Bitmap meter ビットマップメーター
Meter=Bitmap
displays frame(s) of an image depending on a measure value.
Optionsオプション
- General meter options一般メーターオプション
-
All general meter options are valid, except
W
andH
.The size of the meter is automatically determined by the height of the bitmap image and the number of image frames displayed.
- General image options一般的な画像オプション
-
All general image options are valid for
BitmapImage
, exceptImageCrop
, andImageRotate
. MeasureName
-
Name of the measure used to determine the frame(s) to display. There are two kinds of values that can be used:
- The measure returns a percentual value.
This can be used to display a single frame from the bitmap image, based on the percentage value. This can be used to create animations.
If for example 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. - The measure returns any integer numeric value. This is an
int64
numeric type, and can be any value up to9,223,372,036,854,775,807
. Fractional values will be rounded to whole numbers.
This can be used to display a numeric value using multiple frames from the bitmap image.
In this case, you will use BitmapExtend with a value of 1, and set BitmapDigits with a value equal to the greatest number of digits the value can be. This will be used with a BitmapImage that consists of the numbers from 0 to 9, and a BitmapFrames of 10. This will then display the entire number using the appropriate numeric (0-9) frames from the bitmap image.
- The measure returns a percentual value.
BitmapImage
-
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 need surround the frames.
Some help with creating bitmap images to use in this meter can be found at Button Images, as the Button and Bitmap meters use the same kind of images made of frames combined into a single image file. Think of a filmstrip.
BitmapFrames
Default:1
-
Number of frames in the image.
BitmapTransitionFrames
-
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
TransitionUpdate
multiplied byBitmapTransitionFrames
.Note:
BitmapFrames
always 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
BitmapFrames
should be set to50
andBitmapTransitionFrames
to4
. BitmapZeroFrame
Default:0
-
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%. BitmapExtend
Default:0
-
If set to
1
the bitmap is extended to display the whole measured 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.
BitmapDigits
Default:0
-
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. BitmapAlign
-
Alignment of the bitmap value (for
BitmapExtend=1
). Valid values areLeft
,Center
, andRight
. BitmapSeparation
Default:0
-
Positive or negative number of pixels used as the separation between digits when
BitmapDigits
is higher than one.
Example例
[Rainmeter] |
An example skin demonstrating a Bitmap meter.
関連記事
- String meter ストリングメーター
- Shape meter 形状メーター
- Roundline meter ラウンドラインメーター
- Rotator meter 回転計
- Line meter ラインメーター
- Image Meter イメージメーター
- Histogram meter ヒストグラムメーター
- Button meter ボタンメーター
- Bar meter バーメーター
- General Meter Options 一般メーターオプション
スポンサーリンク