CDC::GetGlyphOutline

Artículo
02/19/2013

Recupera la curva o mapa de bits de esquema por un carácter de contorno en la fuente actual.

DWORD GetGlyphOutline(
   UINT nChar,
   UINT nFormat,
   LPGLYPHMETRICS lpgm,
   DWORD cbBuffer,
   LPVOID lpBuffer,
   const MAT2* lpmat2
) const;

Parámetros

nChar
Especifica el carácter que información debe volver.

nFormat
Especifica el formato en el que la función es devolver información.Puede ser uno de los valores siguientes, o 0:

Valor	Significado
GGO_BITMAP	Devuelve el mapa de bits del glifo.Cuando finaliza la función, el búfer indicada por lpBuffer contiene un 1 bits por píxel bitmap cuyas filas comienzan en límites de palabra doble.
GGO_NATIVE	Devuelve los puntos de datos de la curva en formato nativo de rasterizador, utilizando unidades.Cuando se especifica este valor, cualquier transformación especificada en lpmat2 se omite.

Cuando el valor de nFormat es 0, la función completa una estructura de GLYPHMETRICS pero no devuelve datos de glifo- contorno.

lpgm
Señala una estructura de GLYPHMETRICS que describe la posición del glifo en la celda de carácter.
cbBuffer
Especifica el tamaño del búfer en el que la función copia información sobre el carácter de esquema.Si este valor es 0 y el parámetro de nFormat son valores de GGO_BITMAP o de GGO_NATIVE , la función devuelve el tamaño necesario del búfer.
lpBuffer
Señala a un búfer en el que la función copia información sobre el carácter de esquema.Si nFormat especifica el valor de GGO_NATIVE , se copia en forma de estructuras de TTPOLYGONHEADER y de TTPOLYCURVE .Si este valor es NULL y nFormat es el valor de GGO_BITMAP o de GGO_NATIVE , la función devuelve el tamaño necesario del búfer.
lpmat2
Señala MAT2 estructurados que contiene una matriz de transformación por carácter.Este parámetro no puede ser NULL, aunque el valor de GGO_NATIVE se especifica para nFormat.

Valor devuelto

El tamaño, en bytes, del búfer requerido para la información recuperada si cbBuffer es 0 o lpBuffer es NULL.Si no, es un valor positivo si la función es correcta, o – 1 si hay un error.

Comentarios

Una aplicación puede activar los caracteres recuperados en formato de mapa de bits especificando una matriz de transformación 2 by-2 en la estructura designada por a lpmat2.

Un esquema del glifo se devuelve como una serie de contornos.Cada esquema se define mediante una estructura de TTPOLYGONHEADER seguida de todas las estructuras de TTPOLYCURVE como se requieren para describirla.Todos los puntos se devuelven como estructuras de POINTFX y representan posiciones absolutas, desplaza no relativos.El punto inicial proporcionado por el miembro de pfxStart de la estructura de TTPOLYGONHEADER es el punto en el que el contorno de un contorno inicia.Las estructuras de TTPOLYCURVE que siguen pueden ser registros de polilínea o registros de spline.Los registros de polilínea son ejecuciones de puntos; las líneas que se dibujen entre puntos describen el contorno del carácter.Los registros de la curva spline representan las curvas cuadráticas utilizadas por TrueType (es decir, b- curvas spline cuadráticas).