CDDrawAreaMBS.linearGradientColor(startX as Integer, startY as Integer, endX as Integer, endY 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 linearGradientColor method, but uses color instead of integer data type for passing color values.

See also:

• linearGradientColor(startX as Integer, startY as Integer, endX as Integer, endY as Integer, colors() as color, periodic as boolean=false) as Integer
• linearGradientColor(startX as Integer, startY as Integer, endX as Integer, endY as Integer, colors() as Integer, periodic as boolean=false) as Integer
• linearGradientColor(startX as Integer, startY as Integer, endX as Integer, endY as Integer, startColor as Integer, endColor as Integer, periodic as boolean=false) as Integer

CDDrawAreaMBS.linearGradientColor(startX as Integer, startY as Integer, endX as Integer, endY 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 linear gradient color.

Argument	Default	Description
startX	(Mandatory)	The x coordinate of the starting point of the reference gradient line segment.
startY	(Mandatory)	The y coordinate of the starting point of the reference gradient line segment.
endX	(Mandatory)	The x coordinate of the ending point of the reference gradient line segment.
endY	(Mandatory)	The y coordinate of the ending point of the reference gradient line segment.
startColor	(Mandatory)	The color at the starting point of the reference gradient line segment.
endColor	(Mandatory)	The color at the ending point of the reference gradient line segment.
periodic	false	Specifies whether the gradient will repeat itself periodically. If the gradient does not repeat itself, the points that lie beyond the end points of the gradient line segment will assume the colors of the end points.

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

See also:

• linearGradientColor(startX as Integer, startY as Integer, endX as Integer, endY as Integer, colors() as color, periodic as boolean=false) as Integer
• linearGradientColor(startX as Integer, startY as Integer, endX as Integer, endY as Integer, colors() as Integer, periodic as boolean=false) as Integer
• linearGradientColor(startX as Integer, startY as Integer, endX as Integer, endY as Integer, startColor as color, endColor as color, periodic as boolean=false) as Integer

CDDrawAreaMBS.load(path as string) as boolean

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

Load an image file into the current DrawArea.

This method will overwrite the current DrawArea. The image type is determined based on file extension, which must be png, jpg/jpeg, gif or wbmp/wmp.

Argument	Default	Description
filename	(Mandatory)	The filename of the image to be loaded.

Return Value
A true value indicates no error. A false value indicates the operation is unsuccessful.

CDDrawAreaMBS.loadData(data as MemoryBlock, ImgType as Integer = -1) as boolean

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

Loads image from data in MemoryBlock.

Optionally provide image type.
Returns true on success or false on failure.

See also:

• loadData(data as string, ImgType as Integer = -1) as boolean

CDDrawAreaMBS.loadData(data as string, ImgType as Integer = -1) as boolean

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

Loads image from data in String.

Optionally provide image type.
Returns true on success or false on failure.

See also:

• loadData(data as MemoryBlock, ImgType as Integer = -1) as boolean

CDDrawAreaMBS.loadGIF(path as string) as boolean

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

Load a GIF image into the current DrawArea.

This method will overwrite the current DrawArea.

Argument	Default	Description
filename	(Mandatory)	The filename of the image to be loaded.

Return Value
A true value indicates no error. A false value indicates the operation is unsuccessful.

CDDrawAreaMBS.loadJPG(path as string) as boolean

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

Load a JPG image into the current DrawArea.

This method will overwrite the current DrawArea.

Argument	Default	Description
filename	(Mandatory)	The filename of the image to be loaded.

Return Value
A true value indicates no error. A false value indicates the operation is unsuccessful.

CDDrawAreaMBS.loadPNG(path as string) as boolean

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

Load a PNG image into the current DrawArea.

This method will overwrite the current DrawArea.

Argument	Default	Description
filename	(Mandatory)	The filename of the image to be loaded.

Return Value
A true value indicates no error. A false value indicates the operation is unsuccessful.

CDDrawAreaMBS.loadWMP(path as string) as boolean

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

Load a WAP bitmap image into the current DrawArea.

This method will overwrite the current DrawArea.

Argument	Default	Description
filename	(Mandatory)	The filename of the image to be loaded.

Return Value
A true value indicates no error. A false value indicates the operation is unsuccessful.

CDDrawAreaMBS.merge(d as CDDrawAreaMBS, x as Integer, y as Integer, align as Integer, transparency as Integer)

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

Copy another DrawArea to the current DrawArea.

Argument	Default	Description
d	(Mandatory)	A DrawArea object representing the source.
x	(Mandatory)	The x coordinate of a reference point in the current DrawArea.
y	(Mandatory)	The y coordinate of a reference point in the current DrawArea.
align	(Mandatory)	The alignment of the source DrawArea relative to the reference point. See Alignment Specification for supported alignment types.
transparency	(Mandatory)	Specify the transparency level when copying the other DrawArea to the current DrawArea. A value of 0 means non-transparent. A value of 255 means totally transparent.

CDDrawAreaMBS.move(xOffset as Double, yOffset 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 move method, but uses color instead of integer data type for passing color values.

See also:

• move(xOffset as Double, yOffset as Double, bgColor as Integer = &hFFFFFF, filter as Integer = 2, blur as Double = 1.0)

CDDrawAreaMBS.move(xOffset as Double, yOffset 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

Moves the drawing surface.

Argument	Default	Description
xOffset	(Mandatory)	The pixel offset to move towards the left.
yOffset	(Mandatory)	The pixel offset to move towards the bottom.
bgColor	FFFFFF	The background color used to fill the space left after moving.
filter	LinearFilter	The filter to use for re-sampling. (Only applies for fractional pixel offsets.)
blur	1	The blur factor to use for re-sampling. (Only applies for fractional pixel offsets.)

See also:

• move(xOffset as Double, yOffset as Double, bgColor as color, filter as Integer = 2, blur as Double = 1.0)

CDDrawAreaMBS.out(file as folderitem) as boolean

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

Writes the DrawArea to an image file.

The file format is determined based on file extension, which must be png, jpg/jpeg, gif, wbmp/wmp or bmp.

Argument	Default	Description
filename	(Mandatory)	The filename of the output image file.

Return Value
A true value indicates no error. A false value indicates the operation is unsuccessful.

CDDrawAreaMBS.outBMP as string

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

Writes the DrawArea as a BMP image to memory.

See also:

• outBMP(file as folderitem) as boolean

CDDrawAreaMBS.outBMP(file as folderitem) as boolean

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

Writes the DrawArea to a BMP image file.

Argument	Default	Description
filename	(Mandatory)	The filename of the output image file.

Return Value
A true value indicates no error. A false value indicates the operation is unsuccessful.

See also:

• outBMP as string

CDDrawAreaMBS.outGIF as string

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

Writes the DrawArea as a GIF image to memory.

See also:

• outGIF(file as folderitem) as boolean

CDDrawAreaMBS.outGIF(file as folderitem) as boolean

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

Writes the DrawArea to a GIF image file.

Argument	Default	Description
filename	(Mandatory)	The filename of the output image file.

Return Value
A true value indicates no error. A false value indicates the operation is unsuccessful.

See also:

• outGIF as string

CDDrawAreaMBS.outJPG(file as folderitem, quality as Integer = 80) as boolean

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

Writes the DrawArea to a JPEG image file.

Argument	Default	Description
filename	(Mandatory)	The filename of the output image file.
quality	80	The quality of the image.

Return Value
A true value indicates no error. A false value indicates the operation is unsuccessful.

See also:

• outJPG(quality as Integer = 80) as string

CDDrawAreaMBS.outJPG(quality as Integer = 80) as string

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

Writes the DrawArea as a JPEG image to memory.

Argument	Default	Description
quality	80	The quality of the image.

Return Value
A binary string containing the JPEG image.

See also:

• outJPG(file as folderitem, quality as Integer = 80) as boolean

CDDrawAreaMBS.outPDF as string

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

Writes the DrawArea as a PDF image to memory.

See also:

• outPDF(file as folderitem) as boolean

CDDrawAreaMBS.outPDF(file as folderitem) as boolean

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

Writes the DrawArea to a PDF image file.

A return value being true indicates no error. A false value indicates the operation is unsuccessful.

See also:

• outPDF as string

CDDrawAreaMBS.outPicture as picture

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

Writes the DrawArea into a picture.

Returns nil on any error.

CDDrawAreaMBS.outPNG as string

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

Writes the DrawArea as a PNG image to memory.

See also:

• outPNG(file as folderitem) as boolean

CDDrawAreaMBS.outPNG(file as folderitem) as boolean

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

Writes the DrawArea to a PNG image file.

Argument	Default	Description
filename	(Mandatory)	The filename of the output image file.

Return Value
A true value indicates no error. A false value indicates the operation is unsuccessful.

See also:

• outPNG as string

CDDrawAreaMBS.outSVG(file as folderitem, options as string = "") as boolean

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

Writes the DrawArea to a SVG or SVGZ image file.

To output true vector graphics in SVG or SVGZ format, please ensure DrawArea.enableVectorOutput is called immediately after creating the DrawArea object. Otherwise the output will be a bitmap image embedded in SVG or SVGZ.

Arguments:

Argument	Default	Description
file	(Mandatory)	The file of the output image file.
options	""	A text string specifying optional parameters for the SVG output. Currently, the only supported text string is "compress", which means to create a SVGZ (compressed SVG) instead of a regular SVG.

See also:

• outSVG(options as string = "") as string

Some examples using this method:

• /ChartDirector/simplePie with SVG output

CDDrawAreaMBS.outSVG(options as string = "") as string

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

Writes the DrawArea as a SVG or SVGZ image to memory.

To output true vector graphics in SVG or SVGZ format, please ensure DrawArea.enableVectorOutput is called immediately after creating the DrawArea object. Otherwise the output will be a bitmap image embedded in SVG or SVGZ.

Arguments:

Argument	Default	Description
options	""	A text string specifying optional parameters for the SVG output. Currently, the only supported text string is "compress", which means to create a SVGZ (compressed SVG) instead of a regular SVG.

Return Value
A memory block containing the SVG or SVGZ image.

See also:

• outSVG(file as folderitem, options as string = "") as boolean

CDDrawAreaMBS.outWMP as string

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

Writes the DrawArea as a WAP bitmap image to memory.

See also:

• outWMP(file as folderitem) as boolean

CDDrawAreaMBS.outWMP(file as folderitem) as boolean

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

Writes the DrawArea to a WAP bitmap image file.

Argument	Default	Description
filename	(Mandatory)	The filename of the output image file.

Return Value
A true value indicates no error. A false value indicates the operation is unsuccessful.

See also:

• outWMP as string

CDDrawAreaMBS.patternColor(colors() as color, height as Integer, startX as Integer = 0, startY as Integer = 0) 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 patternColor method, but uses color instead of integer data type for passing color values.

See also:

• patternColor(colors() as Integer, height as Integer, startX as Integer = 0, startY as Integer = 0) as Integer
• patternColor(file as folderitem, startX as Integer = 0, startY as Integer = 0) as Integer

CDDrawAreaMBS.patternColor(colors() as Integer, height as Integer, startX as Integer = 0, startY as Integer = 0) 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 pattern color using an array of colors as the bitmap pattern.

A pattern color is a dynamic color that changes according to a 2D periodic pattern. When it is used to fill an area, the area will look like being tiled with a wallpaper pattern.

Argument	Default	Description
colorArray	(Mandatory)	An array of colors representing the colors of the bitmap pixels. The color of the pixel at (x, y) should correspond to index (x + y * width - 1) of the array.
height	(Mandatory)	The height of the bitmap in pixels. (The width is automatically computed as the size of the color array divided by the height.)
startX	0	The x coordinate of a reference point to align with the top-left corner the pattern.
startY	0	The y coordinate of a reference point to align with the top-left corner the pattern.

Return Value
A 32-bit integer representing the pattern color.

See also:

• patternColor(colors() as color, height as Integer, startX as Integer = 0, startY as Integer = 0) as Integer
• patternColor(file as folderitem, startX as Integer = 0, startY as Integer = 0) as Integer

CDDrawAreaMBS.patternColor(file as folderitem, startX as Integer = 0, startY as Integer = 0) 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 pattern color by loading the pattern from an image file.

A pattern color is a dynamic color that changes according to a 2D periodic pattern. When it is used to fill an area, the area will look like being tiled with a wallpaper pattern.

ChartDirector will automatically detect the image file format using the file extension, which must either png, jpg, jpeg, gif, wbmp or wmp (case insensitive).

Please refer to DrawArea.setSearchPath on the directory that ChartDirector will search for the file.

Argument	Default	Description
filename	(Mandatory)	An image file providing the pattern.
startX	0	The x coordinate of a reference point to align with the top-left corner the pattern.
startY	0	The y coordinate of a reference point to align with the top-left corner the pattern.

Return Value
A 32-bit integer representing the pattern color.

See also:

• patternColor(colors() as color, height as Integer, startX as Integer = 0, startY as Integer = 0) as Integer
• patternColor(colors() as Integer, height as Integer, startX as Integer = 0, startY as Integer = 0) as Integer

CDDrawAreaMBS.Pixel(x as Integer, y as Integer, c as Integer)

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

Draw a pixel.

Argument	Default	Description
x	(Mandatory)	The x coordinate of the pixel.
y	(Mandatory)	The y coordinate of the pixel.
c	(Mandatory)	The color of the pixel.

CDDrawAreaMBS.polygon(x() as Double, y() 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 polygon method, but uses color instead of integer data type for passing color values.

See also:

• polygon(x() as Double, y() as Double, edgeColor as Integer, fillColor as Integer)
• polygon(x() as Integer, y() as Integer, edgeColor as color, fillColor as color)
• polygon(x() as Integer, y() as Integer, edgeColor as Integer, fillColor as Integer)

CDDrawAreaMBS.polygon(x() as Double, y() 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 polygon.

Argument	Default	Description
x	(Mandatory)	An array of numbers representing the x coordinates of the vertices of a polygon.
y	(Mandatory)	An array of numbers representing the y coordinates of the vertices of a polygon.
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.

See also:

• polygon(x() as Double, y() as Double, edgeColor as color, fillColor as color)
• polygon(x() as Integer, y() as Integer, edgeColor as color, fillColor as color)
• polygon(x() as Integer, y() as Integer, edgeColor as Integer, fillColor as Integer)

CDDrawAreaMBS.polygon(x() as Integer, y() 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 polygon method, but uses color instead of integer data type for passing color values.

See also:

• polygon(x() as Double, y() as Double, edgeColor as color, fillColor as color)
• polygon(x() as Double, y() as Double, edgeColor as Integer, fillColor as Integer)
• polygon(x() as Integer, y() as Integer, edgeColor as Integer, fillColor as Integer)

CDDrawAreaMBS.polygon(x() as Integer, y() 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 polygon.

x	(Mandatory)	An array of numbers representing the x coordinates of the vertices of a polygon.
y	(Mandatory)	An array of numbers representing the y coordinates of the vertices of a polygon.
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.

none

See also:

• polygon(x() as Double, y() as Double, edgeColor as color, fillColor as color)
• polygon(x() as Double, y() as Double, edgeColor as Integer, fillColor as Integer)
• polygon(x() as Integer, y() as Integer, edgeColor as color, fillColor as color)

CDDrawAreaMBS.polyShape(xy() as integer, edgeColor as color, fillColor as color)

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

Draws a shape.

A simple shape can be a polygon or an ellipse. A polygon an be specified as an array of numbers (x0, y0, x1, y1, .....) representing the coordinates of the polygon vertices. As a polygon must have at least 3 vertices, the array must contain at least 6 numbers. If it contains only 4 numbers, it is will considered as an ellipse, with the numbers (x, y, rx, ry) interpreted as the coordinates of the center and the horizontal and vertical radii.

A complex shape is composed of multiple simple shapes. For example, a donut is a complex shape composed of two concentric circles. The shape is filled using the even-odd rule. (The web should have a lot of explanation on what is the even-odd rule in graphics.) A complex shape can be specified by including multiple simple shapes in the array, using the NewShape constant to separate them.

Argument	Default	Description
xy	(Mandatory)	An array of integers specifying the shape.
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.

See also:

• polyShape(xy() as integer, edgeColor as Integer, fillColor as Integer)

CDDrawAreaMBS.polyShape(xy() as integer, edgeColor as Integer, fillColor as Integer)

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

Draws a shape.

A simple shape can be a polygon or an ellipse. A polygon an be specified as an array of numbers (x0, y0, x1, y1, .....) representing the coordinates of the polygon vertices. As a polygon must have at least 3 vertices, the array must contain at least 6 numbers. If it contains only 4 numbers, it is will considered as an ellipse, with the numbers (x, y, rx, ry) interpreted as the coordinates of the center and the horizontal and vertical radii.

A complex shape is composed of multiple simple shapes. For example, a donut is a complex shape composed of two concentric circles. The shape is filled using the even-odd rule. (The web should have a lot of explanation on what is the even-odd rule in graphics.) A complex shape can be specified by including multiple simple shapes in the array, using the NewShape constant to separate them.

Argument	Default	Description
xy	(Mandatory)	An array of integers specifying the shape.
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.

See also:

• polyShape(xy() as integer, edgeColor as color, fillColor as color)

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)