WARNING: The convert command is deprecated in IMv7, use "magick" instead of "convert" or "magick convert"
Version: ImageMagick 7.1.2-35 Q16-HDRI x86_64 acaf7e418:20261031 https://imagemagick.org
Copyright: (C) 1999 ImageMagick Studio LLC
License: https://imagemagick.org/license/
Features: Cipher DPC HDRI OpenMP
Delegates (built-in): bzlib fontconfig freetype heic jng jp2 jpeg lcms lzma pangocairo png tiff webp x xml zlib zstd
Compiler: gcc (16.2)
Usage: convert [options ...] file [ [options ...] file ...] [options ...] file
Image Settings:
-adjoin join images into a single multi-image file
-affine matrix affine transform matrix
-alpha option activate, deactivate, reset, or set the alpha channel
-antialias remove pixel-aliasing
-authenticate password
decipher image with this password
-attenuate value lessen (or intensify) when adding noise to an image
-background color background color
-bias value add bias when convolving an image
-black-point-compensation
use black point compensation
-blue-primary point chromaticity blue primary point
-bordercolor color border color
-caption string assign a caption to an image
-clip clip along the first path from the 8BIM profile
-clip-mask filename associate a clip mask with the image
-clip-path id clip along a named path from the 8BIM profile
-colorspace type alternate image colorspace
-comment string annotate image with comment
-compose operator set image composite operator
-compress type type of pixel compression when writing the image
-define format:option
define one or more image format options
-delay value display the next image after pausing
-density geometry horizontal and vertical density of the image
-depth value image depth
-direction type render text right-to-left or left-to-right
-display server get image or font from this X server
-dispose method layer disposal method
-dither method apply error diffusion to image
-encoding type text encoding type
-endian type endianness (MSB or LSB) of the image
-family name render text with this font family
-features distance analyze image features (e.g. contrast, correlation)
-fill color color to use when filling a graphic primitive
-filter type use this filter when resizing an image
-font name render text with this font
-format "string" output formatted image characteristics
-fuzz distance colors within this distance are considered equal
-gravity type horizontal and vertical text placement
-green-primary point chromaticity green primary point
-illuminant type reference illuminant
-intensity method method to generate an intensity value from a pixel
-intent type type of rendering intent when managing the image color
-interlace type type of image interlacing scheme
-interline-spacing value
set the space between two text lines
-interpolate method pixel color interpolation method
-interword-spacing value
set the space between two words
-kerning value set the space between two letters
-label string assign a label to an image
-limit type value pixel cache resource limit
-loop iterations add Netscape loop extension to your GIF animation
-matte store matte channel if the image has one
-mattecolor color frame color
-moments report image moments
-monitor monitor progress
-orient type image orientation
-page geometry size and location of an image canvas (setting)
-ping efficiently determine image attributes
-pointsize value font point size
-precision value maximum number of significant digits to print
-preview type image preview type
-quality value JPEG/MIFF/PNG compression level
-quiet suppress all warning messages
-read-mask filename associate a read mask with the image
-red-primary point chromaticity red primary point
-regard-warnings pay attention to warning messages
-remap filename transform image colors to match this set of colors
-repage geometry size and location of an image canvas
-respect-parentheses settings remain in effect until parenthesis boundary
-sampling-factor geometry
horizontal and vertical sampling factor
-scene value image scene number
-seed value seed a new sequence of pseudo-random numbers
-size geometry width and height of image
-stretch type render text with this font stretch
-stroke color graphic primitive stroke color
-strokewidth value graphic primitive stroke width
-style type render text with this font style
-support factor resize support: > 1.0 is blurry, < 1.0 is sharp
-synchronize synchronize image to storage device
-taint declare the image as modified
-texture filename name of texture to tile onto the image background
-tile-offset geometry
tile offset
-treedepth value color tree depth
-transparent-color color
transparent color
-undercolor color annotation bounding box color
-units type the units of image resolution
-verbose print detailed information about the image
-view FlashPix viewing transforms
-virtual-pixel method
virtual pixel access method
-weight type render text with this font weight
-white-point point chromaticity white point
-write-mask filename associate a write mask with the image -word-break type sets whether line breaks appear wherever the text would otherwise overflow
Image Operators:
-adaptive-blur geometry
adaptively blur pixels; decrease effect near edges
-adaptive-resize geometry
adaptively resize image using 'mesh' interpolation
-adaptive-sharpen geometry
adaptively sharpen pixels; increase effect near edges
-alpha option on, activate, off, deactivate, set, opaque, copy
transparent, extract, background, or shape
-annotate geometry text
annotate the image with text
-auto-gamma automagically adjust gamma level of image
-auto-level automagically adjust color levels of image
-auto-orient automagically orient (rotate) image
-auto-threshold method
automatically perform image thresholding
-bench iterations measure performance
-bilateral-blur geometry
non-linear, edge-preserving, and noise-reducing smoothing filter
-black-threshold value
force all pixels below the threshold into black
-blue-shift factor simulate a scene at nighttime in the moonlight
-blur geometry reduce image noise and reduce detail levels
-border geometry surround image with a border of color
-bordercolor color border color
-brightness-contrast geometry
improve brightness / contrast of the image
-canny geometry detect edges in the image
-cdl filename color correct with a color decision list
-channel mask set the image channel mask
-charcoal radius simulate a charcoal drawing
-chop geometry remove pixels from the image interior
-clahe geometry contrast limited adaptive histogram equalization
-clamp keep pixel values in range (0-QuantumRange)
-colorize value colorize the image with the fill color
-color-matrix matrix apply color correction to the image
-colors value preferred number of colors in the image
-connected-components connectivity
connected-components uniquely labeled
-contrast enhance or reduce the image contrast
-contrast-stretch geometry
improve contrast by 'stretching' the intensity range
-convolve coefficients
apply a convolution kernel to the image
-cycle amount cycle the image colormap
-decipher filename convert cipher pixels to plain pixels
-deskew threshold straighten an image
-despeckle reduce the speckles within an image
-distort method args
distort images according to given method and args
-draw string annotate the image with a graphic primitive
-edge radius apply a filter to detect edges in the image
-encipher filename convert plain pixels to cipher pixels
-emboss radius emboss an image
-enhance apply a digital filter to enhance a noisy image
-equalize perform histogram equalization to an image
-evaluate operator value
evaluate an arithmetic, relational, or logical expression
-extent geometry set the image size
-extract geometry extract area from image
-fft implements the discrete Fourier transform (DFT)
-flip flip image vertically
-floodfill geometry color
floodfill the image with color
-flop flop image horizontally
-frame geometry surround image with an ornamental border
-function name parameters
apply function over image values
-gamma value level of gamma correction
-gaussian-blur geometry
reduce image noise and reduce detail levels
-geometry geometry preferred size or location of the image
-grayscale method convert image to grayscale
-hough-lines geometry
identify lines in the image
-identify identify the format and characteristics of the image
-ift implements the inverse discrete Fourier transform (DFT)
-implode amount implode image pixels about the center
-integral calculate the sum of values (pixel values) in the image
-interpolative-resize geometry
resize image using interpolation
-kmeans geometry K means color reduction
-kuwahara geometry edge preserving noise reduction filter
-lat geometry local adaptive thresholding
-level value adjust the level of image contrast
-level-colors color,color
level image with the given colors
-linear-stretch geometry
improve contrast by 'stretching with saturation'
-liquid-rescale geometry
rescale image with seam-carving
-local-contrast geometry
enhance local contrast
-mean-shift geometry delineate arbitrarily shaped clusters in the image
-median geometry apply a median filter to the image
-mode geometry make each pixel the 'predominant color' of the
neighborhood
-modulate value vary the brightness, saturation, and hue
-monochrome transform image to black and white
-morphology method kernel
apply a morphology method to the image
-motion-blur geometry
simulate motion blur
-negate replace every pixel with its complementary color
-noise geometry add or reduce noise in an image
-normalize transform image to span the full range of colors
-opaque color change this color to the fill color
-ordered-dither NxN
add a noise pattern to the image with specific
amplitudes
-paint radius simulate an oil painting
-perceptible epsilon
pixel value less than |epsilon| become epsilon or
-epsilon
-polaroid angle simulate a Polaroid picture
-posterize levels reduce the image to a limited number of color levels
-profile filename add, delete, or apply an image profile
-quantize colorspace reduce colors in this colorspace
-raise value lighten/darken image edges to create a 3-D effect
-random-threshold low,high
random threshold the image
-range-threshold values
perform either hard or soft thresholding within some range of values in an image
-region geometry apply options to a portion of the image
-render render vector graphics
-resample geometry change the resolution of an image
-reshape geometry reshape the image
-resize geometry resize the image
-roll geometry roll an image vertically or horizontally
-rotate degrees apply Paeth rotation to the image
-rotational-blur angle
rotational blur the image
-sample geometry scale image with pixel sampling
-scale geometry scale the image
-segment values segment an image
-selective-blur geometry
selectively blur pixels within a contrast threshold
-sepia-tone threshold
simulate a sepia-toned photo
-set property value set an image property
-shade degrees shade the image using a distant light source
-shadow geometry simulate an image shadow
-sharpen geometry sharpen the image
-shave geometry shave pixels from the image edges
-shuffle strategy reorders the sequence of images
-shear geometry slide one edge of the image along the X or Y axis
-sigmoidal-contrast geometry
increase the contrast without saturating highlights or
shadows
-sketch geometry simulate a pencil sketch
-solarize threshold negate all pixels above the threshold level
-sort-pixels sort each scanline in ascending order of intensity
-sparse-color method args
fill in a image based on a few color points
-splice geometry splice the background color into the image
-spread radius displace image pixels by a random amount
-statistic type geometry
replace each pixel with corresponding statistic from the
neighborhood
-strip strip image of all profiles and comments
-swirl degrees swirl image pixels about the center
-threshold value threshold the image
-thumbnail geometry create a thumbnail of the image
-tile filename tile image when filling a graphic primitive
-tint value tint the image with the fill color
-transform affine transform image
-transparent color make this color transparent within the image
-transpose flip image vertically and rotate 90 degrees
-transverse flop image horizontally and rotate 270 degrees
-trim trim image edges
-type type image type
-unique-colors discard all but one of any pixel color
-unsharp geometry sharpen the image
-vignette geometry soften the edges of the image in vignette style
-wave geometry alter an image along a sine wave
-wavelet-denoise threshold
removes noise from the image using a wavelet transform
-white-balance automagically adjust white balance of image
-white-threshold value
force all pixels above the threshold into white
Image Channel Operators:
-channel-fx expression
exchange, extract, or transfer one or more image channels
-separate separate an image channel into a grayscale image
Image Sequence Operators:
-append append an image sequence
-clut apply a color lookup table to the image
-coalesce merge a sequence of images
-combine combine a sequence of images
-compare mathematically and visually annotate the difference between an image and its reconstruction
-complex operator perform complex mathematics on an image sequence
-composite composite image
-copy geometry offset
copy pixels from one area of an image to another
-crop geometry cut out a rectangular region of the image
-deconstruct break down an image sequence into constituent parts
-evaluate-sequence operator
evaluate an arithmetic, relational, or logical expression
-flatten flatten a sequence of images
-fx expression apply mathematical expression to an image channel(s)
-hald-clut apply a Hald color lookup table to the image
-layers method optimize, merge, or compare image layers
-morph value morph an image sequence
-mosaic create a mosaic from an image sequence
-poly terms build a polynomial from the image sequence and the corresponding
terms (coefficients and degree pairs).
-print string interpret string and print to console
-process arguments process the image with a custom image filter
-smush geometry smush an image sequence together
-write filename write images to this file
Image Stack Operators:
-clone indexes clone an image
-delete indexes delete the image from the image sequence
-duplicate count,indexes
duplicate an image one or more times
-insert index insert last image into the image sequence
-reverse reverse image sequence
-swap indexes swap two images in the image sequence
Miscellaneous Options:
-debug events display copious debugging information
-distribute-cache port
distributed pixel cache spanning one or more servers
-help print program options
-list type print a list of supported option arguments
-log format format of debugging information
-version print version information
By default, the image format of 'file' is determined by its magic
number. To specify a particular image format, precede the filename
with an image format name and a colon (i.e. ps:image) or specify the
image type as the filename suffix (i.e. image.ps). Specify 'file' as
'-' for standard input or output.
Options (247)
| Option | Description | Source |
|---|---|---|
-adjoin | join images into a single multi-image file | help |
-affine matrix | affine transform matrix | help |
-alpha option | activate, deactivate, reset, or set the alpha channel | help |
-antialias | remove pixel-aliasing | help |
-authenticate password | decipher image with this password | help |
-attenuate value | lessen (or intensify) when adding noise to an image | help |
-background color | background color | help |
-bias value | add bias when convolving an image | help |
-black-point-compensation | use black point compensation | help |
-blue-primary point | chromaticity blue primary point | help |
-bordercolor color | border color | help |
-caption string | assign a caption to an image | help |
-clip | clip along the first path from the 8BIM profile | help |
-clip-mask filename | associate a clip mask with the image | help |
-clip-path id | clip along a named path from the 8BIM profile | help |
-colorspace type | alternate image colorspace | help |
-comment string | annotate image with comment | help |
-compose operator | set image composite operator | help |
-compress type | type of pixel compression when writing the image | help |
-define format:option | define one or more image format options | help |
-delay value | display the next image after pausing | help |
-density geometry | horizontal and vertical density of the image | help |
-depth value | image depth | help |
-direction type | render text right-to-left or left-to-right | help |
-display server | get image or font from this X server | help |
-dispose method | layer disposal method | help |
-dither method | apply error diffusion to image | help |
-encoding type | text encoding type | help |
-endian type | endianness (MSB or LSB) of the image | help |
-family name | render text with this font family | help |
-features distance | analyze image features (e.g. contrast, correlation) | help |
-fill color | color to use when filling a graphic primitive | help |
-filter type | use this filter when resizing an image | help |
-font name | render text with this font | help |
-format "string" | output formatted image characteristics | help |
-fuzz distance | colors within this distance are considered equal | help |
-gravity type | horizontal and vertical text placement | help |
-illuminant type | reference illuminant | help |
-intensity method | method to generate an intensity value from a pixel | help |
-intent type | type of rendering intent when managing the image color | help |
-interlace type | type of image interlacing scheme | help |
-interline-spacing value | set the space between two text lines | help |
-interpolate method | pixel color interpolation method | help |
-interword-spacing value | set the space between two words | help |
-kerning value | set the space between two letters | help |
-label string | assign a label to an image | help |
-limit type | pixel cache resource limit | help |
-loop iterations | add Netscape loop extension to your GIF animation | help |
-matte | store matte channel if the image has one | help |
-mattecolor color | frame color | help |
-moments | report image moments | help |
-monitor | monitor progress | help |
-orient type | image orientation | help |
-page geometry | size and location of an image canvas (setting) | help |
-ping | efficiently determine image attributes | help |
-pointsize value | font point size | help |
-precision value | maximum number of significant digits to print | help |
-preview type | image preview type | help |
-quality value | JPEG/MIFF/PNG compression level | help |
-quiet | suppress all warning messages | help |
-read-mask filename | associate a read mask with the image | help |
-red-primary point | chromaticity red primary point | help |
-regard-warnings | pay attention to warning messages | help |
-remap filename | transform image colors to match this set of colors | help |
-repage geometry | size and location of an image canvas | help |
-sampling-factor geometry | horizontal and vertical sampling factor | help |
-scene value | image scene number | help |
-seed value | seed a new sequence of pseudo-random numbers | help |
-size geometry | width and height of image | help |
-stretch type | render text with this font stretch | help |
-stroke color | graphic primitive stroke color | help |
-strokewidth value | graphic primitive stroke width | help |
-style type | render text with this font style | help |
-support factor | resize support: > 1.0 is blurry, < 1.0 is sharp | help |
-synchronize | synchronize image to storage device | help |
-taint | declare the image as modified | help |
-texture filename | name of texture to tile onto the image background | help |
-tile-offset geometry | tile offset | help |
-treedepth value | color tree depth | help |
-transparent-color color | transparent color | help |
-undercolor color | annotation bounding box color | help |
-units type | the units of image resolution | help |
-verbose | print detailed information about the image | help |
-view | FlashPix viewing transforms | help |
-virtual-pixel method | virtual pixel access method | help |
-weight type | render text with this font weight | help |
-white-point point | chromaticity white point | help |
-write-mask filename | -word-break type sets whether line breaks appear wherever the text would otherwise overflow | help |
-adaptive-blur geometry | adaptively blur pixels; | help |
-adaptive-resize geometry | adaptively resize image using 'mesh' interpolation | help |
-adaptive-sharpen geometry | adaptively sharpen pixels; | help |
-auto-gamma | automagically adjust gamma level of image | help |
-auto-level | automagically adjust color levels of image | help |
-auto-orient | automagically orient (rotate) image | help |
-auto-threshold method | automatically perform image thresholding | help |
-bench iterations | measure performance | help |
-bilateral-blur geometry | non-linear, edge-preserving, and noise-reducing smoothing filter | help |
-black-threshold value | force all pixels below the threshold into black | help |
-blue-shift factor | simulate a scene at nighttime in the moonlight | help |
-blur geometry | reduce image noise and reduce detail levels | help |
-border geometry | surround image with a border of color | help |
-brightness-contrast geometry | improve brightness / contrast of the image | help |
-canny geometry | detect edges in the image | help |
-cdl filename | color correct with a color decision list | help |
-channel mask | set the image channel mask | help |
-charcoal radius | simulate a charcoal drawing | help |
-chop geometry | remove pixels from the image interior | help |
-clahe geometry | contrast limited adaptive histogram equalization | help |
-clamp | keep pixel values in range (0-QuantumRange) | help |
-colorize value | colorize the image with the fill color | help |
-colors value | preferred number of colors in the image | help |
-connected-components connectivity | connected-components uniquely labeled | help |
-contrast | enhance or reduce the image contrast | help |
-contrast-stretch geometry | improve contrast by 'stretching' the intensity range | help |
-convolve coefficients | apply a convolution kernel to the image | help |
-cycle amount | cycle the image colormap | help |
-decipher filename | convert cipher pixels to plain pixels | help |
-deskew threshold | straighten an image | help |
-despeckle | reduce the speckles within an image | help |
-draw string | annotate the image with a graphic primitive | help |
-edge radius | apply a filter to detect edges in the image | help |
-encipher filename | convert plain pixels to cipher pixels | help |
-emboss radius | emboss an image | help |
-enhance | apply a digital filter to enhance a noisy image | help |
-equalize | perform histogram equalization to an image | help |
-extent geometry | set the image size | help |
-extract geometry | extract area from image | help |
-fft | implements the discrete Fourier transform (DFT) | help |
-flip | flip image vertically | help |
-flop | flop image horizontally | help |
-frame geometry | surround image with an ornamental border | help |
-gamma value | level of gamma correction | help |
-gaussian-blur geometry | reduce image noise and reduce detail levels | help |
-geometry geometry | preferred size or location of the image | help |
-grayscale method | convert image to grayscale | help |
-hough-lines geometry | identify lines in the image | help |
-identify | identify the format and characteristics of the image | help |
-ift | implements the inverse discrete Fourier transform (DFT) | help |
-implode amount | implode image pixels about the center | help |
-integral | calculate the sum of values (pixel values) in the image | help |
-interpolative-resize geometry | resize image using interpolation | help |
-kmeans geometry | K means color reduction | help |
-kuwahara geometry | edge preserving noise reduction filter | help |
-lat geometry | local adaptive thresholding | help |
-level value | adjust the level of image contrast | help |
-level-colors color | level image with the given colors | help |
-linear-stretch geometry | improve contrast by 'stretching with saturation' | help |
-liquid-rescale geometry | rescale image with seam-carving | help |
-local-contrast geometry | enhance local contrast | help |
-median geometry | apply a median filter to the image | help |
-mode geometry | make each pixel the 'predominant color' of the neighborhood | help |
-modulate value | vary the brightness, saturation, and hue | help |
-monochrome | transform image to black and white | help |
-motion-blur geometry | simulate motion blur | help |
-negate | replace every pixel with its complementary color | help |
-noise geometry | add or reduce noise in an image | help |
-normalize | transform image to span the full range of colors | help |
-opaque color | change this color to the fill color | help |
-ordered-dither NxN | add a noise pattern to the image with specific amplitudes | help |
-paint radius | simulate an oil painting | help |
-perceptible epsilon | pixel value less than |epsilon| become epsilon or | help |
-polaroid angle | simulate a Polaroid picture | help |
-posterize levels | reduce the image to a limited number of color levels | help |
-profile filename | add, delete, or apply an image profile | help |
-raise value | lighten/darken image edges to create a 3-D effect | help |
-random-threshold low | random threshold the image | help |
-range-threshold values | perform either hard or soft thresholding within some range of values in an image | help |
-region geometry | apply options to a portion of the image | help |
-render | render vector graphics | help |
-resample geometry | change the resolution of an image | help |
-reshape geometry | reshape the image | help |
-resize geometry | resize the image | help |
-roll geometry | roll an image vertically or horizontally | help |
-rotate degrees | apply Paeth rotation to the image | help |
-rotational-blur angle | rotational blur the image | help |
-sample geometry | scale image with pixel sampling | help |
-scale geometry | scale the image | help |
-segment values | segment an image | help |
-selective-blur geometry | selectively blur pixels within a contrast threshold | help |
-sepia-tone threshold | simulate a sepia-toned photo | help |
-set property | set an image property | help |
-shade degrees | shade the image using a distant light source | help |
-shadow geometry | simulate an image shadow | help |
-sharpen geometry | sharpen the image | help |
-shave geometry | shave pixels from the image edges | help |
-shuffle strategy | reorders the sequence of images | help |
-shear geometry | slide one edge of the image along the X or Y axis | help |
-sigmoidal-contrast geometry | increase the contrast without saturating highlights or shadows | help |
-sketch geometry | simulate a pencil sketch | help |
-solarize threshold | negate all pixels above the threshold level | help |
-sort-pixels | sort each scanline in ascending order of intensity | help |
-splice geometry | splice the background color into the image | help |
-spread radius | displace image pixels by a random amount | help |
-strip | strip image of all profiles and comments | help |
-swirl degrees | swirl image pixels about the center | help |
-threshold value | threshold the image | help |
-thumbnail geometry | create a thumbnail of the image | help |
-tile filename | tile image when filling a graphic primitive | help |
-tint value | tint the image with the fill color | help |
-transform | affine transform image | help |
-transparent color | make this color transparent within the image | help |
-transpose | flip image vertically and rotate 90 degrees | help |
-transverse | flop image horizontally and rotate 270 degrees | help |
-trim | trim image edges | help |
-type type | image type | help |
-unique-colors | discard all but one of any pixel color | help |
-unsharp geometry | sharpen the image | help |
-vignette geometry | soften the edges of the image in vignette style | help |
-wave geometry | alter an image along a sine wave | help |
-wavelet-denoise threshold | removes noise from the image using a wavelet transform | help |
-white-balance | automagically adjust white balance of image | help |
-white-threshold value | force all pixels above the threshold into white | help |
-channel-fx expression | exchange, extract, or transfer one or more image channels | help |
-separate | separate an image channel into a grayscale image | help |
-append | append an image sequence | help |
-clut | apply a color lookup table to the image | help |
-coalesce | merge a sequence of images | help |
-combine | combine a sequence of images | help |
-compare | mathematically and visually annotate the difference between an image and its reconstruction | help |
-complex operator | perform complex mathematics on an image sequence | help |
-composite | composite image | help |
-crop geometry | cut out a rectangular region of the image | help |
-deconstruct | break down an image sequence into constituent parts | help |
-evaluate-sequence operator | evaluate an arithmetic, relational, or logical expression | help |
-flatten | flatten a sequence of images | help |
-fx expression | apply mathematical expression to an image channel(s) | help |
-hald-clut | apply a Hald color lookup table to the image | help |
-layers method | optimize, merge, or compare image layers | help |
-morph value | morph an image sequence | help |
-mosaic | create a mosaic from an image sequence | help |
-poly terms | build a polynomial from the image sequence and the corresponding terms (coefficients and degree pairs). | help |
-print string | interpret string and print to console | help |
-process arguments | process the image with a custom image filter | help |
-smush geometry | smush an image sequence together | help |
-write filename | write images to this file | help |
-clone indexes | clone an image | help |
-delete indexes | delete the image from the image sequence | help |
-duplicate count | duplicate an image one or more times | help |
-insert index | insert last image into the image sequence | help |
-reverse | reverse image sequence | help |
-swap indexes | swap two images in the image sequence | help |
-debug events | display copious debugging information | help |
-distribute-cache port | distributed pixel cache spanning one or more servers | help |
-help | print program options | help |
-list type | print a list of supported option arguments | help |
-log format | format of debugging information | help |
-version | print version information | help |