Функция D3DXSaveSurfaceToFile

Статья
06/13/2023

Сохраняет поверхность в файл.

Синтаксис

HRESULT D3DXSaveSurfaceToFile(
  _In_       LPCTSTR              pDestFile,
  _In_       D3DXIMAGE_FILEFORMAT DestFormat,
  _In_       LPDIRECT3DSURFACE9   pSrcSurface,
  _In_ const PALETTEENTRY         *pSrcPalette,
  _In_ const RECT                 *pSrcRect
);

Параметры

pDestFile [in]

Тип: LPCTSTR

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

DestFormat [in]

Тип: D3DXIMAGE_FILEFORMAT

D3DXIMAGE_FILEFORMAT укажите формат файла, используемый при сохранении. Эта функция поддерживает сохранение во всех форматах D3DXIMAGE_FILEFORMAT , кроме переносимого Pixmap (PPM) и графического адаптера Targa/Truevision (TGA).

pSrcSurface [in]

Тип: LPDIRECT3DSURFACE9

Указатель на интерфейс IDirect3DSurface9 , содержащий сохраненное изображение.

pSrcPalette [in]

Тип: const PALETTEENTRY*

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

pSrcRect [in]

Тип: const RECT*

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

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

Тип: HRESULT

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

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

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

Требования

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

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

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