This method changes the colors of an image according to the pattern of a sine wave.
Syntax
'Declaration
Public Shared Sub FreeDirectionalLight( _
ByVal As ImGearRasterPage, _
ByVal As Single, _
ByVal () As Single, _
ByVal () As Single, _
ByVal As Single, _
ByVal As Single, _
ByVal As Single _
)
'Usage
Dim page As ImGearRasterPage
Dim direction As Single
Dim points() As Single
Dim amplitude() As Single
Dim frequency As Single
Dim phase As Single
Dim attenuation As Single
ImGearEffects.FreeDirectionalLight(page, direction, points, amplitude, frequency, phase, attenuation)
public static void FreeDirectionalLight(
ImGearRasterPage ,
float ,
float[] ,
float[] ,
float ,
float ,
float
)
public: static void FreeDirectionalLight(
ImGearRasterPage* ,
float ,
float[]* ,
float[]* ,
float ,
float ,
float
)
Parameters
- page
- Image to apply free directional light effect to.
- direction
- Direction to apply the effect across the image. The value is specified as an
angle in degrees and ranges from 0 to 360.
- points
- Array of points containing relative light deviations along the period of the
sine wave. Each value typically ranges from -1 to 1. The number of points is flexible and should be
chosen based on the period length relative to the image size and desired resolution of the effect.
- amplitude
- Controls the magnitude of color adjustment for each channel of the image.
The number of elements of the array is typically set to the number of channels in the image. Each
value should range from 0 to 2, although higher values are possible. 0 represents no change in the
image color. Higher values represent more intense change. Color changes are clipped, so higher
values result in a harder edge to the waveform.
- frequency
- Frequency of sine wave. The value should be from 0 to 0.5. The higher the
frequency, the more bars will be visible.
- phase
- Phase of sine wave. The value should be from 0 to 2*PI (approximately 6.28). As
the phase is changed, the alignment of the bars is changed. This can be used to line up the bars
with image content or boundaries.
- attenuation
- Attenuation of sine wave. The value should be from -0.01 to 0.01.
Attenuation adjusts how much the amplitude of the sine wave is decreased or increased as the sine
wave proceeds. It can be used to cause the lighting to fade or intensify.
See Also