


  

  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  



  

    

      

        
../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.pcbanter.net/PCbanter WindowsXP Help Forum       
]
      


      

[ #usageExample Usage  | #optionsOption 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.htmlCommand 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.jpgrose   
==>  
../images/rose.pngrose 
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.pngfuzzy-magick 
You can find additional examples of using convert 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 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#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 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     
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#blur–motion-blur geometry     
simulate motion blur   
  
    
../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-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
  

  



