Image Data Handling

Operations on image data. More...

Functions
ILAPI ILubyte *ILAPIENTRY	ilCompressDXT (ILubyte *Data, ILuint Width, ILuint Height, ILuint Depth, ILenum DXTCFormat, ILuint *DXTCSize)
	Compresses data to a DXT format using different methods. More...
ILAPI ILboolean ILAPIENTRY	ilDxtcDataToImage ()
	Decompresses stored DXTC data into the currently bound image and all of its mipmaps.
ILAPI ILboolean ILAPIENTRY	ilDxtcDataToSurface ()
	Decompresses stored DXTC data into the currently bound image.
void ILAPIENTRY	ilFlipSurfaceDxtcData ()
	Flips the stored DXTC data of the currently bound image vertically.
ILubyte *ILAPIENTRY	ilGetAlpha (ILenum Type)
	Extract the alpha channel from the currently bound image. More...
ILubyte *ILAPIENTRY	ilGetData (void)
	Returns a pointer to the current image's data. More...
ILuint ILAPIENTRY	ilGetDXTCData (void *Buffer, ILuint BufferSize, ILenum DXTCFormat)
	Compress image data using internal DXTC compression and copy the data into the supplied buffer and returns the number of bytes written. More...
ILubyte *ILAPIENTRY	ilGetPalette (void)
	Returns a pointer to the current image's palette data. More...
ILboolean ILAPIENTRY	ilImageToDxtcData (ILenum Format)
	Convert the DXTC data of the currently bound image and its mipmaps into image data.
ILAPI ILboolean ILAPIENTRY	ilInvertSurfaceDxtcDataAlpha ()
	Invert the alpha channel in the DXTC data of the currently bound image.
ILboolean ILAPIENTRY	ilSetDuration (ILuint Duration)
	Set the duration of the currently bound image. More...
ILAPI ILboolean ILAPIENTRY	ilSurfaceToDxtcData (ILenum Format)
	Compresses the currently bound image with DXTC and store the result in its internal DXTC data buffer.

Detailed Description

Operations on image data.

Function Documentation

ILAPI ILubyte* ILAPIENTRY ilCompressDXT	(	ILubyte *	Data,
		ILuint	Width,
		ILuint	Height,
		ILuint	Depth,
		ILenum	DXTCFormat,
		ILuint *	DXTCSize
	)

Compresses data to a DXT format using different methods.

The data must be in unsigned byte RGBA or BGRA format. Only DXT1, DXT3 and DXT5 are supported.

ILubyte* ILAPIENTRY ilGetAlpha

(

ILenum

Type

)

Extract the alpha channel from the currently bound image.

Parameters

Type	Data type to use.

ILubyte* ILAPIENTRY ilGetData

(

void

)

Returns a pointer to the current image's data.

The pointer to the image data returned by this function is only valid until any operations are done on the image. After any operations, this function should be called again. The pointer can be cast to other types for images that have more than one byte per channel for easier access to data.

Exceptions

IL_ILLEGAL_OPERATION

No currently bound image

Returns

ILubyte pointer to image data.

ILuint ILAPIENTRY ilGetDXTCData	(	void *	Buffer,
		ILuint	BufferSize,
		ILenum	DXTCFormat
	)

Compress image data using internal DXTC compression and copy the data into the supplied buffer and returns the number of bytes written.

If Buffer is NULL no data is written and only the minimum size of the Buffer is returned.

ILubyte* ILAPIENTRY ilGetPalette

(

void

)

Returns a pointer to the current image's palette data.

The pointer to the image palette data returned by this function is only valid until any operations are done on the image. After any operations, this function should be called again.

Exceptions

IL_ILLEGAL_OPERATION

No currently bound image

Returns

ILubyte pointer to image palette data.

ILboolean ILAPIENTRY ilSetDuration

(

ILuint

Duration

)

Set the duration of the currently bound image.

Only useful if the image is part of an animation chain.