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 |