D3DXCreateVolumeTextureFromFileInMemoryEx 函数
从文件创建卷纹理。 这是比 D3DXCreateVolumeTextureFromFileInMemory 更高级的函数。
语法
HRESULT D3DXCreateVolumeTextureFromFileInMemoryEx(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ LPCVOID pSrcData,
_In_ UINT SrcDataSize,
_In_ UINT Width,
_In_ UINT Height,
_In_ UINT Depth,
_In_ UINT MipLevels,
_In_ DWORD Usage,
_In_ D3DFORMAT Format,
_In_ D3DPOOL Pool,
_In_ DWORD Filter,
_In_ DWORD MipFilter,
_In_ D3DCOLOR ColorKey,
_Inout_ D3DXIMAGE_INFO *pSrcInfo,
_Out_ PALETTEENTRY *pPalette,
_Out_ LPDIRECT3DVOLUMETEXTURE9 *ppVolumeTexture
);
参数
-
pDevice [in]
-
指向 IDirect3DDevice9 接口的指针,表示要与纹理关联的设备。
-
pSrcData [in]
-
类型: LPCVOID
指向内存中要从中创建卷纹理的文件的指针。
-
SrcDataSize [in]
-
类型: UINT
内存中文件的大小(以字节为单位)。
-
Width [in]
-
类型: UINT
宽度(以像素为单位)。 如果此值为零或D3DX_DEFAULT,则维度取自文件。 可在 D3DCAPS9 中的 MaxVolumeExtent 中找到驱动程序支持的宽度、高度和深度 (的最大维度) 。
-
高度 [in]
-
类型: UINT
高度(以像素为单位)。 如果此值为零或D3DX_DEFAULT,则维度取自文件。 可在 D3DCAPS9 中的 MaxVolumeExtent 中找到驱动程序支持的宽度、高度和深度 (的最大维度) 。
-
深度 [in]
-
类型: UINT
深度(以像素为单位)。 如果此值为零或D3DX_DEFAULT,则维度取自文件。 可在 D3DCAPS9 中的 MaxVolumeExtent 中找到驱动程序支持的宽度、高度和深度 (的最大维度) 。
-
MipLevels [in]
-
类型: UINT
请求的 mip 级别数。 如果此值为零或D3DX_DEFAULT,则会创建完整的 mipmap 链。
-
用法 [in]
-
类型: DWORD
0、D3DUSAGE_RENDERTARGET 或 D3DUSAGE_DYNAMIC。 将此标志设置为D3DUSAGE_RENDERTARGET表示该图面将用作呈现目标。 然后,可以将资源传递给 SetRenderTarget 方法的 pNewRenderTarget 参数。 如果指定了D3DUSAGE_RENDERTARGET或D3DUSAGE_DYNAMIC,则必须将“池”设置为“D3DPOOL_DEFAULT”,并且应用程序应通过调用 CheckDeviceFormat 检查设备支持此操作。 D3DUSAGE_DYNAMIC指示应动态处理图面。 有关使用动态纹理的详细信息,请参阅 使用动态纹理。
-
格式 [in]
-
类型: D3DFORMAT
D3DFORMAT 枚举类型的成员,描述纹理请求的像素格式。 返回的纹理的格式可能与 Format 指定的格式不同。 应用程序应检查返回的纹理的格式。 如果 D3DFMT_UNKNOWN,则格式取自文件。 如果D3DFMT_FROM_FILE,则采用的格式与文件中的格式完全相同,如果这违反了设备功能,调用将失败。
-
池 [in]
-
类型: D3DPOOL
D3DPOOL 枚举类型的成员,描述应放置纹理的内存类。
-
筛选器 [in]
-
类型: DWORD
控制图像筛选方式的一个或多个 D3DX_FILTER 的组合。 为此参数指定D3DX_DEFAULT等效于指定D3DX_FILTER_TRIANGLE |D3DX_FILTER_DITHER。
-
MipFilter [in]
-
类型: DWORD
控制图像筛选方式的一个或多个 D3DX_FILTER 的组合。 为此参数指定D3DX_DEFAULT等效于指定D3DX_FILTER_BOX。 此外,使用位 27-31 指定要从 mipmap 链顶部 (跳过的 mip 级别数,) .dds 纹理加载到内存中时;这样,最多可以跳过 32 个级别。
-
ColorKey [in]
-
类型: D3DCOLOR
D3DCOLOR 值替换为透明黑色,或 0 表示禁用颜色键。 这始终是 32 位 ARGB 颜色,与源图像格式无关。 Alpha 非常重要,对于不透明颜色键,通常应设置为 FF。 因此,对于不透明的黑色,该值将等于 0xFF000000。
-
pSrcInfo [in, out]
-
类型: D3DXIMAGE_INFO*
指向要用源图像文件中数据的说明填充 的D3DXIMAGE_INFO 结构的指针,或 为 NULL。
-
pPalette [out]
-
类型: PALETTEENTRY*
指向 PALETTEENTRY 结构的指针,表示要填充的 256 色调色板或 NULL。
-
ppVolumeTexture [out]
-
指向 IDirect3DVolumeTexture9 接口的指针的地址,表示创建的纹理对象。
返回值
类型: HRESULT
如果函数成功,则返回值D3D_OK。 如果函数失败,则返回值可以是下列值之一:D3DERR_NOTAVAILABLE、D3DERR_OUTOFVIDEOMEMORY、D3DERR_INVALIDCALL、D3DXERR_INVALIDDATA E_OUTOFMEMORY。
备注
此函数支持以下文件格式:.bmp、.dds、.dib、.hdr、.jpg、.pfm、.png、.ppm 和 .tga。 请参阅 D3DXIMAGE_FILEFORMAT。
加载 .dds 文件时跳过 mipmap 级别时,请使用 D3DX_SKIP_DDS_MIP_LEVELS 宏生成 MipFilter 值。 此宏采用要跳过的级别数和筛选器类型,并返回筛选器值,该值随后将传递到 MipFilter 参数中。
要求
要求 | 值 |
---|---|
标头 |
|
库 |
|
另请参阅