Função wglUseFontBitmapsA (wingdi.h)

Artigo
11/20/2024

A função wglUseFontBitmaps cria um conjunto de listas de exibição de bitmap para uso no contexto atual de renderização do OpenGL. O conjunto de listas de exibição de bitmap baseia-se nos glifos na fonte atualmente selecionada no contexto do dispositivo. Em seguida, você pode usar bitmaps para desenhar caracteres em uma imagem OpenGL.

A função wglUseFontBitmaps cria contagem listas de exibição, uma para cada uma de uma execução de contagem glifos que começa com o primeiro glifo nas fontes selecionadas do hdc parâmetro.

Sintaxe

BOOL wglUseFontBitmapsA(
  HDC   unnamedParam1,
  DWORD unnamedParam2,
  DWORD unnamedParam3,
  DWORD unnamedParam4
);

Parâmetros

unnamedParam1

Especifica o contexto do dispositivo cuja fonte atualmente selecionada será usada para formar as listas de exibição de bitmap de glifo no contexto atual de renderização do OpenGL.

unnamedParam2

Especifica o primeiro glifo na execução de glifos que serão usados para formar listas de exibição de bitmap de glifo.

unnamedParam3

Especifica o número de glifos na execução de glifos que serão usados para formar listas de exibição de bitmap de glifo. A função cria contagem listas de exibição, uma para cada glifo na execução.

unnamedParam4

Especifica uma lista de exibição inicial.

Valor de retorno

Se a função for bem-sucedida, o valor retornado será VERDADEIRO.

Se a função falhar, o valor retornado será false. Para obter informações de erro estendidas, chame GetLastError.

Observações

A função wglUseFontBitmaps define contagem listas de exibição no contexto atual de renderização do OpenGL. Cada lista de exibição tem um número de identificação, começando em listBase. Cada lista de exibição consiste em uma única chamada para glBitmap. A definição de bitmap listBase + i é retirada do glifo primeiro + i da fonte atualmente selecionada no contexto do dispositivo especificado por hdc. Se um glifo não estiver definido, a função definirá uma lista de exibição vazia para ele.

A função wglUseFontBitmaps cria texto bitmap no plano da tela. Ele habilita a rotulagem de objetos no OpenGL.

Na versão atual da implementação do OpenGL pela Microsoft, você não pode fazer chamadas GDI para um contexto de dispositivo que tenha um formato de pixel com buffer duplo. Portanto, você não pode usar as fontes GDI e as funções de texto com esses contextos de dispositivo. Você pode usar a função wglUseFontBitmaps para contornar essa limitação e desenhar texto em um contexto de dispositivo com buffer duplo.

A função determina os parâmetros de cada chamada para glBitmap da seguinte maneira.

Parâmetro glBitmap	Significado
largura	A largura do bitmap do glifo, conforme retornado no gmBlackBoxX membro da estrutura de GLIPHMETRICS do glifo.
de altura	A altura do bitmap do glifo, conforme retornado no gmBlackBoxY membro da estrutura de GLIPHMETRICS do glifo.
xorig	O deslocamento x da origem do glifo, conforme retornado na gmptGlyphOrigin.x membro do glifo GLYPHMETRICS.
yorig	O deslocamento y da origem do glifo, conforme retornado no gmptGlyphOrigin.y membro da estrutura GLIFOMETRICS do glifo.
xmove	A distância horizontal até a origem da próxima célula de caractere, conforme retornado no gmCellIncX membro da estrutura de GLIFOMÉTRICOS do glifo.
ymove	A distância vertical até a origem da próxima célula de caracteres, conforme retornado na gmCellIncY membro da estrutura de GLIPHMETRICS do glifo.
de bitmap	O bitmap para o glifo, conforme retornado por GetGlyphOutline com uFormat igual a 1.

Exemplos

O exemplo de código a seguir mostra como usar wglUseFontBitmaps para desenhar algum 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

O cabeçalho wingdi.h define wglUseFontBitmaps como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	wingdi.h
biblioteca	Opengl32.lib
de DLL	Opengl32.dll