ImageGear .NET v25.2 - Updated
ImageGear.Processing.Advanced Assembly / ImageGear.Processing Namespace / ImGearEffects Class / FreeRadialLight Method
Image to apply free radial light effect to.
Center point in the image (in pixels) about which the effect is applied.
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.
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.




In This Topic
    FreeRadialLight Method
    In This Topic
    This method changes the colors of an image according to the pattern of a sine wave.
    Syntax
    'Declaration
     
    Public Shared Sub FreeRadialLight( _
       ByVal page As ImGearRasterPage, _
       ByVal center As ImGearPoint, _
       ByVal points() As Single, _
       ByVal amplitude() As Single, _
       ByVal frequency As Single, _
       ByVal phase As Single, _
       ByVal attenuation As Single _
    ) 
    'Usage
     
    Dim page As ImGearRasterPage
    Dim center As ImGearPoint
    Dim points() As Single
    Dim amplitude() As Single
    Dim frequency As Single
    Dim phase As Single
    Dim attenuation As Single
     
    ImGearEffects.FreeRadialLight(page, center, points, amplitude, frequency, phase, attenuation)
    public static void FreeRadialLight( 
       ImGearRasterPage page,
       ImGearPoint center,
       float[] points,
       float[] amplitude,
       float frequency,
       float phase,
       float attenuation
    )
    public: static void FreeRadialLight( 
       ImGearRasterPage* page,
       ImGearPoint center,
       float[]* points,
       float[]* amplitude,
       float frequency,
       float phase,
       float attenuation
    ) 
    public:
    static void FreeRadialLight( 
       ImGearRasterPage^ page,
       ImGearPoint center,
       array<float>^ points,
       array<float>^ amplitude,
       float frequency,
       float phase,
       float attenuation
    ) 

    Parameters

    page
    Image to apply free radial light effect to.
    center
    Center point in the image (in pixels) about which the effect is applied.
    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.
    Remarks
    The image will appear to have regularly spaced bars of light and/or shadow overlaid on top of it in a radial pattern.
    See Also