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 |
|
| Bibliothèque |
|