Функция D3DX10CreateFont

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

Примечание

Вместо этой функции рекомендуется использовать DirectWrite и библиотеку DirectXTK, класс SpriteFont.

 

Синтаксис

HRESULT D3DX10CreateFont(
  _In_  ID3D10Device *pDevice,
  _In_  INT          Height,
  _In_  UINT         Width,
  _In_  UINT         Weight,
  _In_  UINT         MipLevels,
  _In_  BOOL         Italic,
  _In_  UINT         CharSet,
  _In_  UINT         OutputPrecision,
  _In_  UINT         Quality,
  _In_  UINT         PitchAndFamily,
  _In_  LPCTSTR      pFaceName,
  _Out_ LPD3DX10FONT *ppFont
);

Параметры

pDevice [in]

Тип: ID3D10Device*

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

Высота [in]

Тип: INT

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

Ширина [in]

Тип: UINT

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

Вес [in]

Тип: UINT

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

MipLevels [in]

Тип: UINT

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

Курсив [ in]

Тип: BOOL

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

CharSet [in]

Тип: UINT

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

OutputPrecision [in]

Тип: UINT

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

Качество [в]

Тип: UINT

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

PitchAndFamily [in]

Тип: UINT

Индекс тона и семьи.

pFaceName [in]

Тип: LPCTSTR

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

ppFont [out]

Тип: LPD3DX10FONT*

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

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

Тип: HRESULT

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

Комментарии

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

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

Требования

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

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

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