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

指定的字型大小會影響輸出圖像Transform，導致它正確調整字元。

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

用來在色彩字型中選取調色盤的索引。 請注意，這與DWRITE_COLOR_GLYPH_RUN結構中的 paletteIndex 不同，這與 SVG 字元無關。

[out] glyphTransform

類型： D2D1_MATRIX_3X2_F*

輸出轉換，從圖像的空間轉換成與 worldTransform 相同的輸出空間。 這包括輸入圖像Origin、圖像的位移，以及任何其他必要的轉換。

[out] glyphImage

類型： ID2D1CommandList**

完成時，包含擷取的字元影像。

傳回值

類型： HRESULT

這個方法會傳回 HRESULT 成功或錯誤碼。

規格需求

需求	值
目標平台	Windows
標頭	d2d1_3.h
Dll	D2d1.dll

另請參閱

ID2D1DeviceContext4