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

Функция D3DXLoadSurfaceFromResource

  • Статья

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

Синтаксис

HRESULT D3DXLoadSurfaceFromResource(
  _In_          LPDIRECT3DSURFACE9 pDestSurface,
  _In_    const PALETTEENTRY       *pDestPalette,
  _In_    const RECT               *pDestRect,
  _In_          HMODULE            hSrcModule,
  _In_          LPCTSTR            pSrcResource,
  _In_    const RECT               *pSrcRect,
  _In_          DWORD              Filter,
  _In_          D3DCOLOR           ColorKey,
  _Inout_       D3DXIMAGE_INFO     *pSrcInfo
);

Параметры

pDestSurface [in]

Тип: LPDIRECT3DSURFACE9

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

pDestPalette [in]

Тип: const PALETTEENTRY*

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

pDestRect [in]

Тип: const RECT*

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

hSrcModule [in]

Тип: HMODULE

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

pSrcResource [in]

Тип: LPCTSTR

Указатель на строку, указывающую имя ресурса. Если для параметров компилятора требуется Юникод, тип данных LPCTSTR разрешается в LPCWSTR. В противном случае строковый тип данных разрешается в LPCSTR. См. заметки.

pSrcRect [in]

Тип: const RECT*

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

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

Тип: DWORD

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

ColorKey [in]

Тип: D3DCOLOR

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

pSrcInfo [вход, выход]

Тип: D3DXIMAGE_INFO*

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

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

Тип: HRESULT

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

Комментарии

Параметр компилятора также определяет версию функции. Если определен Юникод, вызов функции разрешается в D3DXLoadSurfaceFromResourceW. В противном случае вызов функции разрешается в D3DXLoadSurfaceFromResourceA, так как используются строки ANSI.

Загружаемый ресурс должен иметь тип RT_BITMAP или RT_RCDATA. Тип ресурса RT_RCDATA используется для загрузки форматов, отличных от растровых изображений (например, TGA, .jpg и DDS).

Эта функция обрабатывает преобразование в сжатые форматы текстур и из нее.

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

Требования

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

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

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