Функция D3DXSaveTextureToFile
Сохраняет текстуру в файл.
Синтаксис
HRESULT D3DXSaveTextureToFile(
_In_ LPCTSTR pDestFile,
_In_ D3DXIMAGE_FILEFORMAT DestFormat,
_In_ LPDIRECT3DBASETEXTURE9 pSrcTexture,
_In_ const PALETTEENTRY *pSrcPalette
);
Параметры
-
pDestFile [in]
-
Тип: LPCTSTR
Указатель на строку, указывающую имя файла целевого образа. Если для параметров компилятора требуется Юникод, тип данных LPCTSTR разрешается в LPCWSTR. В противном случае строковый тип данных разрешается в LPCSTR. См. заметки.
-
DestFormat [in]
-
Тип: D3DXIMAGE_FILEFORMAT
D3DXIMAGE_FILEFORMAT с указанием формата файла, используемого при сохранении. Эта функция поддерживает сохранение во всех форматах D3DXIMAGE_FILEFORMAT , кроме переносимого Pixmap (PPM) и графического адаптера Targa/Truevision (TGA).
-
pSrcTexture [in]
-
Указатель на интерфейс IDirect3DBaseTexture9 , содержащий сохраняемую текстуру.
-
pSrcPalette [in]
-
Тип: const PALETTEENTRY*
Указатель на структуру PALETTEENTRY , содержащую палитру из 256 цветов. Этот параметр может принимать значение NULL.
Возвращаемое значение
Тип: HRESULT
Если функция выполняется успешно, возвращаемое значение будет D3D_OK. Если функция завершается сбоем, возвращаемое значение может быть следующим: D3DERR_INVALIDCALL
Комментарии
Параметр компилятора также определяет версию функции. Если определен Юникод, вызов функции разрешается в D3DXSaveTextureToFileW. В противном случае вызов функции разрешается в D3DXSaveTextureToFileA, так как используются строки ANSI.
Эта функция обрабатывает преобразование в сжатые форматы текстур и из нее.
Если том нединамический (из-за того, что параметр использования имеет значение 0 при создании) и находится в видеопамяти (пул памяти, для D3DPOOL_DEFAULT), D3DXSaveTextureToFile завершится сбоем, так как D3DX не может заблокировать нединамические тома, расположенные в видеопамяти.
Требования
| Требование | Значение |
|---|---|
| Заголовок |
|
| Библиотека |
|
См. также раздел