Функция D3DXLoadVolumeFromResource
Загружает том из ресурса.
Синтаксис
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.
Комментарии
Загружаемый ресурс должен быть ресурсом растрового изображения(RT_BITMAP).
Эта функция обрабатывает преобразование в сжатые форматы текстур и из нее.
Запись на неуровневую поверхность текстуры тома не приведет к обновлению прямоугольника грязное. Если вызывается D3DXLoadVolumeFromFile и текстура еще не была грязное (это маловероятно в обычных сценариях использования), приложение должно явно вызвать IDirect3DVolumeTexture9::AddDirtyBox в текстуре тома.
Эта функция поддерживает строки Юникода и ANSI.
Требования
| Требование | Значение |
|---|---|
| Заголовок |
|
| Библиотека |
|
См. также раздел