Функция D3DXSaveTextureToFile

Сохраняет текстуру в файл.

Синтаксис

HRESULT D3DXSaveTextureToFile(
  _In_       LPCTSTR                pDestFile,
  _In_       D3DXIMAGE_FILEFORMAT   DestFormat,
  _In_       LPDIRECT3DBASETEXTURE9 pSrcTexture,
  _In_ const PALETTEENTRY           *pSrcPalette
);

Параметры

пдестфиле [ окне]

Тип: LPCTSTR

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

Дестформат [ окне]

Тип: D3DXIMAGE _ FILEFORMAT

D3DXIMAGE _ FILEFORMAT , указывающий формат файла, используемый при сохранении. Эта функция поддерживает сохранение во всех форматах _ FILEFORMAT D3DXIMAGE , кроме переносимых пиксмап (. ppm) и Targa/формат графического адаптера (. TGA).

псрктекстуре [ окне]

Тип: LPDIRECT3DBASETEXTURE9

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

псркпалетте [ окне]

Тип: const палеттинтри *

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

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

Тип: HRESULT

Если функция выполнена успешно, возвращается значение D3D _ ОК. Если функция завершается ошибкой, возвращаемое значение может быть следующим: D3DERR _ инвалидкалл

Комментарии

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

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

Если том является нединамическим (из-за параметра использования, установленного в значение 0 при создании) и расположен в видеопамяти (пул памяти со значением D3DPOOL _ по умолчанию), D3DXSaveTextureToFile завершится сбоем, так как D3DX не сможет блокировать нединамические тома, расположенные в видеопамяти.

Требования

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

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

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

D3DXSaveSurfaceToFile

D3DXSaveVolumeToFile