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 |
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 |
Argument | Default | Description |
fillColor | (Mandatory) | The fill color of the meter pointer. |
edgeColor | -1 | The 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 |
Argument | Default | Description |
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 |
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.
Argument | Default | Description |
pointerCoor | (Mandatory) | An array of numbers x0, y0, x1, y1, x2, y2, ..., representing the coordinates the polygon vertices. |
lengthRatio | NoValue | The 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. |
widthRatio | NoValue | The width ratio applies to the pointer. NoValue means the widthRatio is not modified. The default is 1.0. |
See also:
- setShape(pointerCoor() as Integer, lengthRatio as Double)
- setShape(pointerCoor() as Integer, lengthRatio as Double, widthRatio as Double)
- setShape(pointerType as Integer)
- setShape(pointerType as Integer, lengthRatio as Double)
- setShape(pointerType as Integer, lengthRatio as Double, widthRatio as Double)
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 |
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.
Argument | Default | Description |
pointerCoor | (Mandatory) | An array of numbers x0, y0, x1, y1, x2, y2, ..., representing the coordinates the polygon vertices. |
lengthRatio | NoValue | The 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. |
widthRatio | NoValue | The 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 |
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.
Argument | Default | Description |
pointerCoor | (Mandatory) | An array of numbers x0, y0, x1, y1, x2, y2, ..., representing the coordinates the polygon vertices. |
lengthRatio | NoValue | The 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. |
widthRatio | NoValue | The 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 |
The built-in symbols are specified by using the following predefined constants as the pointerType argument.
ConstantValueDescription
DiamondPointer | 0 | The blue pointers in the meters above. |
TriangularPointer | 1 | The purple pointers in the meters above. |
ArrowPointer | 2 | The red pointers in the meters above. |
ArrowPointer2 | 3 | The yellow pointers in the meters above. |
LinePointer | 4 | The green pointers in the meters above. |
PencilPointer | 5 | The 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.
Argument | Default | Description |
pointerType | (Mandatory) | One of the predefined pointer shape constants to specify the pointer shape to use. |
lengthRatio | NoValue | The 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. |
widthRatio | NoValue | The width ratio applies to the pointer. NoValue means the widthRatio is not modified. The default is 1.0. |
See also:
- setShape(pointerCoor() as Integer)
- setShape(pointerCoor() as Integer, lengthRatio as Double)
- setShape(pointerCoor() as Integer, lengthRatio as Double, widthRatio as Double)
- setShape(pointerType as Integer, lengthRatio as Double)
- setShape(pointerType as Integer, lengthRatio as Double, widthRatio as Double)
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 |
The built-in symbols are specified by using the following predefined constants as the pointerType argument.
ConstantValueDescription
DiamondPointer | 0 | The blue pointers in the meters above. |
TriangularPointer | 1 | The purple pointers in the meters above. |
ArrowPointer | 2 | The red pointers in the meters above. |
ArrowPointer2 | 3 | The yellow pointers in the meters above. |
LinePointer | 4 | The green pointers in the meters above. |
PencilPointer | 5 | The 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.
Argument | Default | Description |
pointerType | (Mandatory) | One of the predefined pointer shape constants to specify the pointer shape to use. |
lengthRatio | NoValue | The 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. |
widthRatio | NoValue | The 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 |
The built-in symbols are specified by using the following predefined constants as the pointerType argument.
ConstantValueDescription
DiamondPointer | 0 | The blue pointers in the meters above. |
TriangularPointer | 1 | The purple pointers in the meters above. |
ArrowPointer | 2 | The red pointers in the meters above. |
ArrowPointer2 | 3 | The yellow pointers in the meters above. |
LinePointer | 4 | The green pointers in the meters above. |
PencilPointer | 5 | The 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.
Argument | Default | Description |
pointerType | (Mandatory) | One of the predefined pointer shape constants to specify the pointer shape to use. |
lengthRatio | NoValue | The 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. |
widthRatio | NoValue | The 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 |
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.
Argument | Default | Description |
pointerCoor | (Mandatory) | An array of numbers x0, y0, x1, y1, x2, y2, ..., representing the coordinates the polygon vertices. |
startOffset | NoValue | The position of the starting point as a ratio to the scale radius. NoValue means the position is automatically determined. |
endOffset | NoValue | The position of the ending point as a ratio to the scale radius. NoValue means the position is automatically determined. |
widthRatio | NoValue | The width of the pointer relative to the default width. NoValue means the width is automatically determined. |
See also:
- setShapeAndOffset(pointerCoor() as Integer, startOffset as Double)
- setShapeAndOffset(pointerCoor() as Integer, startOffset as Double, endOffset as Double)
- setShapeAndOffset(pointerCoor() as Integer, startOffset as Double, endOffset as Double, widthRatio as Double)
- setShapeAndOffset(pointerType as Integer)
- setShapeAndOffset(pointerType as Integer, startOffset as Double)
- setShapeAndOffset(pointerType as Integer, startOffset as Double, endOffset as Double)
- setShapeAndOffset(pointerType as Integer, startOffset as Double, endOffset as Double, widthRatio as Double)
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 |
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.
Argument | Default | Description |
pointerCoor | (Mandatory) | An array of numbers x0, y0, x1, y1, x2, y2, ..., representing the coordinates the polygon vertices. |
startOffset | NoValue | The position of the starting point as a ratio to the scale radius. NoValue means the position is automatically determined. |
endOffset | NoValue | The position of the ending point as a ratio to the scale radius. NoValue means the position is automatically determined. |
widthRatio | NoValue | The width of the pointer relative to the default width. NoValue means the width is automatically determined. |
See also:
- setShapeAndOffset(pointerCoor() as Integer)
- setShapeAndOffset(pointerCoor() as Integer, startOffset as Double, endOffset as Double)
- setShapeAndOffset(pointerCoor() as Integer, startOffset as Double, endOffset as Double, widthRatio as Double)
- setShapeAndOffset(pointerType as Integer)
- setShapeAndOffset(pointerType as Integer, startOffset as Double)
- setShapeAndOffset(pointerType as Integer, startOffset as Double, endOffset as Double)
- setShapeAndOffset(pointerType as Integer, startOffset as Double, endOffset as Double, widthRatio as Double)
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 |
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.
Argument | Default | Description |
pointerCoor | (Mandatory) | An array of numbers x0, y0, x1, y1, x2, y2, ..., representing the coordinates the polygon vertices. |
startOffset | NoValue | The position of the starting point as a ratio to the scale radius. NoValue means the position is automatically determined. |
endOffset | NoValue | The position of the ending point as a ratio to the scale radius. NoValue means the position is automatically determined. |
widthRatio | NoValue | The width of the pointer relative to the default width. NoValue means the width is automatically determined. |
See also:
- setShapeAndOffset(pointerCoor() as Integer)
- setShapeAndOffset(pointerCoor() as Integer, startOffset as Double)
- setShapeAndOffset(pointerCoor() as Integer, startOffset as Double, endOffset as Double, widthRatio as Double)
- setShapeAndOffset(pointerType as Integer)
- setShapeAndOffset(pointerType as Integer, startOffset as Double)
- setShapeAndOffset(pointerType as Integer, startOffset as Double, endOffset as Double)
- setShapeAndOffset(pointerType as Integer, startOffset as Double, endOffset as Double, widthRatio as Double)
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 |
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.
Argument | Default | Description |
pointerCoor | (Mandatory) | An array of numbers x0, y0, x1, y1, x2, y2, ..., representing the coordinates the polygon vertices. |
startOffset | NoValue | The position of the starting point as a ratio to the scale radius. NoValue means the position is automatically determined. |
endOffset | NoValue | The position of the ending point as a ratio to the scale radius. NoValue means the position is automatically determined. |
widthRatio | NoValue | The width of the pointer relative to the default width. NoValue means the width is automatically determined. |
See also:
- setShapeAndOffset(pointerCoor() as Integer)
- setShapeAndOffset(pointerCoor() as Integer, startOffset as Double)
- setShapeAndOffset(pointerCoor() as Integer, startOffset as Double, endOffset as Double)
- setShapeAndOffset(pointerType as Integer)
- setShapeAndOffset(pointerType as Integer, startOffset as Double)
- setShapeAndOffset(pointerType as Integer, startOffset as Double, endOffset as Double)
- setShapeAndOffset(pointerType as Integer, startOffset as Double, endOffset as Double, widthRatio as Double)
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 |
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.
Argument | Default | Description |
pointerType | (Mandatory) | Should be TriangularPointer2 for new style triangular pointer, and LinePointer2 for new style line pointer. |
startOffset | NoValue | The radius the pointer starts at, expressed as a ratio to the scale radius. NoValue means the radius is automatically determined. |
endOffset | NoValue | he radius the pointer ends at, expressed as a ratio to the scale radius. NoValue means the radius is automatically determined. |
widthRatio | NoValue | The width of the pointer relative to the default width. NoValue means the width is automatically determined. |
See also:
- setShapeAndOffset(pointerCoor() as Integer)
- setShapeAndOffset(pointerCoor() as Integer, startOffset as Double)
- setShapeAndOffset(pointerCoor() as Integer, startOffset as Double, endOffset as Double)
- setShapeAndOffset(pointerCoor() as Integer, startOffset as Double, endOffset as Double, widthRatio as Double)
- setShapeAndOffset(pointerType as Integer, startOffset as Double)
- setShapeAndOffset(pointerType as Integer, startOffset as Double, endOffset as Double)
- setShapeAndOffset(pointerType as Integer, startOffset as Double, endOffset as Double, widthRatio as Double)
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 |
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.
Argument | Default | Description |
pointerType | (Mandatory) | Should be TriangularPointer2 for new style triangular pointer, and LinePointer2 for new style line pointer. |
startOffset | NoValue | The radius the pointer starts at, expressed as a ratio to the scale radius. NoValue means the radius is automatically determined. |
endOffset | NoValue | he radius the pointer ends at, expressed as a ratio to the scale radius. NoValue means the radius is automatically determined. |
widthRatio | NoValue | The width of the pointer relative to the default width. NoValue means the width is automatically determined. |
See also:
- setShapeAndOffset(pointerCoor() as Integer)
- setShapeAndOffset(pointerCoor() as Integer, startOffset as Double)
- setShapeAndOffset(pointerCoor() as Integer, startOffset as Double, endOffset as Double)
- setShapeAndOffset(pointerCoor() as Integer, startOffset as Double, endOffset as Double, widthRatio as Double)
- setShapeAndOffset(pointerType as Integer)
- setShapeAndOffset(pointerType as Integer, startOffset as Double, endOffset as Double)
- setShapeAndOffset(pointerType as Integer, startOffset as Double, endOffset as Double, widthRatio as Double)
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 |
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.
Argument | Default | Description |
pointerType | (Mandatory) | Should be TriangularPointer2 for new style triangular pointer, and LinePointer2 for new style line pointer. |
startOffset | NoValue | The radius the pointer starts at, expressed as a ratio to the scale radius. NoValue means the radius is automatically determined. |
endOffset | NoValue | he radius the pointer ends at, expressed as a ratio to the scale radius. NoValue means the radius is automatically determined. |
widthRatio | NoValue | The width of the pointer relative to the default width. NoValue means the width is automatically determined. |
See also:
- setShapeAndOffset(pointerCoor() as Integer)
- setShapeAndOffset(pointerCoor() as Integer, startOffset as Double)
- setShapeAndOffset(pointerCoor() as Integer, startOffset as Double, endOffset as Double)
- setShapeAndOffset(pointerCoor() as Integer, startOffset as Double, endOffset as Double, widthRatio as Double)
- setShapeAndOffset(pointerType as Integer)
- setShapeAndOffset(pointerType as Integer, startOffset as Double)
- setShapeAndOffset(pointerType as Integer, startOffset as Double, endOffset as Double, widthRatio as Double)
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 |
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.
Argument | Default | Description |
pointerType | (Mandatory) | Should be TriangularPointer2 for new style triangular pointer, and LinePointer2 for new style line pointer. |
startOffset | NoValue | The radius the pointer starts at, expressed as a ratio to the scale radius. NoValue means the radius is automatically determined. |
endOffset | NoValue | he radius the pointer ends at, expressed as a ratio to the scale radius. NoValue means the radius is automatically determined. |
widthRatio | NoValue | The width of the pointer relative to the default width. NoValue means the width is automatically determined. |
See also:
- setShapeAndOffset(pointerCoor() as Integer)
- setShapeAndOffset(pointerCoor() as Integer, startOffset as Double)
- setShapeAndOffset(pointerCoor() as Integer, startOffset as Double, endOffset as Double)
- setShapeAndOffset(pointerCoor() as Integer, startOffset as Double, endOffset as Double, widthRatio as Double)
- setShapeAndOffset(pointerType as Integer)
- setShapeAndOffset(pointerType as Integer, startOffset as Double)
- setShapeAndOffset(pointerType as Integer, startOffset as Double, endOffset as Double)
The items on this page are in the following plugins: MBS ChartDirector Plugin.