wglUseFontBitmapsA-Funktion (wingdi.h)
Die wglUseFontBitmaps-Funktion erstellt eine Reihe von Bitmapanzeigelisten für die Verwendung im aktuellen OpenGL-Renderingkontext. Der Satz von Bitmapanzeigelisten basiert auf den Glyphen in der aktuell ausgewählten Schriftart im Gerätekontext. Anschließend können Sie Bitmaps verwenden, um Zeichen in einem OpenGL-Bild zu zeichnen.
Die wglUseFontBitmaps-Funktion erstellt Listen zur Zählungsanzeige, eine für jede Ausführung von Count-Glyphen, die mit der ersten Glyphe in den ausgewählten Schriftarten des hdc-Parameters beginnt.
Syntax
BOOL wglUseFontBitmapsA(
HDC unnamedParam1,
DWORD unnamedParam2,
DWORD unnamedParam3,
DWORD unnamedParam4
);
Parameter
unnamedParam1
Gibt den Gerätekontext an, dessen aktuell ausgewählte Schriftart verwendet wird, um die Bitmapanzeigelisten für Glyphen im aktuellen OpenGL-Renderingkontext zu bilden.
unnamedParam2
Gibt die erste Glyphe in der Ausführung von Glyphen an, die zum Bilden von Bitmap-Anzeigelisten für Glyphen verwendet wird.
unnamedParam3
Gibt die Anzahl von Glyphen in der Ausführung von Glyphen an, die zum Bilden von Bitmap-Anzeigelisten für Glyphen verwendet werden. Die Funktion erstellt Listen für die Anzahl der Anzeige, eine für jede Glyphe in der Ausführung.
unnamedParam4
Gibt eine Startanzeigeliste an.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE.
Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Die wglUseFontBitmaps-Funktion definiert Zählungsanzeigelisten im aktuellen OpenGL-Renderingkontext. Jede Anzeigeliste hat eine identifikationsbasierte Nummer, beginnend mit listBase. Jede Anzeigeliste besteht aus einem einzelnen Aufruf von glBitmap. Die Definition von bitmap listBase + i stammt aus der Glyphe first + i der Schriftart, die derzeit im von hdc angegebenen Gerätekontext ausgewählt ist. Wenn keine Glyphe definiert ist, definiert die Funktion eine leere Anzeigeliste dafür.
Die wglUseFontBitmaps-Funktion erstellt Bitmaptext auf der Bildschirmebene. Es ermöglicht die Bezeichnung von Objekten in OpenGL.
In der aktuellen Version der Microsoft-Implementierung von OpenGL können Sie keine GDI-Aufrufe an einen Gerätekontext tätigen, der ein doppelt gepuffertes Pixelformat aufweist. Daher können Sie die GDI-Schriftarten und -Textfunktionen nicht mit solchen Gerätekontexten verwenden. Sie können die wglUseFontBitmaps-Funktion verwenden, um diese Einschränkung zu umgehen und Text in einem doppelt gepufferten Gerätekontext zu zeichnen.
Die Funktion bestimmt die Parameter jedes Aufrufs von glBitmap wie folgt.
| glBitmap-Parameter | Bedeutung |
|---|---|
| width | Die Breite der Bitmap der Glyphe, wie sie im gmBlackBoxX-Element der GLYPHMETRICS-Struktur der Glyphe zurückgegeben wird. |
| height | Die Höhe der Bitmap der Glyphe, wie sie im gmBlackBoxY-Element der GLYPHMETRICS-Struktur der Glyphe zurückgegeben wird. |
| xorig | Der x-Offset des Ursprungs der Glyphe, wie im Element gmptGlyphOrigin.x der GLYPHMETRICS-Struktur der Glyphe zurückgegeben. |
| yorig | Der y-Offset des Ursprungs der Glyphe, wie im element gmptGlyphOrigin.y der GLYPHMETRICS-Struktur der Glyphen zurückgegeben wird. |
| Xmove | Der horizontale Abstand zum Ursprung der nächsten Zeichenzelle, wie er im gmCellIncX-Element der GLYPHMETRICS-Struktur der Glyphe zurückgegeben wird. |
| ymove | Der vertikale Abstand zum Ursprung der nächsten Zeichenzelle, wie er im gmCellIncY-Element der GLYPHMETRICS-Struktur der Glyphe zurückgegeben wird. |
| Bitmap | Die Bitmap für die Glyphe, die von GetGlyphOutline mit uFormat gleich 1 zurückgegeben wird. |
Beispiele
Das folgende Codebeispiel zeigt, wie Sie wglUseFontBitmaps verwenden, um Text zu zeichnen.
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");
Hinweis
Der wingdi.h-Header definiert wglUseFontBitmaps als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wingdi.h |
| Bibliothek | Opengl32.lib |
| DLL | Opengl32.dll |