Platforms to show: All Mac Windows Linux Cross-Platform

Back to CDAngularMeterMBS class.

CDAngularMeterMBS.addGlare

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 15.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Adds glare effect to the meter.

The glare effect is created by brightening part of the meter face.
The face is divided by an arc, of which one part is brightened. The glare effect works best for meters with dark background.
All parameters are optional.

ArgumentDefaultDescription
radiusNoValueThe radius of the face of the meter. The default is the meter scale radius as set by AngularMeter.setMeter.
span135The angular span of the arc that divides the face into two parts. The dividing arc intersects with the face border at two points. The angular span is defined as center angle of these two points (that is, the angle subtended at the meter center by these two points).
rotate0By default, the glare will be symmetrically with respect to the vertical axis. This argument can be used to rotate the glare clockwise in degrees.
glareRadiusNoValueThe radius of the arc that divides the face into two parts. A positive value means the arc will result in a convex glare, while a negative means concave glare. The default is equal to 1.5 times of the face radius.
intensity0.13The intensity of the glare, which must be from 0 to 1. A value of 0 means no glare, while a value of 1 means the glare will be 100% white.

See also:

CDAngularMeterMBS.addGlare(radius as Double, span as Double = 135, rotate as Double = 0.0)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 15.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Adds glare effect to the meter.

The glare effect is created by brightening part of the meter face.
The face is divided by an arc, of which one part is brightened. The glare effect works best for meters with dark background.
All parameters are optional.

ArgumentDefaultDescription
radiusNoValueThe radius of the face of the meter. The default is the meter scale radius as set by AngularMeter.setMeter.
span135The angular span of the arc that divides the face into two parts. The dividing arc intersects with the face border at two points. The angular span is defined as center angle of these two points (that is, the angle subtended at the meter center by these two points).
rotate0By default, the glare will be symmetrically with respect to the vertical axis. This argument can be used to rotate the glare clockwise in degrees.
glareRadiusNoValueThe radius of the arc that divides the face into two parts. A positive value means the arc will result in a convex glare, while a negative means concave glare. The default is equal to 1.5 times of the face radius.
intensity0.13The intensity of the glare, which must be from 0 to 1. A value of 0 means no glare, while a value of 1 means the glare will be 100% white.

See also:

CDAngularMeterMBS.addGlare(radius as Double, span as Double, rotate as Double, glareRadius as Double, intensity as Double = 0.13)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 15.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Adds glare effect to the meter.

The glare effect is created by brightening part of the meter face.
The face is divided by an arc, of which one part is brightened. The glare effect works best for meters with dark background.
All parameters are optional.

ArgumentDefaultDescription
radiusNoValueThe radius of the face of the meter. The default is the meter scale radius as set by AngularMeter.setMeter.
span135The angular span of the arc that divides the face into two parts. The dividing arc intersects with the face border at two points. The angular span is defined as center angle of these two points (that is, the angle subtended at the meter center by these two points).
rotate0By default, the glare will be symmetrically with respect to the vertical axis. This argument can be used to rotate the glare clockwise in degrees.
glareRadiusNoValueThe radius of the arc that divides the face into two parts. A positive value means the arc will result in a convex glare, while a negative means concave glare. The default is equal to 1.5 times of the face radius.
intensity0.13The intensity of the glare, which must be from 0 to 1. A value of 0 means no glare, while a value of 1 means the glare will be 100% white.

See also:

CDAngularMeterMBS.addPointer(value as Double, fillColor as color, edgeColor as color = &cFFFFFFFF, pointerType as Integer = 6) as CDMeterPointerMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 15.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Adds a new style pointer to the meter.

When compared to classical pointers (added by CDBaseMeterMBS.addPointer), new style pointers are thinner. They are designed to be used with the new style meter cap (see CDAngularMeterMBS.setCap2). They are also designed to have their base and tip movable in the radial direction, which means they can be detached from the center, and can even points from the outside inwards.
Parameters are optional and colors can be passed as Integer or color values.

ArgumentDefaultDescription
value(Mandatory)The value that the pointer points to.
fillColor(Mandatory)The fill color of the pointer.
edgeColor-1The edge color of the pointer. -1 means the edge color is the same as the fill color.
pointerTypeTriangularPointer2The pointer shape. Please refer to MeterPointer.setShapeAndOffset for the available shapes.
startOffsetNoValueThe distance between the starting point of the pointer with the meter center, expressed as a ratio to the scale radius. NoValue means the radius is automatically determined. Please refer to MeterPointer.setShapeAndOffset for more information about this argument.
endOffsetNoValueThe distance between the ending point of the pointer with the meter center, expressed as a ratio to the scale radius. NoValue means the radius is automatically determined. Please refer to MeterPointer.setShapeAndOffset for more information about this argument.
widthRatioNoValueThe width of the pointer relative to the default width. NoValue means the width is automatically determined.

Return a MeterPointer object representing the pointer. You may use this object to fine-tune the appearance of the pointer.

See also:

CDAngularMeterMBS.addPointer(value as Double, fillColor as color, edgeColor as color, pointerType as Integer, startOffset as Double) as CDMeterPointerMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 15.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Adds a new style pointer to the meter.

When compared to classical pointers (added by CDBaseMeterMBS.addPointer), new style pointers are thinner. They are designed to be used with the new style meter cap (see CDAngularMeterMBS.setCap2). They are also designed to have their base and tip movable in the radial direction, which means they can be detached from the center, and can even points from the outside inwards.
Parameters are optional and colors can be passed as Integer or color values.

ArgumentDefaultDescription
value(Mandatory)The value that the pointer points to.
fillColor(Mandatory)The fill color of the pointer.
edgeColor-1The edge color of the pointer. -1 means the edge color is the same as the fill color.
pointerTypeTriangularPointer2The pointer shape. Please refer to MeterPointer.setShapeAndOffset for the available shapes.
startOffsetNoValueThe distance between the starting point of the pointer with the meter center, expressed as a ratio to the scale radius. NoValue means the radius is automatically determined. Please refer to MeterPointer.setShapeAndOffset for more information about this argument.
endOffsetNoValueThe distance between the ending point of the pointer with the meter center, expressed as a ratio to the scale radius. NoValue means the radius is automatically determined. Please refer to MeterPointer.setShapeAndOffset for more information about this argument.
widthRatioNoValueThe width of the pointer relative to the default width. NoValue means the width is automatically determined.

Return a MeterPointer object representing the pointer. You may use this object to fine-tune the appearance of the pointer.

See also:

CDAngularMeterMBS.addPointer(value as Double, fillColor as color, edgeColor as color, pointerType as Integer, startOffset as Double, endOffset as Double) as CDMeterPointerMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 15.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Adds a new style pointer to the meter.

When compared to classical pointers (added by CDBaseMeterMBS.addPointer), new style pointers are thinner. They are designed to be used with the new style meter cap (see CDAngularMeterMBS.setCap2). They are also designed to have their base and tip movable in the radial direction, which means they can be detached from the center, and can even points from the outside inwards.
Parameters are optional and colors can be passed as Integer or color values.

ArgumentDefaultDescription
value(Mandatory)The value that the pointer points to.
fillColor(Mandatory)The fill color of the pointer.
edgeColor-1The edge color of the pointer. -1 means the edge color is the same as the fill color.
pointerTypeTriangularPointer2The pointer shape. Please refer to MeterPointer.setShapeAndOffset for the available shapes.
startOffsetNoValueThe distance between the starting point of the pointer with the meter center, expressed as a ratio to the scale radius. NoValue means the radius is automatically determined. Please refer to MeterPointer.setShapeAndOffset for more information about this argument.
endOffsetNoValueThe distance between the ending point of the pointer with the meter center, expressed as a ratio to the scale radius. NoValue means the radius is automatically determined. Please refer to MeterPointer.setShapeAndOffset for more information about this argument.
widthRatioNoValueThe width of the pointer relative to the default width. NoValue means the width is automatically determined.

Return a MeterPointer object representing the pointer. You may use this object to fine-tune the appearance of the pointer.

See also:

CDAngularMeterMBS.addPointer(value as Double, fillColor as color, edgeColor as color, pointerType as Integer, startOffset as Double, endOffset as Double, widthRatio as Double) as CDMeterPointerMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 15.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Adds a new style pointer to the meter.

When compared to classical pointers (added by CDBaseMeterMBS.addPointer), new style pointers are thinner. They are designed to be used with the new style meter cap (see CDAngularMeterMBS.setCap2). They are also designed to have their base and tip movable in the radial direction, which means they can be detached from the center, and can even points from the outside inwards.
Parameters are optional and colors can be passed as Integer or color values.

ArgumentDefaultDescription
value(Mandatory)The value that the pointer points to.
fillColor(Mandatory)The fill color of the pointer.
edgeColor-1The edge color of the pointer. -1 means the edge color is the same as the fill color.
pointerTypeTriangularPointer2The pointer shape. Please refer to MeterPointer.setShapeAndOffset for the available shapes.
startOffsetNoValueThe distance between the starting point of the pointer with the meter center, expressed as a ratio to the scale radius. NoValue means the radius is automatically determined. Please refer to MeterPointer.setShapeAndOffset for more information about this argument.
endOffsetNoValueThe distance between the ending point of the pointer with the meter center, expressed as a ratio to the scale radius. NoValue means the radius is automatically determined. Please refer to MeterPointer.setShapeAndOffset for more information about this argument.
widthRatioNoValueThe width of the pointer relative to the default width. NoValue means the width is automatically determined.

Return a MeterPointer object representing the pointer. You may use this object to fine-tune the appearance of the pointer.

See also:

CDAngularMeterMBS.addPointer(value as Double, fillColor as Integer, edgeColor as Integer = -1, pointerType as Integer = 6) as CDMeterPointerMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 15.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Adds a new style pointer to the meter.

When compared to classical pointers (added by CDBaseMeterMBS.addPointer), new style pointers are thinner. They are designed to be used with the new style meter cap (see CDAngularMeterMBS.setCap2). They are also designed to have their base and tip movable in the radial direction, which means they can be detached from the center, and can even points from the outside inwards.
Parameters are optional and colors can be passed as Integer or color values.

ArgumentDefaultDescription
value(Mandatory)The value that the pointer points to.
fillColor(Mandatory)The fill color of the pointer.
edgeColor-1The edge color of the pointer. -1 means the edge color is the same as the fill color.
pointerTypeTriangularPointer2The pointer shape. Please refer to MeterPointer.setShapeAndOffset for the available shapes.
startOffsetNoValueThe distance between the starting point of the pointer with the meter center, expressed as a ratio to the scale radius. NoValue means the radius is automatically determined. Please refer to MeterPointer.setShapeAndOffset for more information about this argument.
endOffsetNoValueThe distance between the ending point of the pointer with the meter center, expressed as a ratio to the scale radius. NoValue means the radius is automatically determined. Please refer to MeterPointer.setShapeAndOffset for more information about this argument.
widthRatioNoValueThe width of the pointer relative to the default width. NoValue means the width is automatically determined.

Return a MeterPointer object representing the pointer. You may use this object to fine-tune the appearance of the pointer.

See also:

CDAngularMeterMBS.addPointer(value as Double, fillColor as Integer, edgeColor as Integer, pointerType as Integer, startOffset as Double) as CDMeterPointerMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 15.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Adds a new style pointer to the meter.

When compared to classical pointers (added by CDBaseMeterMBS.addPointer), new style pointers are thinner. They are designed to be used with the new style meter cap (see CDAngularMeterMBS.setCap2). They are also designed to have their base and tip movable in the radial direction, which means they can be detached from the center, and can even points from the outside inwards.
Parameters are optional and colors can be passed as Integer or color values.

ArgumentDefaultDescription
value(Mandatory)The value that the pointer points to.
fillColor(Mandatory)The fill color of the pointer.
edgeColor-1The edge color of the pointer. -1 means the edge color is the same as the fill color.
pointerTypeTriangularPointer2The pointer shape. Please refer to MeterPointer.setShapeAndOffset for the available shapes.
startOffsetNoValueThe distance between the starting point of the pointer with the meter center, expressed as a ratio to the scale radius. NoValue means the radius is automatically determined. Please refer to MeterPointer.setShapeAndOffset for more information about this argument.
endOffsetNoValueThe distance between the ending point of the pointer with the meter center, expressed as a ratio to the scale radius. NoValue means the radius is automatically determined. Please refer to MeterPointer.setShapeAndOffset for more information about this argument.
widthRatioNoValueThe width of the pointer relative to the default width. NoValue means the width is automatically determined.

Return a MeterPointer object representing the pointer. You may use this object to fine-tune the appearance of the pointer.

See also:

CDAngularMeterMBS.addPointer(value as Double, fillColor as Integer, edgeColor as Integer, pointerType as Integer, startOffset as Double, endOffset as Double) as CDMeterPointerMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 15.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Adds a new style pointer to the meter.

When compared to classical pointers (added by CDBaseMeterMBS.addPointer), new style pointers are thinner. They are designed to be used with the new style meter cap (see CDAngularMeterMBS.setCap2). They are also designed to have their base and tip movable in the radial direction, which means they can be detached from the center, and can even points from the outside inwards.
Parameters are optional and colors can be passed as Integer or color values.

ArgumentDefaultDescription
value(Mandatory)The value that the pointer points to.
fillColor(Mandatory)The fill color of the pointer.
edgeColor-1The edge color of the pointer. -1 means the edge color is the same as the fill color.
pointerTypeTriangularPointer2The pointer shape. Please refer to MeterPointer.setShapeAndOffset for the available shapes.
startOffsetNoValueThe distance between the starting point of the pointer with the meter center, expressed as a ratio to the scale radius. NoValue means the radius is automatically determined. Please refer to MeterPointer.setShapeAndOffset for more information about this argument.
endOffsetNoValueThe distance between the ending point of the pointer with the meter center, expressed as a ratio to the scale radius. NoValue means the radius is automatically determined. Please refer to MeterPointer.setShapeAndOffset for more information about this argument.
widthRatioNoValueThe width of the pointer relative to the default width. NoValue means the width is automatically determined.

Return a MeterPointer object representing the pointer. You may use this object to fine-tune the appearance of the pointer.

See also:

CDAngularMeterMBS.addPointer(value as Double, fillColor as Integer, edgeColor as Integer, pointerType as Integer, startOffset as Double, endOffset as Double, widthRatio as Double) as CDMeterPointerMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 15.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Adds a new style pointer to the meter.

When compared to classical pointers (added by CDBaseMeterMBS.addPointer), new style pointers are thinner. They are designed to be used with the new style meter cap (see CDAngularMeterMBS.setCap2). They are also designed to have their base and tip movable in the radial direction, which means they can be detached from the center, and can even points from the outside inwards.
Parameters are optional and colors can be passed as Integer or color values.

ArgumentDefaultDescription
value(Mandatory)The value that the pointer points to.
fillColor(Mandatory)The fill color of the pointer.
edgeColor-1The edge color of the pointer. -1 means the edge color is the same as the fill color.
pointerTypeTriangularPointer2The pointer shape. Please refer to MeterPointer.setShapeAndOffset for the available shapes.
startOffsetNoValueThe distance between the starting point of the pointer with the meter center, expressed as a ratio to the scale radius. NoValue means the radius is automatically determined. Please refer to MeterPointer.setShapeAndOffset for more information about this argument.
endOffsetNoValueThe distance between the ending point of the pointer with the meter center, expressed as a ratio to the scale radius. NoValue means the radius is automatically determined. Please refer to MeterPointer.setShapeAndOffset for more information about this argument.
widthRatioNoValueThe width of the pointer relative to the default width. NoValue means the width is automatically determined.

Return a MeterPointer object representing the pointer. You may use this object to fine-tune the appearance of the pointer.

See also:

CDAngularMeterMBS.addRing(startRadius as Integer, endRadius as Integer, 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 addRing method, but uses color instead of integer data type for passing color values.

See also:

Some examples using this method:

CDAngularMeterMBS.addRing(startRadius as Integer, endRadius as Integer, 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
Adds a circular ring or a circle to the meter.

A ring is the region between two concentric circles. This method is most often used for adding circular borders and backgrounds for the meter, and for some other decorative purposes. For example, one can add a circle with a metallic background color as the 'face' of the meter meter using this method.

ParameterDefaultDescription
startRadius(Mandatory)The starting radius of the ring in pixels. To add a circle, set the start radius to 0.
endRadius(Mandatory)The ending radius of the ring in pixels.
fillColor(Mandatory)The fill color of the ring.
edgeColor-1The edge color of the ring. The default is the same as the fill color.

See also:

CDAngularMeterMBS.addRingSector(startRadius as Integer, endRadius as Integer, a1 as Double, a2 as Double, 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 addRingSector method, but uses color instead of integer data type for passing color values.

See also:

Some examples using this method:

CDAngularMeterMBS.addRingSector(startRadius as Integer, endRadius as Integer, a1 as Double, a2 as Double, 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
Adds a ring sector or a sector to the meter.

This method is similar to the AngularMeter.addRing method, except that the ring it adds does not span the complete circle, but just part of the circle.

ParameterDefaultDescription
startRadius(Mandatory)The starting radius of the ring sector in pixels. To add a sector, set the starting radius to 0.
endRadius(Mandatory)The ending radius of the ring sector in pixels.
a1(Mandatory)The starting angle of the ring sector in degrees. The angle is measured in degrees clockwise, with 0 being the upward pointing direction.
a2(Mandatory)The ending angle of the ring sector in degrees. The angle is measured in degrees clockwise, with 0 being the upward pointing direction.
fillColor(Mandatory)The fill color of the ring sector.
edgeColor-1The edge color of the ring sector. The default is the same as the fill color.

See also:

CDAngularMeterMBS.addScaleBackground(bgRadius as Integer, fillColor as color, edgeWidth as Integer = 0, edgeColor as color = &cFFFFFFFF, scaleRadius as Integer = -2147483647)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 15.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Adds a background to the meter scale.

The scale background is a circle segment (a circle with a part cut-off by a chord). Its radius is usually configured as larger than that of the meter scale. In this case, its angular span will also be larger than that of the meter scale. In the above sample, the meter scale spans 180 degrees. The scale background spans more than 180 degrees so that it can maintain a margin at the bottom side (the chord side).
Most arguments are optional and colors can be passed as Integer or color value.

ArgumentDefaultDescription
bgRadius(Mandatory)The radius of the circle segment to be used as the scale background.
fillColor(Mandatory)The fill color of the circle segment (the background color).
edgeWidth0The edge width of the circle segment. A positive width means the edge is internal to the circle segment. A negative width means the edge is external to the circle segment.
edgeColor-1The edge color. The default value of -1 means the edge color is the same as the fill color.
scaleRadius-0x7fffffffThe radius of the meter scale. ChartDirector uses this value to compute the extra angular span the circle segment must have in order to maintain proper margin at the chord side. This argument is usually not necessary as ChartDirector already know the scale radius from the meter configuration. This argument can be used if you would like to use a "fake" scale radius to draw the scale background for special effects.
startAngleNoValueThe start angle of the meter scale. ChartDirector uses this value to compute start angle of the circle segment. This argument is usually not necessary as ChartDirector already know the start angle from the meter configuration. This argument can be used if you would like to use a "fake" angle to draw the scale background for special effects.
endAngleNoValueThe end angle of the meter scale. ChartDirector uses this value to compute end angle of the circle segment. This argument is usually not necessary as ChartDirector already know the end angle from the meter configuration. This argument can be used if you would like to use a "fake" angle to draw the scale background for special effects.

See also:

CDAngularMeterMBS.addScaleBackground(bgRadius as Integer, fillColor as color, edgeWidth as Integer, edgeColor as color, scaleRadius as Integer, startAngle as Double, endAngle as Double)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 15.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Adds a background to the meter scale.

The scale background is a circle segment (a circle with a part cut-off by a chord). Its radius is usually configured as larger than that of the meter scale. In this case, its angular span will also be larger than that of the meter scale. In the above sample, the meter scale spans 180 degrees. The scale background spans more than 180 degrees so that it can maintain a margin at the bottom side (the chord side).
Most arguments are optional and colors can be passed as Integer or color value.

ArgumentDefaultDescription
bgRadius(Mandatory)The radius of the circle segment to be used as the scale background.
fillColor(Mandatory)The fill color of the circle segment (the background color).
edgeWidth0The edge width of the circle segment. A positive width means the edge is internal to the circle segment. A negative width means the edge is external to the circle segment.
edgeColor-1The edge color. The default value of -1 means the edge color is the same as the fill color.
scaleRadius-0x7fffffffThe radius of the meter scale. ChartDirector uses this value to compute the extra angular span the circle segment must have in order to maintain proper margin at the chord side. This argument is usually not necessary as ChartDirector already know the scale radius from the meter configuration. This argument can be used if you would like to use a "fake" scale radius to draw the scale background for special effects.
startAngleNoValueThe start angle of the meter scale. ChartDirector uses this value to compute start angle of the circle segment. This argument is usually not necessary as ChartDirector already know the start angle from the meter configuration. This argument can be used if you would like to use a "fake" angle to draw the scale background for special effects.
endAngleNoValueThe end angle of the meter scale. ChartDirector uses this value to compute end angle of the circle segment. This argument is usually not necessary as ChartDirector already know the end angle from the meter configuration. This argument can be used if you would like to use a "fake" angle to draw the scale background for special effects.

See also:

CDAngularMeterMBS.addScaleBackground(bgRadius as Integer, fillColor as Integer, edgeWidth as Integer = 0, edgeColor as Integer = -1, scaleRadius as Integer = -2147483647)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 15.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Adds a background to the meter scale.

The scale background is a circle segment (a circle with a part cut-off by a chord). Its radius is usually configured as larger than that of the meter scale. In this case, its angular span will also be larger than that of the meter scale. In the above sample, the meter scale spans 180 degrees. The scale background spans more than 180 degrees so that it can maintain a margin at the bottom side (the chord side).
Most arguments are optional and colors can be passed as Integer or color value.

ArgumentDefaultDescription
bgRadius(Mandatory)The radius of the circle segment to be used as the scale background.
fillColor(Mandatory)The fill color of the circle segment (the background color).
edgeWidth0The edge width of the circle segment. A positive width means the edge is internal to the circle segment. A negative width means the edge is external to the circle segment.
edgeColor-1The edge color. The default value of -1 means the edge color is the same as the fill color.
scaleRadius-0x7fffffffThe radius of the meter scale. ChartDirector uses this value to compute the extra angular span the circle segment must have in order to maintain proper margin at the chord side. This argument is usually not necessary as ChartDirector already know the scale radius from the meter configuration. This argument can be used if you would like to use a "fake" scale radius to draw the scale background for special effects.
startAngleNoValueThe start angle of the meter scale. ChartDirector uses this value to compute start angle of the circle segment. This argument is usually not necessary as ChartDirector already know the start angle from the meter configuration. This argument can be used if you would like to use a "fake" angle to draw the scale background for special effects.
endAngleNoValueThe end angle of the meter scale. ChartDirector uses this value to compute end angle of the circle segment. This argument is usually not necessary as ChartDirector already know the end angle from the meter configuration. This argument can be used if you would like to use a "fake" angle to draw the scale background for special effects.

See also:

CDAngularMeterMBS.addScaleBackground(bgRadius as Integer, fillColor as Integer, edgeWidth as Integer, edgeColor as Integer, scaleRadius as Integer, startAngle as Double, endAngle as Double)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 15.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Adds a background to the meter scale.

The scale background is a circle segment (a circle with a part cut-off by a chord). Its radius is usually configured as larger than that of the meter scale. In this case, its angular span will also be larger than that of the meter scale. In the above sample, the meter scale spans 180 degrees. The scale background spans more than 180 degrees so that it can maintain a margin at the bottom side (the chord side).
Most arguments are optional and colors can be passed as Integer or color value.

ArgumentDefaultDescription
bgRadius(Mandatory)The radius of the circle segment to be used as the scale background.
fillColor(Mandatory)The fill color of the circle segment (the background color).
edgeWidth0The edge width of the circle segment. A positive width means the edge is internal to the circle segment. A negative width means the edge is external to the circle segment.
edgeColor-1The edge color. The default value of -1 means the edge color is the same as the fill color.
scaleRadius-0x7fffffffThe radius of the meter scale. ChartDirector uses this value to compute the extra angular span the circle segment must have in order to maintain proper margin at the chord side. This argument is usually not necessary as ChartDirector already know the scale radius from the meter configuration. This argument can be used if you would like to use a "fake" scale radius to draw the scale background for special effects.
startAngleNoValueThe start angle of the meter scale. ChartDirector uses this value to compute start angle of the circle segment. This argument is usually not necessary as ChartDirector already know the start angle from the meter configuration. This argument can be used if you would like to use a "fake" angle to draw the scale background for special effects.
endAngleNoValueThe end angle of the meter scale. ChartDirector uses this value to compute end angle of the circle segment. This argument is usually not necessary as ChartDirector already know the end angle from the meter configuration. This argument can be used if you would like to use a "fake" angle to draw the scale background for special effects.

See also:

CDAngularMeterMBS.addZone(startValue as Double, endValue as Double, 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 addZone method, but uses color instead of integer data type for passing color values.

See also:

CDAngularMeterMBS.addZone(startValue as Double, endValue as Double, 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
Adds a colored zone to the meter.

This method is just a short cut to AngularMeter.addZone, in which the starting radius is always 0, and ending radius is the radius of the meter scale. In other words, the zone is a sector on the meter.

ParameterDefaultDescription
startValue(Mandatory)The data value that marks the start position of the zone.
endValue(Mandatory)The data value that marks the end position of the zone.
fillColor(Mandatory)The fill color of the zone.
edgeColor-1The edge color of the zone. The default is the same as the fill color.

See also:

CDAngularMeterMBS.addZone(startValue as Double, endValue as Double, startRadius as Integer, endRadius as Integer, 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 addZone method, but uses color instead of integer data type for passing color values.

See also:

CDAngularMeterMBS.addZone(startValue as Double, endValue as Double, startRadius as Integer, endRadius as Integer, 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
Adds a colored zone to the meter.

ParameterDefaultDescription
startValue(Mandatory)The data value that marks the start position of the zone.
endValue(Mandatory)The data value that marks the end position of the zone.
startRadius(Mandatory)The starting radius of the zone in pixels.
endRadius(Mandatory)The ending radius of the zone in pixels.
fillColor(Mandatory)The fill color of the zone.
edgeColor-1The edge color of the zone. The default is the same as the fill color.

See also:

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


The biggest plugin in space...