D3DXCreateCubeTextureFromResource 函数

从资源创建立方体纹理。

语法

HRESULT D3DXCreateCubeTextureFromResource(
  _In_  LPDIRECT3DDEVICE9      pDevice,
  _In_  HMODULE                hSrcModule,
  _In_  LPCTSTR                pSrcResource,
  _Out_ LPDIRECT3DCUBETEXTURE9 *ppCubeTexture
);

参数

pDevice [in]

类型: LPDIRECT3DDEVICE9

指向 IDirect3DDevice9 接口的指针,表示要与立方体纹理关联的设备。

hSrcModule [in]

类型: HMODULE

资源所在的模块的句柄;对于与操作系统用于创建当前进程的映像关联的模块,则为 NULL

pSrcResource [in]

类型: LPCTSTR

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

ppCubeTexture [out]

类型: LPDIRECT3DCUBETEXTURE9*

指向 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、NULLppCubeTexture) 。

此函数支持以下文件格式:.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 在哪里?

要求

要求
标头
D3dx9tex.h

D3dx9.lib

另请参阅

D3DXCreateCubeTextureFromResourceEx

D3DX 9 中的纹理函数