Differences between current version and previous revision of ImageMagick(1).
Other diffs: Previous Major Revision, Previous Author, or view the Annotated Edit History
Newer page: | version 2 | Last edited on Monday, June 3, 2002 11:54:53 pm | by perry | |
Older page: | version 1 | Last edited on Monday, June 3, 2002 11:54:53 pm | by perry | Revert |
@@ -1,6 +1,6 @@
-ImageMagick
-!!!ImageMagick
+!
ImageMagick
+!
!!!ImageMagick
NAME
SYNOPSIS
DESCRIPTION
OPTIONS
@@ -10,9 +10,9 @@
COPYRIGHT
AUTHORS
----
!!NAME
-ImageMagick - commandline utilities to create, edit, or
+!
ImageMagick - commandline utilities to create, edit, or
convert images
!!SYNOPSIS
@@ -56,9 +56,9 @@
__]__ ''output_file''
!!DESCRIPTION
-__ImageMagick__ provides a suite of commandline utilities
+__!
ImageMagick__ provides a suite of commandline utilities
for creating, converting, editing, and displaying
images:
@@ -104,14 +104,14 @@
__Conjure__ interprets and executes scripts in the Magick
Scripting Language (MSL).
-The __ImageMagick__ utilities recognize the following
+The __!
ImageMagick__ utilities recognize the following
image formats:
__Name Mode Description__ o 8BIM *rw- Photoshop resource
-format o AFM *r-- TrueType font o APP1 *rw- Photoshop
+format o AFM *r-- !
TrueType font o APP1 *rw- Photoshop
resource format o ART *r-- PF1: 1st Publisher o AVI *r--
Audio/Visual Interleaved o AVS *rw+ AVS X image o BIE *rw-
Joint Bi-level Image experts Group interchange format o BMP
*rw+ Microsoft Windows bitmap image o CAPTION *r+ Caption
@@ -123,20 +123,20 @@
Communications in Medicine image o DCX *rw+ ZSoft IBM PC
multi-page Paintbrush o DIB *rw+ Microsoft Windows bitmap
image o DPS *r-- Display Postscript o DPX *r-- Digital
Moving Picture Exchange o EPDF *rw- Encapsulated Portable
-Document Format o EPI *rw- Adobe Encapsulated PostScript
-Interchange format o EPS *rw- Adobe Encapsulated PostScript
-o EPS2 *-w- Adobe Level II Encapsulated PostScript o EPS3
-*-w- Adobe Level III Encapsulated PostScript o EPSF *rw-
-Adobe Encapsulated PostScript o EPSI *rw- Adobe Encapsulated
-PostScript Interchange format o EPT *rw- Adobe Encapsulated
-PostScript with TIFF preview o FAX *rw+ Group 3 FAX o FILE
+Document Format o EPI *rw- Adobe Encapsulated !
PostScript
+Interchange format o EPS *rw- Adobe Encapsulated !
PostScript
+o EPS2 *-w- Adobe Level II Encapsulated !
PostScript o EPS3
+*-w- Adobe Level III Encapsulated !
PostScript o EPSF *rw-
+Adobe Encapsulated !
PostScript o EPSI *rw- Adobe Encapsulated
+!
PostScript Interchange format o EPT *rw- Adobe Encapsulated
+!
PostScript with TIFF preview o FAX *rw+ Group 3 FAX o FILE
*r-- Uniform Resource Locator o FITS *rw- Flexible Image
-Transport System o FPX *rw- FlashPix Format o FTP *r--
+Transport System o FPX *rw- !
FlashPix Format o FTP *r--
Uniform Resource Locator o G3 *rw- Group 3 FAX o GIF *rw+
-CompuServe graphics interchange format o GIF87 *rw-
-CompuServe graphics interchange format (version 87a) o
+!
CompuServe graphics interchange format o GIF87 *rw-
+!
CompuServe graphics interchange format (version 87a) o
GRADIENT *r-- Gradual passing from one shade to another o
GRANITE *r-- Granite texture o GRAY *rw+ Raw gray samples (8
or 16 bits, depending on the image depth) o H *rw- Internal
format o HDF -rw+ Hierarchical Data Format o HISTOGRAM *-w-
@@ -151,9 +151,9 @@
interchange format o JP2 *rw- JPEG-2000 JP2 File Format
Syntax o JPC *rw- JPEG-2000 Code Stream Syntax o JPEG *rw-
Joint Photographic Experts Group JFIF format o JPG *rw-
Joint Photographic Experts Group JFIF format o LABEL *r--
-Text image format o LOGO *rw- ImageMagick Logo o M2V *rw+
+Text image format o LOGO *rw- !
ImageMagick Logo o M2V *rw+
MPEG-2 Video Stream o MAP *rw- Colormap intensities (8 or 16
bits, depending on the image depth) and indices (8 or 16
bits, depending on whether colors exceeds 256). o MAT *-w+
MATLAB image format o MATTE *-w+ MATTE format o MIFF *rw+
@@ -169,35 +169,35 @@
thumbnail format o PAL *rw- 16bit/pixel interleaved YUV o
PALM *rw- Palm Pixmap format o PBM *rw+ Portable bitmap
format (black and white) o PCD *rw- Photo CD o PCDS *rw-
Photo CD o PCL *-w- Page Control Language o PCT *rw- Apple
-Macintosh QuickDraw/PICT o PCX *rw- ZSoft IBM PC Paintbrush
+Macintosh !
QuickDraw/PICT o PCX *rw- ZSoft IBM PC Paintbrush
o PDB *r-- Pilot Image Format o PDF *rw+ Portable Document
-Format o PFA *r-- TrueType font o PFB *r-- TrueType font o
-PFM *r-- TrueType font o PGM *rw+ Portable graymap format
+Format o PFA *r-- !
TrueType font o PFB *r-- !
TrueType font o
+PFM *r-- !
TrueType font o PGM *rw+ Portable graymap format
(gray scale) o PICON *rw- Personal Icon o PICT *rw- Apple
-Macintosh QuickDraw/PICT o PIX *r-- Alias/Wavefront RLE
+Macintosh !
QuickDraw/PICT o PIX *r-- Alias/Wavefront RLE
image format o PLASMA *r-- Plasma fractal image o PM *rw- X
Windows system pixmap (color) o PNG *rw- Portable Network
Graphics o PNM *rw+ Portable anymap o PPM *rw+ Portable
pixmap format (color) o PREVIEW *-w- Show a preview an image
-enhancement, effect, or f/x o PS *rw+ Adobe PostScript o PS2
-*-w+ Adobe Level II PostScript o PS3 *-w+ Adobe Level III
-PostScript o PSD *rw- Adobe Photoshop bitmap o PTIF *rw-
+enhancement, effect, or f/x o PS *rw+ Adobe !
PostScript o PS2
+*-w+ Adobe Level II !
PostScript o PS3 *-w+ Adobe Level III
+!
PostScript o PSD *rw- Adobe Photoshop bitmap o PTIF *rw-
Pyramid encoded TIFF o PWP *r-- Seattle Film Works o RAS
*rw+ SUN Rasterfile o RGB *rw+ Raw red, green, and blue
samples (8 or 16 bits, depending on the image depth) o RGBA
*rw+ Raw red, green, blue, and matte samples (8 or 16 bits,
depending on the image depth) o RLA *r-- Alias/Wavefront
image o RLE *r-- Utah Run length encoded image o ROSE *rw-
-70x46 Truecolor test image o SCT *r-- Scitex HandShake o SFW
+70x46 Truecolor test image o SCT *r-- Scitex !
HandShake o SFW
*r-- Seattle Film Works o SGI *rw+ Irix RGB image o SHTML
*-w- Hypertext Markup Language and a client-side image map o
STEGANO *r-- Steganographic image o SUN *rw+ SUN Rasterfile
o SVG *rw+ Scalable Vector Gaphics o TEXT *rw+ Raw text o
TGA *rw+ Truevision Targa image o TIF *rw+ Tagged Image File
Format o TIFF *rw+ Tagged Image File Format o TILE *r-- Tile
-image with a texture o TIM *r-- PSX TIM o TTF *r-- TrueType
+image with a texture o TIM *r-- PSX TIM o TTF *r-- !
TrueType
font o TXT *rw+ Raw text o UIL *-w- X-Motif UIL table o UYVY
*rw- 16bit/pixel interleaved YUV o VDA *rw+ Truevision Targa
image o VICAR *rw- VICAR rasterfile format o VID *rw+ Visual
Image Directory o VIFF *rw+ Khoros Visualization image o VST
@@ -232,12 +232,12 @@
supported by your particular configuration, run
Raw images are expected to have one byte per pixel unless
-__ImageMagick__ is compiled in 16-bit mode. Here, the raw
+__!
ImageMagick__ is compiled in 16-bit mode. Here, the raw
data is expected to be stored two bytes per pixel in
most-significant-byte-first order. You can tell if
-__ImageMagick__ was compiled in 16-bit mode by typing
+__!
ImageMagick__ was compiled in 16-bit mode by typing
__
!!OPTIONS
@@ -250,9 +250,9 @@
images.
This is a combined list of the commandline options used by
-the ImageMagick utilities (''animate, composite, convert,
+the !
ImageMagick utilities (''animate, composite, convert,
display, identify, import, mogrify'' and
''montage'').
@@ -438,14 +438,14 @@
The ''x'' offset normally specifies the leftmost column
to remove. If the __-gravity__ option is present with
-''NorthEast, East,'' or ''SouthEast'' gravity, it
+''!
NorthEast, East,'' or ''!
SouthEast'' gravity, it
gives the distance leftward from the right edge of the image
to the rightmost column to remove. Similarly, the ''y''
offset normally specifies the topmost row to remove, but if
-the __-gravity__ option is present with ''SouthWest,
-South,'' or ''SouthEast'' gravity, it specifies the
+the __-gravity__ option is present with ''!
SouthWest,
+South,'' or ''!
SouthEast'' gravity, it specifies the
distance upward from the bottom edge of the image to the
bottom row to remove.
@@ -516,9 +516,9 @@
Choose between __shared__ or __private__.
This option only applies when the default X server visual is
-''PseudoColor'' or ''GRAYScale''. Refer to
+''!
PseudoColor'' or ''GRAYScale''. Refer to
__-visual__ for more details. By default, a shared
colormap is allocated. The image shares colors with other X
clients. Some image colors could be approximated, therefore
your image may look very different than intended. Choose
@@ -630,10 +630,10 @@
alternate composite operation:
Over In Out Atop Xor Plus Minus Add Subtract Difference
-Multiply Bumpmap Copy CopyRed CopyGreen CopyBlue
-CopyOpacity
+Multiply Bumpmap Copy !
CopyRed !
CopyGreen !
CopyBlue
+!
CopyOpacity
How each operator behaves is described below.
@@ -741,33 +741,33 @@
''composite image''. Here the matte information is
ignored.
-__CopyRed__
+__!
CopyRed__
The resulting image is the red layer in ''image''
replaced with the red layer in ''composite image''. The
other layers are copied untouched.
-__CopyGreen__
+__!
CopyGreen__
The resulting image is the green layer in ''image''
replaced with the green layer in ''composite image''. The
other layers are copied untouched.
-__CopyBlue__
+__!
CopyBlue__
The resulting image is the blue layer in ''image''
replaced with the blue layer in ''composite image''. The
other layers are copied untouched.
-__CopyOpacity__
+__!
CopyOpacity__
The resulting image is the matte layer in ''image''
replaced with the matte layer in ''composite image''. The
@@ -857,13 +857,13 @@
cropping region. The offsets specify the location of the
upper left corner of the cropping region measured downward
and rightward with respect to the upper left corner of the
image. If the __-gravity__ option is present with
-''NorthEast, East,'' or ''SouthEast'' gravity, it
+''!
NorthEast, East,'' or ''!
SouthEast'' gravity, it
gives the distance leftward from the right edge of the image
to the right edge of the cropping region. Similarly, if the
-__-gravity__ option is present with ''SouthWest,
-South,'' or ''SouthEast'' gravity, the distance is
+__-gravity__ option is present with ''!
SouthWest,
+South,'' or ''!
SouthEast'' gravity, the distance is
measured upward between the bottom edges.
If the ''x'' and ''y'' offsets are omitted, a set of
@@ -928,9 +928,9 @@
image
This option specifies an image density when decoding a
-''PostScript'' or Portable Document page. The default is
+''!
PostScript'' or Portable Document page. The default is
72 dots per inch in the horizontal and vertical direction.
This option is used in concert with
__-page__.
@@ -1060,9 +1060,9 @@
__Point__ requires a single coordinate. __Line__
requires a start and end coordinate, while __rectangle__
expects an upper left and lower right coordinate.
-__RoundRectangle__ has a center coordinate, a width and
+__!
RoundRectangle__ has a center coordinate, a width and
height, and the width and height of the corners.
__Circle__ has a center coordinate and a coordinate for
the outer edge. Use __Arc__ to circumscribe an arc within
a rectangle. Arcs require a start and end point as well as
@@ -1297,10 +1297,10 @@
the image format type
This option will convert any image to the image format you
-specify. See ''ImageMagick(1)'' for a list of image
-format types supported by __ImageMagick__.
+specify. See ''!
ImageMagick(1)'' for a list of image
+format types supported by __!
ImageMagick__.
By default the file is written to its original name.
However, if the filename extension matches a supported
@@ -1489,14 +1489,14 @@
When used as a ''composite'' option, __-geometry__
gives the dimensions of the image and its location with
respect to the composite image. If the __-gravity__
-option is present with ''NorthEast, East,'' or
-''SouthEast'' gravity, the ''x'' represents the
+option is present with ''!
NorthEast, East,'' or
+''!
SouthEast'' gravity, the ''x'' represents the
distance from the right edge of the image to the right edge
of the composite image. Similarly, if the __-gravity__
-option is present with ''SouthWest, South,'' or
-''SouthEast'' gravity, ''y'' is measured between the
+option is present with ''!
SouthWest, South,'' or
+''!
SouthEast'' gravity, ''y'' is measured between the
bottom edges. Accordingly, a positive offset will never
point in the direction outside of the image. The offsets are
not affected by
''
@@ -1523,17 +1523,17 @@
direction primitive gravitates to when annotating the
image.
-Choices are: NorthWest, North, NorthEast, West, Center,
-East, SouthWest, South, SouthEast.
+Choices are: !
NorthWest, North, !
NorthEast, West, Center,
+East, !
SouthWest, South, !
SouthEast.
The direction you choose specifies where to position the
text or other graphic primitive when annotating the image.
For example ''Center'' gravity forces the text to be
centered within the image. By default, the image gravity is
-''NorthWest''. See __-draw__ for more details about
+''!
NorthWest''. See __-draw__ for more details about
graphic primitives.
The __-gravity__ option is also used in concert with the
@@ -1671,9 +1671,9 @@
image label is read from a file titled by the remaining
characters in the string.
-When converting to ''PostScript'', use this option to
+When converting to ''!
PostScript'', use this option to
specify a header string to print above the image. Specify
the label font with __-font__.
@@ -1704,9 +1704,9 @@
Choices are: __Delegate__, __Format__, __Magic__,
__Module__, or __Type__.
-This option lists entries from the ImageMagick configuration
+This option lists entries from the !
ImageMagick configuration
files.
__-loop__ ''''
@@ -1974,21 +1974,21 @@
size and location of an image canvas
Use this option to specify the dimensions of the
-''PostScript'' page in dots per inch or a TEXT page in
+''!
PostScript'' page in dots per inch or a TEXT page in
pixels. The choices for a Postscript page are:
11x17 792 1224 Ledger 1224 792 Legal 612 1008 Letter 612 792
-LetterSmall 612 792 ArchE 2592 3456 ArchD 1728 2592 ArchC
+!
LetterSmall 612 792 ArchE 2592 3456 ArchD 1728 2592 ArchC
1296 1728 ArchB 864 1296 ArchA 648 864 A0 2380 3368 A1 1684
2380 A2 1190 1684 A3 842 1190 A4 595 842 A4Small 595 842 A5
421 595 A6 297 421 A7 210 297 A8 148 210 A9 105 148 A10 74
105 B0 2836 4008 B1 2004 2836 B2 1418 2004 B3 1002 1418 B4
709 1002 B5 501 709 C0 2600 3677 C1 1837 2600 C2 1298 1837
C3 918 1298 C4 649 918 C5 459 649 C6 323 459 Flsa 612 936
-Flse 612 936 HalfLetter 396 612
+Flse 612 936 !
HalfLetter 396 612
For convenience you can specify the page size by media (e.g.
A4, Ledger, etc.). Otherwise, __-page__ behaves much like
@@ -2005,13 +2005,13 @@
hand corner of the page by
{+-}__x__''offset''''y__
''offset''. Use -page 612x792
''-page__ option is
-''NorthWest'', i.e., positive __x__ and __y__
+''!
NorthWest'', i.e., positive __x__ and __y__
''offset'' are measured rightward and downward from the
top left corner of the page, unless the __-gravity__
option is present with a value other than
-''NorthWest''.
+''!
NorthWest''.
The default page dimensions for a TEXT image is
612x792.
@@ -2070,9 +2070,9 @@
__-pointsize__ ''''
-pointsize of the Postscript, OPTION1, or TrueType
+pointsize of the Postscript, OPTION1, or !
TrueType
font
__-preview__ ''''
@@ -2086,11 +2086,11 @@
these previews:
Rotate Shear Roll Hue Saturation Brightness Gamma Spiff Dull
-Grayscale Quantize Despeckle ReduceNoise Add Noise Sharpen
-Blur Threshold EdgeDetect Spread Shade Raise Segment
-Solarize Swirl Implode Wave OilPaint CharcoalDrawing
+Grayscale Quantize Despeckle !
ReduceNoise Add Noise Sharpen
+Blur Threshold !
EdgeDetect Spread Shade Raise Segment
+Solarize Swirl Implode Wave !
OilPaint !
CharcoalDrawing
JPEG
The default preview is __JPEG__.
@@ -2364,9 +2364,9 @@
specify the screen to capture
-This option indicates that the GetImage request used to
+This option indicates that the !
GetImage request used to
obtain the image should be done on the root window, rather
than directly on the specified window. In this way, you can
obtain pieces of other windows that overlap the specified
window, and more importantly, you can capture menus or other
@@ -2426,9 +2426,9 @@
use shared memory
This option specifies whether the utility should attempt use
-shared memory for pixmaps. ImageMagick must be compiled with
+shared memory for pixmaps. !
ImageMagick must be compiled with
shared memory support, and the display must support the
''MIT-SHM'' extension. Otherwise, this option is ignored.
The default is __True__.
@@ -2741,11 +2741,11 @@
the image type
Choose from: __Bilevel__, __Grayscale__,
-__Palette__, __PaletteMatte__, __TrueColor__,
-__TrueColorMatte__, __ColorSeparation__,
-__ColorSeparationMatte__, or
+__Palette__, __!
PaletteMatte__, __!
TrueColor__,
+__!
TrueColorMatte__, __!
ColorSeparation__,
+__!
ColorSeparationMatte__, or
__Optimize__.
Normally, when a format supports different subformats such
@@ -2755,12 +2755,12 @@
from being written in grayscale format even though only gray
pixels are present, use
-convert bird.pgm -type TrueColor bird.jpg
+convert bird.pgm -type !
TrueColor bird.jpg
-Similarly, using -type TrueColorMatte will force the encoder
+Similarly, using -type !
TrueColorMatte will force the encoder
to write an alpha channel even though the image is opaque,
if the output format supports transparency.
@@ -2782,10 +2782,10 @@
the type of image resolution
-Choose from: __Undefined__, __PixelsPerInch__, or
-__PixelsPerCentimeter__.
+Choose from: __Undefined__, __!
PixelsPerInch__, or
+__!
PixelsPerCentimeter__.
__-unsharp__
''''
@@ -2810,10 +2810,10 @@
print detailed information about the image
This information is printed: image scene number; image name;
-image size; the image class (''DirectClass'' or
-''PseudoClass''); the total number of unique colors; and
+image size; the image class (''!
DirectClass'' or
+''!
PseudoClass''); the total number of unique colors; and
the number of seconds to read and transform the image. Refer
to miff for a description of the image class.
@@ -2825,9 +2825,9 @@
__-view__ ''''
-FlashPix viewing parameters
+!
FlashPix viewing parameters
__-visual__ ''''
@@ -2837,10 +2837,10 @@
Choose from these visual classes:
-StaticGray GrayScale StaticColor PseudoColor TrueColor
-DirectColor default visual id
+!
StaticGray !
GrayScale !
StaticColor !
PseudoColor !
TrueColor
+!
DirectColor default visual id
The X server must support the visual you choose, otherwise
an error occurs. If a visual is not specified, the visual
@@ -2935,9 +2935,9 @@
compression.
The equivalent X resource for this option is
-__writeFilename__ (class __WriteFilename__). See
+__writeFilename__ (class __!
WriteFilename__). See
__
!!FILES AND FORMATS
@@ -2982,9 +2982,9 @@
(e.g. image.tiff[[2,7,4]). For raw images, specify a subimage
with a geometry (e.g. -size 640x512
image.rgb[[320x256+50+50]). Single images are written with
the filename you specify. However, multi-part images (e.g.,
-a multi-page PostScript document with __+adjoin__
+a multi-page !
PostScript document with __+adjoin__
specified) are written with the filename followed by a
period (__.__) and the scene number. You can change this
behavior by embedding a %d, %0Nd, %o, %0No, %x, or %0Nx
''printf'' format specification in the file name. For
@@ -3017,9 +3017,9 @@
import(1), montage(1), mogrify(1), composite(1)
!!COPYRIGHT
-__Copyright (C) 2002 ImageMagick Studio__
+__Copyright (C) 2002 !
ImageMagick Studio__
__Permission is hereby granted, free of charge, to any
person obtaining a copy of this software and associated
@@ -3028,22 +3028,22 @@
__The above copyright notice and this permission notice
shall be included in all copies or substantial portions of
-ImageMagick.__
+!
ImageMagick.__
__The software is provided
__
__Except as contained in this notice, the name of the
-ImageMagick Studio LLC shall not be used in advertising or
+!
ImageMagick Studio LLC shall not be used in advertising or
otherwise to promote the sale, use or other dealings in
-ImageMagick without prior written authorization from the
-ImageMagick Studio.__
+!
ImageMagick without prior written authorization from the
+!
ImageMagick Studio.__
!!AUTHORS
-''John Cristy, ImageMagick Studio LLC, Glenn
-Randers-Pehrson, ImageMagick Studio LLC.''
+''John Cristy, !
ImageMagick Studio LLC, Glenn
+Randers-Pehrson, !
ImageMagick Studio LLC.''
----