../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.webservertalk.com
Server Administration
Support Forum
]
[
#usage
Example Usage
|
#options
Option Summary
]
Use the
convert
program to convert between image formats as well as resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more.   See
../www/command-line-processing.html
Command Line Processing
for advice on how to structure your
convert
command or see below for example usages of the command.
Example Usage
We list a few examples of the
convert
command here to illustrate its usefulness and ease of use.  To get started, lets convert an image in the JPEG format to PNG:
convert rose.jpg rose.png
Next, we reduce the image size before it is written to the PNG format:
convert rose.jpg -resize 50% rose.png
../images/rose.jpg
rose
==>
../images/rose.png
rose
You can combine multiple image-processing operations to produce complex results:
convert -size 320x85 xc:transparent -font Bookman-DemiItalic -pointsize 72 -draw "text 25,60 'Magick'" \
-channel RGBA -gaussian 0x6 -fill darkred -stroke magenta -draw "text 20,55 'Magick'" fuzzy-magick.png
../images/fuzzy-magick.png
fuzzy-magick
You can find additional examples of using
convert
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
convert
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
crop the 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
string
output formatted image characteristics
../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
describe 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
geometry
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://net11.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi
ImageMagick Studio
© 1999-2005 ImageMagick Studio LLC
