Функция D3DXLoadSurfaceFromMemory

Статья
06/13/2023

Загружает поверхность из памяти.

Синтаксис

HRESULT D3DXLoadSurfaceFromMemory(
  _In_       LPDIRECT3DSURFACE9 pDestSurface,
  _In_ const PALETTEENTRY       *pDestPalette,
  _In_ const RECT               *pDestRect,
  _In_       LPCVOID            pSrcMemory,
  _In_       D3DFORMAT          SrcFormat,
  _In_       UINT               SrcPitch,
  _In_ const PALETTEENTRY       *pSrcPalette,
  _In_ const RECT               *pSrcRect,
  _In_       DWORD              Filter,
  _In_       D3DCOLOR           ColorKey
);

Параметры

pDestSurface [in]

Тип: LPDIRECT3DSURFACE9

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

pDestPalette [in]

Тип: const PALETTEENTRY*

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

pDestRect [in]

Тип: const RECT*

Указатель на структуру RECT . Задает прямоугольник назначения. Присвойте этому параметру значение NULL , чтобы указать всю поверхность.

pSrcMemory [in]

Тип: LPCVOID

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

SrcFormat [in]

Тип: D3DFORMAT

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

SrcPitch [in]

Тип: UINT

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

pSrcPalette [in]

Тип: const PALETTEENTRY*

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

pSrcRect [in]

Тип: const RECT*

Указатель на структуру RECT . Задает размеры исходного изображения в памяти. Это значение не может иметь значение NULL.

Фильтр [в]

Тип: DWORD

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

ColorKey [in]

Тип: D3DCOLOR

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

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

Тип: HRESULT

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

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

Требования

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

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

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

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