Функция D3DXLoadVolumeFromResource

Статья
06/13/2023

Загружает том из ресурса.

Синтаксис

HRESULT D3DXLoadVolumeFromResource(
  _In_       LPDIRECT3DVOLUME9 pDestVolume,
  _In_ const PALETTEENTRY      *pDestPalette,
  _In_ const D3DBOX            *pDestBox,
  _In_       HMODULE           hSrcModule,
  _In_       LPCSTR            pSrcResource,
  _In_ const D3DBOX            *pSrcBox,
  _In_       DWORD             Filter,
  _In_       D3DCOLOR          ColorKey,
  _In_       D3DXIMAGE_INFO    *pSrcInfo
);

Параметры

pDestVolume [in]

Тип: LPDIRECT3DVOLUME9

Указатель на интерфейс IDirect3DVolume9 . Указывает целевой том.

pDestPalette [in]

Тип: const PALETTEENTRY*

Указатель на структуру PALETTEENTRY , конечную палитру из 256 цветов или null.

pDestBox [in]

Тип: const D3DBOX*

Указатель на структуру D3DBOX . Указывает целевое поле. Присвойте этому параметру значение NULL , чтобы указать весь том.

hSrcModule [in]

Тип: HMODULE

Дескриптор для модуля, в котором находится ресурс, или значение NULL для модуля, связанного с образом, используемым операционной системой для создания текущего процесса.

pSrcResource [in]

Тип: LPCSTR

Указатель на строку, указывающую имя файла исходного образа. Если определены юникод или _UNICODE, этот тип параметра — LPCWSTR, в противном случае — LPCSTR.

pSrcBox [in]

Тип: const D3DBOX*

Указатель на структуру D3DBOX . Указывает поле источника. Присвойте этому параметру значение NULL , чтобы указать весь том.

Фильтр [в]

Тип: DWORD

Сочетание одного или нескольких D3DX_FILTER, управляющих фильтрацией изображения. Указание D3DX_DEFAULT для этого параметра эквивалентно указанию D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER.

ColorKey [in]

Тип: D3DCOLOR

Значение D3DCOLOR для замены прозрачным черным цветом или значение 0 для отключения клавиши colorkey. Это всегда 32-разрядный цвет ARGB, независимо от формата исходного изображения. Альфа имеет важное значение, и для непрозрачных цветовых ключей обычно должно быть задано значение FF. Таким образом, для непрозрачного черного цвета значение будет равно 0xFF000000.

pSrcInfo [in]

Тип: D3DXIMAGE_INFO*

Указатель на D3DXIMAGE_INFO структуру, заполняемую описанием данных в исходном файле изображения или значением NULL.

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

Тип: HRESULT

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

Запись на неуровневую поверхность текстуры тома не приведет к обновлению прямоугольника грязное. Если вызывается D3DXLoadVolumeFromFile и текстура еще не была грязное (это маловероятно в обычных сценариях использования), приложение должно явно вызвать IDirect3DVolumeTexture9::AddDirtyBox в текстуре тома.

Эта функция поддерживает строки Юникода и ANSI.

Требования

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

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

D3DXLoadVolumeFromFile
D3DXLoadVolumeFromFileInMemory
D3DXLoadVolumeFromMemory
D3DXLoadVolumeFromVolume
Функции текстур в D3DX 9

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