ImageGear .NET v25.1 - Updated
RippleFreeHand Method




ImageGear.Processing.Advanced Assembly > ImageGear.Processing Namespace > ImGearEffects Class : RippleFreeHand Method
Page to apply the effect to.
Strength of the Ripple effect.
Array of points containing relative light deviations along the X axis in each cell. 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.
Array of points containing relative light deviations along the Y axis in each cell. 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.
Horizontal period of the repeating pattern. It corresponds to number of points from the distributionX array that should be used in the transform, and does not have to be equal to the length of the array.
Index of the first point in the distributionX array to be used in the transform.
Vertical period of the repeating pattern. It corresponds to number of points from the distributionY array, that should be used in the transform, and does not have to be equal to the length of the array.
Index of the first point in the distributionY array to be used in the transform.
Specifies how much the ripple pattern should be smoothed before applying.
Specifies the angle for the ripple pattern, in degrees. Valid range is from 0 to 360.
This method provides the ripple effect on the image, as if it is looked at through a relief glass.
Syntax
'Declaration
 
Public Shared Sub RippleFreeHand( _
   ByVal page As ImGearRasterPage, _
   ByVal depth As Single, _
   ByVal distributionX() As Single, _
   ByVal distributionY() As Single, _
   ByVal periodX As Integer, _
   ByVal phaseX As Integer, _
   ByVal periodY As Integer, _
   ByVal phaseY As Integer, _
   ByVal smoothness As Single, _
   ByVal angle As Single _
) 
'Usage
 
Dim page As ImGearRasterPage
Dim depth As Single
Dim distributionX() As Single
Dim distributionY() As Single
Dim periodX As Integer
Dim phaseX As Integer
Dim periodY As Integer
Dim phaseY As Integer
Dim smoothness As Single
Dim angle As Single
 
ImGearEffects.RippleFreeHand(page, depth, distributionX, distributionY, periodX, phaseX, periodY, phaseY, smoothness, angle)
public static void RippleFreeHand( 
   ImGearRasterPage page,
   float depth,
   float[] distributionX,
   float[] distributionY,
   int periodX,
   int phaseX,
   int periodY,
   int phaseY,
   float smoothness,
   float angle
)
public: static void RippleFreeHand( 
   ImGearRasterPage* page,
   float depth,
   float[]* distributionX,
   float[]* distributionY,
   int periodX,
   int phaseX,
   int periodY,
   int phaseY,
   float smoothness,
   float angle
) 
public:
static void RippleFreeHand( 
   ImGearRasterPage^ page,
   float depth,
   array<float>^ distributionX,
   array<float>^ distributionY,
   int periodX,
   int phaseX,
   int periodY,
   int phaseY,
   float smoothness,
   float angle
) 

Parameters

page
Page to apply the effect to.
depth
Strength of the Ripple effect.
distributionX
Array of points containing relative light deviations along the X axis in each cell. 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.
distributionY
Array of points containing relative light deviations along the Y axis in each cell. 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.
periodX
Horizontal period of the repeating pattern. It corresponds to number of points from the distributionX array that should be used in the transform, and does not have to be equal to the length of the array.
phaseX
Index of the first point in the distributionX array to be used in the transform.
periodY
Vertical period of the repeating pattern. It corresponds to number of points from the distributionY array, that should be used in the transform, and does not have to be equal to the length of the array.
phaseY
Index of the first point in the distributionY array to be used in the transform.
smoothness
Specifies how much the ripple pattern should be smoothed before applying.
angle
Specifies the angle for the ripple pattern, in degrees. Valid range is from 0 to 360.
Remarks
This method provides the ripple effect on the image, as if it is looked at through a relief glass. The method uses a custom ripple pattern, defined as two one-dimensional arrays containing light deviations in X and Y directions.
See Also

Reference

ImGearEffects Class
ImGearEffects Members
ImGearRasterPage Class
Ripple Method
RippleTexture Method