]> granicus.if.org Git - imagemagick/blobdiff - utilities/mogrify.1
https://github.com/ImageMagick/ImageMagick/pull/1325
[imagemagick] / utilities / mogrify.1
index 841504cf85b96817a735d81ec5aa471536d8b699..b8da2d88a6e1b2017bb2e7c499addae68e147563 100644 (file)
@@ -7,13 +7,14 @@ mogrify \- resize an image, blur, crop, despeckle, dither, draw on, flip, join,
 .SH OVERVIEW
 The \fBmogrify\fP program is a member of the ImageMagick(1) suite of tools.  Use it to resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more. This tool is similar to convert(1) except the original image file is overwritten with any changes you request.
 
-For more information about the mogrify command, point your browser to file:///usr/local/share/doc/ImageMagick-6.6.0/www/mogrify.html or http://www.imagemagick.org/script/mogrify.php.
+For more information about the mogrify command, point your browser to file:///usr/local/share/doc/ImageMagick-7/www/mogrify.html or http://imagemagick.org/script/mogrify.php.
 .SH DESCRIPTION
 Image Settings:
   \-adjoin              join images into a single multi-image file
   \-affine matrix       affine transform matrix
   \-antialias           remove pixel-aliasing
   \-authenticate value  decrypt image with this password
+  \-attenuate value     lessen (or intensify) when adding noise to an image
   \-background color    background color
   \-bias value          add bias when convolving an image
   \-black-point-compensation
@@ -22,7 +23,6 @@ Image Settings:
   \-bordercolor color   border color
   \-caption string      assign a caption to an image
   \-cdl filename        color correct with a color decision list
-  \-channel type        apply option to select image channels
   \-colors value        preferred number of colors in the image
   \-colorspace type     alternate image colorspace
   \-comment string      annotate image with comment
@@ -34,6 +34,7 @@ Image Settings:
   \-delay value         display the next image after pausing
   \-density geometry    horizontal and vertical density of the image
   \-depth value         image depth
+  \-direction type      render text right-to-left or left-to-right
   \-display server      get image or font from this X server
   \-dispose method      layer disposal method
   \-dither method       apply error diffusion to image
@@ -41,6 +42,7 @@ Image Settings:
   \-encoding type       text encoding type
   \-endian type         endianness (MSB or LSB) of the image
   \-family name         render text with this font family
+  \-features distance   analyze image features (e.g. contrast, correlation)
   \-fill color          color to use when filling a graphic primitive
   \-filter type         use this filter when resizing an image
   \-flatten             flatten a sequence of images
@@ -50,29 +52,39 @@ Image Settings:
   \-fuzz distance       colors within this distance are considered equal
   \-gravity type        horizontal and vertical text placement
   \-green-primary point chromaticity green primary point
+  \-intensity method    method to generate intensity value from pixel
   \-intent type         type of rendering intent when managing the image color
   \-interlace type      type of image interlacing scheme
+  \-interline-spacing   value set the space between two text lines
   \-interpolate method  pixel color interpolation method
+  \-interword-spacing   value set the space between two words
+  \-kerning value       set the space between two letters
   \-label string        assign a label to an image
   \-limit type value    pixel cache resource limit
   \-loop iterations     add Netscape loop extension to your GIF animation
-  \-mask filename       associate a mask with the image
   \-matte               store matte channel if the image has one
   \-mattecolor color    frame color
+  \-metric type         measure differences between images with this metric
   \-monitor             monitor progress
   \-morphology method kernel
                        apply a morphology method to the image
   \-orient type         image orientation
-  \-origin geometry     image origin
   \-page geometry       size and location of an image canvas (setting)
   \-path path           write images to this path on disk
+  \-perceptible epsilon
+                       pixel value less than |epsilon| become epsilon or -epsilon
   \-ping                efficiently determine image attributes
   \-pointsize value     font point size
+  \-precision value     maximum number of significant digits to print
   \-preview type        image preview type
   \-quality value       JPEG/MIFF/PNG compression level
   \-quiet               suppress all warning messages
+  \-read-mask filename  associate a read mask with the image
   \-red-primary point   chromaticity red primary point
   \-regard-warnings     pay attention to warning messages
+  \-remap filename      transform image colors to match this set of colors
+  \-repage geometry     size and location of an image canvas
+  \-respect-parentheses settings remain in effect until parenthesis boundary
   \-sampling-factor geometry
                        horizontal and vertical sampling factor
   \-scene value         image scene number
@@ -82,7 +94,8 @@ Image Settings:
   \-stroke color        graphic primitive stroke color
   \-strokewidth value   graphic primitive stroke width
   \-style type          render text with this font style
-  \-support factor      resize support: > 1.0 is blurry, < 1.0 is sharp
+  \-synchronize         synchronize image to storage device
+  \-taint               declare the image as modified
   \-texture filename    name of texture to tile onto the image background
   \-tile-offset geometry
                        tile offset
@@ -92,11 +105,11 @@ Image Settings:
   \-undercolor color    annotation bounding box color
   \-units type          the units of image resolution
   \-verbose             print detailed information about the image
-  \-view                FlashPix viewing transforms
   \-virtual-pixel method
                        virtual pixel access method
   \-weight type         render text with this font weight
   \-white-point point   chromaticity white point
+  \-write-mask filename associate a write mask with the image
 
 Image Operators:
   \-adaptive-blur geometry
@@ -105,26 +118,45 @@ Image Operators:
                        adaptively resize image with data dependent triangulation
   \-adaptive-sharpen geometry
                        adaptively sharpen pixels; increase effect near edges
+  \-alpha option        on, activate, off, deactivate, set, opaque, copy
+                       transparent, extract, background, or shape
   \-annotate geometry text
                        annotate the image with text
+  \-auto-gamma          automagically adjust gamma level of image
+  \-auto-level          automagically adjust color levels of image
   \-auto-orient         automatically orient image
+  \-auto-threshold method
+                       automatically perform image thresholding
+  \-bench iterations    measure performance
   \-black-threshold value
                        force all pixels below the threshold into black
+  \-blue-shift          simulate a scene at nighttime in the moonlight
   \-blur geometry       reduce image noise and reduce detail levels
   \-border geometry     surround image with a border of color
+  \-brightness-contrast geometry
+                       improve brightness / contrast of the image
+  \-canny geometry      detect edges in the image
+  \-channel mask        set the image channel mask
   \-charcoal radius     simulate a charcoal drawing
   \-chop geometry       remove pixels from the image interior
+  \-clamp               keep pixel values in range (0-QuantumRange)
   \-clip                clip along the first path from the 8BIM profile
   \-clip-mask filename  associate a clip mask with the image
   \-clip-path id        clip along a named path from the 8BIM profile
   \-colorize value      colorize the image with the fill color
+  \-color-matrix matrix apply color correction to the image
+  \-connected-component connectivity
+                       connected-components uniquely labeled
   \-contrast            enhance or reduce the image contrast
   \-contrast-stretch geometry
                        improve contrast by `stretching' the intensity range
   \-convolve coefficients
                        apply a convolution kernel to the image
   \-cycle amount        cycle the image colormap
+  \-deskew threshold    straighten an image
   \-despeckle           reduce the speckles within an image
+  \-distort method args
+                       distort images according to given method and args
   \-draw string         annotate the image with a graphic primitive
   \-edge radius         apply a filter to detect edges in the image
   \-emboss radius       emboss an image
@@ -144,22 +176,34 @@ Image Operators:
   \-gaussian-blur geometry
                        reduce image noise and reduce detail levels
   \-geometry geometry   preferred size or location of the image
-  \-ift                 implements the inverse discrete Fourier transform (DFT)
+  \-grayscale method    convert image to grayscale
   \-help                print program options
+  \-hough-lines geometry
+                       identify lines in the image
   \-identify            identify the format and characteristics of the image
+  \-ift                 implements the inverse discrete Fourier transform (DFT)
   \-implode amount      implode image pixels about the center
+  \-interpolative-resize geometry
+                       resize image using interpolation
   \-lat geometry        local adaptive thresholding
   \-layers method       optimize or compare image layers
   \-level value         adjust the level of image contrast
+  \-level-colors color,color
+                       level image with the given colors
   \-linear-stretch geometry
                        improve contrast by `stretching with saturation' the intensity range
-  \-median radius       apply a median filter to the image
+  \-liquid-rescale geometry
+                       rescale image with seam-carving
+  \-magnify             double the size of the image with pixel art scaling
+  \-mean-shift geometry delineate arbitrarily shaped clusters in the image
+  \-median geometry     apply a median filter to the image
+  \-mode geometry       make each pixel the 'predominant color' of the neighborhood
   \-modulate value      vary the brightness, saturation, and hue
   \-monochrome          transform image to black and white
   \-motion-blur geometry
                        simulate motion blur
   \-negate              replace each pixel with its complementary color 
-  \-noise radius        add or reduce noise in an image
+  \-noise geometry      add or reduce noise in an image
   \-normalize           transform image to span the full range of colors
   \-opaque color        change this color to the fill color
   \-ordered-dither NxN
@@ -174,10 +218,10 @@ Image Operators:
   \-raise value         lighten/darken image edges to create a 3-D effect
   \-random-threshold low,high
                        random threshold the image
-  \-recolor matrix      translate, scale, shear, or rotate image colors
+  \-range-threshold values
+                       perform either hard or soft thresholding within some range of values in an image
   \-region geometry     apply options to a portion of the image
   \-render              render vector graphics
-  \-repage geometry     size and location of an image canvas
   \-resample geometry   change the resolution of an image
   \-resize geometry     resize the image
   \-roll geometry       roll an image vertically or horizontally
@@ -199,8 +243,12 @@ Image Operators:
                        lightness rescaling using sigmoidal contrast enhancement
   \-sketch geometry     simulate a pencil sketch
   \-solarize threshold  negate all pixels above the threshold level
+  \-sparse-color method args
+                       fill in a image based on a few color points
   \-splice geometry     splice the background color into the image
   \-spread amount       displace image pixels by a random amount
+  \-statistic type geometry
+                       replace each pixel with corresponding statistic from the neighborhood
   \-strip               strip image of all profiles and comments
   \-swirl degrees       swirl image pixels about the center
   \-threshold value     threshold the image
@@ -217,16 +265,27 @@ Image Operators:
   \-unsharp geometry    sharpen the image
   \-vignette geometry   soften the edges of the image in vignette style
   \-wave geometry       alter an image along a sine wave
+  \-wavelet-denoise threshold
+                        removes noise from the image using a wavelet transform
   \-white-threshold value
                        force all pixels above the threshold into white
 
+Image Channel Operators:
+  \-channel-fx expression
+                       exchange, extract, or transfer one or more image channels
+  \-separate            separate an image channel into a grayscale image
+
 Image Sequence Operators:
   \-affinity filename   transform image colors to match this set of colors
-  \-append              append an image sequence
+  \-append              append an image sequence top to botto (use +append for left to right)
   \-clut                apply a color lookup table to the image
   \-coalesce            merge a sequence of images
   \-combine             combine a sequence of images
+  \-compare             mathematically and visually annotate the difference between an image and its reconstruction
+  \-complex operator    perform complex mathematics on an image sequence
   \-composite           composite image
+  \-copy geometry offset,
+                       copy pixels from one area of an image to another
   \-crop geometry       cut out a rectangular region of the image
   \-deconstruct         break down an image sequence into constituent parts
   \-evaluate-sequence operator
@@ -236,18 +295,24 @@ Image Sequence Operators:
   \-hald-clut           apply a Hald color lookup table to the image
   \-morph value         morph an image sequence
   \-mosaic              create a mosaic from an image sequence
+  \-poly terms          build a polynomial from the image sequence and the corresponding terms (coefficients and degree pairs)
   \-process arguments   process the image with a custom image filter
   \-separate            separate an image channel into a grayscale image
+  \-smush geometry      smush an image sequence together
   \-write filename      write images to this file
 
 Image Stack Operators:
-  \-clone index         clone an image
-  \-delete index        delete the image from the image sequence
+  \-delete indexes      delete the image from the image sequence
+  \-duplicate count,indexes
+                       duplicate an image one or more times
   \-insert index        insert last image into the image sequence
+  \-reverse             reverse image sequence
   \-swap indexes        swap two images in the image sequence
 
 Miscellaneous Options:
   \-debug events        display copious debugging information
+  \-distribute-cache port
+                       distributed pixel cache spanning one or more servers
   \-help                print program options
   \-log format          format of debugging information
   \-list type           print a list of supported option arguments
@@ -259,4 +324,4 @@ ImageMagick(1)
 
 .SH COPYRIGHT
 
-\fBCopyright (C) 1999-2010 ImageMagick Studio LLC. Additional copyrights and licenses apply to this software, see file:///usr/local/share/doc/ImageMagick-6.6.0/www/license.html or http://www.imagemagick.org/script/license.php\fP
+\fBCopyright (C) 1999-2018 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