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


Функция D3DX11SaveTextureToFile

Примечание

Библиотека служебной программы D3DX (D3DX 9, D3DX 10 и D3DX 11) является устаревшей для Windows 8 и не поддерживается для приложений Магазина Windows.

Примечание

Вместо этой функции рекомендуется использовать библиотеку DirectXTex , CaptureTexture , а затем SaveToXXXFile (где XXX — WIC, DDS или TGA; WIC не поддерживает DDS и TGA; D3DX 9 поддерживает TGA в качестве общего формата арт-источника для игр). В упрощенном сценарии создания снимка экрана из целевой текстуры отрисовки рекомендуется использовать библиотеку DirectXTKSaveDDSTextureToFile или SaveWICTextureToFile.

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

Синтаксис

HRESULT D3DX11SaveTextureToFile(
       ID3D11DeviceContext      *pContext,
  _In_ ID3D11Resource           *pSrcTexture,
  _In_ D3DX11_IMAGE_FILE_FORMAT DestFormat,
  _In_ LPCTSTR                  pDestFile
);

Параметры

pContext

Тип: ID3D11DeviceContext*

Указатель на объект ID3D11DeviceContext .

pSrcTexture [in]

Тип: ID3D11Resource*

Указатель на сохраняемую текстуру. См. id3D11Resource.

DestFormat [in]

Тип: D3DX11_IMAGE_FILE_FORMAT

Формат текстуры будет сохранен (см . D3DX11_IMAGE_FILE_FORMAT). D3DX11_IFF_DDS является предпочтительным форматом, так как это единственный вариант, поддерживающий все форматы в DXGI_FORMAT.

pDestFile [in]

Тип: LPCTSTR

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

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

Тип: HRESULT

Возвращаемое значение является одним из значений, перечисленных в коде возврата Direct3D 11; используйте возвращаемое значение, чтобы узнать, поддерживается ли DestFormat .

Комментарии

D3DX11SaveTextureToFile записывает дополнительную структуру DDS_HEADER_DXT10 для входной текстуры только при необходимости (например, потому, что входная текстура имеет стандартный формат RGB (sRGB). Если D3DX11SaveTextureToFile записывает структуру DDS_HEADER_DXT10 , элемент dwFourCCструктуры DDS_PIXELFORMAT текстуры присваивается dx10 , чтобы указать предопределение расширенного заголовка DDS_HEADER_DXT10 .

Требования

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

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

Функции D3DX