Método ID2D1DeviceContext4::GetColorBitmapGlyphImage (d2d1_3.h)

Recupera una imagen del glifo de mapa de bits de color de la memoria caché del glifo de color. Si la memoria caché aún no contiene el recurso solicitado, se creará. Este método se puede usar para ampliar la duración de una imagen de glifo incluso después de expulsarla de la caché de glifos de color.

Sintaxis

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
);

Parámetros

glyphImageFormat

Tipo: DWRITE_GLYPH_IMAGE_FORMATS

Formato de la imagen del glifo. Si no hay datos de imagen en el formato solicitado para el glifo solicitado, este método devolverá un error.

glyphOrigin

Tipo: D2D1_POINT_2F

Origen del glifo.

[in] fontFace

Tipo: IDWriteFontFace*

Referencia a una cara de fuente que contiene el tipo de cara de fuente, las referencias de archivo adecuadas, los datos de identificación facial y varios datos de fuente, como métricas, nombres y esquemas de glifo.

fontEmSize

Tipo: FLOAT

El tamaño de fuente especificado afecta a la elección del mapa de bits que se va a usar desde la fuente. También afecta al glifo de salidaTransform, lo que hace que escale correctamente el glifo.

glyphIndex

Tipo: UINT16

Índice del glifo.

isSideways

Tipo: BOOL

Si es true, especifica que los glifos giran 90 grados a la izquierda y se usan métricas verticales. La escritura vertical se logra especificando isSideways como true y girando toda la ejecución 90 grados a la derecha a través de una transformación de rotación.

[in, optional] worldTransform

Tipo: const D2D1_MATRIX_3X2_F*

Transformación que se va a aplicar a la imagen. Esta transformación de entrada afecta a la elección del mapa de bits que se va a usar desde la fuente. También se factoriza en el glifo de salidaTransform.

dpiX

Tipo: FLOAT

Puntos por pulgada a lo largo del eje X.

dpiY

Tipo: FLOAT

Puntos por pulgada a lo largo del eje Y.

[out] glyphTransform

Tipo: D2D1_MATRIX_3X2_F*

Transformación de salida, que transforma desde el espacio del glifo al mismo espacio de salida que worldTransform. Esto incluye el glifo de entradaOrigin, el desplazamiento del glifo desde el glifoOrigin y cualquier otra transformación necesaria.

[out] glyphImage

Tipo: ID2D1Image**

Al finalizar, contiene la imagen de glifo recuperada.

Valor devuelto

Tipo: HRESULT

Este método devuelve un código de error o correcto HRESULT.

Requisitos

Plataforma de destino	Windows
Encabezado	d2d1_3.h
Archivo DLL	D2d1.dll

Consulte también

ID2D1DeviceContext4