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 |