DevIL Documentation Home | Previous | Next

iluEnlargeCanvas

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

 

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 height.
Depth
New image depth - must be larger than the current image's depth.

Remarks

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,