D3DXCreateText fonction)

Crée un maillage contenant le texte spécifié, à l’aide de la police associée au contexte de périphérique.

Syntaxe

HRESULT D3DXCreateText(
  _In_  LPDIRECT3DDEVICE9   pDevice,
  _In_  HDC                 hDC,
  _In_  LPCTSTR             pText,
  _In_  FLOAT               Deviation,
  _In_  FLOAT               Extrusion,
  _Out_ LPD3DXMESH          *ppMesh,
  _Out_ LPD3DXBUFFER        *ppAdjacency,
  _Out_ LPGLYPHMETRICSFLOAT pGlyphMetrics
);

Paramètres

pDevice [ dans]

Type : LPDIRECT3DDEVICE9

Pointeur vers l’appareil qui a créé le maillage.

HDC [ dans]

Type : HDC

Contexte de périphérique, contenant la police de sortie. La police sélectionnée par le contexte de périphérique doit être une police TrueType.

pText [ dans]

Type : LPCTSTR

Pointeur vers une chaîne qui spécifie le texte à générer. Si les paramètres du compilateur requièrent Unicode, le type de données LPCTSTR est résolu en LPCWSTR. Dans le cas contraire, le type de données String est résolu en LPCSTR. Consultez la section Notes.

Écart [ dans]

Type : float

Écart de corde maximal à partir des contours de police TrueType.

Extrusion [ dans]

Type : float

Quantité d’extrusion du texte dans l’axe z négatif.

ppMesh [ à]

Type : LPD3DXMESH*

Pointeur vers le maillage retourné.

ppAdjacency [ à]

Type : LPD3DXBUFFER*

Pointeur vers une mémoire tampon qui contient des informations d’adjacence. Peut avoir la valeur null.

pGlyphMetrics [ à]

Type : LPGLYPHMETRICSFLOAT

Pointeur vers un tableau de structures GLYPHMETRICSFLOAT qui contiennent les données de métrique de glyphe. Chaque élément contient des informations sur la position et l’orientation du glyphe correspondant dans la chaîne. Le nombre d’éléments dans le tableau doit être égal au nombre de caractères de la chaîne. Notez que l’origine dans chaque structure n’est pas relative à la chaîne entière, mais qu’elle est relative à cette cellule de caractère. Pour calculer l’intégralité du cadre englobant, ajoutez l’incrément pour chaque glyphe tout en parcourant la chaîne. Si vous n’êtes pas concerné par les tailles de glyphe, définissez ce paramètre sur la valeur null.

Valeur retournée

Type : HRESULT

Si la fonction est réussie, la valeur de retour est D3D _ OK. Si la fonction échoue, la valeur de retour peut être l’une des suivantes : D3DERR _ INVALIDCALL, D3DXERR _ sera déplacé, E _ OUTOFMEMORY.

Remarques

Le paramètre du compilateur détermine également la version de la fonction. Si Unicode est défini, l’appel de fonction est résolu en D3DXCreateTextW. Dans le cas contraire, l’appel de fonction est résolu en D3DXCreateTextA, car les chaînes ANSI sont utilisées.

Cette fonction crée une maille avec l' _ option de création managée D3DXMESH et D3DFVF _ xyz | D3DFVF _ le format de vertex flexible normal.

Configuration requise

Condition requise Valeur
En-tête
D3dx9shape. h
Bibliothèque
D3dx9. lib

Voir aussi

Fonctions de dessin de forme