CDDrawAreaMBS.hFlip

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

Function: Flip the drawing surface along the central horizontal line.

CDDrawAreaMBS.hline(x1 as Integer, x2 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

Function: Draws a horizontal line.
Notes:

Argument	Default	Description
x1	(Mandatory)	The x coordinate of the first end-point of the line.
x2	(Mandatory)	The x coordinate of the second end-point of the line.
y	(Mandatory)	The y coordinate of the line.
c	(Mandatory)	The color of the line.

CDDrawAreaMBS.hTriangleTransform(tWidth as Integer = -1, 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

Function: Wraps the drawing surface onto a horizontal triangle pointing leftwards.
Notes:

Argument	Default	Description
tWidth	-1	The width of the triangle in pixels.
bgColor	FFFFFF	The background color used to fill the space left after transformation.
filter	LinearFilter	The filter to use for re-sampling.
blur	1	The blur factor to use for re-sampling.

See also:

• hTriangleTransform(tWidth as Integer, bgColor as color, filter as Integer = 2, blur as Double = 1.0)

CDDrawAreaMBS.hTriangleTransform(tWidth as Integer, 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

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

See also:

• hTriangleTransform(tWidth as Integer = -1, bgColor as Integer = &hFFFFFF, filter as Integer = 2, blur as Double = 1.0)

CDDrawAreaMBS.initDynamicLayer

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

Function: Initializes a dynamic layer for drawing text and shapes.
Notes:
This method clears the existing dynamic layer, or creates a new one if there is no existing dynamic layer. This method returned a DrawArea object that can be used to draw on the dynamic layer. The dynamic layer can later be removed using BaseChart.removeDynamicLayer.

The design of the dynamic layer is for drawing small, rapidly updatable contents for desktop applications. For example, the dynamic layer can be used to implement a cross-hair mouse cursor, with text showing the location of the mouse cursor. To do this, in the mouse move event handler, BaseChart.initDynamicLayer can be used to create or clear the dynamic layer. The returned DrawArea object can then be used to draw the cross hair cursor (as two straight lines) and the text. When the mouse cursor leaves the chart, BaseChart.removeDynamicLayer can be used in the mouse out event handler to remove the cross-hair cursor and the text.

Note that as long as the dynamic layer is not removed with BaseChart.removeDynamicLayer, only the returned DrawArea object should be used to draw things on the dynamic layer. No other objects should be used to draw on the chart.

Returns a DrawArea object that can be used to add text and shapes to the dynamic layer.

CDDrawAreaMBS.line(x1 as Double, y1 as Double, x2 as Double, y2 as Double, colorValue as color, lineWidth as Integer = 1)

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

Function: Draw a straight line.
Notes:

Argument	Default	Description
x1	(Mandatory)	The x coordinate of the first end-point of the line.
y1	(Mandatory)	The y coordinate of the first end-point of the line.
x2	(Mandatory)	The x coordinate of the second end-point of the line.
y2	(Mandatory)	The y coordinate of the second end-point of the line.
c	(Mandatory)	The color of the line.
lineWidth	1	The line width (thickness).

See also:

• line(x1 as Double, y1 as Double, x2 as Double, y2 as Double, colorValue as Integer, lineWidth as Integer = 1)

CDDrawAreaMBS.line(x1 as Double, y1 as Double, x2 as Double, y2 as Double, colorValue as Integer, lineWidth as Integer = 1)

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

Function: Draw a straight line.
Notes:

Argument	Default	Description
x1	(Mandatory)	The x coordinate of the first end-point of the line.
y1	(Mandatory)	The y coordinate of the first end-point of the line.
x2	(Mandatory)	The x coordinate of the second end-point of the line.
y2	(Mandatory)	The y coordinate of the second end-point of the line.
c	(Mandatory)	The color of the line.
lineWidth	1	The line width (thickness).

See also:

• line(x1 as Double, y1 as Double, x2 as Double, y2 as Double, colorValue as color, lineWidth as Integer = 1)

CDDrawAreaMBS.linearGradientColor(startX as Integer, startY as Integer, endX as Integer, endY as Integer, colors() 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

Function: 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 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
• 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, colors() 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

Function: Creates a multi-point linear gradient color.
Notes:
In this method, the color points are defined as an array of positions and colors along a reference line segment, in the following format:

position0, color0, position1, color1, .... positionN, colorN
The positions are specified as a number from 0 - 256 (0 - 100 in hex), in which 0 represents the starting point of the reference line segment, and 256 (100 in hex) represents the ending point of the reference line segment.

For example, the array (in hex):

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

One common usage of multi-point gradient colors is to define colors that have metallic look and feel. ChartDirector comes from several predefined gradient color arrays as follows.

NameValue (in Hex)

goldGradient	000000, FFE743, 000060, FFFFE0, 0000B0, FFF0B0, 000100, FFE743
silverGradient	000000, C8C8C8, 000060, F8F8F8, 0000B0, E0E0E0, 000100, C8C8C8
redMetalGradient	000000, E09898, 000060, FFF0F0, 0000B0, F0D8D8, 000100, E09898
greenMetalGradient	000000, 98E098, 000060, F0FFF0, 0000B0, D8F0D8, 000100, 98E098
blueMetalGradient	000000, 9898E0, 000060, F0F0FF, 0000B0, D8D8F0, 000100, 9898E0

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.
colorArray	(Mandatory)	An array defining the positions and colors of the pixels along 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, startColor as color, endColor as color, 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 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

Function: 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

Function: Creates a two-point linear gradient color.
Notes:

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

Function: Load an image file into the current DrawArea.
Notes:
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

Function: Loads image from data in MemoryBlock.
Notes:
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

Function: Loads image from data in String.
Notes:
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

Function: Load a GIF image into the current DrawArea.
Notes:
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

Function: Load a JPG image into the current DrawArea.
Notes:
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

Function: Load a PNG image into the current DrawArea.
Notes:
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

Function: Load a WAP bitmap image into the current DrawArea.
Notes:
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

Function: Copy another DrawArea to the current DrawArea.
Notes:

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

Function: 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

Function: Moves the drawing surface.
Notes:

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

Function: Writes the DrawArea to an image file.
Notes:
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

Function: 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

Function: Writes the DrawArea to a BMP image file.
Notes:

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

Function: 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

Function: Writes the DrawArea to a GIF image file.
Notes:

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

Function: Writes the DrawArea to a JPEG image file.
Notes:

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

Function: Writes the DrawArea as a JPEG image to memory.
Notes:

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

Function: 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

Function: Writes the DrawArea to a PDF image file.
Notes: A return value being true indicates no error. A false value indicates the operation is unsuccessful.

See also:

• outPDF as string