CDLineLayerMBS.getLine(dataSet as Integer = 0) as CDLineObjMBS

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

Retrieves an opaque LineObj representing a line in the line layer. The opaque LineObj is to be used in XYChart.addInterLineLayer for adding coloring between lines.

Argument	Default	Description
dataSet	0	The data set number for the line. The first data set is 0. The nth data set is (n - 1).

Return Value
An opaque LineObj representing the requested line.

CDLineLayerMBS.setFastLineMode(b as boolean = true)

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

Enables or disables fast line mode.

In a chart, the plot area width is usually a few hundred to around 2000 pixels. For a line chart that "flows" horizontally (eg. from left to right), if there are a lot more data points (eg. 100000 data points than the plot area pixel width, many of the points would be at the same x-pixel coordinates. The line segments joining the data points at the same x-pixel coordinates would just be oscillating up and down, overlapping themselves. What is visible at each x-pixel position is essentially a line joining the minimum point and the maximum point.

In fast line mode, ChartDirector will automatically detect that there are too many points in the same x-pixel coordinate, and draws only a line segment joining the extreme points at that coordinate. The resulting line is visually indistinguishable from a line in which the line segments join all data points. The fast line mode can significantly reduce the number of points drawn without affecting the chart appearance.

The fast line mode has no effect if there are not significantly more data points than the pixel width of the plot area. For charts with evenly spaced data points, the fast line mode would only act on x-pixel positions with too many data points. Thus the fast line mode can be enabled on line charts regardless of the number of data points.

The fast line mode should not be used if the data points are not flowing horizontally (or vertically if XYChart.swapXY is in effect), but are flowing in random directions.

Argument	Default	Description
b	true	A true value enables fast line mode. A false value disables fast line mode.

Some examples using this method:

• /ChartDirector/RealTime ViewPort

CDLineLayerMBS.setGapColor(lineColor as color, lineWidth as Integer = -1)

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

See also:

• setGapColor(lineColor as Integer, lineWidth as Integer = -1)

CDLineLayerMBS.setGapColor(lineColor 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

Sets the color and style of the line used for jumping across NoValue data points.

By default, the color of the line for jumping across NoValue data points is Transparent, which means the line will become discontinuous.

Argument	Default	Description
lineColor	(Mandatory)	The line color of the line used for jumping across NoValue data points
lineWidth	-1	The line width of the line used for jumping across NoValue data points. -1 means the width will be the same as the line width of the line for drawing normal data points.

See also:

• setGapColor(lineColor as color, lineWidth as Integer = -1)

CDLineLayerMBS.setImageMapWidth(Width as Integer)

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

Sets the effective width of the line used for producing image maps.

For thin lines, it is hard to click on the lines. So for the purpose of producing image maps for a line chart, ChartDirector can assume the line is very thick. The default is 10 pixels.

Argument	Default	Description
width	(Mandatory)	The effective width of the line used for producing image maps.

CDLineLayerMBS.setSymbolScale(zDataX() as Double, scaleTypeX as Integer = 0)

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

Sets the size of the symbol for each data point (for creating bubble charts).

One common usage for this method is to draw circle symbols of different sizes at each data points, creating a bubble chart.

This method supports any valid data symbols. You can create bubble charts with square bubbles, or even custom data symbols. Also, this method supports independent x and y direction sizing, so you can create bubbles elliptical in shape, and use the horizontal and vertical radius to represent different data.

ChartDirector supports specifying sizes as pixels or in axis scale. The unit is specified by using the following predefined constants.

ConstantValueDescription

PixelScale	0	The unit is measured in pixels.
XAxisScale	1	The unit is measured in x-axis scale.
YAxisScale	2	The unit is measured in y-axis scale.

Argument	Default	Description
zDataX	(Mandatory)	The sizes of the symbols at the x-axis direction, expressed using the unit defined by the scaleTypeX argument.
scaleTypeX	PixelScale	The unit for zDataX, which must be one of the predefined constants in the table above.
zDataY	[Empty_Array]	The sizes of the symbols at the y-axis direction, expressed using the unit defined by the scaleTypeY argument. An empty array means the sizes at the y-axis direction are the means as the sizes at the x-axis direction.
scaleTypeY	PixelScale	The unit for zDataY, which must be one of the predefined constants in the table above.

See also:

• setSymbolScale(zDataX() as Double, scaleTypeX as Integer, zDataY() as Double, scaleTypeY as Integer = 0)

CDLineLayerMBS.setSymbolScale(zDataX() as Double, scaleTypeX as Integer, zDataY() as Double, scaleTypeY as Integer = 0)

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

Sets the size of the symbol for each data point (for creating bubble charts).

One common usage for this method is to draw circle symbols of different sizes at each data points, creating a bubble chart.

This method supports any valid data symbols. You can create bubble charts with square bubbles, or even custom data symbols. Also, this method supports independent x and y direction sizing, so you can create bubbles elliptical in shape, and use the horizontal and vertical radius to represent different data.

ChartDirector supports specifying sizes as pixels or in axis scale. The unit is specified by using the following predefined constants.

ConstantValueDescription

PixelScale	0	The unit is measured in pixels.
XAxisScale	1	The unit is measured in x-axis scale.
YAxisScale	2	The unit is measured in y-axis scale.

Argument	Default	Description
zDataX	(Mandatory)	The sizes of the symbols at the x-axis direction, expressed using the unit defined by the scaleTypeX argument.
scaleTypeX	PixelScale	The unit for zDataX, which must be one of the predefined constants in the table above.
zDataY	[Empty_Array]	The sizes of the symbols at the y-axis direction, expressed using the unit defined by the scaleTypeY argument. An empty array means the sizes at the y-axis direction are the means as the sizes at the x-axis direction.
scaleTypeY	PixelScale	The unit for zDataY, which must be one of the predefined constants in the table above.

See also:

• setSymbolScale(zDataX() as Double, scaleTypeX as Integer = 0)