DevIL Documentation Previous | ILU | Next

 

iluEnlargeCanvas

 

iluEnlargeCanvas enlarges the canvas of the current image, clearing the background to the colour specified in ilClearColour. To control the placement of the image, use iluImageParameter

 

ILboolean iluEnlargeCanvas(
  ILuint Width, ILuint Height, ILuint Depth );


Parameters

 
Width
New image width - must be larger than the current image's width.
Height
New image height - must be larger than the current image's width.
Depth
New image depth - must be larger than the current image's width.


Errors

 
ILU_ILLEGAL_OPERATION
The operation attempted is not allowable in the current state. The function returns with no ill side effects. Generally there is currently no image bound or it has been deleted via ilDeleteImages. You should use ilGenImages and ilBindImage before calling the function.
ILU_OUT_OF_MEMORY
Could not allocate enough memory in an operation

See Also

 
ilBindImages, ilClearColour, ilGenImages, iluImageParameter,