OS Manuals

/usr/bin/display

ImageMagick® is a free, open-source software suite, used for editing and manipulating digital images.

From imagemagick-7 7.1.2.35-r0 (os), captured 2026-11-05 by running display -help (exit 0). permalink

Also provided by 1 other package version
Version: ImageMagick 7.1.2-35 Q16-HDRI x86_64 acaf7e418:20261031 https://imagemagick.org
Copyright: (C) 1999 ImageMagick Studio LLC
License: https://imagemagick.org/license/
Features: Cipher DPC HDRI OpenMP
Delegates (built-in): bzlib fontconfig freetype heic jng jp2 jpeg lcms lzma pangocairo png tiff webp x xml zlib zstd
Compiler: gcc (16.2)
Usage: display [options ...] file [ [options ...] file ...]

Image Settings:
  -alpha option        on, activate, off, deactivate, set, opaque, copy
                       transparent, extract, background, or shape
  -antialias           remove pixel-aliasing
  -authenticate password
                       decipher 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
  -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
  -filter type         use this filter when resizing an image
  -format string     output formatted image characteristics
  -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
  -nostdin             do not try to open stdin
  -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-level          automagically adjust color levels of image
  -auto-orient         automagically 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
  -decipher filename   convert cipher pixels to plain pixels
  -deskew threshold    straighten an 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
  -equalize            perform histogram equalization to an image
  -extent geometry     set the image size
  -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
  -fuzz distance       colors within this distance are considered equal
  -gamma value         level of gamma correction
  -monochrome          transform image to black and white
  -negate              replace every 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
  -list type           print a list of supported option arguments
  -log format          format of debugging information
  -version             print version information

In addition to those listed above, you can specify these standard X
resources as command line options:  -background, -bordercolor,
 -mattecolor, -borderwidth, -font, -foreground, -iconGeometry,
-iconic, -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
Options (100)
OptionDescriptionSource
-alpha optionon, activate, off, deactivate, set, opaque, copy transparent, extract, background, or shapehelp
-antialiasremove pixel-aliasinghelp
-authenticate passworddecipher image with this passwordhelp
-backdropdisplay image centered on a backdrophelp
-channel typeapply option to select image channelshelp
-colormap typeShared or Privatehelp
-colorspace typealternate image colorspacehelp
-comment stringannotate image with commenthelp
-compress typetype of pixel compression when writing the imagehelp
-define format:optiondefine one or more image format optionshelp
-delay valuedisplay the next image after pausinghelp
-density geometryhorizontal and vertical density of the imagehelp
-depth valueimage depthhelp
-display serverdisplay image to this X serverhelp
-dispose methodlayer disposal methodhelp
-dither methodapply error diffusion to imagehelp
-endian typeendianness (MSB or LSB) of the imagehelp
-filter typeuse this filter when resizing an imagehelp
-format stringoutput formatted image characteristicshelp
-geometry geometrypreferred size and location of the Image windowhelp
-gravity typehorizontal and vertical backdrop placementhelp
-identifyidentify the format and characteristics of the imagehelp
-immutabledisplayed image cannot be modifiedhelp
-interlace typetype of image interlacing schemehelp
-interpolate methodpixel color interpolation methodhelp
-label stringassign a label to an imagehelp
-limit typepixel cache resource limithelp
-loop iterationsloop images then exithelp
-map typedisplay image using this Standard Colormaphelp
-mattestore matte channel if the image has onehelp
-monitormonitor progresshelp
-nostdindo not try to open stdinhelp
-page geometrysize and location of an image canvashelp
-profile filenameadd, delete, or apply an image profilehelp
-quality valueJPEG/MIFF/PNG compression levelhelp
-quietsuppress all warning messageshelp
-regard-warningspay attention to warning messageshelp
-remote commandexecute a command in an remote display processhelp
-repage geometrysize and location of an image canvas (operator)help
-sampling-factor geometryhorizontal and vertical sampling factorhelp
-scenes rangeimage scene rangehelp
-seed valueseed a new sequence of pseudo-random numbershelp
-set propertyset an image propertyhelp
-size geometrywidth and height of imagehelp
-support factorresize support: > 1.0 is blurry, < 1.0 is sharphelp
-texture filenamename of texture to tile onto the image backgroundhelp
-transparent-color colortransparent colorhelp
-treedepth valuecolor tree depthhelp
-update secondsdetect when image file is modified and redisplayhelp
-verboseprint detailed information about the imagehelp
-visual typedisplay image using this visual typehelp
-virtual-pixel methodvirtual pixel access methodhelp
-window iddisplay image to background of this windowhelp
-window-group idexit program when this window id is destroyedhelp
-write filenamewrite image to a filehelp
-auto-levelautomagically adjust color levels of imagehelp
-auto-orientautomagically orient imagehelp
-border geometrysurround image with a border of colorhelp
-clipclip along the first path from the 8BIM profilehelp
-clip-path idclip along a named path from the 8BIM profilehelp
-colors valuepreferred number of colors in the imagehelp
-contrastenhance or reduce the image contrasthelp
-crop geometrypreferred size and location of the cropped imagehelp
-decipher filenameconvert cipher pixels to plain pixelshelp
-deskew thresholdstraighten an imagehelp
-despecklereduce the speckles within an imagehelp
-edge factorapply a filter to detect edges in the imagehelp
-enhanceapply a digital filter to enhance a noisy imagehelp
-equalizeperform histogram equalization to an imagehelp
-extent geometryset the image sizehelp
-extract geometryextract area from imagehelp
-flipflip image in the vertical directionhelp
-flopflop image in the horizontal directionhelp
-frame geometrysurround image with an ornamental borderhelp
-fuzz distancecolors within this distance are considered equalhelp
-gamma valuelevel of gamma correctionhelp
-monochrometransform image to black and whitehelp
-negatereplace every pixel with its complementary colorhelp
-normalizetransform image to span the full range of colorshelp
-raise valuelighten/darken image edges to create a 3-D effecthelp
-resample geometrychange the resolution of an imagehelp
-resize geometryresize the imagehelp
-roll geometryroll an image vertically or horizontallyhelp
-rotate degreesapply Paeth rotation to the imagehelp
-sample geometryscale image with pixel samplinghelp
-segment valuesegment an imagehelp
-sharpen geometrysharpen the imagehelp
-stripstrip image of all profiles and commentshelp
-threshold valuethreshold the imagehelp
-thumbnail geometrycreate a thumbnail of the imagehelp
-trimtrim image edgeshelp
-coalescemerge a sequence of imageshelp
-flattenflatten a sequence of imageshelp
-debug eventsdisplay copious debugging informationhelp
-helpprint program optionshelp
-list typeprint a list of supported option argumentshelp
-log formatformat of debugging informationhelp
-versionprint version informationhelp
-mattecolor, -borderwidth, -font, -foreground, -iconGeometryhelp
-iconic, -name, -shared-memory, -usePixmap, -titlehelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.