Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

display (1)

Name

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

Synopsis

display [options] input-file

Description

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


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+-------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE   |
       +---------------+-------------------+
       |Availability   | image/imagemagick |
       +---------------+-------------------+
       |Stability      | Volatile          |
       +---------------+-------------------+
SEE ALSO
       ImageMagick(1)


COPYRIGHT
       Copyright (C) 1999-2019 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



NOTES
       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source    was   downloaded   from    https://www.imagemagick.org//down-
       load/ImageMagick-6.9.10-34.tar.gz

       Further information about this software can be found on the open source
       community website at https://www.imagemagick.org/.



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