man pages section 1: User Commands

Exit Print View

Updated: July 2014
 
 

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

Description




User Commands                                          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/share/doc/ImageMagick-6.8.3/www/con-
     vert.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
       -antialias           remove pixel-aliasing
       -authenticate value  decrypt image with this password
       -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
       -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  writ-
     ing 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-



ImageMagick   Last change: Date: 2009/01/10 01:00:00            1






User Commands                                          convert(1)



     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.  con-
     trast, 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 characteris-
     tics
       -fuzz distance       colors within this distance are  con-
     sidered equal
       -gravity  type         horizontal and vertical text place-
     ment
       -green-primary point chromaticity green primary point
       -intent type         type of rendering intent when  manag-
     ing the image color
       -interlace type      type of image interlacing scheme
       -interpolate method  pixel color interpolation method
       -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
       -monitor             monitor progress
       -orient type         image orientation
       -origin geometry     image origin
       -page  geometry       size and location of an image canvas
     (setting)
       -ping                   efficiently    determine     image
     attributes
       -pointsize value     font point size
       -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
       -sampling-factor geometry
                            horizontal and vertical sampling fac-
     tor



ImageMagick   Last change: Date: 2009/01/10 01:00:00            2






User Commands                                          convert(1)



       -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-orient         automatically orient image
       -black-threshold value
                            force all pixels below the  threshold
     into black
       -blur  geometry       reduce image noise and reduce detail
     levels
       -border geometry     surround image with a border of color
       -charcoal radius     simulate a charcoal drawing



ImageMagick   Last change: Date: 2009/01/10 01:00:00            3






User Commands                                          convert(1)



       -chop geometry       remove pixels from the image interior
       -clamp               keep pixel values in  range  (0-Quan-
     tumRange)
       -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
       -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
       -despeckle           reduce the speckles within an image
       -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
       -identify             identify the format and characteris-
     tics of the image
       -ift                  implements  the   inverse   discrete



ImageMagick   Last change: Date: 2009/01/10 01:00:00            4






User Commands                                          convert(1)



     Fourier transform (DFT)
       -implode amount      implode image pixels about the center
       -lat geometry        local adaptive thresholding
       -layers method       optimize or compare image layers
       -level value         adjust the level of image contrast
       -linear-stretch geometry
                            improve contrast by `stretching  with
     saturation' the intensity range
       -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  comple-
     mentary 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  pro-
     file
       -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 horizon-
     tally



ImageMagick   Last change: Date: 2009/01/10 01:00:00            5






User Commands                                          convert(1)



       -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 con-
     trast 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
       -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 com-
     ments
       -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



ImageMagick   Last change: Date: 2009/01/10 01:00:00            6






User Commands                                          convert(1)



     into white

     Image Sequence Operators:
       -affinity  filename   transform image colors to match this
     set of colors
       -append              append an image sequence top to  bot-
     tom (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
       -composite           composite image
       -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
       -swap indexes        swap two images in the image sequence

     Miscellaneous Options:
       -debug events        display copious debugging information
       -help                print program options
       -log format          format of debugging information
       -list type           print  a  list  of  supported  option



ImageMagick   Last change: Date: 2009/01/10 01:00:00            7






User Commands                                          convert(1)



     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  mis-
     cellaneous 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.


ATTRIBUTES
     See  attributes(5)  for  descriptions   of   the   following
     attributes:

     +---------------+-------------------+
     |ATTRIBUTE TYPE | ATTRIBUTE VALUE   |
     +---------------+-------------------+
     |Availability   | image/imagemagick |
     +---------------+-------------------+
     |Stability      | Volatile          |
     +---------------+-------------------+
SEE ALSO
     ImageMagick(1)


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



NOTES
     This  software  was   built   from   source   available   at
     https://java.net/projects/solaris-userland.    The  original
     community  source  was  downloaded  from   http://image_mag-
     ick.veidrodis.com/image_magick/ImageMagick-6.8.3-5.tar.gz

     Further  information about this software can be found on the
     open  source  community  website   at   http://www.imagemag-
     ick.org/.






ImageMagick   Last change: Date: 2009/01/10 01:00:00            8