convert



convert(1)                  General Commands Manual                 convert(1)


NAME

       convert - convert between image formats as well as resize an image,
       blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much
       more.


SYNOPSIS

       convert [input-option] input-file [output-option] output-file


OVERVIEW

       The convert program is a member of the ImageMagick(1) suite of tools.
       Use it to convert between image formats as well as resize an image,
       blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much
       more.

       For more information about the convert command, point your browser to
       file:///usr/local/share/doc/ImageMagick/www/convert.html or
       http://www.imagemagick.org/script/convert.php.


DESCRIPTION

       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 value  decrypt 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
         -cdl filename        color correct with a color decision list
         -channel type        apply option to select image channels
         -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
         -colors value        preferred number of colors in the image
         -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
         -decipher filename   convert cipher pixels to plain pixels
         -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
         -encipher filename   convert plain pixels to cipher pixels
         -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
         -flatten             flatten a sequence of images
         -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
         -intensity method    method to generate intensity value from 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
         -mask filename       associate a mask with the image
         -matte               store matte channel if the image has one
         -mattecolor color    frame color
         -metric type         measure differences between images with this
       metric
         -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
         -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
         -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
         -statistic type geometry
                              replace each pixel with corresponding statistic
       from the neighborhood
         -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

       Image Operators:
         -adaptive-blur geometry
                              adaptively blur pixels; decrease effect near
       edges
         -adaptive-resize geometry
                              adaptively resize image with data dependent
       triangulation
         -adaptive-sharpen geometry
                              adaptively sharpen pixels; increase effect near
       edges
         -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         automatically orient image
         -bench iterations    measure performance
         -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
         -brightness-contrast geometry
                              improve brightness / contrast of the image
         -canny geometry      detect edges in the image
         -charcoal radius     simulate a charcoal drawing
         -chop geometry       remove pixels from the image interior
         -clamp               keep pixel values in range (0-QuantumRange)
         -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
         -colorize value      colorize the image with the fill color
         -color-matrix matrix apply color correction to the image
         -connected-component 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
         -deskew threshold    straighten an image
         -despeckle           reduce the speckles within an image
         -distort method args
                              distort images according to given method ad args
         -draw string         annotate the image with a graphic primitive
         -edge radius         apply a filter to detect edges in the image
         -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       apply a function to the image
         -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
         -interpolative-resize geometry
                              resize image using 'point sampled' interpolation
         -lat geometry        local adaptive thresholding
         -layers method       optimize or compare image layers
         -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'
       the intensity range
         -liquid-rescale geometry
                              rescale image with seam-carving
         -magnify             double the size of the image with pixel art
       scaling
         -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 each 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
         -print string        interpret string and print to console
         -profile filename    add, delete, or apply an image profile
         -quantize colorspace reduce colors in this colorspace
         -radial-blur angle   radial blur the image
         -raise value         lighten/darken image edges to create a 3-D
       effect
         -random-threshold low,high
                              random threshold the image
         -region geometry     apply options to a portion of the image
         -render              render vector graphics
         -repage geometry     size and location of an image canvas
         -resample geometry   change the resolution of an image
         -resize geometry     resize the image
         -roll geometry       roll an image vertically or horizontally
         -rotate degrees      apply Paeth rotation to 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
         -shear geometry      slide one edge of the image along the X or Y
       axis
         -sigmoidal-contrast geometry
                              lightness rescaling using sigmoidal contrast
       enhancement
         -sketch geometry     simulate a pencil sketch
         -solarize threshold  negate all pixels above the threshold level
         -sparse-color method args
                              fill in a image based on a few color points
         -splice geometry     splice the background color into the image
         -spread amount       displace image pixels by a random amount
         -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
         -white-threshold value
                              force all pixels above the threshold into white

       Image Sequence Operators:
         -append              append an image sequence top to bottom (use
       +append for left to right)
         -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
         -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)
         -process arguments   process the image with a custom image filter
         -separate            separate an image channel into a grayscale image
         -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
         -log format          format of debugging information
         -list type           print a list of supported option arguments
         -version             print version information

       Use any setting or operator as an output-option.  Only a limited number
       of setting are  input-option. They include: -antialias, -caption,
       -density, -define, -encoding, -font, -pointsize, -size, and -texture as
       well as any of the miscellaneous options.

       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.


SEE ALSO

       ImageMagick(1)


COPYRIGHT

       Copyright (C) 1999-2016 ImageMagick Studio LLC. Additional copyrights
       and licenses apply to this software, see
       file:///usr/local/share/doc/ImageMagick/www/license.html or
       http://www.imagemagick.org/script/license.php

ImageMagick                Date: 2009/01/10 01:00:00                convert(1)

[Unix Hosting | Open-Source | Contact Us]
[Engineering & Automation | Software Development | Server Applications]