Microsoft DirectX 8.1 (C++) |
D3DXFillVolumeTexture
Uses a user-provided function to fill each texel of each mip level of a given texture.
HRESULT D3DXFillVolumeTexture( LPDIRECT3DVOLUMETEXTURE8 pVolumeTexture, LPD3DXFILL3D pFunction, LPVOID pData );
Parameters
- pVolumeTexture
- [out, retval] Pointer to an IDirect3DVolumeTexture8 interface, representing the filled texture.
- pFunction
- [in] Pointer to an LPD3DXFILL3D user-provided evaluator function, which will be used to compute the value of each texel.
- pData
- [in] Pointer to an arbitrary block of user-defined data. This pointer will be passed to the function provided in pFunction.
Return Values
If the function succeeds, the return value is D3D_OK.
If the function fails, the return value can be the following value.
D3DERR_INVALIDCALL |
Remarks
If the volume is nondynamic (because of a usage parameter set to 0 at the creation) and located in video memory (the memory pool set to D3DPOOL_DEFAULT), D3DXFillVolumeTexture will fail because Direct3DX cannot lock nondynamic volumes located in video memory.
Requirements
Header: Declared in D3dx8tex.h.
Import Library: Use D3dx8.lib.