Поделиться через

Функция D3DXCreateTexture

  • Статья

Создает пустую текстуру, при необходимости корректируя вызывающие параметры.

Синтаксис

HRESULT D3DXCreateTexture(
  _In_  LPDIRECT3DDEVICE9  pDevice,
  _In_  UINT               Width,
  _In_  UINT               Height,
  _In_  UINT               MipLevels,
  _In_  DWORD              Usage,
  _In_  D3DFORMAT          Format,
  _In_  D3DPOOL            Pool,
  _Out_ LPDIRECT3DTEXTURE9 *ppTexture
);

Параметры

pDevice [in]

Тип: LPDIRECT3DDEVICE9

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

Ширина [in]

Тип: UINT

Ширина в пикселях. Если это значение равно 0, используется значение 1. См. заметки.

Высота [in]

Тип: UINT

Высота в пикселях. Если это значение равно 0, используется значение 1. См. заметки.

MipLevels [in]

Тип: UINT

Количество запрошенных уровней MIP. Если это значение равно нулю или D3DX_DEFAULT, создается полная цепочка MIP-карты.

Использование [в]

Тип: DWORD

0, D3DUSAGE_RENDERTARGET или D3DUSAGE_DYNAMIC. Установка этого флага D3DUSAGE_RENDERTARGET означает, что поверхность будет использоваться в качестве целевого объекта отрисовки путем вызова метода SetRenderTarget . Если указана D3DUSAGE_RENDERTARGET или D3DUSAGE_DYNAMIC, приложение должно проверка, что устройство поддерживает эту операцию, вызвав Метод CheckDeviceFormat. Дополнительные сведения об использовании динамических текстур см. в разделе Использование динамических текстур.

Формат [in]

Тип: D3DFORMAT

Член перечисленного типа D3DFORMAT , описывающий запрошенный формат пикселей для текстуры. Возвращаемая текстура может иметь формат, отличный от указанного, если устройство не поддерживает запрошенный формат. Приложения должны проверка формат возвращаемой текстуры, чтобы узнать, соответствует ли она запрошенной.

Пул [в]

Тип: D3DPOOL

Член перечисленного типа D3DPOOL , описывающий класс памяти, в который должна быть помещена текстура.

ppTexture [out]

Тип: LPDIRECT3DTEXTURE9*

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

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

Тип: HRESULT

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

Комментарии

Для внутренней настройки параметров вызова D3DXCreateTexture использует D3DXCheckTextureRequirements . Поэтому вызовы D3DXCreateTexture часто выполняются успешно, если вызовы CreateTexture завершаются ошибкой.

Если для параметра Height и Width задано значение D3DX_DEFAULT, для обоих параметров используется значение 256. Если для параметра Height или Width задано значение D3DX_DEFAULT а для другого параметра задано числовое значение, текстура будет квадратной с высотой и шириной, равными числовым значениям.

Требования

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

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

Функции текстур в D3DX 9