ImageGear .NET v25.1 - Updated
DirectionalLight Method




ImageGear.Processing.Advanced Assembly > ImageGear.Processing Namespace > ImGearEffects Class : DirectionalLight Method
Image to apply direct light effect to.
Direction to apply the effect across the image. The value is specified as an angle in degrees and ranges from 0 to 360.
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 of sine wave. The value should be from 0 to 0.5. The higher the frequency, the more bars will be visible.
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 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.
This method changes the colors of an image according to the pattern of a sine wave.
Syntax
'Declaration
 
Public Shared Sub DirectionalLight( _
   ByVal page As ImGearRasterPage, _
   ByVal direction As Single, _
   ByVal amplitude() As Single, _
   ByVal frequency As Single, _
   ByVal phase As Single, _
   ByVal attenuation As Single _
) 
'Usage
 
Dim page As ImGearRasterPage
Dim direction As Single
Dim amplitude() As Single
Dim frequency As Single
Dim phase As Single
Dim attenuation As Single
 
ImGearEffects.DirectionalLight(page, direction, amplitude, frequency, phase, attenuation)
public static void DirectionalLight( 
   ImGearRasterPage page,
   float direction,
   float[] amplitude,
   float frequency,
   float phase,
   float attenuation
)
public: static void DirectionalLight( 
   ImGearRasterPage* page,
   float direction,
   float[]* amplitude,
   float frequency,
   float phase,
   float attenuation
) 
public:
static void DirectionalLight( 
   ImGearRasterPage^ page,
   float direction,
   array<float>^ amplitude,
   float frequency,
   float phase,
   float attenuation
) 

Parameters

page
Image to apply direct 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.
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.
Remarks
The image will appear to have regularly spaced bars of light and shadow overlaid on top of it.
See Also

Reference

ImGearEffects Class
ImGearEffects Members
ImGearRasterPage Class