Функция D3DXCreateCubeTextureFromFileInMemoryEx
Создает текстуру куба из файла в памяти. Это более расширенная функция, чем D3DXCreateCubeTextureFromFileInMemory.
Синтаксис
HRESULT D3DXCreateCubeTextureFromFileInMemoryEx(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ LPCVOID pSrcData,
_In_ UINT SrcDataSize,
_In_ UINT Size,
_In_ UINT MipLevels,
_In_ DWORD Usage,
_In_ D3DFORMAT Format,
_In_ D3DPOOL Pool,
_In_ DWORD Filter,
_In_ DWORD MipFilter,
_In_ D3DCOLOR ColorKey,
_Inout_ D3DXIMAGE_INFO *pSrcInfo,
_Out_ PALETTEENTRY *pPalette,
_Out_ LPDIRECT3DCUBETEXTURE9 *ppCubeTexture
);
Параметры
-
pDevice [in]
-
Тип: LPDIRECT3DDEVICE9
Указатель на интерфейс IDirect3DDevice9 , представляющий устройство, связанное с текстурой куба.
-
pSrcData [in]
-
Тип: LPCVOID
Указатель на файл в памяти, из которого создается текстура куба. См. заметки.
-
SrcDataSize [in]
-
Тип: UINT
Размер файла в памяти в байтах.
-
Размер [in]
-
Тип: UINT
Ширина (или высота) в пикселях. Если это значение равно нулю или D3DX_DEFAULT, измерения берутся из файла.
-
MipLevels [in]
-
Тип: UINT
Количество запрошенных уровней MIP. Если это значение равно нулю или D3DX_DEFAULT, создается полная цепочка MIP-карты.
-
Использование [in]
-
Тип: DWORD
0, D3DUSAGE_RENDERTARGET или D3DUSAGE_DYNAMIC. Присвоение этому флагу значения D3DUSAGE_RENDERTARGET указывает, что поверхность будет использоваться в качестве целевого объекта отрисовки. Затем ресурс можно передать в параметр pNewRenderTarget метода SetRenderTarget . Если указано D3DUSAGE_RENDERTARGET, приложение должно проверка, что устройство поддерживает эту операцию, вызвав Метод CheckDeviceFormat. Дополнительные сведения об использовании динамических текстур см. в разделе Использование динамических текстур.
-
Формат [in]
-
Тип: D3DFORMAT
Член перечисленного типа D3DFORMAT , описывающий запрошенный формат пикселей для текстуры куба. Возвращаемая текстура может иметь формат, отличный от формата, заданного параметром Format. Приложения должны проверка формат возвращаемой текстуры. Если D3DFMT_UNKNOWN, формат берется из файла. Если D3DFMT_FROM_FILE, формат принимается точно так же, как в файле, и вызов завершится ошибкой, если это нарушает возможности устройства.
-
Пул [вход]
-
Тип: D3DPOOL
Член перечисленного типа D3DPOOL , описывающий класс памяти, в который должна быть помещена текстура куба.
-
Фильтр [вход]
-
Тип: DWORD
Сочетание одного или нескольких D3DX_FILTER , управляющих фильтрацией изображения. Указание D3DX_DEFAULT для этого параметра эквивалентно указанию D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER.
-
MipFilter [in]
-
Тип: DWORD
Сочетание одного или нескольких D3DX_FILTER , управляющих фильтрацией изображения. Указание D3DX_DEFAULT для этого параметра эквивалентно указанию D3DX_FILTER_BOX. Кроме того, используйте биты 27–31, чтобы указать количество пропущенных уровней MIP (из верхней части цепочки MIP-карты) при загрузке текстуры .dds в память; это позволяет пропустить до 32 уровней.
-
ColorKey [in]
-
Тип: D3DCOLOR
Значение D3DCOLOR для замены на прозрачный черный или 0 для отключения цветовой клавиши. Это всегда 32-разрядный цвет ARGB, независимо от формата исходного изображения. Альфа-канал имеет важное значение, и для непрозрачных цветовых ключей обычно следует задать значение FF. Таким образом, для непрозрачного черного цвета значение будет равно 0xFF000000.
-
pSrcInfo [вход, выход]
-
Тип: D3DXIMAGE_INFO*
Указатель на D3DXIMAGE_INFO структуру, заполняемую описанием данных в файле исходного изображения или значением NULL.
-
pPalette [out]
-
Тип: PALETTEENTRY*
Указатель на структуру PALETTEENTRY , представляющую 256-цветовую палитру для заполнения или значение NULL. См. заметки.
-
ppCubeTexture [out]
-
Тип: LPDIRECT3DCUBETEXTURE9*
Адрес указателя на интерфейс IDirect3DCubeTexture9 , представляющий созданный объект текстуры куба.
Возвращаемое значение
Тип: HRESULT
Если функция выполняется успешно, возвращаемое значение будет D3D_OK. В случае сбоя функции возвращаемое значение может быть одним из следующих: D3DERR_INVALIDCALL, D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, D3DXERR_INVALIDDATA E_OUTOFMEMORY.
Комментарии
Эта функция поддерживает следующие форматы файлов: .bmp, DDS, DIB, HDR, .jpg, PFM, .png, PPM и TGA. См . D3DXIMAGE_FILEFORMAT.
Текстуры куба отличаются от других поверхностей тем, что они являются коллекциями поверхностей. Чтобы вызвать SetRenderTarget с текстурой куба, необходимо выбрать отдельное лицо с помощью GetCubeMapSurface и передать полученную поверхность в SetRenderTarget .
Этот метод предназначен для загрузки файлов изображений, хранящихся в виде RT_RCDATA, который является ресурсом, определяемым приложением (необработанные данные). В противном случае этот метод завершится ошибкой.
Дополнительные сведения о PALETTEENTRY см. в разделе Пакет SDK для платформы. Обратите внимание, что в DirectX 8.0 элемент peFlags структуры PALETTEENTRY не работает, как описано в пакете SDK для платформы. Элемент peFlags теперь является альфа-каналом для 8-разрядных палеттизированных форматов.
D3DXCreateCubeTextureFromFileInMemoryEx использует формат файла поверхности DirectDraw (DDS). Редактор текстур DirectX (Dxtex.exe) позволяет создать карту куба из файлов других форматов и сохранить ее в формате DDS. Вы можете получить Dxtex.exe и узнать о нем из пакета SDK для DirectX. Сведения о пакете SDK для DirectX см. в разделе Где находится пакет SDK для DirectX?.
При пропуске уровней MIP-карты при загрузке DDS-файла используйте макрос D3DX_SKIP_DDS_MIP_LEVELS для создания значения MipFilter. Этот макрос принимает количество пропускаемых уровней и тип фильтра и возвращает значение фильтра, которое затем передается в параметр MipFilter.
Требования
| Требование | Значение |
|---|---|
| Заголовок |
|
| Библиотека |
|
См. также раздел