ImageMagick Command-line Options

https://imagemagick.org/command-line-options/
Admin
Comprehensive reference documentation for ImageMagick command-line options and image processing...
Tokens:63,535
Snippets:533
Trust Score:9.7
Update:1 week ago
Show doc for...
Tokens:
Raw
### Sinusoid example

Source: https://imagemagick.org/command-line-options

Generates a curve that starts and ends at 0.9, oscillating three times between 0.5 and 0.9.

```shell
-function Sinusoid 3,-90,.2,.7
```

--------------------------------

### -transform example: apply affine matrix

Source: https://imagemagick.org/command-line-options

Applies the transformation matrix from a previous -affine option. The example transforms bird.ppm to bird.jpg.

```shell
$ magick -affine 2,2,-2,2,0,0 -transform bird.ppm bird.jpg
```

--------------------------------

### Debug log format example

Source: https://imagemagick.org/command-line-options

Sets the debug log format for the -debug option. The example logs coder events with user CPU time, module, line, and event.

```bash
$ magick -debug coder -log "%u %m:%l %e" in.gif out.png
```

--------------------------------

### Use -preview with Gamma preview type

Source: https://imagemagick.org/command-line-options

Command to apply a preview type to an image. The example uses the Gamma preview type and writes the output to Preview:gamma.png.

```bash
$ magick file.png -preview Gamma Preview:gamma.png
```

--------------------------------

### Get metric value with -format "%[distortion]"

Source: https://imagemagick.org/command-line-options

After comparing two images, use the string format "%[distortion]" to output the metric value. The example uses -metric RMSE and -compare with -format.

```bash
$ magick image.png reference.png -metric RMSE -compare -format \
   "%[distortion]" info:

```

--------------------------------

### -fill color: example color specifications

Source: https://imagemagick.org/command-line-options

Examples of specifying fill colors for graphic primitives. Enclose color specifications in quotation marks to prevent shell interpretation of '#' or parentheses.

```shell
-fill blue
-fill "#ddddff"
-fill "rgb(255,255,255)"
```

--------------------------------

### Convert CMYK to RGB with -profile

Source: https://imagemagick.org/command-line-options

This example shows a CMYK-CMYK-RGB conversion when the original image is CMYK with a profile. Note that -profile is an operator, so a conversion is made each time it is encountered in order.

```bash
$ magick CMYK.tif -profile "CMYK.icc" -profile "RGB.icc" RGB.tiff
```

--------------------------------

### -title example: format string for image title

Source: https://imagemagick.org/command-line-options

Use this option to assign a specific title to the image, displayed in the window title bar. The example embeds format characters to include the image filename, type, width, and height.

```shell
-title "%m:%f %wx%h"
```

--------------------------------

### Compare two images with -metric RMSE and -compare

Source: https://imagemagick.org/command-line-options

Use the convert-style -compare option to mathematically and visually annotate the difference between two same-sized images. The example uses the RMSE metric and outputs a difference image.

```bash
$ magick image.png reference.png -metric RMSE -compare \   
 difference.png

```

--------------------------------

### Define a PostScript image mask with -define

Source: https://imagemagick.org/command-line-options

Use -define to set coder-specific definitions. This example sets the ps:imagemask define for a PostScript output.

```bash
$ magick bilevel.tif -define ps:imagemask eps3:stencil.ps

```

--------------------------------

### Log cache and blob events with -debug

Source: https://imagemagick.org/command-line-options

Use -debug with a comma-separated list of event domains to log specific events. This example logs Cache and Blob events while converting an image.

```bash
$ magick -debug "Cache,Blob" rose: rose.png

```

--------------------------------

### Set a temporary path in the registry with -define

Source: https://imagemagick.org/command-line-options

Use -define with a registry: prefix to set image registry attributes. This example sets a temporary path for work files.

```bash
-define registry:temporary-path=/data/tmp

```

--------------------------------

### Command to list all -list arguments

Source: https://imagemagick.org/command-line-options

Use `magick identify -list list` to get a complete listing of all the -list arguments available in your version of ImageMagick.

```bash
$ magick identify -list list
```

--------------------------------

### Benchmark image resize with -bench 5

Source: https://imagemagick.org/command-line-options

Runs the magick command with -bench 5 to measure performance over 5 iterations. The output shows performance metrics including iterations per second, user time, and elapsed time. Modify with -duration for fixed seconds and -concurrent for parallel execution (requires OpenMP).

```shell
$ magick logo: -resize 200% -bench 5 logo.png
Performance[1]: 5i 1.344ips 1.000e 3.710u 0:03.720
Performance[2]: 5i 1.634ips 0.549e 3.890u 0:03.060
Performance[3]: 5i 2.174ips 0.618e 3.190u 0:02.300
Performance[4]: 5i 1.678ips 0.555e 3.810u 0:02.980
Performance[4]: 5i 0.875657ips 6.880u 0:05.710

```

--------------------------------

### List previews with -list preview

Source: https://imagemagick.org/command-line-options

Use `-list preview` to print a complete list of previews. The default preview is `JPEG`.

```bash
$ magick identify -verbose
```

--------------------------------

### -caption example with format string

Source: https://imagemagick.org/command-line-options

Example of using -caption with a format string to set caption metadata. The caption is expanded when assigned to the image. The example produces 'MIFF:bird.miff 512x480' for an image bird.miff with width 512 and height 480.

```shell
-caption "%m:%f %wx%h"  bird.miff
```

--------------------------------

### Create meta channels from gray pixels

Source: https://imagemagick.org/command-line-options

Creates two meta channels and populates them with a copy of the gray pixels, saving to a TIFF file.

```bash
$ magick gray.pgm -channel-fx "gray=>meta, gray=>meta1" gray.tif
```

--------------------------------

### Example: Create a custom 8-lobe jinc windowed sinc filter

Source: https://imagemagick.org/command-line-options

Shows a magick command that uses -filter sinc with expert settings to create a custom filter. The command is incomplete in the source, ending with a backslash, so it is presented as-is.

```shell
$ magick image.png \
  -filter sinc \
```

--------------------------------

### Example Color Correction Collection (CDL XML)

Source: https://imagemagick.org/command-line-options

Example XML file for the -cdl option. Defines a ColorCorrectionCollection with a ColorCorrection element containing SOPNode (Slope, Offset, Power) and SATNode (Saturation) values.

```xml
<?xml version="1.0" encoding="UTF-8"?>
<ColorCorrectionCollection xmlns="urn:ASC:CDL:v1.2">
  <ColorCorrection id="cc06668">
    <SOPNode>
      <Slope> 0.9 1.2 0.5 </Slope>
      <Offset> 0.4 -0.5 0.6 </Offset>
      <Power> 1.0 0.8 1.5 </Power>
    </SOPNode>
    <SATNode>
      <Saturation> 0.85 </Saturation>
    </SATNode>
  </ColorCorrection>
</ColorCorrectionCollection>
```

--------------------------------

### Define a read mask with -channel-fx

Source: https://imagemagick.org/command-line-options

Similar to the alpha injection example, but writes the result to the read-mask channel.

```bash
$ magick wizard.png mask.pgm -channel-fx '| gray=>read-mask' wizard-mask.png
```

--------------------------------

### Set memory and map limits with -limit

Source: https://imagemagick.org/command-line-options

Use -limit to set resource limits. This example limits memory to 32MiB and map to 64MiB. The value for file is in number of files; other limits are in bytes, with SI prefixes allowed (e.g., 100MB).

```shell
-limit memory 32MiB -limit map 64MiB

```

--------------------------------

### Generate all-black and all-white images using threshold

Source: https://imagemagick.org/command-line-options

Instructive examples that generate an all-black and an all-white image with the same dimensions as the input image. The first command uses -threshold 100% to produce black, and the second uses -threshold -1 to produce white.

```shell
$ magick in.png -channel RGB -threshold 100% black.png
```

```shell
convert in.png -channel RGB -threshold -1 white.png
```

--------------------------------

### Print list of -function operators

Source: https://imagemagick.org/command-line-options

Use this command to list all available -function operators.

```shell
-list function
```

--------------------------------

### Extract Exif profile with -profile

Source: https://imagemagick.org/command-line-options

To extract Exif data (stored in JPEG APP1 profile), write the image to a file with an image format such as APP1. The example writes the profile to `profile.exif`.

```bash
$ magick cockatoo.jpg profile.exif
```
Tokens:
Raw