Roundline meter
Meter=Roundline
displays a line or solid fill that rotates in a circle around a point, based on a measure value.
The values for StartAngle and RotationAngle are defined in Radians
Options
- General meter options
-
All general meter options are valid.
MeasureName
-
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.
StartAngle
-
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.
RotationAngle
-
The size of the rotation angle in radians for the line. This defines the distance in radians from
StartAngle
that the meter will travel around the circle when the measure value is 100%. Use a negative value for counter-clockwise rotation. LineStart
-
Defines the distance in pixels from the center of rotation at which the line starts.
LineLength
-
Length in pixels of the line. The length is always measured from the center of rotation, regardless of the
LineStart
option. LineWidth
Default:1
-
Width in pixels of the line when
Solid
is 0. LineColor
Default:255,255,255,255
-
The Color of the line.
Solid
Default:0
-
If set to 1, meter will fill the meter with
LineColor
fromStartAngle
to the currentMeasureName
percentage value.LineWidth
is ignored. ControlAngle
Default:1
-
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
StartAngle
forRotationAngle
radians.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
StartAngle
.RotationAngle
is ignored. ControlStart, StartShift
Default:0
-
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 fromLineStart
to (LineStart
+StartShift
) pixels from the center of rotation. ControlLength, LengthShift
Default:0
-
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 fromLineLength
to (LineLength
+LengthShift
) pixels from the center of rotation. ValueRemainder
-
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=43200
Seconds in a 12-hour analog clock face. - Minutes Hand:
ValueRemainder=3600
Seconds in an hour. - Seconds Hand:
ValueRemainder=60
Seconds 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.
Example
[Rainmeter] |