ID2D1DeviceContext4::GetSvgGlyphImage メソッド (d2d1_3.h)

カラー グリフ キャッシュから SVG グリフのイメージを取得します。 キャッシュに要求されたリソースがまだ含まれていない場合は、作成されます。 このメソッドは、カラー グリフ キャッシュから削除された後でも、グリフ イメージの有効期間を延長するために使用できます。

構文

HRESULT GetSvgGlyphImage(
                 D2D1_POINT_2F           glyphOrigin,
  [in]           IDWriteFontFace         *fontFace,
                 FLOAT                   fontEmSize,
                 UINT16                  glyphIndex,
                 BOOL                    isSideways,
  [in, optional] const D2D1_MATRIX_3X2_F *worldTransform,
  [in, optional] ID2D1Brush              *defaultFillBrush,
  [in, optional] ID2D1SvgGlyphStyle      *svgGlyphStyle,
                 UINT32                  colorPaletteIndex,
  [out]          D2D1_MATRIX_3X2_F       *glyphTransform,
  [out]          ID2D1CommandList        **glyphImage
);

パラメーター

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*

イメージに適用する変換。

[in, optional] defaultFillBrush

種類: ID2D1Brush*

領域の塗りつぶし方法について説明します。

[in, optional] svgGlyphStyle

種類: ID2D1SvgGlyphStyle*

SVG グリフのレンダリング時に使用されるコンテキストフィル、コンテキスト ストローク、コンテキスト値の値。

colorPaletteIndex

種類: UINT32

カラー フォント内のカラー パレットを選択するために使用するインデックス。 これは、SVG グリフには関係のない、DWRITE_COLOR_GLYPH_RUN 構造体の paletteIndex と同じではないことに注意してください。

[out] glyphTransform

種類: D2D1_MATRIX_3X2_F*

出力変換。グリフの空間から worldTransform と同じ出力空間に変換されます。 これには、入力 glyphOrigin、glyphOrigin からのグリフのオフセット、およびその他の必要な変換が含まれます。

[out] glyphImage

種類: ID2D1CommandList**

完了時に、 には取得されたグリフ イメージが含まれます。

戻り値

種類: HRESULT

このメソッドは、HRESULT の成功またはエラー コードを返します。

要件

こちらもご覧ください

ID2D1DeviceContext4