


  

  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  



  

    

      

        
../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://larscapes.com/Larscapes       
]
      


      

[ #usageExample Usage  | #optionsOption Summary ]
Use the composite program overlaps one image over another.  See ../www/command-line-processing.htmlCommand Line Processing  for advice on how to structure your composite command or see below for example usages of the command.
  
Example Usage
We list a few examples of the composite command here to illustrate its usefulness and ease of use.  To get started, lets overlay a letter over a a rose:
composite -gravity center smile.gif  rose: rose-over.png
  
../images/smile.gifsmile  over  
../images/rose.jpgrose   
==>  
../images/rose-over.pngrose 
You can create three-dimensional effect with the Atop:
  convert -size 70x70 xc:none -fill red -draw 'circle 35,35 10,30' red-circle.png
  convert -size 70x70 xc:none -draw 'circle 35,35 35,20' -negate -channel A -gaussian 0x8 white-highlight.png
  composite -compose atop -geometry -13-17 white-highlight.png red-circle.png red-ball.png
  
../images/white-highlight.pngwhite highlight  atop  
../images/red-circle.pngred circle   
==>  
../images/red-ball.pngred ball 
You can find additional examples of using composite in http://www.cit.gu.edu.au/~anthony/graphics/imagick6Examples of ImageMagick Usage .  You can find out more about them and the mathematics by looking at http://www.w3.org/TR/SVG12/rendering.htmlSVG Alpha Compositing 
  
Option Summary
The composite command recognizes these options.  Click on an option to get more details about how that option works.
  
  
    
Option    
Description  
  
    
../www/command-line-options.html#affine-affine matrix     
affine transform matrix   
  
    
../www/command-line-options.html#authenticate-authenticate value     
decrypt image with this password   
  
    
../www/command-line-options.html#blend-blend geometry     
blend images   
  
    
../www/command-line-options.html#blue-primary-blue-primary point     
chromaticity blue primary point   
  
    
../www/command-line-options.html#channel-channel type     
apply option to select image channels   
  
    
../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#comment-comment string     
annotate image with comment   
  
    
../www/command-line-options.html#compose-compose operator     
set image composite operator   
  
    
../www/command-line-options.html#compress-compress type     
image compression type   
  
    
../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#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#displace-displace geometry     
shift image pixels defined by a displacement map   
  
    
../www/command-line-options.html#dissolve-dissolve value     
dissolve the two images a given percent   
  
    
../www/command-line-options.html#dither-dither     
apply Floyd/Steinberg error diffusion to 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#extract-extract geometry     
extract area from image   
  
    
../www/command-line-options.html#filter-filter type     
use this filter when resizing an image   
  
    
../www/command-line-options.html#font-font name     
render text with this font   
  
    
../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#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#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#matte-matte     
store matte channel if the image has one   
  
    
../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#negate-negate     
replace every pixel with its complementary color   
  
    
../www/command-line-options.html#page-page geometry     
size and location of an image canvas (setting)   
  
    
../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#red-primary-red-primary point     
chromaticity red primary point   
  
    
../www/command-line-options.html#rotate-rotate degrees     
apply Paeth rotation to the image   
  
    
../www/command-line-options.html#sampling-factor-sampling-factor geometry     
horizontal and vertical sampling factor   
  
    
../www/command-line-options.html#scene-scene value     
image scene number   
  
    
../www/command-line-options.html#set-set attribute value     
set an image attribute   
  
    
../www/command-line-options.html#sharpen-sharpen geometry     
sharpen the image   
  
    
../www/command-line-options.html#size-size geometry     
width and height of image   
  
    
../www/command-line-options.html#stegano-stegano offset     
hide watermark within an image   
  
    
../www/command-line-options.html#strip-strip     
strip image of all profiles and comments   
  
    
../www/command-line-options.html#support-support factor     
resize support: > 1.0 is blurry,   
  
    
../www/command-line-options.html#thumbnail-thumbnail geometry     
create a thumbnail of the image   
  
    
../www/command-line-options.html#tile-tile     
repeat composite operation across and down image   
  
    
../www/command-line-options.html#transform-transform     
affine transform image   
  
    
../www/command-line-options.html#treedepth-treedepth value     
color tree depth   
  
    
../www/command-line-options.html#type-type type     
image type   
  
    
../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#virtual-pixel-virtual-pixel method     
access method for pixels outside the boundaries of the image   
  
    
../www/command-line-options.html#watermark-watermark geometry     
percent brightness and saturation of a watermark   
  
    
../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
  

  



