wglUseFontOutlinesA, fonction (wingdi.h)

Article
08/27/2023

La fonction wglUseFontOutlines crée un ensemble de listes d’affichage, une pour chaque glyphe de la police hiérarchique actuellement sélectionnée d’un contexte d’appareil, à utiliser avec le contexte de rendu actuel. Les listes d’affichage sont utilisées pour dessiner des caractères 3D de polices TrueType. Chaque liste d’affichage décrit un contour de glyphe en coordonnées à virgule flottante.

L’exécution des glyphes commence par le firstglyphe de la police du contexte d’appareil spécifié. La taille carrée de la police, la taille de grille notionnelle du contour de police d’origine à partir de laquelle la police est ajustée, est mappée à 1,0 dans les coordonnées x et y des listes d’affichage. Le paramètre d’extrusion définit la profondeur de la police dans la direction z.

Thelpgmfparameter retourne une structure GLYPHMETRICSFLOAT qui contient des informations sur le positionnement et l’orientation de chaque glyphe dans une cellule de caractères.

Syntaxe

BOOL wglUseFontOutlinesA(
  HDC                 unnamedParam1,
  DWORD               unnamedParam2,
  DWORD               unnamedParam3,
  DWORD               unnamedParam4,
  FLOAT               unnamedParam5,
  FLOAT               unnamedParam6,
  int                 unnamedParam7,
  LPGLYPHMETRICSFLOAT unnamedParam8
);

Paramètres

unnamedParam1

Spécifie le contexte de l’appareil avec la police de plan souhaitée. La police de plan de hdc est utilisée pour créer les listes d’affichage dans le contexte de rendu actuel.

unnamedParam2

Spécifie le premier de l’ensemble de glyphes qui forment les listes d’affichage du plan de police.

unnamedParam3

Spécifie le nombre de glyphes dans l’ensemble de glyphes utilisés pour former les listes d’affichage du plan de police. La fonction wglUseFontOutlines crée des listes d’affichage de nombre , une liste d’affichage pour chaque glyphe dans un ensemble de glyphes.

unnamedParam4

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

unnamedParam5

Spécifie l’écart chordal maximal par rapport aux contours d’origine. Lorsque l’écart est égal à zéro, l’écart chordal équivaut à une unité de conception de la police d’origine. La valeur de l’écart doit être égale ou supérieure à 0.

unnamedParam6

Spécifie la quantité d’extrudées d’une police dans la direction z négative. La valeur doit être égale ou supérieure à 0. Lorsque l’extrusion est 0, les listes d’affichage ne sont pas extrudées.

unnamedParam7

Spécifie le format, WGL_FONT_LINES ou WGL_FONT_POLYGONS, à utiliser dans les listes d’affichage. Lorsque le format est WGL_FONT_LINES, la fonction wglUseFontOutlines crée des polices avec des segments de ligne. Lorsque le format est WGL_FONT_POLYGONS, wglUseFontOutlines crée des polices avec des polygones.

unnamedParam8

Pointe vers un tableau de structures GLYPHMETRICSFLOAT de comptage qui doit recevoir les métriques des glyphes. Lorsque lpgmf a la valeur NULL, aucune métrique de glyphe n’est retournée.

Valeur retournée

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

En cas d’échec de la fonction, la valeur de retour est FALSE et aucune liste d’affichage n’est générée. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

La fonction wglUseFontOutlines définit les glyphes d’une police de plan avec des listes d’affichage dans le contexte de rendu actuel. La fonction wglUseFontOutlines fonctionne uniquement avec les polices TrueType ; Les polices de trait et de raster ne sont pas prises en charge.

Chaque liste d’affichage se compose de segments de ligne ou de polygones, et possède un numéro d’identification unique commençant par le nombre listBase .

La fonction wglUseFontOutlines se rapproche des contours de glyphe en subdivisant les courbes B-spline quadratiques du contour en segments de ligne, jusqu’à ce que la distance entre le contour et le point intermédiaire interpolé soit comprise dans la valeur spécifiée par écart. Il s’agit du format final utilisé lorsque le format est WGL_FONT_LINES. Lorsque vous spécifiez WGL_FONT_OUTLINES, les listes d’affichage créées ne contiennent pas de normales ; ainsi l’éclairage ne fonctionne pas correctement. Pour obtenir l’éclairage correct des lignes, utilisez WGL_FONT_POLYGONS et définissez glPolygonMode( GL_FRONT, GL_LINE ). Lorsque vous spécifiez le format comme WGL_FONT_POLYGONS les contours sont ensuite convertis en triangles distincts, ventilateurs de triangles, bandes de triangles ou bandes quadrilatérales pour créer la surface de chaque glyphe. Avec WGL_FONT_POLYGONS, les listes d’affichage créées appellent glFrontFace( GL_CW ) ou glFrontFace( GL_CCW ); par conséquent, la valeur frontale actuelle peut être modifiée. Pour une apparence optimale du texte avec WGL_FONT_POLYGONS, découpez les faces arrière comme suit :

glCullFace(GL_BACK); 
glEnable(GL_CULL_FACE);

Une structure GLYPHMETRICSFLOAT contient des informations sur le positionnement et l’orientation de chaque glyphe dans une cellule de caractères. Le paramètre lpgmf est un tableau de structures GLYPHMETRICSFLOAT contenant l’ensemble entier des glyphes d’une police. Chaque liste d’affichage se termine par une traduction spécifiée avec les membres gmfCellIncX et gmfCellIncY de la structure GLYPHMETRICSFLOAT correspondante. La traduction permet de dessiner des caractères successifs dans leur sens naturel avec un seul appel à glCallLists.

Note Avec OpenGL pour Windows, vous ne pouvez pas effectuer d’appels GDI vers un contexte d’appareil lorsqu’un format de pixel est mis en mémoire tampon double. Vous pouvez contourner cette limitation en utilisant wglUseFontOutlines et wglUseFontBitmaps, lorsque vous utilisez des contextes d’appareil à double mise en mémoire tampon.

Exemples

L’exemple de code suivant montre comment dessiner du texte à l’aide de wglUseFontOutlines.

HDC    hdc;  // A TrueType font has already been selected  
HGLRC  hglrc; 
GLYPHMETRICSFLOAT agmf[256]; 
 
// Make hglrc the calling thread's current rendering context  
wglMakeCurrent(hdc, hglrc); 
 
// create display lists for glyphs 0 through 255 with 0.1 extrusion  
// and default deviation. The display list numbering starts at 1000  
// (it could be any number)  
wglUseFontOutlines(hdc, 0, 255, 1000, 0.0f, 0.1f,  
            WGL_FONT_POLYGONS, &agmf); 
 
// Set up transformation to draw the string  
glLoadIdentity(); 
glTranslate(0.0f, 0.0f, -5.0f) 
glScalef(2.0f, 2.0f, 2.0f); 
 
// Display a string  
glListBase(1000); // Indicates the start of display lists for the glyphs  
// Draw the characters in a string  
glCallLists(24, GL_UNSIGNED_BYTE, "Hello Windows OpenGL World.");

Notes

L’en-tête wingdi.h définit wglUseFontOutlines comme 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. La combinaison 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


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