kolrabi's another Image Library  1.11.0
 All Files Functions Groups Pages
Image Management

Creating, deleting, copying, selecting images. More...

Functions

ILboolean ILAPIENTRY ilActiveFace (ILuint Number)
 Sets the current face if the currently bound image is a cubemap. More...
 
ILboolean ILAPIENTRY ilActiveImage (ILuint Number)
 Sets the current animation frame. More...
 
ILboolean ILAPIENTRY ilActiveLayer (ILuint Number)
 Sets the current image layer. More...
 
ILboolean ILAPIENTRY ilActiveMipmap (ILuint Number)
 Sets the current mipmap level. More...
 
ILuint ILAPIENTRY ilCloneCurImage ()
 Creates a duplicate of the currently bound image.
 
ILboolean ILAPIENTRY ilCopyImage (ILuint Src)
 Copies everything from Src to the current bound image. More...
 
void ILAPIENTRY ilDeleteImage (const ILuint Num)
 Delete one single image from the image stack.
 
void ILAPIENTRY ilDeleteImages (ILsizei Num, const ILuint *Images)
 Deletes Num images from the image stack - similar to glDeleteTextures().
 
ILuint ILAPIENTRY ilGenImage (void)
 Create one single new image on the image stack.
 
void ILAPIENTRY ilGenImages (ILsizei Num, ILuint *Images)
 Creates Num images and puts their index in Images - similar to glGenTextures().
 
ILint ILAPIENTRY ilGetIntegerImage (ILuint ImageName, ILenum Mode)
 Get a value about a specific image. More...
 
ILboolean ILAPIENTRY ilIsImage (ILuint Image)
 Checks whether a given Image name is valid.
 

Detailed Description

Creating, deleting, copying, selecting images.

Function Documentation

ILboolean ILAPIENTRY ilActiveFace ( ILuint  Number)

Sets the current face if the currently bound image is a cubemap.

Note
If IL_IMAGE_SELECTION_MODE is set to IL_RELATIVE (default), the Number is the number of sub images down the chain, NOT the absolute face index. To go back to the base image use ilBindImage.
ILboolean ILAPIENTRY ilActiveImage ( ILuint  Number)

Sets the current animation frame.

Note
If IL_IMAGE_SELECTION_MODE is set to IL_RELATIVE (default), the Number is the number of sub images down the chain, NOT the absolute frame index. To go back to the base image use ilBindImage.
ILboolean ILAPIENTRY ilActiveLayer ( ILuint  Number)

Sets the current image layer.

Note
If IL_IMAGE_SELECTION_MODE is set to IL_RELATIVE (default), the Number is the number of sub images down the chain, NOT the absolute layer index. To go back to the base image use ilBindImage.
ILboolean ILAPIENTRY ilActiveMipmap ( ILuint  Number)

Sets the current mipmap level.

Note
If IL_IMAGE_SELECTION_MODE is set to IL_RELATIVE (default), the Number is the number of sub images down the chain, NOT the absolute mipmap level. To go back to the base image use ilBindImage.
ILboolean ILAPIENTRY ilCopyImage ( ILuint  Src)

Copies everything from Src to the current bound image.

Parameters
SrcName of source image from which to copy.
ILint ILAPIENTRY ilGetIntegerImage ( ILuint  ImageName,
ILenum  Mode 
)

Get a value about a specific image.

The Modes listed here can also be retrieved for the currently bound image by calling ilGetInteger().

Valid Modes are:

Mode Description
IL_DXTC_DATA_FORMAT Format of the retained compressed DXTC data (if IL_KEEP_DXTC_DATA is enabled on load).
IL_IMAGE_BITS_PER_PIXEL Bits per pixel.
IL_IMAGE_BYTES_PER_PIXEL Bytes per pixel.
IL_IMAGE_BPC Bytes per channel.
IL_IMAGE_CHANNELS Image colour channel count.
IL_IMAGE_CUBEFLAGS Cubemap face of image if it is a cubemap.
IL_IMAGE_DEPTH Depth of image in pixels (number 2d images along the Z axis).
IL_IMAGE_DURATION Duration of the image in an animation in milliseconds.
IL_IMAGE_FORMAT Pixel format of image.
IL_IMAGE_HEIGHT Height of image in pixels.
IL_IMAGE_SIZE_OF_DATA Total number of bytes in image data buffer.
IL_IMAGE_OFFX X offset of image in pixels.
IL_IMAGE_OFFY Y offset of image in pixels.
IL_IMAGE_ORIGIN Origin of image.
IL_IMAGE_PLANESIZE Size of one 2d image plane in bytes.
IL_IMAGE_TYPE Data type of bytes in data buffer.
IL_IMAGE_WIDTH Width of image in pixels.
IL_NUM_FACES Number of faces (== 5 for cubemaps).
IL_NUM_IMAGES Number of following sub images (eg. in an animation).
IL_NUM_LAYERS Number of layers in image.
IL_NUM_MIPMAPS Number of mipmaps contained in image.
IL_PALETTE_TYPE Type of palette data if any.
IL_PALETTE_BPP Bytes pro palette entry.
IL_PALETTE_NUM_COLS Total number of palette entries.
IL_PALETTE_BASE_TYPE Pixel format for all palette entries.
Since
1.9.0