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