This function applies a lens flare effect to the image.
Declaration:
Copy Code | |
---|---|
AT_ERRCOUNT ACCUAPI IG_FX_lens_flare( HIGEAR hIGear, AT_INT xPos, AT_INT yPos, AT_DOUBLE primaryBrightness, AT_DOUBLE secondaryBrightness, AT_MODE flareType ); |
Arguments:
Name | Type | Description |
hIGear | HIGEAR | Image to which to apply lens flare effect. |
xPos | AT_INT | X coordinate of the primary flare. |
yPos | AT_INT | Y coordinate of the primary flare. |
primaryBrightness | AT_DOUBLE | Brightness of the primary flare. This value should range from 0 to 1. |
secondaryBrightness | AT_DOUBLE | Brightness of the secondary flare. This value should range from 0 to 1. |
flareType | AT_MODE | Predefined flare type to use. Determines the shape and appearance of the lens flare elements. |
Return Value:
Returns the number of ImageGear errors that occurred during this function call.
Supported Raster Image Formats:
RGB – 3…48 bpp
RGBA – 4…64 bpp
RGBPA – 4…64 bpp
RGBEx – 1..16 bpc
RGBAEx – 1..16 bpc
RGBPAEx – 1..16 bpc
Sample:
Image Processing
Remarks:
The effect simulates a bright light, such as the sun, and some reflections within the lens. It is typically used to add a sense of drama or realism to a photographic image.