init

technology/applications/media/ImageMagick.md

@@ -0,0 +1,138 @@
+---
+obj: application
+website: https://imagemagick.org
+repo: 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](images/GIMP.md) 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
+```shell
+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,y`
+- `line x0,y0 x1,y1`
+- `rectangle x0,y0 x1,y1`
+- `roundRectangle x0,y0 x1,y1 wc,hc`
+- `arc x0,y0 x1,y1 a0,a1`
+- `ellipse x0,y0 rx,ry a0,a1`
+- `circle x0,y0 x1,y1`
+- `polyline x0,y0 ... xn,yn`
+- `polygon x0,y0 ... xn,yn`
+- `bezier x0,y0 ... xn,yn`
+- `image 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
+```shell
+magick composite -geometry +100+200 overlay.png input.jpg output.jpg
+```