Skip to content

Home

Jump to bottom
khanhas edited this page Dec 22, 2017 · 23 revisions

Image Types:

Basic usage:

MagickMeter can't display Image by itself, so it needs a Image meter that has MagickMeter plugin measure as MeasureName.

[MagickMeter_1]
Measure = Plugin
Plugin = MagickMeter
Image = File D:\homer.svg

[Image_1]
Meter = Image
MeasureName = MagickMeter_1

You can add more image into current canvas by appending Image2, Image3, ImageN in plugin measure:

[MagickMeter_1]
Measure = Plugin
Plugin = MagickMeter
Image  = File D:\homer.svg
Image2 = File E:\kanna.png
Image3 = File http://www.clker.com/cliparts/f/a/5/P/4/A/dark-green-marijuana-leaf-vector-format-md.png

True power of ImageMagick library is image manipulation. To use available effects and modifiers, you can add them right after image declaration:

Image = File D:\homer.svg | Scale 200% | Implode -1
Image2 = Text EXAMPLE FOR#CRLF#GitHub | Size 120 | Shadow 80,10,20,0 ; FF5050
Image3 = File E:\Weed420Meme.jpg | AdaptiveBlur 0,20

General modifiers:

Particular modifiers of each type are applied first, then general modifiers are applied later, no matter where they stand in modifiers list.

All Effects modifiers can be used in any image type.

Move Default: 0,0

Parameters:

Move OffsetX,OffsetY

Move canvas to new position. Useful for some effects that need more space in the top left corner. If you're working on shape or text with rotation or stroke, use their Offset modifiers instead.

Color formats:

Normal Rainmeter colors in hex format RRGGBBAA and decimal format R,G,B,A are compatible.
HSL is also supported, use it with this format hsl(HueDegree, Saturation, Lightness, Alpha).
HueDegree can be set from 0 to 360. Saturation, Lightness and Alpha goes from 0 to 100. Eg:

Image = Rectangle 0,0,300,400 | Color hsl(40,66,20) | StrokeColor hsl(60,33,11)
Image2 = File D:\example.png | Shadow 100,20,20,30 ; hsl(320,45,87)

Internal variables:

Format:

{ImageN:VariableName}

Range of N depends on where internal variable is used, it has to be equal or smaller than current image index.
Although internal variables of one image can be used on itself modifier, they're only available after all type's particular modifiers are applied first (raw image object). Then you can use them in general modifiers.
If you accidentally use them on type's modifiers, they will just return 0.

Effect modifiers will not change position, size and colors. But bounding box and colors of Clone and Combine always be recalculated after their definition, so you can take advantage of this to update internal variables value of effect added image.

Valid VariableName:

  • X: Returns X position of raw image object's top left corner.

  • Y: Returns Y position of raw image object's top left corner.

  • W: Returns width of raw image object.

  • H: Returns height of raw image object.

  • ColorBG: Darkest color

  • Color1: Interesting color 1

  • Color2: Interesting color 2

  • Color3: Interesting color 3

  • ColorFG: Lightest color

Notes: Color1, Color2, Color3 are interesting colors that might are image's dominant colors or just different shades of ColorBG and ColorFG.

Bangs

!CommandMeasure MeasureName Update

Reread and recreate all images.

!CommandMeasure MeasureName "Reload ImageList"

Reread and recreate only images in ImageList

OnChangeAction = !CommandMeasure MM "Reload Image2,Image4,Image8"
IfTrueAction = !CommandMeasure MM2 "Reload Image3"
Clone this wiki locally