Función D3DX11SaveTextureToFile
Nota
La biblioteca de utilidades D3DX (D3DX 9, D3DX 10 y D3DX 11) está en desuso para Windows 8 y no es compatible con las aplicaciones de la Tienda Windows.
Nota
En lugar de usar esta función, se recomienda usar la biblioteca DirectXTex , CaptureTexture y SaveToXXXFile (donde XXX es WIC, DDS o TGA; WIC no admite DDS y TGA; D3DX 9 admite TGA como un formato de origen de arte común para juegos). Para el escenario simplificado de creación de una captura de pantalla a partir de una textura de destino de representación, se recomienda usar la biblioteca directXTK , SaveDDSTextureToFile o SaveWICTextureToFile.
Guarde una textura en un archivo.
Sintaxis
HRESULT D3DX11SaveTextureToFile(
ID3D11DeviceContext *pContext,
_In_ ID3D11Resource *pSrcTexture,
_In_ D3DX11_IMAGE_FILE_FORMAT DestFormat,
_In_ LPCTSTR pDestFile
);
Parámetros
-
pContext
-
Tipo: ID3D11DeviceContext*
Puntero a un objeto ID3D11DeviceContext .
-
pSrcTexture [in]
-
Tipo: ID3D11Resource*
Puntero a la textura que se va a guardar. Consulte ID3D11Resource.
-
DestFormat [in]
-
Tipo: D3DX11_IMAGE_FILE_FORMAT
El formato de la textura se guardará como (consulte D3DX11_IMAGE_FILE_FORMAT). D3DX11_IFF_DDS es el formato preferido, ya que es la única opción que admite todos los formatos de DXGI_FORMAT.
-
pDestFile [in]
-
Tipo: LPCTSTR
Nombre del archivo de salida de destino donde se guardará la textura. Si la configuración del compilador requiere Unicode, el tipo de datos LPCTSTR se resuelve en LPCWSTR. De lo contrario, el tipo de datos se resuelve en LPCSTR.
Valor devuelto
Tipo: HRESULT
El valor devuelto es uno de los valores enumerados en Códigos de retorno de Direct3D 11; use el valor devuelto para ver si se admite DestFormat .
Observaciones
D3DX11SaveTextureToFile escribe la estructura de DDS_HEADER_DXT10 adicional para la textura de entrada solo si es necesario (por ejemplo, porque la textura de entrada está en formato RGB estándar (sRGB). Si D3DX11SaveTextureToFile escribe la estructura de DDS_HEADER_DXT10 , establece el miembro dwFourCC de la estructura DDS_PIXELFORMAT de la textura en DX10 para indicar el prescense del encabezado extendido de DDS_HEADER_DXT10 .
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|
| Biblioteca |
|