]> granicus.if.org Git - imagemagick/blobdiff - utilities/ImageMagick.1.in
(no commit message)
[imagemagick] / utilities / ImageMagick.1.in
index f10a39ba62e0d2dee9534476b6a3fc464c0d01ff..ad1aa9d5f06ac19588ef63c10c0fb376afbc5977 100644 (file)
@@ -2,7 +2,8 @@
 .SH NAME
 ImageMagick \- is a free software suite for the creation, modification and display of bitmap images.
 .SH SYNOPSIS
-\fBconvert\fP \fIinput-file\fP [\fIoptions\fP] \fIoutput-file\fP
+\fBmagick\fP [\fIoptions\fP|\fIinput-file\fP]... \fIoutput-file\fP
+\fBmagick-script\fP \fIscript-file\fP [\fIscript-arguments\fP]...
 .SH OVERVIEW
 
 ImageMagick\[rg], is a software suite to create, edit, and compose bitmap images. It can read, convert and write images in a variety of formats (about 100) including GIF, JPEG, JPEG-2000, PNG, PDF, PhotoCD, TIFF, and DPX. Use ImageMagick to translate, flip, mirror, rotate, scale, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and B\\['e]zier curves.
@@ -13,27 +14,51 @@ The functionality of ImageMagick is typically utilized from the command line or
 
 ImageMagick includes a number of command-line utilities for manipulating images. Most of you are probably accustom to editing images one at a time with a graphical user interface (GUI) with such programs as gimp or Photoshop. However, a GUI is not always convenient. Suppose you want to process an image dynamically from a web script or you want to apply the same operations to many images or repeat a specific operation at different times to the same or different image. For these types of operations, the command-line image processing utility is appropriate.
 
-In the paragraphs below, find a short description for each command-line tool.Click on the program name to get details on the program usage and a list of command-line options that alters how the program performs. If you are just getting acquianted with ImageMagick, start at the top of the list, the convert program, and work your way dowm. Also be sure to peruse Anthony Thyssen's tutorial on how to use ImageMagick utilities to convert, compose, or edit images from the command-line.
+In the paragraphs below, find a short description for each command-line tool.Cl
+ick on the program name to get details on the program usage and a list of comman
+d-line options that alters how the program performs. If you are just getting acq
+uainted with ImageMagick, start at the top of the list, the convert program, and
+ work your way down. Also be sure to peruse Anthony Thyssen's tutorial on how to
+ use ImageMagick utilities to convert, compose, or edit images from the command-
+line.
 .TP
-.B convert
+.B magick
+
+Read images into memory, and perform operations on those images, and write
+then out to either the same of some other image file format.
 
-convert between image formats as well as resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more.
+The "-script" option can be switch from processing command line options,
+to reading options from a file or pipeline.
 .TP
-.B identify
+.B magick-script
 
-describes the format and characteristics of one or more image files.
+As "magick" command but with an implied "-script" option. Allows it to be used
+in special "#!/usr/bin/env magick-script" scripts that will search for the
+"magick-script" command anywhere along the users command path, rather than in
+a hardcorded command location.
+
+.TP
+.B convert
+
+Backwards compatiblity for ImageMagick version 6 "convert". Essentually an
+alias to a restrictive form of the "magick" command, which should be used
+instead.
 .TP
 .B mogrify
 
 resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more. Mogrify overwrites the original image file, whereas, convert writes to a different image file.
 .TP
+.B identify
+
+describes the format and characteristics of one or more image files.
+.TP
 .B composite
 
 overlaps one image over another.
 .TP
 .B montage
 
-create a composite image by combining several separate images. The images are tiled on the composite image optionall adorned with a border, frame, image name, and more.
+create a composite image by combining several separate images. The images are tiled on the composite image optionally adorned with a border, frame, image name, and more.
 .TP
 .B compare
 
@@ -66,4 +91,4 @@ For more information about the ImageMagick, point your browser to file://@DOCUME
 convert(1), identify(1), composite(1), montage(1), compare(1), display(1), animate(1), import(1), conjure(1), quantize(5), miff(4)
 
 .SH COPYRIGHT
-\fBCopyright (C) 1999-2009 ImageMagick Studio LLC. Additional copyrights and licenses apply to this software, see file://@DOCUMENTATION_PATH@/www/license.html or http://www.imagemagick.org/script/license.php\fP
+\fBCopyright (C) 1999-2013 ImageMagick Studio LLC. Additional copyrights and licenses apply to this software, see file://@DOCUMENTATION_PATH@/www/license.html or http://www.imagemagick.org/script/license.php\fP