Meter=Image displays either a static image or an image dependant on a measure value(s).

Options

General meter options

All general meter options are valid.

General image options

All general image options are valid for ImageName.

MeasureName, MeasureName2, ..., MeasureNameN

Name(s) of the measure(s) to use in ImageName with the %N syntax. This option does not need to be specified if not needed.

ImageName Default: %1.png

Path of the image file. The values of the measure(s) specified with MeasureName can be used with the %N syntax as follows:

MeasureName=SomeMeasure
MeasureName2=SomeMeasure2
ImageName=%1-%2.png
; %1 and %2 will be replaced by the string values of SomeMeasure and
; SomeMeasure2, respectively.

Note: If an extension is not provided for the image file, .png is assumed.

Path

Path of the image folder location.

PreserveAspectRatio Default: 0

Controls how W and H scale the image when Tile=0. Valid values are:

• 0: The image is scaled to exactly fit the bounds specified by W and H without regard to aspect ratio.
• 1: The image is scaled to fit within the bounds specified by W and/or H while preserving the aspect ratio.
• 2: The image is scaled and cropped to fill the bounds specified by W and/or H while preserving the aspect ratio.

ScaleMargins Format: Left, Top, Right, Bottom

Margins of the image to exclude from scaling when Tile=0 and PreserveAspectRatio=0.

Example: ScaleMargins=10, 50, 10, 50

Note: Using the SolidColor option, along with W and H options, an image meter may be used to draw squares, rectangles or lines without needing any ImageName or MeasureName.

Example

[Rainmeter]
Update=1000

[MeterBackground]
Meter=Image
ImageName=#@#Images\Background.jpg
W=200
H=200
GreyScale=1
ImageTint=171,54,3,150

[MeasureMyPictures]
Measure=Plugin
Plugin=QuotePlugin
PathName=#@#\Pictures
Subfolders=0
FileFilter=*.jpg;*.gif;*.bmp;*.png
UpdateDivider=10

[MeterShowPicture]
Meter=Image
MeasureName=MeasureMyPictures
X=25
Y=25
W=150
H=150
PreserveAspectRatio=1
LeftMouseUpAction=!Refresh