man pages section 1: User Commands

Exit Print View

Updated: July 2014

ImageMagick (1)


ImageMagick - is a free software suite for the creation, modification and display of bitmap images.


convert input-file [options] output-file


User Commands                                      ImageMagick(1)

     ImageMagick  -  is  a  free software suite for the creation,
     modification and display of bitmap images.

     convert input-file [options] output-file

     ImageMagick[rg], is a software suite to  create,  edit,  and
     compose bitmap images. It can read, convert and write images
     in a variety of formats (about  100)  including  GIF,  JPEG,
     JPEG-2000, PNG, PDF, PhotoCD, TIFF, and DPX. Use ImageMagick
     to translate, flip, mirror, rotate, scale, shear and  trans-
     form  images,  adjust  image  colors,  apply various special
     effects,  or  draw  text,  lines,  polygons,  ellipses   and
     B\['e]zier curves.

     ImageMagick  is  free  software  delivered as a ready-to-run
     binary distribution or as source code that  you  can  freely
     use, copy, modify, and distribute. Its license is compatible
     with the GPL. It runs on all major operating systems.

     The functionality of ImageMagick is typically utilized  from
     the  command  line or you can use the features from programs
     written in your favorite programming language.  Choose  from
     these  interfaces:  MagickCore (C), MagickWand (C), ChMagick
     (Ch), Magick++ (C++), JMagick (Java), L-Magick (Lisp),  Pas-
     calMagick  (Pascal),  PerlMagick  (Perl), MagickWand for PHP
     (PHP), PythonMagick (Python), RMagick (Ruby),  or  TclMagick
     (Tcl/TK). With a language interface, use ImageMagick to mod-
     ify or create images automagically and dynamically.

     ImageMagick includes a number of command-line utilities  for
     manipulating  images.  Most  of you are probably accustom to
     editing images one at a time with a graphical user interface
     (GUI)  with  such  programs as gimp or Photoshop. However, a
     GUI is not always convenient. Suppose you want to process an
     image dynamically from a web script or you want to apply the
     same operations to many images or repeat a  specific  opera-
     tion  at different times to the same or different image. For
     these types of operations, the command-line image processing
     utility is appropriate.

     In  the  paragraphs below, find a short description for each
     command-line tool.Cl ick on the program name to get  details
     on  the  program  usage  and a list of comman d-line options
     that alters how the program performs. If you are  just  get-
     ting  acq  uainted with ImageMagick, start at the top of the
     list, the convert program, and
      work  your  way  down.  Also  be  sure  to  peruse  Anthony
     Thyssen's tutorial on how to
      use  ImageMagick  utilities  to  convert,  compose, or edit

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

User Commands                                      ImageMagick(1)

     images from the command- line.


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


          describes the format and characteristics of one or more
          image files.


          resize  an  image,  blur, crop, despeckle, dither, draw
          on, flip, join, re-sample, and much more. Mogrify over-
          writes the original image file, whereas, convert writes
          to a different image file.


          overlaps one image over another.


          create a composite image by combining several  separate
          images.  The  images  are  tiled on the composite image
          optionally adorned with a border,  frame,  image  name,
          and more.


          mathematically  and  visually  annotate  the difference
          between an image and its reconstruction..


          is a lightweight tool to stream one or more pixel  com-
          ponents  of  the  image or portion of the image to your
          choice of storage formats. It writes the  pixel  compo-
          nents  as they are read from the input image a row at a
          time making stream desirable when  working  with  large
          images or when you require raw pixel components.


          displays an image or image sequence on any X server.


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

User Commands                                      ImageMagick(1)

          animates an image sequence on any X server.


          saves  any visible window on an X server and outputs it
          as an image file. You can capture a single window,  the
          entire  screen,  or  any  rectangular  portion  of  the


          interprets and executes scripts written in  the  Magick
          Scripting Language (MSL).

     For  more  information  about  the  ImageMagick,  point your
     browser          to          file:///usr/share/doc/ImageMag-
     ick-6.8.3/index.html or

     See   attributes(5)   for   descriptions  of  the  following

     |Availability   | image/imagemagick |
     |Stability      | Volatile          |
     convert(1),  identify(1),  composite(1),  montage(1),   com-
     pare(1),   display(1),  animate(1),  import(1),  conjure(1),
     quantize(5), miff(4)

     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

     This   software   was   built   from   source  available  at   The   original
     community  source  was  downloaded  from   http://image_mag-

     Further information about this software can be found on  the
     open        source        community        website        at

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

User Commands                                      ImageMagick(1)

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