Função D3DXCreateText

Cria uma malha que contém o texto especificado, usando a fonte associada ao contexto do dispositivo.

Sintaxe

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

Ponteiro para o dispositivo que criou a malha.

hDC [in]

Tipo: HDC

Contexto do dispositivo, que contém a fonte para saída. A fonte selecionada pelo contexto do dispositivo deve ser uma fonte TrueType.

pText [in]

Tipo: LPCTSTR

Ponteiro para uma cadeia de caracteres que especifica o texto a ser gerado. Se as configurações do compilador exigirem Unicode, o tipo de dados LPCTSTR será resolvido para LPCWSTR. Caso contrário, o tipo de dados de cadeia de caracteres será resolvido para LPCSTR. Consulte Observações.

Desvio [in]

Tipo: FLOAT

Desvio máximo de acordes das estruturas de tópicos da fonte TrueType.

Extrusão [in]

Tipo: FLOAT

Valor para extrusar texto na direção z negativa.

ppMesh [out]

Tipo: LPD3DXMESH*

Ponteiro para a malha retornada.

ppAdjacency [out]

Tipo: LPD3DXBUFFER*

Ponteiro para um buffer que contém informações de adjacência. Pode ser NULL.

pGlyphMetrics [out]

Tipo: LPGLYPHMETRICSFLOAT

Ponteiro para uma matriz de estruturas GLYPHMETRICSFLOAT que contêm os dados de métrica de glifo. Cada elemento contém informações sobre a posição e a orientação do glifo correspondente na cadeia de caracteres. O número de elementos na matriz deve ser igual ao número de caracteres na cadeia de caracteres. Observe que a origem em cada estrutura não é relativa à cadeia de caracteres inteira, mas sim é relativa a essa célula de caractere. Para calcular toda a caixa delimitadora, adicione o incremento para cada glifo ao percorrer a cadeia de caracteres. Se você não estiver preocupado com os tamanhos de glifo, defina esse parâmetro como NULL.

Valor retornado

Tipo: HRESULT

Se a função for bem-sucedida, o valor retornado será D3D_OK. Se a função falhar, o valor retornado poderá ser um dos seguintes: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA E_OUTOFMEMORY.

Comentários

A configuração do compilador também determina a versão da função. Se Unicode for definido, a chamada de função será resolvida para D3DXCreateTextW. Caso contrário, a chamada de função será resolvida para D3DXCreateTextA porque cadeias de caracteres ANSI estão sendo usadas.

Essa função cria uma malha com a opção de criação D3DXMESH_MANAGED e D3DFVF_XYZ | D3DFVF_NORMAL FVF (formato de vértice flexível).

Requisitos

Requisito	Valor
parâmetro	D3dx9shape.h
Biblioteca	D3dx9.lib

Confira também

Funções de desenho de forma