| METERS |

| Each meter needs to have an unique name, which defines a section in the ini-file for that meter. The name needs to be put inside []-characters. The name doesn't matter as long as you don't use it anywhere else in the same ini-file. Do not use spaces in the names. General settings for all meters MeasureName The name of the measure that this meter displays. X The X-position of the meter inside the window. The coordinates can be made relative to the previous meter by adding 'r' to the end of the number (e.g. X=5r). You can also use capital R which makes the position relative to the right edge of the previous meter. Y The Y-position of the meter inside the window. The coordinates can be made relative to the previous meter by adding 'r' to the end of the number (e.g. Y=-10r). You can also use capital R which makes the position relative to the bottom edge of the previous meter. W The width of the meter. It is not necessary to define this if the width can be calculated from an image or if you are using a STRING meter. If you use the desktop as background for the Rainmeter you should always define the correct height and width for the meters or the window's dimensions might be calculated wrongly. H The height of the meter. This can also be left undefined under the same conditions as W. Hidden If set to 1, the meter is hidden. LeftMouseDownAction RightMouseDownAction LeftMouseUpAction RightMouseUpAction MouseOverAction MouseLeaveAction These are the same as with the global settings except that they only apply to the specific meter. I.e. The mouse action is only executed when the mouse is on the meter's area. These settings override the global setting. UpdateDivider This value determines how often the meter is updated. This is bound to the Update value. For example if the Update is set to 1000 and the UpdateDivider is 30, the meter is updated every 30 seconds. The default value is 1. SolidColor The color of the meter's background. SolidColor2 The second color of the meter's background for gradient. GradientAngle The angle of the meter's background color gradient. The angle is defined as radians. BevelType This draws a bevel edge around the solid background. 0 = no bevel, 1 = raised, 2 = sunken. Meter Type of the meter. The valid values are: HISTOGRAM STRING BAR BITMAP IMAGE LINE ROTATOR BUTTON Histogram SecondaryMeasureName The name of the secondary measure. This defines the measure for the secondary histogram that is drawn on the same meter. It is not necessary to define this if the other meter is not needed. PrimaryColor Color for the primary histogram. The colors are given in RGB format. Separate the color components with ",". E.g. PrimaryColor=10,30,255 SecondaryColor Color for the secondary histogram. BothColor Color that is used when the primary and secondary histograms are on top of eachother. PrimaryImage Name of the image that is used behind the secondary histogram. You can only use either colors or images but not both at the same time. So, if you define PrimaryImage you must also define SecondaryImage and BothImage (if you have a secondary measure in the same histogram). SecondaryImage Name of the image that is used behind the secondary histogram. BothImage Name of the image that is used when the primary and secondary histograms are on top of eachother. Autoscale If set to 1, the histogram is automatically scaled to show all the values. Flip If set to 1 the meter is flipped upsidedown. String FontColor The color of the text. Prefix String that is displayed before the value. Postfix String that is displayed after the value. FontFace Name of the font FontSize Size of the font. StringAlign The alignment of the string. The valid values are: LEFT, CENTER and RIGHT. StringStyle Style of the string. The valid values are: NORMAL, BOLD, ITALIC and BOLDITALIC. Scale Scaling factor for the measured value. The measured value is divided with the scale value, so in order to get 1000 times smaller values just set the scale to 1000. If the scale value has a decimal point (e.g. 1000.0) the resulting measured value is displayed as floating point value with one decimal. AutoScale If set to 1, the value is scaled automatically. This setting overrides Scale. The value is automatically postfixed with T, G, M or k depending how much it was scaled. Percentual If set to 1, the value is displayed in percents. NumOfDecimals The number of decimals used in the displayed value. AntiAlias If set to 1, the text is drawn as antialiased. Text The text that is displayed. Use %1 in the string to display the measured value. If this is bound to several measures just use %2, %3, etc. for different values. ClipString If set to 1 the width (W) of the meter clips the string. An ellipsis is added to the end of the string. Angle This defines the angle of the text. The value is given as radians. Note that the size of the text is still calculated as if the text would be horizontal. Bar BarColor The color of the bar. BarImage The image that is used behind the bar. This can be used instead of the BarColor. BarBorder This defines how much from the beginning and end of the bitmap is always drawn. BarOrientation The orientation of the bar. Valid values are: HORIZONTAL VERTICAL Flip Set to 1 to flip the direction of the bar. Bitmap BitmapImage This is the name of the image that holds the image frames. The images can be laid horizontally or vertically in the bitmap. The orientation is determined automatically form the hieght or the width of the bitmap (whichever is larger). Also the size of one frame is calculated automatically so you need to crop the image so that there is no extra space around the frames. BitmapFrames The number of frames in the bitmap. BitmapZeroFrame If set to 1, the first frame is used only when the measured value is zero. Otherwise the frames are linearly determined by the measured value. Image Note that this meter need's not to be bound on any measure as it really doesn't show the measured value in any way. The purpose for this meter is to make skinning easier. However, if you bind this to something it tries to load the image that the measure gives out as string value. If the W and H are defined for the meter, the image is scaled to the given size. ImageName Name of the image to be displayed. Line LineCount Number of lines in the meter. There can be any number of lines in the same meter. The below settings are set for the different lines by specifying the line number after the name. Note that the [N] for the first line is never given. So, for example to set the color of the first line you'd give "LineColor=255,0,0" and for the second line "LineColor2=0,0,0", etc. MeasureName[N] The name of the measure for the line [N]. LineColor[N] The color of the line N. Scale[N] The scale of the line N. The measured value is multiplied with this. AutoScale If set to 1, the lines are automatically scaled so that the largest value is visible in the meter. If set to 0, the meter's scale is taken from the largest max value of the measures. HorizontalLines If set to 1 horizontal lines are drawn behind the histogram lines. HorizontalLineColor The color of the horizontal lines. AntiAlias If set to 1, the lines are drawn as antialiased. LineWidth Width of the line. Flip If set to 1 the meter is flipped upsidedown. Roundline LineWidth This defines the width of the line (1.0 = one pixel). LineLength This defines the length of the line. The lenght is always measured from the center of rotation (no matter what the LineStart value is). LineStart This defines where the line start. StartAngle The start angle for the line. This is in radians and the zero angle is towards positive x-axis. Normal rotation direction is clockwise. RotationAngle The size of the rotation angle for the line. Use negative value for counter-clockwise rotation. AntiAlias If set to 1, the line is antialiased. ValueRemainder Use remainder instead of the actual measured value. This can be used to draw analog clock (check the example in the example skin files). LineColor The color of the line. Solid Set to 1 and the meter will draw a pie-chart instead. Rotator ImageName Name of the image to be rotated OffsetX X-offset of the center of rotation. OffsetY Y-offset of the center of rotation. StartAngle The start angle for the line. This is in radians and the zero angle is towards positive x-axis. Normal rotation direction is clockwise. RotationAngle The size of the rotation angle for the line. Use negative value for counter-clockwise rotation. ValueRemainder Use remainder instead of the actual measured value. This can be used to draw analog clock (check the example in the example skin files). Button This not a normal meter since you cannot bind it to any measure. The purpose of it is to make button creation easier. ButtonImage The name of the button image. The image must have 3 frames which can be set either horizontally or vertically (The orientation is checked from the width/height of the image). ButtonCommand The command or !bang that is executed when the button is pressed. |