CDDrawAreaMBS.radialGradientColor(cx as Integer, cy as Integer, rx as Integer, ry as Integer, data() as Integer, periodic as boolean=false) as Integer

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	ChartDirector	MBS ChartDirector Plugin	8.2	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Creates a multi-point radial gradient color.

In this method, the color points are defined as an array of radial distances and colors, in the following format:

distance0, color0, distance1, color1, .... distanceN, colorN
The distances are specified as a number from 0 - 256 (0 - 100 in hex), in which 0 represents the center of the gradient defining ellipse, and 256 (100 in hex) represents the perimeter of the gradient defining ellipse.

For example, the array (in hex):

000000, FF0000, 000080, FFFF00, 000100, 00FF00
means the center (000000) is red (FF0000), the mid-point (000080 in hex) is yellow (FFFF00), and the perimeter (000100 in hex) is green (00FF00).

Argument	Default	Description
cx	(Mandatory)	The x coordinate of the center of the radial gradient.
cy	(Mandatory)	The y coordinate of the center of the radial gradient.
rx	(Mandatory)	The horizontal radius of the radial gradient defining ellipse.
ry	(Mandatory)	The vertical radius of the radial gradient defining ellipse.
colorArray	(Mandatory)	An array defining the radial distances and colors.
periodic	false	Specifies whether the gradient will repeat itself periodically. If the gradient does not repeat itself, the points that lie outside the gradient defining ellipse will assume the color at the perimeter of the gradient defining ellipse.

Return Value
A 32-bit integer representing the radial gradient color.

See also:

• radialGradientColor(cx as Integer, cy as Integer, rx as Integer, ry as Integer, startColor as color, endColor as color, periodic as boolean=false) as Integer
• radialGradientColor(cx as Integer, cy as Integer, rx as Integer, ry as Integer, startColor as Integer, endColor as Integer, periodic as boolean=false) as Integer

CDDrawAreaMBS.radialGradientColor(cx as Integer, cy as Integer, rx as Integer, ry as Integer, startColor as color, endColor as color, periodic as boolean=false) as Integer

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	ChartDirector	MBS ChartDirector Plugin	11.1	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Same as the other radialGradientColor method, but uses color instead of integer data type for passing color values.

See also:

• radialGradientColor(cx as Integer, cy as Integer, rx as Integer, ry as Integer, data() as Integer, periodic as boolean=false) as Integer
• radialGradientColor(cx as Integer, cy as Integer, rx as Integer, ry as Integer, startColor as Integer, endColor as Integer, periodic as boolean=false) as Integer

CDDrawAreaMBS.radialGradientColor(cx as Integer, cy as Integer, rx as Integer, ry as Integer, startColor as Integer, endColor as Integer, periodic as boolean=false) as Integer

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	ChartDirector	MBS ChartDirector Plugin	8.2	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Creates a two-point radial gradient color.

Argument	Default	Description
cx	(Mandatory)	The x coordinate of the center of the radial gradient.
cy	(Mandatory)	The y coordinate of the center of the radial gradient.
rx	(Mandatory)	The horizontal radius of the radial gradient defining ellipse.
ry	(Mandatory)	The vertical radius of the radial gradient defining ellipse.
startColor	(Mandatory)	The color at the center of the gradient defining ellipse.
endColor	(Mandatory)	The color at the perimeter of the gradient defining ellipse.
periodic	false	Specifies whether the gradient will repeat itself periodically. If the gradient does not repeat itself, the points that lie outside the gradient defining ellipse will assume the color at the perimeter of the gradient defining ellipse.

Return Value
A 32-bit integer representing the radial gradient color.

See also:

• radialGradientColor(cx as Integer, cy as Integer, rx as Integer, ry as Integer, data() as Integer, periodic as boolean=false) as Integer
• radialGradientColor(cx as Integer, cy as Integer, rx as Integer, ry as Integer, startColor as color, endColor as color, periodic as boolean=false) as Integer

CDDrawAreaMBS.rAffineTransform(a as Double, b as Double, c as Double, d as Double, e as Double, f as Double, bgColor as color, filter as Integer = 2, blur as Double = 1.0)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	ChartDirector	MBS ChartDirector Plugin	11.1	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Same as the other rAffineTransform method, but uses color instead of integer data type for passing color values.

See also:

• rAffineTransform(a as Double, b as Double, c as Double, d as Double, e as Double, f as Double, bgColor as Integer = &hFFFFFF, filter as Integer = 2, blur as Double = 1.0)

CDDrawAreaMBS.rAffineTransform(a as Double, b as Double, c as Double, d as Double, e as Double, f as Double, bgColor as Integer = &hFFFFFF, filter as Integer = 2, blur as Double = 1.0)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	ChartDirector	MBS ChartDirector Plugin	8.2	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Perform reverse affine transformation on the drawing surface.

A reverse affine transformation is an operation where every pixel is copied from another pixel according to the formula.

xSrc = a * xDest + b * yDest + cySrc = d * xDest + e * yDest + f
where (xDest, yDest) is a destination pixel, and (xSrc, ySrc) is where it should come from.

Many graphics operation, such as translation, rotation, and resizing, can be considered as a special case of reverse affine transformation.

Argument	Default	Description
a	(Mandatory)	The parameter 'a' in the coordinate transformation formula "xSrc = a * xDest + b * yDest + c".
b	(Mandatory)	The parameter 'b' in the coordinate transformation formula "xSrc = a * xDest + b * yDest + c".
c	(Mandatory)	The parameter 'c' in the coordinate transformation formula "xSrc = a * xDest + b * yDest + c".
d	(Mandatory)	The parameter 'd' in the coordinate transformation formula "ySrc = d * xDest + e * yDest + f".
e	(Mandatory)	The parameter 'e' in the coordinate transformation formula "ySrc = d * xDest + e * yDest + f".
f	(Mandatory)	The parameter 'f' in the coordinate transformation formula "ySrc = d * xDest + e * yDest + f".
bgColor	FFFFFF	The background color used to fill destination pixels that are not mapped to any source pixels.
filter	LinearFilter	The filter to use for re-sampling.
blur	1	The blur factor to use for re-sampling.

See also:

• rAffineTransform(a as Double, b as Double, c as Double, d as Double, e as Double, f as Double, bgColor as color, filter as Integer = 2, blur as Double = 1.0)

CDDrawAreaMBS.rect(x1 as Integer, y1 as Integer, x2 as Integer, y2 as Integer, edgeColor as color, fillColor as color, raisedEffect as Integer = 0)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	ChartDirector	MBS ChartDirector Plugin	11.1	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Same as the other rect method, but uses color instead of integer data type for passing color values.

See also:

• rect(x1 as Integer, y1 as Integer, x2 as Integer, y2 as Integer, edgeColor as Integer, fillColor as Integer, raisedEffect as Integer = 0)

CDDrawAreaMBS.rect(x1 as Integer, y1 as Integer, x2 as Integer, y2 as Integer, edgeColor as Integer, fillColor as Integer, raisedEffect as Integer = 0)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	ChartDirector	MBS ChartDirector Plugin	8.2	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Draws a rectangle.

Argument	Default	Description
x1	(Mandatory)	The x coordinate of one corner of the rectangle.
y1	(Mandatory)	The y coordinate of one corner of the rectangle.
x2	(Mandatory)	The x coordinate of the opposite corner of the rectangle.
y2	(Mandatory)	The y coordinate of the opposite corner of the rectangle.
edgeColor	(Mandatory)	The border color. To disable border, set the edgeColor the same as the fillColor.
fillColor	(Mandatory)	The fill color. To disable filling, set the fillColor to Transparent.
raisedEffect	0	The 3D border width. For positive values, the border will appear raised. For negative values, the border will appear depressed. A zero value means the border will appear flat. This argument is also used to support CDBaseChartMBS.glassEffect and CDBaseChartMBS.softLighting effects.

See also:

• rect(x1 as Integer, y1 as Integer, x2 as Integer, y2 as Integer, edgeColor as color, fillColor as color, raisedEffect as Integer = 0)

CDDrawAreaMBS.reduceColors(colorCount as Integer, blackAndWhite as boolean=false) as Integer

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	ChartDirector	MBS ChartDirector Plugin	8.2	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Reduces the number of colors in the image.

The colors in the image will be reduced to at most the number of colors specified, which should be 16 - 256. You may also set the image to black and white. In this case, the color count means number of grey levels.

The colors will be reduced by computing an optimal palette for the image. The image will then be converted using the palette based on the current dithering settings (see DrawArea.setDitherMethod).

Argument	Default	Description
colorCount	(Mandatory)	The maximum number of colors that image should have after after reduction. Must be between 16 - 256.
blackAndWhite	false	A true value means the image will be converted to black and white (with grey levels). A false value means the image will not be converted to black and white.

Return Value
The actual number of colors the converted image has.

CDDrawAreaMBS.removeDynamicLayer(keepOriginal as boolean = false)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	ChartDirector	MBS ChartDirector Plugin	12.3	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Removes the dynamic layer if any.

CDDrawAreaMBS.resize(newWidth as Integer, newHeight as Integer, filter as Integer = 1, blur as Double = 1.0)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	ChartDirector	MBS ChartDirector Plugin	8.2	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Resize the drawing surface.

Argument	Default	Description
newWidth	(Mandatory)	The new width of the drawing surface in pixels.
newHeight	(Mandatory)	The new height of the drawing surface in pixels.
filter	LinearFilter	The filter to use for re-sampling.
blur	1	The blur factor to use for re-sampling.

CDDrawAreaMBS.ring(cx as Integer, cy as Integer, rx as Integer, ry as Integer, rx2 as Integer, ry2 as Integer, edgeColor as color, fillColor as color)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	ChartDirector	MBS ChartDirector Plugin	11.1	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Same as the other ring method, but uses color instead of integer data type for passing color values.

See also:

• ring(cx as Integer, cy as Integer, rx as Integer, ry as Integer, rx2 as Integer, ry2 as Integer, edgeColor as Integer, fillColor as Integer)

CDDrawAreaMBS.ring(cx as Integer, cy as Integer, rx as Integer, ry as Integer, rx2 as Integer, ry2 as Integer, edgeColor as Integer, fillColor as Integer)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	ChartDirector	MBS ChartDirector Plugin	8.2	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Draws a ring.

See also:

• ring(cx as Integer, cy as Integer, rx as Integer, ry as Integer, rx2 as Integer, ry2 as Integer, edgeColor as color, fillColor as color)

CDDrawAreaMBS.ringSector(cx as Integer, cy as Integer, rx as Integer, ry as Integer, rx2 as Integer, ry2 as Integer, a1 as Double, a2 as Double, edgeColor as color, fillColor as color)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	ChartDirector	MBS ChartDirector Plugin	11.1	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Same as the other ringSector method, but uses color instead of integer data type for passing color values.

See also:

• ringSector(cx as Integer, cy as Integer, rx as Integer, ry as Integer, rx2 as Integer, ry2 as Integer, a1 as Double, a2 as Double, edgeColor as Integer, fillColor as Integer)

CDDrawAreaMBS.ringSector(cx as Integer, cy as Integer, rx as Integer, ry as Integer, rx2 as Integer, ry2 as Integer, a1 as Double, a2 as Double, edgeColor as Integer, fillColor as Integer)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	ChartDirector	MBS ChartDirector Plugin	8.2	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Draws a ring sector.

See also:

• ringSector(cx as Integer, cy as Integer, rx as Integer, ry as Integer, rx2 as Integer, ry2 as Integer, a1 as Double, a2 as Double, edgeColor as color, fillColor as color)

CDDrawAreaMBS.rotate(angle as Double, bgColor as color, cx as Double = -1, cy as Double = -1, filter as Integer = 2, blur as Double = 1.0)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	ChartDirector	MBS ChartDirector Plugin	11.1	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Same as the other rotate method, but uses color instead of integer data type for passing color values.

See also:

• rotate(angle as Double, bgColor as Integer = &hFFFFFF, cx as Double = -1, cy as Double = -1, filter as Integer = 2, blur as Double = 1.0)

CDDrawAreaMBS.rotate(angle as Double, bgColor as Integer = &hFFFFFF, cx as Double = -1, cy as Double = -1, filter as Integer = 2, blur as Double = 1.0)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	ChartDirector	MBS ChartDirector Plugin	8.2	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Rotate the drawing surface.

Argument	Default	Description
angle	(Mandatory)	The rotation angle measured clockwise in degrees.
bgColor	FFFFFF	The background color used to fill the space left after rotation.
cx	-1	The x coordinate of the center of rotation. -1 means rotating about the center of the drawing surface.
cy	-1	The y coordinate of the center of rotation. -1 means rotating about the center of the drawing surface.
filter	LinearFilter	The filter to use for re-sampling.
blur	1	The blur factor to use for re-sampling.

See also:

• rotate(angle as Double, bgColor as color, cx as Double = -1, cy as Double = -1, filter as Integer = 2, blur as Double = 1.0)