Función wglUseFontBitmapsW (wingdi.h)

La función wglUseFontBitmaps crea un conjunto de listas de visualización de mapa de bits para su uso en el contexto actual de representación de OpenGL. 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 recuento listas para mostrar, una para cada una de una ejecución de recuento glifos que comienzan con el primer glifo del hdc fuentes seleccionadas del parámetro.

Sintaxis

BOOL wglUseFontBitmapsW(
  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 actual de representación de OpenGL.

unnamedParam2

Especifica el primer glifo de la ejecución de glifos que se usarán para formar listas de visualización de mapas 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 recuento listas 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.

Observaciones

La función wglUseFontBitmaps define recuento listas para mostrar en el contexto actual de representación de OpenGL. 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 del mapa de bits listBase + 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íxeles de doble búfer. 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 de la manera siguiente.

Parámetro glBitmap	Significado
de ancho	Ancho del mapa de bits del glifo, tal y como se devuelve en la estructura gmBlackBoxX del glifo GLYPHMETRICS estructura.
alto	Alto del mapa de bits del glifo, tal como se devuelve en la gmBlackBoxY miembro del glifo estructura GLYPHMETRICS.
xorig	Desplazamiento x del origen del glifo, tal como se devuelve en la gmptGlyphOrigin.x miembro del GLYPHMETRICS del glifo estructura.
yorig	Desplazamiento y del origen del glifo, tal como se devuelve en la estructura gmptGlyphOrigin.y del GLYPHMETRIC S del glifo.
xmove	Distancia horizontal al origen de la siguiente celda de caracteres, tal como se devuelve en la estructura de gmCellIncX del GLYPHMETRICS del glifo.
ymove	Distancia vertical al origen de la siguiente celda de caracteres tal como se devuelve en la gmCellIncY miembro del glifo estructura GLYPHMETRICS.
de mapa de bits	Mapa de bits del glifo, tal como lo 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	wingdi.h
biblioteca de	Opengl32.lib
DLL de	Opengl32.dll

Consulte también

GLYPHMETRICS

GetGlyphOutline

OpenGL en Windows

funciones WGL de

glBitmap

glCallLists

glListBase

wglUseFontOutlines