funzione wglUseFontBitmapsA (wingdi.h)
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 sugli 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 elenchi di visualizzazione conteggio, uno per ogni esecuzione di glifi di conteggio che inizia con il primo glifo nei tipi di carattere selezionati del parametro hdc.
Sintassi
BOOL wglUseFontBitmapsA(
HDC unnamedParam1,
DWORD unnamedParam2,
DWORD unnamedParam3,
DWORD unnamedParam4
);
Parametri
unnamedParam1
Specifica il contesto del dispositivo il cui carattere attualmente selezionato verrà usato 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 elenchi di visualizzazione conteggio , 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 ha esito negativo, il valore restituito è FALSE. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
La funzione wglUseFontBitmaps definisce gli elenchi di visualizzazione dei conteggi 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. Ladefinizione di bitmaplistBase + i viene presa dal glifo primo + i del tipo di carattere attualmente selezionato nel contesto del dispositivo specificato da hdc. Se un glifo non è definito, la funzione definisce un elenco di visualizzazione vuoto.
La funzione wglUseFontBitmaps crea testo bitmap nel piano dello schermo. Abilita l'etichettatura degli oggetti in OpenGL.
Nella versione corrente dell'implementazione di Microsoft di OpenGL non è possibile effettuare chiamate GDI a un contesto di dispositivo con un formato pixel con buffer doppio. 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 buffer doppio.
La funzione determina i parametri di ogni chiamata a glBitmap come indicato di seguito.
| Parametro glBitmap | Significato |
|---|---|
| width | Larghezza della bitmap del glifo, come restituito nel membro gmBlackBoxX della struttura GLYPHMETRICS del glifo. |
| height | Altezza della bitmap del glifo, come restituito nel membro gmBlackBoxY della struttura GLYPHMETRICS del glifo. |
| xorig | Offset x dell'origine del glifo, come restituito nel membro gmptGlyphOrigin.x della struttura GLYPHMETRICS del glifo. |
| yorig | Offset y dell'origine del glifo, come restituito nel membro gmptGlyphOrigin.y della struttura GLYPHMETRICS del glifo. |
| xmove | Distanza orizzontale all'origine della cella di caratteri successiva, come restituito nel membro gmCellIncX della struttura GLYPHMETRICS del glifo. |
| ymove | Distanza verticale all'origine della cella di caratteri successiva, come restituito nel membro gmCellIncY della struttura GLYPHMETRICS del glifo. |
| bitmap | Bitmap per il glifo, come restituito da GetGlyphOutline con uFormat uguale a 1. |
Esempio
Nell'esempio di codice seguente viene illustrato come usare wglUseFontBitmaps per disegnare un 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | wingdi.h |
| Libreria | Opengl32.lib |
| DLL | Opengl32.dll |