display(1)		    General Commands Manual		    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/www/display.html		    or
       http://imagemagick.org/script/display.php.

DESCRIPTION
       Image Settings:
	 -alpha option	      on, activate, off, deactivate, set, opaque, copy
			      transparent, extract, background, or shape
	 -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 writing the image
	 -decipher filename   convert cipher pixels to plain pixels
	 -deskew threshold    straighten an image
	 -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 characteristics
	 -fuzz distance	      colors within this distance are considered equal
	 -geometry geometry   preferred size and location of the Image window
	 -gravity type	      horizontal and vertical backdrop placement
	 -identify	      identify the format and 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 profile
	 -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 display process
	 -repage geometry     size and location of an image canvas (operator)
	 -respect-parentheses  settings	 remain	 in  effect  until parenthesis
       boundary
	 -sampling-factor geometry
			      horizontal and vertical sampling factor
	 -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	 back-
       ground
	 -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:
	 -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 direction
	 -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 complementary color
	 -normalize	      transform image to span the full range of colors
	 -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 horizontally
	 -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 comments
	 -threshold value     threshold the image
	 -thumbnail geometry  create a thumbnail of the image
	 -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

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

       By  default, the image format of `file' is determined by its magic num-
       ber.  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

SEE ALSO
       ImageMagick(1)


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



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