D3DXSaveTextureToFile 函数

将纹理保存到文件中。

语法

HRESULT D3DXSaveTextureToFile(
  _In_       LPCTSTR                pDestFile,
  _In_       D3DXIMAGE_FILEFORMAT   DestFormat,
  _In_       LPDIRECT3DBASETEXTURE9 pSrcTexture,
  _In_ const PALETTEENTRY           *pSrcPalette
);

参数

pDestFile [in]

类型: LPCTSTR

指向指定目标映像文件名的字符串的指针。 如果编译器设置需要 Unicode,则数据类型 LPCTSTR 解析为 LPCWSTR。 否则,字符串数据类型解析为 LPCSTR。 请参阅“备注”。

DestFormat [in]

类型: D3DXIMAGE_FILEFORMAT

D3DXIMAGE_FILEFORMAT 指定保存时要使用的文件格式。 此函数支持保存到除可移植 Pixmap (.ppm) 和 Targa/Truevision 图形适配器 (.tga) 之外的所有 D3DXIMAGE_FILEFORMAT 格式。

pSrcTexture [in]

类型: LPDIRECT3DBASETEXTURE9

指向 IDirect3DBaseTexture9 接口的指针,其中包含要保存的纹理。

pSrcPalette [in]

类型: const PALETTEENTRY*

指向包含 256 种颜色调色板的 PALETTEENTRY 结构的指针。 此参数可以为 NULL。

返回值

类型: HRESULT

如果函数成功,则返回值D3D_OK。 如果函数失败,则返回值可以是以下值:D3DERR_INVALIDCALL

注解

编译器设置还确定函数版本。 如果定义了 Unicode,则函数调用将解析为 D3DXSaveTextureToFileW。 否则,函数调用将解析为 D3DXSaveTextureToFileA,因为正在使用 ANSI 字符串。

此函数处理与压缩纹理格式的转换。

如果卷在创建) 时设置为 0 (且位于视频内存 (内存池设置为D3DPOOL_DEFAULT) , 则 D3DXSaveTextureToFile 会失败,因为 D3DX 无法锁定位于视频内存中的非动态卷。

要求

要求 Value
标头
D3dx9tex.h

D3dx9.lib

另请参阅

D3DX 9 中的纹理函数

D3DXSaveSurfaceToFile

D3DXSaveVolumeToFile