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

関連項目

ID2D1DeviceContext4