Funzione wglUseFontBitmapsW (wingdi.h)

Articolo
11/20/2024

La funzione wglUseFontBitmaps crea un set di elenchi di visualizzazione bitmap da usare nel contesto di rendering OpenGL corrente. Il set di elenchi di visualizzazione bitmap si basa sui glifi nel tipo di carattere attualmente selezionato nel contesto del dispositivo. È quindi possibile usare bitmap per disegnare caratteri in un'immagine OpenGL.

La funzione wglUseFontBitmaps crea conteggio elenchi di visualizzazione, uno per ogni esecuzione di conteggio glifi che inizia con il primo glifo nel tipi di carattere selezionati del parametro hdc.

Sintassi

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

Parametri

unnamedParam1

Specifica il contesto del dispositivo il cui tipo di carattere attualmente selezionato verrà utilizzato per formare gli elenchi di visualizzazione bitmap del glifo nel contesto di rendering OpenGL corrente.

unnamedParam2

Specifica il primo glifo nell'esecuzione di glifi che verranno usati per formare elenchi di visualizzazione bitmap del glifo.

unnamedParam3

Specifica il numero di glifi nell'esecuzione di glifi che verranno usati per formare elenchi di visualizzazione bitmap del glifo. La funzione crea conteggio elenchi di visualizzazione, uno per ogni glifo nell'esecuzione.

unnamedParam4

Specifica un elenco di visualizzazione iniziale.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è TRUE.

Se la funzione non riesce, il valore restituito viene FALSE. Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

La funzione wglUseFontBitmaps definisce conteggio visualizzare gli elenchi nel contesto di rendering OpenGL corrente. Ogni elenco di visualizzazione ha un numero di identificazione, a partire da listBase. Ogni elenco di visualizzazione è costituito da una singola chiamata a glBitmap. La definizione di bitmap listBase + i viene ricavata dal glifo prima + i del tipo di carattere attualmente selezionato nel contesto di dispositivo specificato da hdc. Se un glifo non è definito, la funzione definisce un elenco di visualizzazione vuoto per esso.

La funzione wglUseFontBitmaps crea testo bitmap nel piano dello schermo. Abilita l'etichettatura degli oggetti in OpenGL.

Nella versione corrente dell'implementazione di OpenGL di Microsoft non è possibile effettuare chiamate GDI a un contesto di dispositivo con un formato pixel con doppio buffer. Pertanto, non è possibile usare i tipi di carattere GDI e le funzioni di testo con tali contesti di dispositivo. È possibile usare la funzione wglUseFontBitmaps per aggirare questa limitazione e disegnare testo in un contesto di dispositivo con doppio buffer.

La funzione determina i parametri di ogni chiamata a glBitmap come indicato di seguito.

Parametro glBitmap	Significato
larghezza	Larghezza della bitmap del glifo, come restituito nel gmBlackBoxX membro della struttura GLYPHMETRICS.
altezza	Altezza della bitmap del glifo, come restituito nel gmBlackBoxY membro della struttura GLYPHMETRICS del glifo.
xorig	Offset x dell'origine del glifo, come restituito nella struttura gmptGlyphOrigin.x della struttura GLYPHMETRICS.
yorig	Offset y dell'origine del glifo, come restituito nel gmptGlyphOrigin.y membro della struttura GLYPHMETRICS.
xmove	Distanza orizzontale all'origine della cella di caratteri successiva, come restituito nella struttura gmCellIncX del GLYPHMETRICS del glifo.
	Distanza verticale all'origine della cella di caratteri successiva restituita nella gmCellIncY membro della struttura GLYPHMETRICS del glifo.
bitmap	Bitmap per il glifo, come restituito da GetGlyphOutline con uFormat uguale a 1.

Esempi

Nell'esempio di codice seguente viene illustrato come usare wglUseFontBitmaps per disegnare del testo.

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

L'intestazione wingdi.h definisce wglUseFontBitmaps come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	wingdi.h
libreria	Opengl32.lib
dll	Opengl32.dll