Meter=Roundline displays a line or solid fill that rotates in a circle around a point, based on a measure value.
- General meter options
All general meter options are valid.
Name of the measure whose percentual value controls the amount of rotation. The measure must be able to return percentual values.
Note: If MeasureName is not specified, then the value is in effect always 100%, which can be used for instance to draw a circle or other curved solid.
The starting angle in radians for the line. This defines the starting point on the circle that will be treated as zero percent. The zero angle is to the right of the center.
The size of the rotation angle in radians for the line. This defines the distance in radians from
StartAnglethat the meter will travel around the circle when the measure value is 100%. Use a negative value for counter-clockwise rotation.
Defines the distance in pixels from the center of rotation at which the line starts.
Length in pixels of the line. The length is always measured from the center of rotation, regardless of the
Width in pixels of the line when
The Color of the line.
If set to 1, meter will fill the meter with
StartAngleto the current
If ControlAngle is 1 (default), then the percentage value of the measure that is bound to the meter controls the angle of the line (or the fill rotation if Solid=1) starting at
If ControlAngle is set to 0, then the measure does not control the angle of the line, which will be static at the value in
If ControlStart is set to 1, then the percentage value of the measure that is bound to the meter controls the starting position of the line. This is defined by
StartShift, and will range from
StartShift) pixels from the center of rotation.
If ControlLength is set to 1, then the percentage value of the measure that is bound to the meter controls the length of the line. This is defined by
LengthShift, and will range from
LengthShift) pixels from the center of rotation.
Use a remainder instead of the actual measured value.
This is primarily used to draw an analog clock. When used with the value of a Time measure in MeasureName the meter will internally use the
%modulo mathematical operator, and calculate the meter based on the remainder when the number of seconds in the Time measure is divided by the following values:
- Hours Hand:
ValueRemainder=43200Seconds in a 12-hour analog clock face.
- Minutes Hand:
ValueRemainder=3600Seconds in an hour.
- Seconds Hand:
ValueRemainder=60Seconds in a minute.
See the Rotator meter for an example.
- Hours Hand:
Note: If the width and height are not defined, the center point is at the X and Y position of the meter and any part of the meter that intersects with the edges of the skin window will be cut off. If width and height are specified, the center point will be in the middle of the bounding box and the skin window will include the meter.
An example skin demonstrating a Roundline meter.