From b2cad531494932ece3a7425c04e6d3361491dd4f Mon Sep 17 00:00:00 2001 From: cristy Date: Sat, 16 May 2015 13:02:45 +0000 Subject: [PATCH] --- www/command-line-options.html | 997 +++++++++++++++++----------------- www/magick++.html | 4 +- www/magick.html | 4 +- 3 files changed, 494 insertions(+), 511 deletions(-) diff --git a/www/command-line-options.html b/www/command-line-options.html index ce4f4a19d..dd6ab34d8 100644 --- a/www/command-line-options.html +++ b/www/command-line-options.html @@ -55,7 +55,7 @@
-

‑adaptive‑blur • ‑adaptive‑resize • ‑adaptive‑sharpen • ‑adjoin • ‑affine • ‑alpha • ‑annotate • ‑antialias • ‑append • ‑attenuate • ‑authenticate • ‑auto‑gamma • ‑auto‑level • ‑auto‑orient • ‑backdrop • ‑background • ‑bench • ‑bias • ‑black‑point‑compensation • ‑black‑threshold • ‑blend • ‑blue‑primary • ‑blue‑shift • ‑blur • ‑border • ‑bordercolor • ‑borderwidth • ‑brightness‑contrast • ‑cache • ‑canny • ‑caption • ‑cdl • ‑channel • ‑charcoal • ‑chop • ‑clamp • ‑clip • ‑clip‑mask • ‑clip‑path • ‑clone • ‑clut • ‑coalesce • ‑colorize • ‑colormap • ‑color‑matrix • ‑colors • ‑colorspace • ‑combine • ‑comment • ‑compare • ‑complex • ‑compose • ‑composite • ‑compress • ‑connected‑components • ‑contrast • ‑contrast‑stretch • ‑convolve • ‑crop • ‑cycle • ‑debug • ‑decipher • ‑deconstruct • ‑define • ‑delay • ‑delete • ‑density • ‑depth • ‑descend • ‑deskew • ‑despeckle • ‑direction • ‑displace • ‑display • ‑dispose • ‑dissimilarity‑threshold • ‑dissolve • ‑distort • ‑distribute‑cache • ‑dither • ‑draw • ‑duplicate • ‑edge • ‑emboss • ‑encipher • ‑encoding • ‑endian • ‑enhance • ‑equalize • ‑evaluate • ‑evaluate‑sequence • ‑extent • ‑extract • ‑family • ‑features • ‑fft • ‑fill • ‑filter • ‑flatten • ‑flip • ‑floodfill • ‑flop • ‑font • ‑foreground • ‑format • ‑format[identify] • ‑frame • ‑frame[import] • ‑function • ‑fuzz • ‑fx • ‑gamma • ‑gaussian‑blur • ‑geometry • ‑gravity • ‑grayscale • ‑green‑primary • ‑hald‑clut • ‑help • ‑highlight‑color • ‑hough‑lines • ‑iconGeometry • ‑iconic • ‑identify • ‑ift • ‑immutable • ‑implode • ‑insert • ‑intensity • ‑intent • ‑interlace • ‑interpolate • ‑interline‑spacing • ‑interword‑spacing • ‑kerning • ‑kuwahara • ‑label • ‑lat • ‑layers • ‑level • ‑level‑colors • ‑limit • ‑linear‑stretch • ‑linewidth • ‑liquid‑rescale • ‑list • ‑log • ‑loop • ‑lowlight‑color • ‑magnify • ‑map • ‑map[stream] • ‑mask • ‑mattecolor • ‑median • ‑mean‑shift • ‑metric • ‑mode • ‑modulate • ‑moments • ‑monitor • ‑monochrome • ‑morph • ‑morphology • ‑mosaic • ‑motion‑blur • ‑name • ‑negate • ‑noise • ‑normalize • ‑opaque • ‑ordered‑dither • ‑orient • ‑page • ‑paint • ‑path • ‑pause[animate] • ‑pause[import] • ‑perceptible • ‑ping • ‑pointsize • ‑polaroid • ‑poly • ‑posterize • ‑precision • ‑preview • ‑print • ‑process • ‑profile • ‑quality • ‑quantize • ‑quiet • ‑radial‑blur • ‑raise • ‑random‑threshold • ‑red‑primary • ‑regard‑warnings • ‑region • ‑remap • ‑remote • ‑render • ‑repage • ‑resample • ‑resize • ‑respect‑parentheses • ‑reverse • ‑roll • ‑rotate • ‑sample • ‑sampling‑factor • ‑scale • ‑scene • ‑screen • ‑seed • ‑segment • ‑selective‑blur • ‑separate • ‑sepia‑tone • ‑set • ‑shade • ‑shadow • ‑shared‑memory • ‑sharpen • ‑shave • ‑shear • ‑sigmoidal‑contrast • ‑silent • ‑similarity‑threshold • ‑size • ‑sketch • ‑smush • ‑snaps • ‑solarize • ‑sparse‑color • ‑splice • ‑spread • ‑statistic • ‑stegano • ‑stereo • ‑stretch • ‑strip • ‑stroke • ‑strokewidth • ‑style • ‑subimage‑search • ‑swap • ‑swirl • ‑synchronize • ‑taint • ‑text‑font • ‑texture • ‑threshold • ‑thumbnail • ‑tile • ‑tile‑offset • ‑tint • ‑title • ‑transform • ‑transparent • ‑transparent‑color • ‑transpose • ‑transverse • ‑treedepth • ‑trim • ‑type • ‑undercolor • ‑unique‑colors • ‑units • ‑unsharp • ‑update • ‑verbose • ‑version • ‑view • ‑vignette • ‑virtual‑pixel • ‑visual • ‑watermark • ‑wave • ‑weight • ‑white‑point • ‑white‑threshold • ‑window • ‑window‑group • ‑write

+

‑adaptive‑blur • ‑adaptive‑resize • ‑adaptive‑sharpen • ‑adjoin • ‑affine • ‑alpha • ‑annotate • ‑antialias • ‑append • ‑attenuate • ‑authenticate • ‑auto‑gamma • ‑auto‑level • ‑auto‑orient • ‑backdrop • ‑background • ‑bench • ‑bias • ‑black‑point‑compensation • ‑black‑threshold • ‑blend • ‑blue‑primary • ‑blue‑shift • ‑blur • ‑border • ‑bordercolor • ‑borderwidth • ‑brightness‑contrast • ‑cache • ‑canny • ‑caption • ‑cdl • ‑channel • ‑charcoal • ‑chop • ‑clamp • ‑clip • ‑clip‑mask • ‑clip‑path • ‑clone • ‑clut • ‑coalesce • ‑colorize • ‑colormap • ‑color‑matrix • ‑colors • ‑colorspace • ‑combine • ‑comment • ‑compare • ‑complex • ‑compose • ‑composite • ‑compress • ‑connected‑components • ‑contrast • ‑contrast‑stretch • ‑convolve • ‑crop • ‑cycle • ‑debug • ‑decipher • ‑deconstruct • ‑define • ‑delay • ‑delete • ‑density • ‑depth • ‑descend • ‑deskew • ‑despeckle • ‑direction • ‑displace • ‑display • ‑dispose • ‑dissimilarity‑threshold • ‑dissolve • ‑distort • ‑distribute‑cache • ‑dither • ‑draw • ‑duplicate • ‑edge • ‑emboss • ‑encipher • ‑encoding • ‑endian • ‑enhance • ‑equalize • ‑evaluate • ‑evaluate‑sequence • ‑extent • ‑extract • ‑family • ‑features • ‑fft • ‑fill • ‑filter • ‑flatten • ‑flip • ‑floodfill • ‑flop • ‑font • ‑foreground • ‑format • ‑format[identify] • ‑frame • ‑frame[import] • ‑function • ‑fuzz • ‑fx • ‑gamma • ‑gaussian‑blur • ‑geometry • ‑gravity • ‑grayscale • ‑green‑primary • ‑hald‑clut • ‑help • ‑highlight‑color • ‑hough‑lines • ‑iconGeometry • ‑iconic • ‑identify • ‑ift • ‑immutable • ‑implode • ‑insert • ‑intensity • ‑intent • ‑interlace • ‑interpolate • ‑interline‑spacing • ‑interword‑spacing • ‑kerning • ‑kuwahara • ‑label • ‑lat • ‑layers • ‑level • ‑level‑colors • ‑limit • ‑linear‑stretch • ‑linewidth • ‑liquid‑rescale • ‑list • ‑log • ‑loop • ‑lowlight‑color • ‑magnify • ‑map • ‑map[stream] • ‑mask • ‑mattecolor • ‑median • ‑mean‑shift • ‑metric • ‑mode • ‑modulate • ‑moments • ‑monitor • ‑monochrome • ‑morph • ‑morphology • ‑mosaic • ‑motion‑blur • ‑name • ‑negate • ‑noise • ‑normalize • ‑opaque • ‑ordered‑dither • ‑orient • ‑page • ‑paint • ‑path • ‑pause[animate] • ‑pause[import] • ‑perceptible • ‑ping • ‑pointsize • ‑polaroid • ‑poly • ‑posterize • ‑precision • ‑preview • ‑print • ‑process • ‑profile • ‑quality • ‑quantize • ‑quiet • ‑radial‑blur • ‑raise • ‑random‑threshold • ‑red‑primary • ‑regard‑warnings • ‑region • ‑remap • ‑remote • ‑render • ‑repage • ‑resample • ‑resize • ‑respect‑parentheses • ‑reverse • ‑roll • ‑rotate • ‑sample • ‑sampling‑factor • ‑scale • ‑scene • ‑screen • ‑seed • ‑segment • ‑selective‑blur • ‑separate • ‑sepia‑tone • ‑set • ‑shade • ‑shadow • ‑shared‑memory • ‑sharpen • ‑shave • ‑shear • ‑sigmoidal‑contrast • ‑silent • ‑similarity‑threshold • ‑size • ‑sketch • ‑smush • ‑snaps • ‑solarize • ‑sparse‑color • ‑splice • ‑spread • ‑statistic • ‑stegano • ‑stereo • ‑storage‑type • ‑stretch • ‑strip • ‑stroke • ‑strokewidth • ‑style • ‑subimage‑search • ‑swap • ‑swirl • ‑synchronize • ‑taint • ‑text‑font • ‑texture • ‑threshold • ‑thumbnail • ‑tile • ‑tile‑offset • ‑tint • ‑title • ‑transform • ‑transparent • ‑transparent‑color • ‑transpose • ‑transverse • ‑treedepth • ‑trim • ‑type • ‑undercolor • ‑unique‑colors • ‑units • ‑unsharp • ‑update • ‑verbose • ‑version • ‑view • ‑vignette • ‑virtual‑pixel • ‑visual • ‑watermark • ‑wave • ‑weight • ‑white‑point • ‑white‑threshold • ‑window • ‑window‑group • ‑write

Below is list of command-line options recognized by the ImageMagick command-line tools. If you want a description of a particular option, click on the option name in the navigation bar above and you will go right to it. Unless otherwise noted, each option is recognized by the commands: convert and mogrify.

@@ -149,9 +149,7 @@ coordinates (x', y') of a pixel at position (x, y) in the original image are calculated using the following matrix equation.

-
-affine transformation -
+

affine transformation

The size of the resulting image is that of the smallest rectangle that contains the transformed source image. The parameters @@ -209,102 +207,80 @@ matrix determinant has a sufficiently small absolute value it is rejected.

Used to set a flag on an image indicating whether or not to use existing alpha channel data, to create an alpha channel, or to perform other operations on the alpha channel. Choose the argument type from the list below.

- -
- - - - - - - - - - + preserve existing (but specifically turned Off) transparency + channel. - - - +
Associate
+
+ associate the alpha channel with the image.
- - - + existing data, just turns off the use of that data. - - - +
Disassociate
+
+ disassociate the alpha channel from the image.
- - - + the alpha channel turned on, it will have no effect. - - - + - - - + intact, but fully transparent. - - - + intact just deactivated. This is the inverse of 'Copy'. + - - - + appropriately. The color channels are not modified. - - - + - - - + - - - - -
TypeDescription
Activate or On - Enable the image's transparency channel. Note normally Set +
+
Activate
+
+ Enable the image's transparency channel. Note normally Set should be used instead of this, unless you specifically need to - preserve existing (but specifically turned Off) transparency - channel.
Associate - associate the alpha channel with the image.
Deactivate or Off +
Deactivate
+
Disables the image's transparency channel. Does not delete or change the - existing data, just turns off the use of that data.
Disassociate - disassociate the alpha channel from the image.
Set +
Set
+
Activates the alpha/matte channel. If it was previously turned off then it also resets the channel to opaque. If the image already had - the alpha channel turned on, it will have no effect.
Opaque +
Opaque
+
Enables the alpha/matte channel and forces it to be fully opaque. -
Transparent +
Transparent
+
Activates the alpha/matte channel and forces it to be fully transparent. This effectively creates a fully transparent image the same size as the original and with all its original RGB data still - intact, but fully transparent.
Extract +
Extract
+
Copies the alpha channel values into all the color channels and turns - 'Off' the the image's transparency, so as to generate + 'Off' the the image's transparency, so as to generate a gray-scale mask of the image's shape. The alpha channel data is left - intact just deactivated. This is the inverse of 'Copy'. -
Copy - Turns 'On' the alpha/matte channel, then copies the +
Copy
+
+ Turns 'On' the alpha/matte channel, then copies the gray-scale intensity of the image, into the alpha channel, converting a gray-scale mask into a transparent shaped mask ready to be colored - appropriately. The color channels are not modified.
Shape - As per 'Copy' but also colors the resulting shape mask with +
Shape
+
+ As per 'Copy' but also colors the resulting shape mask with the current background color. That is the RGB color channels is replaced, with appropriate alpha shape. -
Remove +
Remove
+
Composite the image over the background color. -
Background +
Background
+
Set any fully-transparent pixel to the background color, while leaving it fully-transparent. This can make some image file formats, such as PNG, smaller as the RGB values of transparent pixels are more uniform, and thus can compress better. -
-
+ +

Note that while the obsolete +matte operation was the same as "-alpha Off", the @@ -334,7 +310,9 @@ convention once it is realized that the positive y–direction is conventionally considered to be downward for images.)

The new (transformed) coordinates (x', y') of a pixel at position (x, y) in the image are calculated using the following matrix -equation.

annotate transformation
+equation.

+ +

annotate transformation

If tx and ty are omitted, they default to 0. This makes the bottom-left of the text becomes the upper-left corner of the image, which is @@ -504,7 +482,7 @@ consider the following command and its output. Modify the benchmark with the to run the benchmark in parallel (requires the OpenMP feature).

-convert logo: -resize 1000% -bench 5 logo.png
+-> convert logo: -resize 1000% -bench 5 logo.png
 Performance[4]: 5i 0.875657ips 6.880u 0:05.710
@@ -590,8 +568,7 @@ the background image is weighted by the exact opposite amount. That is a

Convolve the image with a Gaussian or normal distribution using the given Sigma value. The formula is:

-
gaussian distribution -
+

gaussian distribution

The Sigma value is the important argument, and determines the actual amount of blurring that will take place.

@@ -650,70 +627,32 @@ ignored.

As of IM 6.7.8-8, the geometry arguments behave as follows:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
sizeGeneral description
valuevalue is added to both left/right and top/bottom
value-xxvalue-x is added only to left/right and top/bottom are unchanged
xvalue-yvalue-y is added only to top/bottom and left/right are unchanged
value-xxvalue-yvalue-x is added to left/right and value-y added to top/bottom
value-xx0value-x is added only to left/right and top/bottom are unchanged
0xvalue-yvalue-y is added only to top/bottom and left/right are unchanged
value%value % of width is added to left/right and value % of height is added to top/bottom
value-xx%value-x % of width is added to left/right and to top/bottom
xvalue-y%value-y % of height is added to top/bottom and to left/right
value-x%xvalue-y%value-x % of width is added to left/right and value-y % of height is added to top/bottom
value-x%x0%value-x % of width is added to left/right and top/bottom are unchanged
0%xvalue-y%value-y % of height is added to top/bottom and left/right are unchanged
- +
+
value
+
value is added to both left/right and top/bottom
+
value-xx
+
value-x is added only to left/right and top/bottom are unchanged
+
xvalue-y
+
value-y is added only to top/bottom and left/right are unchanged
+
value-xxvalue-y
+
value-x is added to left/right and value-y added to top/bottom
+
value-xx0
+
value-x is added only to left/right and top/bottom are unchanged
+
0xvalue-y
+
value-y is added only to top/bottom and left/right are unchanged
+
value%
+
value % of width is added to left/right and value % of height is added to top/bottom
+
value-xx%
+
value-x % of width is added to left/right and to top/bottom
+
xvalue-y%
+
value-y % of height is added to top/bottom and to left/right
+
value-x%xvalue-y%
+
value-x % of width is added to left/right and value-y % of height is added to top/bottom
+
value-x%x0%
+
value-x % of width is added to left/right and top/bottom are unchanged
+
0%xvalue-y%
+
value-y % of height is added to top/bottom and left/right are unchanged
+

Set the border color by preceding with the -bordercolor setting.

@@ -916,8 +855,6 @@ Not all operators understands this flag at this time, but that is changing.

To print a complete list of channel types, use -list channel.

-
-

By default, ImageMagick sets -channel to the value 'RGBK,sync', which specifies that operators act on all color channels except the transparency channel, and that all the color channels are @@ -1911,8 +1848,10 @@ available:

jpeg:block-smoothing=on|off + &nbsp + - + jpeg:colors=value Set the desired number of colors and let the JPEG encoder do the quantizing. @@ -1935,17 +1874,25 @@ available:

jpeg:fancy-upsampling=on|off + &nbsp + - + jpeg:optimize-coding=on|off + &nbsp + - + jpeg:q-table=table + &nbsp + - + jpeg:sampling-factor=sampling-factor-string + &nbsp + - + jpeg:size=geometry Set the size hint of a JPEG image, for example, -define jpeg:size=128x128. @@ -1960,11 +1907,15 @@ available:

json:limit + &nbsp + - + json:locate + &nbsp + - + json:moments includes image moments in verbose information @@ -1998,16 +1949,24 @@ available:

pdf:fit-to-page=true + &nbsp + - + pdf:use-cropbox=true + &nbsp + - + pdf:use-trimbox=true + &nbsp + - + png:bit-depth=value - + &nbsp + + png:color-type=value desired bit-depth and color-type for PNG output. You can force the PNG encoder to use a different bit-depth and color-type than it would have @@ -2231,16 +2190,20 @@ available:

tiff:endian=msb|lsb + &nbsp + - + tiff:exif-properties=false Skips reading the EXIF properties. tiff:fill-order=msb|lsb + &nbsp + - + tiff:ignore-tags=comma-separate-list-of-tag-IDs Allows one or more tag ID values to be ignored. @@ -2519,12 +2482,11 @@ and meaning of the floating point values depends on the distortion method - ScaleRotateTranslate -
or SRT + ScaleRotateTranslate
SRT Distort image by first scaling and rotating about a given 'center', before translating that 'center' to the new location, in that order. It - is an alternative method of specifying a 'Affine' type of + is an alternative method of specifying a 'Affine' type of distortion, but without shearing effects. It also provides a good way of rotating and displacing a smaller image for tiling onto a larger background (IE 2-dimensional animations).
@@ -2532,30 +2494,26 @@ and meaning of the floating point values depends on the distortion method - - - - - - - - - - -
2:Scale Angle
3:X,Y Angle
4:X,Y Scale Angle
5:X,Y ScaleX,ScaleY Angle
6:X,Y Scale Angle NewX,NewY
7:X,Y ScaleX,ScaleY Angle - NewX,NewY
+
+
2:
Scale Angle
+
3:
X,Y Angle
+
4:
X,Y Scale Angle
+
5:
X,Y ScaleX,ScaleY Angle
+
6:
X,Y Scale Angle NewX,NewY
+
7:
X,Y ScaleX,ScaleY Angle NewX,NewY
+
This is actually an alternative way of specifying a 2 dimensional linear - 'Affine' or 'AffineProjection' distortion. + 'Affine' or 'AffineProjection' distortion. - Affine + Affine Distort the image linearly by moving a list of at least 3 or more sets of control points (as defined below). Ideally 3 sets or 12 floating point values are given allowing the image to be linearly scaled, rotated, sheared, and translated, according to those three points. See - also the related 'AffineProjection' and 'SRT' + also the related 'AffineProjection' and 'SRT' distortions.
More than 3 sets given control point pairs (12 numbers) is least @@ -2572,22 +2530,22 @@ and meaning of the floating point values depends on the distortion method - AffineProjection + AffineProjection Linearly distort an image using the given Affine Matrix of 6 pre-calculated coefficients forming a set of Affine Equations to map the source image to the destination image. -
+

sx, rx, ry, sy, tx, ty -

+

See -affine setting for more detail, and meanings of these coefficients.
- The distortions 'Affine' and 'SRT' provide + The distortions 'Affine' and 'SRT' provide alternative methods of defining this distortion, with ImageMagick doing the calculations needed to generate the required coefficients. You can see the internally generated coefficients, by using a -verbose setting with those other variants. @@ -2595,20 +2553,20 @@ and meaning of the floating point values depends on the distortion method - BilinearForward
- BilinearReverse + BilinearForward
+ BilinearReverse Bilinear Distortion, given a minimum of 4 sets of coordinate pairs, or 16 values (see below). Not that lines may not appear straight after distortion, though the distance between coordinates will remain consistent.
- The 'BilinearForward' is used to map rectangles to any - quadrilateral, while the 'BilinearReverse' form maps any + The 'BilinearForward' is used to map rectangles to any + quadrilateral, while the 'BilinearReverse' form maps any quadrilateral to a rectangle, while preserving the straight line edges in each case.
- Note that 'BilinearForward' can generate invalid pixels + Note that 'BilinearForward' can generate invalid pixels which will be colored using the -mattecolor color setting. Also if the quadrilateral becomes 'flipped' the image may disappear.
@@ -2621,13 +2579,13 @@ and meaning of the floating point values depends on the distortion method - Perspective + Perspective Perspective distort the images, using a list of 4 or more sets of control points (as defined below). More that 4 sets (16 numbers) of control points provide least squares fitting for more accurate distortions (for the purposes of image registration and panorama - effects). Less than 4 sets will fall back to a 'Affine' + effects). Less than 4 sets will fall back to a 'Affine' linear distortion.
Perspective Distorted images ensures that straight lines remain @@ -2637,34 +2595,33 @@ and meaning of the floating point values depends on the distortion method - PerspectiveProjection + PerspectiveProjection - Do a 'Perspective' distortion biased on a set of 8 + Do a 'Perspective' distortion biased on a set of 8 pre-calculated coefficients. You can get these coefficients by looking at the -verbose output of a - 'Perspective' distortion, or by calculating them yourself. + 'Perspective' distortion, or by calculating them yourself. If the last two perspective scaling coefficients are zero, the remaining 6 represents a transposed 'Affine Matrix'. - Arc + Arc Arc the image (variation of polar mapping) over the angle given around - a circle.
- - - - - - - - - - - -
ArgumentMeaning
arc_angleThe angle over which to arc the image side-to-side
rotate_angleAngle to rotate resulting image from vertical center
top_radiusSet top edge of source image at this radius
bottom_radius Set bottom edge to this radius (radial scaling)
+ a circle. + +

+
arc_angle
+
The angle over which to arc the image side-to-side
+
rotate_angle
+
Angle to rotate resulting image from vertical center
+
top_radius
+
Set top edge of source image at this radius
+
bottom_radius
+
Set bottom edge to this radius (radial scaling)
+
The resulting image is always resized to best fit the resulting image, (as if using +distort) while attempting to @@ -2678,9 +2635,9 @@ and meaning of the floating point values depends on the distortion method - Polar + Polar - Like 'Arc' but do a complete Cartesian to Polar mapping of + Like 'Arc' but do a complete Cartesian to Polar mapping of the image. that is the height of the input image is mapped to the radius limits, while the width is wrapped around between the angle limits.
@@ -2690,32 +2647,32 @@ and meaning of the floating point values depends on the distortion methodRmin defaulting to zero, the center to the center of the image, and the angles going from -180 (top) to +180 (top). If Rmax is given the special value of - '0', the the distance from the center to the nearest edge + '0', the the distance from the center to the nearest edge is used for the radius of the output image, which will ensure the whole image is visible (though scaled smaller). However a special value of - '-1' will use the distance from the center to the furthest + '-1' will use the distance from the center to the furthest corner, This may 'clip' the corners from the input rectangular image, - but will generate the exact reverse of a 'DePolar' with + but will generate the exact reverse of a 'DePolar' with the same arguments.
If the plus form of distort (+distort) is used - output image center will default to 0,0 of the virtual + output image center will default to 0,0 of the virtual canvas, and the image size adjusted to ensure the whole input image is made visible in the output image on the virtual canvas. - DePolar + DePolar - Uses the same arguments and meanings as a 'Polar' distortion + Uses the same arguments and meanings as a 'Polar' distortion but generates the reverse Polar to Cartesian distortion.
- The special Rmax setting of '0' may however clip + The special Rmax setting of '0' may however clip the corners of the input image. However using the special - Rmax setting of '-1' (maximum center to corner + Rmax setting of '-1' (maximum center to corner distance) will ensure the whole distorted image is preserved in the - generated result, so that the same argument to 'Polar' will + generated result, so that the same argument to 'Polar' will reverse the distortion re-producing the original. Note that as this distortion requires the area resampling of a circular @@ -2727,21 +2684,21 @@ and meaning of the floating point values depends on the distortion method - Barrel + Barrel Given the four coefficients (A,B,C,D) as defined by Helmut Dersch, perform a barrel or pin-cushion distortion appropriate to correct radial lens distortions. That is in photographs, make straight lines straight again.
- Arguments: A B C [ D [ +

Arguments: A B C [ D [ X , Y ] ]
or Ax Bx Cx Dx Ay By Cy Dy - [ X , Y ]
- So that it forms the function
- Rsrc = r * ( A*r3 + B*r2 + - C*r + D )
+ [ X , Y ]

+ So that it forms the function +

Rsrc = r * ( A*r3 + B*r2 + + C*r + D )

Where X,Y is the optional center of the distortion (defaulting to the center of the image).
@@ -2752,22 +2709,22 @@ and meaning of the floating point values depends on the distortion method - BarrelInverse + BarrelInverse - This is very similar to 'Barrel' with the same set of + This is very similar to 'Barrel' with the same set of arguments, and argument handling. However it uses the inverse of the radial polynomial, - so that it forms the function
- Rsrc = r / ( A*r3 + B*r2 + - C*r + D )
- Note that this is not the reverse of the 'Barrel' + so that it forms the function +

Rsrc = r / ( A*r3 + B*r2 + + C*r + D )

+ Note that this is not the reverse of the 'Barrel' distortion, just a different barrel-like radial distortion method. - Shepards + Shepards Distort the given list control points (any number) using an Inverse Squared Distance Interpolation Method (Shepards @@ -2799,13 +2756,13 @@ defining how these points in the given image should be distorted in the destination image. Each set of four floating point values represent a source image coordinate, followed immediately by the destination image coordinate. This produces a list of values such as...

-
+

U1,V1 X1,Y1 U2,V2 X2,Y2 U3,V3 X3,Y3 ... Un,Vn Xn,Yn -

+

where U,V on the source image is mapped to X,Y on the destination image.

@@ -2938,32 +2895,31 @@ operations.

The shape primitives:

-
-point           x,y
-line            x0,y0 x1,y1
-rectangle       x0,y0 x1,y1
-roundRectangle  x0,y0 x1,y1 wc,hc
-arc             x0,y0 x1,y1 a0,a1
-ellipse         x0,y0 rx,ry a0,a1
-circle          x0,y0 x1,y1
-polyline        x0,y0  ...  xn,yn
-polygon         x0,y0  ...  xn,yn
-bezier          x0,y0  ...  xn,yn
-path specification
-image           operator x0,y0 w,h filename
-
+
+
point
x,y
+
line
x0,y0 x1,y1
+
rectangle
x0,y0 x1,y1
+
roundRectangle
x0,y0 x1,y1 wc,hc
+
arc
x0,y0 x1,y1 a0,a1
+
ellipse
x0,y0 rx,ry a0,a1
+
circle
x0,y0 x1,y1
+
polyline
x0,y0 ... xn,yn
+
polygon
x0,y0 ... xn,yn
+
bezier
x0,y0 ... xn,yn
+
path
specification
+
image
operator x0,y0 w,h filename
+

The text primitive:

-
-text            x0,y0 string
-
+
+
text
x0,y0 string
+

The text gravity primitive:

-
-gravity         NorthWest, North, NorthEast, West, Center,
-                East, SouthWest, South, or SouthEast
-
+
+
gravity
NorthWest, North, NorthEast, West, Center, East, SouthWest, South, or SouthEast
+

The text gravity primitive only affects the placement of text and does not interact with the other primitives. It is equivalent to using the -gravity command-line option, except that it is limited in @@ -2971,20 +2927,20 @@ scope to the -draw option in which

The transformation primitives:

-
-rotate     degrees
-translate  dx,dy
-scale      sx,sy
-skewX      degrees
-skewY      degrees
-
+
+
rotate
degrees
+
translate
dx,dy
+
scale
sx,sy
+
skewX
degrees
+
skewY
degrees
+

The pixel operation primitives:

-
-color  x0,y0 method
-matte  x0,y0 method
-
+
+
color
x0,y0 method
+
matte
x0,y0 method
+

The shape primitives are drawn in the color specified by the preceding -fill setting. For unfilled shapes, use -fill none. You can optionally control the stroke (the "outline" of a shape) with the -stroke and -strokewidth settings.

@@ -3198,10 +3154,16 @@ Decipher an Image.

specify the text encoding.

-

Choose from AdobeCustom, AdobeExpert, -AdobeStandard, AppleRoman, BIG5, -GB2312, Latin 2, None, SJIScode, -Symbol, Unicode, Wansung.

+

Choose from

+ +
+AdobeCustom     AdobeExpert
+AdobeStandard   AppleRoman
+BIG5            GB2312
+Latin 2         None
+SJIScode        Symbol
+Unicode         Wansung
+

-endian type

@@ -3460,23 +3422,15 @@ rendering text. If the family can be found it is used; if not, a default font

display (cooccurrence matrix) texture measure features for each channel in the image in each of four directions (horizontal, vertical, left and right diagonals) for the specified distance.

-Angular Second Moment
-Contrast
-Correlation
-Sum of Squares Variance
-Inverse Difference Moment
-Sum Average
-Sum Variance
-Sum Entropy
-Entropy
-Difference Variance
-Difference Entropy
-Information Measure of Correlation 1
-Information Measure of Correlation 2
-Maximum Correlation Coefficient
+Angular Second Moment       Sum Entropy
+Contrast                    Entropy
+Correlation                 Difference Variance
+Sum of Squares Variance     Difference Entropy
+Inverse Difference Moment   Information Measure of Correlation 1
+Sum Average                 Information Measure of Correlation 2
+Sum Variance                Maximum Correlation Coefficient
-

-fft

@@ -4186,8 +4140,7 @@ convert input.png +gamma .45455 output.png

Convolve the image with a Gaussian or normal distribution using the given Sigma value. The formula is:

-
gaussian distribution -
+

gaussian distribution

The Sigma value is the important argument, and determines the actual amount of blurring that will take place.

@@ -4500,14 +4453,15 @@ converting images to -colorspace gray.

the pixel values to linear-RGB or non-linear sRGB colorspace before being applied to calulate the final greyscale value.

-
-   Rec601Luma        0.298839R' + 0.586811G'+ 0.114350B'
-   Rec601Luminance   0.298839R + 0.586811G + 0.114350B
-   Rec709Luma        0.212656R' + 0.715158G' + 0.072186B'
-   Rec709Luminance   0.212656R + 0.715158G + 0.072186B
-   Brightness        max(R', G', B')
-   Lightness         (min(R', G', B') + max(R', G', B')) / 2.0
-
+
+
Rec601Luma
0.298839R' + 0.586811G'+ 0.114350B'
+
Rec601Luminance
0.298839R + 0.586811G + 0.114350B
+
Rec709Luma
0.212656R' + 0.715158G' + 0.072186B'
+
Rec709Luminance
0.212656R + 0.715158G + 0.072186B
+
Brightness
max(R', G', B')
+
Lightness
(min(R', G', B') + max(R', G', B')) / 2.0
+
+

Note that the above R,G,B values is the image's linear-RGB values, while R',G',B' are sRGB non-linear values.

@@ -4515,11 +4469,11 @@ R',G',B' are sRGB non-linear values.

current value in the images respective R,G,B channel regardless of what that is, or what colorspace the image is currently using.

-
-   Average           (R + G + B) / 3.0
-   MS                (R^2 + G^2 + B^2) / 3.0
-   RMS               sqrt( (R^2 + G^2 + B^2) / 3.0 )
-
+
+
Average
(R + G + B) / 3.0
+
MS
(R^2 + G^2 + B^2) / 3.0
+
RMS
sqrt( (R^2 + G^2 + B^2) / 3.0 )
+

These methods are often used for other purposes, such as generating a grayscale difference image between two color images (using -compose 'Difference' composition.

@@ -4582,13 +4536,13 @@ Perceptual, Relative, Saturation.

Choose from:

-   none
-   line
-   plane
-   partition
-   JPEG
-   GIF
-   PNG
+none
+line
+plane
+partition
+JPEG
+GIF
+PNG

This option is used to specify the type of interlacing scheme for raw image @@ -5217,24 +5171,77 @@ normalization of mathematical images.

Print a list of supported arguments for various options or settings. Choose from these list types:

-
-   Align          Alpha          Boolean        Channel
-   Class          ClipPath       Coder          Color
-   Colorspace     Command        Compose        Compress
-   Configure      DataType       Debug          Decoration
-   Delegate       Direction      Dispose        Distort
-   Dither         Endian         Evaluate       FillRule
-   Filter         Font           Format         Function
-   Gravity        ImageList      Intent         Interlace
-   Interpolate    Kernel         Layers         LineCap
-   LineJoin       List           Locale         LogEvent
-   Log            Magic          Method         Metric
-   Mime           Mode           Morphology     Module
-   Noise          Orientation    Policy         PolicyDomain
-   PolicyRights   Preview        Primitive      QuantumFormat
-   Resource       SparseColor    Storage        Stretch
-   Style          Threshold      Type           Units
-   Validate       VirtualPixel
+
+Align
+Alpha
+Boolean
+Cache
+Channel
+Class
+ClipPath
+Coder
+Color
+Colorspace
+Command
+Complex
+Compose
+Compress
+Configure
+DataType
+Debug
+Decoration
+Delegate
+Direction
+Dispose
+Distort
+Dither
+Endian
+Evaluate
+FillRule
+Filter
+Font
+Format
+Function
+Gravity
+Intensity
+Intent
+Interlace
+Interpolate
+Kernel
+Layers
+LineCap
+LineJoin
+List
+Locale
+LogEvent
+Log
+Magic
+Method
+Metric
+Mime
+Mode
+Morphology
+Module
+Noise
+Orientation
+PixelIntensity
+Policy
+PolicyDomain
+PolicyRights
+Preview
+Primitive
+QuantumFormat
+Resource
+SparseColor
+Statistic
+Storage
+Stretch
+Style
+Threshold
+Type
+Units
+Validate
+VirtualPixel
 

 
 
These lists vary depending on your version of ImageMagick. Use "-list
@@ -5256,20 +5263,20 @@ identify -list list
 
You can display the following components by embedding special format
 characters:

 
-
-%d  domain
-%e  event
-%f  function
-%l  line
-%m  module
-%p  process ID
-%r  real CPU time
-%t  wall clock time
-%u  user CPU time
-%%  percent sign
-\n  newline
-\r  carriage return
-

+

+
%d
domain

+
%e
event

+
%f
function

+
%l
line

+
%m
module

+
%p
process ID

+
%r
real CPU time

+
%t
wall clock time

+
%u
user CPU time

+
%%
percent sign

+
\n
newline

+
\r
carriage return

+

 
 
For example:

 
@@ -5333,19 +5340,19 @@ the type and display searches the list of colormap types in
 
 
Here are the valid components of a map:

 
-
-r  red pixel component
-g  green pixel component
-b  blue pixel component
-a  alpha pixel component (0 is transparent)
-o  opacity pixel component (0 is opaque)
-i  grayscale intensity pixel component
-c  cyan pixel component
-m  magenta pixel component
-y  yellow pixel component
-k  black pixel component
-p  pad component (always 0)
-

+

+
r
  red pixel component

+
g
  green pixel component

+
b
  blue pixel component

+
a
  alpha pixel component (0 is transparent)

+
o
  opacity pixel component (0 is opaque)

+
i
  grayscale intensity pixel component

+
c
  cyan pixel component

+
m
  magenta pixel component

+
y
  yellow pixel component

+
k
  black pixel component

+
p
  pad component (always 0)

+

 
 
You can specify as many of these components as needed in any order (e.g.
 bgr).  The components can repeat as well (e.g. rgbr).

@@ -5407,7 +5414,7 @@ name. 

 
 
widthxheight is the window size and distance is the color distance measured in the range 0 to 1 or 0 to 100%

 
-
The mean shift algorithm is iterative and thus slower the larger the window size. For each pixel, it gets all the pixels in the window centered at the pixel and excludes those that are outside the radius=sqrt((width-1)(height-1)/4) surrounding the pixel. From those pixels, it finds which of them are within the specified squared color distance from the current mean. It then computes a new x,y centroid from those coordinates and a new mean. This new x,y centroid is used as the center for a new window. This process is iterated until it converges and the final mean is then used to replace the original pixel value. It repeats this process for the next pixel, etc, until it processes all pixels in the image. Results are better when using other colorspaces rather than RGB. Recommend YIQ, YUV or YCbCr, which seem to give equivalent results.

+
The mean shift algorithm is iterative and thus slower the larger the window size. For each pixel, it gets all the pixels in the window centered at the pixel and excludes those that are outside the radius=sqrt((width-1)(height-1)/4) surrounding the pixel. From those pixels, it finds which of them are within the specified squared color distance from the current mean. It then computes a new x,y centroid from those coordinates and a new mean. This new x,y centroid is used as the center for a new window. This process is iterated until it converges and the final mean is then used to replace the original pixel value. It repeats this process for the next pixel, etc, until it processes all pixels in the image. Results are better when using other colorspaces rather than RGB. Recommend YIQ, YUV or YCbCr, which seem to give equivalent results.

 
 

   
-metric type

@@ -5695,7 +5702,7 @@ given number of levels per color channel.

 
 
You can choose from these standard threshold maps:

 
-
+
 threshold   1x1   Threshold 1x1 (non-dither)
 checks      2x1   Checkerboard 2x1 (dither)
 o2x2        2x2   Ordered 2x2 (dispersed)
@@ -5753,15 +5760,11 @@ after being created. 

 
Choose from these orientations:

 
 
-bottom-left
-bottom-right
-left-bottom
-left-top
+bottom-left    right-top
+bottom-right   top-left
+left-bottom    top-right
+left-top       undefined
 right-bottom
-right-top
-top-left
-top-right
-undefined
 

 
 
To print a complete list of orientations, use the -list
@@ -5785,52 +5788,46 @@ orientation option.

 
Use media as shorthand to specify the dimensions (widthxheight) of the PostScript page in dots per inch or a TEXT page in pixels.
 The choices for a PostScript page are:

 
-

-
-  
-    
-    
-    
- 
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
MediaWidthHeight
 11x17         792  1224 
 Ledger       1224   792 
 Legal         612  1008 
 Letter        612   792 
 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 

+

+
 11x17      
 
  792 x 1224
 
+
 Ledger     
 
 1224 x  792
 
+
 Legal      
 
  612 x 1008
 
+
 Letter     
 
  612 x  792
 
+
 LetterSmall
 
  612 x  792
 
+
 ArchE      
 
 2592 x 3456
 
+
 ArchD      
 
 1728 x 2592
 
+
 ArchC      
 
 1296 x 1728
 
+
 ArchB      
 
  864 x 1296
 
+
 ArchA      
 
  648 x  864
 
+
 A0         
 
 2380 x 3368
 
+
 A1         
 
 1684 x 2380
 
+
 A2         
 
 1190 x 1684
 
+
 A3         
 
  842 x 1190
 
+
 A4         
 
  595 x  842
 
+
 A4Small    
 
  595 x  842
 
+
 A5         
 
  421 x  595
 
+
 A6         
 
  297 x  421
 
+
 A7         
 
  210 x  297
 
+
 A8         
 
  148 x  210
 
+
 A9         
 
  105 x  148
 
+
 A10        
 
   74 x  105
 
+
 B0         
 
 2836 x 4008
 
+
 B1         
 
 2004 x 2836
 
+
 B2         
 
 1418 x 2004
 
+
 B3         
 
 1002 x 1418
 
+
 B4         
 
  709 x 1002
 
+
 B5         
 
  501 x  709
 
+
 C0         
 
 2600 x 3677
 
+
 C1         
 
 1837 x 2600
 
+
 C2         
 
 1298 x 1837
 
+
 C3         
 
  918 x 1298
 
+
 C4         
 
  649 x  918
 
+
 C5         
 
  459 x  649
 
+
 C6         
 
  323 x  459
 
+
 Flsa       
 
  612 x  936
 
+
 Flse       
 
  612 x  936
 
+
 HalfLetter 
 
  396 x  612
 
+

 
 
This option is also used to place subimages when writing to a multi-image
 format that supports offsets, such as GIF89 and MNG. When used for this
@@ -5923,7 +5920,7 @@ neighborhood whose width is specified with radius.

 
 
The exponents may be positive, negative or zero. A negative exponent is equivalent to 1 divided by the image raised to the corresponding positive exponent. A zero exponent always produces 1 scaled by quantumrange to white, i.e. wt*white, no matter what the image.

 
-
The format is: output = wt1*image1^exp1 + wt2*image2^exp2 ...

+
The format is: output = wt1*image1^exp1 + wt2*image2^exp2 ...

 
 
Some simple uses are:
diff --git a/www/magick++.html b/www/magick++.html index efe1dac80..a5231e93a 100644 --- a/www/magick++.html +++ b/www/magick++.html @@ -158,7 +158,7 @@
- Search + Search
@@ -293,7 +293,7 @@ of installing ImageMagick in a known location.
© 1999-2015 ImageMagick Studio LLC - Contact the Wizards + Contact the Wizards
diff --git a/www/magick.html b/www/magick.html index 4ab7c06a9..51951de63 100644 --- a/www/magick.html +++ b/www/magick.html @@ -141,7 +141,7 @@
- Search + Search
@@ -1383,7 +1383,7 @@ transparent, extract, background, or shape the alpha channel
© 1999-2011 ImageMagick Studio LLC - Contact the Wizards + Contact the Wizards