../index.html
[ImageMagick]
http://www.imagemagick.org/
[sponsor]
../index.html
../index.html
#main
Skip to page contents
[
../index.html
About ImageMagick
../www/command-line-tools.html
Command-line Tools
../www/api.html
Program Interfaces
]
[
../www/install-source.html
Install from Source
../www/binary-releases.html
Binary Releases
../www/resources.html
Resources
]
[
../www/download.html
Downloads
]
[
../www/links.html
Links
]
[
../www/sponsors.html
Sponsors
http://www.thebest3d.com/dogwaffle
Project Dogwaffle digital
image paint and
animation software
]
[
#usage
Example Usage
|
#options
Option 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.html
convert
except the original image file is overwritten with any changes you request.  See
../www/command-line-processing.html
Command 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.jpg
rose
==>
../images/rose.png
rose
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-428
Graphics from the Command Line
.  Further discussion is available in
http://www-106.ibm.com/developerworks/library/l-graf2/?ca=dgr-lnxw15GraphicsLine
More Graphics from the Command Line
and
http://www.cit.gu.edu.au/~anthony/graphics/imagick6
Examples 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#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#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
contrast
x
mid-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-server
Discourse Server
|
../www/mailing-list.html
Mailing Lists
|
http://redux.imagemagick.org/gallery
Image Gallery
|
http://studio.webbyland.com/MagickStudio/scripts/MagickStudio.cgi
ImageMagick Studio
© 1999-2005 ImageMagick Studio LLC
