EngTextOut

EngTextOut 関数は、GDI に指定位置でグリフ集合をレンダリングさせる。

EngTextOut pso, pstro, pfo, pco, prclExtra, prclOpaque, pboFore, pboOpaque, pptlOrg, mix

pso : [var] 書き込み先のサーフェスを記述する SURFOBJ 構造体へのポインタ。
pstro : [var] レンダリングするグリフと配置位置を定義する STROBJ 構造体へのポインタ。
pfo : [var] フォントとそのグリフに関する情報を取得するために使われる FONTOBJ 構造体へのポインタ。
pco : [var] レンダリングを行うクリップ領域を定義する CLIPOBJ 構造体へのポインタ。このクリップ領域の外のピクセルは影響を受けない。
prclExtra : [var] RECTL 構造体へのポインタ。このパラメータは常に NULL であるべきである。
prclOpaque : [var] 右下を含まない単一の不透明矩形を識別する RECTL 構造体へのポインタ。この矩形内のピクセル（前景でなくクリップされていないもの）は不透明ブラシでレンダリングされる。この矩形は常に描画されるテキストを囲む。NULL の場合、不透明ピクセルはレンダリングされない。
pboFore : [var] 前景ピクセルに使用するブラシオブジェクトを表す BRUSHOBJ 構造体へのポインタ。このブラシは常にソリッドカラーブラシである。
pboOpaque : [var] 不透明ピクセル用のブラシオブジェクトを表す BRUSHOBJ 構造体へのポインタ。このブラシの前景・背景の混合モードはどちらも R2_COPYPEN と仮定される。ドライバが DEVINFO 構造体の flGraphicsCaps メンバに GCAPS_ARBRUSHOPAQUE 機能ビットを設定しない限り、常にソリッドカラーブラシで呼ばれる。
pptlOrg : [var] 両方のブラシのブラシ原点を定義する POINTL 構造体へのポインタ。EngTextOut の呼び出し時にこのパラメータが 0 に設定されていると、一部のプリンタドライバでカラー画像が正しく印刷されないことがある。詳細は備考を参照。
mix : [int] pboFore 用の前景および背景ラスタ操作（混合モード）を指定する。

(プラグイン / モジュール : gdi32.dll)

解説

EngTextOut 関数は、GDI に指定位置でグリフ集合をレンダリングさせる。

[戻り値]
関数が成功した場合、戻り値は TRUE となる。それ以外の場合は FALSE となり、エラーコードがログに記録される。

[備考]
ドライバが DrvTextOut をフックしているがグリフをレンダリングできない場合、EngTextOut を呼ぶべきである。注意:
ドライバはデバイス管理サーフェスに対して DrvTextOut をフックしている場合、EngTextOut
にパントできない。EngTextOut への入力パラメータは前景と不透明の 2
種類のピクセル集合を定義する。ドライバは、まず不透明ブラシで不透明ピクセルをレンダリングし、次に前景ブラシで前景ピクセルをレンダリングするプロセスと同一の結果になるようにサーフェスをレンダリングしなければならない。これらの各操作はクリッピングによって制限される。この関数の
pptlOrg パラメータが 0 に設定されると、Microsoft Windows Server 2003 (日本語版)
では一部のプリンタドライバがカラー画像を正しく印刷しないことがある。pptlOrg を 0（NULL
ポインタ値）に設定することは、ブラシ原点が定義されていないと解釈される。これを防ぐには、EngTextOut を呼ぶ前に pptlOrg
をメンバが (0,0) に設定された POINTL
構造体のアドレスで初期化する。前景および不透明ピクセルは、それを通して色がサーフェスに塗られるスクリーンとして扱われる。フォントのグリフ自体は色を持たない。EngTextOut
への入力パラメータは、グリフピクセルの集合、追加矩形の集合、不透明矩形、クリップ領域を定義する。ドライバは前景・不透明ピクセルの集合を計算してレンダリングしなければならない。混合モードは、入ってくるパターンを既にデバイスサーフェス上にあるデータとどのように混合するかを定義する。MIX
データ型は、単一の ULONG にパックされた 2 つの ROP2
値からなる。下位バイトは前景ラスタ操作を、次のバイトは背景ラスタ操作を定義する。ラスタ操作コードの詳細は Microsoft
Windows SDK ドキュメントを参照。

情報