man pages section 1: User Commands

Exit Print View

Updated: July 2014
 
 

display (1)

Name

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

Synopsis

display [options] input-file

Description




User Commands                                          display(1)



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

SYNOPSIS
     display [options] input-file

OVERVIEW
     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  http://www.imagemagick.org/script/display.php.

DESCRIPTION
     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
     options
       -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
     image
       -filter  type          use  this  filter  when resizing an
     image
       -format "string"     output formatted  image  characteris-
     tics
       -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
     placement
       -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
     Colormap
       -matte               store matte channel if the image  has
     one
       -monitor             monitor progress
       -page geometry       size and location of an image canvas
       -profile  filename     add, delete, or apply an image pro-
     file
       -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
     (operator)
       -sampling-factor geometry
                            horizontal and vertical sampling fac-
     tor
       -scenes range        image scene range
       -seed  value          seed a new sequence of pseudo-random
     numbers
       -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
     image
       -visual type         display image using this visual type
       -virtual-pixel method
                            virtual pixel access method
       -window id           display image to background  of  this
     window
       -window-group  id      exit program when this window id is
     destroyed
       -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
     profile
       -colors  value         preferred  number  of colors in the
     image
       -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
     image
       -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-
     tion
       -frame geometry      surround  image  with  an  ornamental
     border
       -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-
     tally
       -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-
     ments
       -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
     arguments
       -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.  image.ps).   Specify 'file' as '-' for standard input
     or output.

     Buttons:
       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

NOTE
     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


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



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






User Commands                                          display(1)



     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            5