kolrabi's another Image Library  1.11.0
 All Files Functions Groups Pages
DirectX 8 Functionality

Contains all functions to convert/copy image data from the IL to Direct3D textures and back. More...

Functions

ILAPI ILboolean ILAPIENTRY ilutD3D8LoadSurface (IDirect3DDevice8 *Device, IDirect3DSurface8 *Surface)
 Copy a given Surface into the currently bound image. More...
 
ILboolean ILAPIENTRY ilutD3D8TexFromFile (IDirect3DDevice8 *Device, ILconst_string FileName, IDirect3DTexture8 **Texture)
 Load an image from a file and store it in Texture. More...
 
ILboolean ILAPIENTRY ilutD3D8TexFromFileHandle (IDirect3DDevice8 *Device, ILHANDLE File, IDirect3DTexture8 **Texture)
 Load an image from an opened file and store it in Texture. More...
 
ILboolean ILAPIENTRY ilutD3D8TexFromFileInMemory (IDirect3DDevice8 *Device, const void *Lump, ILuint Size, IDirect3DTexture8 **Texture)
 Load an image from memory and store it in Texture. More...
 
ILboolean ILAPIENTRY ilutD3D8TexFromResource (IDirect3DDevice8 *Device, HMODULE SrcModule, ILconst_string SrcResource, IDirect3DTexture8 **Texture)
 Load an image from a resource and store it in Texture. More...
 
IDirect3DTexture8 *ILAPIENTRY ilutD3D8Texture (IDirect3DDevice8 *Device)
 Convert the currently bound image into a IDirect3DTexture8. More...
 
ILboolean ILAPIENTRY ilutD3D8VolTexFromFile (IDirect3DDevice8 *Device, ILconst_string FileName, IDirect3DVolumeTexture8 **Texture)
 Load a volumetric (3d) image from a file and store it in Texture. More...
 
ILboolean ILAPIENTRY ilutD3D8VolTexFromFileHandle (IDirect3DDevice8 *Device, ILHANDLE File, IDirect3DVolumeTexture8 **Texture)
 Load a volumetric (3d) image from an opened file and store it in Texture. More...
 
ILboolean ILAPIENTRY ilutD3D8VolTexFromFileInMemory (IDirect3DDevice8 *Device, const void *Lump, ILuint Size, IDirect3DVolumeTexture8 **Texture)
 Load a volumetric (3d) image from memory and store it in Texture. More...
 
ILboolean ILAPIENTRY ilutD3D8VolTexFromResource (IDirect3DDevice8 *Device, HMODULE SrcModule, ILconst_string SrcResource, IDirect3DVolumeTexture8 **Texture)
 Load a volumetric (3d) image from a resource and store it in Texture. More...
 
IDirect3DVolumeTexture8 *ILAPIENTRY ilutD3D8VolumeTexture (IDirect3DDevice8 *Device)
 Convert the currently bound image into a IDirect3DVolumeTexture8 Uses the following settings: More...
 

Detailed Description

Contains all functions to convert/copy image data from the IL to Direct3D textures and back.

Function Documentation

ILAPI ILboolean ILAPIENTRY ilutD3D8LoadSurface ( IDirect3DDevice8 *  Device,
IDirect3DSurface8 *  Surface 
)

Copy a given Surface into the currently bound image.

Parameters
DeviceDirect3D device to use
SurfaceSurface to copy image frome
Return values
IL_TRUEif successful
IL_FALSEif there was an error
ILboolean ILAPIENTRY ilutD3D8TexFromFile ( IDirect3DDevice8 *  Device,
ILconst_string  FileName,
IDirect3DTexture8 **  Texture 
)

Load an image from a file and store it in Texture.

Uses the following settings:

  • ILUT_D3D_USE_DXTC
  • ILUT_D3D_MIPLEVELS
  • ILUT_D3D_POOL
  • ILUT_D3D_GEN_DXTC
  • ILUT_DXTC_FORMAT (if ILUT_D3D_GEN_DXTC is IL_TRUE)
    Parameters
    DeviceDirect3D device to use
    FileNameName of file to load
    TextureWhere to store the pointer to the loaded texture.
    Return values
    IL_FALSEif there was an error.
    IL_TRUEif successful.
ILboolean ILAPIENTRY ilutD3D8TexFromFileHandle ( IDirect3DDevice8 *  Device,
ILHANDLE  File,
IDirect3DTexture8 **  Texture 
)

Load an image from an opened file and store it in Texture.

Parameters
DeviceDirect3D device to use
FileHandle of open file to use. Must be compatible with currently active image IO routines, see ilSetRead.
TextureWhere to store the pointer to the loaded Direct3D texture
Return values
IL_TRUEif successful
IL_FALSEif there was an error
ILboolean ILAPIENTRY ilutD3D8TexFromFileInMemory ( IDirect3DDevice8 *  Device,
const void *  Lump,
ILuint  Size,
IDirect3DTexture8 **  Texture 
)

Load an image from memory and store it in Texture.

Uses the following settings:

  • ILUT_D3D_USE_DXTC
  • ILUT_D3D_MIPLEVELS
  • ILUT_D3D_POOL
  • ILUT_D3D_GEN_DXTC
  • ILUT_DXTC_FORMAT (if ILUT_D3D_GEN_DXTC is IL_TRUE)
    Parameters
    DeviceDirect3D device to use
    LumpPointer to image file in memory
    SizeSize of image file in memory in bytes
    Texturewhere to store the pointer to the Direct3D texture
    Return values
    IL_TRUEif successful
    IL_FALSEif there was an error
ILboolean ILAPIENTRY ilutD3D8TexFromResource ( IDirect3DDevice8 *  Device,
HMODULE  SrcModule,
ILconst_string  SrcResource,
IDirect3DTexture8 **  Texture 
)

Load an image from a resource and store it in Texture.

Uses the following settings:

  • ILUT_D3D_USE_DXTC
  • ILUT_D3D_MIPLEVELS
  • ILUT_D3D_POOL
  • ILUT_D3D_GEN_DXTC
  • ILUT_DXTC_FORMAT (if ILUT_D3D_GEN_DXTC is IL_TRUE)
    Parameters
    DeviceDirect3D device to use
    SrcModuleLoaded module that contains the resource to load.
    SrcResourceName of the resource to load.
    TextureWhere to store the pointer to the loaded Direct3D texture
    Return values
    IL_TRUEif successful
    IL_FALSEif there was an error
IDirect3DTexture8* ILAPIENTRY ilutD3D8Texture ( IDirect3DDevice8 *  Device)

Convert the currently bound image into a IDirect3DTexture8.

Parameters
DeviceDirect3D device to use
Returns
A newly allocated Direct3D texture containing the image if succesful or NULL if there was an error.
ILboolean ILAPIENTRY ilutD3D8VolTexFromFile ( IDirect3DDevice8 *  Device,
ILconst_string  FileName,
IDirect3DVolumeTexture8 **  Texture 
)

Load a volumetric (3d) image from a file and store it in Texture.

Uses the following settings:

  • ILUT_D3D_POOL
    Parameters
    DeviceDirect3D device to use
    FileNameName of image file to load
    Texturewhere to store the pointer to the Direct3D texture
    Return values
    IL_TRUEif successful
    IL_FALSEif there was an error
ILboolean ILAPIENTRY ilutD3D8VolTexFromFileHandle ( IDirect3DDevice8 *  Device,
ILHANDLE  File,
IDirect3DVolumeTexture8 **  Texture 
)

Load a volumetric (3d) image from an opened file and store it in Texture.

Uses the following settings:

  • ILUT_D3D_POOL
    Parameters
    DeviceDirect3D device to use
    FileHandle of open file to use. Must be compatible with currently active image IO routines, see ilSetRead.
    TextureWhere to store the pointer to the loaded Direct3D texture
    Return values
    IL_TRUEif successful
    IL_FALSEif there was an error
ILboolean ILAPIENTRY ilutD3D8VolTexFromFileInMemory ( IDirect3DDevice8 *  Device,
const void *  Lump,
ILuint  Size,
IDirect3DVolumeTexture8 **  Texture 
)

Load a volumetric (3d) image from memory and store it in Texture.

Uses the following settings:

  • ILUT_D3D_POOL
    Parameters
    DeviceDirect3D device to use
    LumpPointer to image file in memory
    SizeSize of image file in memory in bytes
    TextureWhere to store the pointer to the loaded Direct3D texture
    Return values
    IL_TRUEif successful
    IL_FALSEif there was an error
ILboolean ILAPIENTRY ilutD3D8VolTexFromResource ( IDirect3DDevice8 *  Device,
HMODULE  SrcModule,
ILconst_string  SrcResource,
IDirect3DVolumeTexture8 **  Texture 
)

Load a volumetric (3d) image from a resource and store it in Texture.

Uses the following settings:

  • ILUT_D3D_POOL
    Parameters
    DeviceDirect3D device to use
    SrcModuleLoaded module that contains the resource to load.
    SrcResourceName of the resource to load.
    TextureWhere to store the pointer to the loaded Direct3D texture
    Return values
    IL_TRUEif successful
    IL_FALSEif there was an error
IDirect3DVolumeTexture8* ILAPIENTRY ilutD3D8VolumeTexture ( IDirect3DDevice8 *  Device)

Convert the currently bound image into a IDirect3DVolumeTexture8 Uses the following settings:

  • ILUT_D3D_POOL
    Parameters
    DeviceDirect3D device to use
    Returns
    A newly allocated Direct3D texture containing the image if succesful or NULL if there was an error.