man pages section 1: User Commands

Exit Print View

Updated: July 2014

display (1)


display - displays an image or image sequence on any X server.


display [options] input-file


User Commands                                          display(1)

     display  -  displays  an  image  or  image sequence on any X

     display [options] input-file

     The display program is a member of the ImageMagick(1)  suite
     of  tools.   Use it to display an image or image sequence on
     any X server.

     For more information about the display command,  point  your
     browser  to file:///usr/share/doc/ImageMagick-6.8.3/www/dis-
     play.html or

     Image Settings:
       -antialias           remove pixel-aliasing
       -authenticate value  decrypt image with this password
       -backdrop            display image centered on a backdrop
       -channel type        apply option to select image channels
       -colormap type       Shared or Private
       -colorspace type     alternate image colorspace
       -comment string      annotate image with comment
       -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
       -delay value         display the next image after pausing
       -density  geometry     horizontal  and vertical density of
     the image
       -depth value         image depth
       -display server      display image to this X server
       -dispose method      layer disposal method
       -dither method       apply error diffusion to image
       -endian type         endianness (MSB or LSB) of the image
       -equalize            perform histogram equalization to  an
       -filter  type          use  this  filter  when resizing an
       -format "string"     output formatted  image  characteris-
       -fuzz  distance       colors within this distance are con-
     sidered equal
       -geometry geometry   preferred size and  location  of  the
     Image window
       -gravity  type         horizontal  and  vertical  backdrop
       -identify               identify    the     format     and

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

User Commands                                          display(1)

     characteristics of the image
       -immutable           displayed image cannot be modified
       -interlace type      type of image interlacing scheme
       -interpolate method  pixel color interpolation method
       -label string        assign a label to an image
       -limit type value    pixel cache resource limit
       -loop iterations     loop images then exit
       -map  type             display  image  using this Standard
       -matte               store matte channel if the image  has
       -monitor             monitor progress
       -page geometry       size and location of an image canvas
       -profile  filename     add, delete, or apply an image pro-
       -quality value       JPEG/MIFF/PNG compression level
       -quantize colorspace reduce colors in this colorspace
       -quiet               suppress all warning messages
       -regard-warnings     pay attention to warning messages
       -remote command      execute a command in an  remote  dis-
     play process
       -repage  geometry     size and location of an image canvas
       -sampling-factor geometry
                            horizontal and vertical sampling fac-
       -scenes range        image scene range
       -seed  value          seed a new sequence of pseudo-random
       -set property value  set an image property
       -size geometry       width and height of image
       -support factor      resize support: > 1.0  is  blurry,  <
     1.0 is sharp
       -texture  filename     name  of  texture  to tile onto the
     image background
       -transparent-color color
                            transparent color
       -treedepth value     color tree depth
       -update seconds      detect when image  file  is  modified
     and redisplay
       -verbose              print detailed information about the
       -visual type         display image using this visual type
       -virtual-pixel method
                            virtual pixel access method
       -window id           display image to background  of  this
       -window-group  id      exit program when this window id is
       -write filename      write image to a file

     Image Operators:

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

User Commands                                          display(1)

       -auto-orient         automatically orient image
       -border geometry     surround image with a border of color
       -clip                 clip  along  the first path from the
     8BIM profile
       -clip-path id        clip along a named path from the 8BIM
       -colors  value         preferred  number  of colors in the
       -contrast            enhance or reduce the image contrast
       -crop geometry       preferred size and  location  of  the
     cropped image
       -despeckle           reduce the speckles within an image
       -edge factor         apply a filter to detect edges in the
       -enhance             apply a digital filter to  enhance  a
     noisy image
       -extract geometry    extract area from image
       -flip                flip image in the vertical direction
       -flop                 flop  image in the horizontal direc-
       -frame geometry      surround  image  with  an  ornamental
       -gamma value         level of gamma correction
       -monochrome          transform image to black and white
       -negate               replace  each pixel with its comple-
     mentary color
       -raise value         lighten/darken image edges to  create
     a 3-D effect
       -resample geometry   change the resolution of an image
       -resize geometry     resize the image
       -roll  geometry       roll an image vertically or horizon-
       -rotate degrees      apply Paeth rotation to the image
       -sample geometry     scale image with pixel sampling
       -segment value       segment an image
       -sharpen geometry    sharpen the image
       -strip               strip image of all profiles and  com-
       -trim                trim image edges

     Image Sequence Operators:
       -coalesce            merge a sequence of images
       -flatten             flatten a sequence of images

     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
       -version             print version information

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

User Commands                                          display(1)

     In  addition  to  those  listed above, you can specify these
     standard X resources as command line options:   -background,
     -bordercolor,  -borderwidth, -font, -foreground, -iconGeome-
     try,   -iconic,    -mattecolor,    -name,    -shared-memory,
     -usePixmap, or -title.

     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.   Specify 'file' as '-' for standard input
     or output.

       1    press to map or unmap the Command widget
       2    press and drag to magnify a region of an image
       3    press to load an image from a visual image directory

     The display program defaults to the X screen resolution.  To
     display  vector formats at their intended size, override the
     default resolution:

       display -density 72 drawing.svg

     See  attributes(5)  for  descriptions   of   the   following

     |Availability   | image/imagemagick |
     |Stability      | Volatile          |

     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

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

User Commands                                          display(1)

     community  source  was  downloaded  from   http://image_mag-

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

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