Options available for use with all meters.

Options

Meter

Type of the meter (e.g. Bar or String).

MeterStyle

Specifies one or more sections as MeterStyles from which option values are inherited. Multiple MeterStyles are delimited with pipes (|).

MeasureName, MeasureName2, MeasureName3...

"Binds" the meter to one or more measures. This means that the meter displays the values of these measures in some way. The exact form of the display depends on the type of meter. See each meter type's page for details about what kind of values are valid for that type, and how the values are displayed.

X, Y Default: 0

Specify the x and y position of the meter relative to the top-left edge of the skin. If the value is appended with r, the position is relative to the previous meter x or y position (e.g. 5r or (5 * 2)r). If the value is appended with R, the position is relative to the bottom-right edge of the previous meter.

W, H

The width and height of the meter. String meters and Image meters (with an image) can automatically determine width and height. For all other cases, W and H must be defined.

Hidden Default: 0

If set to 1, the meter is hidden. The visibility can also be changed with the !ShowMeter and !HideMeter bangs.

UpdateDivider Default: 1

Sets the update frequency of the meter.

Example: If set to 1, the meter is updated on every update cycle. If set to 5, the meter is updated on every fifth update cycle and so forth.

OnUpdateAction

Action to execute on each Update of the meter. This option obeys any UpdateDivider on the meter.

SolidColor, SolidColor2 Default: 0,0,0,0

Color of the meter background. If SolidColor2 is also specified, the background is a gradient composed of SolidColor and SolidColor2.

Hint: SolidColor=0,0,0,1 can be used to make transparent areas of the meter clickable.

GradientAngle

Angle of the gradient in degrees (for SolidColor and SolidColor2).

BevelType Default: 0

If enabled, draws a bevel around the edges of the rectangle specified by H and W. Valid values are:

• 0: No bevel
• 1: Raised
• 2: Sunken

AntiAlias Default: 0

If set to 1, antialising is used to display the meter.

DynamicVariables Default: 0

If set to 1, the meter is dynamic.

See also: Dynamic Variables

TransformationMatrix Default: 1;0;0;1;0;0

Defines a 3x2 matrix which can be used to transform the meter. Transformations include: scaling, skewing, and translating (ie. moving). There must be exactly 6 values separated by semicolons ;. Combining these can have drastic effects on the meter it is applied to.

See also: Transformation Matrix

Examples:

• TransformationMatrix=-1; 0; 0; 1; 40; 0: This will flip X along the line X=20.
• TransformationMatrix=1; 0; 0; -1; 0; 100: This will flip Y along the line Y=50.
• TransformationMatrix=0.5; 0; 0; 1; 25; 0: This will scale X by 0.5 at X=50.

Note: All transformations are relative to the top left corner of the window and not to the meter itself. So if you want to rotate the meter by its center the translation component in the matrix must be relative to the top left corner of the window.

Also note that the even if the meter's visual location and orientation is changed by the transformation the place where it would be located without the transformation will still be used to define the window size and register the mouse clicks. This might change in the future though.