Leadtools.ImageProcessing.SpecialEffects Send comments on this topic. | Back to Introduction - All Topics | Help Version 16.5.9.25
ColoredBallsCommand Constructor(Int32,Int32,Int32,Int32,RasterColor,RasterColor,RasterColor,Int32,RasterColor[],Int32,Int32,ColoredBallsCommandFlags)
See Also  Example
Leadtools.ImageProcessing.SpecialEffects Namespace > ColoredBallsCommand Class > ColoredBallsCommand Constructor : ColoredBallsCommand Constructor(Int32,Int32,Int32,Int32,RasterColor,RasterColor,RasterColor,Int32,RasterColor[],Int32,Int32,ColoredBallsCommandFlags)



numberOfBalls
Number of balls that will be drawn in the image. Only positive values are accepted.
size
Average balls size, in pixels. Only positive values are accepted.
sizeVariation
Balls size variation. Valid values range from 0 to 100. Use 0 to have all balls the same size. Use 100 to have the size vary from 0 to 2 X uSize.
highLightAngle
Light source direction of the highlight color on the ball. This value is in hundredths of degrees (+/-). A positive value will rotate the highlight color clockwise, while a negative value will rotate the highlight color counter-clockwise. Valid values range from -36000 to + 36000.
highLightColor
Highlight color.
backGroundColor
Backgound color.
shadingColor
Shade (or gradient) color.
ripple
The number of shades that are used to produce the background. This value is divided internally by 100. For example, if lRipple = 200 the actual frequency is 2.
ballColors
An array of ball colors.
ballColorOpacity
Average ball color opacity. Valid values range from: 0 to 255 for 8-bit, 0 to 4095 for 12-bit, 0 to 65535 for 16-bit.
ballColorOpacityVariation
Ball color opacity variation. Valid values range from 0 to 100. Use 0 to have all pixels assigned the same opacity. Use 100 to have the opacity vary from 0 to 2 X ballColorOpacity.
flags
Enumeration that indicates the background color , shade (or gradient) type, ball type and ball color type.
Initializes a new ColoredBallsCommand with explicit parameters.

Syntax

Visual Basic (Declaration)  
Public Function New( _
   ByVal numberOfBalls As Integer, _
   ByVal size As Integer, _
   ByVal sizeVariation As Integer, _
   ByVal highLightAngle As Integer, _
   ByVal highLightColor As RasterColor, _
   ByVal backGroundColor As RasterColor, _
   ByVal shadingColor As RasterColor, _
   ByVal ripple As Integer, _
   ByVal ballColors() As RasterColor, _
   ByVal ballColorOpacity As Integer, _
   ByVal ballColorOpacityVariation As Integer, _
   ByVal flags As ColoredBallsCommandFlags _
)
Visual Basic (Usage) Copy Code
Dim numberOfBalls As Integer
Dim size As Integer
Dim sizeVariation As Integer
Dim highLightAngle As Integer
Dim highLightColor As RasterColor
Dim backGroundColor As RasterColor
Dim shadingColor As RasterColor
Dim ripple As Integer
Dim ballColors() As RasterColor
Dim ballColorOpacity As Integer
Dim ballColorOpacityVariation As Integer
Dim flags As ColoredBallsCommandFlags
 
Dim instance As ColoredBallsCommand(numberOfBalls, size, sizeVariation, highLightAngle, highLightColor, backGroundColor, shadingColor, ripple, ballColors, ballColorOpacity, ballColorOpacityVariation, flags)

Parameters

numberOfBalls
Number of balls that will be drawn in the image. Only positive values are accepted.
size
Average balls size, in pixels. Only positive values are accepted.
sizeVariation
Balls size variation. Valid values range from 0 to 100. Use 0 to have all balls the same size. Use 100 to have the size vary from 0 to 2 X uSize.
highLightAngle
Light source direction of the highlight color on the ball. This value is in hundredths of degrees (+/-). A positive value will rotate the highlight color clockwise, while a negative value will rotate the highlight color counter-clockwise. Valid values range from -36000 to + 36000.
highLightColor
Highlight color.
backGroundColor
Backgound color.
shadingColor
Shade (or gradient) color.
ripple
The number of shades that are used to produce the background. This value is divided internally by 100. For example, if lRipple = 200 the actual frequency is 2.
ballColors
An array of ball colors.
ballColorOpacity
Average ball color opacity. Valid values range from: 0 to 255 for 8-bit, 0 to 4095 for 12-bit, 0 to 65535 for 16-bit.
ballColorOpacityVariation
Ball color opacity variation. Valid values range from 0 to 100. Use 0 to have all pixels assigned the same opacity. Use 100 to have the opacity vary from 0 to 2 X ballColorOpacity.
flags
Enumeration that indicates the background color , shade (or gradient) type, ball type and ball color type.

Example

Run the ColoredBallsCommand on an image.

Visual Basic Copy Code
Public Sub ColoredBallsConstructorExample()
   RasterCodecs.Startup()
   Dim codecs As New RasterCodecs()
   codecs.ThrowExceptionsOnInvalidImages = True

   Dim leadImage As RasterImage = codecs.Load(LeadtoolsExamples.Common.ImagesPath.Path + "Master.jpg")

   ' Prepare the command
   Dim ballColors() As RasterColor
   ReDim ballColors(3)
   ballColors(0) = New RasterColor(255, 128, 64)
   ballColors(1) = New RasterColor(160, 80, 255)
   ballColors(2) = New RasterColor(64, 255, 100)
   ballColors(3) = New RasterColor(100, 255, 255)

   Dim command As New ColoredBallsCommand(1000, 15, 10, 4500, _
                     New RasterColor(255, 255, 255), _
                     New RasterColor(255, 0, 0), _
                     New RasterColor(255, 255, 0), _
                     200, ballColors, 64, 25, _
                     ColoredBallsCommandFlags.ShadingCircular Or _
                     ColoredBallsCommandFlags.Sticker Or _
                     ColoredBallsCommandFlags.BackGroundImage Or _
                     ColoredBallsCommandFlags.BallsColorOpacity)
   command.Run(leadImage)
   codecs.Save(leadImage, LeadtoolsExamples.Common.ImagesPath.Path + "Result.jpg", RasterImageFormat.Jpeg, 24)

   RasterCodecs.Shutdown()
End Sub
C# Copy Code
public void ColoredBallsConstructorExample() 

   // Load an image 
   RasterCodecs.Startup(); 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.ThrowExceptionsOnInvalidImages = true; 
 
   RasterImage image = codecs.Load(LeadtoolsExamples.Common.ImagesPath.Path + "Master.jpg"); 
 
   // Prepare the command 
   RasterColor [] ballColors = new RasterColor[4]; 
   ballColors[0] = new RasterColor(255,128,64); 
   ballColors[1] = new RasterColor(160,80,255); 
   ballColors[2] = new RasterColor(64,255,100); 
   ballColors[3] = new RasterColor(100,255,255); 
   ColoredBallsCommand command  = new ColoredBallsCommand(1000, 15, 10, 4500,  
      new RasterColor(255, 255, 255),  
      new RasterColor(255, 0, 0),  
      new RasterColor(255, 255, 0), 
      200, ballColors, 64, 25, 
      ColoredBallsCommandFlags.ShadingCircular | 
      ColoredBallsCommandFlags.Sticker | 
      ColoredBallsCommandFlags.BackGroundImage | 
      ColoredBallsCommandFlags.BallsColorOpacity); 
   command.Run(image); 
   codecs.Save(image, LeadtoolsExamples.Common.ImagesPath.Path + "Result.jpg", RasterImageFormat.Jpeg, 24); 
 
   RasterCodecs.Shutdown(); 
}

Requirements

Target Platforms: Microsoft .NET Framework 2.0, Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also