ImageGear Professional DLL v17.1 for Windows Accusoft
IG_FX_aging
Send Feedback  
ImageGear Professional DLL v17.1 for Windows > API Reference Guide > Core Component API Reference > Core Component Functions Reference > FX Functions > IG_FX_aging

Glossary Item Box

This function applies an aging effect to make an image look older.

Declaration:

  Copy Code
AT_ERRCOUNT ACCUAPI IG_FX_aging(
        HIGEAR hIGear,
        AT_FLOAT saturation, 
        AT_FLOAT deviation, 
        AT_FLOAT imageContrast, 
        AT_FLOAT lineContrast, 
        AT_INT lineDensity, 
        AT_FLOAT agingColor[],
        AT_INT agingColorCount
);

Arguments:

hIGear Image to which to apply aging effect.
saturation Adjusts color saturation of the original image. The value should range from 0 to 1, where 0 removes all color from the image and 1 does not adjust color saturation.
deviation Amount of noise to add to the image. The value should range from 0 to 50.
imageContrast Adjusts image contrast. The value should range from 0 to 1, where 0 is minimum contrast and 1 does not adjust contrast. Values less than 0 produce inverted contrast.
lineContrast Adjusts contrast of random vertical lines added to the image. The value should range from -1 to 1, where -1 is completely black lines, 0 is invisible lines, and 1 is completely white lines. Values between 0 and 1, for example, blend line color between original image pixel colors and white.
lineDensity Adjusts density (quantity) of random vertical lines added to the image. The value should range from 0 to the width of the image in pixels, where 0 would add no lines, and the width of the image in pixels would fill the image with lines.
agingColor [ ] Adjusts color tint of the image. The color of the image will be tinted according to the values of the array. The array consists of three elements which represent color adjustment factors, corresponding to image color space. Each element ranges from -1 to 1, where a value of 0 represents no change to the image's color component, -1 represents completely change to the color component's minimum value, and 1 represents complete change to the color component's maximum value.
agingColorCount Number of entries in the agingColor array. Must be equal to number of channels in the image.

Return Value:

Returns the number of ImageGear errors that occurred during this function call.

Supported Raster Image Formats:

Indexed RGB  with grayscale palette – 2…8 bpp
Grayscale, with no Grayscale LUT attached – 2…16 bpp
RGB – 3…48 bpp

Sample:

Image Processing

Remarks:

The effect can adjust image saturation and contrast, and add noise and random vertical lines to the image.

©2012. Accusoft Corporation. All Rights Reserved.