D3DXCreateCubeTextureFromResource 函数
从资源创建立方体纹理。
语法
HRESULT D3DXCreateCubeTextureFromResource(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ HMODULE hSrcModule,
_In_ LPCTSTR pSrcResource,
_Out_ LPDIRECT3DCUBETEXTURE9 *ppCubeTexture
);
参数
-
pDevice [in]
-
指向 IDirect3DDevice9 接口的指针,表示要与立方体纹理关联的设备。
-
hSrcModule [in]
-
类型: HMODULE
资源所在的模块的句柄;对于与操作系统用于创建当前进程的映像关联的模块,则为 NULL 。
-
pSrcResource [in]
-
类型: LPCTSTR
指向指定资源名称的字符串的指针。 如果编译器设置需要 Unicode,则数据类型 LPCTSTR 解析为 LPCWSTR。 否则,字符串数据类型解析为 LPCSTR。 请参阅“备注”。
-
ppCubeTexture [out]
-
指向 IDirect3DCubeTexture9 接口的指针的地址,表示创建的立方体纹理对象。
返回值
类型: HRESULT
如果函数成功,则返回值D3D_OK。 如果函数失败,则返回值可以是以下值之一:D3DERR_INVALIDCALL、D3DERR_NOTAVAILABLE、D3DERR_OUTOFVIDEOMEMORY、D3DXERR_INVALIDDATA E_OUTOFMEMORY。
备注
编译器设置确定函数版本。 如果定义了 Unicode,则函数调用将解析为 D3DXCreateCubeTextureFromResourceW。 否则,函数调用将解析为 D3DXCreateCubeTextureFromResourceA ,因为正在使用 ANSI 字符串。
函数等效于 D3DXCreateCubeTextureFromResourceEx (pDevice、hSrcModule、pSrcResource、D3DX_DEFAULT、D3DX_DEFAULT、0、D3DFMT_UNKNOWN、D3DPOOL_MANAGED、D3DX_DEFAULT、D3DX_DEFAULT、0、NULL、ppCubeTexture) 。
此函数支持以下文件格式:.bmp、.dds、.dib、.hdr、.jpg、.pfm、.png、.ppm 和 .tga。 请参阅 D3DXIMAGE_FILEFORMAT。
请注意,从 IDirect3DDevice9 对象调用时使用此函数创建的资源将放置在由 D3DPOOL_MANAGED 表示的内存类中。 从 IDirect3DDevice9Ex 对象调用此方法时,资源将放置在由 D3DPOOL_DEFAULT 表示的内存类中。
筛选会自动应用于使用此方法创建的纹理。 筛选等效于 D3DX_FILTER_TRIANGLE |在 D3DX_FILTER 中 D3DX_FILTER_DITHER。
D3DXCreateCubeTextureFromResource 使用 DirectDraw 图面 (DDS) 文件格式。 使用 DirectX 纹理编辑器 (Dxtex.exe) ,可以从其他文件格式生成多维数据集贴图并将其保存为 DDS 文件格式。 可以从 DirectX SDK 获取Dxtex.exe并了解它。 有关 DirectX SDK 的信息,请参阅 DirectX SDK 在哪里?。
要求
要求 | 值 |
---|---|
标头 |
|
库 |
|
另请参阅