ID2D1DeviceContext4::GetColorBitmapGlyphImage メソッド (d2d1_3.h)
カラー グリフ キャッシュからカラー ビットマップ グリフのイメージを取得します。 キャッシュに要求されたリソースがまだ含まれていない場合は、作成されます。 このメソッドは、カラー グリフ キャッシュから削除された後でも、グリフ イメージの有効期間を延長するために使用できます。
構文
HRESULT GetColorBitmapGlyphImage(
DWRITE_GLYPH_IMAGE_FORMATS glyphImageFormat,
D2D1_POINT_2F glyphOrigin,
[in] IDWriteFontFace *fontFace,
FLOAT fontEmSize,
UINT16 glyphIndex,
BOOL isSideways,
[in, optional] const D2D1_MATRIX_3X2_F *worldTransform,
FLOAT dpiX,
FLOAT dpiY,
[out] D2D1_MATRIX_3X2_F *glyphTransform,
[out] ID2D1Image **glyphImage
);
パラメーター
glyphImageFormat
種類: DWRITE_GLYPH_IMAGE_FORMATS
グリフ イメージの形式。 要求されたグリフの要求された形式の画像データがない場合、このメソッドはエラーを返します。
glyphOrigin
種類: D2D1_POINT_2F
グリフの原点。
[in] fontFace
種類: IDWriteFontFace*
フォントフェイスの種類、適切なファイル参照、顔識別データ、メトリック、名前、グリフアウトラインなどのさまざまなフォントデータを含むフォントフェイスへの参照。
fontEmSize
型: FLOAT
指定したフォント サイズは、フォントから使用するビットマップの選択に影響します。 また、出力 glyphTransform にも影響を与え、グリフを適切にスケーリングします。
glyphIndex
種類: UINT16
グリフのインデックス。
isSideways
種類: BOOL
true の場合は、グリフが左に 90 度回転し、垂直方向のメトリックが使用されることを指定します。 垂直書き込みは、isSideways を true として指定し、回転変換を使用してラン全体を右に 90 度回転することで実現されます。
[in, optional] worldTransform
型: const D2D1_MATRIX_3X2_F*
イメージに適用する変換。 この入力変換は、フォントから使用するビットマップの選択に影響します。 また、出力グリフTransform にも組み込まれます。
dpiX
型: FLOAT
x 軸に沿った 1 インチあたりのドット数。
dpiY
型: FLOAT
y 軸に沿った 1 インチあたりのドット数。
[out] glyphTransform
種類: D2D1_MATRIX_3X2_F*
出力変換。グリフの空間から worldTransform と同じ出力空間に変換されます。 これには、入力 glyphOrigin、glyphOrigin からのグリフのオフセット、およびその他の必要な変換が含まれます。
[out] glyphImage
種類: ID2D1Image**
完了時には、取得したグリフ イメージが含まれます。
戻り値
種類: HRESULT
このメソッドは、HRESULT の成功またはエラー コードを返します。
必要条件
対象プラットフォーム | Windows |
ヘッダー | d2d1_3.h |
[DLL] | D2d1.dll |