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
指定的字型大小會影響要從字型使用的點陣圖選擇。 它也會影響輸出圖像Transform，導致它正確調整圖像。
glyphIndex
類型： UINT16
圖像的索引。
isSideways
類型： BOOL
如果為 true，則指定圖像會旋轉 90 度到左邊，並使用垂直計量。 垂直寫入可藉由指定 isSideways 指定為 true，並透過旋轉轉換將整個執行旋轉 90 度旋轉至右邊來達成。
[in, optional] worldTransform
類型：const D2D1_MATRIX_3X2_F*
要套用至影像的轉換。 此輸入轉換會影響要從字型使用的點陣圖選擇。 它也會納入輸出字元Transform。
dpiX
類型： FLOAT
沿著 X 軸的每英吋點數。
dpiY
類型： FLOAT
沿著 Y 軸的每英吋點數。
[out] glyphTransform
類型： D2D1_MATRIX_3X2_F*
輸出轉換，從圖像的空間轉換成與 worldTransform 相同的輸出空間。 這包括輸入圖像Origin、圖像的位移，以及任何其他必要的轉換。
[out] glyphImage
類型： ID2D1Image**
完成時包含擷取的圖像影像。
傳回值
類型： HRESULT
這個方法會傳回 HRESULT 成功或錯誤碼。
規格需求
| 目標平台 | Windows |
| 標頭 | d2d1_3.h |
| Dll | D2d1.dll |