CDDrawAreaMBS.surface(cx1 as Double, y1 as Double, x2 as Double, y2 as Double, depthX as Integer, depthY 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 surface method, but uses color instead of integer data type for passing color values.

See also:

• surface(cx1 as Double, y1 as Double, x2 as Double, y2 as Double, depthX as Integer, depthY as Integer, edgeColor as Integer, fillColor as Integer)

Some examples using this method:

• /ChartDirector/surfacetexture

CDDrawAreaMBS.surface(cx1 as Double, y1 as Double, x2 as Double, y2 as Double, depthX as Integer, depthY 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 parallelogram.

Argument	Default	Description
x1	(Mandatory)	The x coordinate of the first end-point of one line of the parallelogram.
y1	(Mandatory)	The y coordinate of the first end-point of one line of the parallelogram.
x2	(Mandatory)	The x coordinate of the second end-point of one line of the parallelogram.
y2	(Mandatory)	The y coordinate of the second end-point of one line of the parallelogram.
depthX	(Mandatory)	The x displacement of the line segment that is parallel to the line segment above.
depthY	(Mandatory)	The y displacement of the line segment that is parallel to the line segment above.
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:

• surface(cx1 as Double, y1 as Double, x2 as Double, y2 as Double, depthX as Integer, depthY as Integer, edgeColor as color, fillColor as color)

CDDrawAreaMBS.text(str as string, font as string, fontIndex as Integer, fontHeight as Double, fontWidth as Double, angle as Double, vertical as boolean) as CDTTFTextMBS

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

Creates a TTFText object representing a text block.

The TTFText object contains methods to measure and draw the text. This method is useful if the size of the text is needed before deciding where the draw it.

Argument	Default	Description
text	(Mandatory)	A string representing the text to be drawn. See ChartDirector Mark Up Language on how to embed special tags in the text for sophisticated formatting.
font	(Mandatory)	The font name. See Font Specification for details on various font attributes.
fontIndex	(Mandatory)	The font index in case the font name refers to a font collection. An index of 0 means the first font.
fontHeight	(Mandatory)	The font height in points.
fontWidth	(Mandatory)	The font width in points.
angle	(Mandatory)	The rotation angle of the text.
vertical	(Mandatory)	A true value means the text is layout vertically (from top to bottom). A false value means the is layout horizontally (from left to right).

Return Value
The TTFText object created.

See font specification here:
http://www.monkeybreadsoftware.net/faq-chartdirectorfontspecification.shtml

See also:

• text(str as string, font as string, fontIndex as Integer, fontHeight as Double, fontWidth as Double, angle as Double, vertical as boolean, x as Integer, y as Integer, colorvalue as color, alignment as Integer = 7)
• text(str as string, font as string, fontIndex as Integer, fontHeight as Double, fontWidth as Double, angle as Double, vertical as boolean, x as Integer, y as Integer, colorvalue as Integer, alignment as Integer = 7)
• text(str as string, font as string, fontsize as Double) as CDTTFTextMBS
• text(str as string, font as string, fontsize as Double, x as Integer, y as Integer, colorvalue as color)
• text(str as string, font as string, fontsize as Double, x as Integer, y as Integer, colorvalue as Integer)

CDDrawAreaMBS.text(str as string, font as string, fontIndex as Integer, fontHeight as Double, fontWidth as Double, angle as Double, vertical as boolean, x as Integer, y as Integer, colorvalue as color, alignment as Integer = 7)

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 text method, but uses color instead of integer data type for passing color values.

See also:

• text(str as string, font as string, fontIndex as Integer, fontHeight as Double, fontWidth as Double, angle as Double, vertical as boolean) as CDTTFTextMBS
• text(str as string, font as string, fontIndex as Integer, fontHeight as Double, fontWidth as Double, angle as Double, vertical as boolean, x as Integer, y as Integer, colorvalue as Integer, alignment as Integer = 7)
• text(str as string, font as string, fontsize as Double) as CDTTFTextMBS
• text(str as string, font as string, fontsize as Double, x as Integer, y as Integer, colorvalue as color)
• text(str as string, font as string, fontsize as Double, x as Integer, y as Integer, colorvalue as Integer)

CDDrawAreaMBS.text(str as string, font as string, fontIndex as Integer, fontHeight as Double, fontWidth as Double, angle as Double, vertical as boolean, x as Integer, y as Integer, colorvalue as Integer, alignment as Integer = 7)

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

Draws text.

Argument	Default	Description
str	(Mandatory)	A string representing the text to be drawn. See ChartDirector Mark Up Language on how to embed special tags in the text for sophisticated formatting.
font	(Mandatory)	The font name. See Font Specification for details on various font attributes.
fontIndex	(Mandatory)	The font index in case the font name refers to a font collection. An index of 0 means the first font.
fontHeight	(Mandatory)	The font height in points.
fontWidth	(Mandatory)	The font width in points.
angle	(Mandatory)	The rotation angle of the text. The angle is measured in degrees in clockwise direction.
vertical	(Mandatory)	A true value means the text is layout vertically (from top to bottom). A false value means the is layout horizontally (from left to right).
x	(Mandatory)	The x coordinate of a reference point to align the text.
y	(Mandatory)	The y coordinate of a reference point to align the text.
color	(Mandatory)	The color of the text.
alignment	TopLeft	The position of the text relative to the reference point. See Alignment Specification for supported alignment types.

See font specification here:
http://www.monkeybreadsoftware.net/faq-chartdirectorfontspecification.shtml

See also:

• text(str as string, font as string, fontIndex as Integer, fontHeight as Double, fontWidth as Double, angle as Double, vertical as boolean) as CDTTFTextMBS
• text(str as string, font as string, fontIndex as Integer, fontHeight as Double, fontWidth as Double, angle as Double, vertical as boolean, x as Integer, y as Integer, colorvalue as color, alignment as Integer = 7)
• text(str as string, font as string, fontsize as Double) as CDTTFTextMBS
• text(str as string, font as string, fontsize as Double, x as Integer, y as Integer, colorvalue as color)
• text(str as string, font as string, fontsize as Double, x as Integer, y as Integer, colorvalue as Integer)

CDDrawAreaMBS.text(str as string, font as string, fontsize as Double) as CDTTFTextMBS

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

Creates a TTFText object representing a text block.

The TTFText object contains methods to measure and draw the text. This method is useful if the size of the text is needed before deciding where the draw it.

Argument	Default	Description
str	(Mandatory)	A string representing the text to be drawn. See ChartDirector Mark Up Language on how to embed special tags in the text for sophisticated formatting.
font	(Mandatory)	The font name. See Font Specification for details on various font attributes.
fontSize	(Mandatory)	The font size in points.

Return Value
The TTFText object created.

See font specification here:
http://www.monkeybreadsoftware.net/faq-chartdirectorfontspecification.shtml

See also:

• text(str as string, font as string, fontIndex as Integer, fontHeight as Double, fontWidth as Double, angle as Double, vertical as boolean) as CDTTFTextMBS
• text(str as string, font as string, fontIndex as Integer, fontHeight as Double, fontWidth as Double, angle as Double, vertical as boolean, x as Integer, y as Integer, colorvalue as color, alignment as Integer = 7)
• text(str as string, font as string, fontIndex as Integer, fontHeight as Double, fontWidth as Double, angle as Double, vertical as boolean, x as Integer, y as Integer, colorvalue as Integer, alignment as Integer = 7)
• text(str as string, font as string, fontsize as Double, x as Integer, y as Integer, colorvalue as color)
• text(str as string, font as string, fontsize as Double, x as Integer, y as Integer, colorvalue as Integer)

CDDrawAreaMBS.text(str as string, font as string, fontsize as Double, x as Integer, y as Integer, colorvalue 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 text method, but uses color instead of integer data type for passing color values.

See also:

• text(str as string, font as string, fontIndex as Integer, fontHeight as Double, fontWidth as Double, angle as Double, vertical as boolean) as CDTTFTextMBS
• text(str as string, font as string, fontIndex as Integer, fontHeight as Double, fontWidth as Double, angle as Double, vertical as boolean, x as Integer, y as Integer, colorvalue as color, alignment as Integer = 7)
• text(str as string, font as string, fontIndex as Integer, fontHeight as Double, fontWidth as Double, angle as Double, vertical as boolean, x as Integer, y as Integer, colorvalue as Integer, alignment as Integer = 7)
• text(str as string, font as string, fontsize as Double) as CDTTFTextMBS
• text(str as string, font as string, fontsize as Double, x as Integer, y as Integer, colorvalue as Integer)

CDDrawAreaMBS.text(str as string, font as string, fontsize as Double, x as Integer, y as Integer, colorvalue as Integer)

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

Draws text.

Argument	Default	Description
str	(Mandatory)	A string representing the text to be drawn. See ChartDirector Mark Up Language on how to embed special tags in the text for sophisticated formatting.
font	(Mandatory)	The font name. See Font Specification for details on various font attributes.
fontSize	(Mandatory)	The font size in points.
x	(Mandatory)	The x coordinate of the top-left corner of the text.
y	(Mandatory)	The y coordinate of the top-left corner of the text.
color	(Mandatory)	The color of the text.

See font specification here:
http://www.monkeybreadsoftware.net/faq-chartdirectorfontspecification.shtml

See also:

• text(str as string, font as string, fontIndex as Integer, fontHeight as Double, fontWidth as Double, angle as Double, vertical as boolean) as CDTTFTextMBS
• text(str as string, font as string, fontIndex as Integer, fontHeight as Double, fontWidth as Double, angle as Double, vertical as boolean, x as Integer, y as Integer, colorvalue as color, alignment as Integer = 7)
• text(str as string, font as string, fontIndex as Integer, fontHeight as Double, fontWidth as Double, angle as Double, vertical as boolean, x as Integer, y as Integer, colorvalue as Integer, alignment as Integer = 7)
• text(str as string, font as string, fontsize as Double) as CDTTFTextMBS
• text(str as string, font as string, fontsize as Double, x as Integer, y as Integer, colorvalue as color)

CDDrawAreaMBS.tile(d as CDDrawAreaMBS, 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 as a wallpaper.

The wallpaper image will be tiled repeatedly on the current DrawArea until the entire DrawArea is covered.

Argument	Default	Description
d	(Mandatory)	A DrawArea object representing the source.
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.vCylinderTransform(xDiameter 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

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

See also:

• vCylinderTransform(xDiameter as Integer, bgColor as Integer = &hFFFFFF, filter as Integer = 2, blur as Double = 1.0)

CDDrawAreaMBS.vCylinderTransform(xDiameter as Integer, 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

Wraps the drawing surface onto a vertical cylinder.

Argument	Default	Description
xDiameter	(Mandatory)	The diameter of the cylinder 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:

• vCylinderTransform(xDiameter as Integer, bgColor as color, filter as Integer = 2, blur as Double = 1.0)

CDDrawAreaMBS.vFlip

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

Flip the drawing surface along the central vertical line.

CDDrawAreaMBS.vline(y1 as Integer, y2 as Integer, x 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

Draws a vertical line.

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

CDDrawAreaMBS.vTriangleTransform(tHeight 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

Wraps the drawing surface onto a vertical triangle pointing upwards.

Argument	Default	Description
tHeight	-1	The height 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:

• vTriangleTransform(tHeight as Integer, bgColor as color, filter as Integer = 2, blur as Double = 1.0)

CDDrawAreaMBS.vTriangleTransform(tHeight 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

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

See also:

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

CDDrawAreaMBS.waveTransform(period as Integer, amplitude as Double, direction as Double = 0, startAngle as Double = 0, longitudinal as boolean=false, 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 pixels on the drawing surface according to a sinusoidal function to achieve a wave effect.

Argument	Default	Description
period	(Mandatory)	The period of the wave in pixels.
amplitude	(Mandatory)	The amplitude of the wave in pixels.
direction	0	The propagation direction of the wave. The upward pointing direction is 0 degree, and the angle is measured clockwise.
startAngle	0	The initial phase angle of the wave in degrees.
longitudinal	false	Determine if the wave is transversal or longitudinal. true means transversal. false means longitudinal.
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:

• waveTransform(period as Integer, amplitude as Double, direction as Double, startAngle as Double, longitudinal as boolean, bgColor as color, filter as Integer = 2, blur as Double = 1.0)

CDDrawAreaMBS.waveTransform(period as Integer, amplitude as Double, direction as Double, startAngle as Double, longitudinal as boolean, 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 waveTransform method, but uses color instead of integer data type for passing color values.

See also:

• waveTransform(period as Integer, amplitude as Double, direction as Double = 0, startAngle as Double = 0, longitudinal as boolean=false, bgColor as Integer = &hFFFFFF, filter as Integer = 2, blur as Double = 1.0)