DevIL Documentation Home | Previous | Next


The iluEnlargeCanvas function enlarges the image while leaving the original data unchanged.

ILboolean iluEnlargeCanvas(
  ILuint Width,
  ILuint Height,
  ILuint Depth


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


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.

Error Codes

ILU_ILLEGAL_OPERATION - There is currently no image bound. Use ilGenImages and ilBindImage before calling this function. This error can also be used if any of the parameter dimensions are smaller than the original image's dimensions.

See Also

ilGenImages, ilBindImage, ilClearColour, iluImageParameter,