wglUseFontBitmapsW-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 Anzahl Anzeigelisten, eine für jede Ausführung Anzahl Glyphen, die mit der ersten Glyphe im hdc ausgewählten Schriftarten des Parameters beginnen.
Syntax
BOOL wglUseFontBitmapsW(
HDC unnamedParam1,
DWORD unnamedParam2,
DWORD unnamedParam3,
DWORD unnamedParam4
);
Parameter
unnamedParam1
Gibt den Gerätekontext an, dessen aktuell ausgewählte Schriftart verwendet wird, um die Glyphen-Bitmapanzeigelisten im aktuellen OpenGL-Renderingkontext zu bilden.
unnamedParam2
Gibt die erste Glyphe bei der Ausführung von Glyphen an, die zum Erstellen von Glyphen-Bitmap-Anzeigelisten verwendet werden.
unnamedParam3
Gibt die Anzahl der Glyphen bei der Ausführung von Glyphen an, die zum Erstellen von Glyphen-Bitmap-Anzeigelisten verwendet werden. Die Funktion erstellt Anzahl Anzeigelisten, 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. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Die wglUseFontBitmaps--Funktion definiert Anzahl Anzeigelisten im aktuellen OpenGL-Renderingkontext. Jede Anzeigeliste verfügt über eine identifikationszahl, beginnend bei listBase. Jede Anzeigeliste besteht aus einem einzelnen Aufruf glBitmap-. Die Definition der Bitmap-listBase + i stammt aus der Glyphe ersten + i der Schriftart, die aktuell im gerätekontext von hdcangegeben ist. Wenn keine Glyphe definiert ist, definiert die Funktion eine leere Anzeigeliste dafür.
Die wglUseFontBitmaps Funktion erstellt Bitmaptext in der Bildschirmebene. Sie ermöglicht die Beschriftung von Objekten in OpenGL.
In der aktuellen Version der Microsoft-Implementierung von OpenGL können Sie keine GDI-Aufrufe an einen Gerätekontext ausführen, der über ein doppelt gepuffertes Pixelformat verfügt. 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 der einzelnen Aufrufe von glBitmap wie folgt.
| glBitmap-Parameter | Bedeutung |
|---|---|
| Breite | Die Breite der Glyphen-Bitmap, wie in der gmBlackBoxX Member der Glyphen-GLYPHMETRICS- Struktur zurückgegeben. |
| Höhe | Die Höhe der Glyphe-Bitmap, wie in der gmBlackBoxY Member der Glyphen-GLYPHMETRICS- Struktur zurückgegeben. |
| xorig- | Der x-Offset des Glyphenursprungs, wie in der gmptGlyphOrigin.x Member der Glyphen GLYPHMETRICS Struktur zurückgegeben. |
| yorig | Der y-Offset des Glyphenursprungs, wie in der gmptGlyphOrigin.y Mitglied der Glyphen GLYPHMETRICS Struktur zurückgegeben. |
| xmove- | Der horizontale Abstand zum Ursprung der nächsten Zeichenzelle, wie in der gmCellIncX Element der GLYPHMETRICS Struktur zurückgegeben. |
| Der vertikale Abstand zum Ursprung der nächsten Zeichenzelle, wie in der gmCellIncY Member der Glyphe GLYPHMETRICS Struktur zurückgegeben. | |
| Bitmap- | Die Bitmap für die Glyphe, wie von GetGlyphOutline- mit uFormat- gleich 1 zurückgegeben. |
Beispiele
Im folgenden Codebeispiel wird gezeigt, 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");
Anmerkung
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 Code, der nicht codierungsneutral ist, 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 |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | wingdi.h |
| Library | Opengl32.lib |
| DLL- | Opengl32.dll |