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 指定保存时要使用的文件格式。 此函数支持保存到除可移植 Pixmap (.ppm) 和 Targa/Truevision 图形适配器 (.tga) 之外的所有 D3DXIMAGE_FILEFORMAT 格式。
-
pSrcTexture [in]
-
指向 IDirect3DBaseTexture9 接口的指针，其中包含要保存的纹理。
-
pSrcPalette [in]
-
类型： const PALETTEENTRY*
指向包含 256 种颜色调色板的 PALETTEENTRY 结构的指针。 此参数可以为 NULL。
返回值
类型： HRESULT
如果函数成功，则返回值D3D_OK。 如果函数失败，则返回值可以是以下值：D3DERR_INVALIDCALL
注解
编译器设置还确定函数版本。 如果定义了 Unicode，则函数调用将解析为 D3DXSaveTextureToFileW。 否则，函数调用将解析为 D3DXSaveTextureToFileA，因为正在使用 ANSI 字符串。
此函数处理与压缩纹理格式的转换。
如果卷在创建) 时设置为 0 (且位于视频内存 (内存池设置为D3DPOOL_DEFAULT) ， 则 D3DXSaveTextureToFile 会失败，因为 D3DX 无法锁定位于视频内存中的非动态卷。
要求
| 要求 | Value |
|---|---|
| 标头 |
|
| 库 |
|
另请参阅