fonction wglUseFontBitmapsA (wingdi.h)

Article
08/27/2023

La fonction wglUseFontBitmaps crée un ensemble de listes d’affichage bitmap à utiliser dans le contexte de rendu OpenGL actuel. L’ensemble de listes d’affichage bitmap est basé sur les glyphes de la police actuellement sélectionnée dans le contexte de l’appareil. Vous pouvez ensuite utiliser des bitmaps pour dessiner des caractères dans une image OpenGL.

La fonction wglUseFontBitmaps crée des listes d’affichage de nombre , une pour chacune d’une série de glyphes de nombre qui commence par le premier glyphe dans les polices sélectionnées du paramètre hdc .

Syntaxe

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

Paramètres

unnamedParam1

Spécifie le contexte d’appareil dont la police actuellement sélectionnée sera utilisée pour former les listes d’affichage bitmap de glyphe dans le contexte de rendu OpenGL actuel.

unnamedParam2

Spécifie le premier glyphe de l’exécution des glyphes qui seront utilisés pour former des listes d’affichage bitmap de glyphes.

unnamedParam3

Spécifie le nombre de glyphes dans l’exécution des glyphes qui seront utilisés pour former des listes d’affichage bitmap de glyphes. La fonction crée des listes d’affichage de nombre , une pour chaque glyphe dans l’exécution.

unnamedParam4

Spécifie une liste d’affichage de départ.

Valeur retournée

Si la fonction réussit, la valeur de retour est TRUE.

Si la fonction échoue, la valeur de retour est FALSE. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

La fonction wglUseFontBitmaps définit lenombre de listes d’affichage dans le contexte de rendu OpenGL actuel. Chaque liste d’affichage a un numéro d’identification, commençant à listBase. Chaque liste d’affichage se compose d’un seul appel à glBitmap. La définition de bitmap listBase + i est extraite du premieri du glyphe + de la police actuellement sélectionnée dans le contexte d’appareil spécifié par hdc. Si un glyphe n’est pas défini, la fonction définit une liste d’affichage vide pour celui-ci.

La fonction wglUseFontBitmaps crée du texte bitmap dans le plan de l’écran. Il permet l’étiquetage des objets dans OpenGL.

Dans la version actuelle de l’implémentation d’OpenGL par Microsoft, vous ne pouvez pas effectuer d’appels GDI à un contexte d’appareil qui a un format de pixel à double mise en mémoire tampon. Par conséquent, vous ne pouvez pas utiliser les polices GDI et les fonctions de texte avec ces contextes d’appareil. Vous pouvez utiliser la fonction wglUseFontBitmaps pour contourner cette limitation et dessiner du texte dans un contexte d’appareil à double mise en mémoire tampon.

La fonction détermine les paramètres de chaque appel à glBitmap comme suit.

paramètre glBitmap	Signification
width	Largeur de la bitmap du glyphe, comme retourné dans le membre gmBlackBoxX de la structure GLYPHMETRICS du glyphe .
height	Hauteur de l’image bitmap du glyphe, comme retourné dans le membre gmBlackBoxY de la structure GLYPHMETRICS du glyphe .
xorig	Décalage x de l’origine du glyphe, tel que retourné dans le membre gmptGlyphOrigin.x de la structure GLYPHMETRICS du glyphe .
yorig	Décalage y de l’origine du glyphe, tel que retourné dans le membre gmptGlyphOrigin.y de la structure GLYPHMETRICS du glyphe .
xmove	Distance horizontale à l’origine de la cellule de caractères suivante, comme retourné dans le membre gmCellIncX de la structure GLYPHMETRICS du glyphe .
ymove	Distance verticale à l’origine de la cellule de caractères suivante, telle que retournée dans le membre gmCellIncY de la structure GLYPHMETRICS du glyphe .
bitmap	Bitmap pour le glyphe, comme retourné par GetGlyphOutline avec uFormat égal à 1.

Exemples

L’exemple de code suivant montre comment utiliser wglUseFontBitmaps pour dessiner du texte.

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");

Notes

L’en-tête wingdi.h définit wglUseFontBitmaps comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wingdi.h
Bibliothèque	Opengl32.lib
DLL	Opengl32.dll