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 from StartAngle to the current MeasureName 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 for RotationAngle 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 from LineStart 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 from LineLength 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.

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]
Update=1000
AccurateText=1
DynamicWindowSize=1

[Metadata]
Name=ExampleMeterRoundline
Author=The Rainmeter Team
Information=Example of the Roundline meter
License=Creative Commons Attribution-Non-Commercial-Share Alike 3.0
Version=1.0

[Variables]
TotalColor=173,230,224,255
FreeColor=75,171,161,255
UsedColor=255,205,112,255

[MeasureTotalDisk]
Measure=FreeDiskSpace
Drive=C:
Total=1

[MeasureUsedDisk]
Measure=FreeDiskSpace
Drive=C:
InvertMeasure=1

[MeasureFreeDisk]
Measure=FreeDiskSpace
Drive=C:

[MeterTotalDisk]
Meter=Roundline
MeasureName=MeasureTotalDisk
X=10
Y=0
W=120
H=120
StartAngle=4.712
RotationAngle=6.283
LineLength=60
LineColor=#TotalColor#
Solid=1
AntiAlias=1

[MeterUsedDisk]
Meter=Roundline
MeasureName=MeasureUsedDisk
X=10
Y=0
W=120
H=120
StartAngle=4.712
RotationAngle=6.283
LineLength=52
LineColor=#UsedColor#
Solid=1
AntiAlias=1

[MeterFreeDisk]
Meter=Roundline
MeasureName=MeasureFreeDisk
X=10
Y=0
W=120
H=120
StartAngle=4.712
RotationAngle=-6.283
LineLength=52
LineColor=#FreeColor#
Solid=1
AntiAlias=1

[MeterTotalText]
Meter=String
MeasureName=MeasureTotalDisk
X=70
Y=130
FontSize=11
FontColor=#TotalColor#
StringAlign=Center
AntiAlias=1
AutoScale=1
Text=Total Disk: %1B

[MeterUsedText]
Meter=String
MeasureName=MeasureUsedDisk
X=70
Y=6R
FontSize=11
FontColor=#UsedColor#
StringAlign=Center
AntiAlias=1
AutoScale=1
Text=Used Disk: %1B

[MeterFreeText]
Meter=String
MeasureName=MeasureFreeDisk
X=70
Y=6R
FontSize=11
FontColor=#FreeColor#
StringAlign=Center
AntiAlias=1
AutoScale=1
Text=Free Disk: %1B

An example skin demonstrating a Roundline meter.