D3DXCreateText, fonction

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

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 [in]

Type : LPDIRECT3DDEVICE9

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

hDC [in]

Type : HDC

Contexte de l’appareil, contenant la police pour la sortie. La police sélectionnée par le contexte de l’appareil doit être une police TrueType.

pText [in]

Type : LPCTSTR

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

Écart [in]

Type : FLOAT

Écart chordal maximal par rapport aux contours de police TrueType.

Extrusion [in]

Type : FLOAT

Montant à extruder du texte dans la direction z négative.

ppMesh [out]

Type : LPD3DXMESH*

Pointeur vers le maillage retourné.

ppAdjacency [out]

Type : LPD3DXBUFFER*

Pointeur vers une mémoire tampon contenant des informations d’adjacence. Peut être NULL.

pGlyphMetrics [out]

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 dans la chaîne. Notez que l’origine de chaque structure n’est pas relative à la chaîne entière, mais plutôt à cette cellule de caractère. Pour calculer l’intégralité du cadre englobant, ajoutez l’incrément de chaque glyphe tout en parcourant la chaîne. Si vous n’êtes pas concerné par les tailles de glyphes, définissez ce paramètre sur NULL.

Valeur retournée

Type : HRESULT

Si la fonction réussit, la valeur de retour est D3D_OK. Si la fonction échoue, la valeur de retour peut être l’une des suivantes : D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Notes

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. Sinon, l’appel de fonction est résolu en D3DXCreateTextA, car les chaînes ANSI sont utilisées.

Cette fonction crée un maillage avec l’option de création D3DXMESH_MANAGED et D3DFVF_XYZ | D3DFVF_NORMAL format de vertex flexible (FVF).

Spécifications

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

Voir aussi

Fonctions de dessin de forme