Meter=Bitmap displays a frame of an image depending on the measure value.
- General meter options
All general meter options are valid, except
- General image options
All general image options are valid for
Name of the measure used to determine the frame to display. The measures used must be able to return percentual values.
Example: If the image contains 5 frames, the first frame is displayed when the percentual measure value is between 0% and 19%, the second frame is shown from 20% to 39% , and so on.
Path to the image. The frames in the images can be laid out either horizontally or vertically (the orientation is determined automatically from the height or the width of the image). The size of a single frame is also determined automatically, so no extra space should surround the frames.
BitmapExtendis not set to
1, the measure being used must return values from 0.0 to 1.0 or must have both
- Number of frames in the image.
The number of transition frames per each actual frame. The transition frames are frames which are displayed when the measure value changes. The same number of transition frames must be used after each regular frame. The TransitionUpdate option in the [Rainmeter] section determines the rate at which the transition frames change during the transition. The total duration of the transition is therefore
BitmapFramesalways defines the total number of frames in the bitmap, including the transition frames.
Example: If the bitmap has 10 values and each transition consists of 4 additional frames, then
BitmapFramesshould be set to
If set to
1, a measured percentual value of zero is included in the calculation of the first frame. Since there are 100 percentage "points" from 0-99%, and 101 from 0-100%, BitmapZeroFrame should be used when measuring from 0-100%, or the meter will overrun the bitmap when the value is at 100%.
If set to
1the bitmap is extended to display the whole value.
Example: If you define a bitmap that defines frames from 0 to 9 you can use this to display the measured value as the bitmap numbers.
Number of digits that are drawn (for
BitmapExtend=1). The first frame is used if the value doesn't have as many digits as this defines.
Alignment of the bitmap value (for
BitmapExtend=1). Valid values are
Positive or negative number used as the separation between digits when
BitmapDigitsis higher than one.
An example skin demonstrating a Bitmap meter.