DevIL Documentation Home | Previous | Next

ilutD3D8VolTexFromFileHandle

The ilutD3D8TexFromFileHandle function loads a file handle into a D3D8 volume texture.

ILboolean ilutD3D8TexFromFile(
  IDirect3DDevice8 *Device,  ILHANDLE File,  IDirect3DTexture8 **Texture);


Parameters

Device
Pointer to an IDirect3DDevice8 interface, representing the device to be associated with the texture.
File
File handle containing the image file.
Texture
Address of a pointer to an IDirect3DVolumeTexture8 interface, representing the created texture object.


Remarks

ilutD3D8VolTexFromFileHandle loads the file present in File and converts it to a Direct3D 8 volume texture (IDirect3DVolumeTexture8). This function creates the texture, so the pointer does not even have to be allocated beforehand. This function is functionally equivalent to D3DX's D3DXCreateTextureFromFile but with a file handle and a volume texture.

Error Codes

ILUT_ILLEGAL_OPERATION - There is currently no image bound. Use ilGenImages and ilBindImage before calling this function.

See Also