iluImageParameter
The iluImageParameter function sets some aspects of the behaviour of ilu.
ILvoid iluImageParameter(
ILenum PName,
ILenum Param
);
Parameters
- PName
- Parameter name. Accepted values are:
- ILU_FILTER
- What filter iluScale uses. The default is ILU_NEAREST.
- ILU_PLACEMENT
- Where to place the image when using iluEnlargeCanvas. The default is ILU_CENTER.
- Param
- Behaviour to use. Accepted values are:
- ILU_NEAREST
- Uses a nearest filter to scale the image (looks worst).
- ILU_LINEAR
- Uses a linear interpolation filter to scale the image (looks better).
- ILU_BILINEAR
- Uses a bilinear (or trilinear for 3d images) interpolation filter to scale the image (looks best).
- ILU_SCALE_BOX
- Uses a box filter to scale the image.
- ILU_SCALE_TRIANGLE
- Uses a triangle filter to scale the image.
- ILU_SCALE_BELL
- Uses a bell filter to scale the image.
- ILU_SCALE_BSPLINE
- Uses a b-spline filter to scale the image.
- ILU_SCALE_LANCZOS3
- Uses a lanczos filter to scale the image.
- ILU_SCALE_MITCHELL
- Uses a mitchell filter to scale the image.
- ILU_LOWER_LEFT
- Places the image in the lower left of the enlarged canvas.
- ILU_LOWER_RIGHT
- Places the image in the lower right of the enlarged canvas.
- ILU_UPPER_LEFT
- Places the image in the upper left of the enlarged canvas.
- ILU_UPPER_RIGHT
- Places the image in the upper right of the enlarged canvas.
- ILU_CENTER
- Places the image in the center of the enlarged canvas.
Remarks
iluImageParameter modifies the behaviour of some ilu functions. Right now, it controls the behaviour of iluEnlargeCanvas and iluScale. For ILU_FILTER, values for Param other than ILU_NEAREST, ILU_LINEAR and ILU_BILINEAR are higher-quality scaling filters and take longer to perform.
Error Codes
ILU_INVALID_ENUM - PName or Param was of an invalid value.
See Also
iluEnlargeCanvas, iluScale