5.2 KiB
| obj | website | repo |
|---|---|---|
| application | https://imagemagick.org | https://github.com/imagemagick/imagemagick |
ImageMagick
ImageMagick is a collection of command-line tools that can be used to modify and manipulate images. While many people are used to using graphical user interfaces (GUIs) like Gimp or Photoshop to edit images individually, these tools may not always be practical. For instance, if you need to process an image dynamically from a web script or apply the same operations to multiple images, or if you need to repeat a specific operation on the same or different images at different times, using a command-line utility like ImageMagick may be more efficient.
Usage
magick tool [ {option} | {image} ... ] {output_image}
magick convert [image] [option]... [output]
You can manipulate the image with a chain of options which get executed one by one resulting in a final output image.
Options
-background color
This option sets a background color
-black-threshold value{%}
Force to black all pixels below the threshold while leaving all pixels at or above the threshold unchanged.
The threshold value can be given as a percentage or as an absolute integer value.
-blend geometry
Blend an image into another by the given absolute value or percent.
Blend will average the images together ('plus') according to the percentages given and each pixels transparency. If only a single percentage value is given it sets the weight of the composite or 'source' image, while the background image is weighted by the exact opposite amount. That is a -blend 30% merges 30% of the 'source' image with 70% of the 'destination' image. Thus it is equivalent to -blend 30x70%.
-blur radius
Convolve the image with a Gaussian or normal distribution using the given Sigma value.
-border geometry
Surround the image with a border of color.
-bordercolor color
Set the border color.
-borderwidth geometry
Set the border width.
-brightness-contrast brightness{xcontrast}{%}
Brightness and Contrast values apply changes to the input image. They are not absolute settings. A brightness or contrast value of zero means no change. The range of values is -100 to +100 on each. Positive values increase the brightness or contrast and negative values decrease the brightness or contrast. To control only contrast, set the brightness=0. To control only brightness, set contrast=0 or just leave it off.
-channel type
Specify those image color channels to which subsequent operators are limited.
The channels above can also be specified as a comma-separated list or can be abbreviated as a concatenation of the letters 'R', 'G', 'B', 'A', 'O', 'C', 'M', 'Y', 'K'.
-chop geometry
Remove pixels from the interior of an image.
-colorize value
Colorize the image by an amount specified by value using the color specified by the most recent -fill setting.
Specify the amount of colorization as a percentage. Separate colorization values can be applied to the red, green, and blue channels of the image with a comma-delimited list of colorization values (e.g., -colorize 0,0,50).
-composite
Take the first image 'destination' and overlay the second 'source' image. The location of the 'source' or 'overlay' image is controlled according to -gravity, and -geometry settings.
-contrast
Enhance or reduce the image contrast.
-copy geometry offset
Copy pixels from one area of an image to another.
-crop geometry{@}{!}
Cut out one or more rectangular regions of the image.
-draw string
Annotate an image with one or more graphic primitives.
The shape primitives:
point x,yline x0,y0 x1,y1rectangle x0,y0 x1,y1roundRectangle x0,y0 x1,y1 wc,hcarc x0,y0 x1,y1 a0,a1ellipse x0,y0 rx,ry a0,a1circle x0,y0 x1,y1polyline x0,y0 ... xn,ynpolygon x0,y0 ... xn,ynbezier x0,y0 ... xn,ynimage operator x0,y0 w,h filename
-extract geometry
Extract the specified area from image.
-fill color
Color to use when filling a graphic primitive.
-flip
Create a mirror image
reflect the scanlines in the vertical direction. The image will be mirrored upside-down.
-flop
Create a mirror image.
Reflect the scanlines in the horizontal direction, just like the image in a vertical mirror.
-gaussian-blur radius
Blur the image with a Gaussian operator.
-geometry geometry
Set the preferred size and location of the image.
-gravity type
Sets the current gravity suggestion for various other settings and options.
Choices include: NorthWest, North, NorthEast, West, Center, East, SouthWest, South, SouthEast.
-negate
Replace each pixel with its complementary color.
-region geometry
Set a region in which subsequent operations apply.
-resize geometry
Resize an image.
-size width[xheight][+offset]
Set the width and height of the image.
-sort-pixels
sorts pixels within each scanline in ascending order of intensity.
-stroke color
Color to use when stroking a graphic primitive.
-strokewidth value
Set the stroke width.
Composite images
magick composite -geometry +100+200 overlay.png input.jpg output.jpg