Función wglUseFontBitmapsA (wingdi.h)
La función wglUseFontBitmaps crea un conjunto de listas de visualización de mapa de bits para su uso en el contexto de representación de OpenGL actual. El conjunto de listas de visualización de mapa de bits se basa en los glifos de la fuente seleccionada actualmente en el contexto del dispositivo. A continuación, puede usar mapas de bits para dibujar caracteres en una imagen de OpenGL.
La función wglUseFontBitmaps crea listas de visualización de recuento , una para cada una de una ejecución de glifos de recuento que comienza con el primer glifo en las fuentes seleccionadas del parámetro hdc .
Sintaxis
BOOL wglUseFontBitmapsA(
HDC unnamedParam1,
DWORD unnamedParam2,
DWORD unnamedParam3,
DWORD unnamedParam4
);
Parámetros
unnamedParam1
Especifica el contexto del dispositivo cuya fuente seleccionada actualmente se usará para formar las listas de visualización del mapa de bits del glifo en el contexto de representación de OpenGL actual.
unnamedParam2
Especifica el primer glifo de la ejecución de glifos que se usarán para formar listas de visualización de mapa de bits de glifo.
unnamedParam3
Especifica el número de glifos en la ejecución de glifos que se usarán para formar listas de visualización de mapa de bits de glifo. La función crea listas de recuento para mostrar, una para cada glifo de la ejecución.
unnamedParam4
Especifica una lista de presentación inicial.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es TRUE.
Si se produce un error en la función, el valor devuelto es FALSE. Para obtener información de error extendida, llame a GetLastError.
Comentarios
La función wglUseFontBitmaps define las listas de visualización de recuento en el contexto de representación de OpenGL actual. Cada lista para mostrar tiene un número de identificación, empezando por listBase. Cada lista de visualización consta de una sola llamada a glBitmap. La definición de listBase + de mapa de bits i se toma del glifo primero + i de la fuente seleccionada actualmente en el contexto del dispositivo especificado por hdc. Si no se define un glifo, la función define una lista de visualización vacía para él.
La función wglUseFontBitmaps crea texto de mapa de bits en el plano de la pantalla. Habilita el etiquetado de objetos en OpenGL.
En la versión actual de la implementación de OpenGL de Microsoft, no puede realizar llamadas GDI a un contexto de dispositivo que tenga un formato de píxel con búfer doble. Por lo tanto, no se pueden usar las fuentes GDI y las funciones de texto con estos contextos de dispositivo. Puede usar la función wglUseFontBitmaps para eludir esta limitación y dibujar texto en un contexto de dispositivo con búfer doble.
La función determina los parámetros de cada llamada a glBitmap como se indica a continuación.
| Parámetro glBitmap | Significado |
|---|---|
| width | Ancho del mapa de bits del glifo, tal como se devuelve en el miembro gmBlackBoxX de la estructura GLYPHMETRICS del glifo. |
| height | Alto del mapa de bits del glifo, tal como se devuelve en el miembro gmBlackBoxY de la estructura GLYPHMETRICS del glifo. |
| xorig | Desplazamiento x del origen del glifo, tal como se devuelve en el miembro gmptGlyphOrigin.x de la estructura GLYPHMETRICS del glifo. |
| yorig | Desplazamiento y del origen del glifo, tal como se devuelve en el miembro gmptGlyphOrigin.y de la estructura GLYPHMETRICS del glifo. |
| xmove | Distancia horizontal al origen de la celda de carácter siguiente, tal como se devuelve en el miembro gmCellIncX de la estructura GLYPHMETRICS del glifo. |
| ymove | Distancia vertical al origen de la celda de carácter siguiente tal como se devuelve en el miembro gmCellIncY de la estructura GLYPHMETRICS del glifo. |
| bitmap | Mapa de bits del glifo, tal y como devuelve GetGlyphOutline con uFormat igual a 1. |
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar wglUseFontBitmaps para dibujar texto.
HDC hdc;
HGLRC hglrc;
// create a rendering context
hglrc = wglCreateContext (hdc);
// make it the calling thread's current rendering context
wglMakeCurrent (hdc, hglrc);
// now we can call OpenGL API
// make the system font the device context's selected font
SelectObject (hdc, GetStockObject (SYSTEM_FONT));
// create the bitmap display lists
// we're making images of glyphs 0 thru 254
// the display list numbering starts at 1000, an arbitrary choice
wglUseFontBitmaps (hdc, 0, 255, 1000);
// display a string:
// indicate start of glyph display lists
glListBase (1000);
// now draw the characters in a string
glCallLists (24, GL_UNSIGNED_BYTE, "Hello Windows OpenGL World");
Nota
El encabezado wingdi.h define wglUseFontBitmaps como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | wingdi.h |
| Library | Opengl32.lib |
| Archivo DLL | Opengl32.dll |