Функция 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_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 .
Требования
Требование | Значение |
---|---|
Заголовок |
|
Библиотека |
|