Funzione D3DXCreateText

Articolo
06/13/2023

Crea una mesh contenente il testo specificato usando il tipo di carattere associato al contesto del dispositivo.

Sintassi

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

Parametri

pDevice [in]

Tipo: LPDIRECT3DDEVICE9

Puntatore al dispositivo che ha creato la mesh.

hDC [in]

Tipo: HDC

Contesto del dispositivo contenente il tipo di carattere per l'output. Il tipo di carattere selezionato dal contesto del dispositivo deve essere un carattere TrueType.

pText [in]

Tipo: LPCTSTR

Puntatore a una stringa che specifica il testo da generare. Se le impostazioni del compilatore richiedono Unicode, il tipo di dati LPCTSTR viene risolto in LPCWSTR. In caso contrario, il tipo di dati stringa viene risolto in LPCSTR. Vedere la sezione Osservazioni.

Deviazione [in]

Tipo: FLOAT

Deviazione massima dal carattere TrueType.

Estrusione [in]

Tipo: FLOAT

Quantità di testo estruso nella direzione z negativa.

ppMesh [out]

Tipo: LPD3DXMESH*

Puntatore alla mesh restituita.

ppAdjacency [out]

Tipo: LPD3DXBUFFER*

Puntatore a un buffer contenente informazioni sull'adjacency. Può essere NULL.

pGlyphMetrics [out]

Tipo: LPGLYPHMETRICSFLOAT

Puntatore a una matrice di strutture GLYPHMETRICSFLOAT che contengono i dati delle metriche del glifo. Ogni elemento contiene informazioni sulla posizione e sull'orientamento del glifo corrispondente nella stringa. Il numero di elementi nella matrice deve essere uguale al numero di caratteri nella stringa. Si noti che l'origine in ogni struttura non è relativa all'intera stringa, ma piuttosto è relativa a tale cella di caratteri. Per calcolare l'intero rettangolo di selezione, aggiungere l'incremento per ogni glifo durante l'attraversamento della stringa. Se non si è interessati alle dimensioni del glifo, impostare questo parametro su NULL.

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, il valore restituito è D3D_OK. Se la funzione ha esito negativo, il valore restituito può essere uno dei seguenti: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Commenti

L'impostazione del compilatore determina anche la versione della funzione. Se Unicode è definito, la chiamata alla funzione viene risolta in D3DXCreateTextW. In caso contrario, la chiamata alla funzione viene risolta in D3DXCreateTextA perché vengono usate stringhe ANSI.

Questa funzione crea una mesh con l'opzione di creazione D3DXMESH_MANAGED e D3DFVF_XYZ | D3DFVF_NORMAL formato del vertice flessibile (FVF).

Requisiti

Requisito	Valore
Intestazione	D3dx9shape.h
Libreria	D3dx9.lib

Vedi anche

Funzioni disegno forma

Condividi tramite