[GM-tools] Mogrify vs. Convert

"Noah Spurrier" <[email protected]> Wed, 9 Apr 2003 10:14:43 -0700
Newsgroups gmane.comp.video.graphicsmagick.tools
Message-ID <02cb01c2febc$8fc738a0$0200a8c0@hal>
Hi,

What is the motive behind the difference between Mogrify and Convert?
Their descriptions do not make it clear when one should be used 
versus another. The fact that their commands differ in only a few places
adds to the confusion. This is how I read the documentation:

        Mogrify -- "Transforms image(s) with optional conversions."
        Convert -- "Converts image(s) with optional transformations."

If there is some crucial difference in these two tools then
it would be great to see this made clear in the documentation. If not, 
then perhaps in future versions one could become an alias for the other
(to preserve existing scripts).

Yours,
Noah

Note, from the documentation we can see how similar they are.

Mogrify                                Convert
-------------------------------------------------------------------------
transforms an image or a sequence      converts an input file using
of images. These transforms include    one image format to an output file 
image scaling, image rotation, color   with a differing image format. 
reduction, and others.                 In addition, various types of 
The transmogrified image overwrites    image processing can be performed 
the original image, unless an          on the converted image during the 
option such as -format causes the      conversion process.  
output filename to be different 
from the input filename.                         
----------------------------            ---------------------
  -Gaussian                               -Gaussian     
                                          -adjoin  
  -affine                                 -affine     
  -antialias                              -antialias  
                                          -append  
  -authenticate                           -authenticate     
                                          -average  
  -background                             -background     
  -blue-primary                           -blue-primary     
  -blur                                   -blur     
  -border                                 -border     
  -bordercolor                            -bordercolor     
                                          -box     
  -cache                                  -cache     
  -channel                                -channel     
  -charcoal                               -charcoal     
                                          -chop     
                                          -clip  
                                          -coalesce  
  -colorize                               -colorize     
  -colors                                 -colors     
  -colorspace                             -colorspace     
  -comment                                -comment     
  -compose                                -compose     
  -compress                               -compress     
  -contrast                               -contrast  
  -crop                                   -crop     
  -cycle                                  -cycle     
  -debug                                  -debug     
                                          -deconstruct  
  -delay                                  -delay     
  -density                                -density     
  -depth                                  -depth     
  -despeckle                              -despeckle  
  -display                                -display     
  -dispose                                -dispose     
  -dither                                 -dither  
  -draw                                   -draw     
  -edge                                   -edge     
  -emboss                                 -emboss  
  -encoding                               -encoding     
  -endian                                 -endian     
  -enhance                                -enhance  
  -equalize                               -equalize  
  -fill                                   -fill     
  -filter                                 -filter     
                                          -flatten  
  -flip                                   -flip  
  -flop                                   -flop  
  -font                                   -font     
  -format                                       
  -frame                                  -frame     
  -fuzz                                   -fuzz     
  -gamma                                  -gamma     
  -geometry                               -geometry     
  -gravity                                -gravity      
  -green-primary                          -green-primary    
  -help                                   -help  
  -implode                                -implode     
                                          -intent     
  -interlace                              -interlace     
  -label                                  -label     
  -lat                                    -lat     
  -level                                  -level     
  -limit                                  -limit   
  -linewidth                                    
  -list                                   -list     
  -log                                    -log     
  -loop                                   -loop     
  -map                                    -map     
  -mask                                   -mask     
  -matte                                  -matte  
  -mattecolor                             -mattecolor     
  -median                                 -median     
  -modulate                               -modulate     
  -monochrome                             -monochrome  
                                          -morph     
                                          -mosaic  
  -negate                                 -negate  
  -noise                                  -noise     
  -noop                                   -noop  
  -normalize                              -normalize  
  -opaque                                 -opaque     
  -page                                   -page     
  -paint                                  -paint     
  -pen                                    -pen     
                                          -ping  
  -pointsize                              -pointsize     
                                          -preview     
                                          -process     
  -profile                                -profile     
  -quality                                -quality     
  -raise                                  -raise     
  -red-primary                            -red-primary     
  -region                                 -region     
  -resize                                 -resize     
  -roll {+-}                              -roll {+-}    
  -rotate                                 -rotate     
  -sample                                 -sample       
  -sampling-factor                        -sampling-factor  
  -scale                                  -scale     
  -scene                                  -scene     
  -seed                                   -seed     
  -segment                                -segment     
  -shade                                  -shade     
  -sharpen                                -sharpen     
  -shave                                  -shave     
  -shear                                  -shear     
  -size                                   -size     
  -solarize                               -solarize     
  -spread                                 -spread     
  -stroke                                 -stroke     
  -strokewidth                            -strokewidth     
  -swirl                                  -swirl     
  -texture                                -texture     
  -threshold                              -threshold     
  -tile                                   -tile     
  -transform                              -transform  
  -transparent                            -transparent     
  -treedepth                              -treedepth     
  -trim                                   -trim  
  -type                                   -type     
  -units                                  -units     
  -unsharp                                -unsharp     
                                          -use-pixmap  
  -verbose                                -verbose  
  -version                                -version  
  -view                                   -view      
  -virtual-pixel                          -virtual-pixel    
  -wave                                   -wave     
  -white-point                            -white-point              
                                          -write     
                                                         



-------------------------------------------------------
This SF.net email is sponsored by: Etnus, makers of TotalView, The debugger 
for complex code. Debugging C/C++ programs can leave you feeling lost and 
disoriented. TotalView can help you find your way. Available on major UNIX 
and Linux platforms. Try it free. www.etnus.com