Platforms to show: All Mac Windows Linux Cross-Platform

Back to CDMeterPointerMBS class.

CDMeterPointerMBS.setColor(fillColor as color, edgeColor 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 setColor method, but uses color instead of integer data type for passing color values.

See also:

CDMeterPointerMBS.setColor(fillColor as Integer, edgeColor 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 fill and border colors of the meter pointer.

ArgumentDefaultDescription
fillColor(Mandatory)The fill color of the meter pointer.
edgeColor-1The border color of the meter pointer. The default value of -1 means it is the same as the fill color.

See also:

CDMeterPointerMBS.setPos(value as Double)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 8.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Sets the value the pointer points to on the meter scale.

ArgumentDefaultDescription
value(Mandatory)The value the pointer points to.

CDMeterPointerMBS.setShape(pointerCoor() 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 shape of the meter pointer to a custom polygon.

The custom polygon is specified as a list of numbers representing the (x, y) coordinates of polygon vertices.

For an angular meter, the polygon should be defined with a nominal dimension of 1000 units. ChartDirector will scale the polygon so that 1000 units will become the radius of the meter.

For a linear meter, the length of the pointer should be defined with a nominal dimension of 1000 units. ChartDirector will scale the polygon so that 1000 units will be the length required for the pointer to reach the meter scale. The width of the pointer will be in 0.1 pixel units (that is, 10 units = 1 pixel).

The coordinate system for defining the polygon is that the x-axis points from left to right, and the y-axis points from bottom to top. The polygon will be defined as a pointer with the pivot at the origin, pointing to the upward direction.

As an example, the coordinates of the standard diamond pointer for an angular meter are:

0, -100, -50, -50, 0, 1000, 50, -50
The coordinates for the standard pencil pointer for a linear meter are:

-30, 0, 30, 0, 30, 768, 0, 1000, -30, 768
After scaling the pointers based on the nominal units, ChartDirector will in addition applies the lengthRatio and widthRatio scaling factor to the pointer. These ratios allow you to change the pointer sizes without changing the polygon definition. For example, if you want the meter pointer to be only 80% of the radius in the angular meter, you can set the lengthRatio to 0.80.
ArgumentDefaultDescription
pointerCoor(Mandatory)An array of numbers x0, y0, x1, y1, x2, y2, ..., representing the coordinates the polygon vertices.
lengthRatioNoValueThe length ratio applies to the pointer. NoValue means the lengthRatio is not modified. The default is 1.0 for angular meters and 0.75 for linear meters.
widthRatioNoValueThe width ratio applies to the pointer. NoValue means the widthRatio is not modified. The default is 1.0.

See also:

Some examples using this method:

CDMeterPointerMBS.setShape(pointerCoor() as Integer, lengthRatio as Double)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 8.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Sets the shape of the meter pointer to a custom polygon.

The custom polygon is specified as a list of numbers representing the (x, y) coordinates of polygon vertices.

For an angular meter, the polygon should be defined with a nominal dimension of 1000 units. ChartDirector will scale the polygon so that 1000 units will become the radius of the meter.

For a linear meter, the length of the pointer should be defined with a nominal dimension of 1000 units. ChartDirector will scale the polygon so that 1000 units will be the length required for the pointer to reach the meter scale. The width of the pointer will be in 0.1 pixel units (that is, 10 units = 1 pixel).

The coordinate system for defining the polygon is that the x-axis points from left to right, and the y-axis points from bottom to top. The polygon will be defined as a pointer with the pivot at the origin, pointing to the upward direction.

As an example, the coordinates of the standard diamond pointer for an angular meter are:

0, -100, -50, -50, 0, 1000, 50, -50
The coordinates for the standard pencil pointer for a linear meter are:

-30, 0, 30, 0, 30, 768, 0, 1000, -30, 768
After scaling the pointers based on the nominal units, ChartDirector will in addition applies the lengthRatio and widthRatio scaling factor to the pointer. These ratios allow you to change the pointer sizes without changing the polygon definition. For example, if you want the meter pointer to be only 80% of the radius in the angular meter, you can set the lengthRatio to 0.80.
ArgumentDefaultDescription
pointerCoor(Mandatory)An array of numbers x0, y0, x1, y1, x2, y2, ..., representing the coordinates the polygon vertices.
lengthRatioNoValueThe length ratio applies to the pointer. NoValue means the lengthRatio is not modified. The default is 1.0 for angular meters and 0.75 for linear meters.
widthRatioNoValueThe width ratio applies to the pointer. NoValue means the widthRatio is not modified. The default is 1.0.

See also:

CDMeterPointerMBS.setShape(pointerCoor() as Integer, lengthRatio as Double, widthRatio as Double)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 8.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Sets the shape of the meter pointer to a custom polygon.

The custom polygon is specified as a list of numbers representing the (x, y) coordinates of polygon vertices.

For an angular meter, the polygon should be defined with a nominal dimension of 1000 units. ChartDirector will scale the polygon so that 1000 units will become the radius of the meter.

For a linear meter, the length of the pointer should be defined with a nominal dimension of 1000 units. ChartDirector will scale the polygon so that 1000 units will be the length required for the pointer to reach the meter scale. The width of the pointer will be in 0.1 pixel units (that is, 10 units = 1 pixel).

The coordinate system for defining the polygon is that the x-axis points from left to right, and the y-axis points from bottom to top. The polygon will be defined as a pointer with the pivot at the origin, pointing to the upward direction.

As an example, the coordinates of the standard diamond pointer for an angular meter are:

0, -100, -50, -50, 0, 1000, 50, -50
The coordinates for the standard pencil pointer for a linear meter are:

-30, 0, 30, 0, 30, 768, 0, 1000, -30, 768
After scaling the pointers based on the nominal units, ChartDirector will in addition applies the lengthRatio and widthRatio scaling factor to the pointer. These ratios allow you to change the pointer sizes without changing the polygon definition. For example, if you want the meter pointer to be only 80% of the radius in the angular meter, you can set the lengthRatio to 0.80.
ArgumentDefaultDescription
pointerCoor(Mandatory)An array of numbers x0, y0, x1, y1, x2, y2, ..., representing the coordinates the polygon vertices.
lengthRatioNoValueThe length ratio applies to the pointer. NoValue means the lengthRatio is not modified. The default is 1.0 for angular meters and 0.75 for linear meters.
widthRatioNoValueThe width ratio applies to the pointer. NoValue means the widthRatio is not modified. The default is 1.0.

See also:

CDMeterPointerMBS.setShape(pointerType 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 shape of the meter pointer to one of the built-in shapes.

The built-in symbols are specified by using the following predefined constants as the pointerType argument.

ConstantValueDescription
DiamondPointer0The blue pointers in the meters above.
TriangularPointer1The purple pointers in the meters above.
ArrowPointer2The red pointers in the meters above.
ArrowPointer23The yellow pointers in the meters above.
LinePointer4The green pointers in the meters above.
PencilPointer5The grey pointers in the meters above.

The length and width of the pointer can be scaled by using the lengthRatio and widthRatio arguments. The meters above are using default length and width ratios, which are both 1 for angular meters, and 0.75 and 1 for linear meters.
ArgumentDefaultDescription
pointerType(Mandatory)One of the predefined pointer shape constants to specify the pointer shape to use.
lengthRatioNoValueThe length ratio applies to the pointer. NoValue means the lengthRatio is not modified. The default is 1.0 for angular meters and 0.75 for linear meters.
widthRatioNoValueThe width ratio applies to the pointer. NoValue means the widthRatio is not modified. The default is 1.0.

See also:

CDMeterPointerMBS.setShape(pointerType as Integer, lengthRatio as Double)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 8.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Sets the shape of the meter pointer to one of the built-in shapes.

The built-in symbols are specified by using the following predefined constants as the pointerType argument.

ConstantValueDescription
DiamondPointer0The blue pointers in the meters above.
TriangularPointer1The purple pointers in the meters above.
ArrowPointer2The red pointers in the meters above.
ArrowPointer23The yellow pointers in the meters above.
LinePointer4The green pointers in the meters above.
PencilPointer5The grey pointers in the meters above.

The length and width of the pointer can be scaled by using the lengthRatio and widthRatio arguments. The meters above are using default length and width ratios, which are both 1 for angular meters, and 0.75 and 1 for linear meters.
ArgumentDefaultDescription
pointerType(Mandatory)One of the predefined pointer shape constants to specify the pointer shape to use.
lengthRatioNoValueThe length ratio applies to the pointer. NoValue means the lengthRatio is not modified. The default is 1.0 for angular meters and 0.75 for linear meters.
widthRatioNoValueThe width ratio applies to the pointer. NoValue means the widthRatio is not modified. The default is 1.0.

See also:

CDMeterPointerMBS.setShape(pointerType as Integer, lengthRatio as Double, widthRatio as Double)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 8.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Sets the shape of the meter pointer to one of the built-in shapes.

The built-in symbols are specified by using the following predefined constants as the pointerType argument.

ConstantValueDescription
DiamondPointer0The blue pointers in the meters above.
TriangularPointer1The purple pointers in the meters above.
ArrowPointer2The red pointers in the meters above.
ArrowPointer23The yellow pointers in the meters above.
LinePointer4The green pointers in the meters above.
PencilPointer5The grey pointers in the meters above.

The length and width of the pointer can be scaled by using the lengthRatio and widthRatio arguments. The meters above are using default length and width ratios, which are both 1 for angular meters, and 0.75 and 1 for linear meters.
ArgumentDefaultDescription
pointerType(Mandatory)One of the predefined pointer shape constants to specify the pointer shape to use.
lengthRatioNoValueThe length ratio applies to the pointer. NoValue means the lengthRatio is not modified. The default is 1.0 for angular meters and 0.75 for linear meters.
widthRatioNoValueThe width ratio applies to the pointer. NoValue means the widthRatio is not modified. The default is 1.0.

See also:

CDMeterPointerMBS.setShapeAndOffset(pointerCoor() as Integer)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 15.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Sets the shape of new style angular meter pointers to a custom polygon.

The custom polygon is specified as a list of numbers representing the (x, y) coordinates of the polygon vertices, with the x-axis pointing from left to right and the y-axis pointing from bottom to top. The direction of the pointer should be pointing upwards, with the starting point at y = 0, and the ending point at y = 1000.

As an example, the coordinates of the new style triangular pointer are:

-15, 0, 15, 0, 0, 1000, 1000

The coordinates for the new style line pointer are:

-5, 0, 5, 0, 5, 1000, -5, 1000

In actual usage, ChartDirector will rotate the polygon to point it to the desired value, and adjust the polygon size and position based on the startOffset, endOffset and widthRatio arguments. Please refer to MeterPointer.setShapeAndOffset2 for the meaning of these arguments.

ArgumentDefaultDescription
pointerCoor(Mandatory)An array of numbers x0, y0, x1, y1, x2, y2, ..., representing the coordinates the polygon vertices.
startOffsetNoValueThe position of the starting point as a ratio to the scale radius. NoValue means the position is automatically determined.
endOffsetNoValueThe position of the ending point as a ratio to the scale radius. NoValue means the position is automatically determined.
widthRatioNoValueThe width of the pointer relative to the default width. NoValue means the width is automatically determined.

See also:

CDMeterPointerMBS.setShapeAndOffset(pointerCoor() as Integer, startOffset as Double)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 15.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Sets the shape of new style angular meter pointers to a custom polygon.

The custom polygon is specified as a list of numbers representing the (x, y) coordinates of the polygon vertices, with the x-axis pointing from left to right and the y-axis pointing from bottom to top. The direction of the pointer should be pointing upwards, with the starting point at y = 0, and the ending point at y = 1000.

As an example, the coordinates of the new style triangular pointer are:

-15, 0, 15, 0, 0, 1000, 1000

The coordinates for the new style line pointer are:

-5, 0, 5, 0, 5, 1000, -5, 1000

In actual usage, ChartDirector will rotate the polygon to point it to the desired value, and adjust the polygon size and position based on the startOffset, endOffset and widthRatio arguments. Please refer to MeterPointer.setShapeAndOffset2 for the meaning of these arguments.

ArgumentDefaultDescription
pointerCoor(Mandatory)An array of numbers x0, y0, x1, y1, x2, y2, ..., representing the coordinates the polygon vertices.
startOffsetNoValueThe position of the starting point as a ratio to the scale radius. NoValue means the position is automatically determined.
endOffsetNoValueThe position of the ending point as a ratio to the scale radius. NoValue means the position is automatically determined.
widthRatioNoValueThe width of the pointer relative to the default width. NoValue means the width is automatically determined.

See also:

CDMeterPointerMBS.setShapeAndOffset(pointerCoor() as Integer, startOffset as Double, endOffset as Double)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 15.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Sets the shape of new style angular meter pointers to a custom polygon.

The custom polygon is specified as a list of numbers representing the (x, y) coordinates of the polygon vertices, with the x-axis pointing from left to right and the y-axis pointing from bottom to top. The direction of the pointer should be pointing upwards, with the starting point at y = 0, and the ending point at y = 1000.

As an example, the coordinates of the new style triangular pointer are:

-15, 0, 15, 0, 0, 1000, 1000

The coordinates for the new style line pointer are:

-5, 0, 5, 0, 5, 1000, -5, 1000

In actual usage, ChartDirector will rotate the polygon to point it to the desired value, and adjust the polygon size and position based on the startOffset, endOffset and widthRatio arguments. Please refer to MeterPointer.setShapeAndOffset2 for the meaning of these arguments.

ArgumentDefaultDescription
pointerCoor(Mandatory)An array of numbers x0, y0, x1, y1, x2, y2, ..., representing the coordinates the polygon vertices.
startOffsetNoValueThe position of the starting point as a ratio to the scale radius. NoValue means the position is automatically determined.
endOffsetNoValueThe position of the ending point as a ratio to the scale radius. NoValue means the position is automatically determined.
widthRatioNoValueThe width of the pointer relative to the default width. NoValue means the width is automatically determined.

See also:

CDMeterPointerMBS.setShapeAndOffset(pointerCoor() as Integer, startOffset as Double, endOffset as Double, widthRatio as Double)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 15.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Sets the shape of new style angular meter pointers to a custom polygon.

The custom polygon is specified as a list of numbers representing the (x, y) coordinates of the polygon vertices, with the x-axis pointing from left to right and the y-axis pointing from bottom to top. The direction of the pointer should be pointing upwards, with the starting point at y = 0, and the ending point at y = 1000.

As an example, the coordinates of the new style triangular pointer are:

-15, 0, 15, 0, 0, 1000, 1000

The coordinates for the new style line pointer are:

-5, 0, 5, 0, 5, 1000, -5, 1000

In actual usage, ChartDirector will rotate the polygon to point it to the desired value, and adjust the polygon size and position based on the startOffset, endOffset and widthRatio arguments. Please refer to MeterPointer.setShapeAndOffset2 for the meaning of these arguments.

ArgumentDefaultDescription
pointerCoor(Mandatory)An array of numbers x0, y0, x1, y1, x2, y2, ..., representing the coordinates the polygon vertices.
startOffsetNoValueThe position of the starting point as a ratio to the scale radius. NoValue means the position is automatically determined.
endOffsetNoValueThe position of the ending point as a ratio to the scale radius. NoValue means the position is automatically determined.
widthRatioNoValueThe width of the pointer relative to the default width. NoValue means the width is automatically determined.

See also:

CDMeterPointerMBS.setShapeAndOffset(pointerType as Integer)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 15.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Sets the shape of new style angular meter pointers.

New style pointers are designed to have configurable starting and ending points, as well as configurable width. In this documentation, the ending point refers to the "tip" of the pointer, while the starting point is the "base" of the pointer.

By default, the starting and ending points are at -0.15 and 0.95. It means the distance between the starting point and the center is 15% of the scale radius. The negative sign means that relative to the center, the starting point is at the opposite direction to the value the pointer is supposed to point to. Similarly, the distance between the ending point and the center is 95% of the scale radius, which means the ending point should be quite close to the outer rim of the meter scale.

ArgumentDefaultDescription
pointerType(Mandatory)Should be TriangularPointer2 for new style triangular pointer, and LinePointer2 for new style line pointer.
startOffsetNoValueThe radius the pointer starts at, expressed as a ratio to the scale radius. NoValue means the radius is automatically determined.
endOffsetNoValuehe radius the pointer ends at, expressed as a ratio to the scale radius. NoValue means the radius is automatically determined.
widthRatioNoValueThe width of the pointer relative to the default width. NoValue means the width is automatically determined.

See also:

CDMeterPointerMBS.setShapeAndOffset(pointerType as Integer, startOffset as Double)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 15.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Sets the shape of new style angular meter pointers.

New style pointers are designed to have configurable starting and ending points, as well as configurable width. In this documentation, the ending point refers to the "tip" of the pointer, while the starting point is the "base" of the pointer.

By default, the starting and ending points are at -0.15 and 0.95. It means the distance between the starting point and the center is 15% of the scale radius. The negative sign means that relative to the center, the starting point is at the opposite direction to the value the pointer is supposed to point to. Similarly, the distance between the ending point and the center is 95% of the scale radius, which means the ending point should be quite close to the outer rim of the meter scale.

ArgumentDefaultDescription
pointerType(Mandatory)Should be TriangularPointer2 for new style triangular pointer, and LinePointer2 for new style line pointer.
startOffsetNoValueThe radius the pointer starts at, expressed as a ratio to the scale radius. NoValue means the radius is automatically determined.
endOffsetNoValuehe radius the pointer ends at, expressed as a ratio to the scale radius. NoValue means the radius is automatically determined.
widthRatioNoValueThe width of the pointer relative to the default width. NoValue means the width is automatically determined.

See also:

CDMeterPointerMBS.setShapeAndOffset(pointerType as Integer, startOffset as Double, endOffset as Double)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 15.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Sets the shape of new style angular meter pointers.

New style pointers are designed to have configurable starting and ending points, as well as configurable width. In this documentation, the ending point refers to the "tip" of the pointer, while the starting point is the "base" of the pointer.

By default, the starting and ending points are at -0.15 and 0.95. It means the distance between the starting point and the center is 15% of the scale radius. The negative sign means that relative to the center, the starting point is at the opposite direction to the value the pointer is supposed to point to. Similarly, the distance between the ending point and the center is 95% of the scale radius, which means the ending point should be quite close to the outer rim of the meter scale.

ArgumentDefaultDescription
pointerType(Mandatory)Should be TriangularPointer2 for new style triangular pointer, and LinePointer2 for new style line pointer.
startOffsetNoValueThe radius the pointer starts at, expressed as a ratio to the scale radius. NoValue means the radius is automatically determined.
endOffsetNoValuehe radius the pointer ends at, expressed as a ratio to the scale radius. NoValue means the radius is automatically determined.
widthRatioNoValueThe width of the pointer relative to the default width. NoValue means the width is automatically determined.

See also:

CDMeterPointerMBS.setShapeAndOffset(pointerType as Integer, startOffset as Double, endOffset as Double, widthRatio as Double)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 15.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Sets the shape of new style angular meter pointers.

New style pointers are designed to have configurable starting and ending points, as well as configurable width. In this documentation, the ending point refers to the "tip" of the pointer, while the starting point is the "base" of the pointer.

By default, the starting and ending points are at -0.15 and 0.95. It means the distance between the starting point and the center is 15% of the scale radius. The negative sign means that relative to the center, the starting point is at the opposite direction to the value the pointer is supposed to point to. Similarly, the distance between the ending point and the center is 95% of the scale radius, which means the ending point should be quite close to the outer rim of the meter scale.

ArgumentDefaultDescription
pointerType(Mandatory)Should be TriangularPointer2 for new style triangular pointer, and LinePointer2 for new style line pointer.
startOffsetNoValueThe radius the pointer starts at, expressed as a ratio to the scale radius. NoValue means the radius is automatically determined.
endOffsetNoValuehe radius the pointer ends at, expressed as a ratio to the scale radius. NoValue means the radius is automatically determined.
widthRatioNoValueThe width of the pointer relative to the default width. NoValue means the width is automatically determined.

See also:

The items on this page are in the following plugins: MBS ChartDirector Plugin.


The biggest plugin in space...