Función D3DXSaveTextureToFile
Guarda una textura en un archivo.
Sintaxis
HRESULT D3DXSaveTextureToFile(
_In_ LPCTSTR pDestFile,
_In_ D3DXIMAGE_FILEFORMAT DestFormat,
_In_ LPDIRECT3DBASETEXTURE9 pSrcTexture,
_In_ const PALETTEENTRY *pSrcPalette
);
Parámetros
-
pDestFile [in]
-
Tipo: LPCTSTR
Puntero a una cadena que especifica el nombre de archivo de la imagen de destino. Si la configuración del compilador requiere Unicode, el tipo de datos LPCTSTR se resuelve en LPCWSTR. De lo contrario, el tipo de datos de cadena se resuelve en LPCSTR. Vea la sección Comentarios.
-
DestFormat [in]
-
Tipo: D3DXIMAGE_FILEFORMAT
D3DXIMAGE_FILEFORMAT especificar el formato de archivo que se va a usar al guardar. Esta función permite guardar en todos los formatos de D3DXIMAGE_FILEFORMAT excepto portable Pixmap (.ppm) y Targa/Truevision Graphics Adapter (.tga).
-
pSrcTexture [in]
-
Tipo: LPDIRECT3DBASETEXTURE9
Puntero a la interfaz IDirect3DBaseTexture9 , que contiene la textura que se va a guardar.
-
pSrcPalette [in]
-
Tipo: const PALETTEENTRY*
Puntero a una estructura PALETTEENTRY que contiene una paleta de 256 colores. Este parámetro puede ser NULL.
Valor devuelto
Tipo: HRESULT
Si la función se ejecuta correctamente, el valor devuelto es D3D_OK. Si se produce un error en la función, el valor devuelto puede ser el siguiente: D3DERR_INVALIDCALL
Comentarios
La configuración del compilador también determina la versión de la función. Si se define Unicode, la llamada de función se resuelve en D3DXSaveTextureToFileW. De lo contrario, la llamada de función se resuelve en D3DXSaveTextureToFileA porque se usan cadenas ANSI.
Esta función controla la conversión a y desde formatos de textura comprimidos.
Si el volumen no es dinámico (debido a un parámetro de uso establecido en 0 en la creación) y se encuentra en memoria de vídeo (el grupo de memoria establecido en D3DPOOL_DEFAULT), se producirá un error en D3DXSaveTextureToFile porque D3DX no puede bloquear volúmenes no dinámicos ubicados en memoria de vídeo.
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|
| Biblioteca |
|
Consulte también