wglUseFontBitmapsW-Funktion (wingdi.h)

Artikel
08/27/2023

Die wglUseFontBitmaps-Funktion erstellt einen Satz 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 Anzeigelisten für die Anzahl, 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 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 Bitmapanzeigelisten für Glyphen im aktuellen OpenGL-Renderingkontext zu bilden.

unnamedParam2

Gibt die erste Glyphe in der Ausführung von Glyphen an, die zum Erstellen von Bitmapanzeigelisten für Glyphen verwendet wird.

unnamedParam3

Gibt die Anzahl der Glyphen in der Ausführung von Glyphen an, die zum Erstellen von Bitmapanzeigelisten für Glyphen verwendet werden. Die Funktion erstellt Listen zur Anzeige der Anzahl , 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 Die Anzahl der Anzeigelisten im aktuellen OpenGL-Renderingkontext. Jede Anzeigeliste hat eine identifizierende Nummer, beginnend bei 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 Beschriftung von Objekten in OpenGL.

In der aktuellen Version der Microsoft-Implementierung von OpenGL können Sie keine GDI-Aufrufe an einen Gerätekontext durchführen, 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 GLYPHMETRICS-Struktur zurückgegeben wird.
height	Die Höhe der Bitmap der Glyphe, wie sie im gmBlackBoxY-Element der GLYPHMETRICS-Struktur der GLYPHMETRICS-Struktur zurückgegeben wird.
xorig	Der x-Offset des Glyphenursprungs, der im Member gmptGlyphOrigin.x der GLYPHMETRICS-Struktur der glyph zurückgegeben wird.
yorig	Der y-Offset des Glyphenursprungs, wie er im Member gmptGlyphOrigin.y der GLYPHMETRICS-Struktur der glyphe zurückgegeben wird.
Xmove	Der horizontale Abstand zum Ursprung der nächsten Zeichenzelle, wie er im gmCellIncX-Element der GLYPHMETRICS-Struktur der GLYPHMETRICS-Struktur zurückgegeben wird.
ymove	Der vertikale Abstand zum Ursprung der nächsten Zeichenzelle, wie er im gmCellIncY-Element der GLYPHMETRICS-Struktur der GLYPHMETRICS-Struktur zurückgegeben wird.
Bitmap	Die Bitmap für die Glyphe, wie von GetGlyphOutline mit uFormat gleich 1 zurückgegeben.

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 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
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