


  

  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  



  

    

      

        
../index.html[ImageMagick] 
        

        
http://www.imagemagick.org/[sponsor] 
        

        
../index.html 
        
../index.html 
      

    

  


  

  


    

      

      
#mainSkip to page contents 

      
[
      
../index.htmlAbout ImageMagick       
../www/command-line-tools.htmlCommand-line Tools       
../www/api.htmlProgram Interfaces   
][
      
../www/install-source.htmlInstall from Source       
../www/binary-releases.htmlBinary Releases       
../www/resources.htmlResources   
][
      
../www/download.htmlDownload   
][
      
../www/links.htmlLinks   
][
      
../www/sponsors.htmlSponsors   
http://www.devlib.orgIT and ProgrammingResources       
]
      


      

[ #usageExample Usage  | #optionsOption Summary ]
Use the mogrify program to resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more.   This tool is similiar to ../www/convert.htmlconvert  except the original image file is overwritten with any changes you request.  See ../www/command-line-processing.htmlCommand Line Processing  for advice on how to structure your mogrify command or see below for example usages of the command.
  
Example Usage
We list a few examples of the mogrify command here to illustrate its usefulness and ease of use.  To get started, lets reduce the size of our
rose:
  mogrify -resize 50% rose.jpg
  
../images/rose.jpgrose   
==>  
../images/rose.pngrose 
You can resize all your JPEG images in a folder to a maximum dimension of 256x256 with this command:
  mogrify -resize 256x256 *.jpg
Finally, we convert all our PNG images to the JPEG format:
  mogrify -format jpg *.png
Here image files 1.png, 2.png, etc., are left untouched and files 1.jpg, 2.jpg, etc., are created.  They are copies of their respective PNG images except are stored  in the JPEG image format.
You can find additional examples of using mogrify in http://www-106.ibm.com/developerworks/library/l-graf/?ca=dnt-428Graphics from the Command Line .  Further discussion is available in  http://www-106.ibm.com/developerworks/library/l-graf2/?ca=dgr-lnxw15GraphicsLineMore Graphics from the Command Line  and http://www.cit.gu.edu.au/~anthony/graphics/imagick6Examples of ImageMagick Usage .
  
Option Summary
The mogrify command recognizes these options.  Click on an option to get more details about how that option works.
  
  
    
Option    
Description  
  
    
../www/command-line-options.html#adjoin-adjoin     
join images into a single multi-image file   
  
    
../www/command-line-options.html#affine-affine matrix     
affine transform matrix   
  
    
../www/command-line-options.html#annotate-annotate geometry text     
annotate the image with text   
  
    
../www/command-line-options.html#antialias-antialias     
remove pixel-aliasing   
  
    
../www/command-line-options.html#append-append     
append an image sequence   
  
    
../www/command-line-options.html#authenticate-authenticate value     
decrypt image with this password   
  
    
../www/command-line-options.html#average-average     
average an image sequence   
  
    
../www/command-line-options.html#background-background color     
background color   
  
    
../www/command-line-options.html#bias-bias value     
add bias when convolving an image   
  
    
../www/command-line-options.html#black-threshold-black-threshold value     
forces all pixels below the threshold into black   
  
    
../www/command-line-options.html#blue-primary-blue-primary point     
chromaticity blue primary point   
  
    
../www/command-line-options.html#blur-blur geometry     
blur the image   
  
    
../www/command-line-options.html#border-border geometry     
surround image with a border of color   
  
    
../www/command-line-options.html#bordercolor-bordercolor color     
border color   
  
    
../www/command-line-options.html#channel-channel type     
apply option to select image channels   
  
    
../www/command-line-options.html#charcoal-charcoal radius     
simulate a charcoal drawing   
  
    
../www/command-line-options.html#chop-chop geometry     
remove pixels from the image interior   
  
    
../www/command-line-options.html#clip-clip     
clip along the first path from the 8BIM profile   
  
    
../www/command-line-options.html#clip-path-clip-path id     
clip along a named path from the 8BIM profile   
  
    
../www/command-line-options.html#clone-clone index     
clone an image   
  
    
../www/command-line-options.html#coalesce-coalesce     
merge a sequence of images   
  
    
../www/command-line-options.html#colorize-colorize value     
colorize the image with the fill color   
  
    
../www/command-line-options.html#colors-colors value     
preferred number of colors in the image   
  
    
../www/command-line-options.html#colorspace-colorspace type     
alternate image colorspace   
  
    
../www/command-line-options.html#combine-combine     
combine a sequence of images   
  
    
../www/command-line-options.html#comment-comment string     
annotate image with comment   
  
    
../www/command-line-options.html#compose-compose operator     
set image composite operator   
  
    
../www/command-line-options.html#composite-composite     
composite image   
  
    
../www/command-line-options.html#compress-compress type     
image compression type   
  
    
../www/command-line-options.html#contrast-contrast     
enhance or reduce the image contrast   
  
    
../www/command-line-options.html#convolve-convolve coefficients     
apply a convolution kernel to the image   
  
    
../www/command-line-options.html#crop-crop geometry     
preferred size and location of the cropped image   
  
    
../www/command-line-options.html#cycle-cycle amount     
cycle the image colormap   
  
    
../www/command-line-options.html#debug-debug events     
display copious debugging information   
  
    
../www/command-line-options.html#define-define format:option     
define one or more image format options   
  
    
../www/command-line-options.html#deconstruct-deconstruct     
break down an image sequence into constituent parts   
  
    
../www/command-line-options.html#delay-delay value     
display the next image after pausing   
  
    
../www/command-line-options.html#delete-delete index     
delete the image from the image sequence   
  
    
../www/command-line-options.html#density-density geometry     
horizontal and vertical density of the image   
  
    
../www/command-line-options.html#depth-depth value     
image depth   
  
    
../www/command-line-options.html#despeckle-despeckle     
reduce the speckles within an image   
  
    
../www/command-line-options.html#display-display server     
get image or font from this X server   
  
    
../www/command-line-options.html#dispose-dispose method     
GIF disposal method   
  
    
../www/command-line-options.html#dither-dither     
apply Floyd/Steinberg error diffusion to image   
  
    
../www/command-line-options.html#draw-draw string     
annotate the image with a graphic primitive   
  
    
../www/command-line-options.html#edge-edge radius     
apply a filter to detect edges in the image   
  
    
../www/command-line-options.html#emboss-emboss radius     
emboss an image   
  
    
../www/command-line-options.html#encoding-encoding type     
text encoding type   
  
    
../www/command-line-options.html#endian-endian type     
endianness (MSB or LSB) of the image   
  
    
../www/command-line-options.html#enhance-enhance     
apply a digital filter to enhance a noisy image   
  
    
../www/command-line-options.html#equalize-equalize     
perform histogram equalization to an image   
  
    
../www/command-line-options.html#evaluate-evaluate operator value     
evaluate an arithmetic, relational, or logical expression   
  
    
../www/command-line-options.html#extent-extent geometry     
set the image size   
  
    
../www/command-line-options.html#extract-extract geometry     
extract area from image   
  
    
../www/command-line-options.html#family-family name     
render text with this font family   
  
    
../www/command-line-options.html#fill-fill color     
color to use when filling a graphic primitive   
  
    
../www/command-line-options.html#filter-filter type     
use this filter when resizing an image   
  
    
../www/command-line-options.html#flatten-flatten     
flatten a sequence of images   
  
    
../www/command-line-options.html#flip-flip     
flip image in the vertical direction   
  
    
../www/command-line-options.html#floodfill-floodfill geometry color     
floodfill the image with color   
  
    
../www/command-line-options.html#flop-flop     
flop image in the horizontal direction   
  
    
../www/command-line-options.html#font-font name     
render text with this font   
  
    
../www/command-line-options.html#format-format type     
image format type   
  
    
../www/command-line-options.html#frame-frame geometry     
surround image with an ornamental border   
  
    
../www/command-line-options.html#fuzz-fuzz distance     
colors within this distance are considered equal   
  
    
../www/command-line-options.html#fx-fx expression     
apply mathematical expression to an image channel(s)   
  
    
../www/command-line-options.html#gamma-gamma value     
level of gamma correction   
  
    
../www/command-line-options.html#gaussian-gaussian geometry     
gaussian blur an image   
  
    
../www/command-line-options.html#geometry-geometry geometry     
perferred size or location of the image   
  
    
../www/command-line-options.html#gravity-gravity type     
horizontal and vertical text placement   
  
    
../www/command-line-options.html#green-primary-green-primary point     
chromaticity green primary point   
  
    
../www/command-line-options.html#help-help     
print program options   
  
    
../www/command-line-options.html#identify–identify     
identify the format and characteristics of the image   
  
    
../www/command-line-options.html#implode-implode amount     
implode image pixels about the center   
  
    
../www/command-line-options.html#insert-insert index     
insert last image into the image sequence   
  
    
../www/command-line-options.html#intent-intent type     
type of rendering intent when managing the image color   
  
    
../www/command-line-options.html#interlace-interlace type     
type of image interlacing scheme   
  
    
../www/command-line-options.html#label-label name     
assign a label to an image   
  
    
../www/command-line-options.html#lat-lat geometry     
local adaptive thresholding   
  
    
../www/command-line-options.html#level-level value     
adjust the level of image contrast   
  
    
../www/command-line-options.html#limit-limit type value     
pixel cache resource limit   
  
    
../www/command-line-options.html#log-log format     
format of debugging information   
  
    
../www/command-line-options.html#loop-loop iterations     
add Netscape loop extension to your GIF animation   
  
    
../www/command-line-options.html#map-map filename     
transform image colors to match this set of colors   
  
    
../www/command-line-options.html#mask-mask filename     
set the image clip mask   
  
    
../www/command-line-options.html#matte-matte     
store matte channel if the image has one   
  
    
../www/command-line-options.html#mattecolor-mattecolor color     
frame color   
  
    
../www/command-line-options.html#median-median radius     
apply a median filter to the image   
  
    
../www/command-line-options.html#modulate-modulate value     
vary the brightness, saturation, and hue   
  
    
../www/command-line-options.html#monitor-monitor     
monitor progress   
  
    
../www/command-line-options.html#monochrome-monochrome     
transform image to black and white   
  
    
../www/command-line-options.html#morph-morph value     
morph an image sequence   
  
    
../www/command-line-options.html#mosaic-mosaic     
create a mosaic from an image sequence   
  
    
../www/command-line-options.html#negate-negate     
replace every pixel with its complementary color   
  
    
../www/command-line-options.html#noise-noise radius     
add or reduce noise in an image   
  
    
../www/command-line-options.html#normalize-normalize     
transform image to span the full range of colors   
  
    
../www/command-line-options.html#opaque-opaque color     
change this color to the fill color   
  
    
../www/command-line-options.html#ordered-dither-ordered-dither NxN     
ordered dither the image   
  
    
../www/command-line-options.html#orient-orient type     
image orientation   
  
    
../www/command-line-options.html#page-page geometry     
size and location of an image canvas (setting)   
  
    
../www/command-line-options.html#paint-paint radius     
simulate an oil painting   
  
    
../www/command-line-options.html#ping-ping     
efficiently determine image attributes   
  
    
../www/command-line-options.html#pointsize-pointsize value     
font point size   
  
    
../www/command-line-options.html#posterize-posterize levels     
reduce the image to a limited number of color levels   
  
    
../www/command-line-options.html#preview-preview type     
image preview type   
  
    
../www/command-line-options.html#profile-profile filename     
add, delete, or apply an image profile   
  
    
../www/command-line-options.html#quality-quality value     
JPEG/MIFF/PNG compression level   
  
    
../www/command-line-options.html#quiet-quiet     
suppress all error or warning messages   
  
    
../www/command-line-options.html#radial-blur-radial-blur angle     
radial blur the image   
  
    
../www/command-line-options.html#raise-raise value     
lighten/darken image edges to create a 3-D effect   
  
    
../www/command-line-options.html#random-threshold-random-threshold low,high     
random threshold the image   
  
    
../www/command-line-options.html#red-primary-red-primary point     
chromaticity red primary point   
  
    
../www/command-line-options.html#region-region geometry     
apply options to a portion of the image   
  
    
../www/command-line-options.html#render-render     
render vector graphics   
  
    
../www/command-line-options.html#repage-repage geometry     
size and location of an image canvas   
  
    
../www/command-line-options.html#resample-resample geometry     
change the resolution of an image   
  
    
../www/command-line-options.html#resize-resize geometry     
resize the image   
  
    
../www/command-line-options.html#roll-roll geometry     
roll an image vertically or horizontally   
  
    
../www/command-line-options.html#rotate-rotate degrees     
apply Paeth rotation to the image   
  
    
../www/command-line-options.html#sample-sample geometry     
scale image with pixel sampling   
  
    
../www/command-line-options.html#sampling-factor-sampling-factor geometry     
horizontal and vertical sampling factor   
  
    
../www/command-line-options.html#scale-scale geometry     
scale the image   
  
    
../www/command-line-options.html#scene-scene value     
image scene number   
  
    
../www/command-line-options.html#seed-seed value     
pseudo-random number generator seed value   
  
    
../www/command-line-options.html#segment-segment values     
segment an image   
  
    
../www/command-line-options.html#separate-separate     
separate an image channel into a grayscale image   
  
    
../www/command-line-options.html#sepia-tone-sepia-tone threshold     
simulate a sepia-toned photo   
  
    
../www/command-line-options.html#set-set attribute value     
set an image attribute   
  
    
../www/command-line-options.html#shade-shade degrees     
shade the image using a distant light source   
  
    
../www/command-line-options.html#shadow-shadow geometry     
simulate an image shadow   
  
    
../www/command-line-options.html#sharpen-sharpen geometry     
sharpen the image   
  
    
../www/command-line-options.html#shave-shave geometry     
shave pixels from the image edges   
  
    
../www/command-line-options.html#shear-shear geometry     
slide one edge of the image along the X or Y axis   
  
   
    
../www/command-line-options.html#sigmoidal-sigmoidal-contrast contrastxmid-point     
image lightness rescaling using sigmoidal contrast enhancement   
      
  
    
../www/command-line-options.html#size-size geometry     
width and height of image   
  
    
../www/command-line-options.html#solarize-solarize threshold     
negate all pixels above the threshold level   
  
    
../www/command-line-options.html#splice-splice geometry     
splice the background color into the image   
  
    
../www/command-line-options.html#spread-spread amount     
displace image pixels by a random amount   
  
    
../www/command-line-options.html#strip-strip     
strip image of all profiles and comments   
  
    
../www/command-line-options.html#stroke-stroke color     
graphic primitive stroke color   
  
    
../www/command-line-options.html#strokewidth-strokewidth value     
graphic primitive stroke width   
  
    
../www/command-line-options.html#stretch-stretch type     
render text with this font stretch   
  
    
../www/command-line-options.html#style-style type     
render text with this font style   
  
    
../www/command-line-options.html#support-support factor     
resize support: > 1.0 is blurry,   
  
    
../www/command-line-options.html#swap-swap indexes     
swap two images in the image sequence   
  
    
../www/command-line-options.html#swirl-swirl degrees     
swirl image pixels about the center   
  
    
../www/command-line-options.html#texture-texture filename     
name of texture to tile onto the image background   
  
    
../www/command-line-options.html#threshold-threshold value     
threshold the image   
  
    
../www/command-line-options.html#thumbnail-thumbnail geometry     
create a thumbnail of the image   
  
    
../www/command-line-options.html#tile-tile filename     
tile image when filling a graphic primitive   
  
    
../www/command-line-options.html#tint-tint value     
tint the image with the fill color   
  
    
../www/command-line-options.html#transform-transform     
affine transform image   
  
    
../www/command-line-options.html#transparent-transparent color     
make this color transparent within the image   
  
    
../www/command-line-options.html#treedepth-treedepth value     
color tree depth   
  
    
../www/command-line-options.html#trim-trim     
trim image edges   
  
    
../www/command-line-options.html#type-type type     
image type   
  
    
../www/command-line-options.html#undercolor-undercolor color     
annotation bounding box color   
  
    
../www/command-line-options.html#units-units type     
the units of image resolution   
  
    
../www/command-line-options.html#unsharp-unsharp geometry     
sharpen the image   
  
    
../www/command-line-options.html#verbose-verbose     
print detailed information about the image   
  
    
../www/command-line-options.html#version-version     
print version information   
  
    
../www/command-line-options.html#view-view     
FlashPix viewing transforms   
  
    
../www/command-line-options.html#virtual-pixel-virtual-pixel method     
access method for pixels outside the boundaries of the image   
  
    
../www/command-line-options.html#wave-wave geometry     
alter an image along a sine wave   
  
    
../www/command-line-options.html#weight-weight type     
render text with this font weight   
  
    
../www/command-line-options.html#white-point-white-point point     
chromaticity white point   
  
    
../www/command-line-options.html#white-threshold-white-threshold value     
forces all pixels above the threshold into white   
  
    
../www/command-line-options.html#write-write filename     
write images to this file   
  
      

      
 
    

  

  

  

    
http://redux.imagemagick.org/discussion-serverDiscourse Server  |
    
../www/mailing-list.htmlMailing Lists  |
    
http://redux.imagemagick.org/galleryImage Gallery  |
    
http://redux.imagemagick.org/MagickStudio/scripts/MagickStudio.cgiImageMagick Studio 
  

  

    
© 1999-2005 ImageMagick Studio LLC
  

  



