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 成功或錯誤碼。

規格需求

另請參閱

ID2D1DeviceContext4