Функция D3DXLoadVolumeFromMemory

Статья
06/13/2023

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

Синтаксис

HRESULT D3DXLoadVolumeFromMemory(
  _In_       LPDIRECT3DVOLUME9 pDestVolume,
  _In_ const PALETTEENTRY      *pDestPalette,
  _In_ const D3DBOX            *pDestBox,
  _In_       LPCVOID           pSrcMemory,
  _In_       D3DFORMAT         SrcFormat,
  _In_       UINT              SrcRowPitch,
  _In_       UINT              SrcSlicePitch,
  _In_ const PALETTEENTRY      *pSrcPalette,
  _In_ const D3DBOX            *pSrcBox,
  _In_       DWORD             Filter,
  _In_       D3DCOLOR          ColorKey
);

Параметры

pDestVolume [in]

Тип: LPDIRECT3DVOLUME9

Указатель на интерфейс IDirect3DVolume9 . Указывает целевой том, который получает изображение.

pDestPalette [in]

Тип: const PALETTEENTRY*

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

pDestBox [in]

Тип: const D3DBOX*

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

pSrcMemory [in]

Тип: LPCVOID

Указатель на левый верхний угол исходного тома в памяти.

SrcFormat [in]

Тип: D3DFORMAT

Член перечисленного типа D3DFORMAT , формат пикселей исходного тома.

SrcRowPitch [in]

Тип: UINT

Шаг исходного изображения в байтах. Для форматов DXT (форматов сжатых текстур) это число должно представлять размер одной строки ячеек в байтах.

SrcSlicePitch [in]

Тип: UINT

Шаг исходного изображения в байтах. Для форматов DXT (форматов сжатых текстур) это число должно представлять размер одного среза ячеек в байтах.

pSrcPalette [in]

Тип: const PALETTEENTRY*

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

pSrcBox [вход]

Тип: const D3DBOX*

Указатель на структуру D3DBOX . Указывает поле источника. Значение NULL не является допустимым значением для этого параметра.

Фильтр [вход]

Тип: DWORD

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

ColorKey [in]

Тип: D3DCOLOR

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

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

Тип: HRESULT

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

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

Требования

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

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

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

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