The methods of the Ilu class are listed below. For a complete list of Ilu class members, see the Ilu Members topic.
![]() ![]() | The story behind this function is actually sorta funny. I had been using a picture of me (contact me if you want it! =) as a test image, and I started working on some colour matrix filters. Well, my first attempt screwed-up, because I had changed the equations to accomodate my bgr image, but I transposed the equations entirely wrong. I got a really neat output, though, where I looked like an alien. =) I decided to keep the screw-up and placed it in iluAlienify. I can't say I've ever run across a filter like this before. |
![]() ![]() | iluBlurAvg blurs an image using an averaging convolution filter. The filter is applied up to Iter number of times, giving more of a blurring effect the higher Iter is. |
![]() ![]() | iluBlurGaussian blurs an image using a Gaussian convolution filter, which usually gives better results than the filter used by iluBlurAvg. The filter is applied up to Iter number of times, giving more of a blurring effect the higher Iter is. |
![]() ![]() | iluBuildMipmaps generates power-of-2 mipmaps for an image. If the image does not have power-of-2 dimensions, then the image is resized via iluScale. Mipmaps are then generated for the image, down to a 1x1 image. To use the mipmaps, see ilActiveMipmap. |
![]() ![]() | iluColoursUsed creates a copy of the image data, quicksorts it and counts the number of unique colours in the image. This value is returned without affecting the original image. |
![]() ![]() | iluCompareImage compares the current image to the image having the name in Comp. If both images are identical, IL_TRUE is returned. IL_FALSE is returned if the images are not identical. The bound image before calling this function remains the bound image after calling ilCompareImage. |
![]() ![]() | iluContrast changes the contrast of an image by using interpolation and extrapolation. Common values for Contrast are in the range -0.5 to 1.7. Anything below 0.0 generates a negative of the image with varying contrast. 1.0 outputs the original image. 0.0 - 1.0 lowers the contrast of the image. 1.0 - 1.7 increases the contrast of the image. This effect is caused by interpolating (or extrapolating) the source image with a totally grey image. |
![]() ![]() | |
![]() ![]() | iluCrop "crops" the current image to new dimensions. The new image appears the same as the original, but portions of the image are clipped-off, depending on the values of the parameters of these functions. If XOff + Width, YOff + Height or ZOff + Depth is larger than the current image's dimensions, ILU_ILLEGAL_OPERATION is set. If ZOff is minus or equal to one the crop will be done only on 2 dimensions |
![]() ![]() | iluDeleteImage is a convenience function to delete a single image instead of calling ilDeleteImages |
![]() ![]() | iluEdgeDetectP detects the edges in the current image by combining two convolution filters. The filters used are Prewitt filters. |
![]() ![]() | iluEdgeDetectP detects the edges in the current image by combining two convolution filters. The filters used are Prewitt filters. |
![]() ![]() | iluEdgeDetectS detects the edges in the current image by combining two convolution filters. The filters used are Sobel filters. |
![]() ![]() | iluEmboss embosses an image, causing it to have a "relief" feel to it using a convolution filter: |
![]() ![]() | 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 |
![]() ![]() | |
![]() ![]() | |
![]() ![]() | iluErrorString returns a human-readable string of the error in Error. This can be useful for displaying the human-readable error in your program to let the user know wtf just happened. |
![]() ![]() | iluFlipImage inverts an image over the x axis. The image will be upside-down after calling this function. If this function is called twice in succession, the image is restored to its original state. A version of this function in OpenIL is used throughout internally when loading images to correct images that would otherwise be upside-down. Using ilOriginFunc will essentially tell the library which way is up. |
![]() ![]() | reater than 1.0, the image is brightened. It uses interpolation so it's slower then iluGammaCorrectScale |
![]() ![]() | iluGenImage is a convenience function to delete a single image instead of calling ilGenImages |
![]() ![]() | The iluGetImageInfo function retrieves information about the current image in an ILinfo struct. This is useful when you are repeatedly calling ilGetInteger and is more efficient in this case. |
![]() ![]() | The iluGetInteger function returns the value of a selected mode |
![]() ![]() | The iluGetIntegerv function returns the mode value in the Param parameter. |
![]() ![]() | iluGetString returns a constant human-readable string describing the current OpenILU implementation. |
![]() ![]() | 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. |
![]() ![]() | iluInit starts ILU and must be called prior to using ILU |
![]() ![]() | iluInvertAlpha inverts the alpha of the currently bound image. |
![]() ![]() | |
![]() ![]() | iluMirror mirrors an image across its y axis, making it appear backwards. |
![]() ![]() | iluNegative creates a negative version of an image, like it was viewed as a picture negative instead of the actual picture. The effect is caused by inverting the image's colours, such as a green pixel would become purple (red-blue). |
![]() ![]() | |
![]() ![]() | iluPixelize performs the effect that can be seen on television, where people want their identity to remain anonymous, so the editors cover the person's face with a very blocky pixelized version. PixSize specifies how blocky the image should be, with 1 being the lowest blockiness (doesn't change the image). |
![]() ![]() | |
![]() ![]() | |
![]() ![]() | |
![]() ![]() | iluRotate simply rotates an image about the center by Angle degrees. The background where there is space left by the rotation will be set to the clear colour. |
![]() ![]() | |
![]() ![]() | iluSaturate1f applies a saturation consistent with the IL_LUMINANCE conversion values to red, green and blue. |
![]() ![]() | iluScaleColours scales the individual colour components of the current bound image. Using 1.0f as any of the parameters yields that colour component's original plane in the new image. |
![]() ![]() | The iluScale function scales the image to the new dimensions specified, shrinking or enlarging the image, depending on the image's original dimensions. There are different filters that can be used to scale an image, and which filter to use can be specified via iluImageParameter. |
![]() ![]() | |
![]() ![]() | iluSharpen can actually either sharpen or blur an image, depending on the value of Factor. iluBlurAvg and iluBlurGaussian are much faster for blurring, though. When Factor is 1.0, the image goes unchanged. When Factor is in the range 0.0 - 1.0, the current image is blurred. When Factor is in the range 1.0 - 2.5, the current image is sharpened. To achieve a more pronounced sharpening/blurring effect, simply increase the number of iterations by increasing the value passed in Iter. |
![]() ![]() | iluSwapColours "swaps" the colour order of the current image. If the current image is in bgr(a) format, iluSwapColours will change the image to use rgb(a) format, or vice-versa. This can be helpful when you want to manipulate the image data yourself but only want to use a certain colour order. To determine the current colour order, call ilGetInteger with the IL_IMAGE_FORMAT parameter. |
![]() ![]() |
![]() | |
![]() | |
![]() | |
![]() |
Ilu Class | Tao.DevIl Namespace