granicus.if.org Git - imagemagick/blob - utilities/display.1

   1 .TH display 1 "Date: 2009/01/10 01:00:00" "ImageMagick"
   2 .SH NAME
   3 display \- displays an image or image sequence on any X server.
   4 .SH SYNOPSIS
   5 .TP
   6 \fBdisplay\fP [\fIoptions\fP] \fIinput-file\fP
   7 .SH OVERVIEW
   8 The \fBdisplay\fP program is a member of the ImageMagick(1) suite of tools.  Use it to display an image or image sequence on any X server.
   9
  10 For more information about the display command, point your browser to file:///usr/local/share/doc/ImageMagick-7.0.0/www/display.html or http://www.imagemagick.org/script/display.php.
  11 .SH DESCRIPTION
  12 Image Settings:
  13   \-antialias           remove pixel-aliasing
  14   \-authenticate value  decrypt image with this password
  15   \-backdrop            display image centered on a backdrop
  16   \-channel type        apply option to select image channels
  17   \-colormap type       Shared or Private
  18   \-colorspace type     alternate image colorspace
  19   \-comment string      annotate image with comment
  20   \-compress type       type of pixel compression when writing the image
  21   \-decipher filename   convert cipher pixels to plain pixels
  22   \-define format:option
  23                        define one or more image format options
  24   \-delay value         display the next image after pausing
  25   \-density geometry    horizontal and vertical density of the image
  26   \-depth value         image depth
  27   \-display server      display image to this X server
  28   \-dispose method      layer disposal method
  29   \-dither method       apply error diffusion to image
  30   \-endian type         endianness (MSB or LSB) of the image
  31   \-equalize            perform histogram equalization to an image
  32   \-filter type         use this filter when resizing an image
  33   \-format "string"     output formatted image characteristics
  34   \-fuzz distance       colors within this distance are considered equal
  35   \-geometry geometry   preferred size and location of the Image window
  36   \-gravity type        horizontal and vertical backdrop placement
  37   \-identify            identify the format and characteristics of the image
  38   \-immutable           displayed image cannot be modified
  39   \-interlace type      type of image interlacing scheme
  40   \-interpolate method  pixel color interpolation method
  41   \-label string        assign a label to an image
  42   \-limit type value    pixel cache resource limit
  43   \-loop iterations     loop images then exit
  44   \-map type            display image using this Standard Colormap
  45   \-matte               store matte channel if the image has one
  46   \-monitor             monitor progress
  47   \-page geometry       size and location of an image canvas
  48   \-profile filename    add, delete, or apply an image profile
  49   \-quality value       JPEG/MIFF/PNG compression level
  50   \-quantize colorspace reduce colors in this colorspace
  51   \-quiet               suppress all warning messages
  52   \-regard-warnings     pay attention to warning messages
  53   \-remote command      execute a command in an remote display process
  54   \-repage geometry     size and location of an image canvas (operator)
  55   \-sampling-factor geometry
  56                        horizontal and vertical sampling factor
  57   \-scenes range        image scene range
  58   \-seed value          seed a new sequence of pseudo-random numbers
  59   \-set property value  set an image property
  60   \-size geometry       width and height of image
  61   \-support factor      resize support: > 1.0 is blurry, < 1.0 is sharp
  62   \-texture filename    name of texture to tile onto the image background
  63   \-transparent-color color
  64                        transparent color
  65   \-treedepth value     color tree depth
  66   \-update seconds      detect when image file is modified and redisplay
  67   \-verbose             print detailed information about the image
  68   \-visual type         display image using this visual type
  69   \-virtual-pixel method
  70                        virtual pixel access method
  71   \-window id           display image to background of this window
  72   \-window-group id     exit program when this window id is destroyed
  73   \-write filename      write image to a file
  74
  75 Image Operators:
  76   \-auto-orient         automatically orient image
  77   \-border geometry     surround image with a border of color
  78   \-clip                clip along the first path from the 8BIM profile
  79   \-clip-path id        clip along a named path from the 8BIM profile
  80   \-colors value        preferred number of colors in the image
  81   \-contrast            enhance or reduce the image contrast
  82   \-crop geometry       preferred size and location of the cropped image
  83   \-despeckle           reduce the speckles within an image
  84   \-edge factor         apply a filter to detect edges in the image
  85   \-enhance             apply a digital filter to enhance a noisy image
  86   \-extract geometry    extract area from image
  87   \-flip                flip image in the vertical direction
  88   \-flop                flop image in the horizontal direction
  89   \-frame geometry      surround image with an ornamental border
  90   \-gamma value         level of gamma correction
  91   \-monochrome          transform image to black and white
  92   \-negate              replace each pixel with its complementary color
  93   \-raise value         lighten/darken image edges to create a 3-D effect
  94   \-resample geometry   change the resolution of an image
  95   \-resize geometry     resize the image
  96   \-roll geometry       roll an image vertically or horizontally
  97   \-rotate degrees      apply Paeth rotation to the image
  98   \-sample geometry     scale image with pixel sampling
  99   \-segment value       segment an image
 100   \-sharpen geometry    sharpen the image
 101   \-strip               strip image of all profiles and comments
 102   \-trim                trim image edges
 103
 104 Image Sequence Operators:
 105   \-coalesce            merge a sequence of images
 106   \-flatten             flatten a sequence of images
 107
 108 Miscellaneous Options:
 109   \-debug events        display copious debugging information
 110   \-help                print program options
 111   \-log format          format of debugging information
 112   \-list type           print a list of supported option arguments
 113   \-version             print version information
 114
 115 In addition to those listed above, you can specify these standard X resources as command line options:  \-background, \-bordercolor, \-borderwidth, \-font, \-foreground, \-iconGeometry, \-iconic, \-mattecolor, \-name, \-shared-memory, \-usePixmap, or \-title.
 116
 117 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.
 118
 119 Buttons:
 120   1    press to map or unmap the Command widget
 121   2    press and drag to magnify a region of an image
 122   3    press to load an image from a visual image directory
 123 .SH NOTE
 124 The display program defaults to the X screen resolution.  To display vector formats at their intended size, override the default resolution:
 125
 126   display -density 72 drawing.svg
 127 .SH SEE ALSO
 128 ImageMagick(1)
 129
 130 .SH COPYRIGHT
 131
 132 \fBCopyright (C) 1999-2013 ImageMagick Studio LLC. Additional copyrights and licenses apply to this software, see file:///usr/local/share/doc/ImageMagick-7.0.0/www/license.html or http://www.imagemagick.org/script/license.php\fP