2.5 Manual

General Image Options

Options available for use with all images.

Note: Valid image file types in Rainmeter are .png, .jpg, .bmp, .gif, .tif and .ico. If no extension is provided on an image file name, .png is assumed.

Options

ImageCrop
Crops the image. The value should be in the form: X, Y, W, H, Origin. Origin is optional and can be set to one of the following:
  • 1: Top left.
  • 2: Top right.
  • 3: Bottom right.
  • 4: Bottom left.
  • 5: Center (both W and H).
Greyscale Default: 0
If set to 1, the image is greyscaled.
ImageTint Default: 255,255,255,255
Color to tint the image with. If the alpha value is specified, the image can be made semi-transparent (0 means invisible, 255 mean fully opaque). The default value (255,255,255,255 for opaque white) and leaves the image unaltered.

Note: Combining Greyscale and ImageTint recolors the image to the specified color. Without Greyscale, the specified color is added to the image (i.e. the image is tinted).
ImageAlpha Default: 255
Opacity of the image ranging from 0 (invisible) to 255 (opaque). If set, overrides the alpha component specified in ImageTint.
ImageFlip Default: None
Flips the image. Valid values are None, Horizontal, Vertical or Both.
ImageRotate Default: 0.0
Rotates the image by the specified angle in degrees. Negative angles can be used for counter-clockwise rotation.
Tile Default: 0
If set to 1, the image is tiled (repeated) within the bounds defined by W and H.
ColorMatrixN
Defines a 5x5 matrix used to manipulate the color values of the image. It is divided into five separate options, one for each row, each numbered. The default matrix is as follows: 
ColorMatrix1=1; 0; 0; 0; 0
ColorMatrix2=0; 1; 0; 0; 0
ColorMatrix3=0; 0; 1; 0; 0
ColorMatrix4=0; 0; 0; 1; 0
ColorMatrix5=0; 0; 0; 0; 1
The values on the main diagonal are, from top-left to bottom-right: Red, Green, Blue, Alpha and a placeholder. The values represent the percentage of the particular value present in the image, where 0.0 is none and 1.0 is normal. The remaining entries in the matrix allow a color to have its value modified in terms of another color (e.g. the value of Red might have half of the Blue value added), with the entries in the final row (ColorMatrix5) determining offset values that are added directly to the color (e.g. ColorMatrix5=0.5; 0; 0; 0; 1 adds 50% to the red value).

See also: ColorMatrix Guide.