Visual Basic example

Visual C++ example

Syntax

long LightFlags

Overview

Refer to Applying Artistic Effects

Value

Meaning

FL_LINEAR_QUADRATIC

[0x1000] If this flag is set, the light will be computed according to the distance from the center which is represented by LightXOrigin and LightYOrigin properties, The brightness increase for every pixel is proportional to the distance to the effect’s center. If this flag is set, do not set FL_TRIGONOMETRY or FL_FREEHAND.

FL_TRIGONOMETRY

[0x2000] If this flag is set then the light will be generated by a sine or cosine function. If this is set, the LightFrequency, LightAngle, LightXOrigin and LightYOrigin properties are used to compute the light. If this flag is set, do not set FL_LINEAR_QUADRATIC or FL_FREEHAND.

FL_FREEHAND

[0x4000] If this flag is set, the user will pass the light shape in the UserShape property. If this flag is set, the LightAngle, UserShape and UserShapeCount properties will be used. The LightAngle property will determine the angle of the light lines compared to the X axis. If this flag is set, do not set FL_LINEAR_QUADRATIC or FL_TRIGONOMETRY.

FL_LINEAR_INNER

[0x0001] The linear light will be concentrated at the center (LightXOrigin, LightYOrigin) and will decrease as it moves away from the center. This flag is valid only if FL_LINEAR_QUADRATIC is also set.

FL_LINEAR_OUTER

[0x0002] The linear light will be concentrated at the far points from the center and will decrease inwards towards the center (LightXOrigin, LightYOrigin). This flag is valid only if FL_LINEAR_QUADRATIC is also set.

FL_QUADRATIC_INNER

[0x0004] The Quadratic light will be concentrated at the center (LightXOrigin, LightYOrigin) and will decrease as it moves away from the center. This flag is valid only if FL_LINEAR_QUADRATIC is also set.

FL_QUADRATIC_OUTER

[0x0008] The Quadratic light will be concentrated at the far points from the center and will decrease inwards towards the center (LightXOrigin, LightYOrigin). This flag is valid only if FL_LINEAR_QUADRATIC is also set.

FL_UNIDIRECTION

[0x0010] A sine or cosine function will generate the light as lines. This flag is valid only if FL_TRIGONOMETRY is also set. The lines are parallel and have no center. The LightAngle property determines the angle formed by these lines with the X axis.

FL_CIRCLES

[0x0020] Sine or cosine function will generate the light as circles around the center (LightXOrigin, LightYOrigin). This flag is valid only if FL_TRIGONOMETRY is also set.

FL_ADD

[0x0040] The LightRedAmplitude, LightGreenAmplitude, and LightBlueAmplitude properties are multiplied with the results of the selected function (sine, cosine, freehand). The results are then added to the pixel values of the equivalent channel. These functions as well as the real buffer values are from –1 to 1. This flag is valid only if FL_TRIGONOMETRY or FL_FREEHAND is also set.

FL_MUL

[0x0080] Multiply the color factor specified by the LightGreenAmplitude proeprty with the results of the selected function (sine, cosine, freehand). The results are multiplied with every channel value. This flag is valid only if FL_TRIGONOMETRY or FL_FREEHAND is also set.

Elements:

LightFrequency property, LightRedAmplitude property, LightGreenAmplitude property, LightBlueAmplitude property, LightAngle property, LightXOrigin property, LightYOrigin property, LightPhase property, UserShapeCount property, UserShape property, FunctionalLight method

Topics:

Raster Images: Artistic Effects