Функция D3DXCreateText

Создает сетку, содержащую указанный текст, используя шрифт, связанный с контекстом устройства.

Синтаксис

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

Параметры

pDevice [in]

Тип: LPDIRECT3DDEVICE9

Указатель на устройство, создающее сетку.

hDC [in]

Тип: HDC

Контекст устройства, содержащий шрифт для выходных данных. Шрифт, выбранный контекстом устройства, должен быть шрифтом TrueType.

pText [in]

Тип: LPCTSTR

Указатель на строку, указывающую создаваемый текст. Если для параметров компилятора требуется Юникод, тип данных LPCTSTR разрешается в LPCWSTR. В противном случае строковый тип данных разрешается в LPCSTR. См. заметки.

Отклонение [in]

Тип: FLOAT

Максимальное отклонение аккордов от контуров шрифтов TrueType.

Экструзия [in]

Тип: FLOAT

Сумма для выдавлия текст в отрицательном Z-направлении.

ppMesh [out]

Тип: LPD3DXMESH*

Указатель на возвращенную сетку.

ppAdjacency [out]

Тип: LPD3DXBUFFER*

Указатель на буфер, содержащий сведения о смежности. Может иметь значение NULL.

pGlyphMetrics [out]

Тип: LPGLYPHMETRICSFLOAT

Указатель на массив структур GLYPHMETRICSFLOAT , содержащих данные метрик глифа. Каждый элемент содержит сведения о положении и ориентации соответствующего глифа в строке. Количество элементов в массиве должно быть равно количеству символов в строке. Обратите внимание, что источник в каждой структуре не связан со всей строкой, а относительно этой символьной ячейки. Чтобы вычислить весь ограничивающий прямоугольник, добавьте приращение для каждого глифа при обходе строки. Если размеры глифов не касаются, задайте для этого параметра значение NULL.

Возвращаемое значение

Тип: HRESULT

Если функция выполняется успешно, возвращаемое значение будет D3D_OK. В случае сбоя функции возвращается одно из следующих значений: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA E_OUTOFMEMORY.

Комментарии

Параметр компилятора также определяет версию функции. Если определен Юникод, вызов функции разрешается в D3DXCreateTextW. В противном случае вызов функции разрешается в D3DXCreateTextA, так как используются строки ANSI.

Эта функция создает сетку с параметром создания D3DXMESH_MANAGED и D3DFVF_XYZ | D3DFVF_NORMAL гибкий формат вершин (FVF).

Требования

Требование	Значение
Заголовок	D3dx9shape.h
Библиотека	D3dx9.lib

См. также раздел

Функции рисования фигур