FONTOBJ 構造体 (winddi.h)

[アーティクル]
08/27/2023

FONTOBJ 構造体は、フォントの特定のインスタンスに関する情報へのアクセス権をドライバーに付与するために使用されます。

構文

typedef struct _FONTOBJ {
  ULONG     iUniq;
  ULONG     iFace;
  ULONG     cxMax;
  FLONG     flFontType;
  ULONG_PTR iTTUniq;
  ULONG_PTR iFile;
  SIZE      sizLogResPpi;
  ULONG     ulStyleSize;
  PVOID     pvConsumer;
  PVOID     pvProducer;
} FONTOBJ;

メンバー

iUniq

フォントの明確な認識を指定します。この値は、ドライバーがキャッシュした可能性のある GDI フォントを識別したり、ドライバーが独自のフォントを認識したりするために使用できます。 GDI フォントのこのメンバーが 0 の場合は、フォントをキャッシュしないでください。

iFace

DrvQueryFont の呼び出しによって登録されたデバイスフォントのデバイスインデックスを指定します。フォントが GDI フォントの場合、このメンバーは GDI に対してのみ意味を持ち、ドライバーはそれを無視する必要があります。

cxMax

指定したフォントの最大グリフの幅をピクセル単位で指定します。

flFontType

フォントの種類を指定する値です。このメンバーは、次の表に示すフラグの組み合わせにすることができます。 (ただし、FO_GRAY16とFO_NOGRAY16は相互に排他的であることに注意してください)。

フラグ	説明
FO_CFF	Postscript OpenType フォント。
FO_DBCS_FONT	フォントは DBCS コードページをサポートします。
FO_EM_HEIGHT	TrueType ドライバーの内部フラグ。
FO_GRAY16	フォントビットマップは、ピクセルごとの 4 ビットブレンド (アルファ) 値です。
FO_MULTIPLEMASTER	複数のマスター (Type1 または OpenType) フォント。
FO_NOGRAY16	フォントドライバーが特定のフォントの実現をグレースケールできない (またはスケールしない) ことを示します。
FO_POSTSCRIPT	Postscript (Type1 または OpenType) フォント。
FO_SIM_BOLD	ドライバーシミュレートされた太字フォント。
FO_SIM_ITALIC	ドライバーシミュレートされた斜体フォント。
FO_TYPE_DEVICE	デバイス固有のフォント。
FO_TYPE_OPENTYPE	OpenType フォント。
FO_TYPE_RASTER	ビットマップフォント。
FO_TYPE_TRUETYPE	TrueType フォント。
FO_VERT_FACE	縦書きフォント。

FO_RASTER フラグが設定されている場合、指定した STROBJ 構造体に書き込まれるグリフはビットマップであり、それ以外の場合は PATHOBJ 構造体へのポインターです。グリフイメージが PATHOBJ 構造体の形式で返される場合、ドライバーは、関連付けられている IFIMETRICS 構造体の flInfo メンバーのFM_INFO_TECH_STROKE フラグを検査する必要があります。そのフラグが設定されている場合は、パスをストロークする必要があります。それ以外の場合は、交互モード規則を使用してパスを入力する必要があります。

FO_GRAY16 フラグが設定されている場合、フォントビットマップはピクセルごとの 4 ビットブレンド (アルファ) 値になります。 0 の値は、結果のピクセルの色が背景と同じである必要があることを意味します。アルファ値が k の場合、次の表では、線形アルファブレンドまたはガンマ補正アルファブレンドを使用して、結果として得られるピクセルの属性について説明します。どちらの方法でも、前景色と背景色はそれぞれ c_f と c_{b です}。

ピクセル属性	説明
ブレンドされた色 (線形アルファブレンド)	線形アルファブレンドでは、前景色と背景色の線形の組み合わせであるブレンドされた色が生成されます。 c = b * c_f + (1 - b) * c_b ブレンド分画bは、以下のようにして得られる。 b = k / 15、k = 0、1、2、...、15 の場合注: 前景色と背景色には、3 つのカラーチャネル (R、G、B) がすべて含まれます。
ブレンドされた色 (ガンマ補正アルファブレンド)	ガンマ補正アルファブレンドでは、アルファ値に依存する変数を固定累乗に引き上げることで、ブレンドされた色が生成されます。 2 つの数式が用意されています。1 つは、前景色が背景色よりも数値的に大きい場合に使用する必要があります。逆の場合は、もう一方を使用する必要があります。 (前景色と背景色が等しい場合、両方の数式が c = c_b に簡略化されます)。 c_f> c_{b の}場合、 c = c_b + pow(b[k], (1 / gamma)) * (c_f - c_b) c_f< c_{b の}場合、 c = c_b + (1 - pow(1 - b[k], 1 / gamma)) * (c_f - c_b) これらの式において、gamma=2.33、およびb[k]は、k^番目のブレンド分画であり、以下のようにして得られる: b[k] = 0、k = 0、および b[k] = (k + 1) / 16, for k = 1, 2, ..., 15 注: 線形アルファブレンドとは異なり、これらの数式は 3 つのカラーチャネル (R、G、B) のそれぞれに適用する必要があります。

ピクセル属性

説明

ブレンドされた色
(線形アルファブレンド)

線形アルファブレンドでは、前景色と背景色の線形の組み合わせであるブレンドされた色が生成されます。

c = b * c_f + (1 - b) * c_b

ブレンド分画bは、以下のようにして得られる。

b = k / 15、k = 0、1、2、...、15 の場合

注: 前景色と背景色には、3 つのカラーチャネル (R、G、B) がすべて含まれます。

ブレンドされた色
(ガンマ補正アルファブレンド)

ガンマ補正アルファブレンドでは、アルファ値に依存する変数を固定累乗に引き上げることで、ブレンドされた色が生成されます。

2 つの数式が用意されています。1 つは、前景色が背景色よりも数値的に大きい場合に使用する必要があります。逆の場合は、もう一方を使用する必要があります。 (前景色と背景色が等しい場合、両方の数式が c = c_b に簡略化されます)。

c_f> c_{b の}場合、
c = c_b + pow(b[k], (1 / gamma)) * (c_f - c_b)

c_f< c_{b の}場合、
c = c_b + (1 - pow(1 - b[k], 1 / gamma)) * (c_f - c_b)

これらの式において、gamma=2.33、およびb[k]は、k^番目のブレンド分画であり、以下のようにして得られる:

b[k] = 0、k = 0、および
b[k] = (k + 1) / 16, for k = 1, 2, ..., 15

注: 線形アルファブレンドとは異なり、これらの数式は 3 つのカラーチャネル (R、G、B) のそれぞれに 適用する必要があります。

GDI は、フォントを 16 個の値のいずれかにグレースケールするように要求したときに、DrvQueryFontData 関数へのエントリに対してFO_GRAY16 フラグを設定します。フォントドライバーで特定のフォントの実現をグレースケールできない場合、フォントプロバイダーは FO_GRAY16 フラグをクリアし、FO_NOGRAY16 フラグを設定して、グレースケール要求が満たされないことを GDI に通知します。

iTTUniq

関連付けられている TrueType ファイルを指定します。 TrueType フォントフェイスの 2 つの個別のポイントサイズの実現には、同じ iTTUniq 値を共有する FONTOBJ 構造体がありますが、 iUniq 値は異なります。 0 以外の iTTUniq メンバーを持つことは、TrueType フォントの種類のみです。詳細については、「 flFontType」を参照してください。

iFile

既に読み込まれているデバイスフォントのドライバー定義値へのポインター。フォントが GDI フォントの場合、このメンバーは内部的にフォントを識別するために使用され、無視する必要があります。

sizLogResPpi

このフォントを実現するデバイスの解像度を指定します。

ulStyleSize

フォントインスタンスのスタイルサイズをポイント単位で指定します。

pvConsumer

このフォントインスタンスに関連付けられているコンシューマー割り当てデータへのポインター。コンシューマーは、テキスト出力を生成するための入力としてグリフ情報を受け取るドライバーです。このメンバーを変更できるのは、フォントコンシューマーだけです。このフォントのコンシューマーは、このメンバーが指す場所に任意の情報を格納できます。エンジンはこのメンバーを変更しません。 pvConsumer メンバーは、FONTOBJ 構造体がコンシューマーに初めて渡されるときに null であることが保証されます。

pvProducer

このフォントインスタンスに関連付けられているプロデューサー割り当てデータへのポインター。プロデューサーは、グリフ情報を出力として生成できるドライバーです。これには、グリフメトリック、ビットマップ、アウトラインが含まれます。このメンバーを変更できるのはフォントプロデューサーだけです。このフォントのプロデューサーは、このメンバーが指す場所に任意の情報を格納できます。エンジンはこのメンバーを変更しません。 PVProducer メンバーは、FONTOBJ 構造体がプロデューサーに初めて渡されるときに null であることが保証されます。

注釈

アクセラレータとして、ドライバーは FONTOBJ 構造体のパブリックメンバーにアクセスできます。

ドライバーは、プロデューサーとコンシューマーの両方にすることができます。たとえば、プリンタードライバーは、ドライバー提供の DrvQueryFontData 関数の呼び出しを処理中にプロデューサーとして機能してグリフメトリックを提供し、後でドライバー提供の DrvTextOut 関数の呼び出しを処理中にコンシューマーを動作させることができます。