Rotator meter

Meter=Rotator displays an image that rotates around a point based on a measure.

The values for StartAngle and RotationAngle are defined in Radians

Options

General meter options
All general meter options are valid.
General image options
All general image options are valid for ImageName.
ImageName
Path of the image file.
MeasureName
Name of the measure whose percentual value controls the angle of rotation. The measure must be a percentual value or have MinValue and MaxValue set.
OffsetX, OffsetY Default: 0.0
X-offset and Y-offset of the center of rotation.
StartAngle Default: 0.0

The starting angle in radians for the image. 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 Default: (2 * pi)

The size of the rotation angle in radians for the image. 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.

ValueRemainder Default: 0

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.

Remarks

The center of rotation will be located at the center of the height and width specified for the meter. If height and width are not specified, the center of rotation will be located at the X and Y coordinates provided for the meter. It is also important to remember that if the height and width are not specified, any portion of the meter that lies outside of the skin window will be cut off.

Here is an example of how to Rotate an Image Around its Center.

Example

[Rainmeter]
Update=1000
[Metadata]
Name=ExampleMeterRotator
Author=The Rainmeter Team
Information=Example of the Rotator meter
License=Creative Commons Attribution-Non-Commercial-Share Alike 3.0
Version=1.0
[MeasureTime]
Measure=Time
[MeterClockFace]
Meter=Image
ImageName=#@#Images\ClockFace.png
W=110
H=116
[MeterHoursHand]
Meter=ROTATOR
MeasureName=MeasureTime
X=0
Y=0
W=110
H=116
ImageName=#@#Images\Hours.png
OffsetX=3
OffsetY=3
StartAngle=4.7124
RotationAngle=6.2832
ValueRemainder=43200
[MeterMinutesHand]
Meter=ROTATOR
MeasureName=MeasureTime
X=0
Y=0
W=110
H=116
ImageName=#@#Images\Minutes.png
OffsetX=3
OffsetY=3
StartAngle=4.7124
RotationAngle=6.2832
ValueRemainder=3600
[MeterSecondsHand]
Meter=ROUNDLINE
MeasureName=MeasureTime
X=0
Y=0
W=110
H=116
LineLength=52
LineColor=247,220,129,255
LineWidth=2
AntiAlias=1
StartAngle=4.7124
RotationAngle=6.2832
ValueRemainder=60

An example skin demonstrating a Rotator meter.