---
name: "display-im6"
section: "1"
platform: "linux"
package: "imagemagick"
version: "8:6.8.9.9-5+deb8u12"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/display-im6"
---

# display-im6(1)

displays an image or image sequence on any X server.

## 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)](/ImageMagick/1.md) 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://www.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 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:\
   \-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, -borderwidth, -font, -foreground, -iconGeometry, -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

## SEE ALSO

[ImageMagick(1)](/ImageMagick/1.md)

## COPYRIGHT

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