Función DrvGetGlyphMode (winddi.h)

Artículo
03/15/2023

La función DrvGetGlyphMode indica a GDI cómo almacenar en caché la información del glifo.

Sintaxis

ULONG DrvGetGlyphMode(
  [in] DHPDEV  unnamedParam1,
  [in] FONTOBJ *unnamedParam2
);

Parámetros

[in] unnamedParam1

Controle la estructura PDEV de un dispositivo físico.

[in] unnamedParam2

Puntero a una estructura FONTOBJ que se puede consultar para buscar el tamaño de fuente, la transformación y otros atributos de fuente.

Valor devuelto

DrvGetGlyphMode devuelve uno de los siguientes valores:

Código devuelto	Descripción
FO_GLYPHBITS	GDI debe almacenar en caché todos los datos de glifo para esta fuente.
FO_HGLYPHS	El dispositivo almacena en caché las fuentes por sí solas, por lo que GDI solo debe almacenar en caché los identificadores de glifo para esta fuente.
FO_PATHOBJ	GDI debe almacenar en caché estructuras PATHOBJ para esta fuente.

Comentarios

GDI llama a la rutina DrvGetGlyphMode de un controlador para determinar el intervalo de información de fuente que se debe almacenar en caché para una fuente determinada; Es decir, DrvGetGlyphMode determina qué GDI almacena en su caché de fuentes. Un dispositivo que almacena en caché las fuentes por sí solas debe devolver FO_HGLYPHS para minimizar los requisitos de almacenamiento de la fuente.

GDI llama a DrvGetGlyphMode para cada realización de fuentes. Por ejemplo, un controlador puede querer descargar esquemas para tamaños de punto mayores de 12 puntos, pero imágenes ráster para fuentes más pequeñas. Sin embargo, GDI se reserva el derecho de rechazar esta solicitud.

El controlador debe comprobar el bit RASTER_FONTTYPE del miembro flFontType de la estructura FONTOBJ para determinar la forma real de los glifos. Si se establece este bit, GDI envía mapas de bits; de lo contrario, envía estructuras PATHOBJ .

En el momento de la llamada a DrvGetGlyphMode, el FONTOBJ asociado no es totalmente funcional. GDI solo garantiza que la estructura IFIMETRICS y la transformación notional a dispositivo sean correctas.

DrvGetGlyphMode es una función de controlador opcional. Si no se proporciona esta función, GDI almacenará las fuentes ráster de forma predeterminada.