Функция D3DXCreateFont

Создает объект шрифта для устройства и шрифта.

Синтаксис

HRESULT D3DXCreateFont(
  _In_  LPDIRECT3DDEVICE9 pDevice,
  _In_  INT               Height,
  _In_  UINT              Width,
  _In_  UINT              Weight,
  _In_  UINT              MipLevels,
  _In_  BOOL              Italic,
  _In_  DWORD             CharSet,
  _In_  DWORD             OutputPrecision,
  _In_  DWORD             Quality,
  _In_  DWORD             PitchAndFamily,
  _In_  LPCTSTR           pFacename,
  _Out_ LPD3DXFONT        *ppFont
);

Параметры

pDevice [in]

Тип: LPDIRECT3DDEVICE9

Указатель на интерфейс IDirect3DDevice9 , устройство, связанное с объектом шрифта.

Высота [in]

Тип: INT

Высота символов в логических единицах.

Ширина [in]

Тип: UINT

Ширина символов в логических единицах.

Вес [in]

Тип: UINT

Вес шрифта. Один из примеров — полужирный.

MipLevels [in]

Тип: UINT

Количество уровней MIP-карты.

Курсив [in]

Тип: BOOL

Значение true для курсивного шрифта, в противном случае — false.

CharSet [in]

Тип: DWORD

Набор символов шрифта.

OutputPrecision [in]

Тип: DWORD

Указывает, как Windows должна пытаться сопоставить требуемые размеры и характеристики шрифтов с фактическими шрифтами. Например, используйте OUT_TT_ONLY_PRECIS, чтобы всегда получать шрифт TrueType.

Quality [in]

Тип: DWORD

Указывает, как Windows должна сопоставлять нужный шрифт с реальным шрифтом. Он применяется только к растровых шрифтам и не должен влиять на шрифты TrueType.

PitchAndFamily [in]

Тип: DWORD

Тон и индекс семейства.

pFacename [in]

Тип: LPCTSTR

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

ppFont [out]

Тип: LPD3DXFONT*

Возвращает указатель на интерфейс ID3DXFont , представляющий созданный объект font.

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

Тип: HRESULT

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

Комментарии

Для создания объекта ID3DXFont требуется, чтобы устройство поддерживало 32-разрядный цвет.

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

Дополнительные сведения о параметрах шрифта см. в разделе Логический шрифт.

Требования

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

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

Функции общего назначения