DevIL Documentation Home | Previous | Next

ilutD3D8VolTexFromFile

The ilutD3D8VolTexFromFile function loads a file into a D3D8 volume texture.

ILboolean ilutD3D8VolTexFromFile(
  IDirect3DDevice8 *Device,  char *FileName,  IDirect3DVolumeTexture8 **Texture);


Parameters

Device
Pointer to an IDirect3DDevice8 interface, representing the device to be associated with the texture.
FileName
File to create the texture from.
Texture
Address of a pointer to an IDirect3DVolumeTexture8 interface, representing the created texture object.


Remarks

ilutD3D8VolTexFromFile loads the file named by FileName 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 for a volume texture.

Error Codes

ILUT_ILLEGAL_OPERATION - There is currently no image bound. Use ilGenImages and ilBindImage before calling this function.ILUT_COULD_NOT_OPEN_FILE - Could not load the file named in FileName.

See Also

ilLoad