Función D3DXCreateText

Crea una malla que contiene el texto especificado, utilizando la fuente asociada al contexto del dispositivo.

Sintaxis

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

Parámetros

pDevice [in]

Tipo: LPDIRECT3DDEVICE9

Puntero al dispositivo que creó la malla.

hDC [in]

Tipo: HDC

Contexto del dispositivo, que contiene la fuente para la salida. La fuente seleccionada por el contexto del dispositivo debe ser una fuente TrueType.

pText [in]

Tipo: LPCTSTR

Puntero a una cadena que especifica el texto que se va a generar. Si la configuración del compilador requiere Unicode, el tipo de datos LPCTSTR se resuelve en LPCWSTR. De lo contrario, el tipo de datos de cadena se resuelve en LPCSTR. Vea la sección Comentarios.

Desviación [in]

Tipo: FLOAT

Desviación de acorde máxima de esquemas de fuente TrueType.

Extrusión [in]

Tipo: FLOAT

Cantidad de texto extruido en la dirección z negativa.

ppMesh [out]

Tipo: LPD3DXMESH*

Puntero a la malla devuelta.

ppAdjacency [out]

Tipo: LPD3DXBUFFER*

Puntero a un búfer que contiene información de adyacencia. Puede ser NULL.

pGlyphMetrics [out]

Tipo: LPGLYPHMETRICSFLOAT

Puntero a una matriz de estructuras GLYPHMETRICSFLOAT que contienen los datos de métricas del glifo. Cada elemento contiene información sobre la posición y la orientación del glifo correspondiente en la cadena. El número de elementos de la matriz debe ser igual al número de caracteres de la cadena. Tenga en cuenta que el origen de cada estructura no es relativo a toda la cadena, sino que es relativo a esa celda de caracteres. Para calcular todo el rectángulo de selección, agregue el incremento de cada glifo mientras recorre la cadena. Si no le preocupa el tamaño del glifo, establezca este parámetro en NULL.

Valor devuelto

Tipo: HRESULT

Si la función se realiza correctamente, el valor devuelto se D3D_OK. Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Comentarios

La configuración del compilador también determina la versión de la función. Si se define Unicode, la llamada de función se resuelve en D3DXCreateTextW. De lo contrario, la llamada de función se resuelve en D3DXCreateTextA porque se usan cadenas ANSI.

Esta función crea una malla con la opción de creación D3DXMESH_MANAGED y D3DFVF_XYZ | D3DFVF_NORMAL formato de vértice flexible (FVF).

Requisitos

Consulte también

Funciones de dibujo de formas