From cf3b108086a500ee2f8a58a491a2792b5fb40ff7 Mon Sep 17 00:00:00 2001 From: Cristy Date: Sat, 9 Dec 2017 18:04:00 -0500 Subject: [PATCH] ... --- index.html | 58 +- www/ImageMagickObject.html | 80 +- www/advanced-unix-installation.html | 53 +- www/advanced-windows-installation.html | 55 +- www/animate.html | 527 +-- www/api.html | 2 +- www/api/Image++.html | 351 +- www/api/animate.html | 507 +-- www/api/annotate.html | 51 +- www/api/attribute.html | 51 +- www/api/blob.html | 51 +- www/api/cache-view.html | 80 +- www/api/cache.html | 80 +- www/api/channel.html | 51 +- www/api/cipher.html | 309 +- www/api/color.html | 54 +- www/api/colormap.html | 51 +- www/api/colorspace.html | 51 +- www/api/compare.html | 166 +- www/api/composite.html | 546 +-- www/api/constitute.html | 51 +- www/api/decorate.html | 51 +- www/api/deprecate.html | 51 +- www/api/display.html | 541 +-- www/api/distort.html | 51 +- www/api/draw.html | 51 +- www/api/drawing-wand.html | 51 +- www/api/effect.html | 51 +- www/api/enhance.html | 51 +- www/api/exception.html | 52 +- www/api/feature.html | 51 +- www/api/fourier.html | 51 +- www/api/fx.html | 1072 +++-- www/api/histogram.html | 51 +- www/api/image-view.html | 80 +- www/api/image.html | 51 +- www/api/layer.html | 51 +- www/api/list.html | 51 +- www/api/magick++-classes.html | 69 +- www/api/magick-deprecate.html | 51 +- www/api/magick-image.html | 52 +- www/api/magick-property.html | 51 +- www/api/magick-wand.html | 56 +- www/api/magick.html | 1333 +------ www/api/memory.html | 51 +- www/api/mime.html | 51 +- www/api/module.html | 80 +- www/api/mogrify.html | 1296 +------ www/api/monitor.html | 51 +- www/api/montage.html | 613 +-- www/api/morphology.html | 51 +- www/api/paint.html | 51 +- www/api/pixel-iterator.html | 51 +- www/api/pixel-wand.html | 51 +- www/api/profile.html | 80 +- www/api/property.html | 80 +- www/api/quantize.html | 54 +- www/api/registry.html | 51 +- www/api/resize.html | 51 +- www/api/resource.html | 80 +- www/api/segment.html | 51 +- www/api/shear.html | 51 +- www/api/signature.html | 51 +- www/api/statistic.html | 51 +- www/api/stream.html | 291 +- www/api/transform.html | 51 +- www/api/version.html | 51 +- www/api/wand-view.html | 80 +- www/architecture.html | 72 +- www/binary-releases.html | 2 +- www/changelog.html | 72 +- www/cipher.html | 50 +- www/color-management.html | 50 +- www/color.html | 4954 +++++++++++++++++++++++- www/command-line-options.html | 156 +- www/command-line-processing.html | 92 +- www/command-line-tools.html | 68 +- www/compare.html | 74 +- www/compose.html | 83 +- www/composite.html | 516 +-- www/conjure.html | 74 +- www/connected-components.html | 52 +- www/contact.html | 50 +- www/convert.html | 528 +-- www/develop.html | 62 +- www/display.html | 561 +-- www/distribute-pixel-cache.html | 50 +- www/download.html | 58 +- www/escape.html | 74 +- www/examples.html | 52 +- www/exception.html | 51 +- www/export.html | 72 +- www/formats.html | 162 +- www/fx.html | 50 +- www/gradient.html | 68 +- www/high-dynamic-range.html | 50 +- www/history.html | 70 +- www/identify.html | 134 +- www/import.html | 74 +- www/index.html | 58 +- www/install-source.html | 84 +- www/jp2.html | 72 +- www/license.html | 72 +- www/links.html | 50 +- www/magick++.html | 74 +- www/magick-core.html | 74 +- www/magick-script.html | 74 +- www/magick-vector-graphics.html | 76 +- www/magick-wand.html | 74 +- www/magick.html | 1353 +------ www/miff.html | 74 +- www/mirror.html | 72 +- www/mogrify.html | 1316 +------ www/montage.html | 50 +- www/motion-picture.html | 52 +- www/opencl.html | 50 +- www/openmp.html | 50 +- www/perl-magick.html | 150 +- www/porting.html | 50 +- www/quantize.html | 53 +- www/resources.html | 54 +- www/search.html | 70 +- www/security-policy.html | 50 +- www/sitemap.html | 90 +- www/stream.html | 283 +- www/subversion.html | 2 +- www/support.html | 52 +- www/webp.html | 72 +- 128 files changed, 10504 insertions(+), 13292 deletions(-) diff --git a/index.html b/index.html index 2e142c738..636e3f521 100644 --- a/index.html +++ b/index.html @@ -5,34 +5,34 @@ - - + + Convert, Edit, Or Compose Bitmap Images @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
-
+

Features and Capabilities • News • Community

@@ -88,7 +88,7 @@ Use ImageMagickcommand-line or you can use the features from programs written in your favorite language. Choose from these interfaces: G2F (Ada), MagickCore (C), MagickWand (C), ChMagick (Ch), ImageMagickObject (COM+), Magick++ (C++), JMagick (Java), JuliaIO (Julia), L-Magick (Lisp), Lua (LuaJIT), NMagick (Neko/haXe), Magick.NET (.NET), PascalMagick (Pascal), PerlMagick (Perl), MagickWand for PHP (PHP), IMagick (PHP), PythonMagick (Python), magick (R), RMagick (Ruby), or TclMagick (Tcl/TK). With a language interface, use ImageMagick to modify or create images dynamically and automagically.

ImageMagick utilizes multiple computational threads to increase performance and can read, process, or write mega-, giga-, or tera-pixel image sizes.

-

ImageMagick is free software delivered as a ready-to-run binary distribution or as source code that you may use, copy, modify, and distribute in both open and proprietary applications. It is distributed under the Apache 2.0 license.

+

ImageMagick is free software delivered as a ready-to-run binary distribution or as source code that you may use, copy, modify, and distribute in both open and proprietary applications. It is distributed under the Apache 2.0 license.

The ImageMagick development process ensures a stable API and ABI. Before each ImageMagick release, we perform a comprehensive security assessment that includes memory error and thread data race detection to help prevent security vulnerabilities.

@@ -131,7 +131,7 @@ Use ImageMagickDelineate image features + Delineate image features Canny edge detection, Hough lines. @@ -199,7 +199,7 @@ Use ImageMagickNoise and color reduction + Noise and color reduction Kuwahara Filter, mean-shift. @@ -273,4 +273,4 @@ Use ImageMagick<\/script>') - \ No newline at end of file + \ No newline at end of file diff --git a/www/ImageMagickObject.html b/www/ImageMagickObject.html index a29beae4e..074c83b00 100644 --- a/www/ImageMagickObject.html +++ b/www/ImageMagickObject.html @@ -5,34 +5,34 @@ - - + + Install the ImageMagickObject COM+ Component @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
-
-
+
-

Build ImageMagickObject From Source

+

Build ImageMagickObject From Source

The ImageMagickObject is a COM+ compatible component that can be invoked from any language capable of using COM objects. The intended use is for Windows Scripting Host VBS scripts and Visual Basic, but it is also available from to C++, ASP, and other languages like Delphi, Perl and PHP.

-

The ImageMagickObject COM+ component provides access to the compare, convert, composite, mogrify, identify, montage, and stream tools, efficiently executing them as part of your process, rather than as external programs. The way you use it is exactly the same. You pass it a list of strings including filenames and various options and it does the job. In fact, you can take any existing batch scripts that use the command line tools and translate them into the equivalent calls to the COM+ object in a matter of minutes. Beyond that, there is also a way to pass in and retrieve images in memory in the form of standard smart arrays (byte arrays). Samples are provided, to show both the simple and more elaborate forms of access.

+

The ImageMagickObject COM+ component provides access to the compare, convert, composite, mogrify, identify, montage, and stream tools, efficiently executing them as part of your process, rather than as external programs. The way you use it is exactly the same. You pass it a list of strings including filenames and various options and it does the job. In fact, you can take any existing batch scripts that use the command line tools and translate them into the equivalent calls to the COM+ object in a matter of minutes. Beyond that, there is also a way to pass in and retrieve images in memory in the form of standard smart arrays (byte arrays). Samples are provided, to show both the simple and more elaborate forms of access.

-

ImageMagick provides a statically-built ImageMagick object as part of its Windows installation package. When this package is installed, ImageMagickObject and its sample programs are installed to this path:

+

ImageMagick provides a statically-built ImageMagick object as part of its Windows installation package. When this package is installed, ImageMagickObject and its sample programs are installed to this path:

  c:\Program Files\ImageMagick-7.0.7-Q16\ImageMagickObject
 
@@ -99,7 +99,7 @@
cscript SimpleTest.vbs
 
-

Since the ImageMagick utility command line parsers are incorporated within ImageMagickObject, please refer to the command-line tools discussion to learn how to use it. The sample VBS scripts show how the object should be called and used and have lots of comments.

+

Since the ImageMagick utility command line parsers are incorporated within ImageMagickObject, please refer to the command-line tools discussion to learn how to use it. The sample VBS scripts show how the object should be called and used and have lots of comments.

C++ programmers should have a look at the MagickCMD.cpp command line utility for an example of how to call the object from C++. The object requires a variable size list of BSTR's to emulate the command line argc, argv style calling conventions of the COM component which is more complex in C++ then in VBS or VB.

@@ -133,13 +133,13 @@ BuildImageMagickObject release
-

Security • - Architecture • - Related • - Sitemap • +

Security • + Architecture • + Related • + Sitemap • Public Key

-

Donate • +

Donate • Back to top • Contact Us

© 1999-2018 ImageMagick Studio LLC

@@ -150,4 +150,4 @@ BuildImageMagickObject release - \ No newline at end of file + \ No newline at end of file diff --git a/www/advanced-unix-installation.html b/www/advanced-unix-installation.html index fad5f0b43..79dbcc9ca 100644 --- a/www/advanced-unix-installation.html +++ b/www/advanced-unix-installation.html @@ -5,34 +5,34 @@ - - + + Advanced Unix Source Installation @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
-
+

Download & Unpack • Configure • Build • Install • Linux-specific Build Instructions • Mac OS X-specific Build Instructions • MinGW-specific Build Instructions • Dealing with Unexpected Problems

-

It's possible you don't want to concern yourself with advanced installation under Unix or Linux systems. If so, you also have the option of installing a pre-compiled binary release or if you still want to install from source without all the fuss see the simple Install From Source instructions. However, if you want to customize the configuration and installation of ImageMagick under Unix or Linux systems, lets begin.

+

It's possible you don't want to concern yourself with advanced installation under Unix or Linux systems. If so, you also have the option of installing a pre-compiled binary release or if you still want to install from source without all the fuss see the simple Install From Source instructions. However, if you want to customize the configuration and installation of ImageMagick under Unix or Linux systems, lets begin.

Download & Unpack

@@ -628,7 +628,7 @@ no encode delegate for this image format

Donate • Back to top • - Contact Us

+ Contact Us

© 1999-2018 ImageMagick Studio LLC

@@ -637,3 +637,4 @@ no encode delegate for this image format + \ No newline at end of file diff --git a/www/advanced-windows-installation.html b/www/advanced-windows-installation.html index 7d6e32777..7ab0be8a4 100644 --- a/www/advanced-windows-installation.html +++ b/www/advanced-windows-installation.html @@ -5,34 +5,34 @@ - - + + Advanced Windows Source Installation @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
-
+

Download & Unpack • Configure • Build • Install • Create a Self-installing Binary Distribution • Dealing with Unexpected Problems • Building Your Custom Project

-

It's possible you don't want to concern yourself with advanced installation under Windows. If so, you also have the option of installing a self-installing binary release or if you still want to install from source without all the fuss see the simple Install From Source instructions. However, if you want to customize the configuration and installation of ImageMagick under Windows, lets begin.

+

It's possible you don't want to concern yourself with advanced installation under Windows. If so, you also have the option of installing a self-installing binary release or if you still want to install from source without all the fuss see the simple Install From Source instructions. However, if you want to customize the configuration and installation of ImageMagick under Windows, lets begin.

Download & Unpack

@@ -277,7 +277,7 @@ ImageMagick\VisualMagick\contrib\win32\MFC\NtMagick (project - DSP)

ImageMagick is now configured and built. You can optionally install it on your system as discussed below.

-

If you are looking to install the ImageMagick COM+ object, see Installing the ImageMagickObject COM+ Component.

+

If you are looking to install the ImageMagick COM+ object, see Installing the ImageMagickObject COM+ Component.

Install

@@ -401,7 +401,7 @@ _MAGICKMOD_

Donate • Back to top • - Contact Us

+ Contact Us

© 1999-2018 ImageMagick Studio LLC

@@ -410,3 +410,4 @@ _MAGICKMOD_ + \ No newline at end of file diff --git a/www/animate.html b/www/animate.html index 1b4e2cec2..11a5e330d 100644 --- a/www/animate.html +++ b/www/animate.html @@ -5,34 +5,34 @@ - - - Command-line Tools: Animate @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + MagickCore, C API: Interactively Animate an Image Sequence @ ImageMagick + + + + + + + + + + + + + + + + + + + +
-
-
+
-

Example Usage • Option Summary

+

Unknown method

-

Use the animate program to animate an image sequence on any X server. See Command Line Processing for advice on how to structure your animate command or see below for example usages of the command.

- -

Example Usage

- -

We list a few examples of the animate command here to illustrate its usefulness and ease of use. To get started, lets animate an image sequence in the GIF format:

- -
magick animate movie.gif
-
- -

To animate a directory of JPEG images, use:

- -
magick animate *.jpg
-
- -

You can find additional examples of using animate in Examples of ImageMagick Usage.

- - -

Option Summary

- -

The animate command recognizes these options. Click on an option to get more details about how that option works.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
OptionDescription
-alphaon, activate, off, deactivate, set, opaque, copy", -transparent, extract, background, or shape the alpha channel
-antialiasremove pixel-aliasing
-authenticate valuedecrypt image with this password
-backdropbackground color
-background colorbackground color
-border geometrysurround image with a border of color
-bordercolor colorborder color
-channel typeapply option to select image channels
-clipclip along the first path from the 8BIM profile
-clip-path idclip along a named path from the 8BIM profile
-coalescemerge a sequence of images
-colormap typeShared or Private
-colors valuepreferred number of colors in the image
-colorspace typeset image colorspace
-comment stringannotate image with comment
-compress typeimage compression type
-contrastenhance or reduce the image contrast
-crop geometrypreferred size and location of the cropped image
-debug eventsanimate copious debugging information
-decipher filenameconvert cipher pixels to plain
-define format:optiondefine one or more image format options
-delay valueanimate the next image after pausing
-density geometryhorizontal and vertical density of the image
-depth valueimage depth
-despecklereduce the speckles within an image
-display serverget image or font from this X server
-dispose methodlayer disposal method
-dither methodapply error diffusion to image
-edge radiusapply a filter to detect edges in the image
-endian typeendianness (MSB or LSB) of the image
-enhanceapply a digital filter to enhance a noisy image
-extract geometryextract area from image
-filter typeuse this filter when resizing an image
-flattenflatten a sequence of images
-flipflip image in the vertical direction
-flopflop image in the horizontal direction
-frame geometrysurround image with an ornamental border
-gamma valuelevel of gamma correction
-geometry geometrypreferred size or location of the image
-gravity geometryhorizontal and vertical backdrop placement
-helpprint program options
-identifyidentify the format and characteristics of the image
-immutable typeprohibit image edits
-interlace typetype of image interlacing scheme
-interpolate methodpixel color interpolation method
-label nameassign a label to an image
-limit type valuepixel cache resource limit
-log formatformat of debugging information
-map filenametransform image colors to match this set of colors
-mattecolor colorframe color
-monitormonitor progress
-monochrometransform image to black and white
-negatereplace each pixel with its complementary color
-page geometrysize and location of an image canvas (setting)
-profile filenameadd, delete, or apply an image profile
-quantize colorspacereduce image colors in this colorspace
-quietsuppress all warning messages
-raise valuelighten/darken image edges to create a 3-D effect
-regard-warningspay attention to warning messages.
-remote commandexecute a command in an remote animate process
-resample geometrychange the resolution of an image
-resize geometryresize the image
-respect-parenthesessettings remain in effect until parenthesis boundary.
-roll geometryroll an image vertically or horizontally
-rotate degreesapply Paeth rotation to the image
-sample geometryscale image with pixel sampling
-sampling-factor geometryhorizontal and vertical sampling factor
-scene valueimage scene number
-segment valuessegment an image
-seed valueseed a new sequence of pseudo-random numbers
-set attribute valueset an image attribute
-sharpen geometrysharpen the image
-size geometrywidth and height of image
-stripstrip image of all profiles and comments
-thumbnail geometrycreate a thumbnail of the image
-transparent-color colortransparent color
-trimtrim image edges
-update secondsdetect when image file is modified and reanimate
-verboseprint detailed information about the image
-versionprint version information
-virtual-pixel methodaccess method for pixels outside the boundaries of the image
-visualanimate image using this visual type
-window idanimate images to background of this window
-window-group idexit program when this window id is destroyed
diff --git a/www/api/Image++.html b/www/api/Image++.html index 055f83e70..fd53967ec 100644 --- a/www/api/Image++.html +++ b/www/api/Image++.html @@ -5,34 +5,34 @@ - - + + Magick++, C++ API for ImageMagick: Image Class @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
-
+

Magick::Image Class

Image is the primary object in Magick++ and represents -a single image frame (see design ). The -STL interface must be used to operate on +a single image frame (see design ). The +STL interface must be used to operate on image sequences or images (e.g. of format GIF, TIFF, MIFF, Postscript, & MNG) which are comprised of multiple image frames. Individual frames of a multi-frame image may be requested by adding array-style @@ -93,7 +93,7 @@ notation to the end of the file name (e.g. "animation.gif[3]" retrieves the fourth frame of a GIF animation. Various image manipulation operations may be applied to the image. Attributes may be set on the image to influence the operation of the manipulation operations. The Pixels class provides low-level access to + href="../Magick++/Pixels.html"> Pixels class provides low-level access to image pixels. As a convenience, including <Magick++.h> is sufficient in order to use the complete Magick++ API. The Magick++ @@ -222,7 +222,7 @@ While encoded images (e.g. JPEG) are most often written-to and read-from a disk file, encoded images may also reside in memory. Encoded images in memory are known as BLOBs (Binary Large OBjects) and may be -represented using the Blob class. The encoded +represented using the Blob class. The encoded image may be initially placed in memory by reading it directly from a file, reading the image from a database, memory-mapped from a disk file, or could be written to memory by Magick++. Once the encoded image @@ -281,7 +281,7 @@ image.read( blob);

Image may be constructed in a number of ways. It may be constructed from a file, a URL, or an encoded image (e.g. JPEG) contained in an -in-memory BLOB . The available Image +in-memory BLOB . The available Image constructors are shown in the following table:

@@ -303,15 +303,15 @@ to select a specific scene from a multi-frame image. const Geometry &size_, const Color &color_ + href="../Magick++/Color.html"> Color &color_ Construct a blank image canvas of specified size and color const Blob &blob_ + href="../Magick++/Blob.html">Blob &blob_ Construct Image by reading from -encoded image data contained in an in-memory BLOB +encoded image data contained in an in-memory BLOB . Depending on the constructor arguments, the Blob size , depth , magick (format) may @@ -324,22 +324,22 @@ When a format can't be automagically detected, the format (magick ) must be specified. - const Blob -&blob_, const Geometry &size_ + const Blob +&blob_, const Geometry &size_ - const Blob -&blob_, const Geometry &size, + const Blob +&blob_, const Geometry &size, size_t depth - const Blob -&blob_, const Geometry &size, + const Blob +&blob_, const Geometry &size, size_t depth_, const string &magick_ - const Blob -&blob_, const Geometry &size, + const Blob +&blob_, const Geometry &size, const string &magick_ @@ -347,7 +347,7 @@ string &magick_ const size_t width_,
const size_t height_,
std::string map_,
- const + const StorageType type_,
const void *pixels_ Construct a new Image based on an array of @@ -379,7 +379,7 @@ order of the pixels in the supplied pixel array. type_ - Pixel + Pixel storage type (CharPixel, ShortPixel, IntegerPixel, FloatPixel, or DoublePixel) @@ -404,7 +404,7 @@ values and type_ parameters. image-list) manipulation operations provided by the ImageMagick library. If you must process a multi-image file (such as an animation), the STL interface , which provides a multi-image + href="../Magick++/STL.html"> STL interface , which provides a multi-image abstraction on top of Image, must be used.

Image manipulation methods are very easy to use. For example:

@@ -448,7 +448,7 @@ compute the threshold.
addNoise
- NoiseType + NoiseType noiseType_ Add noise to image with specified noise type. @@ -482,13 +482,13 @@ specified affine (or free transform) matrix.
annotate
const std::string &text_, const Geometry &location_ + href="../Magick++/Geometry.html"> Geometry &location_
Annotate using specified text, and placement location - string text_, const Geometry -&boundingArea_, GravityType + string text_, const Geometry +&boundingArea_, GravityType gravity_ Annotate using specified text, bounding area, and placement gravity. If boundingArea_ is invalid, then @@ -496,8 +496,8 @@ bounding area is entire image. const std::string &text_, const Geometry &boundingArea_, GravityType gravity_, double + href="../Magick++/Geometry.html"> Geometry &boundingArea_, GravityType gravity_, double degrees_, Annotate with text using specified text, bounding area, placement gravity, and rotation. If boundingArea_ @@ -505,7 +505,7 @@ is invalid, then bounding area is entire image. const std::string &text_, GravityType gravity_ + href="../Magick++/Enumerations.html#GravityType"> GravityType gravity_ Annotate with text (bounding area is entire image) and placement gravity. @@ -540,7 +540,7 @@ deviation of the Laplacian, in pixels.
border
- const Geometry + const Geometry &geometry_ = "6x6+0+0" Border image (add border to image). The color of the border is specified by the borderColor attribute. @@ -556,7 +556,7 @@ color of the border is specified by the borderColor attribute.
channel
- ChannelType + ChannelType layer_ Extract channel from image. Use this option to extract a particular channel from the image. MatteChannel @@ -578,7 +578,7 @@ parameter specifies the standard deviation of the Laplacian, in pixels.
chop
- const Geometry + const Geometry &geometry_ Chop image (remove vertical or horizontal subregion of image) @@ -610,7 +610,7 @@ image). By default, each image is commented with its file name. Use this method to assign a specific comment to the image. Optionally you can include the image filename, type, width, height, or other image attributes by embedding special format characters. + href="../Magick++/FormatCharacters.html">special format characters.

const
Image &compositeImage_, ssize_t xOffset_, ssize_t yOffset_, CompositeOperator + href="../Magick++/Enumerations.html#CompositeOperator"> CompositeOperator compose_ = InCompositeOp Compose an image onto the current image at offset specified by xOffset_, yOffset_ using the @@ -642,8 +642,8 @@ composition algorithm specified by compose_. const Image -&compositeImage_, const Geometry -&offset_, CompositeOperator +&compositeImage_, const Geometry +&offset_, CompositeOperator compose_ = InCompositeOp Compose an image onto the current image at offset specified by offset_ using the composition algorithm @@ -651,8 +651,8 @@ specified by compose_ . const Image -&compositeImage_, GravityType -gravity_, CompositeOperator +&compositeImage_, GravityType +gravity_, CompositeOperator compose_ = InCompositeOp Compose an image onto the current image with placement specified by gravity_ using the composition @@ -682,7 +682,7 @@ kernel to apply.
crop
- const Geometry + const Geometry &geometry_ Crop image (subregion of original image) @@ -723,12 +723,12 @@ distortion to the image.
draw
- const Drawable + const Drawable &drawable_ Draw shape or text on image. - const std::list<Drawable + const std::list<Drawable > &drawable_ Draw shapes or text on image using a set of Drawable objects contained in an STL list. Use of this method improves @@ -780,22 +780,22 @@ background color.
extent - const Geometry &geometry_ + const Geometry &geometry_ extends the image as defined by the geometry, gravity, and image background color. - const Geometry -&geometry_, const Color &backgroundColor_ + const Geometry +&geometry_, const Color &backgroundColor_ - const Geometry &geometry_, const GravityType + const Geometry &geometry_, const GravityType &gravity_ extends the image as defined by the geometry, gravity, and image background color. - const Geometry -&geometry_, const Color &backgroundColor_, -const GravityType &gravity_ + const Geometry +&geometry_, const Color &backgroundColor_, +const GravityType &gravity_ @@ -812,28 +812,28 @@ vertical direction) Color
ssize_t x_, ssize_t y_, const Color &fillColor_ + href="../Magick++/Color.html"> Color &fillColor_
Flood-fill color across pixels that match the color of the target pixel and are neighbors of the target pixel. Uses current fuzz setting when determining color match. - const Geometry -&point_, const Color &fillColor_ + const Geometry +&point_, const Color &fillColor_ ssize_t x_, ssize_t y_, const Color &fillColor_, const Color + href="../Magick++/Color.html"> Color &fillColor_, const Color &borderColor_ Flood-fill color across pixels starting at target-pixel and stopping at pixels matching specified border color. Uses current fuzz setting when determining color match. - const Geometry -&point_, const Color &fillColor_, -const Color &borderColor_ + const Geometry +&point_, const Color &fillColor_, +const Color &borderColor_ - const Geometry + const Geometry &point_, const Image &texture_ ssize_t x_, ssize_t y_, const Image -&texture_, const Color &borderColor_ +&texture_, const Color &borderColor_ Flood-fill texture across pixels starting at target-pixel and stopping at pixels matching specified border color. Uses current fuzz setting when determining color match. - const Geometry -&point_, const Image &texture_, const + const Geometry +&point_, const Image &texture_, const Color &borderColor_ @@ -885,7 +885,7 @@ horizontal direction)
frame
- const Geometry + const Geometry &geometry_ = "25x25+6+6" Add decorative frame around image @@ -973,7 +973,7 @@ specified by 'sigma_'. Assign a label to an image. Use this option to assign a specific label to the image. Optionally you can include the image filename, type, width, height, or scene -number in the label by embedding +number in the label by embedding special format characters. If the first character of string is @, the image label is read from a file titled by the remaining characters in @@ -1047,10 +1047,10 @@ with this option.
matteFloodfill
- const Color + const Color &target_, const unsigned int opacity_, const ssize_t x_, const ssize_t -y_, PaintMethod method_ +y_, PaintMethod method_ Floodfill designated area with a replacement opacity value. @@ -1065,7 +1065,7 @@ component with the median color in a circular neighborhood
mergeLayers
- LayerMethod + LayerMethod noiseType_ handle multiple images forming a set of image layers or animation frames. @@ -1157,8 +1157,8 @@ respectively.
opaque
- const Color -&opaqueColor_, const Color &penColor_ + const Color +&opaqueColor_, const Color &penColor_ Change color of pixels matching opaqueColor_ to specified penColor_. @@ -1206,7 +1206,7 @@ measureError_ to true in order to calculate error attributes.
raise
- const Geometry + const Geometry &geometry_ = "6x6+0+0", bool raisedFlag_ = false Raise image (lighten or darken the edges of an image to give a 3-D raised or lowered effect) @@ -1219,7 +1219,7 @@ an image to give a 3-D raised or lowered effect) Read image into current object - const Geometry + const Geometry &size_, const std::string &imageSpec_ Read image of specified size into current object. This form is useful for images that do not specify their size @@ -1229,9 +1229,9 @@ library to return an image which is the next resolution greater or equal to the specified size. This may result in memory and time savings. - const Blob &blob_ + const Blob &blob_ Read encoded image of specified -size from an in-memory BLOB into current +size from an in-memory BLOB into current object. Depending on the method arguments, the Blob size, depth, and format may also be specified. Some image formats require that size be specified. The default ImageMagick uses for depth depends on its @@ -1242,22 +1242,22 @@ When a format can't be automagically detected, the format must be specified. - const Blob -&blob_, const Geometry &size_ + const Blob +&blob_, const Geometry &size_ - const Blob -&blob_, const Geometry &size_, + const Blob +&blob_, const Geometry &size_, size_t depth_ - const Blob -&blob_, const Geometry &size_, + const Blob +&blob_, const Geometry &size_, size_t depth_, const string &magick_ - const Blob -&blob_, const Geometry &size_, + const Blob +&blob_, const Geometry &size_, const string &magick_ @@ -1364,7 +1364,7 @@ number of degrees.
sample
- const Geometry + const Geometry &geometry_ Resize image by using pixel sampling algorithm @@ -1372,7 +1372,7 @@ number of degrees.
scale
- const Geometry + const Geometry &geometry_ Resize image by using simple ratio algorithm @@ -1479,7 +1479,7 @@ exposing a photographic film to light during the development process)
splice
- const Geometry + const Geometry &geometry_ splice the background color into the image @@ -1548,21 +1548,21 @@ background color.
transform
- const Geometry + const Geometry &imageGeometry_ Transform image based on image and crop geometries. Crop geometry is optional. - const Geometry -&imageGeometry_, const Geometry + const Geometry +&imageGeometry_, const Geometry &cropGeometry_
transparent
- const Color + const Color &color_ Add matte image to image, setting pixels matching color to transparent. @@ -1633,9 +1633,9 @@ original image will be quantized to fewer colors. Use a copy of the original if this is a problem. - Blob *blob_ + Blob *blob_ Write image to a in-memory BLOB stored in blob_. The magick_ + href="../Magick++/Blob.html"> BLOB stored in blob_. The magick_ parameter specifies the image format to write (defaults to magick ). The depth_ parameter species the image depth (defaults to depth ).
@@ -1646,11 +1646,11 @@ original image will be quantized to fewer colors. Use a copy of the original if this is a problem.
- Blob *blob_, + Blob *blob_, std::string &magick_ - Blob *blob_, + Blob *blob_, std::string &magick_, size_t depth_ @@ -1716,7 +1716,7 @@ values and type_ parameters.
resize
- const Geometry + const Geometry &geometry_ Resize image to specified size. @@ -1833,9 +1833,9 @@ similar to "EXIF:DateTime".

Color - Color + Color void - const Color + const Color &color_ Image background color @@ -1882,9 +1882,9 @@ texture. Does not modify image pixels.
borderColor
- Color + Color void - const Color + const Color &color_ Image border color @@ -1902,9 +1902,9 @@ crop(Geometry(0,0)).
boxColor
- Color + Color void - const Color + const Color &boxColor_ Base color that annotation text is rendered on. @@ -1999,10 +1999,10 @@ y=0.329)
classType
- ClassType + ClassType void - ClassType + ClassType class_ Image storage class. Note that conversion from a DirectClass image to a PseudoClass image may result @@ -2038,10 +2038,10 @@ are close to the target color in RGB space.
colorMap
- Color + Color size_t index_ size_t index_, const Color &color_ + href="../Magick++/Color.html"> Color &color_
Color at colormap index. @@ -2069,10 +2069,10 @@ ensure that the image colormap indexes reference valid colormap entries.
<
colorSpace
- ColorspaceType + ColorspaceType colorSpace_ void - ColorspaceType + ColorspaceType colorSpace_ The colorspace (e.g. CMYK) used to represent the image pixel colors. Image pixels are always stored as RGB(A) except @@ -2100,11 +2100,11 @@ for the case of CMY(K).
compose
- CompositeOperator + CompositeOperator void CompositeOperator + href="../Magick++/Enumerations.html#CompositeOperator">CompositeOperator compose_ Composition operator to be used when composition is implicitly used (such as for image flattening). @@ -2115,11 +2115,11 @@ composition is implicitly used (such as for image flattening).
Type - CompressionType + CompressionType void CompressionType + href="../Magick++/Enumerations.html#CompressionType">CompressionType compressType_ Image compresion type. The default is the compression type of the specified image file. @@ -2185,10 +2185,10 @@ exists.
density
- Geometry + Geometry (default 72x72) void - const Geometry + const Geometry &density_ Vertical and horizontal resolution in pixels of the image. This option specifies an image density when decoding a @@ -2210,10 +2210,10 @@ ImageMagick is compiled with.
endian
- EndianType + EndianType void - EndianType + EndianType endian_ Specify (or obtain) endian option for formats which support it. @@ -2277,7 +2277,7 @@ objects.
fillRule
- FillRule + FillRule void const Magick::FillRule &fillRule_ @@ -2287,10 +2287,10 @@ objects.
filterType
- FilterTypes + FilterTypes void - FilterTypes + FilterTypes filterType_ Filter to use when resizing image. The reduction filter employed has a significant effect on the time required @@ -2324,9 +2324,9 @@ server. To use a TrueType font, precede the TrueType filename with an
fontTypeMetrics
- TypeMetric + TypeMetric const std::string &text_, TypeMetric *metrics + href="../Magick++/TypeMetric.html"> TypeMetric *metrics
Update metrics with font type metrics using specified text, and current font and
geometry
- Geometry + Geometry void Preferred size of the image when encoding. @@ -2385,12 +2385,12 @@ disposed of) when creating a GIF animation.
iccColorProfile
- Blob + Blob void - const Blob + const Blob &colorProfile_ ICC color profile. Supplied via a Blob since Magick++/ and ImageMagick do not + href="../Magick++/Blob.html"> Blob since Magick++/ and ImageMagick do not currently support formating this data structure directly. Specifications are available from the International Color Consortium for the format of ICC color profiles. @@ -2401,10 +2401,10 @@ International Color Consortium for the format of ICC color profiles.<
Type - InterlaceType + InterlaceType void - InterlaceType + InterlaceType interlace_ The type of interlacing scheme (default NoInterlace ). This option is used to specify the type of interlacing @@ -2421,12 +2421,12 @@ image.
iptcProfile
- Blob + Blob void - const Blob & + const Blob & iptcProfile_ IPTC profile. Supplied via a Blob since Magick++ and ImageMagick do not + href="../Magick++/Blob.html"> Blob since Magick++ and ImageMagick do not currently support formating this data structure directly. Specifications are available from the International Press Telecommunications Council for IPTC profiles. @@ -2464,9 +2464,9 @@ an opaque one.
matteColor
- Color + Color void - const Color + const Color &matteColor_ Image matte (frame) color @@ -2521,7 +2521,7 @@ using this method.

Geometry - Geometry + Geometry void Tile size and offset within an image montage. @@ -2558,11 +2558,11 @@ is set to true and the image has just been quantized. name="orientation">orientation
OrientationType + href="../Magick++/Enumerations.html#OrientationType">OrientationType void
OrientationType + href="../Magick++/Enumerations.html#OrientationType">OrientationType orientation_ Image orientation. Supported by some file formats such as DPX and TIFF. Useful for @@ -2593,11 +2593,11 @@ turning the right way up.
page
- Geometry + Geometry void const Geometry &pageSize_ + href="../Magick++/Geometry.html#PostscriptPageSize"> Geometry &pageSize_ Preferred size and location of an image canvas.

Use this option to specify the dimensions @@ -2612,10 +2612,10 @@ image (such as for a scene in an animation)

pixelColor
- Color + Color ssize_t x_, ssize_t y_ ssize_t x_, ssize_t y_, const Color &color_ + href="../Magick++/Color.html"> Color &color_
Get/set pixel color at location x & y. @@ -2623,7 +2623,7 @@ image (such as for a scene in an animation)

profile
- Blob
+
Blob
const std::string name_
@@ -2664,10 +2664,10 @@ option will have any duplicate or unused colors removed.
ColorSpace - ColorspaceType + ColorspaceType void - ColorspaceType + ColorspaceType colorSpace_ Colorspace to quantize colors in (default RGB). Empirical evidence suggests that distances in color spaces such @@ -2714,10 +2714,10 @@ may be used to manually adjust the tree depth.
Intent - RenderingIntent + RenderingIntent void - RenderingIntent + RenderingIntent render_ The type of rendering intent @@ -2727,10 +2727,10 @@ render_
Units - ResolutionType + ResolutionType void - ResolutionType + ResolutionType units_ Units of image resolution @@ -2766,9 +2766,9 @@ force re-computation of signature.
size
- Geometry + Geometry void - const Geometry + const Geometry &geometry_ Width and height of a raw image (an image which does not support width and height information). Size may @@ -2943,11 +2943,11 @@ designed to support Unicode.

type
- ImageType + ImageType void ImageType + href="../Magick++/Enumerations.html#ImageType"> ImageType Image type. @@ -2972,11 +2972,11 @@ designed to support Unicode.

virtualPixelMethod
- VirtualPixelMethod + VirtualPixelMethod void VirtualPixelMethod + href="../Magick++/Enumerations.html#VirtualPixelMethod">VirtualPixelMethod virtualPixelMethod_ Image virtual pixel method. @@ -3021,12 +3021,12 @@ disk). Two interfaces exist to access the Image Pixel Cache. The interface described here (part of the Image class) supports only -one view at a time. See the Pixels +one view at a time. See the Pixels class for a more abstract interface which supports simultaneous pixel views (up to the number of rows). As an analogy, the interface described -here relates to the Pixels class as -stdio's gets() relates to fgets(). The Pixels +here relates to the Pixels class as +stdio's gets() relates to fgets(). The Pixels class provides the more general form of the interface.

Obtain existing image pixels via getPixels(). Create a new pixel region using setPixels().

@@ -3051,7 +3051,7 @@ representation according to the format specified by QuantumTypes.

may be accessed, addressed, and updated, as shown in the following example:
-

+

Image image("cow.png"); // Ensure that there are no other references to this image. image.modifyImage(); @@ -3186,7 +3186,7 @@ should never be deallocated by the user.
readPixels
void - QuantumTypes + QuantumTypes quantum_, unsigned char *source_, Transfers one or more pixel components from a buffer or file into the image pixel cache of an image. ReadPixels is @@ -3198,7 +3198,7 @@ corresponds to the region set by a preceding setPixels call.
writePixels
void - QuantumTypes + QuantumTypes quantum_, unsigned char *destination_ Transfers one or more pixel components from the image pixel cache to a buffer or file. WritePixels is typically @@ -3230,3 +3230,4 @@ the region set by a preceding getPixels or getConstPixels call. + \ No newline at end of file diff --git a/www/api/animate.html b/www/api/animate.html index bbc5a7ec1..1387c6e63 100644 --- a/www/api/animate.html +++ b/www/api/animate.html @@ -5,34 +5,34 @@ - - - Command-line Tools: Animate @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + MagickCore, C API: Interactively Animate an Image Sequence @ ImageMagick + + + + + + + + + + + + + + + + + + + +
-
+
-

Example Usage • Option Summary

+

Unknown method

-

Use the animate program to animate an image sequence on any X server. See Command Line Processing for advice on how to structure your animate command or see below for example usages of the command.

- -

Example Usage

- -

We list a few examples of the animate command here to illustrate its usefulness and ease of use. To get started, lets animate an image sequence in the GIF format:

- -
magick animate movie.gif
-
- -

To animate a directory of JPEG images, use:

- -
magick animate *.jpg
-
- -

You can find additional examples of using animate in Examples of ImageMagick Usage.

- - -

Option Summary

- -

The animate command recognizes these options. Click on an option to get more details about how that option works.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
OptionDescription
-alphaon, activate, off, deactivate, set, opaque, copy", -transparent, extract, background, or shape the alpha channel
-antialiasremove pixel-aliasing
-authenticate valuedecrypt image with this password
-backdropbackground color
-background colorbackground color
-border geometrysurround image with a border of color
-bordercolor colorborder color
-channel typeapply option to select image channels
-clipclip along the first path from the 8BIM profile
-clip-path idclip along a named path from the 8BIM profile
-coalescemerge a sequence of images
-colormap typeShared or Private
-colors valuepreferred number of colors in the image
-colorspace typeset image colorspace
-comment stringannotate image with comment
-compress typeimage compression type
-contrastenhance or reduce the image contrast
-crop geometrypreferred size and location of the cropped image
-debug eventsanimate copious debugging information
-decipher filenameconvert cipher pixels to plain
-define format:optiondefine one or more image format options
-delay valueanimate the next image after pausing
-density geometryhorizontal and vertical density of the image
-depth valueimage depth
-despecklereduce the speckles within an image
-display serverget image or font from this X server
-dispose methodlayer disposal method
-dither methodapply error diffusion to image
-edge radiusapply a filter to detect edges in the image
-endian typeendianness (MSB or LSB) of the image
-enhanceapply a digital filter to enhance a noisy image
-extract geometryextract area from image
-filter typeuse this filter when resizing an image
-flattenflatten a sequence of images
-flipflip image in the vertical direction
-flopflop image in the horizontal direction
-frame geometrysurround image with an ornamental border
-gamma valuelevel of gamma correction
-geometry geometrypreferred size or location of the image
-gravity geometryhorizontal and vertical backdrop placement
-helpprint program options
-identifyidentify the format and characteristics of the image
-immutable typeprohibit image edits
-interlace typetype of image interlacing scheme
-interpolate methodpixel color interpolation method
-label nameassign a label to an image
-limit type valuepixel cache resource limit
-log formatformat of debugging information
-map filenametransform image colors to match this set of colors
-mattecolor colorframe color
-monitormonitor progress
-monochrometransform image to black and white
-negatereplace each pixel with its complementary color
-page geometrysize and location of an image canvas (setting)
-profile filenameadd, delete, or apply an image profile
-quantize colorspacereduce image colors in this colorspace
-quietsuppress all warning messages
-raise valuelighten/darken image edges to create a 3-D effect
-regard-warningspay attention to warning messages.
-remote commandexecute a command in an remote animate process
-resample geometrychange the resolution of an image
-resize geometryresize the image
-respect-parenthesessettings remain in effect until parenthesis boundary.
-roll geometryroll an image vertically or horizontally
-rotate degreesapply Paeth rotation to the image
-sample geometryscale image with pixel sampling
-sampling-factor geometryhorizontal and vertical sampling factor
-scene valueimage scene number
-segment valuessegment an image
-seed valueseed a new sequence of pseudo-random numbers
-set attribute valueset an image attribute
-sharpen geometrysharpen the image
-size geometrywidth and height of image
-stripstrip image of all profiles and comments
-thumbnail geometrycreate a thumbnail of the image
-transparent-color colortransparent color
-trimtrim image edges
-update secondsdetect when image file is modified and reanimate
-verboseprint detailed information about the image
-versionprint version information
-virtual-pixel methodaccess method for pixels outside the boundaries of the image
-visualanimate image using this visual type
-window idanimate images to background of this window
-window-group idexit program when this window id is destroyed
@@ -555,4 +104,4 @@ transparent, extract, background, or shape the alpha channel - \ No newline at end of file + \ No newline at end of file diff --git a/www/api/annotate.html b/www/api/annotate.html index 2ebee0910..9fed5baeb 100644 --- a/www/api/annotate.html +++ b/www/api/annotate.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Annotate an Image @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
-
+

AnnotateImageFormatMagickCaptionGetMultilineTypeMetricsGetTypeMetrics

@@ -325,3 +325,4 @@ MagickBooleanType GetTypeMetrics(Image *image,const DrawInfo *draw_info, + \ No newline at end of file diff --git a/www/api/attribute.html b/www/api/attribute.html index f26f7e0dc..07b31d045 100644 --- a/www/api/attribute.html +++ b/www/api/attribute.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Set Text Attributes @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
-
+

GetImageDepthGetImageQuantumDepthGetImageTypeIdentifyImageGrayIdentifyImageMonochromeIdentifyImageTypeIsImageGrayIsImageMonochromeIsImageOpaqueSetImageDepthSetImageType

@@ -409,3 +409,4 @@ MagickBooleanType SetImageType(Image *image,const ImageType type, + \ No newline at end of file diff --git a/www/api/blob.html b/www/api/blob.html index becc650db..54c7d7107 100644 --- a/www/api/blob.html +++ b/www/api/blob.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Read or Write Binary Large OBjects @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
-
+

BlobToImageCustomStreamToImageFileToBlobFileToImageGetBlobPropertiesImageToBlobImageToFileImagesToBlobInjectImageBlobIsBlobExemptIsBlobSeekableIsBlobTemporary

@@ -462,3 +462,4 @@ MagickBooleanType InjectImageBlob(const ImageInfo *image_info, + \ No newline at end of file diff --git a/www/api/cache-view.html b/www/api/cache-view.html index 760e34fe9..19cb73f4f 100644 --- a/www/api/cache-view.html +++ b/www/api/cache-view.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Cache Views @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
-
-
+
- - + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/api/cache.html b/www/api/cache.html index ad9c97d51..573f8cfb2 100644 --- a/www/api/cache.html +++ b/www/api/cache.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Get or Set Image Pixels @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
-
-
+
- - + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/api/channel.html b/www/api/channel.html index 5b7f302c5..9baa5af62 100644 --- a/www/api/channel.html +++ b/www/api/channel.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Get or Set Image Channels @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
-
+

ChannelFxImageCombineImagesGetImageAlphaChannelSeparateImageSeparateImagesSetImageAlphaChannel

@@ -289,3 +289,4 @@ MagickBooleanType SetImageAlphaChannel(Image *image, + \ No newline at end of file diff --git a/www/api/cipher.html b/www/api/cipher.html index 62ab17d38..f87be5b21 100644 --- a/www/api/cipher.html +++ b/www/api/cipher.html @@ -5,34 +5,34 @@ - - - Encipher or Decipher an Image @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + MagickCore, C API: Convert to and from Cipher Pixels @ ImageMagick + + + + + + + + + + + + + + + + + + + +
-
+
-

Encipher an Image • Decipher an Image • Encipher and Decipher Caveats

+

AcquireAESInfoDestroyAESInfoEncipherAESBlockPasskeyDecipherImagePasskeyEncipherImageSetAESKeyPasskeyDecipherImagePasskeyEncipherImage

-

Most images, by design, are made to be viewed often and by many people. Web images, for example, may be viewed hundreds of times a day by a multitude of vistors. However, in some cases, you may want to keep a particular image private so that only you or perhaps a select group of your friends or web visitors can view it. ImageMagick permits you to scramble your images such that unless someone knows your passphrase, they will be unable to view the original content.

+

AcquireAESInfo

-

You could use an enciphering utility to scramble your image but they typically scramble the entire file making it unrecognizable as an image format. With ImageMagick, only the pixels are scrambled. The scrambled image continues to be recognized as an image and will even display in your web page. However, the content appears as gibberish, nothing like the original content.

+

AcquireAESInfo() allocate the AESInfo structure.

-

Encipher an Image

+

The format of the AcquireAESInfo method is:

-

Use the -encipher option to scramble your image so that it is unrecognizable. The option requires a filename that contains your passphrase. In this example we scramble an image and save it in the PNG format:

+
+AESInfo *AcquireAESInfo(void)
+
-
convert rose.jpg -encipher passphrase.txt rose.png
-
+

DestroyAESInfo

-

Here we encipher an image using another image as the passphrase:

+

DestroyAESInfo() zeros memory associated with the AESInfo structure.

-
convert rose.jpg -encipher smiley.gif rose.png
-
+

The format of the DestroyAESInfo method is:

-

Decipher an Image

+
+AESInfo *DestroyAESInfo(AESInfo *aes_info)
+
-

Use the -decipher option to unscramble your image so that it is recognizable once again. The option requires a filename that contains your passphrase. In this example we unscramble an image and save it in the JPEG format:

+

A description of each parameter follows:

-
convert rose.png -decipher passphrase.txt rose.jpg
-
+
+
-

Encipher and Decipher Caveats

+
+
+
aes_info
+
the cipher context.
-

Some formats do not support enciphered pixels-- the JPEG or GIF format, for -example. To ensure your image format is supported, encipher a test image and -verify you can restore its original content before you encipher any -additional images in that format.

+
+
+

EncipherAESBlock

-

The image format may only support 8-bit and RGB (TrueColor). As such you may -like to include the options "-depth 8 -type TrueColor" before the output -filename.

+

EncipherAESBlock() enciphers a single block of plaintext to produce a block of ciphertext.

-

The passphrase can be any combinations of letters and symbols. It should -be a minimum of 12 character combinations to help ensure your image remains -private. Also make sure your passphrase file permissions prevent others from -reading it otherwise unintended users may be able to view the original image -content.

+

The format of the EncipherAESBlock method is:

-

You can only restore the original image content if you know your -passphrase. If you lose or forget it, your original image content is lost -forever.

+
+void EncipherAES(AESInfo *aes_info,const unsigned char *plaintext,
+  unsigned char *ciphertext)
+
-

ImageMagick only scrambles the image pixels. The image metadata remains -untouched and readable by anyone with access to the image file.

+

A description of each parameter follows:

-

ImageMagick uses the AES -cipher in Counter mode. We use the the first half of your passphrase to derive the nonce. The second half is the cipher key. When used correctly, AES-CTR provides a high level of confidentiality. To avoid information leaks, you must use a fresh passphrase for each image your encrypt.

+
+
-

Currently only ImageMagick can restore your enciphered image content. We -use a standard cipher and mode so other vendors could support enciphered image content.

+
+
+
aes_info
+
the cipher context.
-

Some small practical examples of image enciphering can be found in IM -Examples Encrypting Image Data.

+
+
plaintext
+
the plain text.
+
+
ciphertext
+
the cipher text.
+ +
+
+

PasskeyDecipherImage

+ +

PasskeyDecipherImage() converts cipher pixels to plain pixels.

+ +

The format of the PasskeyDecipherImage method is:

+ +
+MagickBooleanType PasskeyDecipherImage(Image *image,
+  const StringInfo *passkey,ExceptionInfo *exception)
+MagickBooleanType DecipherImage(Image *image,const char *passphrase,
+  ExceptionInfo *exception)
+
+ +

A description of each parameter follows:

+ +
+
+ +
+
+
image
+
the image.
+ +
+
passphrase
+
decipher cipher pixels with this passphrase.
+ +
+
passkey
+
decrypt cipher pixels with this passkey.
+ +
+
exception
+
return any errors or warnings in this structure.
+ +
+
+

PasskeyEncipherImage

+ +

PasskeyEncipherImage() converts pixels to cipher-pixels.

+ +

The format of the PasskeyEncipherImage method is:

+ +
+MagickBooleanType PasskeyEncipherImage(Image *image,
+  const StringInfo *passkey,ExceptionInfo *exception)
+MagickBooleanType EncipherImage(Image *image,const char *passphrase,
+  ExceptionInfo *exception)
+
+ +

A description of each parameter follows:

+ +
+
+ +
+
+
image
+
the image.
+ +
+
passphrase
+
encipher pixels with this passphrase.
+ +
+
passkey
+
decrypt cipher pixels with this passkey.
+ +
+
exception
+
return any errors or warnings in this structure.
+ +
+
+

SetAESKey

+ +

SetAESKey() sets the key for the AES cipher. The key length is specified in bits. Valid values are 128, 192, or 256 requiring a key buffer length in bytes of 16, 24, and 32 respectively.

+ +

The format of the SetAESKey method is:

+ +
+SetAESKey(AESInfo *aes_info,const StringInfo *key)
+
+ +

A description of each parameter follows:

+ +
+
+ +
+
+
aes_info
+
the cipher context.
+ +
+
key
+
the key.
+ +
+
+

PasskeyDecipherImage

+ +

PasskeyDecipherImage() converts cipher pixels to plain pixels.

+ +

The format of the PasskeyDecipherImage method is:

+ +
+MagickBooleanType PasskeyDecipherImage(Image *image,
+  const StringInfo *passkey,ExceptionInfo *exception)
+MagickBooleanType DecipherImage(Image *image,const char *passphrase,
+  ExceptionInfo *exception)
+
+ +

A description of each parameter follows:

+ +
+
+ +
+
+
image
+
the image.
+ +
+
passphrase
+
decipher cipher pixels with this passphrase.
+ +
+
passkey
+
decrypt cipher pixels with this passkey.
+ +
+
exception
+
return any errors or warnings in this structure.
+ +
+
+

PasskeyEncipherImage

+ +

PasskeyEncipherImage() converts pixels to cipher-pixels.

+ +

The format of the PasskeyEncipherImage method is:

+ +
+MagickBooleanType PasskeyEncipherImage(Image *image,
+  const StringInfo *passkey,ExceptionInfo *exception)
+MagickBooleanType EncipherImage(Image *image,const char *passphrase,
+  ExceptionInfo *exception)
+
+ +

A description of each parameter follows:

+ +
+
+ +
+
+
passphrase
+
decipher cipher pixels with this passphrase.
+ +
+
passkey
+
decrypt cipher pixels with this passkey.
+ +
+
exception
+
return any errors or warnings in this structure.
+ +
+
@@ -162,4 +337,4 @@ Examples window.jQuery || document.write(' - \ No newline at end of file + \ No newline at end of file diff --git a/www/api/color.html b/www/api/color.html index d6a5b8bcb..ef32b243d 100644 --- a/www/api/color.html +++ b/www/api/color.html @@ -5,34 +5,34 @@ - - + + Color Names @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
-
+

Example Usage • Color Model Specification • List of Color Names

A number of ImageMagick options and methods take a color as an argument. The color can then be given as a color name (there is a limited but large set of these; see below) or it can be given as a set of numbers (in decimal or hexadecimal), each corresponding to a channel in an RGB or RGBA color model. HSL, HSLA, HSB, HSBA, CMYK, or CMYKA color models may also be specified. These topics are briefly described in the sections below.

-

Use the Color Converter to supply any valid ImageMagick color specification as described below to see a color swatch of that color and to convert to all the other color models.

+

Use the Color Converter to supply any valid ImageMagick color specification as described below to see a color swatch of that color and to convert to all the other color models.

Example Usage

@@ -4954,4 +4954,4 @@ device-cmyk(0.11, 0.48, 0.83, 0.00) - \ No newline at end of file + \ No newline at end of file diff --git a/www/api/colormap.html b/www/api/colormap.html index ed3ca42e6..fa1339116 100644 --- a/www/api/colormap.html +++ b/www/api/colormap.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Colormap Methods @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
-
+

AcquireImageColormapCycleColormap

@@ -168,3 +168,4 @@ MagickBooleanType CycleColormapImage(Image *image,const ssize_t displace, + \ No newline at end of file diff --git a/www/api/colorspace.html b/www/api/colorspace.html index f069c5356..652a14634 100644 --- a/www/api/colorspace.html +++ b/www/api/colorspace.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Dealing with Image Colorspaces @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
-
+

SetImageColorspaceSetImageGraySetImageMonochromeTransformImageColorspace

@@ -220,3 +220,4 @@ MagickBooleanType TransformImageColorspace(Image *image, + \ No newline at end of file diff --git a/www/api/compare.html b/www/api/compare.html index 2bda36585..12a8108e9 100644 --- a/www/api/compare.html +++ b/www/api/compare.html @@ -5,34 +5,34 @@ - - + + Command-line Tools: Compare @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
-
+

Example Usage • Option Summary

@@ -96,9 +96,9 @@ magick compare -compose src rose.jpg reconstruct.jpg difference.png
    rose - rose + rose ==> - rose + rose

The red areas of the difference image emphasizes (highlight) pixels that are affected by the image sharpening, whereas white de-emphasizes (lowlight) pixels that are untouched by the sharpening process.

@@ -147,278 +147,278 @@ Image: rose.jpg - -alpha + -alpha on, activate, off, deactivate, set, opaque, copy", transparent, extract, background, or shape the alpha channel - -authenticate value + -authenticate value decrypt image with this password - -background color + -background color background color - -brightness-contrast geometry + -brightness-contrast geometry improve brightness / contrast of the image - -channel type + -channel type apply option to select image channels - -colorspace type + -colorspace type set image colorspace - -compose operator + -compose operator set image composite operator - -crop geometry + -crop geometry crop the image - -decipher filename + -decipher filename convert cipher pixels to plain - -debug events + -debug events display copious debugging information - -define format:option + -define format:option define one or more image format options - -density geometry + -density geometry horizontal and vertical density of the image - -depth value + -depth value image depth - -dissimilarity-threshold value + -dissimilarity-threshold value maximum distortion for (sub)image match (default 0.2) - -distort type coefficients + -distort type coefficients distort image - -encipher filename + -encipher filename convert plain pixels to cipher pixels - -extract geometry + -extract geometry extract area from image - -fuzz distance + -fuzz distance colors within this distance are considered equal - -gravity type + -gravity type horizontal and vertical text placement - -help + -help print program options - -highlight-color color + -highlight-color color emphasize pixel differences with this color - -identify + -identify identify the format and characteristics of the image - -interlace type + -interlace type type of image interlacing scheme - -level value + -level value adjust the level of image contrast - -limit type value + -limit type value pixel cache resource limit - -log format + -log format format of debugging information - -lowlight-color color + -lowlight-color color de-emphasize pixel differences with this color - -metric type + -metric type measure differences between images with this metric - -negate + -negate replace each pixel with its complementary color - -profile filename + -profile filename add, delete, or apply an image profile - -quality value + -quality value JPEG/MIFF/PNG compression level - -quantize colorspace + -quantize colorspace reduce image colors in this colorspace - -quiet + -quiet suppress all warning messages - -read-mask filename + -read-mask filename associate a read mask with the image - -regard-warnings + -regard-warnings pay attention to warning messages. - -repage geometry + -repage geometry size and location of an image canvas - -resize geometry + -resize geometry resize the image - -respect-parentheses + -respect-parentheses settings remain in effect until parenthesis boundary. - -rotate degrees + -rotate degrees apply Paeth rotation to the image - -sampling-factor geometry + -sampling-factor geometry horizontal and vertical sampling factor - -seed value + -seed value seed a new sequence of pseudo-random numbers - -separate + -separate separate an image channel into a grayscale image - -set attribute value + -set attribute value set an image attribute - -sigmoidal-contrast geometry + -sigmoidal-contrast geometry increase the contrast without saturating highlights or shadows - -similarity-threshold value + -similarity-threshold value minimum distortion for (sub)image match (default 0.0) - -size geometry + -size geometry width and height of image - -subimage-search + -subimage-search search for subimage - -synchronize + -synchronize synchronize image to storage device - -taint + -taint mark the image as modified - -transparent-color color + -transparent-color color transparent color - -trim + -trim trim image edges - -verbose + -verbose print detailed information about the image - -version + -version print version information - -virtual-pixel method + -virtual-pixel method access method for pixels outside the boundaries of the image - -read-mask filename + -read-mask filename associate a write mask with the image @@ -445,4 +445,4 @@ transparent, extract, background, or shape the alpha channel - \ No newline at end of file + \ No newline at end of file diff --git a/www/api/composite.html b/www/api/composite.html index a8d732d6a..a4135befd 100644 --- a/www/api/composite.html +++ b/www/api/composite.html @@ -5,34 +5,34 @@ - - - Command-line Tools: Composite @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + MagickCore, C API: Composite an Image @ ImageMagick + + + + + + + + + + + + + + + + + + + +
-
-
+
-

Example Usage • Option Summary

+

CompositeImageCommand

-

Use the composite program to overlap one image over another. See Command Line Processing for advice on how to structure your composite command or see below for example usages of the command.

+

CompositeImageCommand

-

Example Usage

+

CompositeImageCommand() reads one or more images and an optional mask and composites them into a new image.

-

We list a few examples of the composite command here to illustrate its usefulness and ease of use. To get started, lets overlay a smiley face over a rose:

+

The format of the CompositeImageCommand method is:

-
magick composite -gravity center smile.gif  rose: rose-over.png
-
+
+MagickBooleanType CompositeImageCommand(ImageInfo *image_info,int argc,
+  char **argv,char **metadata,ExceptionInfo *exception)
+
-
    - smile - over - rose - ==> - rose -
+

A description of each parameter follows:

-

You can create three-dimensional effect with the Atop:

+
+
-
magick convert -size 70x70 canvas:none -fill red -draw 'circle 35,35 10,30' red-circle.png
-magick convert -size 70x70 canvas:none -draw 'circle 35,35 35,20' -negate \
--channel A -gaussian-blur 0x8 white-highlight.png
-magick composite -compose atop -geometry -13-17 white-highlight.png red-circle.png red-ball.png
-
+
+
+
image_info
+
the image info.
-
    - white highlight - atop - red circle - ==> - red ball -
+
+
argc
+
the number of elements in the argument vector.
-

You can find additional examples of using composite in Examples of ImageMagick Usage. You can find out more about them and the mathematics by looking at SVG Alpha Compositing

+
+
argv
+
A text array containing the command line arguments.
-

Option Summary

+
+
metadata
+
any metadata is returned here.
-

The composite command recognizes these options. Click on an option to get more details about how that option works.

+
+
exception
+
return any errors or warnings in this structure.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
OptionDescription
-affine matrixaffine transform matrix
-alphaon, activate, off, deactivate, set, opaque, copy", -transparent, extract, background, or shape the alpha channel
-authenticate valuedecrypt image with this password
-blend geometryblend images
-blue-primary pointchromaticity blue primary point
-border geometrysurround image with a border of color
-bordercolor colorborder color
-channel typeapply option to select image channels
-colors valuepreferred number of colors in the image
-colorspace typeset image colorspace
-comment stringannotate image with comment
-compose operatorset image composite operator
-compress typeimage compression type
-debug eventsdisplay copious debugging information
-decipher filenameconvert cipher pixels to plain
-define format:optiondefine one or more image format options
-density geometryhorizontal and vertical density of the image
-depth valueimage depth
-displace geometryshift image pixels defined by a displacement map
-dissolve valuedissolve the two images a given percent
-dither methodapply error diffusion to image
-encipher filenameconvert plain pixels to cipher pixels
-encoding typetext encoding type
-endian typeendianness (MSB or LSB) of the image
-extract geometryextract area from image
-filter typeuse this filter when resizing an image
-font namerender text with this font
-geometry geometrypreferred size or location of the image
-gravity typehorizontal and vertical text placement
-green-primary pointchromaticity green primary point
-helpprint program options
-identifyidentify the format and characteristics of the image
-interlace typetype of image interlacing scheme
-interpolate methodpixel color interpolation method
-label stringassign a label to an image
-level valueadjust the level of image contrast
-limit type valuepixel cache resource limit
-log formatformat of debugging information
-monitormonitor progress
-monochrometransform image to black and white
-negatereplace each pixel with its complementary color
-page geometrysize and location of an image canvas (setting)
-pointsize valuefont point size
-profile filenameadd, delete, or apply an image profile
-quality valueJPEG/MIFF/PNG compression level
-quantize colorspacereduce image colors in this colorspace
-quietsuppress all warning messages
-red-primary pointchromaticity red primary point
-regard-warningspay attention to warning messages.
-respect-parenthesessettings remain in effect until parenthesis boundary.
-rotate degreesapply Paeth rotation to the image
-sampling-factor geometryhorizontal and vertical sampling factor
-scene valueimage scene number
-seed valueseed a new sequence of pseudo-random numbers
-set attribute valueset an image attribute
-sharpen geometrysharpen the image
-shave geometryshave pixels from the image edges
-size geometrywidth and height of image
-stegano offsethide watermark within an image
-stereo geometrycombine two image to create a stereo anaglyph
-stripstrip image of all profiles and comments
-swap indexesswap two images in the image sequence
-synchronizesynchronize image to storage device
-taintmark the image as modified
-thumbnail geometrycreate a thumbnail of the image
-tilerepeat composite operation across and down image
-transformaffine transform image
-transparent-color colortransparent color
-treedepth valuecolor tree depth
-type typeimage type
-units typethe units of image resolution
-unsharp geometrysharpen the image
-verboseprint detailed information about the image
-versionprint version information
-virtual-pixel methodaccess method for pixels outside the boundaries of the image
-watermark geometrypercent brightness and saturation of a watermark
-white-point pointchromaticity white point
-white-threshold valueforce all pixels above the threshold into white
-write filenamewrite images to this file
+
+
- - + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/api/constitute.html b/www/api/constitute.html index 3d6bd1c0d..49d37717e 100644 --- a/www/api/constitute.html +++ b/www/api/constitute.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Constitute an Image @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
-
+

ConstituteImagePingImagePingImagesReadImageReadImagesWriteImageWriteImages

@@ -332,3 +332,4 @@ MagickBooleanType WriteImages(const ImageInfo *image_info,Image *images, + \ No newline at end of file diff --git a/www/api/decorate.html b/www/api/decorate.html index fe719c6d8..50653a635 100644 --- a/www/api/decorate.html +++ b/www/api/decorate.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Decorate an Image @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
-
+

BorderImageFrameImageRaiseImage

@@ -210,3 +210,4 @@ MagickBooleanType RaiseImage(const Image *image, + \ No newline at end of file diff --git a/www/api/deprecate.html b/www/api/deprecate.html index 1e6648392..4e4ad412a 100644 --- a/www/api/deprecate.html +++ b/www/api/deprecate.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Deprecated Methods @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
-
+

MagickGetImageAlphaColorMagickSetImageAlphaColor

@@ -158,3 +158,4 @@ MagickBooleanType MagickSetImageAlphaColor(MagickWand *wand, + \ No newline at end of file diff --git a/www/api/display.html b/www/api/display.html index 666ae76c8..8f2ece150 100644 --- a/www/api/display.html +++ b/www/api/display.html @@ -5,34 +5,34 @@ - - - Command-line Tools: Display @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + MagickCore, C API: Interactively Display and Edit an Image @ ImageMagick + + + + + + + + + + + + + + + + + + + +
-
+
-

Example Usage • Option Summary

- -

Use the display program to display an image or image sequence on any X server. See Command Line Processing for advice on how to structure your display command or see below for example usages of the command.

- -

Example Usage

- -

We list a few examples of the display command here to illustrate its usefulness and ease of use. To get started, lets display an image in the JPEG format:

- -
magick display rose.jpg
-
- -

To tile a slate texture onto the root window, use:

- -
magick display -size 1280x1024 -window root slate.png
-
- -

To display a visual image directory of all your JPEG images, use:

- -
magick display 'vid:*.jpg'
-
- -

The display program defaults to the X screen resolution. To display vecotr formats at their intended size, override the default resolution:

- -
magick display -density 72 drawing.svg
-
- -

You can find additional examples of using display in Graphics from the Command Line. Further discussion is available in More Graphics from the Command Line and Examples of ImageMagick Usage.

- -

Option Summary

- -

The display command recognizes these options. Click on an option to get more details about how that option works.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
OptionDescription
-alphaon, activate, off, deactivate, set, opaque, copy", -transparent, extract, background, or shape the alpha channel
-antialiasremove pixel-aliasing
-authenticate valuedecrypt image with this password
-backdropdisplay image centered on a backdrop
-background colorbackground color
-border geometrysurround image with a border of color
-bordercolor colorborder color
-channel typeapply option to select image channels
-clipclip along the first path from the 8BIM profile
-clip-path idclip along a named path from the 8BIM profile
-coalescemerge a sequence of images
-colormap typeShared or Private
-colors valuepreferred number of colors in the image
-colorspace typeset image colorspace
-comment stringannotate image with comment
-compress typeimage compression type
-contrastenhance or reduce the image contrast
-crop geometrypreferred size and location of the cropped image
-debug eventsdisplay copious debugging information
-decipher filenameconvert cipher pixels to plain
-define format:optiondefine one or more image format options
-delay valuedisplay the next image after pausing
-density geometryhorizontal and vertical density of the image
-depth valueimage depth
-despecklereduce the speckles within an image
-display serverget image or font from this X server
-dispose methodlayer disposal method
-dither methodapply error diffusion to image
-edge radiusapply a filter to detect edges in the image
-endian typeendianness (MSB or LSB) of the image
-enhanceapply a digital filter to enhance a noisy image
-equalizeperform histogram equalization to an image
-extract geometryextract area from image
-filter typeuse this filter when resizing an image
-flattenflatten a sequence of images
-flipflip image in the vertical direction
-flopflop image in the horizontal direction
-frame geometrysurround image with an ornamental border
-fuzz distancecolors within this distance are considered equal
-gamma valuelevel of gamma correction
-geometry geometrypreferred size or location of the image
-gravity geometryhorizontal and vertical backdrop placement
-helpprint program options
-identifyidentify the format and characteristics of the image
-immutable typeprohibit image edits
-interlace typetype of image interlacing scheme
-interpolate methodpixel color interpolation method
-label nameassign a label to an image
-limit type valuepixel cache resource limit
-log formatformat of debugging information
-map filenametransform image colors to match this set of colors
-mattecolor colorframe color
-monitormonitor progress
-monochrometransform image to black and white
-negatereplace each pixel with its complementary color
-normalizetransform image to span the full range of colors
-page geometrysize and location of an image canvas (setting)
-profile filenameadd, delete, or apply an image profile
-quantize colorspacereduce image colors in this colorspace
-quietsuppress all warning messages
-raise valuelighten/darken image edges to create a 3-D effect
-regard-warningspay attention to warning messages.
-remote commandexecute a command in an remote display process
-resample geometrychange the resolution of an image
-resize geometryresize the image
-respect-parenthesessettings remain in effect until parenthesis boundary.
-roll geometryroll an image vertically or horizontally
-rotate degreesapply Paeth rotation to the image
-sample geometryscale image with pixel sampling
-sampling-factor geometryhorizontal and vertical sampling factor
-scene valueimage scene number
-seed valueseed a new sequence of pseudo-random numbers
-segment valuessegment an image
-set attribute valueset an image attribute
-sharpen geometrysharpen the image
-size geometrywidth and height of image
-stripstrip image of all profiles and comments
-thumbnail geometrycreate a thumbnail of the image
-transparent-color colortransparent color
-black-threshold valueforce all pixels below the threshold into black
-trimtrim image edges
-update secondsdetect when image file is modified and redisplay
-verboseprint detailed information about the image
-versionprint version information
-virtual-pixel methodaccess method for pixels outside the boundaries of the image
-visualdisplay image using this visual type
-window iddisplay image to background of this window
-window-group idexit program when this window id is destroyed
-write filenamewrite images to this file
+

Unknown method

@@ -589,4 +104,4 @@ transparent, extract, background, or shape the alpha channel - \ No newline at end of file + \ No newline at end of file diff --git a/www/api/distort.html b/www/api/distort.html index c58920a65..5b0b8f881 100644 --- a/www/api/distort.html +++ b/www/api/distort.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Image Distortions @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
-
+

AffineTransformImageDistortImageRotateImageSparseColorImage

@@ -267,3 +267,4 @@ Image *SparseColorImage(const Image *image, + \ No newline at end of file diff --git a/www/api/draw.html b/www/api/draw.html index 8612b8c6e..3d444530f 100644 --- a/www/api/draw.html +++ b/www/api/draw.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Draw on an Image @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
-
+

AcquireDrawInfoCloneDrawInfoDestroyDrawInfoDrawAffineImageDrawClipPathDrawImageDrawGradientImageDrawPatternPathDrawPrimitiveGetAffineMatrix

@@ -391,3 +391,4 @@ void GetAffineMatrix(AffineMatrix *affine_matrix) + \ No newline at end of file diff --git a/www/api/drawing-wand.html b/www/api/drawing-wand.html index 2a308179a..ab06e9f2b 100644 --- a/www/api/drawing-wand.html +++ b/www/api/drawing-wand.html @@ -5,34 +5,34 @@ - - + + MagickWand, C API: Drawing Wand Methods @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
-
+

ClearDrawingWandCloneDrawingWandDestroyDrawingWandDrawAffineDrawAlphaDrawAnnotationDrawArcDrawBezierDrawCircleDrawClearExceptionDrawCloneExceptionInfoDrawColorDrawCompositeDrawCommentDrawEllipseDrawGetBorderColorDrawGetClipPathDrawGetClipRuleDrawGetClipUnitsDrawGetDensityDrawGetExceptionDrawGetExceptionTypeDrawGetFillColorDrawGetFillOpacityDrawGetFillRuleDrawGetFontDrawGetFontFamilyDrawGetFontResolutionDrawGetFontSizeDrawGetFontStretchDrawGetFontStyleDrawGetFontWeightDrawGetGravityDrawGetOpacityDrawGetStrokeAntialiasDrawGetStrokeColorDrawGetStrokeDashArrayDrawGetStrokeDashOffsetDrawGetStrokeLineCapDrawGetStrokeLineJoinDrawGetStrokeMiterLimitDrawGetStrokeOpacityDrawGetStrokeWidthDrawGetTextAlignmentDrawGetTextAntialiasDrawGetTextDecorationDrawGetTextDirectionDrawGetTextEncodingDrawGetTextKerningDrawGetTextInterlineSpacingDrawGetTextInterwordSpacingDrawGetVectorGraphicsDrawGetTextUnderColorDrawLineDrawPathCloseDrawPathCurveToAbsoluteDrawPathCurveToRelativeDrawPathCurveToQuadraticBezierAbsoluteDrawPathCurveToQuadraticBezierRelativeDrawPathCurveToQuadraticBezierSmoothAbsoluteDrawPathCurveToQuadraticBezierSmoothRelativeDrawPathCurveToSmoothAbsoluteDrawPathCurveToSmoothRelativeDrawPathEllipticArcAbsoluteDrawPathEllipticArcRelativeDrawPathFinishDrawPathLineToAbsoluteDrawPathLineToRelativeDrawPathLineToHorizontalAbsoluteDrawPathLineToHorizontalRelativeDrawPathLineToVerticalAbsoluteDrawPathLineToVerticalRelativeDrawPathMoveToAbsoluteDrawPathMoveToRelativeDrawPathStartDrawPointDrawPolygonDrawPolylineDrawPopClipPathDrawPopDefsDrawPopPatternDrawPushClipPathDrawPushDefsDrawPushPatternDrawRectangleDrawResetVectorGraphicsDrawRotateDrawRoundRectangleDrawScaleDrawSetBorderColorDrawSetClipPathDrawSetClipRuleDrawSetClipUnitsDrawSetDensityDrawSetFillColorDrawSetFillOpacityDrawSetFontResolutionDrawSetOpacityDrawSetFillPatternURLDrawSetFillRuleDrawSetFontDrawSetFontFamilyDrawSetFontSizeDrawSetFontStretchDrawSetFontStyleDrawSetFontWeightDrawSetGravityDrawSetStrokeColorDrawSetStrokePatternURLDrawSetStrokeAntialiasDrawSetStrokeDashArrayDrawSetStrokeDashOffsetDrawSetStrokeLineCapDrawSetStrokeLineJoinDrawSetStrokeMiterLimitDrawSetStrokeOpacityDrawSetStrokeWidthDrawSetTextAlignmentDrawSetTextAntialiasDrawSetTextDecorationDrawSetTextDirectionDrawSetTextEncodingDrawSetTextKerningDrawSetTextInterlineSpacingDrawSetTextInterwordSpacingDrawSetTextUnderColorDrawSetVectorGraphicsDrawSkewXDrawSkewYDrawTranslateDrawSetViewboxIsDrawingWandNewDrawingWandPeekDrawingWandPopDrawingWandPushDrawingWand

@@ -3868,3 +3868,4 @@ MagickBooleanType PushDrawingWand(DrawingWand *wand) + \ No newline at end of file diff --git a/www/api/effect.html b/www/api/effect.html index 32ca7ff35..833ca3506 100644 --- a/www/api/effect.html +++ b/www/api/effect.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Add an Effect @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
-
+

AdaptiveBlurImageAdaptiveSharpenImageBlurImageConvolveImageDespeckleImageEdgeImageEmbossImageGaussianBlurImageKuwaharaImageLocalContrastImageMotionBlurImagePreviewImageRotationalBlurImageSelectiveBlurImageShadeImageSharpenImageSpreadImageUnsharpMaskImage

@@ -737,3 +737,4 @@ ExceptionInfo *exception) + \ No newline at end of file diff --git a/www/api/enhance.html b/www/api/enhance.html index 5bd8ea8c5..73ea1a60b 100644 --- a/www/api/enhance.html +++ b/www/api/enhance.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Enhance an Image @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
-
+

AutoGammaImageAutoLevelImageBrightnessContrastImageClutImageColorDecisionListImageContrastImageContrastStretchImageEnhanceImageEqualizeImageGammaImageGrayscaleImageHaldClutImageLevelImageLevelizeImageLevelImageColorsLinearStretchImageModulateImageNegateImageThe NormalizeImageSigmoidalContrastImage

@@ -785,3 +785,4 @@ MagickBooleanType SigmoidalContrastImage(Image *image, + \ No newline at end of file diff --git a/www/api/exception.html b/www/api/exception.html index 2f2f297b7..3121e4d6f 100644 --- a/www/api/exception.html +++ b/www/api/exception.html @@ -5,34 +5,34 @@ - - + + Exceptions @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
-
+
@@ -294,4 +294,4 @@ - \ No newline at end of file + \ No newline at end of file diff --git a/www/api/feature.html b/www/api/feature.html index 998429556..cd7f1faa2 100644 --- a/www/api/feature.html +++ b/www/api/feature.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Image Features @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
-
+

CannyEdgeImageGetImageFeaturesUse HoughLineImageMeanShiftImage

@@ -257,3 +257,4 @@ Image *MeanShiftImage(const Image *image,const size_t width, + \ No newline at end of file diff --git a/www/api/fourier.html b/www/api/fourier.html index de57d61db..209634b67 100644 --- a/www/api/fourier.html +++ b/www/api/fourier.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Fourier Transform @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
-
+

ComplexImagesForwardFourierTransformImageInverseFourierTransformImage

@@ -202,3 +202,4 @@ Image *InverseFourierTransformImage(const Image *magnitude_image, + \ No newline at end of file diff --git a/www/api/fx.html b/www/api/fx.html index f9b1b8f34..323857c7f 100644 --- a/www/api/fx.html +++ b/www/api/fx.html @@ -5,34 +5,34 @@ - - - The Fx Special Effects Image Operator @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + MagickCore, C API: Add a Special Effect @ ImageMagick + + + + + + + + + + + + + + + + + + + +
-
+
-

The Fx Special Effects Image Operator • The Anatomy of an Fx Expression

- - - -

Use the Fx special effects image operator to apply a mathematical expression to an image or image channels. Use Fx to:

- -
    -
  • create canvases, gradients, mathematical colormaps
  • -
  • move color values between images and channels
  • -
  • translate, flip, mirror, rotate, scale, shear and generally distort images
  • -
  • merge or composite multiple images together
  • -
  • convolve or merge neighboring pixels together
  • -
  • generate image metrics or 'fingerprints'
  • -
- -

The expression can be simple:

- -
convert -size 64x64 canvas:black -channel blue -fx "1/2" fx_navy.png
-
- -

Here, we convert a black to a navy blue image:

- -
    - black - ==> - navy -
- -

Or the expression can be complex:

- -
convert rose.jpg \  
-  -fx "(1.0/(1.0+exp(10.0*(0.5-u)))-0.006693)*1.0092503" \ 
-  rose-sigmoidal.png'
-
- -

This expression results in a high contrast version of the image:

- -
    - rose - ==> - rose-sigmoidal -
- -

The expression can include variable assignments. Assignments, in most cases, reduce the complexity of an expression and permit some operations that might not be possible any other way. For example, lets create a radial gradient:

- -
convert -size 70x70 canvas: \
-  -fx "Xi=i-w/2; Yj=j-h/2; 1.2*(0.5-hypot(Xi,Yj)/70.0)+0.5" 
-  radial-gradient.png'
-
- -

The command above returns this image:

- -
    - radial-gradient -
- -

This FX expression adds random noise to an image:

- -
convert photo.jpg -fx \'iso=32; rone=rand(); rtwo=rand(); \
-  myn=sqrt(-2*ln(rone))*cos(2*Pi*rtwo); myntwo=sqrt(-2*ln(rtwo))* \
-  cos(2*Pi*rone); pnoise=sqrt(p)*myn*sqrt(iso)* \ 
-  channel(4.28,3.86,6.68,0)/255; max(0,p+pnoise)\' noisy.png
-
- -

See Using FX, The Special Effects Image Operator for more examples.

- -

The next section discusses the Fx expression language.

- -

The Anatomy of an Fx Expression

- -

The Fx Expression Language

- -

The formal Fx expression language is defined here:

- -
-
numbers:
-
integer, floating point, scientific notation (+/- required, e.g. 3.81469e-06), International System number postfixes (.e.g KB, Mib, GB, etc.)
-
constants:
-
E (Euler's number), Epsilon, QuantumRange, QuantumScale, Opaque, Phi (golden ratio), Pi, Transparent
-
Fx operators (in order of precedence):
-
^ (power), unary -, *, /, % (modulo), +, -, - <<, >>, <, <=, >, >=, ==, !=, - & (bitwise AND), | (bitwise OR), - && (logical AND), || (logical OR), - ~ (logical NOT), ?: (ternary conditional)
-
math functions:
-
abs(), acos(), acosh(), airy(), alt(), asin(), asinh(), atan(), atanh(), atan2(), ceil(), clamp(), cos(), cosh(), debug(), drc(), erf(), exp(), floor(), gauss(), gcd(), hypot(), int(), isnan(), j0(), j1(), jinc(), ln(), log(), logtwo(), max(), min(), mod(), not(), pow(), rand(), round(), sign(), sin(), sinc(), sinh(), sqrt(), squish(), tan(), tanh(), trunc()
-
channel functions:
-
channel(r,g,b,a), channel(c,m,y,k,a)
-
color names:
-
red, cyan, black, etc.
-
color functions:
-
srgb(), srgba(), rgb(), rgba(), cmyk(), cmyka(), hsl(), hsla(), etc.
-
color hex values:
-
#ccc, #cbfed0, #b9e1cc00, etc.
-
symbols:
-
  • u=> first image in list
  • -
  • v=> second image in list
  • -
  • s=> current image in list (for %[fx:] otherwise = u)
  • -
  • t=> index of current image (s) in list
  • -
  • n=> number of images in list
  • - -
  • i=> column offset
  • -
  • j=> row offset
  • -
  • p=> pixel to use (absolute or relative to current pixel)
  • - -
  • w=> width of this image
  • -
  • h=> height of this image
  • -
  • z=> channel depth
  • - -
  • r=> red value (from RGBA), of a specific or current pixel
  • -
  • g=> green
  • -
  • b=> blue
  • -
  • a=> alpha
  • -
  • o=> opacity
  • - -
  • c=> cyan value of CMYK color of pixel
  • -
  • y=> yellow
  • -
  • m=> magenta
  • -
  • k=> black
  • - -
  • intensity=> pixel intensity
  • - -
  • hue=> pixel hue
  • -
  • saturation=> pixel saturation
  • -
  • lightness=> pixel lightness
  • -
  • luma=> pixel luma
  • - -
  • page.width=> page width
  • -
  • page.height=> page height
  • -
  • page.x=> page x offset
  • -
  • page.y=> page y offset
  • - -
  • resolution.x=> x resolution
  • -
  • resolution.y=> y resolution
  • - -
  • depth=> image depth
  • -
  • minima=> image minima
  • -
  • maxima=> image maxima
  • -
  • mean=> image mean
  • -
  • standard_deviation=> image standard deviation
  • -
  • kurtosis=> image kurtosis
  • -
  • skewness=> image skewness (add a channel specifier to compute a statistic for that channel, e.g. depth.r)
  • -
    iterators:
    -
    while()
    +

    AddNoiseImageBlueShiftImageCharcoalImageColorizeImageColorMatrixImageFxImageImplodeImageThe MorphImagesPlasmaImagePolaroidImageMagickSepiaToneImageShadowImageSketchImageSolarizeImageSteganoImageStereoAnaglyphImageSwirlImageTintImageVignetteImageWaveImageWaveletDenoiseImage

    + +

    AddNoiseImage

    + +

    AddNoiseImage() adds random noise to the image.

    + +

    The format of the AddNoiseImage method is:

    + +
    +Image *AddNoiseImage(const Image *image,const NoiseType noise_type,
    +  const double attenuate,ExceptionInfo *exception)
    +
    + +

    A description of each parameter follows:

    + +
    +
    + +
    +
    +
    image
    +
    the image.
    + +
    +
    channel
    +
    the channel type.
    + +
    +
    noise_type
    +
    The type of noise: Uniform, Gaussian, Multiplicative, Impulse, Laplacian, or Poisson.
    + +
    +
    attenuate
    +
    attenuate the random distribution.
    + +
    +
    exception
    +
    return any errors or warnings in this structure.
    + +
    +
    +

    BlueShiftImage

    + +

    BlueShiftImage() mutes the colors of the image to simulate a scene at nighttime in the moonlight.

    + +

    The format of the BlueShiftImage method is:

    + +
    +Image *BlueShiftImage(const Image *image,const double factor,
    +  ExceptionInfo *exception)
    +
    + +

    A description of each parameter follows:

    + +
    +
    + +
    +
    +
    image
    +
    the image.
    + +
    +
    factor
    +
    the shift factor.
    + +
    +
    exception
    +
    return any errors or warnings in this structure.
    + +
    +
    +

    CharcoalImage

    + +

    CharcoalImage() creates a new image that is a copy of an existing one with the edge highlighted. It allocates the memory necessary for the new Image structure and returns a pointer to the new image.

    + +

    The format of the CharcoalImage method is:

    + +
    +Image *CharcoalImage(const Image *image,const double radius,
    +  const double sigma,ExceptionInfo *exception)
    +
    + +

    A description of each parameter follows:

    + +
    +
    + +
    +
    +
    image
    +
    the image.
    + +
    +
    radius
    +
    the radius of the pixel neighborhood.
    + +
    +
    sigma
    +
    the standard deviation of the Gaussian, in pixels.
    + +
    +
    exception
    +
    return any errors or warnings in this structure.
    + +
    +
    +

    ColorizeImage

    + +

    ColorizeImage() blends the fill color with each pixel in the image. A percentage blend is specified with opacity. Control the application of different color components by specifying a different percentage for each component (e.g. 90/100/10 is 90 red, 100 green, and 10 blue).

    + +

    The format of the ColorizeImage method is:

    + +
    +Image *ColorizeImage(const Image *image,const char *blend,
    +  const PixelInfo *colorize,ExceptionInfo *exception)
    +
    + +

    A description of each parameter follows:

    + +
    +
    + +
    +
    +
    image
    +
    the image.
    + +
    +
    blend
    +
    A character string indicating the level of blending as a percentage.
    + +
    +
    colorize
    +
    A color value.
    + +
    +
    exception
    +
    return any errors or warnings in this structure.
    + +
    +
    +

    ColorMatrixImage

    + +

    ColorMatrixImage() applies color transformation to an image. This method permits saturation changes, hue rotation, luminance to alpha, and various other effects. Although variable-sized transformation matrices can be used, typically one uses a 5x5 matrix for an RGBA image and a 6x6 for CMYKA (or RGBA with offsets). The matrix is similar to those used by Adobe Flash except offsets are in column 6 rather than 5 (in support of CMYKA images) and offsets are normalized (divide Flash offset by 255).

    + +

    The format of the ColorMatrixImage method is:

    + +
    +Image *ColorMatrixImage(const Image *image,
    +  const KernelInfo *color_matrix,ExceptionInfo *exception)
    +
    + +

    A description of each parameter follows:

    + +
    +
    + +
    +
    +
    image
    +
    the image.
    + +
    +
    color_matrix
    +
    the color matrix.
    + +
    +
    exception
    +
    return any errors or warnings in this structure.
    + +
    +
    +

    FxImage

    + +

    FxImage() applies a mathematical expression to the specified image.

    + +

    The format of the FxImage method is:

    + +
    +Image *FxImage(const Image *image,const char *expression,
    +  ExceptionInfo *exception)
    +
    + +

    A description of each parameter follows:

    + +
    +
    + +
    +
    +
    image
    +
    the image.
    + +
    +
    expression
    +
    A mathematical expression.
    + +
    +
    exception
    +
    return any errors or warnings in this structure.
    + +
    +
    +

    ImplodeImage

    + +

    ImplodeImage() creates a new image that is a copy of an existing one with the image pixels "implode" by the specified percentage. It allocates the memory necessary for the new Image structure and returns a pointer to the new image.

    + +

    The format of the ImplodeImage method is:

    + +
    +Image *ImplodeImage(const Image *image,const double amount,
    +  const PixelInterpolateMethod method,ExceptionInfo *exception)
    +
    + +

    A description of each parameter follows:

    + +
    +
    + +
    +
    +
    implode_image
    +
    Method ImplodeImage returns a pointer to the image after it is implode. A null image is returned if there is a memory shortage.
    + +
    +
    image
    +
    the image.
    + +
    +
    amount
    +
    Define the extent of the implosion.
    + +
    +
    method
    +
    the pixel interpolation method.
    + +
    +
    exception
    +
    return any errors or warnings in this structure.
    + +
    +
    +

    The MorphImages

    + +

    The MorphImages() method requires a minimum of two images. The first image is transformed into the second by a number of intervening images as specified by frames.

    + +

    The format of the MorphImage method is:

    + +
    +Image *MorphImages(const Image *image,const size_t number_frames,
    +  ExceptionInfo *exception)
    +
    + +

    A description of each parameter follows:

    + +
    +
    + +
    +
    +
    image
    +
    the image.
    + +
    +
    number_frames
    +
    Define the number of in-between image to generate. The more in-between frames, the smoother the morph.
    + +
    +
    exception
    +
    return any errors or warnings in this structure.
    + +
    +
    +

    PlasmaImage

    + +

    PlasmaImage() initializes an image with plasma fractal values. The image must be initialized with a base color and the random number generator seeded before this method is called.

    + +

    The format of the PlasmaImage method is:

    + +
    +MagickBooleanType PlasmaImage(Image *image,const SegmentInfo *segment,
    +  size_t attenuate,size_t depth,ExceptionInfo *exception)
    +
    + +

    A description of each parameter follows:

    + +
    +
    + +
    +
    +
    image
    +
    the image.
    + +
    +
    segment
    +
    Define the region to apply plasma fractals values.
    + +
    +
    attenuate
    +
    Define the plasma attenuation factor.
    + +
    +
    depth
    +
    Limit the plasma recursion depth.
    + +
    +
    exception
    +
    return any errors or warnings in this structure.
    + +
    +
    +

    PolaroidImage

    + +

    PolaroidImage() simulates a Polaroid picture.

    + +

    The format of the PolaroidImage method is:

    + +
    +Image *PolaroidImage(const Image *image,const DrawInfo *draw_info,
    +  const char *caption,const double angle,
    +  const PixelInterpolateMethod method,ExceptionInfo exception)
    +
    + +

    A description of each parameter follows:

    + +
    +
    + +
    +
    +
    image
    +
    the image.
    + +
    +
    draw_info
    +
    the draw info.
    + +
    +
    caption
    +
    the Polaroid caption.
    + +
    +
    angle
    +
    Apply the effect along this angle.
    + +
    +
    method
    +
    the pixel interpolation method.
    + +
    +
    exception
    +
    return any errors or warnings in this structure.
    + +
    +
    +

    MagickSepiaToneImage

    + +

    MagickSepiaToneImage() applies a special effect to the image, similar to the effect achieved in a photo darkroom by sepia toning. Threshold ranges from 0 to QuantumRange and is a measure of the extent of the sepia toning. A threshold of 80 is a good starting point for a reasonable tone.

    + +

    The format of the SepiaToneImage method is:

    + +
    +Image *SepiaToneImage(const Image *image,const double threshold,
    +  ExceptionInfo *exception)
    +
    + +

    A description of each parameter follows:

    + +
    +
    + +
    +
    +
    image
    +
    the image.
    + +
    +
    threshold
    +
    the tone threshold.
    + +
    +
    exception
    +
    return any errors or warnings in this structure.
    + +
    +
    +

    ShadowImage

    + +

    ShadowImage() simulates a shadow from the specified image and returns it.

    + +

    The format of the ShadowImage method is:

    + +
    +Image *ShadowImage(const Image *image,const double alpha,
    +  const double sigma,const ssize_t x_offset,const ssize_t y_offset,
    +  ExceptionInfo *exception)
    +
    + +

    A description of each parameter follows:

    + +
    +
    + +
    +
    +
    image
    +
    the image.
    + +
    +
    alpha
    +
    percentage transparency.
    + +
    +
    sigma
    +
    the standard deviation of the Gaussian, in pixels.
    + +
    +
    x_offset
    +
    the shadow x-offset.
    + +
    +
    y_offset
    +
    the shadow y-offset.
    + +
    +
    exception
    +
    return any errors or warnings in this structure.
    + +
    +
    +

    SketchImage

    + +

    SketchImage() simulates a pencil sketch. We convolve the image with a Gaussian operator of the given radius and standard deviation (sigma). For reasonable results, radius should be larger than sigma. Use a radius of 0 and SketchImage() selects a suitable radius for you. Angle gives the angle of the sketch.

    + +

    The format of the SketchImage method is:

    + +
    +    Image *SketchImage(const Image *image,const double radius,
    +const double sigma,const double angle,ExceptionInfo *exception)
    +
    + +

    A description of each parameter follows:

    + +
    +
    + +
    +
    +
    image
    +
    the image.
    + +
    +
    radius
    +
    the radius of the Gaussian, in pixels, not counting the center pixel.
    + +
    +
    sigma
    +
    the standard deviation of the Gaussian, in pixels.
    + +
    +
    angle
    +
    apply the effect along this angle.
    + +
    +
    exception
    +
    return any errors or warnings in this structure.
    + +
    +
    +

    SolarizeImage

    + +

    SolarizeImage() applies a special effect to the image, similar to the effect achieved in a photo darkroom by selectively exposing areas of photo sensitive paper to light. Threshold ranges from 0 to QuantumRange and is a measure of the extent of the solarization.

    + +

    The format of the SolarizeImage method is:

    + +
    +MagickBooleanType SolarizeImage(Image *image,const double threshold,
    +  ExceptionInfo *exception)
    +
    + +

    A description of each parameter follows:

    + +
    +
    + +
    +
    +
    image
    +
    the image.
    + +
    +
    threshold
    +
    Define the extent of the solarization.
    + +
    +
    exception
    +
    return any errors or warnings in this structure.
    + +
    +
    +

    SteganoImage

    + +

    SteganoImage() hides a digital watermark within the image. Recover the hidden watermark later to prove that the authenticity of an image. Offset defines the start position within the image to hide the watermark.

    + +

    The format of the SteganoImage method is:

    + +
    +Image *SteganoImage(const Image *image,Image *watermark,
    +  ExceptionInfo *exception)
    +
    + +

    A description of each parameter follows:

    + +
    +
    + +
    +
    +
    image
    +
    the image.
    + +
    +
    watermark
    +
    the watermark image.
    + +
    +
    exception
    +
    return any errors or warnings in this structure.
    + +
    +
    +

    StereoAnaglyphImage

    + +

    StereoAnaglyphImage() combines two images and produces a single image that is the composite of a left and right image of a stereo pair. Special red-green stereo glasses are required to view this effect.

    + +

    The format of the StereoAnaglyphImage method is:

    + +
    +Image *StereoImage(const Image *left_image,const Image *right_image,
    +  ExceptionInfo *exception)
    +Image *StereoAnaglyphImage(const Image *left_image,
    +  const Image *right_image,const ssize_t x_offset,const ssize_t y_offset,
    +  ExceptionInfo *exception)
    +
    + +

    A description of each parameter follows:

    + +
    +
    + +
    +
    +
    left_image
    +
    the left image.
    + +
    +
    right_image
    +
    the right image.
    + +
    +
    exception
    +
    return any errors or warnings in this structure.
    + +
    +
    x_offset
    +
    amount, in pixels, by which the left image is offset to the right of the right image.
    + +
    +
    y_offset
    +
    amount, in pixels, by which the left image is offset to the bottom of the right image.
    + +
    + +
    +

    SwirlImage

    + +

    SwirlImage() swirls the pixels about the center of the image, where degrees indicates the sweep of the arc through which each pixel is moved. You get a more dramatic effect as the degrees move from 1 to 360.

    + +

    The format of the SwirlImage method is:

    + +
    +Image *SwirlImage(const Image *image,double degrees,
    +  const PixelInterpolateMethod method,ExceptionInfo *exception)
    +
    +

    A description of each parameter follows:

    -

    The Fx Expression

    - -

    An Fx expression may include any combination of the following:

    -
    -
    x ^ y
    exponentiation (xy)
    -
    ( ... )
    grouping
    -
    x * y
    multiplication (the asterisk * is optional, for example, 2u or 2(x+y) are acceptable)
    -
    x / y
    division
    -
    x % y
    modulo
    -
    x + y
    addition
    -
    x - y
    subtraction
    -
    x << y
    left shift
    -
    x >> y
    right shift
    -
    x < y
    boolean relation, return value 1.0 if x < y, otherwise 0.0
    -
    x <= y
    boolean relation, return value 1.0 if x <= y, otherwise 0.0
    -
    x > y
    boolean relation, return value 1.0 if x > y, otherwise 0.0
    -
    x >= y
    boolean relation, return value 1.0 if x >= y, otherwise 0.0
    -
    x == y
    boolean relation, return value 1.0 if x == y, otherwise 0.0
    -
    x != y
    boolean relation, return value 1.0 if x != y, otherwise 0.0
    -
    x & y
    binary AND
    -
    x | y
    binary OR
    -
    x && y
    logical AND connective, return value 1.0 if x > 0 and y > 0, otherwise 0.0
    -
    x || y
    logical OR connective (inclusive), return value 1.0 if x > 0 or y > 0 (or both), otherwise 0.0
    -
    ~x
    logical NOT operator, return value 1.0 if not x > 0, otherwise 0.0
    -
    +x
    unary plus, return 1.0*value
    -
    -x
    unary minus, return -1.0*value
    -
    x ? y : z
    ternary conditional expression, return value y if x != 0, otherwise z; only one ternary conditional permitted per statement
    -
    x = y
    assignment; assignment variables are restricted to letter combinations only (e.g. Xi not X1)
    -
    x ; y
    statement separator
    -
    phi
    constant (1.618034...)
    -
    pi
    constant (3.14159265359...)
    -
    e
    constant (2.71828...)
    -
    QuantumRange
    constant maximum pixel value (255 for Q8, 65535 for Q16)
    -
    QuantumScale
    constant 1.0/QuantumRange
    -
    intensity
    pixel intensity whose value respects the -intensity option.
    -
    hue
    pixel hue
    -
    saturation
    pixel saturation
    -
    lightness
    pixel lightness; equivalent to 0.5*max(red,green,blue) + 0.5*min(red,green,blue)
    -
    luminance
    pixel luminance; equivalent to 0.212656*red + 0.715158*green + 0.072186*blue
    -
    red, green, blue, etc.
    color names
    -
    #ccc, #cbfed0, #b9e1cc00, etc.
    color hex values
    -
    rgb(), rgba(), cmyk(), cmyka(), hsl(), hsla()
    color functions
    -
    s, t, u, v, n, i, j, w, h, z, r, g, b, a, o, c, y, m, k
    symbols
    -
    abs(x)
    absolute value function
    -
    acos(x)
    arc cosine function
    -
    acosh(x)
    inverse hyperbolic cosine function
    -
    airy(x)
    Airy function (max=1, min=0); airy(x)=[jinc(x)]2=[2*j1(pi*x)/(pi*x)]2
    -
    alt(x)
    sign alternation function (return 1.0 if int(x) is even, -1.0 if int(x) is odd)
    -
    asin(x)
    arc sine function
    -
    asinh(x)
    inverse hyperbolic sine function
    -
    atan(x)
    arc tangent function
    -
    atanh(x)
    inverse hyperbolic tangent function
    -
    atan2(x,y)
    arc tangent function of two variables
    -
    ceil(x)
    smallest integral value not less than argument
    -
    channel(r,g,b,a)
    select numeric argument based on current channel
    -
    channel(c,m,y,k,a)
    select numeric argument based on current channel
    -
    clamp(x)
    clamp value
    -
    cos(x)
    cosine function
    -
    cosh(x)
    hyperbolic cosine function
    -
    debug(x)
    print x (useful for debugging your expression)
    -
    drc(x,y)
    dynamic range compression (knee curve); drc(x,y)=(x)/(y*(x-1)+1); -1<y<1
    -
    erf(x)
    error function
    -
    exp(x)
    natural exponential function (ex)
    -
    floor(x)
    largest integral value not greater than argument
    -
    gauss(x)
    gaussian function; gauss(x)=exp(-x*x/2)/sqrt(2*pi)
    -
    gcd(x,y)
    greatest common denominator
    -
    hypot(x,y)
    the square root of x2+y2
    -
    int(x)
    greatest integer function (return greatest integer less than or equal to x)
    -
    isnan(x)
    return 1.0 if x is NAN, 0.0 otherwise
    -
    j0(x)
    Bessel functions of x of the first kind of order 0
    -
    j1(x)
    Bessel functions of x of the first kind of order 1
    -
    jinc(x)
    jinc function (max=1, min=-0.1323); jinc(x)=2*j1(pi*x)/(pi**x)
    -
    ln(x)
    natural logarithm function
    -
    log(x)
    logarithm base 10
    -
    logtwo(x)
    logarithm base 2
    -
    ln(x)
    natural logarithm
    -
    max(x, y)
    maximum of x and y
    -
    min(x, y)
    minimum of x and y
    -
    mod(x, y)
    floating-point remainder function
    -
    not(x)
    return 1.0 if x is zero, 0.0 otherwise
    -
    pow(x,y)
    power function (xy)
    -
    rand()
    value uniformly distributed over the interval [0.0, 1.0) with a 2 to the 128th-1 period
    -
    round()
    round to integral value, regardless of rounding direction
    -
    sign(x)
    return -1.0 if x is less than 0.0 otherwise 1.0
    -
    sin(x)
    sine function
    -
    sinc(x)
    sinc function (max=1, min=-0.21); sinc(x)=sin(pi*x)/(pi*x)
    -
    squish(x)
    squish function; squish(x)=1.0/(1.0+exp(-x))
    -
    sinh(x)
    hyperbolic sine function
    -
    sqrt(x)
    square root function
    -
    tan(x)
    tangent function
    -
    tanh(x)
    hyperbolic tangent function
    -
    trunc(x)
    round to integer, towards zero
    -
    while(condition,expression)
    iterate while the condition is not equal to 0
    +
    +
    + +
    +
    +
    image
    +
    the image.
    + +
    +
    degrees
    +
    Define the tightness of the swirling effect.
    + +
    +
    method
    +
    the pixel interpolation method.
    + +
    +
    exception
    +
    return any errors or warnings in this structure.
    + +
    -
    -

    The expression semantics include these rules:

    +

    TintImage

    -
      -
    • symbols are case insensitive
    • -
    • only one ternary conditional (e.g. x ? y : z) per statement
    • -
    • statements are assignments or the final expression to return
    • -
    • an assignment starts a statement, it is not an operator
    • -
    • assignments to built-ins do not throw an exception and have no effect; e.g. r=3.0; r returns the pixel red color value, not 3.0
    • -
    • Unary operators have a lower priority than binary operators, that is, the unary minus (negation) has lower precedence than exponentiation, so -3^2 is interpreted as -(3^2) = -9. Use parentheses to clarify your intent (e.g. (-3)^2 = 9).
    • -
    • Similarly, care must be exercised when using the slash ('/') symbol. The string of characters 1/2x is interpreted as (1/2)x. The contrary interpretation should be written explicitly as 1/(2x). Again, the use of parentheses helps clarify the meaning and should be used whenever there is any chance of misinterpretation.
    • -
    -
    +

    TintImage() applies a color vector to each pixel in the image. The length of the vector is 0 for black and white and at its maximum for the midtones. The vector weighting function is f(x)=(1-(4.0*((x-0.5)*(x-0.5))))

    +

    The format of the TintImage method is:

    -

    Source Images

    +
    +Image *TintImage(const Image *image,const char *blend,
    +  const PixelInfo *tint,ExceptionInfo *exception)
    +
    -

    The symbols u and v refer to the first and second images, respectively, in the current image sequence. Refer to a particular image in a sequence by appending its index to any image reference (usually u), with a zero index for the beginning of the sequence. A negative index counts from the end. For example, u[0] is the first image in the sequence, u[2] is the third, u[-1] is the last image, and u[t] is the current image. The current image can also be referenced by s. If the sequence number exceeds the length of the sequence, the count is wrapped. Thus in a 3-image sequence, u[-1], u[2], and u[5] all refer to the same (third) image.

    +

    A description of each parameter follows:

    -

    As an example, we form an image by averaging the first image and third images (the second (index 1) image is ignored and just junked):

    +
    +
    -
    convert image1.jpg image2.jpg image3.jpg -fx "(u+u[2])/2.0" image.jpg
    -
    +
    +
    +
    image
    +
    the image.
    -

    By default, the image to which p, r, g, b, a, etc., are applied is the current image s in the image list. This is equivalent to u except when used in an escape sequence %[fx:...].

    +
    +
    blend
    +
    A color value used for tinting.
    -

    It is important to note the special role played by the first image. This is the only image in the image sequence that is modified, other images are used only for their data. As an illustrative example, consider the following, and note that the setting -channel red instructs -fx to modify only the red channel; nothing in the green or blue channels will change. It is instructive to ponder why the result is not symmetric.

    +
    +
    tint
    +
    A color value used for tinting.
    -
    convert -channel red logo: -flop logo: -resize "20%" -fx "(u+v)/2" image.jpg
    -
    +
    +
    exception
    +
    return any errors or warnings in this structure.
    -
      - logo-sm-flop.png - logo-sm.png -==> - logo-sm-fx.png -
    +
    +
    +

    VignetteImage

    -
    -

    Accessing Pixels

    +

    VignetteImage() softens the edges of the image in vignette style.

    -

    All color values are normalized to the range of 0.0 to 1.0. The alpha channel ranges from 0.0 (fully transparent) to 1.0 (fully opaque).

    +

    The format of the VignetteImage method is:

    -

    The pixels are processed one at a time, but a different pixel of an image can be specified using a pixel index represented by p. For example,

    +
    +Image *VignetteImage(const Image *image,const double radius,
    +  const double sigma,const ssize_t x,const ssize_t y,
    +  ExceptionInfo *exception)
    +
    -
    p[-1].g      green value of pixel to the immediate left of the current pixel
    -p[-1,-1].r   red value of the pixel diagonally left and up from current pixel
    -
    +

    A description of each parameter follows:

    -

    To specify an absolute position, use braces, rather than brackets.

    +
    +
    -
    p{0,0}.r     red value of the pixel in the upper left corner of the image
    -p{12,34}.b   blue pixel value at column number 12, row 34 of the image
    -
    +
    +
    +
    image
    +
    the image.
    -

    Integer values of the position retrieve the color of the pixel referenced, while non-integer position values return a blended color according to the current -interpolate setting.

    +
    +
    radius
    +
    the radius of the pixel neighborhood.
    -

    A position outside the boundary of the image retrieves a value dictated by the -virtual-pixel option setting.

    +
    +
    sigma
    +
    the standard deviation of the Gaussian, in pixels.
    -

    Apply an Expression to Select Image Channels

    +
    +
    x, y
    +
    Define the x and y ellipse offset.
    -

    Use the -channel setting to specify the output channel of the result. If no output channel is given, the result is set over all channels except the opacity channel. For example, to replace the red channel of alpha.png with the average of the green channels from the images alpha.png and beta.png, use:

    +
    +
    exception
    +
    return any errors or warnings in this structure.
    -
    convert alpha.png beta.png -channel red -fx "(u.g+v.g)/2" gamma.png
    -
    +
    +
    +

    WaveImage

    + +

    WaveImage() creates a "ripple" effect in the image by shifting the pixels vertically along a sine wave whose amplitude and wavelength is specified by the given parameters.

    + +

    The format of the WaveImage method is:

    + +
    +Image *WaveImage(const Image *image,const double amplitude,
    +  const double wave_length,const PixelInterpolateMethod method,
    +  ExceptionInfo *exception)
    +
    + +

    A description of each parameter follows:

    + +
    +
    +
    +
    +
    image
    +
    the image.
    -

    Results

    +
    +
    amplitude, wave_length
    +
    Define the amplitude and wave length of the sine wave.
    -

    The -fx operator evaluates the given expression for each channel (set by -channel) of each pixel in the first image (u) in the sequence. The computed values are temporarily stored in a copy (clone) of that first image until all the pixels have been processed, after which this single new image replaces the list of images in the current image sequence. As such, in the previous example the updated version of alpha.png replaces both of the original images, alpha.png and beta.png, before being saved as gamma.png.

    +
    +
    interpolate
    +
    the pixel interpolation method.
    -

    The current image s is set to the first image in the sequence (u), and t to its index, 0. The symbols i and j reference the current pixel being processed.

    +
    +
    exception
    +
    return any errors or warnings in this structure.
    +
    +
    +

    WaveletDenoiseImage

    + +

    WaveletDenoiseImage() removes noise from the image using a wavelet transform. The wavelet transform is a fast hierarchical scheme for processing an image using a set of consecutive lowpass and high_pass filters, followed by a decimation. This results in a decomposition into different scales which can be regarded as different “frequency bands”, determined by the mother wavelet. Adapted from dcraw.c by David Coffin.

    + +

    The format of the WaveletDenoiseImage method is:

    -

    For use with -format, the value-escape %[fx:] is evaluated just once for each image in the current image sequence. As each image in the sequence is being evaluated, s and t successively refer to the current image and its index, while i and j are set to zero, and the current channel set to red (-channel is ignored). An example:

    +
    +Image *WaveletDenoiseImage(const Image *image,const double threshold,
    +  const double softness,ExceptionInfo *exception)
    +
    -
    $ convert canvas:'rgb(25%,50%,75%)' rose: -colorspace rgb  \ 
    -  -format 'Red channel of NW corner of image #%[fx:t] is %[fx:s]' info:
    -Red channel of NW corner of image #0 is 0.453758 
    -Red channel of NW corner of image #1 is 0.184588
    -
    +

    A description of each parameter follows:

    -

    Here we use the image indexes to rotate each image differently, and use -set with the image index to set a different pause delay on the first image in the animation:

    +
    +
    -
    convert rose: -duplicate 29 -virtual-pixel Gray -distort SRT '%[fx:360.0*t/n]' \
    -  -set delay '%[fx:t == 0 ? 240 : 10]' -loop 0 rose.gif"
    -
    +
    +
    +
    image
    +
    the image.
    -

    The color-escape %[pixel:] or %[hex:] is evaluated once per image and per color channel in that image (-channel is ignored), The values generated are then converted into a color string (a named color or hex color value). The symbols i and j are set to zero, and s and t refer to each successively current image and index.

    +
    +
    threshold
    +
    set the threshold for smoothing.
    +
    +
    softness
    +
    attenuate the smoothing threshold.
    + +
    +
    exception
    +
    return any errors or warnings in this structure.
    + +
    +
    @@ -434,4 +860,4 @@ Red channel of NW corner of image #1 is 0.184588 - \ No newline at end of file + \ No newline at end of file diff --git a/www/api/histogram.html b/www/api/histogram.html index 5c58f394c..0d4251e71 100644 --- a/www/api/histogram.html +++ b/www/api/histogram.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Image Histograms @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    GetImageHistogramIdentifyPaletteImageIsHistogramImageIsPaletteImageMinMaxStretchImageGetNumberColorsUniqueImageColors

    @@ -262,3 +262,4 @@ Image *UniqueImageColors(const Image *image,ExceptionInfo *exception) + \ No newline at end of file diff --git a/www/api/image-view.html b/www/api/image-view.html index 7420fde44..ae6270488 100644 --- a/www/api/image-view.html +++ b/www/api/image-view.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Image View Methods @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    -
    +
    - - + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/api/image.html b/www/api/image.html index 3a7c5e53a..ceb5a06ea 100644 --- a/www/api/image.html +++ b/www/api/image.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Image Methods @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    AcquireImageAcquireImageInfoAcquireNextImageAppendImagesCatchImageExceptionClipImagePathCloneImageCloneImageInfoCopyImagePixelsDestroyImageDestroyImageInfoGetImageInfoGetImageInfoFileGetImageMaskGetImageVirtualPixelMethodInterpretImageFilenameIsHighDynamicRangeImageIsImageObjectIsTaintImageModifyImageNewMagickImageReferenceImageResetImagePageSetImageAlphaSetImageBackgroundColorSetImageChannelMaskSetImageColorSetImageStorageClassSetImageExtentSetImageInfoBlobSetImageInfoCustomStreamSetImageInfoFileSetImageMaskSetImageRegionMaskSetImageVirtualPixelMethodSmushImagesStripImageSyncImageSettings

    @@ -1179,3 +1179,4 @@ MagickBooleanType SyncImagesSettings(const ImageInfo *image_info, + \ No newline at end of file diff --git a/www/api/layer.html b/www/api/layer.html index 9e2a97a99..2057e9e98 100644 --- a/www/api/layer.html +++ b/www/api/layer.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Dealing with Image Layers @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    CoalesceImagesDisposeImagesCompareImagesLayersOptimizeImageLayersOptimizeImagePlusLayersOptimizeImageTransparencyRemoveDuplicateLayersRemoveZeroDelayLayersCompositeLayersMergeImageLayers

    @@ -423,3 +423,4 @@ Image *MergeImageLayers(const Image *image, + \ No newline at end of file diff --git a/www/api/list.html b/www/api/list.html index 754e38d2d..d686478b3 100644 --- a/www/api/list.html +++ b/www/api/list.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Working with Image Lists @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    AppendImageToListCloneImageListCloneImagesDeleteImageFromListDeleteImagesDestroyImageListDuplicateImagesGetFirstImageInListGetImageFromListGetImageIndexInListGetImageListLengthGetLastImageInListGetNextImageInListGetPreviousImageInListImageListToArrayInsertImageInListNewImageListPrependImageToListRemoveImageFromListRemoveFirstImageFromListRemoveLastImageFromListReplaceImageInListReplaceImageInListReturnLastReverseImageListSpliceImageIntoListSplitImageList

    @@ -763,3 +763,4 @@ Image *SplitImageList(Image *images) + \ No newline at end of file diff --git a/www/api/magick++-classes.html b/www/api/magick++-classes.html index bca332a11..0213a6c0a 100644 --- a/www/api/magick++-classes.html +++ b/www/api/magick++-classes.html @@ -5,34 +5,34 @@ - - + + Magick++, C++ API: Classes @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    Magick++ Classes

    @@ -86,7 +86,7 @@

    Magick++ is intended to support commercial-grade application development. In order to avoid possible conflicts with the user's application, all symbols contained in Magick++ (included by the header <Magick++.h>) are scoped to the namespace Magick. Symbols from the ImageMagick C library are imported under the MagickCore namespace to avoid possible conflicts and ImageMagick macros are only included within the Magick++ implementation so they won't impact the user's application.

    The core class in Magick++ is the Image class. The Image class provides methods to manipulate a single image frame (e.g. a JPEG image). Standard Template Library (STL)compatible algorithms and function objects are provided in order to manipulate multiple image frames or to read and write file formats which support multiple image frames (e.g. GIF animations, MPEG animations, and Postscript files).

    The Image class supports reference-counted memory management which supports the semantics of an intrinsic variable type (e.g. 'int') with an extremely efficient operator = and copy constructor (only a pointer is assigned) while ensuring that the image data is replicated as required so that it the image may be modified without impacting earlier generations. Since the Image class manages heap memory internally, images are best allocated via C++ automatic (stack-based) memory allocation. This support allows most programs using Magick++ to be written without using any pointers, simplifying the implementation and avoiding the risks of using pointers. When a program uses automatic memory allocation to allocate Magick++ images, that aspect of the program becomes naturally exception-safe and thread-safe.

    -

    The image class uses a number of supportive classes in order to specify arguments. Colors are specified via the Color class. Colors specified in X11-style string form are implicitly converted to the Color class. Geometry arguments (those specifying width, height, and/or x and y offset) are specified via the Geometry class. Similar to the Color class, geometries specified as an X11-style string are implicitly converted to the Geometry class. Two dimensional drawable objects are specified via the Drawable class. Drawable objects may be provided as a single object or as a list of objects to be rendered using the current image options. Montage options (a montage is a rendered grid of thumbnails in one image) are specified via the Montage class.

    +

    The image class uses a number of supportive classes in order to specify arguments. Colors are specified via the Color class. Colors specified in X11-style string form are implicitly converted to the Color class. Geometry arguments (those specifying width, height, and/or x and y offset) are specified via the Geometry class. Similar to the Color class, geometries specified as an X11-style string are implicitly converted to the Geometry class. Two dimensional drawable objects are specified via the Drawable class. Drawable objects may be provided as a single object or as a list of objects to be rendered using the current image options. Montage options (a montage is a rendered grid of thumbnails in one image) are specified via the Montage class.

    Errors are reported using C++ exceptions derived from the Exception class, which is itself derived from the standard C++ exception class. Exceptions are reported synchronous with the operation and are caught by the first matching try block as the stack is unraveled. This allows a clean coding style in which multiple related Magick++ commands may be executed with errors handled as a unit rather than line-by-line. Since the Image object provides reference-counted memory management, unreferenced images on the stack are automagically cleaned up, avoiding the potential for memory leaks.

    For ease of access, the documentation for the available user-level classes is available via the following table.


    @@ -97,23 +97,23 @@ -Blob +Blob Binary Large OBject container. CoderInfo Report information about supported image formats (use with -coderInfoList()) +coderInfoList()) -Color +Color Color specification. -Drawable +Drawable Drawable shape (for input to 'draw'). Exception C++ exception objects. -Geometry +Geometry Geometry specification. Image @@ -122,14 +122,14 @@ Montage Montage options for montageImages(). -Pixels +Pixels Low-level access to image pixels. -STL +STL STL algorithms and function objects for operating on containers of image frames. -TypeMetric +TypeMetric Container for font type metrics (use with Image::fontTypeMetrics). @@ -157,3 +157,4 @@ containers of image frames. + \ No newline at end of file diff --git a/www/api/magick-deprecate.html b/www/api/magick-deprecate.html index 661480fa3..0bcbb232b 100644 --- a/www/api/magick-deprecate.html +++ b/www/api/magick-deprecate.html @@ -5,34 +5,34 @@ - - + + MagickWand, C API: Deprecated Methods @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    @@ -104,3 +104,4 @@ + \ No newline at end of file diff --git a/www/api/magick-image.html b/www/api/magick-image.html index 60e56e14e..b670ee318 100644 --- a/www/api/magick-image.html +++ b/www/api/magick-image.html @@ -5,34 +5,34 @@ - - + + MagickWand, C API: Image Methods @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    GetImageFromMagickWandMagickAdaptiveBlurImageMagickAdaptiveResizeImageMagickAdaptiveSharpenImageMagickAdaptiveThresholdImageMagickAddImageMagickAddNoiseImageMagickAffineTransformImageMagickAnnotateImageMagickAnimateImagesMagickAppendImagesMagickAutoGammaImageMagickAutoLevelImageMagickAutoOrientImageMagickBlackThresholdImageMagickBlueShiftImageMagickBlurImageMagickBorderImageUse MagickBrightnessContrastImageMagickChannelFxImageMagickCharcoalImageMagickChopImageMagickClampImageMagickClipImageMagickClipImagePathMagickClutImageMagickCoalesceImagesMagickColorDecisionListImageMagickColorizeImageMagickColorMatrixImageMagickCombineImagesMagickCommentImageMagickCompareImagesLayersMagickCompareImagesMagickCompositeImageMagickCompositeImageGravityMagickCompositeLayersMagickContrastImageMagickContrastStretchImageMagickConvolveImageMagickCropImageMagickCycleColormapImageMagickConstituteImageMagickDecipherImageMagickDeconstructImagesMagickDeskewImageMagickDespeckleImageMagickDestroyImageMagickDisplayImageMagickDisplayImagesMagickDistortImageMagickDrawImageMagickEdgeImageMagickEmbossImageMagickEncipherImageMagickEnhanceImageMagickEqualizeImageMagickEvaluateImageMagickExportImagePixelsMagickExtentImageMagickFlipImageMagickFloodfillPaintImageMagickFlopImageMagickForwardFourierTransformImageMagickFrameImageMagickFunctionImageMagickFxImageMagickGammaImageMagickGaussianBlurImageMagickGetImageMagickGetImageAlphaChannelMagickGetImageMaskMagickGetImageBackgroundColorMagickGetImageBlobMagickGetImageBlobMagickGetImageBluePrimaryMagickGetImageBorderColorMagickGetImageFeaturesMagickGetImageKurtosisMagickGetImageMeanMagickGetImageRangeMagickGetImageStatisticsMagickGetImageColormapColorMagickGetImageColorsMagickGetImageColorspaceMagickGetImageComposeMagickGetImageCompressionMagickGetImageCompressionQualityMagickGetImageDelayMagickGetImageDepthMagickGetImageDisposeMagickGetImageDistortionMagickGetImageDistortionsMagickGetImageEndianMagickGetImageFilenameMagickGetImageFormatMagickGetImageFuzzMagickGetImageGammaMagickGetImageGravityMagickGetImageGreenPrimaryMagickGetImageHeightMagickGetImageHistogramMagickGetImageInterlaceSchemeMagickGetImageInterpolateMethodMagickGetImageIterationsMagickGetImageLengthMagickGetImageMatteColorMagickGetImageOrientationMagickGetImagePageMagickGetImagePixelColorMagickGetImageRedPrimaryMagickGetImageRegionMagickGetImageRenderingIntentMagickGetImageResolutionMagickGetImageSceneMagickGetImageSignatureMagickGetImageTicksPerSecondMagickGetImageTypeMagickGetImageUnitsMagickGetImageVirtualPixelMethodMagickGetImageWhitePointMagickGetImageWidthMagickGetNumberImagesMagickGetImageTotalInkDensityMagickHaldClutImageMagickHasNextImageMagickHasPreviousImageMagickIdentifyImageMagickIdentifyImageTypeMagickImplodeImageMagickImportImagePixelsMagickInterpolativeResizeImageMagickInverseFourierTransformImageMagickLabelImageMagickLevelImageMagickLinearStretchImageMagickLiquidRescaleImageMagickLocalContrastImageMagickMagnifyImageMagickMergeImageLayersMagickMinifyImageMagickModulateImageMagickMontageImageMagickMorphImagesMagickMorphologyImageMagickMotionBlurImageMagickNegateImageMagickNewImageMagickNextImageMagickNormalizeImageMagickOilPaintImageMagickOpaquePaintImageMagickOptimizeImageLayersMagickOptimizeImageTransparencyMagickOrderedDitherImageMagickPingImageMagickPingImageBlobMagickPingImageFileMagickPolaroidImageMagickPosterizeImageMagickPreviewImagesMagickPreviousImageMagickQuantizeImageMagickQuantizeImagesMagickRotationalBlurImageMagickRaiseImageMagickRandomThresholdImageMagickReadImageMagickReadImageBlobMagickReadImageFileMagickRemapImageMagickRemoveImageMagickResampleImageMagickResetImagePageMagickResizeImageMagickRollImageMagickRotateImageMagickSampleImageMagickScaleImageMagickSegmentImageMagickSelectiveBlurImageMagickSeparateImageMagickSepiaToneImageMagickSetImageMagickSetImageAlphaChannelMagickSetImageBackgroundColorMagickSetImageBluePrimaryMagickSetImageBorderColorMagickSetImageChannelMaskMagickSetImageMaskMagickSetImageColorMagickSetImageColormapColorMagickSetImageColorspaceMagickSetImageComposeMagickSetImageCompressionMagickSetImageCompressionQualityMagickSetImageDelayMagickSetImageDepthMagickSetImageDisposeMagickSetImageEndianMagickSetImageExtentMagickSetImageFilenameMagickSetImageFormatMagickSetImageFuzzMagickSetImageGammaMagickSetImageGravityMagickSetImageGreenPrimaryMagickSetImageInterlaceSchemeMagickSetImageInterpolateMethodMagickSetImageIterationsMagickSetImageMatteMagickSetImageMatteColorMagickSetImageAlphaMagickSetImageOrientationMagickSetImagePageMagickSetImageProgressMonitorMagickSetImageRedPrimaryMagickSetImageRenderingIntentMagickSetImageResolutionMagickSetImageSceneMagickSetImageTicksPerSecondMagickSetImageTypeMagickSetImageUnitsMagickSetImageVirtualPixelMethodMagickSetImageWhitePointMagickShadeImageMagickShadowImageMagickSharpenImageMagickShaveImageMagickShearImageMagickSigmoidalContrastImageMagickSimilarityImageMagickSketchImageMagickSmushImagesMagickSolarizeImageMagickSparseColorImageMagickSpliceImageMagickSpreadImageMagickStatisticImageMagickSteganoImageMagickStereoImageMagickStripImageMagickSwirlImageMagickTextureImageMagickThresholdImageMagickThumbnailImageMagickTintImageMagickTransformImageColorspaceMagickTransparentPaintImageMagickTransposeImageMagickTransverseImageMagickTrimImageMagickUniqueImageColorsMagickUnsharpMaskImageMagickVignetteImageMagickWaveImageMagickWhiteThresholdImageMagickWriteImageMagickWriteImageFileMagickWriteImagesMagickWriteImagesFile

    @@ -7846,4 +7846,4 @@ MagickBooleanType MagickWriteImagesFile(MagickWand *wand,FILE *file) - \ No newline at end of file + \ No newline at end of file diff --git a/www/api/magick-property.html b/www/api/magick-property.html index 9567a8f42..4109572f4 100644 --- a/www/api/magick-property.html +++ b/www/api/magick-property.html @@ -5,34 +5,34 @@ - - + + MagickWand, C API: Property Methods @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    MagickDeleteImageArtifactMagickDeleteImagePropertyMagickDeleteOptionMagickGetAntialiasMagickGetBackgroundColorMagickGetColorspaceMagickGetCompressionMagickGetCompressionQualityMagickGetCopyrightMagickGetFilenameMagickGetFontMagickGetFormatMagickGetGravityMagickGetHomeURLMagickGetImageArtifactMagickGetImageArtifactsMagickGetImageProfileMagickGetImageProfilesMagickGetImagePropertyMagickGetImagePropertiesMagickGetInterlaceSchemeMagickGetInterpolateMethodMagickGetOptionMagickGetOptionsMagickGetOrientationMagickGetPackageNameMagickGetPageMagickGetPointsizeMagickGetQuantumDepthMagickGetQuantumRangeMagickGetReleaseDateMagickGetResolutionMagickGetResourceMagickGetResourceLimitMagickGetSamplingFactorsMagickGetSizeMagickGetSizeOffsetMagickGetTypeMagickGetVersionMagickProfileImageMagickRemoveImageProfileMagickSetAntialiasMagickSetBackgroundColorMagickSetColorspaceMagickSetCompressionMagickSetCompressionQualityMagickSetDepthMagickSetExtractMagickSetFilenameMagickSetFontMagickSetFormatMagickSetGravityMagickSetImageArtifactMagickSetImageProfileMagickSetImagePropertyMagickSetInterlaceSchemeMagickSetInterpolateMethodMagickSetOptionMagickSetOrientationMagickSetPageMagickSetPassphraseMagickSetPointsizeMagickSetProgressMonitorMagickSetResourceLimitMagickSetResolutionMagickSetSamplingFactorsMagickSetSecurityPolicyMagickSetSizeMagickSetSizeOffsetMagickSetType

    @@ -1943,3 +1943,4 @@ MagickBooleanType MagickSetType(MagickWand *wand, + \ No newline at end of file diff --git a/www/api/magick-wand.html b/www/api/magick-wand.html index afc24a00a..f6ac2406d 100644 --- a/www/api/magick-wand.html +++ b/www/api/magick-wand.html @@ -5,34 +5,34 @@ - - + + MagickWand, C API @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +
    -

    The MagickWand API is the recommended interface between the C programming language and the ImageMagick image processing libraries. Unlike the MagickCore C API, MagickWand uses only a few opaque types. Accessors are available to set or get important wand properties. A description of the MagickWand public methods are found here:

    +

    The MagickWand API is the recommended interface between the C programming language and the ImageMagick image processing libraries. Unlike the MagickCore C API, MagickWand uses only a few opaque types. Accessors are available to set or get important wand properties. A description of the MagickWand public methods are found here:

    @@ -406,4 +406,4 @@ int main(int argc,char **argv) - \ No newline at end of file + \ No newline at end of file diff --git a/www/api/magick.html b/www/api/magick.html index 6b228d0a3..8df7e1d24 100644 --- a/www/api/magick.html +++ b/www/api/magick.html @@ -5,34 +5,34 @@ - - - Command-line Tools: Magick @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + MagickCore, C API: Read or List Image formats @ ImageMagick + + + + + + + + + + + + + + + + + + + +
    -
    +
    -

    Use the magick program to convert between image formats as well as resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more. See Command Line Processing for advice on how to structure your convert command or see below for example usages of the command.

    +

    AcquireMagickInfoGetMagickPrecisionIsMagickCoreInstantiatedMagickCoreGenesisMagickCoreTerminusSetMagickPrecision

    -

    We list a few examples of the magick command here to illustrate its usefulness and ease of use. To get started, lets convert an image in the JPEG format to PNG:

    +

    AcquireMagickInfo

    -
    magick rose.jpg rose.png
    -
    +

    AcquireMagickInfo() allocates a MagickInfo structure and initializes the members to default values.

    -

    Next, we reduce the image size before it is written to the PNG format:

    +

    The format of the AcquireMagickInfo method is:

    -
    magick rose.jpg -resize 50% rose.png
    -
    +
    +MagickInfo *AcquireMagickInfo(const char *module, const char *name,)
    +
    - +

    A description of each parameter follows:

    -

    You can combine multiple image-processing operations to produce complex results:

    +
    +
    -
    magick -size 320x85 canvas:none -font Bookman-DemiItalic -pointsize 72 \
    -  -draw "text 25,60 \'Magick\'" -channel RGBA -blur 0x6 -fill darkred -stroke magenta \
    -  -draw "text 20,55 \'Magick\'" fuzzy-magick.png
    -
    +
    +
    +
    module
    +
    a character string that represents the module associated with the MagickInfo structure.
    -
      - fuzzy-magick -
    +
    +
    name
    +
    a character string that represents the image format associated with the MagickInfo structure.
    -

    or here we resize an image with improved quality:

    +
    +
    description
    +
    a character string that represents the image format associated with the MagickInfo structure.
    -
    magick input.png -colorspace RGB +sigmoidal-contrast 11.6933 \
    -  -define filter:filter=Sinc -define filter:window=Jinc -define filter:lobes=3 \
    -  -resize 400% -sigmoidal-contrast 11.6933 -colorspace sRGB output.png');
    -
    +
    +
    +

    GetMagickPrecision

    -

    Utilize other command-line tools from the magick tool. To invoke this functionality, simply create a symbolic link to the magick tool or specify the tool you want to use as the first argument. These two methods are equivalent:

    +

    GetMagickPrecision() returns the maximum number of significant digits to be printed.

    -
    ln -s magick convert
    -convert rose.jpg rose.png
    -magick convert rose.jpg rose.png
    -
    +

    The format of the GetMagickPrecision method is:

    -

    You can find additional examples of using magick in Examples of ImageMagick Usage.

    +
    +int GetMagickPrecision(void)
    +
    -

    Option Summary

    +

    IsMagickCoreInstantiated

    -

    The magick command recognizes these options. Click on an option to get more details about how that option works.

    +

    IsMagickCoreInstantiated() returns MagickTrue if the ImageMagick environment is currently instantiated: MagickCoreGenesis() has been called but MagickDestroy() has not.

    -
    - - - - - +

    The format of the IsMagickCoreInstantiated method is:

    - - - - +
    +MagickBooleanType IsMagickCoreInstantiated(void)
    +
    - - - - +

    MagickCoreGenesis

    - - - - +

    MagickCoreGenesis() initializes the MagickCore environment.

    - - - - +

    The format of the MagickCoreGenesis function is:

    - - - - +
    +MagickCoreGenesis(const char *path,
    +  const MagickBooleanType establish_signal_handlers)
    +
    - - - - +

    A description of each parameter follows:

    - - - - +
    +
    - - - - +
    +
    +
    path
    +
    the execution path of the current ImageMagick client.
    -
    - - - +
    +
    establish_signal_handlers
    +
    set to MagickTrue to use MagickCore's own signal handlers for common signals.
    - - - - +
    + +

    MagickCoreTerminus

    - - - - +

    MagickCoreTerminus() destroys the MagickCore environment.

    - - - - +

    The format of the MagickCoreTerminus function is:

    - - - - +
    +MagickCoreTerminus(void)
    +
    - - - - +

    SetMagickPrecision

    - - - - +

    SetMagickPrecision() sets the maximum number of significant digits to be printed.

    - - - - +

    An input argument of 0 returns the current precision setting.

    - - - - +

    A negative value forces the precision to reset to a default value according to the environment variable "MAGICK_PRECISION", the current 'policy' configuration setting, or the default value of '6', in that order.

    - - - - +

    The format of the SetMagickPrecision method is:

    - - - - +
    +int SetMagickPrecision(const int precision)
    +
    - - - - +

    A description of each parameter follows:

    - - - - +
    +
    - - - - +
    +
    +
    precision
    +
    set the maximum number of significant digits to be printed.
    -
    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    -adaptive-blur geometryadaptively blur pixels; decrease effect near edges
    -adaptive-resize geometryadaptively resize image with data dependent triangulation.
    -adaptive-sharpen geometryadaptively sharpen pixels; increase effect near edges
    -adjoinjoin images into a single multi-image file
    -affine matrixaffine transform matrix
    -alphaon, activate, off, deactivate, set, opaque, copy", -transparent, extract, background, or shape the alpha channel
    -annotate geometry textannotate the image with text
    -antialiasremove pixel-aliasing
    -appendappend an image sequence
    -authenticate valuedecipher image with this password
    -auto-gammaautomagically adjust gamma level of image
    -auto-levelautomagically adjust color levels of image
    -auto-orientautomagically orient image
    -background colorbackground color
    -bench iterationsmeasure performance
    -bias valueadd bias when convolving an image
    -black-threshold valueforce all pixels below the threshold into black
    -blue-primary pointchromaticity blue primary point
    -blue-shift factorsimulate a scene at nighttime in the moonlight
    -blur geometryreduce image noise and reduce detail levels
    -border geometrysurround image with a border of color
    -bordercolor colorborder color
    -brightness-contrast geometryimprove brightness / contrast of the image
    -canny geometryuse a multi-stage algorithm to detect a wide range of edges in the image
    -caption stringassign a caption to an image
    -cdl filenamecolor correct with a color decision list
    -channel typeapply option to select image channels
    -charcoal radiussimulate a charcoal drawing
    -chop geometryremove pixels from the image interior
    -clampset each pixel whose value is below zero to zero and any the pixel whose value is above the quantum range to the quantum range (e.g. 65535) otherwise the pixel value remains unchanged.
    -clipclip along the first path from the 8BIM profile
    -clip-mask filenameassociate clip mask with the image
    -clip-path idclip along a named path from the 8BIM profile
    -clone indexclone an image
    -clutapply a color lookup table to the image
    -connected-components connectivityconnected-components uniquely labeled, choose from 4 or 8 way connectivity
    -contrast-stretch geometryimprove the contrast in an image by `stretching' the range of intensity value
    -coalescemerge a sequence of images
    -colorize valuecolorize the image with the fill color
    -color-matrix matrixapply color correction to the image.
    -colors valuepreferred number of colors in the image
    -colorspace typeset image colorspace
    -combinecombine a sequence of images
    -comment stringannotate image with comment
    -comparecompare image
    -complexoperatorperform complex mathematics on an image sequence
    -compose operatorset image composite operator
    -compositecomposite image
    -compress typeimage compression type
    -contrastenhance or reduce the image contrast
    -convolve coefficientsapply a convolution kernel to the image
    -copy geometry offsetcopy pixels from one area of an image to another
    -crop geometrycrop the image
    -cycle amountcycle the image colormap
    -decipher filenameconvert cipher pixels to plain
    -debug eventsdisplay copious debugging information
    -define format:optiondefine one or more image format options
    -deconstructbreak down an image sequence into constituent parts
    -delay valuedisplay the next image after pausing
    -delete indexdelete the image from the image sequence
    -density geometryhorizontal and vertical density of the image
    -depth valueimage depth
    -despecklereduce the speckles within an image
    -direction typerender text right-to-left or left-to-right
    -display serverget image or font from this X server
    -dispose methodlayer disposal method
    -distribute-cache portlaunch a distributed pixel cache server
    -distort type coefficientsdistort image
    -dither methodapply error diffusion to image
    -draw stringannotate the image with a graphic primitive
    -duplicate count,indexesduplicate an image one or more times
    -edge radiusapply a filter to detect edges in the image
    -emboss radiusemboss an image
    -encipher filenameconvert plain pixels to cipher pixels
    -encoding typetext encoding type
    -endian typeendianness (MSB or LSB) of the image
    -enhanceapply a digital filter to enhance a noisy image
    -equalizeperform histogram equalization to an image
    -evaluate operator valueevaluate an arithmetic, relational, or logical expression
    -evaluate-sequence operatorevaluate an arithmetic, relational, or logical expression for an image sequence
    -extent geometryset the image size
    -extract geometryextract area from image
    -family namerender text with this font family
    -features distanceanalyze image features (e.g. contract, correlations, etc.).
    -fftimplements the discrete Fourier transform (DFT)
    -fill colorcolor to use when filling a graphic primitive
    -filter typeuse this filter when resizing an image
    -flattenflatten a sequence of images
    -flipflip image in the vertical direction
    -floodfill geometry colorfloodfill the image with color
    -flopflop image in the horizontal direction
    -font namerender text with this font
    -format stringoutput formatted image characteristics
    -frame geometrysurround image with an ornamental border
    -function nameapply a function to the image
    -fuzz distancecolors within this distance are considered equal
    -fx expressionapply mathematical expression to an image channel(s)
    -gamma valuelevel of gamma correction
    -gaussian-blur geometryreduce image noise and reduce detail levels
    -geometry geometrypreferred size or location of the image
    -gravity typehorizontal and vertical text placement
    -grayscale methodconvert image to grayscale
    -green-primary pointchromaticity green primary point
    -helpprint program options
    -hough-lines geometryidentify lines in the image
    -identifyidentify the format and characteristics of the image
    -iftimplements the inverse discrete Fourier transform (DFT)
    -implode amountimplode image pixels about the center
    -insert indexinsert last image into the image sequence
    -intensity methodmethod to generate an intensity value from a pixel
    -intent typetype of rendering intent when managing the image color
    -interlace typetype of image interlacing scheme
    -interline-spacing valuethe space between two text lines
    -interpolate methodpixel color interpolation method
    -interword-spacing valuethe space between two words
    -kerning valuethe space between two characters
    -kuwahara geometryedge preserving noise reduction filter
    -label stringassign a label to an image
    -lat geometrylocal adaptive thresholding
    -layers methodoptimize or compare image layers
    -level valueadjust the level of image contrast
    -limit type valuepixel cache resource limit
    -linear-stretch geometrylinear with saturation histogram stretch
    -liquid-rescale geometryrescale image with seam-carving
    -list typeColor, Configure, Delegate, Format, Magic, Module, Resource, or Type
    -log formatformat of debugging information
    -loop iterationsadd Netscape loop extension to your GIF animation
    -mask filenameassociate a mask with the image
    -mattecolor colorframe color
    -median radiusapply a median filter to the image
    -mean-shift geometrydelineate arbitrarily shaped clusters in the image
    -metric typemeasure differences between images with this metric
    -mode radiusmake each pixel the 'predominant color' of the neighborhood
    -modulate valuevary the brightness, saturation, and hue
    -momentsdisplay image moments.
    -monitormonitor progress
    -monochrometransform image to black and white
    -morph valuemorph an image sequence
    -morphology method kernelapply a morphology method to the image
    -motion-blur geometrysimulate motion blur
    -negatereplace each pixel with its complementary color
    -noise radiusadd or reduce noise in an image
    -normalizetransform image to span the full range of colors
    -opaque colorchange this color to the fill color
    -ordered-dither NxNordered dither the image
    -orient typeimage orientation
    -page geometrysize and location of an image canvas (setting)
    -paint radiussimulate an oil painting
    -perceptibleset each pixel whose value is less than |epsilon| to -epsilon or epsilon (whichever is closer) otherwise the pixel value remains unchanged.
    -pingefficiently determine image attributes
    -pointsize valuefont point size
    -polaroid anglesimulate a Polaroid picture
    -poly termsbuild a polynomial from the image sequence and the corresponding terms (coefficients and degree pairs).
    -posterize levelsreduce the image to a limited number of color levels
    -precision valueset the maximum number of significant digits to be printed
    -preview typeimage preview type
    -print stringinterpret string and print to console
    -process image-filterprocess the image with a custom image filter
    -profile filenameadd, delete, or apply an image profile
    -quality valueJPEG/MIFF/PNG compression level
    -quantize colorspacereduce image colors in this colorspace
    -quietsuppress all warning messages
    -radial-blur angleradial blur the image
    -raise valuelighten/darken image edges to create a 3-D effect
    -random-threshold low,highrandom threshold the image
    -red-primary pointchromaticity red primary point
    -regard-warningspay attention to warning messages.
    -region geometryapply options to a portion of the image
    -remap filenametransform image colors to match this set of colors
    -renderrender vector graphics
    -repage geometrysize and location of an image canvas
    -resample geometrychange the resolution of an image
    -resize geometryresize the image
    -respect-parenthesessettings remain in effect until parenthesis boundary.
    -roll geometryroll an image vertically or horizontally
    -rotate degreesapply Paeth rotation to the image
    -sample geometryscale image with pixel sampling
    -sampling-factor geometryhorizontal and vertical sampling factor
    -scale geometryscale the image
    -scene valueimage scene number
    -seed valueseed a new sequence of pseudo-random numbers
    -segment valuessegment an image
    -selective-blur geometryselectively blur pixels within a contrast threshold
    -separateseparate an image channel into a grayscale image
    -sepia-tone thresholdsimulate a sepia-toned photo
    -set attribute valueset an image attribute
    -shade degreesshade the image using a distant light source
    -shadow geometrysimulate an image shadow
    -sharpen geometrysharpen the image
    -shave geometryshave pixels from the image edges
    -shear geometryslide one edge of the image along the X or Y axis
    -sigmoidal-contrast geometryincrease the contrast without saturating highlights or shadows
    -smush offsetsmush an image sequence together
    -size geometrywidth and height of image
    -sketch geometrysimulate a pencil sketch
    -solarize thresholdnegate all pixels above the threshold level
    -splice geometrysplice the background color into the image
    -spread radiusdisplace image pixels by a random amount
    -statistic type geometryreplace each pixel with corresponding statistic from the neighborhood
    -stripstrip image of all profiles and comments
    -stroke colorgraphic primitive stroke color
    -strokewidth valuegraphic primitive stroke width
    -stretch typerender text with this font stretch
    -style typerender text with this font style
    -swap indexesswap two images in the image sequence
    -swirl degreesswirl image pixels about the center
    -synchronizesynchronize image to storage device
    -taintmark the image as modified
    -texture filenamename of texture to tile onto the image background
    -threshold valuethreshold the image
    -thumbnail geometrycreate a thumbnail of the image
    -tile filenametile image when filling a graphic primitive
    -tile-offset geometryset the image tile offset
    -tint valuetint the image with the fill color
    -transformaffine transform image
    -transparent colormake this color transparent within the image
    -transparent-color colortransparent color
    -transposeflip image in the vertical direction and rotate 90 degrees
    -transverseflop image in the horizontal direction and rotate 270 degrees
    -treedepth valuecolor tree depth
    -trimtrim image edges
    -type typeimage type
    -undercolor colorannotation bounding box color
    -unique-colorsdiscard all but one of any pixel color.
    -units typethe units of image resolution
    -unsharp geometrysharpen the image
    -verboseprint detailed information about the image
    -versionprint version information
    -viewFlashPix viewing transforms
    -vignette geometrysoften the edges of the image in vignette style
    -virtual-pixel methodaccess method for pixels outside the boundaries of the image
    -wave geometryalter an image along a sine wave
    -wavelet-denoise thresholdremoves noise from the image using a wavelet transform
    -weight typerender text with this font weight
    -white-point pointchromaticity white point
    -white-threshold valueforce all pixels above the threshold into white
    -write filenamewrite images to this file
    -
    +
    +
    @@ -1344,4 +217,4 @@ transparent, extract, background, or shape the alpha channel - \ No newline at end of file + \ No newline at end of file diff --git a/www/api/memory.html b/www/api/memory.html index c6cbea6ca..4ac1524c5 100644 --- a/www/api/memory.html +++ b/www/api/memory.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Memory Allocation @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    AcquireAlignedMemoryAcquireMagickMemoryAcquireQuantumMemoryAcquireVirtualMemoryCopyMagickMemoryGetMagickMemoryMethodsGetVirtualMemoryBlobRelinquishAlignedMemoryRelinquishMagickMemoryRelinquishVirtualMemoryResetMagickMemoryResizeMagickMemoryResizeQuantumMemorySetMagickMemoryMethods

    @@ -472,3 +472,4 @@ SetMagickMemoryMethods(AcquireMemoryHandler acquire_memory_handler, + \ No newline at end of file diff --git a/www/api/mime.html b/www/api/mime.html index a0ee74009..4c709de8e 100644 --- a/www/api/mime.html +++ b/www/api/mime.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Mime Methods @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    AcquireMimeCacheGetMimeInfoListGetMimeListGetMimeDescriptionGetMimeTypeListMimeInfo

    @@ -255,3 +255,4 @@ MagickBooleanType ListMimeInfo(FILE *file,ExceptionInfo *exception) + \ No newline at end of file diff --git a/www/api/module.html b/www/api/module.html index f4c0ebc17..6adf10757 100644 --- a/www/api/module.html +++ b/www/api/module.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Loadable Modules @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    -
    +
    - - + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/api/mogrify.html b/www/api/mogrify.html index 3f7e63f62..b2a76a4f9 100644 --- a/www/api/mogrify.html +++ b/www/api/mogrify.html @@ -5,34 +5,34 @@ - - - Command-line Tools: Mogrify @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + MagickWand, C API: Command-line Interface @ ImageMagick + + + + + + + + + + + + + + + + + + + +
    -
    +
    -

    Example Usage • Option Summary

    +

    MagickCommandGenesis

    -

    Use the mogrify program to resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more. This tool is similar to convert except that the original image file is overwritten (unless you change the file suffix with the -format option) with any changes you request. See Command Line Processing for advice on how to structure your mogrify command or see below for sample usages of the command.

    +

    MagickCommandGenesis

    -

    Example Usage

    +

    MagickCommandGenesis() applies image processing options to an image as prescribed by command line options.

    -

    We list a few examples of the mogrify command here to illustrate its usefulness and ease of use. To get started, let's reduce the size of our -rose:

    +

    It wiil look for special options like "-debug", "-bench", and "-distribute-cache" that needs to be applied even before the main processing begins, and may completely overrule normal command processing. Such 'Genesis' Options can only be given on the CLI, (not in a script) and are typically ignored (as they have been handled) if seen later.

    -
    magick mogrify -resize 50% rose.jpg
    -
    +

    The format of the MagickCommandGenesis method is:

    - +
    +MagickBooleanType MagickCommandGenesis(ImageInfo *image_info,
    +  MagickCommand command,int argc,char **argv,char **metadata,
    +  ExceptionInfo *exception)
    +
    -

    You can resize all your JPEG images in a folder to a maximum dimension of 256x256 with this command:

    +

    A description of each parameter follows:

    -
    magick mogrify -resize 256x256 *.jpg
    -
    +
    +
    -

    Finally, we convert all our PNG images in a folder to the JPEG format:

    +
    +
    +
    image_info
    +
    the image info.
    -
    magick mogrify -format jpg *.png
    -
    +
    +
    command
    +
    Choose from ConvertImageCommand, IdentifyImageCommand, MogrifyImageCommand, CompositeImageCommand, CompareImagesCommand, ConjureImageCommand, StreamImageCommand, ImportImageCommand, DisplayImageCommand, or AnimateImageCommand.
    -

    Here image files 1.png, 2.png, etc., are left untouched and files 1.jpg, 2.jpg, etc., are created. They are copies of their respective PNG images except are stored in the JPEG image format.

    +
    +
    argc
    +
    Specifies a pointer to an integer describing the number of elements in the argument vector.
    +
    +
    argv
    +
    Specifies a pointer to a text array containing the command line arguments.
    -

    You can find additional examples of using mogrify in Graphics from the Command Line. Further discussion is available in More Graphics from the Command Line and Examples of ImageMagick Usage.

    +
    +
    metadata
    +
    any metadata is returned here.
    -

    Option Summary

    - -

    The mogrify command recognizes these options. Click on an option to get more details about how that option works.

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    OptionDescription
    -adaptive-blur geometryadaptively blur pixels; decrease effect near edges
    -adaptive-resize geometryadaptively resize image with data dependent triangulation.
    -adaptive-sharpen geometryadaptively sharpen pixels; increase effect near edges
    -adjoinjoin images into a single multi-image file
    -affine matrixaffine transform matrix
    -alphaon, activate, off, deactivate, set, opaque, copy", -transparent, extract, background, or shape the alpha channel
    -annotate geometry textannotate the image with text
    -antialiasremove pixel-aliasing
    -appendappend an image sequence
    -authenticate valuedecipher image with this password
    -auto-gammaautomagically adjust gamma level of image
    -auto-levelautomagically adjust color levels of image
    -auto-orientautomagically orient image
    -auto-threshold methodautomatically perform image thresholding
    -background colorbackground color
    -bench iterationsmeasure performance
    -bias valueadd bias when convolving an image
    -black-threshold valueforce all pixels below the threshold into black
    -blue-primary pointchromaticity blue primary point
    -blue-shift factorsimulate a scene at nighttime in the moonlight
    -blur geometryreduce image noise and reduce detail levels
    -border geometrysurround image with a border of color
    -bordercolor colorborder color
    -brightness-contrast geometryimprove brightness / contrast of the image
    -canny geometryuse a multi-stage algorithm to detect a wide range of edges in the image
    -caption stringassign a caption to an image
    -cdl filenamecolor correct with a color decision list
    -channel typeapply option to select image channels
    -charcoal radiussimulate a charcoal drawing
    -chop geometryremove pixels from the image interior
    -clipclip along the first path from the 8BIM profile
    -clampset each pixel whose value is below zero to zero and any the pixel whose value is above the quantum range to the quantum range (e.g. 65535) otherwise the pixel value remains unchanged.
    -clip-mask filenameassociate clip mask with the image
    -clip-path idclip along a named path from the 8BIM profile
    -clutapply a color lookup table to the image
    -complexoperatorperform complex mathematics on an image sequence
    -connected-components connectivityconnected-components uniquely labeled, choose from 4 or 8 way connectivity
    -contrast-stretch geometryimprove the contrast in an image by `stretching' the range of intensity value
    -coalescemerge a sequence of images
    -colorize valuecolorize the image with the fill color
    -color-matrix matrixapply color correction to the image.
    -colors valuepreferred number of colors in the image
    -colorspace typeset image colorspace
    -combinecombine a sequence of images
    -comment stringannotate image with comment
    -compose operatorset image composite operator
    -compositecomposite image
    -compress typeimage compression type
    -contrastenhance or reduce the image contrast
    -convolve coefficientsapply a convolution kernel to the image
    -copy geometry offsetcopy pixels from one area of an image to another
    -crop geometrycrop the image
    -cycle amountcycle the image colormap
    -decipher filenameconvert cipher pixels to plain
    -debug eventsdisplay copious debugging information
    -define format:optiondefine one or more image format options
    -deconstructbreak down an image sequence into constituent parts
    -delay valuedisplay the next image after pausing
    -delete indexdelete the image from the image sequence
    -density geometryhorizontal and vertical density of the image
    -depth valueimage depth
    -despecklereduce the speckles within an image
    -direction typerender text right-to-left or left-to-right
    -display serverget image or font from this X server
    -dispose methodlayer disposal method
    -distort type coefficientsdistort image
    -distribute-cache portlaunch a pixel cache server
    -dither methodapply error diffusion to image
    -draw stringannotate the image with a graphic primitive
    -duplicate count,indexesduplicate an image one or more times
    -edge radiusapply a filter to detect edges in the image
    -emboss radiusemboss an image
    -encipher filenameconvert plain pixels to cipher pixels
    -encoding typetext encoding type
    -endian typeendianness (MSB or LSB) of the image
    -enhanceapply a digital filter to enhance a noisy image
    -equalizeperform histogram equalization to an image
    -evaluate operator valueevaluate an arithmetic, relational, or logical expression
    -evaluate-sequence operatorevaluate an arithmetic, relational, or logical expression for an image sequence
    -extent geometryset the image size
    -extract geometryextract area from image
    -family namerender text with this font family
    -features distanceanalyze image features (e.g. contract, correlations, etc.).
    -fftimplements the discrete Fourier transform (DFT)
    -fill colorcolor to use when filling a graphic primitive
    -filter typeuse this filter when resizing an image
    -flattenflatten a sequence of images
    -flipflip image in the vertical direction
    -floodfill geometry colorfloodfill the image with color
    -flopflop image in the horizontal direction
    -font namerender text with this font
    -format typeoutput formatted image characteristics
    -frame geometrysurround image with an ornamental border
    -function nameapply a function to the image
    -fuzz distancecolors within this distance are considered equal
    -fx expressionapply mathematical expression to an image channel(s)
    -gamma valuelevel of gamma correction
    -gaussian-blur geometryreduce image noise and reduce detail levels
    -geometry geometrypreferred size or location of the image
    -gravity typehorizontal and vertical text placement
    -grayscale methodconvert image to grayscale
    -green-primary pointchromaticity green primary point
    -helpprint program options
    -hough-lines geometryidentify lines in the image
    -identifyidentify the format and characteristics of the image
    -ifftimplements the inverse discrete Fourier transform (DFT)
    -implode amountimplode image pixels about the center
    -insert indexinsert last image into the image sequence
    -intensity methodmethod to generate an intensity value from a pixel
    -intent typetype of rendering intent when managing the image color
    -interlace typetype of image interlacing scheme
    -interline-spacing valuethe space between two text lines
    -interpolate methodpixel color interpolation method
    -interword-spacing valuethe space between two words
    -kerning valuethe space between two characters
    -kuwahara geometryedge preserving noise reduction filter
    -label stringassign a label to an image
    -lat geometrylocal adaptive thresholding
    -layers methodoptimize or compare image layers
    -level valueadjust the level of image contrast
    -limit type valuepixel cache resource limit
    -linear-stretch geometrylinear with saturation histogram stretch
    -liquid-rescale geometryrescale image with seam-carving
    -log formatformat of debugging information
    -loop iterationsadd Netscape loop extension to your GIF animation
    -mattecolor colorframe color
    -median radiusapply a median filter to the image
    -mean-shift geometrydelineate arbitrarily shaped clusters in the image
    -metric typemeasure differences between images with this metric
    -mode radiusmake each pixel the 'predominant color' of the neighborhood
    -modulate valuevary the brightness, saturation, and hue
    -monitormonitor progress
    -monochrometransform image to black and white
    -morph valuemorph an image sequence
    -morphology method kernelapply a morphology method to the image
    -motion-blur geometrysimulate motion blur
    -negatereplace each pixel with its complementary color
    -noise radiusadd or reduce noise in an image
    -normalizetransform image to span the full range of colors
    -opaque colorchange this color to the fill color
    -ordered-dither NxNordered dither the image
    -orient typeimage orientation
    -page geometrysize and location of an image canvas (setting)
    -paint radiussimulate an oil painting
    -perceptibleset each pixel whose value is less than |epsilon| to -epsilon or epsilon (whichever is closer) otherwise the pixel value remains unchanged.
    -pingefficiently determine image attributes
    -pointsize valuefont point size
    -polaroid anglesimulate a Polaroid picture
    -poly termsbuild a polynomial from the image sequence and the corresponding terms (coefficients and degree pairs).
    -posterize levelsreduce the image to a limited number of color levels
    -precision valueset the maximum number of significant digits to be printed
    -preview typeimage preview type
    -print stringinterpret string and print to console
    -process image-filterprocess the image with a custom image filter
    -profile filenameadd, delete, or apply an image profile
    -quality valueJPEG/MIFF/PNG compression level
    -quantize colorspacereduce image colors in this colorspace
    -quietsuppress all warning messages
    -radial-blur angleradial blur the image
    -raise valuelighten/darken image edges to create a 3-D effect
    -random-threshold low,highrandom threshold the image
    -read-mask filenameassociate a read mask with the image
    -red-primary pointchromaticity red primary point
    -regard-warningspay attention to warning messages.
    -region geometryapply options to a portion of the image
    -remap filenametransform image colors to match this set of colors
    -renderrender vector graphics
    -repage geometrysize and location of an image canvas
    -resample geometrychange the resolution of an image
    -resize geometryresize the image
    -respect-parenthesessettings remain in effect until parenthesis boundary.
    -roll geometryroll an image vertically or horizontally
    -rotate degreesapply Paeth rotation to the image
    -sample geometryscale image with pixel sampling
    -sampling-factor geometryhorizontal and vertical sampling factor
    -scale geometryscale the image
    -scene valueimage scene number
    -seed valueseed a new sequence of pseudo-random numbers
    -segment valuessegment an image
    -selective-blur geometryselectively blur pixels within a contrast threshold
    -separateseparate an image channel into a grayscale image
    -sepia-tone thresholdsimulate a sepia-toned photo
    -set attribute valueset an image attribute
    -shade degreesshade the image using a distant light source
    -shadow geometrysimulate an image shadow
    -sharpen geometrysharpen the image
    -shave geometryshave pixels from the image edges
    -shear geometryslide one edge of the image along the X or Y axis
    -sigmoidal-contrast geometryincrease the contrast without saturating highlights or shadows
    -size geometrywidth and height of image
    -sketch geometrysimulate a pencil sketch
    -smush offsetsmush an image sequence together
    -solarize thresholdnegate all pixels above the threshold level
    -splice geometrysplice the background color into the image
    -spread radiusdisplace image pixels by a random amount
    -statistic type geometryreplace each pixel with corresponding statistic from the neighborhood
    -stripstrip image of all profiles and comments
    -stroke colorgraphic primitive stroke color
    -strokewidth valuegraphic primitive stroke width
    -stretch typerender text with this font stretch
    -style typerender text with this font style
    -swap indexesswap two images in the image sequence
    -swirl degreesswirl image pixels about the center
    -synchronizesynchronize image to storage device
    -texture filenamename of texture to tile onto the image background
    -threshold valuethreshold the image
    -thumbnail geometrycreate a thumbnail of the image
    -tile filenametile image when filling a graphic primitive
    -tile-offset geometryset the image tile offset
    -tint valuetint the image with the fill color
    -transformaffine transform image
    -transparent colormake this color transparent within the image
    -transparent-color colortransparent color
    -transposeflip image in the vertical direction and rotate 90 degrees
    -transverseflop image in the horizontal direction and rotate 270 degrees
    -treedepth valuecolor tree depth
    -trimtrim image edges
    -type typeimage type
    -undercolor colorannotation bounding box color
    -unique-colorsdiscard all but one of any pixel color.
    -units typethe units of image resolution
    -unsharp geometrysharpen the image
    -verboseprint detailed information about the image
    -versionprint version information
    -viewFlashPix viewing transforms
    -vignette geometrysoften the edges of the image in vignette style
    -virtual-pixel methodaccess method for pixels outside the boundaries of the image
    -wave geometryalter an image along a sine wave
    -wavelet-denoise thresholdremoves noise from the image using a wavelet transform
    -weight typerender text with this font weight
    -white-point pointchromaticity white point
    -white-threshold valueforce all pixels above the threshold into white
    -write filenamewrite images to this file
    -write-mask filenameassociate a write mask with the image
    +
    +
    exception
    +
    return any errors or warnings in this structure.
    +
    +
    @@ -1324,4 +150,4 @@ transparent, extract, background, or shape the alpha channel - \ No newline at end of file + \ No newline at end of file diff --git a/www/api/monitor.html b/www/api/monitor.html index 2dc01e34a..8bf5787fa 100644 --- a/www/api/monitor.html +++ b/www/api/monitor.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Monitor the Progress of an Image Operation @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    SetImageProgressMonitorSetImageInfoProgressMonitor

    @@ -182,3 +182,4 @@ MagickProgressMonitor SetImageInfoProgressMonitor(ImageInfo *image_info, + \ No newline at end of file diff --git a/www/api/montage.html b/www/api/montage.html index f3175c71e..065de5eb8 100644 --- a/www/api/montage.html +++ b/www/api/montage.html @@ -5,34 +5,34 @@ - - - Command-line Tools: Montage @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + MagickCore, C API: Create an Image Thumbnail @ ImageMagick + + + + + + + + + + + + + + + + + + + +
    -
    +
    -

    Example Usage • Option Summary

    - -

    Use the montage program to 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. See Command Line Processing for advice on how to structure your montage command or see below for example usages of the command.

    - -

    Example Usage

    - -

    We list a few examples of the montage command here to illustrate its usefulness and ease of use. To get started, let's montage two images into a single composite:

    - -
    magick montage -background '#336699' -geometry +4+4 rose.jpg red-ball.png montage.jpg
    -
    - - - -

    Ok, let's add some decorations:

    - -
    magick montage -label %f -frame 5 -background '#336699' -geometry +4+4 rose.jpg red-ball.png frame.jpg
    -
    - - - -

    You can find additional examples of using montage at Examples of ImageMagick Usage and Graphics from the Command Line. Further discussion is available in More Graphics from the Command Line and Examples of ImageMagick Usage.

    - -

    Option Summary

    - -

    The montage command recognizes these options. Click on an option to get more details about how that option works.

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    OptionDescription
    -adaptive-sharpen geometryadaptively sharpen pixels; increase effect near edges
    -adjoinjoin images into a single multi-image file
    -affine matrixaffine transform matrix
    -alphaon, activate, off, deactivate, set, opaque, copy", -transparent, extract, background, or shape the alpha channel
    -annotate geometry textannotate the image with text
    -authenticate valuedecrypt image with this password
    -auto-orientautomagically orient image
    -background colorbackground color
    -blue-primary pointchromaticity blue primary point
    -blur geometryreduce image noise and reduce detail levels
    -border geometrysurround image with a border of color
    -bordercolor colorborder color
    -caption stringassign a caption to an image
    -channel typeapply option to select image channels
    -clone indexclone an image
    -coalescemerge a sequence of images
    -colors valuepreferred number of colors in the image
    -colorspace typeset image colorspace
    -comment stringannotate image with comment
    -compose operatorset image composite operator
    -compositecomposite image
    -compress typeimage compression type
    -crop geometrypreferred size and location of the cropped image
    -debug eventsdisplay copious debugging information
    -define format:optiondefine one or more image format options
    -density geometryhorizontal and vertical density of the image
    -depth valueimage depth
    -display serverget image or font from this X server
    -dispose methodlayer disposal method
    -dither methodapply error diffusion to image
    -draw stringannotate the image with a graphic primitive
    -duplicate count,indexesduplicate an image one or more times
    -endian typeendianness (MSB or LSB) of the image
    -extent geometryset the image size
    -extract geometryextract area from image
    -fill colorcolor to use when filling a graphic primitive
    -filter typeuse this filter when resizing an image
    -flattenflatten a sequence of images
    -flipflip image in the vertical direction
    -flopflop image in the horizontal direction
    -font namerender text with this font
    -frame geometrysurround image with an ornamental border
    -gamma valuelevel of gamma correction
    -geometry geometrypreferred size or location of the image
    -gravity typehorizontal and vertical text placement
    -green-primary pointchromaticity green primary point
    -helpprint program options
    -identifyidentify the format and characteristics of the image
    -interlace typetype of image interlacing scheme
    -interpolate methodpixel color interpolation method
    -kerning valuethe space between two characters
    -label stringassign a label to an image
    -limit type valuepixel cache resource limit
    -log formatformat of debugging information
    -mattecolor colorframe color
    -mode typeframing style
    -monitormonitor progress
    -monochrometransform image to black and white
    -origin geometryimage origin
    -page geometrysize and location of an image canvas (setting)
    -pointsize valuefont point size
    -polaroid anglesimulate a Polaroid picture
    -profile filenameadd, delete, or apply an image profile
    -quality valueJPEG/MIFF/PNG compression level
    -quantize colorspacereduce image colors in this colorspace
    -quietsuppress all warning messages
    -red-primary pointchromaticity red primary point
    -regard-warningspay attention to warning messages.
    -repage geometrysize and location of an image canvas
    -resize geometryresize the image
    -respect-parenthesessettings remain in effect until parenthesis boundary.
    -rotate degreesapply Paeth rotation to the image
    -sampling-factor geometryhorizontal and vertical sampling factor
    -scale geometryscale the image
    -scenesrangeimage scene range
    -seed valueseed a new sequence of pseudo-random numbers
    -shadow geometrysimulate an image shadow
    -size geometrywidth and height of image
    -stripstrip image of all profiles and comments
    -stroke colorgraphic primitive stroke color
    -synchronizesynchronize image to storage device
    -taintmark the image as modified
    -texture filenamename of texture to tile onto the image background
    -tile filenametile image when filling a graphic primitive
    -tile-offset geometryset the image tile offset
    -titledecorate the montage image with a title
    -transformaffine transform image
    -transparent colormake this color transparent within the image
    -transposeflip image in the vertical direction and rotate 90 degrees
    -transparent-color colortransparent color
    -treedepth valuecolor tree depth
    -trimtrim image edges
    -type typeimage type
    -units typethe units of image resolution
    -unsharp geometrysharpen the image
    -verboseprint detailed information about the image
    -versionprint version information
    -viewFlashPix viewing transforms
    -virtual-pixel methodaccess method for pixels outside the boundaries of the image
    -white-point pointchromaticity white point
    +

    Unknown method

    @@ -661,4 +104,4 @@ transparent, extract, background, or shape the alpha channel - \ No newline at end of file + \ No newline at end of file diff --git a/www/api/morphology.html b/www/api/morphology.html index 82545f5da..f569f4f98 100644 --- a/www/api/morphology.html +++ b/www/api/morphology.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Morphological Erosions, Dilations, Openings, and Closings @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    AcquireKernelInfoAcquireKernelBuiltInCloneKernelInfoDestroyKernelInfoMorphologyApplyThis is almost identical to the MorphologyPrimativeMorphologyImageScaleGeometryKernelInfoScaleKernelInfoShowKernelInfoUnityAddKernelInfoZeroKernelNans

    @@ -639,3 +639,4 @@ void ZeroKernelNans (KernelInfo *kernel) + \ No newline at end of file diff --git a/www/api/paint.html b/www/api/paint.html index 45ba67114..a0c19733f 100644 --- a/www/api/paint.html +++ b/www/api/paint.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Paint on an Image @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    FloodfillPaintImageOilPaintImageOpaquePaintImageTransparentPaintImageTransparentPaintImageChroma

    @@ -316,3 +316,4 @@ MagickBooleanType TransparentPaintImageChroma(Image *image, + \ No newline at end of file diff --git a/www/api/pixel-iterator.html b/www/api/pixel-iterator.html index 5eefeeb82..b832930c2 100644 --- a/www/api/pixel-iterator.html +++ b/www/api/pixel-iterator.html @@ -5,34 +5,34 @@ - - + + MagickWand, C API: Pixel Iterator Methods @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    ClearPixelIteratorClonePixelIteratorDestroyPixelIteratorIsPixelIteratorNewPixelIteratorPixelClearIteratorExceptionNewPixelRegionIteratorPixelGetCurrentIteratorRowPixelGetIteratorExceptionPixelGetIteratorExceptionTypePixelGetIteratorRowPixelGetNextIteratorRowPixelGetPreviousIteratorRowPixelResetIteratorPixelSetFirstIteratorRowPixelSetIteratorRowPixelSetLastIteratorRowPixelSyncIterator

    @@ -527,3 +527,4 @@ MagickBooleanType PixelSyncIterator(PixelIterator *iterator) + \ No newline at end of file diff --git a/www/api/pixel-wand.html b/www/api/pixel-wand.html index 380247873..7ae6ce509 100644 --- a/www/api/pixel-wand.html +++ b/www/api/pixel-wand.html @@ -5,34 +5,34 @@ - - + + MagickWand, C API: Pixel Wand Methods @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    ClearPixelWandClonePixelWandClonePixelWandsDestroyPixelWandDestroyPixelWandsIsPixelWandSimilarIsPixelWandNewPixelWandNewPixelWandsPixelClearExceptionPixelGetAlphaPixelGetAlphaQuantumPixelGetBlackPixelGetBlackQuantumPixelGetBluePixelGetBlueQuantumPixelGetColorAsStringPixelGetColorAsNormalizedStringPixelGetColorCountPixelGetCyanPixelGetCyanQuantumPixelGetExceptionPixelGetExceptionTypePixelGetFuzzPixelGetGreenPixelGetGreenQuantumPixelGetHSLPixelGetIndexPixelGetMagentaPixelGetMagentaQuantumPixelGetMagickColorPixelGetPixelPixelGetQuantumPacketPixelGetQuantumPixelPixelGetRedPixelGetRedQuantumPixelGetYellowPixelGetYellowQuantumPixelSetAlphaPixelSetAlphaQuantumPixelSetBlackPixelSetBlackQuantumPixelSetBluePixelSetBlueQuantumPixelSetColorPixelSetColorCountPixelSetColorFromWandPixelSetCyanPixelSetCyanQuantumPixelSetFuzzPixelSetGreenPixelSetGreenQuantumPixelSetHSLPixelSetIndexPixelSetMagentaPixelSetMagentaQuantumPixelSetPixelColorPixelSetQuantumPixelPixelSetRedPixelSetRedQuantumPixelSetYellowPixelSetYellowQuantum

    @@ -1596,3 +1596,4 @@ void PixelSetYellowQuantum(PixelWand *wand,const Quantum yellow) + \ No newline at end of file diff --git a/www/api/profile.html b/www/api/profile.html index 85cfbd977..b659eaba0 100644 --- a/www/api/profile.html +++ b/www/api/profile.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Dealing with Image Profiles @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    -
    +

    CloneImageProfilesDeleteImageProfileDestroyImageProfilesGetImageProfileGetNextImageProfileProfileImageRemoveImageProfileResetImageProfileIteratorSetImageProfileSyncImageProfiles

    @@ -352,21 +352,21 @@ MagickBooleanType SyncImageProfiles(Image *image)
    - - + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/api/property.html b/www/api/property.html index 631c4e1aa..2c8fbe6d8 100644 --- a/www/api/property.html +++ b/www/api/property.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Get/Set Image Properties @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    -
    +
    - - + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/api/quantize.html b/www/api/quantize.html index e9421ccef..aa6cd22bb 100644 --- a/www/api/quantize.html +++ b/www/api/quantize.html @@ -5,34 +5,34 @@ - - + + Color Reduction Utilizing Adaptive Spatial Subdivision @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    Algorithm Description • Measuring Color Reduction Error

    @@ -185,7 +185,7 @@ while number of nodes with (n2 > 0) > required maximum number of colors

    The normalized error measurement can be used to compare images. In general, the closer the mean error is to zero the more the quantized image resembles the source image. Ideally, the error should be perceptually-based, since the human eye is the final judge of quantization quality.

    -

    These errors are measured and printed when the -colors and -verbose options are specified on the convert command line:

    +

    These errors are measured and printed when the -colors and -verbose options are specified on the convert command line:

    @@ -224,4 +224,4 @@ while number of nodes with (n2 > 0) > required maximum number of colors - \ No newline at end of file + \ No newline at end of file diff --git a/www/api/registry.html b/www/api/registry.html index 392606679..a0df75cd2 100644 --- a/www/api/registry.html +++ b/www/api/registry.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: The Image Registry @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    DefineImageRegistryDeleteImageRegistryGetImageRegistryGetNextImageRegistryRegistryComponentTerminusRemoveImageRegistryResetImageRegistryIteratorSetImageRegistry

    @@ -275,3 +275,4 @@ MagickBooleanType SetImageRegistry(const RegistryType type, + \ No newline at end of file diff --git a/www/api/resize.html b/www/api/resize.html index 8f682a08a..770860d36 100644 --- a/www/api/resize.html +++ b/www/api/resize.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Resize an Image @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    AdaptiveResizeImageInterpolativeResizeImageLiquidRescaleImageMagnifyImageMinifyImageResampleImageResizeImageSampleImageScaleImageThumbnailImage

    @@ -465,3 +465,4 @@ Image *ThumbnailImage(const Image *image,const size_t columns, + \ No newline at end of file diff --git a/www/api/resource.html b/www/api/resource.html index 165e7ccc7..f6eb10427 100644 --- a/www/api/resource.html +++ b/www/api/resource.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Monitor or Limit Resource Consumption @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    -
    +

    AcquireMagickResourceAcquireUniqueFileResourceGetMagickResourceGetMagickResourceLimitListMagickResourceInfoRelinquishMagickResourceRelinquishUniqueFileResourceSetMagickResourceLimit

    @@ -275,21 +275,21 @@ MagickBooleanType SetMagickResourceLimit(const ResourceType type,
    - - + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/api/segment.html b/www/api/segment.html index bc1994989..c183544e8 100644 --- a/www/api/segment.html +++ b/www/api/segment.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Segment an Image with Thresholding Fuzzy c-Means @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    SegmentImage

    @@ -137,3 +137,4 @@ MagickBooleanType SegmentImage(Image *image, + \ No newline at end of file diff --git a/www/api/shear.html b/www/api/shear.html index f49ce33b8..083ef7152 100644 --- a/www/api/shear.html +++ b/www/api/shear.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Shear or Rotate an Image by an Arbitrary Angle @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    The XShearImageDeskewImageIntegralRotateImageShearImageShearRotateImage

    @@ -208,3 +208,4 @@ Image *ShearRotateImage(const Image *image,const double degrees, + \ No newline at end of file diff --git a/www/api/signature.html b/www/api/signature.html index 3a033e11a..adb52ac05 100644 --- a/www/api/signature.html +++ b/www/api/signature.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Compute a Message Digest for an Image @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    SignatureImage

    @@ -130,3 +130,4 @@ MagickBooleanType SignatureImage(Image *image,ExceptionInfo *exception) + \ No newline at end of file diff --git a/www/api/statistic.html b/www/api/statistic.html index 8a1c18767..5a6725f18 100644 --- a/www/api/statistic.html +++ b/www/api/statistic.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Image Statistics @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    EvaluateImageFunctionImageGetImageEntropyGetImageExtremaGetImageKurtosisGetImageMeanGetImageMomentsGetImagePerceptualHashGetImageRangeGetImageStatisticsPolynomialImageStatisticImage

    @@ -512,3 +512,4 @@ Image *StatisticImage(const Image *image,const StatisticType type, + \ No newline at end of file diff --git a/www/api/stream.html b/www/api/stream.html index 59215f067..a794b4484 100644 --- a/www/api/stream.html +++ b/www/api/stream.html @@ -5,34 +5,34 @@ - - - Command-line Tools: Stream @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + MagickCore, C API: The Pixel FIFO @ ImageMagick + + + + + + + + + + + + + + + + + + + +
    -
    -
    +
    -

    Example Usage • Option Summary

    +

    StreamImageCommand

    -

    Stream is a lightweight tool to stream one or more pixel components of the image or portion of the image to your choice of storage formats. It writes the pixel components as they are read from the input image a row at a time making stream desirable when working with large images or when you require raw pixel components.

    +

    StreamImageCommand

    -

    Example Usage

    +

    StreamImageCommand() is a lightweight method designed to extract pixels from large image files to a raw format using a minimum of system resources. The entire image or any regular portion of the image can be extracted.

    -

    We list a few examples of the stream command here to illustrate its usefulness and ease of use. To get started, lets stream the red, green, blue components of a 640x480 JPEG image to disk as unsigned characters:

    +

    The format of the StreamImageCommand method is:

    -
    magick stream -map rgb -storage-type char image.jpg pixels.dat
    -magick display -depth 8 -size 640x480 rgb:pixels.dat
    -
    +
    +MagickBooleanType StreamImageCommand(ImageInfo *image_info,int argc,
    +  char **argv,char **metadata,ExceptionInfo *exception)
    +
    -

    Here we extract a 100x100 region from a TIFF image in the grayscale format as doubles:

    +

    A description of each parameter follows:

    -
    magick stream -map i -storage-type double -extract 100x100+30+40 image.tif gray.raw
    -
    +
    +
    -

    You can also associate the region to extract with the image filename:

    +
    +
    +
    image_info
    +
    the image info.
    -
    magick stream -map i -storage-type double 'image.tif[100x100+30+40]' gray.raw
    -
    +
    +
    argc
    +
    the number of elements in the argument vector.
    +
    +
    argv
    +
    A text array containing the command line arguments.
    -

    Option Summary

    +
    +
    metadata
    +
    any metadata is returned here.
    -

    The stream command recognizes these options. Click on an option to get more details about how that option works.

    - -
    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    OptionDescription
    -authenticate valuedecrypt image with this password
    -channel typeapply option to select image channels
    -colorspace typeset image colorspace
    -debug eventsdisplay copious debugging information
    -define format:optiondefine one or more image format options
    -density geometryhorizontal and vertical density of the image
    -depth valueimage depth
    -extract geometryextract area from image
    -helpprint program options
    -interlace typetype of image interlacing scheme
    -interpolate methodpixel color interpolation method
    -limit type valuepixel cache resource limit
    -list typeColor, Configure, Delegate, Format, Magic, Module, Resource, or Type
    -log formatformat of debugging information
    -map componentsstore pixels in this format.
    -monitormonitor progress
    -quantize colorspacereduce image colors in this colorspace
    -quietsuppress all warning messages
    -regard-warningspay attention to warning messages.
    -respect-parenthesessettings remain in effect until parenthesis boundary.
    -sampling-factor geometryhorizontal and vertical sampling factor
    -seed valueseed a new sequence of pseudo-random numbers
    -set attribute valueset an image attribute
    -size geometrywidth and height of image
    -storage-type typestore pixels with this storage type.
    -synchronizesynchronize image to storage device
    -taintmark the image as modified
    -transparent-color colortransparent color
    -verboseprint detailed information about the image
    -versionprint version information
    -virtual-pixel methodaccess method for pixels outside the boundaries of the image
    +
    +
    exception
    +
    return any errors or warnings in this structure.
    +
    +
    - - + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/api/transform.html b/www/api/transform.html index b31733369..a6055d346 100644 --- a/www/api/transform.html +++ b/www/api/transform.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Transform an Image @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    AutoOrientImageChopImageCropImageCropImageToTilesExcerptImageExtentImageFlipImageFlopImageRollImageShaveImageSpliceImageTransformImageTransposeImageTransverseImageTrimImage

    @@ -559,3 +559,4 @@ Image *TrimImage(const Image *image,ExceptionInfo *exception) + \ No newline at end of file diff --git a/www/api/version.html b/www/api/version.html index ceb5876bf..d3616bafa 100644 --- a/www/api/version.html +++ b/www/api/version.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Get the Version and Copyrights @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    GetMagickCopyrightGetMagickDelegatesGetMagickFeaturesGetMagickHomeURLGetMagickLicenseGetMagickPackageNameGetMagickQuantumDepthGetMagickQuantumRangeGetMagickReleaseDateGetMagickSignatureGetMagickVersionListMagickVersion

    @@ -292,3 +292,4 @@ void ListMagickVersion(FILE *file) + \ No newline at end of file diff --git a/www/api/wand-view.html b/www/api/wand-view.html index abc46c9e6..560b9d354 100644 --- a/www/api/wand-view.html +++ b/www/api/wand-view.html @@ -5,34 +5,34 @@ - - + + MagickWand, C API: Wand View Methods @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    -
    +
    - - + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/architecture.html b/www/architecture.html index 441836d46..c52f54b3d 100644 --- a/www/architecture.html +++ b/www/architecture.html @@ -5,34 +5,34 @@ - - + + Architecture @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    The Pixel Cache • Streaming Pixels • Image Properties and Profiles • Large Image Support • Threads of Execution • Heterogeneous Distributed Processing • Custom Image Coders • Custom Image Filters

    @@ -155,9 +155,9 @@ if (image == (Image *) NULL) -

    In our discussion of the pixel cache, we use the MagickCore API to illustrate our points, however, the principles are the same for other program interfaces to ImageMagick.

    +

    In our discussion of the pixel cache, we use the MagickCore API to illustrate our points, however, the principles are the same for other program interfaces to ImageMagick.

    -

    When the pixel cache is initialized, pixels are scaled from whatever bit depth they originated from to that required by the pixel cache. For example, a 1-channel 1-bit monochrome PBM image is scaled to 8-bit gray image, if you are using the Q8 version of ImageMagick, and 16-bit RGBA for the Q16 version. You can determine which version you have with the ‑version option:

    +

    When the pixel cache is initialized, pixels are scaled from whatever bit depth they originated from to that required by the pixel cache. For example, a 1-channel 1-bit monochrome PBM image is scaled to 8-bit gray image, if you are using the Q8 version of ImageMagick, and 16-bit RGBA for the Q16 version. You can determine which version you have with the ‑version option:

    $ identify -version
    $ Version: ImageMagick 7.0.7-14 2017-12-06 Q16 https://www.imagemagick.org

    As you can see, the convenience of the pixel cache sometimes comes with a trade-off in storage (e.g. storing a 1-bit monochrome image as 16-bit is wasteful) and speed (i.e. storing the entire image in memory is generally slower than accessing one scanline of pixels at a time). In most cases, the benefits of the pixel cache typically outweigh any disadvantages.

    @@ -172,7 +172,7 @@ if (image == (Image *) NULL)
  • SyncAuthenticPixels(): update the pixel cache with any modified pixels
  • -

    Here is a typical MagickCore code snippet for manipulating pixels in the pixel cache. In our example, we copy pixels from the input image to the output image and decrease the intensity by 10%:

    +

    Here is a typical MagickCore code snippet for manipulating pixels in the pixel cache. In our example, we copy pixels from the input image to the output image and decrease the intensity by 10%:

    const Quantum
       *p;
    @@ -239,7 +239,7 @@ if (y < (ssize_t) source->rows)
     

    Virtual Pixels

    There are a plethora of image processing algorithms that require a neighborhood of pixels about a pixel of interest. The algorithm typically includes a caveat concerning how to handle pixels around the image boundaries, known as edge pixels. With virtual pixels, you do not need to concern yourself about special edge processing other than choosing which virtual pixel method is most appropriate for your algorithm.

    -

    Access to the virtual pixels are controlled by the SetImageVirtualPixelMethod() method from the MagickCore API or the ‑virtual‑pixel option from the command line. The methods include:

    +

    Access to the virtual pixels are controlled by the SetImageVirtualPixelMethod() method from the MagickCore API or the ‑virtual‑pixel option from the command line. The methods include:

    background
    @@ -317,7 +317,7 @@ Resource limits: Time: unlimited
    -

    You can set these limits either as a security policy (see policy.xml), with an environment variable, with the -limit command line option, or with the SetMagickResourceLimit() MagickCore API method. As an example, our online web interface to ImageMagick, ImageMagick Studio, includes these policy limits to help prevent a denial-of-service:

    +

    You can set these limits either as a security policy (see policy.xml), with an environment variable, with the -limit command line option, or with the SetMagickResourceLimit() MagickCore API method. As an example, our online web interface to ImageMagick, ImageMagick Studio, includes these policy limits to help prevent a denial-of-service:

    <policymap>
       <policy domain="resource" name="temporary-path" value="/tmp"/>
       <policy domain="resource" name="memory" value="256MiB"/>
    @@ -340,7 +340,7 @@ Resource limits:
     
     

    Note, the cache limits are global to each invocation of ImageMagick, meaning if you create several images, the combined resource requirements are compared to the limit to determine the pixel cache storage disposition.

    -

    To determine which type and how much resources are consumed by the pixel cache, add the -debug cache option to the command-line:

    +

    To determine which type and how much resources are consumed by the pixel cache, add the -debug cache option to the command-line:

    -> convert -debug cache logo: -sharpen 3x2 null:
     2016-12-17T13:33:42-05:00 0:00.000 0.000u 7.0.0 Cache convert: cache.c/DestroyPixelCache/1275/Cache
       destroy 
    @@ -463,7 +463,7 @@ image_info->client_data=(void *) MyData;
     image=ReadStream(image_info,&StreamPixels,exception);
     
    -

    We also provide a lightweight tool, stream, to stream one or more pixel components of the image or portion of the image to your choice of storage formats. It writes the pixel components as they are read from the input image a row at a time making stream desirable when working with large images or when you require raw pixel components. A majority of the image formats stream pixels (red, green, and blue) from left to right and top to bottom. However, a few formats do not support this common ordering (e.g. the PSD format).

    +

    We also provide a lightweight tool, stream, to stream one or more pixel components of the image or portion of the image to your choice of storage formats. It writes the pixel components as they are read from the input image a row at a time making stream desirable when working with large images or when you require raw pixel components. A majority of the image formats stream pixels (red, green, and blue) from left to right and top to bottom. However, a few formats do not support this common ordering (e.g. the PSD format).

    Image Properties and Profiles

    @@ -530,7 +530,7 @@ convert -limit memory 2mb -limit map 2mb -limit disk 2gb \

    Threads of Execution

    -

    Many of ImageMagick's internal algorithms are threaded to take advantage of speed-ups offered by the multicore processor chips. However, you are welcome to use ImageMagick algorithms in your threads of execution with the exception of the MagickCore's GetVirtualPixels(), GetAuthenticPixels(), QueueAuthenticPixels(), or SyncAuthenticPixels() pixel cache methods. These methods are intended for one thread of execution only with the exception of an OpenMP parallel section. To access the pixel cache with more than one thread of execution, use a cache view. We do this for the CompositeImage() method, for example. Suppose we want to composite a single image over a different image in each thread of execution. If we use GetVirtualPixels(), the results are unpredictable because multiple threads would likely be asking for different areas of the pixel cache simultaneously. Instead we use GetCacheViewVirtualPixels() which creates a unique view for each thread of execution ensuring our program behaves properly regardless of how many threads are invoked. The other program interfaces, such as the MagickWand API, are completely thread safe so there are no special precautions for threads of execution.

    +

    Many of ImageMagick's internal algorithms are threaded to take advantage of speed-ups offered by the multicore processor chips. However, you are welcome to use ImageMagick algorithms in your threads of execution with the exception of the MagickCore's GetVirtualPixels(), GetAuthenticPixels(), QueueAuthenticPixels(), or SyncAuthenticPixels() pixel cache methods. These methods are intended for one thread of execution only with the exception of an OpenMP parallel section. To access the pixel cache with more than one thread of execution, use a cache view. We do this for the CompositeImage() method, for example. Suppose we want to composite a single image over a different image in each thread of execution. If we use GetVirtualPixels(), the results are unpredictable because multiple threads would likely be asking for different areas of the pixel cache simultaneously. Instead we use GetCacheViewVirtualPixels() which creates a unique view for each thread of execution ensuring our program behaves properly regardless of how many threads are invoked. The other program interfaces, such as the MagickWand API, are completely thread safe so there are no special precautions for threads of execution.

    Here is an MagickCore code snippet that takes advantage of threads of execution with the OpenMP programming paradigm:

    CacheView
    @@ -642,7 +642,7 @@ void ConvertBMPToImage(const BITMAPINFOHEADER *bmp_info,
     
     

    If you call the ImageMagick API from your OpenMP-enabled application and you intend to dynamically increase the number of threads available in subsequent parallel regions, be sure to perform the increase before you call the API otherwise ImageMagick may fault.

    -

    MagickWand supports wand views. A view iterates over the entire, or portion, of the image in parallel and for each row of pixels, it invokes a callback method you provide. This limits most of your parallel programming activity to just that one module. There are similar methods in MagickCore. For an example, see the same sigmoidal contrast algorithm implemented in both MagickWand and MagickCore.

    +

    MagickWand supports wand views. A view iterates over the entire, or portion, of the image in parallel and for each row of pixels, it invokes a callback method you provide. This limits most of your parallel programming activity to just that one module. There are similar methods in MagickCore. For an example, see the same sigmoidal contrast algorithm implemented in both MagickWand and MagickCore.

    In most circumstances, the default number of threads is set to the number of processor cores on your system for optimal performance. However, if your system is hyperthreaded or if you are running on a virtual host and only a subset of the processors are available to your server instance, you might get an increase in performance by setting the thread policy or the MAGICK_THREAD_LIMIT environment variable. For example, your virtual host has 8 processors but only 2 are assigned to your server instance. The default of 8 threads can cause severe performance problems. One solution is to limit the number of threads to the available processors in your policy.xml configuration file:

    <policy domain="resource" name="thread" value="2"/>
    @@ -671,7 +671,7 @@ Performance[11]: 10i 4.348ips 0.793e 16.500u 0:02.300
     Performance[12]: 10i 4.525ips 0.799e 18.320u 0:02.210
     

    The sweet spot for this example is 6 threads. This makes sense since there are 6 physical cores. The other 6 are hyperthreads. It appears that sharpening does not benefit from hyperthreading.

    -

    In certain cases, it might be optimal to set the number of threads to 1 or to disable OpenMP completely with the MAGICK_THREAD_LIMIT environment variable, -limit command line option, or the policy.xml configuration file.

    +

    In certain cases, it might be optimal to set the number of threads to 1 or to disable OpenMP completely with the MAGICK_THREAD_LIMIT environment variable, -limit command line option, or the policy.xml configuration file.

    Heterogeneous Distributed Processing

    ImageMagick includes support for heterogeneous distributed processing with the OpenCL framework. OpenCL kernels within ImageMagick permit image processing algorithms to execute across heterogeneous platforms consisting of CPUs, GPUs, and other processors. Depending on your platform, speed-ups can be an order of magnitude faster than the traditional single CPU.

    @@ -1185,7 +1185,7 @@ display logo.mgk

    Custom Image Filters

    -

    ImageMagick provides a convenient mechanism for adding your own custom image processing algorithms. We call these image filters and they are invoked from the command line with the -process option or from the MagickCore API method ExecuteModuleProcess().

    +

    ImageMagick provides a convenient mechanism for adding your own custom image processing algorithms. We call these image filters and they are invoked from the command line with the -process option or from the MagickCore API method ExecuteModuleProcess().

    Here is a listing of a sample custom image filter. It computes a few statistics such as the pixel brightness and saturation mean and standard-deviation.

    #include <stdio.h>
    @@ -1477,4 +1477,4 @@ ModuleExport size_t analyzeImage(Image **images,const int argc,
       
     
     
    -
    \ No newline at end of file
    +
    \ No newline at end of file
    diff --git a/www/binary-releases.html b/www/binary-releases.html
    index 143ed4d99..f5ab2d482 100644
    --- a/www/binary-releases.html
    +++ b/www/binary-releases.html
    @@ -447,7 +447,7 @@ objShell.Exec("convert ""e:/myimages/image.png"" ""e:/myimages/image.jpg""")
     

    Back to top • Public Key • - Contact Us

    + Contact Us

    © 1999-2016 ImageMagick Studio LLC

    diff --git a/www/changelog.html b/www/changelog.html index d18a3b1cc..6ddae6f94 100644 --- a/www/changelog.html +++ b/www/changelog.html @@ -5,34 +5,34 @@ - - + + Changelog @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    -
    +
    2017-12-08 7.0.7-15 Cristy <quetzlzacatenango@image...>
  • Overall standard deviation is the average of each pixel channel (reference https://www.imagemagick.org/discourse-server//viewforum.html?f=3).
  • @@ -588,13 +588,13 @@
    -

    Security • - Architecture • - Related • - Sitemap • +

    Security • + Architecture • + Related • + Sitemap • Public Key

    -

    Donate • +

    Donate • Back to top • Contact Us

    © 1999-2018 ImageMagick Studio LLC

    @@ -605,4 +605,4 @@ - \ No newline at end of file + \ No newline at end of file diff --git a/www/cipher.html b/www/cipher.html index b17cc4b49..9f0eedb12 100644 --- a/www/cipher.html +++ b/www/cipher.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Convert to and from Cipher Pixels @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    AcquireAESInfoDestroyAESInfoEncipherAESBlockPasskeyDecipherImagePasskeyEncipherImageSetAESKeyPasskeyDecipherImagePasskeyEncipherImage

    @@ -337,4 +337,4 @@ MagickBooleanType EncipherImage(Image *image,const char *passphrase, - \ No newline at end of file + \ No newline at end of file diff --git a/www/color-management.html b/www/color-management.html index f7f0889e9..90f8d2d29 100644 --- a/www/color-management.html +++ b/www/color-management.html @@ -5,34 +5,34 @@ - - + + Color Management @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +
    @@ -156,4 +156,4 @@ magick myimage_channels_*.png -set colorspace HSL -combine -colorspace RGB -set - \ No newline at end of file + \ No newline at end of file diff --git a/www/color.html b/www/color.html index 186ec9b6f..2d717ec1a 100644 --- a/www/color.html +++ b/www/color.html @@ -5,34 +5,34 @@ - - - MagickCore, C API: Count the Colors in an Image @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + Color Names @ ImageMagick + + + + + + + + + + + + + + + + + + + +
    -
    +
    -

    AcquireColorCacheGetColorInfoListGetColorListListColorInfoQueryColorname

    +

    Example Usage • Color Model Specification • List of Color Names

    -

    AcquireColorCache

    +

    A number of ImageMagick options and methods take a color as an argument. The color can then be given as a color name (there is a limited but large set of these; see below) or it can be given as a set of numbers (in decimal or hexadecimal), each corresponding to a channel in an RGB or RGBA color model. HSL, HSLA, HSB, HSBA, CMYK, or CMYKA color models may also be specified. These topics are briefly described in the sections below.

    -

    AcquireColorCache() caches one or more color configurations which provides a mapping between color attributes and a color name.

    +

    Use the Color Converter to supply any valid ImageMagick color specification as described below to see a color swatch of that color and to convert to all the other color models.

    -

    The format of the AcquireColorCache method is:

    +

    Example Usage

    -
    -LinkedListInfo *AcquireColorCache(const char *filename,
    -  ExceptionInfo *exception)
    -
    +

    Each of the following commands produces the same lime border around the image. (Use "double quotes" for Windows.)

    -

    A description of each parameter follows:

    +
    magick -bordercolor lime -border 10 image.jpg image.png
    +magick -bordercolor '#0f0' -border 10 image.jpg image.png
    +magick -bordercolor '#00ff00' -border 10 image.jpg image.png
    +magick -bordercolor 'rgb(0,255,0)' -border 10 image.jpg image.png
    +magick -bordercolor 'rgb(0,100%,0)' -border 10 image.jpg image.png
    -
    -
    +

    The list of recognized color names (for example, aqua, black, blue, fuchsia, gray, green, lime, maroon, navy, olive, purple, red, silver, teal, white, yellow, and others) is shown in a table further below.

    -
    -
    -
    filename
    -
    the font file name.
    +

    Color Model Specification

    -
    -
    exception
    -
    return any errors or warnings in this structure.
    +

    The sRGB, CMYK, HSL and HSB color models are used in numerical color specifications. These examples all specify the same red sRGB color:

    -
    -
    -

    GetColorInfoList

    +
    #f00                      #rgb
    +#ff0000                   #rrggbb
    +#ff0000ff                 #rrggbbaa
    +#ffff00000000             #rrrrggggbbbb
    +#ffff00000000ffff         #rrrrggggbbbbaaaa
    +rgb(255, 0, 0)            an integer in the range 0—255 for each component
    +rgb(100.0%, 0.0%, 0.0%)   a float in the range 0—100% for each component
    -

    GetColorInfoList() returns any colors that match the specified pattern.

    +

    The format of an sRGB value in hexadecimal notation is a '#' immediately followed by either three, six, or twelve hexadecimal characters. The three-digit sRGB notation (#rgb) is converted into six-digit form (#rrggbb) by replicating digits, not by adding zeros. For example, #fb0 expands to #ffbb00. This ensures that white (#ffffff) can be specified with the short notation (#fff) and removes any dependencies on the color depth of the image. Use the hexadecimal notation whenever performance is an issue. ImageMagick does not need to load the expansive color table to interpret a hexadecimal color, e.g., #000000, but it does if black is used instead.

    -

    The format of the GetColorInfoList function is:

    +

    The format of an sRGB value in the functional notation is 'rgb(r,g,b)', where r, g, and b are either three integer or float values in the range 0—255 or three integer or float percentage values in the range 0—100%. The value 255 corresponds to 100%, and to #F or #FF in the hexadecimal notation: rgb(255, 255, 255) = rgb(100%, 100%, 100%) = #FFF = #FFFFFF.

    -
    -const ColorInfo **GetColorInfoList(const char *pattern,
    -  size_t *number_colors,ExceptionInfo *exception)
    -
    +

    White space characters are allowed around the numerical values, at least if the entire color argument is enclosed in quotes ('single quotes' for Unix-like systems, "double quotes" for Windows).

    -

    A description of each parameter follows:

    +

    The sRGB color model is extended in this specification to include alpha to allow specification of the transparency of a color. These examples all specify the same color:

    -
    -
    +
    rgb(255, 0, 0)                 range 0 - 255
    +rgba(255, 0, 0, 1.0)           the same, with an explicit alpha value
    +rgb(100%, 0%, 0%)              range 0.0% - 100.0%
    +rgba(100%, 0%, 0%, 1.0)        the same, with an explicit alpha value
    -
    -
    -
    pattern
    -
    Specifies a pointer to a text string containing a pattern.
    +

    The format of an RGBA value in the functional notation is 'rgba(r,g,b,a)', where r, g, and b are as described above for the RGB functional notation, and where the alpha value a ranges from 0.0 (fully transparent) to 1.0 (fully opaque).

    -
    -
    number_colors
    -
    This integer returns the number of colors in the list.
    +

    There is also a color called 'none' that is fully transparent. This color is shorthand for rgba(0, 0, 0, 0.0).

    -
    -
    exception
    -
    return any errors or warnings in this structure.
    +

    Gray values are conveniently defined with a single intensity value or an intensity value and an alpha value:

    -
    -
    -

    GetColorList

    +
    gray(50%)        mid gray
    +graya(50%, 0.5)  semi-transparent mid gray
    -

    GetColorList() returns any colors that match the specified pattern.

    +

    The ImageMagick color model also supports hue-saturation-lightness (HSL) and hue-saturation-brightness (HSB) colors as a complement to numerical sRGB colors. HSL colors are encoding as a triple (hue, saturation, lightness). Likewise HSB colors are encoding as a triple (hue, saturation, brightness). HSL or HSB triples are either direct values (hue 0—360, saturation 0—255, lightness or brightness 0—255) or with S,L,B as percentage values relative to these ranges.

    -

    The format of the GetColorList function is:

    +

    The HSB color system is geometrically represented as a cone with its apex pointing downward. Hue is measured around the perimeter. Saturation is measured from the axis outward. Brightness is measured from the apex upward.

    -
    -char **GetColorList(const char *pattern,size_t *number_colors,
    -  ExceptionInfo *exception)
    -
    +

    The HSL color system is geometrically represented as a stacked double cone with one apex pointing downward and the other pointing upward. The widest ends of both cones are stacked together one on top of the other. Hue is measured around the perimeter. Saturation is measured from the axis outward. Lightness is measured from the bottom apex upward.

    -

    A description of each parameter follows:

    +

    See http://en.wikipedia.org/wiki/HSL_and_HSV for more details on HSL and HSB color systems.

    -
    -
    +

    Hue is represented as an angle of the color around the circular perimeter of the cone(s) (i.e. the rainbow represented in a circle). Hue values are integers or floats in the range 0—360. By definition red=0=360, and the other colors are spread around the circle, so green=120, blue=240, etc. As an angle, it implicitly wraps around such that -120=240 and 480=120, for instance. (Students of trigonometry would say that "coterminal angles are equivalent" here; an angle θ can be standardized by computing the equivalent angle, θ mod 360.)

    -
    -
    -
    pattern
    -
    Specifies a pointer to a text string containing a pattern.
    +

    Saturation is measure outward from the central axis of the cone(s) toward the perimeter of the cone(s). Saturation may be expressed as an integer or float in the range 0—255 or as an integer or float percentage in the range 0—100. Saturation may be thought of as the absence of any "white" mixed with the base color. Thus 255 or 100% is full saturation and corresponds to a point on the outside surface of the cone (HSB) or double cone (HSL). It will be the most "colorful" region. 0 or 0% is no saturation which results in some shade of gray. It occurs along the central axis of the cone or double cone with black at the bottom apex and white at the top.

    -
    -
    number_colors
    -
    This integer returns the number of colors in the list.
    +

    Brightness and Lightness also may be represented as integers or floats in the range 0—255 or as integer or float percentages in the range 0—100%. Brightness and Lightness are measured from the bottom apex upward to the top of the cone or double cone along the cone(s) central axis. 0 or 0% corresponds to the bottom apex and 255 or 100% corresponds to the top center of the cone for Brightness and to the top apex of the double cone for Lightness.

    -
    -
    exception
    -
    return any errors or warnings in this structure.
    +

    The HSB color system is a little easier to understand than the HSL color system. In the HSB color system, black is at the bottom apex and white is at the top center of the cone on the central axis. The most colorful or saturated colors will then be at the outer edge of the top of the cone at the widest part. Thus at Saturation=100% and Brightness=100%

    -
    -
    -

    ListColorInfo

    +
    hsb(0,   100%,  100%)    or    hsb(0,   255,   255)          full red
    +hsb(120, 100%,  100%)    or    hsb(120, 255,   255)       full green
    +hsb(120, 100%,  75%)     or    hsb(120, 255,   191.25)    medium green
    +hsb(120, 100%,  50%)     or    hsb(120, 255,   127.5)     dark green
    +hsb(120, 100%,  25%)     or    hsb(120, 255,   63.75)     very dark green
    +hsb(120, 50%,   50%)     or    hsb(120, 127.5, 127.5)     pastel green
    -

    ListColorInfo() lists color names to the specified file. Color names are a convenience. Rather than defining a color by its red, green, and blue intensities just use a color name such as white, blue, or yellow.

    +

    In the HSL color system, black is at the bottom apex and white is at the top apex. However, saturation is largest at the middle of the double cone on its outer perimeter and thus at a lightness value of 50%. The most colorful or saturated colors will then be at the outer edge of the double cone at its widest part. Thus at Saturation=100% and Brightness=50%

    -

    The format of the ListColorInfo method is:

    +
    hsl(0,   100%,  50%)     or    hsl(0,   255,   127.5)        full red
    +hsl(120, 100%,  100%)    or    hsl(120, 255,   255)       white
    +hsl(120, 100%,  75%)     or    hsl(120, 255,   191.25)    pastel green
    +hsl(120, 100%,  50%)     or    hsl(120, 255,   127.5)     full green
    +hsl(120, 100%,  25%)     or    hsl(120, 255,   63.75)     dark green
    +hsl(120, 50%,   50%)     or    hsl(120, 127.5, 127.5)     medium green
    -
    -MagickBooleanType ListColorInfo(FILE *file,ExceptionInfo *exception)
    -
    +

    One advantage of HSB or HSL over RGB is that it can be more intuitive: you can guess at the colors you want, and then tweak. It is also easier to create sets of matching colors (by keeping the hue the same and varying the brightness or lightness and saturation, for example).

    -

    A description of each parameter follows.

    +

    Just as the 'rgb()' functional notation has the 'rgba()' alpha counterpart, the 'hsl()' and 'hsb()' functional notations have their 'hsla()' 'hsba()' alpha counterparts. These examples specify the same color:

    -
    file
    -

    List color names to this file handle.

    +
    hsb(120, 100%,  100%)              full green in hsb
    +hsba(120, 100%,  100%,  1.0)       the same, with an alpha value of 1.0
    +hsb(120, 255,  255)                full green in hsb
    +hsba(120, 255,  255,  1.0)         the same, with an alpha value of 1.0
     
    -
    exception
    -

    return any errors or warnings in this structure.

    +hsl(120, 100%, 50%) full green in hsl +hsla(120, 100%, 50%, 1.0) the same, with an alpha value of 1.0 +hsl(120, 255, 127.5) full green in hsl +hsla(120, 255, 127.5, 1.0) the same, with an alpha value of 1.0
    -

    QueryColorname

    +

    For ImageMagick between 6.5.6-6 and 6.9.2-0, HSL (HSB) could only be specified with Hue as percent in range 0—100%, when Saturation and Lightness (Brightness) were also specified as percent in range 0—100%.

    -

    QueryColorname() returns a named color for the given color intensity. If an exact match is not found, a hex value is returned instead. For example an intensity of rgb:(0,0,0) returns black whereas rgb:(223,223,223) returns #dfdfdf.

    +

    Specify the Lab colors like this:

    +
    cielab(62.253188, 23.950124, 48.410653)
    +

    Note, the a and b components of any Lab color you specify are biased internally by 50% to ensure it fits in the quantum range (typically 0 to 65535). The bias is retained when writing to the TIFF and MIFF image formats. However, the TXT format supports negative pixel values so the bias is removed when writing to this format:

    +
    -> magick xc:cyan -colorspace LAB txt:
    +# ImageMagick pixel enumeration: 1,1,65535,cielab
    +0,0: (91.1131%,-18.8571%,-5.5436%)  #E93F00000000  cielab(91.1131%,-18.8571%,-5.5436%)
     
    -

    UPDATE: the 'image' argument is no longer needed as all information should have been preset using GetPixelInfo().

    +-> magick -size 100x100 xc:"cielab(91.1131%,-18.8571%,-5.5436%)" -colorspace sRGB cyan.png
    -

    The format of the QueryColorname method is:

    +

    Or specify colors generically with the icc-color keyword, for example:

    +
    icc-color(cmyk, 0.11, 0.48, 0.83, 0.00)
    +icc-color(rgb, white)
    -
    -MagickBooleanType QueryColorname(const Image *image,
    -  const PixelInfo *color,const ComplianceType compliance,char *name,
    -  ExceptionInfo *exception)
    -
    +

    Or specify uncalibrated device colors with the device- keyword, for example:

    +
    device-gray(0.5)
    +device-rgb(0.5, 1.0, 0.0)
    +device-cmyk(0.11, 0.48, 0.83, 0.00)
    -

    A description of each parameter follows.

    +

    List of Color Names

    -
    image
    -

    the image. (not used! - color gets settings from GetPixelInfo()

    +

    The table below provides a list of named colors recognized by ImageMagick:

    -
    color
    -

    the color intensities.

    + + + + + + + + -
    Compliance
    -

    Adhere to this color standard: SVG, X11, or XPM.

    + + + + + + -
    name
    -

    Return the color name or hex value.

    + + + + + + -
    exception
    -

    return any errors or warnings in this structure.

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameColorRGBHex
    snowsnowrgb(255, 250, 250)#FFFAFA
    snow1snow1rgb(255, 250, 250)#FFFAFA
    snow2snow2rgb(238, 233, 233)#EEE9E9
    RosyBrown1RosyBrown1rgb(255, 193, 193)#FFC1C1
    RosyBrown2RosyBrown2rgb(238, 180, 180)#EEB4B4
    snow3snow3rgb(205, 201, 201)#CDC9C9
    LightCoralLightCoralrgb(240, 128, 128)#F08080
    IndianRed1IndianRed1rgb(255, 106, 106)#FF6A6A
    RosyBrown3RosyBrown3rgb(205, 155, 155)#CD9B9B
    IndianRed2IndianRed2rgb(238, 99, 99)#EE6363
    RosyBrownRosyBrownrgb(188, 143, 143)#BC8F8F
    brown1brown1rgb(255, 64, 64)#FF4040
    firebrick1firebrick1rgb(255, 48, 48)#FF3030
    brown2brown2rgb(238, 59, 59)#EE3B3B
    IndianRedIndianRedrgb(205, 92, 92)#CD5C5C
    IndianRed3IndianRed3rgb(205, 85, 85)#CD5555
    firebrick2firebrick2rgb(238, 44, 44)#EE2C2C
    snow4snow4rgb(139, 137, 137)#8B8989
    brown3brown3rgb(205, 51, 51)#CD3333
    redredrgb(255, 0, 0)#FF0000
    red1red1rgb(255, 0, 0)#FF0000
    RosyBrown4RosyBrown4rgb(139, 105, 105)#8B6969
    firebrick3firebrick3rgb(205, 38, 38)#CD2626
    red2red2rgb(238, 0, 0)#EE0000
    firebrickfirebrickrgb(178, 34, 34)#B22222
    brownbrownrgb(165, 42, 42)#A52A2A
    red3red3rgb(205, 0, 0)#CD0000
    IndianRed4IndianRed4rgb(139, 58, 58)#8B3A3A
    brown4brown4rgb(139, 35, 35)#8B2323
    firebrick4firebrick4rgb(139, 26, 26)#8B1A1A
    DarkRedDarkRedrgb(139, 0, 0)#8B0000
    red4red4rgb(139, 0, 0)#8B0000
    maroonmaroon (SVG compliance)rgb(128, 0, 0)#800000
    LightPink1LightPink1rgb(255, 174, 185)#FFAEB9
    LightPink3LightPink3rgb(205, 140, 149)#CD8C95
    LightPink4LightPink4rgb(139, 95, 101)#8B5F65
    LightPink2LightPink2rgb(238, 162, 173)#EEA2AD
    LightPinkLightPinkrgb(255, 182, 193)#FFB6C1
    pinkpinkrgb(255, 192, 203)#FFC0CB
    crimsoncrimsonrgb(220, 20, 60)#DC143C
    pink1pink1rgb(255, 181, 197)#FFB5C5
    pink2pink2rgb(238, 169, 184)#EEA9B8
    pink3pink3rgb(205, 145, 158)#CD919E
    pink4pink4rgb(139, 99, 108)#8B636C
    PaleVioletRed4PaleVioletRed4rgb(139, 71, 93)#8B475D
    PaleVioletRedPaleVioletRedrgb(219, 112, 147)#DB7093
    PaleVioletRed2PaleVioletRed2rgb(238, 121, 159)#EE799F
    PaleVioletRed1PaleVioletRed1rgb(255, 130, 171)#FF82AB
    PaleVioletRed3PaleVioletRed3rgb(205, 104, 137)#CD6889
    LavenderBlushLavenderBlushrgb(255, 240, 245)#FFF0F5
    LavenderBlush1LavenderBlush1rgb(255, 240, 245)#FFF0F5
    LavenderBlush3LavenderBlush3rgb(205, 193, 197)#CDC1C5
    LavenderBlush2LavenderBlush2rgb(238, 224, 229)#EEE0E5
    LavenderBlush4LavenderBlush4rgb(139, 131, 134)#8B8386
    maroonmaroon (X11 compliance)rgb(176, 48, 96)#B03060
    HotPink3HotPink3rgb(205, 96, 144)#CD6090
    VioletRed3VioletRed3rgb(205, 50, 120)#CD3278
    VioletRed1VioletRed1rgb(255, 62, 150)#FF3E96
    VioletRed2VioletRed2rgb(238, 58, 140)#EE3A8C
    VioletRed4VioletRed4rgb(139, 34, 82)#8B2252
    HotPink2HotPink2rgb(238, 106, 167)#EE6AA7
    HotPink1HotPink1rgb(255, 110, 180)#FF6EB4
    HotPink4HotPink4rgb(139, 58, 98)#8B3A62
    HotPinkHotPinkrgb(255, 105, 180)#FF69B4
    DeepPinkDeepPinkrgb(255, 20, 147)#FF1493
    DeepPink1DeepPink1rgb(255, 20, 147)#FF1493
    DeepPink2DeepPink2rgb(238, 18, 137)#EE1289
    DeepPink3DeepPink3rgb(205, 16, 118)#CD1076
    DeepPink4DeepPink4rgb(139, 10, 80)#8B0A50
    maroon1maroon1rgb(255, 52, 179)#FF34B3
    maroon2maroon2rgb(238, 48, 167)#EE30A7
    maroon3maroon3rgb(205, 41, 144)#CD2990
    maroon4maroon4rgb(139, 28, 98)#8B1C62
    MediumVioletRedMediumVioletRedrgb(199, 21, 133)#C71585
    VioletRedVioletRedrgb(208, 32, 144)#D02090
    orchid2orchid2rgb(238, 122, 233)#EE7AE9
    orchidorchidrgb(218, 112, 214)#DA70D6
    orchid1orchid1rgb(255, 131, 250)#FF83FA
    orchid3orchid3rgb(205, 105, 201)#CD69C9
    orchid4orchid4rgb(139, 71, 137)#8B4789
    thistle1thistle1rgb(255, 225, 255)#FFE1FF
    thistle2thistle2rgb(238, 210, 238)#EED2EE
    plum1plum1rgb(255, 187, 255)#FFBBFF
    plum2plum2rgb(238, 174, 238)#EEAEEE
    thistlethistlergb(216, 191, 216)#D8BFD8
    thistle3thistle3rgb(205, 181, 205)#CDB5CD
    plumplumrgb(221, 160, 221)#DDA0DD
    violetvioletrgb(238, 130, 238)#EE82EE
    plum3plum3rgb(205, 150, 205)#CD96CD
    thistle4thistle4rgb(139, 123, 139)#8B7B8B
    fuchsiafuchsiargb(255, 0, 255)#FF00FF
    magentamagentargb(255, 0, 255)#FF00FF
    magenta1magenta1rgb(255, 0, 255)#FF00FF
    plum4plum4rgb(139, 102, 139)#8B668B
    magenta2magenta2rgb(238, 0, 238)#EE00EE
    magenta3magenta3rgb(205, 0, 205)#CD00CD
    DarkMagentaDarkMagentargb(139, 0, 139)#8B008B
    magenta4magenta4rgb(139, 0, 139)#8B008B
    purplepurple (SVG compliance)rgb(128, 0, 128)#800080
    MediumOrchidMediumOrchidrgb(186, 85, 211)#BA55D3
    MediumOrchid1MediumOrchid1rgb(224, 102, 255)#E066FF
    MediumOrchid2MediumOrchid2rgb(209, 95, 238)#D15FEE
    MediumOrchid3MediumOrchid3rgb(180, 82, 205)#B452CD
    MediumOrchid4MediumOrchid4rgb(122, 55, 139)#7A378B
    DarkVioletDarkVioletrgb(148, 0, 211)#9400D3
    DarkOrchidDarkOrchidrgb(153, 50, 204)#9932CC
    DarkOrchid1DarkOrchid1rgb(191, 62, 255)#BF3EFF
    DarkOrchid3DarkOrchid3rgb(154, 50, 205)#9A32CD
    DarkOrchid2DarkOrchid2rgb(178, 58, 238)#B23AEE
    DarkOrchid4DarkOrchid4rgb(104, 34, 139)#68228B
    purplepurple (X11 compliance)rgb(160, 32, 240)#A020F0
    indigoindigorgb( 75, 0, 130)#4B0082
    BlueVioletBlueVioletrgb(138, 43, 226)#8A2BE2
    purple2purple2rgb(145, 44, 238)#912CEE
    purple3purple3rgb(125, 38, 205)#7D26CD
    purple4purple4rgb( 85, 26, 139)#551A8B
    purple1purple1rgb(155, 48, 255)#9B30FF
    MediumPurpleMediumPurplergb(147, 112, 219)#9370DB
    MediumPurple1MediumPurple1rgb(171, 130, 255)#AB82FF
    MediumPurple2MediumPurple2rgb(159, 121, 238)#9F79EE
    MediumPurple3MediumPurple3rgb(137, 104, 205)#8968CD
    MediumPurple4MediumPurple4rgb( 93, 71, 139)#5D478B
    DarkSlateBlueDarkSlateBluergb( 72, 61, 139)#483D8B
    LightSlateBlueLightSlateBluergb(132, 112, 255)#8470FF
    MediumSlateBlueMediumSlateBluergb(123, 104, 238)#7B68EE
    SlateBlueSlateBluergb(106, 90, 205)#6A5ACD
    SlateBlue1SlateBlue1rgb(131, 111, 255)#836FFF
    SlateBlue2SlateBlue2rgb(122, 103, 238)#7A67EE
    SlateBlue3SlateBlue3rgb(105, 89, 205)#6959CD
    SlateBlue4SlateBlue4rgb( 71, 60, 139)#473C8B
    GhostWhiteGhostWhitergb(248, 248, 255)#F8F8FF
    lavenderlavenderrgb(230, 230, 250)#E6E6FA
    bluebluergb( 0, 0, 255)#0000FF
    blue1blue1rgb( 0, 0, 255)#0000FF
    blue2blue2rgb( 0, 0, 238)#0000EE
    blue3blue3rgb( 0, 0, 205)#0000CD
    MediumBlueMediumBluergb( 0, 0, 205)#0000CD
    blue4blue4rgb( 0, 0, 139)#00008B
    DarkBlueDarkBluergb( 0, 0, 139)#00008B
    MidnightBlueMidnightBluergb( 25, 25, 112)#191970
    navynavyrgb( 0, 0, 128)#000080
    NavyBlueNavyBluergb( 0, 0, 128)#000080
    RoyalBlueRoyalBluergb( 65, 105, 225)#4169E1
    RoyalBlue1RoyalBlue1rgb( 72, 118, 255)#4876FF
    RoyalBlue2RoyalBlue2rgb( 67, 110, 238)#436EEE
    RoyalBlue3RoyalBlue3rgb( 58, 95, 205)#3A5FCD
    RoyalBlue4RoyalBlue4rgb( 39, 64, 139)#27408B
    CornflowerBlueCornflowerBluergb(100, 149, 237)#6495ED
    LightSteelBlueLightSteelBluergb(176, 196, 222)#B0C4DE
    LightSteelBlue1LightSteelBlue1rgb(202, 225, 255)#CAE1FF
    LightSteelBlue2LightSteelBlue2rgb(188, 210, 238)#BCD2EE
    LightSteelBlue3LightSteelBlue3rgb(162, 181, 205)#A2B5CD
    LightSteelBlue4LightSteelBlue4rgb(110, 123, 139)#6E7B8B
    SlateGray4SlateGray4rgb(108, 123, 139)#6C7B8B
    SlateGray1SlateGray1rgb(198, 226, 255)#C6E2FF
    SlateGray2SlateGray2rgb(185, 211, 238)#B9D3EE
    SlateGray3SlateGray3rgb(159, 182, 205)#9FB6CD
    LightSlateGrayLightSlateGrayrgb(119, 136, 153)#778899
    LightSlateGreyLightSlateGreyrgb(119, 136, 153)#778899
    SlateGraySlateGrayrgb(112, 128, 144)#708090
    SlateGreySlateGreyrgb(112, 128, 144)#708090
    DodgerBlueDodgerBluergb( 30, 144, 255)#1E90FF
    DodgerBlue1DodgerBlue1rgb( 30, 144, 255)#1E90FF
    DodgerBlue2DodgerBlue2rgb( 28, 134, 238)#1C86EE
    DodgerBlue4DodgerBlue4rgb( 16, 78, 139)#104E8B
    DodgerBlue3DodgerBlue3rgb( 24, 116, 205)#1874CD
    AliceBlueAliceBluergb(240, 248, 255)#F0F8FF
    SteelBlue4SteelBlue4rgb( 54, 100, 139)#36648B
    SteelBlueSteelBluergb( 70, 130, 180)#4682B4
    SteelBlue1SteelBlue1rgb( 99, 184, 255)#63B8FF
    SteelBlue2SteelBlue2rgb( 92, 172, 238)#5CACEE
    SteelBlue3SteelBlue3rgb( 79, 148, 205)#4F94CD
    SkyBlue4SkyBlue4rgb( 74, 112, 139)#4A708B
    SkyBlue1SkyBlue1rgb(135, 206, 255)#87CEFF
    SkyBlue2SkyBlue2rgb(126, 192, 238)#7EC0EE
    SkyBlue3SkyBlue3rgb(108, 166, 205)#6CA6CD
    LightSkyBlueLightSkyBluergb(135, 206, 250)#87CEFA
    LightSkyBlue4LightSkyBlue4rgb( 96, 123, 139)#607B8B
    LightSkyBlue1LightSkyBlue1rgb(176, 226, 255)#B0E2FF
    LightSkyBlue2LightSkyBlue2rgb(164, 211, 238)#A4D3EE
    LightSkyBlue3LightSkyBlue3rgb(141, 182, 205)#8DB6CD
    SkyBlueSkyBluergb(135, 206, 235)#87CEEB
    LightBlue3LightBlue3rgb(154, 192, 205)#9AC0CD
    DeepSkyBlueDeepSkyBluergb( 0, 191, 255)#00BFFF
    DeepSkyBlue1DeepSkyBlue1rgb( 0, 191, 255)#00BFFF
    DeepSkyBlue2DeepSkyBlue2rgb( 0, 178, 238)#00B2EE
    DeepSkyBlue4DeepSkyBlue4rgb( 0, 104, 139)#00688B
    DeepSkyBlue3DeepSkyBlue3rgb( 0, 154, 205)#009ACD
    LightBlue1LightBlue1rgb(191, 239, 255)#BFEFFF
    LightBlue2LightBlue2rgb(178, 223, 238)#B2DFEE
    LightBlueLightBluergb(173, 216, 230)#ADD8E6
    LightBlue4LightBlue4rgb(104, 131, 139)#68838B
    PowderBluePowderBluergb(176, 224, 230)#B0E0E6
    CadetBlue1CadetBlue1rgb(152, 245, 255)#98F5FF
    CadetBlue2CadetBlue2rgb(142, 229, 238)#8EE5EE
    CadetBlue3CadetBlue3rgb(122, 197, 205)#7AC5CD
    CadetBlue4CadetBlue4rgb( 83, 134, 139)#53868B
    turquoise1turquoise1rgb( 0, 245, 255)#00F5FF
    turquoise2turquoise2rgb( 0, 229, 238)#00E5EE
    turquoise3turquoise3rgb( 0, 197, 205)#00C5CD
    turquoise4turquoise4rgb( 0, 134, 139)#00868B
    cadet bluecadet bluergb( 95, 158, 160)#5F9EA0
    CadetBlueCadetBluergb( 95, 158, 160)#5F9EA0
    DarkTurquoiseDarkTurquoisergb( 0, 206, 209)#00CED1
    azureazurergb(240, 255, 255)#F0FFFF
    azure1azure1rgb(240, 255, 255)#F0FFFF
    LightCyanLightCyanrgb(224, 255, 255)#E0FFFF
    LightCyan1LightCyan1rgb(224, 255, 255)#E0FFFF
    azure2azure2rgb(224, 238, 238)#E0EEEE
    LightCyan2LightCyan2rgb(209, 238, 238)#D1EEEE
    PaleTurquoise1PaleTurquoise1rgb(187, 255, 255)#BBFFFF
    PaleTurquoisePaleTurquoisergb(175, 238, 238)#AFEEEE
    PaleTurquoise2PaleTurquoise2rgb(174, 238, 238)#AEEEEE
    DarkSlateGray1DarkSlateGray1rgb(151, 255, 255)#97FFFF
    azure3azure3rgb(193, 205, 205)#C1CDCD
    LightCyan3LightCyan3rgb(180, 205, 205)#B4CDCD
    DarkSlateGray2DarkSlateGray2rgb(141, 238, 238)#8DEEEE
    PaleTurquoise3PaleTurquoise3rgb(150, 205, 205)#96CDCD
    DarkSlateGray3DarkSlateGray3rgb(121, 205, 205)#79CDCD
    azure4azure4rgb(131, 139, 139)#838B8B
    LightCyan4LightCyan4rgb(122, 139, 139)#7A8B8B
    aquaaquargb( 0, 255, 255)#00FFFF
    cyancyanrgb( 0, 255, 255)#00FFFF
    cyan1cyan1rgb( 0, 255, 255)#00FFFF
    PaleTurquoise4PaleTurquoise4rgb(102, 139, 139)#668B8B
    cyan2cyan2rgb( 0, 238, 238)#00EEEE
    DarkSlateGray4DarkSlateGray4rgb( 82, 139, 139)#528B8B
    cyan3cyan3rgb( 0, 205, 205)#00CDCD
    cyan4cyan4rgb( 0, 139, 139)#008B8B
    DarkCyanDarkCyanrgb( 0, 139, 139)#008B8B
    tealtealrgb( 0, 128, 128)#008080
    DarkSlateGrayDarkSlateGrayrgb( 47, 79, 79)#2F4F4F
    DarkSlateGreyDarkSlateGreyrgb( 47, 79, 79)#2F4F4F
    MediumTurquoiseMediumTurquoisergb( 72, 209, 204)#48D1CC
    LightSeaGreenLightSeaGreenrgb( 32, 178, 170)#20B2AA
    turquoiseturquoisergb( 64, 224, 208)#40E0D0
    aquamarine4aquamarine4rgb( 69, 139, 116)#458B74
    aquamarineaquamarinergb(127, 255, 212)#7FFFD4
    aquamarine1aquamarine1rgb(127, 255, 212)#7FFFD4
    aquamarine2aquamarine2rgb(118, 238, 198)#76EEC6
    aquamarine3aquamarine3rgb(102, 205, 170)#66CDAA
    MediumAquamarineMediumAquamarinergb(102, 205, 170)#66CDAA
    MediumSpringGreenMediumSpringGreenrgb( 0, 250, 154)#00FA9A
    MintCreamMintCreamrgb(245, 255, 250)#F5FFFA
    SpringGreenSpringGreenrgb( 0, 255, 127)#00FF7F
    SpringGreen1SpringGreen1rgb( 0, 255, 127)#00FF7F
    SpringGreen2SpringGreen2rgb( 0, 238, 118)#00EE76
    SpringGreen3SpringGreen3rgb( 0, 205, 102)#00CD66
    SpringGreen4SpringGreen4rgb( 0, 139, 69)#008B45
    MediumSeaGreenMediumSeaGreenrgb( 60, 179, 113)#3CB371
    SeaGreenSeaGreenrgb( 46, 139, 87)#2E8B57
    SeaGreen3SeaGreen3rgb( 67, 205, 128)#43CD80
    SeaGreen1SeaGreen1rgb( 84, 255, 159)#54FF9F
    SeaGreen4SeaGreen4rgb( 46, 139, 87)#2E8B57
    SeaGreen2SeaGreen2rgb( 78, 238, 148)#4EEE94
    MediumForestGreenMediumForestGreenrgb( 50, 129, 75)#32814B
    honeydewhoneydewrgb(240, 255, 240)#F0FFF0
    honeydew1honeydew1rgb(240, 255, 240)#F0FFF0
    honeydew2honeydew2rgb(224, 238, 224)#E0EEE0
    DarkSeaGreen1DarkSeaGreen1rgb(193, 255, 193)#C1FFC1
    DarkSeaGreen2DarkSeaGreen2rgb(180, 238, 180)#B4EEB4
    PaleGreen1PaleGreen1rgb(154, 255, 154)#9AFF9A
    PaleGreenPaleGreenrgb(152, 251, 152)#98FB98
    honeydew3honeydew3rgb(193, 205, 193)#C1CDC1
    LightGreenLightGreenrgb(144, 238, 144)#90EE90
    PaleGreen2PaleGreen2rgb(144, 238, 144)#90EE90
    DarkSeaGreen3DarkSeaGreen3rgb(155, 205, 155)#9BCD9B
    DarkSeaGreenDarkSeaGreenrgb(143, 188, 143)#8FBC8F
    PaleGreen3PaleGreen3rgb(124, 205, 124)#7CCD7C
    honeydew4honeydew4rgb(131, 139, 131)#838B83
    green1green1rgb( 0, 255, 0)#00FF00
    limelimergb( 0, 255, 0)#00FF00
    LimeGreenLimeGreenrgb( 50, 205, 50)#32CD32
    DarkSeaGreen4DarkSeaGreen4rgb(105, 139, 105)#698B69
    green2green2rgb( 0, 238, 0)#00EE00
    PaleGreen4PaleGreen4rgb( 84, 139, 84)#548B54
    green3green3rgb( 0, 205, 0)#00CD00
    ForestGreenForestGreenrgb( 34, 139, 34)#228B22
    green4green4rgb( 0, 139, 0)#008B00
    greengreenrgb( 0, 128, 0)#008000
    DarkGreenDarkGreenrgb( 0, 100, 0)#006400
    LawnGreenLawnGreenrgb(124, 252, 0)#7CFC00
    chartreusechartreusergb(127, 255, 0)#7FFF00
    chartreuse1chartreuse1rgb(127, 255, 0)#7FFF00
    chartreuse2chartreuse2rgb(118, 238, 0)#76EE00
    chartreuse3chartreuse3rgb(102, 205, 0)#66CD00
    chartreuse4chartreuse4rgb( 69, 139, 0)#458B00
    GreenYellowGreenYellowrgb(173, 255, 47)#ADFF2F
    DarkOliveGreen3DarkOliveGreen3rgb(162, 205, 90)#A2CD5A
    DarkOliveGreen1DarkOliveGreen1rgb(202, 255, 112)#CAFF70
    DarkOliveGreen2DarkOliveGreen2rgb(188, 238, 104)#BCEE68
    DarkOliveGreen4DarkOliveGreen4rgb(110, 139, 61)#6E8B3D
    DarkOliveGreenDarkOliveGreenrgb( 85, 107, 47)#556B2F
    OliveDrabOliveDrabrgb(107, 142, 35)#6B8E23
    OliveDrab1OliveDrab1rgb(192, 255, 62)#C0FF3E
    OliveDrab2OliveDrab2rgb(179, 238, 58)#B3EE3A
    OliveDrab3OliveDrab3rgb(154, 205, 50)#9ACD32
    YellowGreenYellowGreenrgb(154, 205, 50)#9ACD32
    OliveDrab4OliveDrab4rgb(105, 139, 34)#698B22
    ivoryivoryrgb(255, 255, 240)#FFFFF0
    ivory1ivory1rgb(255, 255, 240)#FFFFF0
    LightYellowLightYellowrgb(255, 255, 224)#FFFFE0
    LightYellow1LightYellow1rgb(255, 255, 224)#FFFFE0
    beigebeigergb(245, 245, 220)#F5F5DC
    ivory2ivory2rgb(238, 238, 224)#EEEEE0
    LightGoldenrodYellowLightGoldenrodYellowrgb(250, 250, 210)#FAFAD2
    LightYellow2LightYellow2rgb(238, 238, 209)#EEEED1
    ivory3ivory3rgb(205, 205, 193)#CDCDC1
    LightYellow3LightYellow3rgb(205, 205, 180)#CDCDB4
    ivory4ivory4rgb(139, 139, 131)#8B8B83
    LightYellow4LightYellow4rgb(139, 139, 122)#8B8B7A
    yellowyellowrgb(255, 255, 0)#FFFF00
    yellow1yellow1rgb(255, 255, 0)#FFFF00
    yellow2yellow2rgb(238, 238, 0)#EEEE00
    yellow3yellow3rgb(205, 205, 0)#CDCD00
    yellow4yellow4rgb(139, 139, 0)#8B8B00
    oliveolivergb(128, 128, 0)#808000
    DarkKhakiDarkKhakirgb(189, 183, 107)#BDB76B
    khaki2khaki2rgb(238, 230, 133)#EEE685
    LemonChiffon4LemonChiffon4rgb(139, 137, 112)#8B8970
    khaki1khaki1rgb(255, 246, 143)#FFF68F
    khaki3khaki3rgb(205, 198, 115)#CDC673
    khaki4khaki4rgb(139, 134, 78)#8B864E
    PaleGoldenrodPaleGoldenrodrgb(238, 232, 170)#EEE8AA
    LemonChiffonLemonChiffonrgb(255, 250, 205)#FFFACD
    LemonChiffon1LemonChiffon1rgb(255, 250, 205)#FFFACD
    khakikhakirgb(240, 230, 140)#F0E68C
    LemonChiffon3LemonChiffon3rgb(205, 201, 165)#CDC9A5
    LemonChiffon2LemonChiffon2rgb(238, 233, 191)#EEE9BF
    MediumGoldenRodMediumGoldenRodrgb(209, 193, 102)#D1C166
    cornsilk4cornsilk4rgb(139, 136, 120)#8B8878
    goldgoldrgb(255, 215, 0)#FFD700
    gold1gold1rgb(255, 215, 0)#FFD700
    gold2gold2rgb(238, 201, 0)#EEC900
    gold3gold3rgb(205, 173, 0)#CDAD00
    gold4gold4rgb(139, 117, 0)#8B7500
    LightGoldenrodLightGoldenrodrgb(238, 221, 130)#EEDD82
    LightGoldenrod4LightGoldenrod4rgb(139, 129, 76)#8B814C
    LightGoldenrod1LightGoldenrod1rgb(255, 236, 139)#FFEC8B
    LightGoldenrod3LightGoldenrod3rgb(205, 190, 112)#CDBE70
    LightGoldenrod2LightGoldenrod2rgb(238, 220, 130)#EEDC82
    cornsilk3cornsilk3rgb(205, 200, 177)#CDC8B1
    cornsilk2cornsilk2rgb(238, 232, 205)#EEE8CD
    cornsilkcornsilkrgb(255, 248, 220)#FFF8DC
    cornsilk1cornsilk1rgb(255, 248, 220)#FFF8DC
    goldenrodgoldenrodrgb(218, 165, 32)#DAA520
    goldenrod1goldenrod1rgb(255, 193, 37)#FFC125
    goldenrod2goldenrod2rgb(238, 180, 34)#EEB422
    goldenrod3goldenrod3rgb(205, 155, 29)#CD9B1D
    goldenrod4goldenrod4rgb(139, 105, 20)#8B6914
    DarkGoldenrodDarkGoldenrodrgb(184, 134, 11)#B8860B
    DarkGoldenrod1DarkGoldenrod1rgb(255, 185, 15)#FFB90F
    DarkGoldenrod2DarkGoldenrod2rgb(238, 173, 14)#EEAD0E
    DarkGoldenrod3DarkGoldenrod3rgb(205, 149, 12)#CD950C
    DarkGoldenrod4DarkGoldenrod4rgb(139, 101, 8)#8B6508
    FloralWhiteFloralWhitergb(255, 250, 240)#FFFAF0
    wheat2wheat2rgb(238, 216, 174)#EED8AE
    OldLaceOldLacergb(253, 245, 230)#FDF5E6
    wheatwheatrgb(245, 222, 179)#F5DEB3
    wheat1wheat1rgb(255, 231, 186)#FFE7BA
    wheat3wheat3rgb(205, 186, 150)#CDBA96
    orangeorangergb(255, 165, 0)#FFA500
    orange1orange1rgb(255, 165, 0)#FFA500
    orange2orange2rgb(238, 154, 0)#EE9A00
    orange3orange3rgb(205, 133, 0)#CD8500
    orange4orange4rgb(139, 90, 0)#8B5A00
    wheat4wheat4rgb(139, 126, 102)#8B7E66
    moccasinmoccasinrgb(255, 228, 181)#FFE4B5
    PapayaWhipPapayaWhiprgb(255, 239, 213)#FFEFD5
    NavajoWhite3NavajoWhite3rgb(205, 179, 139)#CDB38B
    BlanchedAlmondBlanchedAlmondrgb(255, 235, 205)#FFEBCD
    NavajoWhiteNavajoWhitergb(255, 222, 173)#FFDEAD
    NavajoWhite1NavajoWhite1rgb(255, 222, 173)#FFDEAD
    NavajoWhite2NavajoWhite2rgb(238, 207, 161)#EECFA1
    NavajoWhite4NavajoWhite4rgb(139, 121, 94)#8B795E
    AntiqueWhite4AntiqueWhite4rgb(139, 131, 120)#8B8378
    AntiqueWhiteAntiqueWhitergb(250, 235, 215)#FAEBD7
    tantanrgb(210, 180, 140)#D2B48C
    bisque4bisque4rgb(139, 125, 107)#8B7D6B
    burlywoodburlywoodrgb(222, 184, 135)#DEB887
    AntiqueWhite2AntiqueWhite2rgb(238, 223, 204)#EEDFCC
    burlywood1burlywood1rgb(255, 211, 155)#FFD39B
    burlywood3burlywood3rgb(205, 170, 125)#CDAA7D
    burlywood2burlywood2rgb(238, 197, 145)#EEC591
    AntiqueWhite1AntiqueWhite1rgb(255, 239, 219)#FFEFDB
    burlywood4burlywood4rgb(139, 115, 85)#8B7355
    AntiqueWhite3AntiqueWhite3rgb(205, 192, 176)#CDC0B0
    DarkOrangeDarkOrangergb(255, 140, 0)#FF8C00
    bisque2bisque2rgb(238, 213, 183)#EED5B7
    bisquebisquergb(255, 228, 196)#FFE4C4
    bisque1bisque1rgb(255, 228, 196)#FFE4C4
    bisque3bisque3rgb(205, 183, 158)#CDB79E
    DarkOrange1DarkOrange1rgb(255, 127, 0)#FF7F00
    linenlinenrgb(250, 240, 230)#FAF0E6
    DarkOrange2DarkOrange2rgb(238, 118, 0)#EE7600
    DarkOrange3DarkOrange3rgb(205, 102, 0)#CD6600
    DarkOrange4DarkOrange4rgb(139, 69, 0)#8B4500
    peruperurgb(205, 133, 63)#CD853F
    tan1tan1rgb(255, 165, 79)#FFA54F
    tan2tan2rgb(238, 154, 73)#EE9A49
    tan3tan3rgb(205, 133, 63)#CD853F
    tan4tan4rgb(139, 90, 43)#8B5A2B
    PeachPuffPeachPuffrgb(255, 218, 185)#FFDAB9
    PeachPuff1PeachPuff1rgb(255, 218, 185)#FFDAB9
    PeachPuff4PeachPuff4rgb(139, 119, 101)#8B7765
    PeachPuff2PeachPuff2rgb(238, 203, 173)#EECBAD
    PeachPuff3PeachPuff3rgb(205, 175, 149)#CDAF95
    SandyBrownSandyBrownrgb(244, 164, 96)#F4A460
    seashell4seashell4rgb(139, 134, 130)#8B8682
    seashell2seashell2rgb(238, 229, 222)#EEE5DE
    seashell3seashell3rgb(205, 197, 191)#CDC5BF
    chocolatechocolatergb(210, 105, 30)#D2691E
    chocolate1chocolate1rgb(255, 127, 36)#FF7F24
    chocolate2chocolate2rgb(238, 118, 33)#EE7621
    chocolate3chocolate3rgb(205, 102, 29)#CD661D
    chocolate4chocolate4rgb(139, 69, 19)#8B4513
    SaddleBrownSaddleBrownrgb(139, 69, 19)#8B4513
    seashellseashellrgb(255, 245, 238)#FFF5EE
    seashell1seashell1rgb(255, 245, 238)#FFF5EE
    sienna4sienna4rgb(139, 71, 38)#8B4726
    siennasiennargb(160, 82, 45)#A0522D
    sienna1sienna1rgb(255, 130, 71)#FF8247
    sienna2sienna2rgb(238, 121, 66)#EE7942
    sienna3sienna3rgb(205, 104, 57)#CD6839
    LightSalmon3LightSalmon3rgb(205, 129, 98)#CD8162
    LightSalmonLightSalmonrgb(255, 160, 122)#FFA07A
    LightSalmon1LightSalmon1rgb(255, 160, 122)#FFA07A
    LightSalmon4LightSalmon4rgb(139, 87, 66)#8B5742
    LightSalmon2LightSalmon2rgb(238, 149, 114)#EE9572
    coralcoralrgb(255, 127, 80)#FF7F50
    OrangeRedOrangeRedrgb(255, 69, 0)#FF4500
    OrangeRed1OrangeRed1rgb(255, 69, 0)#FF4500
    OrangeRed2OrangeRed2rgb(238, 64, 0)#EE4000
    OrangeRed3OrangeRed3rgb(205, 55, 0)#CD3700
    OrangeRed4OrangeRed4rgb(139, 37, 0)#8B2500
    DarkSalmonDarkSalmonrgb(233, 150, 122)#E9967A
    salmon1salmon1rgb(255, 140, 105)#FF8C69
    salmon2salmon2rgb(238, 130, 98)#EE8262
    salmon3salmon3rgb(205, 112, 84)#CD7054
    salmon4salmon4rgb(139, 76, 57)#8B4C39
    coral1coral1rgb(255, 114, 86)#FF7256
    coral2coral2rgb(238, 106, 80)#EE6A50
    coral3coral3rgb(205, 91, 69)#CD5B45
    coral4coral4rgb(139, 62, 47)#8B3E2F
    tomato4tomato4rgb(139, 54, 38)#8B3626
    tomatotomatorgb(255, 99, 71)#FF6347
    tomato1tomato1rgb(255, 99, 71)#FF6347
    tomato2tomato2rgb(238, 92, 66)#EE5C42
    tomato3tomato3rgb(205, 79, 57)#CD4F39
    MistyRose4MistyRose4rgb(139, 125, 123)#8B7D7B
    MistyRose2MistyRose2rgb(238, 213, 210)#EED5D2
    MistyRoseMistyRosergb(255, 228, 225)#FFE4E1
    MistyRose1MistyRose1rgb(255, 228, 225)#FFE4E1
    salmonsalmonrgb(250, 128, 114)#FA8072
    MistyRose3MistyRose3rgb(205, 183, 181)#CDB7B5
    whitewhitergb(255, 255, 255)#FFFFFF
    gray100gray100rgb(255, 255, 255)#FFFFFF
    grey100grey100rgb(255, 255, 255)#FFFFFF
    grey100grey100rgb(255, 255, 255)#FFFFFF
    gray99gray99rgb(252, 252, 252)#FCFCFC
    grey99grey99rgb(252, 252, 252)#FCFCFC
    gray98gray98rgb(250, 250, 250)#FAFAFA
    grey98grey98rgb(250, 250, 250)#FAFAFA
    gray97gray97rgb(247, 247, 247)#F7F7F7
    grey97grey97rgb(247, 247, 247)#F7F7F7
    gray96gray96rgb(245, 245, 245)#F5F5F5
    grey96grey96rgb(245, 245, 245)#F5F5F5
    WhiteSmokeWhiteSmokergb(245, 245, 245)#F5F5F5
    gray95gray95rgb(242, 242, 242)#F2F2F2
    grey95grey95rgb(242, 242, 242)#F2F2F2
    gray94gray94rgb(240, 240, 240)#F0F0F0
    grey94grey94rgb(240, 240, 240)#F0F0F0
    gray93gray93rgb(237, 237, 237)#EDEDED
    grey93grey93rgb(237, 237, 237)#EDEDED
    gray92gray92rgb(235, 235, 235)#EBEBEB
    grey92grey92rgb(235, 235, 235)#EBEBEB
    gray91gray91rgb(232, 232, 232)#E8E8E8
    grey91grey91rgb(232, 232, 232)#E8E8E8
    gray90gray90rgb(229, 229, 229)#E5E5E5
    grey90grey90rgb(229, 229, 229)#E5E5E5
    gray89gray89rgb(227, 227, 227)#E3E3E3
    grey89grey89rgb(227, 227, 227)#E3E3E3
    gray88gray88rgb(224, 224, 224)#E0E0E0
    grey88grey88rgb(224, 224, 224)#E0E0E0
    gray87gray87rgb(222, 222, 222)#DEDEDE
    grey87grey87rgb(222, 222, 222)#DEDEDE
    gainsborogainsbororgb(220, 220, 220)#DCDCDC
    gray86gray86rgb(219, 219, 219)#DBDBDB
    grey86grey86rgb(219, 219, 219)#DBDBDB
    gray85gray85rgb(217, 217, 217)#D9D9D9
    grey85grey85rgb(217, 217, 217)#D9D9D9
    gray84gray84rgb(214, 214, 214)#D6D6D6
    grey84grey84rgb(214, 214, 214)#D6D6D6
    gray83gray83rgb(212, 212, 212)#D4D4D4
    grey83grey83rgb(212, 212, 212)#D4D4D4
    LightGrayLightGrayrgb(211, 211, 211)#D3D3D3
    LightGreyLightGreyrgb(211, 211, 211)#D3D3D3
    gray82gray82rgb(209, 209, 209)#D1D1D1
    grey82grey82rgb(209, 209, 209)#D1D1D1
    gray81gray81rgb(207, 207, 207)#CFCFCF
    grey81grey81rgb(207, 207, 207)#CFCFCF
    gray80gray80rgb(204, 204, 204)#CCCCCC
    grey80grey80rgb(204, 204, 204)#CCCCCC
    gray79gray79rgb(201, 201, 201)#C9C9C9
    grey79grey79rgb(201, 201, 201)#C9C9C9
    gray78gray78rgb(199, 199, 199)#C7C7C7
    grey78grey78rgb(199, 199, 199)#C7C7C7
    gray77gray77rgb(196, 196, 196)#C4C4C4
    grey77grey77rgb(196, 196, 196)#C4C4C4
    gray76gray76rgb(194, 194, 194)#C2C2C2
    grey76grey76rgb(194, 194, 194)#C2C2C2
    silversilverrgb(192, 192, 192)#C0C0C0
    gray75gray75rgb(191, 191, 191)#BFBFBF
    grey75grey75rgb(191, 191, 191)#BFBFBF
    gray74gray74rgb(189, 189, 189)#BDBDBD
    grey74grey74rgb(189, 189, 189)#BDBDBD
    gray73gray73rgb(186, 186, 186)#BABABA
    grey73grey73rgb(186, 186, 186)#BABABA
    gray72gray72rgb(184, 184, 184)#B8B8B8
    grey72grey72rgb(184, 184, 184)#B8B8B8
    gray71gray71rgb(181, 181, 181)#B5B5B5
    grey71grey71rgb(181, 181, 181)#B5B5B5
    gray70gray70rgb(179, 179, 179)#B3B3B3
    grey70grey70rgb(179, 179, 179)#B3B3B3
    gray69gray69rgb(176, 176, 176)#B0B0B0
    grey69grey69rgb(176, 176, 176)#B0B0B0
    gray68gray68rgb(173, 173, 173)#ADADAD
    grey68grey68rgb(173, 173, 173)#ADADAD
    gray67gray67rgb(171, 171, 171)#ABABAB
    grey67grey67rgb(171, 171, 171)#ABABAB
    DarkGrayDarkGrayrgb(169, 169, 169)#A9A9A9
    DarkGreyDarkGreyrgb(169, 169, 169)#A9A9A9
    gray66gray66rgb(168, 168, 168)#A8A8A8
    grey66grey66rgb(168, 168, 168)#A8A8A8
    gray65gray65rgb(166, 166, 166)#A6A6A6
    grey65grey65rgb(166, 166, 166)#A6A6A6
    gray64gray64rgb(163, 163, 163)#A3A3A3
    grey64grey64rgb(163, 163, 163)#A3A3A3
    gray63gray63rgb(161, 161, 161)#A1A1A1
    grey63grey63rgb(161, 161, 161)#A1A1A1
    gray62gray62rgb(158, 158, 158)#9E9E9E
    grey62grey62rgb(158, 158, 158)#9E9E9E
    gray61gray61rgb(156, 156, 156)#9C9C9C
    grey61grey61rgb(156, 156, 156)#9C9C9C
    gray60gray60rgb(153, 153, 153)#999999
    grey60grey60rgb(153, 153, 153)#999999
    gray59gray59rgb(150, 150, 150)#969696
    grey59grey59rgb(150, 150, 150)#969696
    gray58gray58rgb(148, 148, 148)#949494
    grey58grey58rgb(148, 148, 148)#949494
    gray57gray57rgb(145, 145, 145)#919191
    grey57grey57rgb(145, 145, 145)#919191
    gray56gray56rgb(143, 143, 143)#8F8F8F
    grey56grey56rgb(143, 143, 143)#8F8F8F
    gray55gray55rgb(140, 140, 140)#8C8C8C
    grey55grey55rgb(140, 140, 140)#8C8C8C
    gray54gray54rgb(138, 138, 138)#8A8A8A
    grey54grey54rgb(138, 138, 138)#8A8A8A
    gray53gray53rgb(135, 135, 135)#878787
    grey53grey53rgb(135, 135, 135)#878787
    gray52gray52rgb(133, 133, 133)#858585
    grey52grey52rgb(133, 133, 133)#858585
    gray51gray51rgb(130, 130, 130)#828282
    grey51grey51rgb(130, 130, 130)#828282
    fractalfractalrgb(128, 128, 128)#808080
    gray50gray50rgb(127, 127, 127)#7F7F7F
    grey50grey50rgb(127, 127, 127)#7F7F7F
    graygrayrgb(126, 126, 126)#7E7E7E
    gray49gray49rgb(125, 125, 125)#7D7D7D
    grey49grey49rgb(125, 125, 125)#7D7D7D
    gray48gray48rgb(122, 122, 122)#7A7A7A
    grey48grey48rgb(122, 122, 122)#7A7A7A
    gray47gray47rgb(120, 120, 120)#787878
    grey47grey47rgb(120, 120, 120)#787878
    gray46gray46rgb(117, 117, 117)#757575
    grey46grey46rgb(117, 117, 117)#757575
    gray45gray45rgb(115, 115, 115)#737373
    grey45grey45rgb(115, 115, 115)#737373
    gray44gray44rgb(112, 112, 112)#707070
    grey44grey44rgb(112, 112, 112)#707070
    gray43gray43rgb(110, 110, 110)#6E6E6E
    grey43grey43rgb(110, 110, 110)#6E6E6E
    gray42gray42rgb(107, 107, 107)#6B6B6B
    grey42grey42rgb(107, 107, 107)#6B6B6B
    DimGrayDimGrayrgb(105, 105, 105)#696969
    DimGreyDimGreyrgb(105, 105, 105)#696969
    gray41gray41rgb(105, 105, 105)#696969
    grey41grey41rgb(105, 105, 105)#696969
    gray40gray40rgb(102, 102, 102)#666666
    grey40grey40rgb(102, 102, 102)#666666
    gray39gray39rgb( 99, 99, 99)#636363
    grey39grey39rgb( 99, 99, 99)#636363
    gray38gray38rgb( 97, 97, 97)#616161
    grey38grey38rgb( 97, 97, 97)#616161
    gray37gray37rgb( 94, 94, 94)#5E5E5E
    grey37grey37rgb( 94, 94, 94)#5E5E5E
    gray36gray36rgb( 92, 92, 92)#5C5C5C
    grey36grey36rgb( 92, 92, 92)#5C5C5C
    gray35gray35rgb( 89, 89, 89)#595959
    grey35grey35rgb( 89, 89, 89)#595959
    gray34gray34rgb( 87, 87, 87)#575757
    grey34grey34rgb( 87, 87, 87)#575757
    gray33gray33rgb( 84, 84, 84)#545454
    grey33grey33rgb( 84, 84, 84)#545454
    gray32gray32rgb( 82, 82, 82)#525252
    grey32grey32rgb( 82, 82, 82)#525252
    gray31gray31rgb( 79, 79, 79)#4F4F4F
    grey31grey31rgb( 79, 79, 79)#4F4F4F
    gray30gray30rgb( 77, 77, 77)#4D4D4D
    grey30grey30rgb( 77, 77, 77)#4D4D4D
    gray29gray29rgb( 74, 74, 74)#4A4A4A
    grey29grey29rgb( 74, 74, 74)#4A4A4A
    gray28gray28rgb( 71, 71, 71)#474747
    grey28grey28rgb( 71, 71, 71)#474747
    gray27gray27rgb( 69, 69, 69)#454545
    grey27grey27rgb( 69, 69, 69)#454545
    gray26gray26rgb( 66, 66, 66)#424242
    grey26grey26rgb( 66, 66, 66)#424242
    gray25gray25rgb( 64, 64, 64)#404040
    grey25grey25rgb( 64, 64, 64)#404040
    gray24gray24rgb( 61, 61, 61)#3D3D3D
    grey24grey24rgb( 61, 61, 61)#3D3D3D
    gray23gray23rgb( 59, 59, 59)#3B3B3B
    grey23grey23rgb( 59, 59, 59)#3B3B3B
    gray22gray22rgb( 56, 56, 56)#383838
    grey22grey22rgb( 56, 56, 56)#383838
    gray21gray21rgb( 54, 54, 54)#363636
    grey21grey21rgb( 54, 54, 54)#363636
    gray20gray20rgb( 51, 51, 51)#333333
    grey20grey20rgb( 51, 51, 51)#333333
    gray19gray19rgb( 48, 48, 48)#303030
    grey19grey19rgb( 48, 48, 48)#303030
    gray18gray18rgb( 46, 46, 46)#2E2E2E
    grey18grey18rgb( 46, 46, 46)#2E2E2E
    gray17gray17rgb( 43, 43, 43)#2B2B2B
    grey17grey17rgb( 43, 43, 43)#2B2B2B
    gray16gray16rgb( 41, 41, 41)#292929
    grey16grey16rgb( 41, 41, 41)#292929
    gray15gray15rgb( 38, 38, 38)#262626
    grey15grey15rgb( 38, 38, 38)#262626
    gray14gray14rgb( 36, 36, 36)#242424
    grey14grey14rgb( 36, 36, 36)#242424
    gray13gray13rgb( 33, 33, 33)#212121
    grey13grey13rgb( 33, 33, 33)#212121
    gray12gray12rgb( 31, 31, 31)#1F1F1F
    grey12grey12rgb( 31, 31, 31)#1F1F1F
    gray11gray11rgb( 28, 28, 28)#1C1C1C
    grey11grey11rgb( 28, 28, 28)#1C1C1C
    gray10gray10rgb( 26, 26, 26)#1A1A1A
    grey10grey10rgb( 26, 26, 26)#1A1A1A
    gray9gray9rgb( 23, 23, 23)#171717
    grey9grey9rgb( 23, 23, 23)#171717
    gray8gray8rgb( 20, 20, 20)#141414
    grey8grey8rgb( 20, 20, 20)#141414
    gray7gray7rgb( 18, 18, 18)#121212
    grey7grey7rgb( 18, 18, 18)#121212
    gray6gray6rgb( 15, 15, 15)#0F0F0F
    grey6grey6rgb( 15, 15, 15)#0F0F0F
    gray5gray5rgb( 13, 13, 13)#0D0D0D
    grey5grey5rgb( 13, 13, 13)#0D0D0D
    gray4gray4rgb( 10, 10, 10)#0A0A0A
    grey4grey4rgb( 10, 10, 10)#0A0A0A
    gray3gray3rgb( 8, 8, 8)#080808
    grey3grey3rgb( 8, 8, 8)#080808
    gray2gray2rgb( 5, 5, 5)#050505
    grey2grey2rgb( 5, 5, 5)#050505
    gray1gray1rgb( 3, 3, 3)#030303
    grey1grey1rgb( 3, 3, 3)#030303
    blackblackrgb( 0, 0, 0)#000000
    gray0gray0rgb( 0, 0, 0)#000000
    grey0grey0rgb( 0, 0, 0)#000000
    opaqueopaquergb( 0, 0, 0)#000000
    nonenonergba( 0, 0, 0, 0.0)#00000000
    transparenttransparentrgba( 0, 0, 0, 0.0)#00000000
    @@ -242,4 +4954,4 @@ MagickBooleanType QueryColorname(const Image *image, - \ No newline at end of file + \ No newline at end of file diff --git a/www/command-line-options.html b/www/command-line-options.html index 6547a8feb..ebbdca17a 100644 --- a/www/command-line-options.html +++ b/www/command-line-options.html @@ -5,34 +5,34 @@ - - + + Command-line Options @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    -
    +

    ‑adaptive‑blur • ‑adaptive‑resize • ‑adaptive‑sharpen • ‑adjoin • ‑affine • ‑alpha • ‑annotate • ‑antialias • ‑append • ‑attenuate • ‑authenticate • ‑auto‑gamma • ‑auto‑level • ‑auto‑orient • ‑auto‑threshold • ‑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 • ‑channel‑fx • ‑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 • ‑copy • ‑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] • ‑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 • ‑read‑mask • ‑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 • ‑wavelet‑denoise • ‑weight • ‑white‑point • ‑white‑threshold • ‑window • ‑window‑group • ‑write • ‑write‑mask

    -

    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.

    +

    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.

    -adaptive-blur radius[xsigma]

    @@ -99,7 +99,7 @@ defaults to 1.

    Resize the image using data-dependent triangulation.

    -

    See Image Geometry for complete details about the geometry argument. The -adaptive-resize +

    See Image Geometry for complete details about the geometry argument. The -adaptive-resize option defaults to data-dependent triangulation. Use the -filter to choose a different resampling algorithm. Offsets, if present in the geometry string, are ignored, and the

    See the discussion on HDRI implementations of ImageMagick on the page High Dynamic-Range Images. For more +href="high-dynamic-range.html" >High Dynamic-Range Images. For more about HDRI go the ImageMagick Usage pages or this +href="../Usage/basics/#hdri" >Usage pages or this Wikipedia entry.

    @@ -659,7 +659,7 @@ pixels which are outside the image proper are blurred into the final result.

    Surround the image with a border of color.

    Set the width and height using the size portion of the -geometry argument. See Image Geometry for complete details about the geometry argument. Offsets are +geometry argument. See Image Geometry for complete details about the geometry argument. Offsets are ignored.

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

    @@ -999,7 +999,7 @@ href="command-line-options.html#clut">-clut operator is a good example of th

    Remove pixels from the interior of an image.

    -

    See Image Geometry for complete details about the geometry argument. The width +

    See Image Geometry for complete details about the geometry argument. The width and height given in the of the size portion of the geometry argument give the number of columns and rows to remove. The offset portion of @@ -1203,7 +1203,7 @@ duplicate or unused colors removed. The ordering of an existing color palette may be altered. When converting an image from color to grayscale, it is more efficient to convert the image to the gray colorspace before reducing the number of colors. Refer to -the +the color reduction algorithm for more details.

    @@ -1449,7 +1449,7 @@ subtract

    Set the type of image composition.

    -

    See Alpha Compositing for +

    See Alpha Compositing for a detailed discussion of alpha compositing.

    This setting affects image processing operators that merge two (or more) @@ -1544,7 +1544,7 @@ the chroma channels.

    -connected-components connectivity

    -

    connected-components labeling detects connected regions in an image, choose from 4 or 8 way connectivity.

    +

    connected-components labeling detects connected regions in an image, choose from 4 or 8 way connectivity.

    Use -define connected-components:verbose=true to output statistics associated with each unique label.

    @@ -1621,9 +1621,9 @@ detection. Without an output bias, the negative values is clipped at zero.

    When using an ImageMagick with the HDRI compile-time setting, ‑bias is not needed, as ImageMagick is able to store/handle any negative results without clipping to the color value range (0..QuantumRange). See the discussion on HDRI implementations of ImageMagick on the page High +href="high-dynamic-range.html">High Dynamic-Range Images. For more about HDRI go the ImageMagick Usage pages or this +href="../Usage/basics/#hdri">Usage pages or this Wikipedia entry.

    @@ -1640,7 +1640,7 @@ entry.

    Cut out one or more rectangular regions of the image.

    -

    See Image Geometry for complete details about the geometry argument.

    +

    See Image Geometry for complete details about the geometry argument.

    The width and height of the geometry argument give the size of the image that remains after cropping, and x and y in the @@ -1728,7 +1728,7 @@ output.

    Use +debug to turn off all logging.

    -

    Debugging may also be set using the MAGICK_DEBUG Debugging may also be set using the MAGICK_DEBUG environment variable. The allowed values for the MAGICK_DEBUG environment variable are the same as for the -debug option.

    @@ -3323,7 +3323,7 @@ filename:

    You can use 0,0 for the image size, which means to use the actual dimensions found in the image header. Otherwise, it is scaled to the given -dimensions. See Alpha Compositing for +dimensions. See Alpha Compositing for a detailed discussion of alpha composition methods that are available.

    The "special augmented compose operators" such as "dissolve" that require @@ -3670,7 +3670,7 @@ image is centered on an 800x600 black canvas:

    -gravity center -extent 800x600 -quality 92 output.jpg -

    See Image Geometry for complete details about the geometry argument.

    +

    See Image Geometry for complete details about the geometry argument.

    -extract geometry

    @@ -3699,7 +3699,7 @@ equivalent to:

    convert -size 16000x16000 -depth 8 -resize 640x480 image.rgb image.png
     
    -

    See Image Geometry for complete details about the geometry argument.

    +

    See Image Geometry for complete details about the geometry argument.

    -family fontFamily

    @@ -3828,9 +3828,9 @@ padding that was discussed above for the magnitude and phase component images.

    See the discussion on HDRI implementations of ImageMagick on the page High Dynamic-Range Images. For more +href="high-dynamic-range.html" >High Dynamic-Range Images. For more about HDRI go the ImageMagick Usage pages, Usage pages, Fred's Fourier Processing With ImageMagick page or this Wikipedia @@ -3846,7 +3846,7 @@ href="http://www.fmwconcepts.com/imagemagick/fourier_transforms/fourier.html"

    color to use when filling a graphic primitive.

    This option accepts a color name, a hex color, or a numerical RGB, RGBA, -HSL, HSLA, CMYK, or CMYKA specification. See Color Names for +HSL, HSLA, CMYK, or CMYKA specification. See Color Names for a description of how to properly specify the color argument.

    Enclose the color specification in quotation marks to prevent the "#" or @@ -4149,7 +4149,7 @@ href="command-line-options.html#fill">-fill option.

    the image format type.

    When used with the mogrify utility, this option converts any -image to the image format you specify. +image to the image format you specify. For a list of image format types supported by ImageMagick, use -list format.

    @@ -4179,7 +4179,7 @@ option.

    The color of the border is specified with the -mattecolor command line option.

    -

    See Image Geometry for complete details about the geometry argument. The size portion of the geometry argument indicates the amount of extra width and +

    See Image Geometry for complete details about the geometry argument. The size portion of the geometry argument indicates the amount of extra width and height that is added to the dimensions of the image. If no offsets are given in the geometry argument, then the border added is a solid color. Offsets x and y, if present, specify that @@ -4397,7 +4397,7 @@ appending % as a percentage of the maximum possible intensity (255, the expression is read from a file titled by the remaining characters in the string.

    -

    See FX, +

    See FX, The Special Effects Image Operator for a detailed discussion of this option.

    @@ -4476,7 +4476,7 @@ pixels which are outside the image proper are blurred into the final result.

    Set the preferred size and location of the image.

    -

    See Image Geometry for complete details about the geometry argument.

    +

    See Image Geometry for complete details about the geometry argument.

    -gravity type

    @@ -4515,17 +4515,17 @@ is (−40,+20). The argument to -gra (100−40,50+20)=(60,70), so the specified 10x10 region is located at that point. (In addition, the -gravity affects the region itself, which is centered at the pixel -coordinate (60,70). (See Image Geometry for complete details about the geometry argument.)

    +coordinate (60,70). (See Image Geometry for complete details about the geometry argument.)

    convert image.png -gravity Center -region 10x10-40+20 \
       -negate output.png
     
    -

    When used as an option to composite, When used as an option to composite, -gravity gives the direction that the image gravitates within the composite.

    -

    When used as an option to montage, When used as an option to montage, -gravity gives the direction that an image gravitates within a tile. The default gravity is Center for this purpose.

    @@ -4650,7 +4650,7 @@ mapping.

    manner as the -geometry option, using X11 style to handle negative offsets.

    -

    See Image Geometry for complete details about the geometry argument.

    +

    See Image Geometry for complete details about the geometry argument.

    -iconic

    @@ -4671,7 +4671,7 @@ a description of the image class.

    If -colors is also specified, the total unique colors in the image and color reduction error values are printed. Refer to color +href="../www/quantize.html">color reduction algorithm for a description of these values.

    If -verbose precedes this option, copious @@ -5429,7 +5429,7 @@ limit as well:

    Here ImageMagick stops processing if an image requires more than 500MB of disk storage.

    In addition to command-line resource limit option, resources can be set -with environment variables. Set the +with environment variables. Set the environment variables MAGICK_AREA_LIMIT, MAGICK_DISK_LIMIT, MAGICK_FILE_LIMIT, MAGICK_MEMORY_LIMIT, MAGICK_MAP_LIMIT, @@ -5445,7 +5445,7 @@ through grep memory|open|destroy|disk for more readable sifting.

    For more about ImageMagick's use of resources, see the section Cache -Storage and Resource Requirements on the Architecture page.

    @@ -5485,7 +5485,7 @@ normalization of mathematical images.

    rescale image with seam-carving.

    -

    See Image Geometry for complete details about the geometry argument.

    +

    See Image Geometry for complete details about the geometry argument.

    -list type

    @@ -6053,7 +6053,7 @@ white, and mid-tone colors into a checkerboard pattern of black and white.

    You can define your own threshold map for ordered dithering and halftoning your images, in either personal or system -thresholds.xml XML file. See Resources +thresholds.xml XML file. See Resources for more details of configuration files.

    To print a complete list of the thresholds that have been defined, use the @@ -6097,7 +6097,7 @@ orientation option.

    Set the size and location of an image on the larger virtual canvas.

    -

    See Image Geometry for complete details about the geometry argument.

    +

    See Image Geometry for complete details about the geometry argument.

    For convenience you can specify the page size using media (see below). Offsets can then be added as with other geometry arguments (e.g.

    The x and y offsets are treated in the same manner as in -crop.

    -

    See Image Geometry for complete details about the geometry argument.

    +

    See Image Geometry for complete details about the geometry argument.

    Use +region to remove any previously set regions.

    @@ -6611,7 +6611,7 @@ This useful when saving the result to vector formats such as MVG or SVG.

    rather than a setting. You can separately set the canvas size or the offset of the image on that canvas by only providing those components.

    -

    See Image Geometry for complete details about the geometry argument.

    +

    See Image Geometry for complete details about the geometry argument.

    If a ! flag is given the offset given is added to the existing offset to move the image relative to its previous position. This useful for @@ -6655,7 +6655,7 @@ resolution specified in the standard file header.

    Resize an image.

    -

    See Image Geometry for complete details about the geometry argument. Offsets, if present in the geometry string, are +

    See Image Geometry for complete details about the geometry argument. Offsets, if present in the geometry string, are ignored, and the -gravity option has no effect.

    If the -filter option @@ -6735,7 +6735,7 @@ the current -filter setting.

    The key feature of the -sample is that no new colors will be added to the resulting image, though some colors may disappear.

    -

    See Image Geometry for complete details about the geometry argument. Offsets, if present in the geometry string, are +

    See Image Geometry for complete details about the geometry argument. Offsets, if present in the geometry string, are ignored, unlike -resize.

    @@ -7021,7 +7021,7 @@ argument specifies the width of the region to be removed from both sides of the image and the height of the regions to be removed from top and bottom. Offsets are ignored.

    -

    See Image Geometry for complete details about the geometry argument.

    +

    See Image Geometry for complete details about the geometry argument.

    -shear Xdegrees[xYdegrees]

    @@ -7231,7 +7231,7 @@ default value.

    This will add rows and columns of the current -background color into the given image according to the -given -gravity geometry setting. See Image Geometry for complete details about the geometry argument. Essentially -splice will divide the +given -gravity geometry setting. See Image Geometry for complete details about the geometry argument. Essentially -splice will divide the image into four quadrants, separating them by the inserted rows and columns.

    @@ -7523,7 +7523,7 @@ for speed and any image profile, other than a color profile, is removed to reduce the thumbnail size. To strip the color profiles as well, add -strip just before of after this option.

    -

    See Image Geometry for complete details about the geometry argument.

    +

    See Image Geometry for complete details about the geometry argument.

    -tile filename

    @@ -7537,7 +7537,7 @@ href="command-line-options.html#strip">-strip just before of after this opti

    Specify the layout of images.

    -

    See Image Geometry for complete details about the geometry argument.

    +

    See Image Geometry for complete details about the geometry argument.

    -tile

    @@ -7686,7 +7686,7 @@ the use of an optimal tree depth for the color reduction algorithm.

    image with the fastest computational speed and the least amount of memory. However, the default depth is inappropriate for some images. To assure the best representation, try values between 2 and 8 for this parameter. Refer to -the color reduction algorithm for more details.

    The -colors or -monochrome @@ -8028,13 +8028,13 @@ but with strict boolean masking.

    -

    Security • - Architecture • - Related • - Sitemap • +

    Security • + Architecture • + Related • + Sitemap • Public Key

    -

    Donate • +

    Donate • Back to top • Contact Us

    © 1999-2018 ImageMagick Studio LLC

    @@ -8045,4 +8045,4 @@ but with strict boolean masking.

    - \ No newline at end of file + \ No newline at end of file diff --git a/www/command-line-processing.html b/www/command-line-processing.html index daf08f63f..b906aae82 100644 --- a/www/command-line-processing.html +++ b/www/command-line-processing.html @@ -5,34 +5,34 @@ - - + + Command-line Processing @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    The Anatomy of the Command-line • Input Filename • Command-line Options • Output Filename

    @@ -144,9 +144,9 @@ convert, composite, montage, -compare, -import, -conjure). +compare, +import, +conjure). @@ -203,12 +203,12 @@ so we explicitly set one:

    STDIN, STDOUT, and file descriptors

    Unix and Windows permit the output of one command to be piped to the input of another. ImageMagick permits image data to be read and written from the standard streams STDIN (standard in) and STDOUT (standard out), respectively, using a pseudo-filename of -. In this example we pipe the output of - convert to the display program: + convert to the display program:

    magick logo: gif:- | display gif:-
    -

    The second explicit format "gif:" is optional in the preceding example. The GIF image format has a unique signature within the image so ImageMagick's display command can readily recognize the format as GIF. The convert program also accepts STDIN as input in this way: +

    The second explicit format "gif:" is optional in the preceding example. The GIF image format has a unique signature within the image so ImageMagick's display command can readily recognize the format as GIF. The convert program also accepts STDIN as input in this way:

    magick rose: gif:- | magick - -resize "200%" bigrose.jpg'
    @@ -253,7 +253,7 @@ In a Windows command shell the brackets are not interpreted but using quotes doe
    magick -size 6000x4000 -depth 8 'rgb:image[600x400+1900+2900]' image.jpg

    - You can get the same results with the ‑extract option: + You can get the same results with the ‑extract option:

    magick -size 6000x4000 -depth 8 -extract 600x400+1900+2900 rgb:image image.jpg
    @@ -302,7 +302,7 @@ frame003.jpg
    'my title.jpg'
    -

    Some ImageMagick command-line options may exceed the capabilities of +

    Some ImageMagick command-line options may exceed the capabilities of your command-line processor. Windows, for example, limits command-lines to 8192 characters. If, for example, you have a draw option with polygon points that exceed the command-line length limit, put the draw option instead @@ -331,7 +331,7 @@ image-5.jpg

    Command-line Options

    -

    You can direct the behavior of ImageMagick utilities with these command-line options. The behavior of an option falls into one of these categories:

    +

    You can direct the behavior of ImageMagick utilities with these command-line options. The behavior of an option falls into one of these categories:

    In this example, -channel applies to each of the images, since, as we mentioned, settings persist:

    @@ -361,7 +361,7 @@ is reset or the command-line terminates. The image settings include:

    An image operator differs from a setting in that it affects the image immediately as it appears on the command-line. An operator is -any command-line option not listed as a +any command-line option not listed as a image setting or image sequence operator. Unlike an image setting, which persists until the command-line terminates, @@ -369,7 +369,7 @@ an operator is applied to an image and forgotten. The image operators include:

    +‑annotate • ‑black‑threshold • ‑blur • ‑border • ‑charcoal • ‑chop • ‑clip • ‑clip‑path • ‑clip‑mask • ‑colors • ‑colorize • ‑colorspace • ‑compose • ‑contrast • ‑convolve • ‑crop • ‑cycle • ‑despeckle • ‑draw • ‑edge • ‑emboss • ‑enhance • ‑equalize • ‑evaluate • ‑extent • ‑flip • ‑flop • ‑floodfill • ‑frame • ‑gamma • ‑gaussian‑blur • ‑grayscale • ‑implode • ‑lat • ‑level • ‑map • ‑median • ‑modulate • ‑monochrome • ‑negate • ‑noise • ‑normalize • ‑opaque • ‑ordered‑dither • ‑paint • ‑posterize • ‑raise • ‑profile • ‑radial‑blur • ‑raise • ‑random‑threshold • ‑resample • ‑resize • ‑roll • ‑rotate • ‑sample • ‑scale • ‑sepia‑tone • ‑segment • ‑shade • ‑shadow • ‑sharpen • ‑shave • ‑shear • ‑sigmoidal‑contrast • ‑solarize • ‑splice • ‑spread • ‑strip • ‑swirl • ‑threshold • ‑transparent • ‑thumbnail • ‑tint • ‑transform • ‑trim • ‑unsharp • ‑version • ‑wave • ‑white‑point • ‑white‑threshold

    In this example, -negate negates the wand image but not the wizard:

    @@ -378,7 +378,7 @@ include:

    Image Channel Operator

    Operate directly on image channels:

    +‑channel‑fx • ‑separate

    Image Sequence Operator

    @@ -387,14 +387,14 @@ image sequence immediately as it appears on the command-line. Choose from these image sequence operators:

    +‑append • ‑affinity • ‑average • ‑clut • ‑coalesce • ‑combine • ‑compare • ‑complex • ‑composite • ‑copy • ‑crop • ‑debug • ‑deconstruct • ‑delete • ‑evaluate‑sequence • ‑fft • ‑flatten • ‑fx • ‑hald‑clut • ‑ift • ‑identify • ‑insert • ‑layers • ‑limit • ‑map • ‑maximum • ‑minimum • ‑morph • ‑mosaic • ‑optimize • ‑print • ‑process • ‑quiet • ‑swap • ‑write

    In this example, -append appends three images into one:

    magick mikayla.png picnic.png beach.png -append vacation.png

    Image Geometry

    -

    Many command-line options take a geometry argument +

    Many command-line options take a geometry argument to specify such things as the desired width and height of an image and other dimensional quantities. Because users want so many variations on the resulting dimensions, sizes, and positions of images (and because ImageMagick wants to @@ -408,7 +408,7 @@ different ways. See the documentation for the individual option or setting for more specifics.

    +‑adaptive‑resize • ‑border • ‑borderwidth • ‑chop • ‑crop • ‑density • ‑extent • ‑extract • ‑frame • ‑geometry • ‑iconGeometry • ‑liquid‑rescale • ‑page • ‑region • ‑repage • ‑resize • ‑sample • ‑scale • ‑shave • ‑splice • ‑thumbnail • ‑window

    The geometry argument might take any of the forms listed in the table below. These will described in more detail in the subsections following the table. The usual form is size[offset], meaning size is required and offset is optional. Occasionally, [size]offset is possible. In no cases are spaces permitted within the geometry argument.

    @@ -469,14 +469,14 @@ setting for more specifics.

    {size}{+-}x{+-}y - Horizontal and vertical offsets x and y, specified in pixels. Signs are required for both. Offsets are affected by ‑gravity setting. Offsets are not affected by % or other size operators. + Horizontal and vertical offsets x and y, specified in pixels. Signs are required for both. Offsets are affected by ‑gravity setting. Offsets are not affected by % or other size operators.

    Basic adjustments to width and height; the operators %, ^, and !

    -

    Here, just below, are a few simple examples of geometry, showing how it might be used as an argument to the ‑resize option. We'll use the internal image logo: for our input image. +

    Here, just below, are a few simple examples of geometry, showing how it might be used as an argument to the ‑resize option. We'll use the internal image logo: for our input image. This fine image is 640 pixels wide and 480 pixels high. We say its dimensions are 640x480. When we give dimensions of an image, the width (the horizontal dimension) always precedes the height (the vertical dimension). This will be true when we speak of coordinates or offsets into an image, which will always be x–value followed by y. Just think of your high school algebra classes and the xy–plane. (Well, almost: our y–axis will always go downward!)

    @@ -521,7 +521,7 @@ magick logo: -resize '100x200<' wiz4.png

    Offsets in geometry

    Here are some examples to illustrate the use of offsets in geometry arguments. One typical use of offsets is in conjunction with the -‑region option. This option allows many other options to modify the pixels within a specified rectangular subregion of an image. As such, it needs to be given the width and height of that region, and also an offset into the image, which is a pair of coordinates that indicate the location of the region within the larger image. Below, in the first example, we specify a region of size 100x200 to be located at the xy–coordinates x=10, y=20. Let's use the usual algebraic notation (x,y)=(10,20), for convenience. +‑region option. This option allows many other options to modify the pixels within a specified rectangular subregion of an image. As such, it needs to be given the width and height of that region, and also an offset into the image, which is a pair of coordinates that indicate the location of the region within the larger image. Below, in the first example, we specify a region of size 100x200 to be located at the xy–coordinates x=10, y=20. Let's use the usual algebraic notation (x,y)=(10,20), for convenience.

    magick logo: -region '100x200+10+20' -negate wizNeg1.png
    @@ -532,7 +532,7 @@ magick logo: -gravity center -region '100x200-10+20' -negate wizNeg3.png<
     
     

    A negative offset can make sense in many cases. In the second example above, the offset is (-10,20), specified by -10+20. In that case, only the portion of the (virtual) rectangle obtained that lies within the image can be negated; here it is equivalent to specifying the geometry as 90x200+0+20.

    -

    In the third example above, the ‑gravity setting precedes the others and sets the current location within the image at the very center of the image. In this case that is at pixel (320,240), since the size of the image is 640x480. This means that the offsets apply to that location, which thereby gets moved, in this case, to (320-10,240+20)=(310,260). But the 100x200 region itself is affected by the ‑gravity setting, so instead of affecting its upper-left corner, the region's own center (at (+50,+100) within it) is determined. Therefore the center of the 100x200 rectangle is moved to (310,260). The negated rectangle's upper-left corner is now at (310-50,260-100)=(260,160). +

    In the third example above, the ‑gravity setting precedes the others and sets the current location within the image at the very center of the image. In this case that is at pixel (320,240), since the size of the image is 640x480. This means that the offsets apply to that location, which thereby gets moved, in this case, to (320-10,240+20)=(310,260). But the 100x200 region itself is affected by the ‑gravity setting, so instead of affecting its upper-left corner, the region's own center (at (+50,+100) within it) is determined. Therefore the center of the 100x200 rectangle is moved to (310,260). The negated rectangle's upper-left corner is now at (310-50,260-100)=(260,160).

    @@ -554,7 +554,7 @@ above.

    In addition to the image operators already discussed, the following image operators are most useful when processing images in an image stack:

    +‑clone • ‑delete • ‑insert • ‑swap

    The arguments to these operators are indexes into the image sequence by number, starting with zero, for the first image, and so on. However if you give a negative index, the images are indexed from the end (last image added). That is, an index of -1 is the last image in the current image sequence, -2 gives the second-to-last, and so on.

    @@ -578,7 +578,7 @@ above.

    Standard Out

    -

    Unix permits the output of one command to be piped to another. ImageMagick permits piping one command to another with a filename of -. In this example we pipe the output of convert to the display program: +

    Unix permits the output of one command to be piped to another. ImageMagick permits piping one command to another with a filename of -. In this example we pipe the output of convert to the display program:

    magick logo: gif:- | display gif:-
    @@ -633,4 +633,4 @@ image-2.jpg
    - \ No newline at end of file + \ No newline at end of file diff --git a/www/command-line-tools.html b/www/command-line-tools.html index 5d6263966..dd311f7eb 100644 --- a/www/command-line-tools.html +++ b/www/command-line-tools.html @@ -5,34 +5,34 @@ - - + + Command-line Tools @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +
    @@ -89,22 +89,22 @@

    Here is a short description for each command-line tool. Click on the program name to get details about the program usage and a list of command-line options that alters how the program behaves. If you are just getting acquainted with ImageMagick, start with the magick program. Be sure to peruse Anthony Thyssen's tutorial on how to use ImageMagick utilities to create, edit, compose, or convert images from the command-line.

    -
    magick
    convert between image formats as well as resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more.
    -
    magick-script
    use this scripting language interpreter to convert between image formats as well as resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more.
    +
    magick
    convert between image formats as well as resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more.
    +
    magick-script
    use this scripting language interpreter to convert between image formats as well as resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more.

    We also support tools for compatibility with ImageMagick version 6:

    -
    animate
    animate an image sequence on any X server.
    -
    compare
    mathematically and visually annotate the difference between an image and its reconstruction.
    +
    animate
    animate an image sequence on any X server.
    +
    compare
    mathematically and visually annotate the difference between an image and its reconstruction.
    composite
    overlap one image over another.
    -
    conjure
    interpret and execute scripts written in the Magick Scripting Language (MSL).
    +
    conjure
    interpret and execute scripts written in the Magick Scripting Language (MSL).
    convert
    convert between image formats as well as resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more.
    -
    display
    display an image or image sequence on any X server.
    +
    display
    display an image or image sequence on any X server.
    identify
    describe the format and characteristics of one or more image files.
    -
    import
    save any visible window on an X server and outputs it as an image file. You can capture a single window, the entire screen, or any rectangular portion of the screen.
    -
    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.
    +
    import
    save any visible window on an X server and outputs it as an image file. You can capture a single window, the entire screen, or any rectangular portion of the screen.
    +
    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.
    montage
    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.
    -
    stream
    a lightweight tool to stream one or more pixel components of the image or portion of the image to your choice of storage formats. It writes the pixel components as they are read from the input image a row at a time making stream desirable when working with large images or when you require raw pixel components.
    +
    stream
    a lightweight tool to stream one or more pixel components of the image or portion of the image to your choice of storage formats. It writes the pixel components as they are read from the input image a row at a time making stream desirable when working with large images or when you require raw pixel components.

    If these tools are not available on your computer, you can instead utilize them as a subcommand of the magick command. For example,

    magick identify -verbose myImage.png
    @@ -130,4 +130,4 @@ - \ No newline at end of file + \ No newline at end of file diff --git a/www/compare.html b/www/compare.html index f26ef09b2..ec262d24a 100644 --- a/www/compare.html +++ b/www/compare.html @@ -5,34 +5,34 @@ - - + + Command-line Tools: Compare @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    -
    +

    Example Usage • Option Summary

    -

    Use the compare program to mathematically and visually annotate the difference between an image and its reconstruction. See Command Line Processing for advice on how to structure your compare command or see below for example usages of the command.

    +

    Use the compare program to mathematically and visually annotate the difference between an image and its reconstruction. See Command Line Processing for advice on how to structure your compare command or see below for example usages of the command.

    Example Usage

    @@ -428,13 +428,13 @@ transparent, extract, background, or shape the alpha channel
    -

    Security • - Architecture • - Related • - Sitemap • +

    Security • + Architecture • + Related • + Sitemap • Public Key

    -

    Donate • +

    Donate • Back to top • Contact Us

    © 1999-2018 ImageMagick Studio LLC

    @@ -445,4 +445,4 @@ transparent, extract, background, or shape the alpha channel - \ No newline at end of file + \ No newline at end of file diff --git a/www/compose.html b/www/compose.html index ea8965442..6416334d5 100644 --- a/www/compose.html +++ b/www/compose.html @@ -5,34 +5,34 @@ - - + + Alpha Compositing @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    This page descibed the Image composition methods that is used to define how two images should be merged together in various image operations. For the Command Line API it is typically set using the -compose setting option.

    +href="../www/command-line-options.html#compose" >-compose setting option.

    The description of composition uses abstract terminology in order to allow @@ -209,13 +209,13 @@ For example the default compose method can be specified as just 'Over'.

    Many of these compose methods will clear the destination image which was not overlaid by the source image. This is to be expected as part of that specific composition methods defintion. You can disable this by setting the -special -define 'compose:outside-overlay' to a value of 'false' will turn off this behavior.

    On top of the above 12 Duff-Porter Alpha Composition methods, one special related method 'Copy' has been provided. This is equivalent to -using the 'Src' with the special Src' with the special -define option 'compose:outside-overlay' set to 'false', so as to only modify the overlaid area, without clearing the rest of the image outside the overlaid area.

    @@ -315,7 +315,7 @@ any values are weighted by the alpha channel of the input and output images. This 'Over' alpha blending is also applied to the lighting composition methods below.

    -

    The math composition is applied on an individual channel basis as defined by the -channel. This includes the alpha channel. This special usage allows you to perform true mathematics of the image channels, without alpha +

    The math composition is applied on an individual channel basis as defined by the -channel. This includes the alpha channel. This special usage allows you to perform true mathematics of the image channels, without alpha composition effects, becoming involved.

    The following lighting composition methods are also available.

    @@ -447,7 +447,7 @@ composition effects, becoming involved.

    change-mask Replace any destination pixel that is the similar to the source images pixel (as defined by the current -fuzz factor), with transparency. + href="../www/command-line-options.html#fuzz">-fuzz factor), with transparency. @@ -465,16 +465,16 @@ arguments, which are tabled below.

    In the "composite" command these composition methods are selected using special options with the arguments needed. They are usually, but not always, the same name as the composite 'method' they use, and replaces -the normal use of the -compose +the normal use of the -compose setting in the "composite" command. For example...

    composite ... -blend 50x50 ...
     
    -

    The "magick" command can accept these extra arguments to its -composite operator, using the special -define +

    The "magick" command can accept these extra arguments to its -composite operator, using the special -define attribute of 'compose:args'. This means you can now -make use of these special augmented -compose methods, those the argument and the method both need to be set separately. For example...

    @@ -496,7 +496,7 @@ with a brief summary of what they do. For more details see the equivalent dissolve Arguments: src_percent[xdst_percent] -
    Equivalent to "composite" -dissolve +
    Equivalent to "composite" -dissolve
    Dissolve the 'source' image by the percentage given before overlaying 'over' the 'destination' image. If src_percent is greater than 100, it starts dissolving the main image so it will @@ -511,7 +511,7 @@ with a brief summary of what they do. For more details see the equivalent Arguments: src_percent[xdst_percent]
    Equivalent to "composite" -blend + href="../www/command-line-options.html#blend">-blend
    Average the images together ('plus') according to the percentages given and each pixels transparency. If only a single percentage value is given it sets the weight of the composite or 'source' image, while @@ -530,7 +530,7 @@ with a brief summary of what they do. For more details see the equivalent
    A*Sc*Dc + B*Sc + C*Dc + D
    Can be used to generate a custom composition method that would otherwise need to be implemented using the slow -fx DIY image operator. + href="../www/command-line-options.html#fx">-fx DIY image operator. @@ -538,7 +538,7 @@ with a brief summary of what they do. For more details see the equivalent modulate Arguments: brightness[xsaturation] -
    Equivalent to "composite" -watermark +
    Equivalent to "composite" -watermark
    Take a grayscale image (with alpha mask) and modify the destination image's brightness according to watermark image's grayscale value and the brightness percentage. The destinations @@ -552,7 +552,7 @@ with a brief summary of what they do. For more details see the equivalent displace Arguments: X-scale[xY-scale][!][%] -
    Equivalent to "composite" -displace +
    Equivalent to "composite" -displace
    With this option, the 'overlay' image, and optionally the 'mask' image, is used as a relative displacement map, which is used to displace the lookup of what part of the destination image is seen at @@ -599,7 +599,7 @@ with a brief summary of what they do. For more details see the equivalent blur Arguments: Width[xHeight[+Angle][+Angle2]] -
    Equivalent to "composite" -blur +
    Equivalent to "composite" -blur
    A Variable Blur Mapping Composition method, where each pixel in the overlaid region is replaced with an Elliptical Weighted Average (EWA), with an ellipse (typically a circle) of the given sigma size, scaled @@ -624,7 +624,7 @@ with a brief summary of what they do. For more details see the equivalent

    To print a complete list of all the available compose operators, use -list compose.

    +href="../www/command-line-options.html#list">-list compose.

    @@ -637,7 +637,7 @@ href="command-line-options.html#list">-list compose.

    Donate • Back to top • - Contact Us

    + Contact Us

    © 1999-2018 ImageMagick Studio LLC

    @@ -646,3 +646,4 @@ href="command-line-options.html#list">-list compose.

    + \ No newline at end of file diff --git a/www/composite.html b/www/composite.html index 8c4f0a744..60d9a5290 100644 --- a/www/composite.html +++ b/www/composite.html @@ -5,34 +5,34 @@ - - - Command-line Tools: Composite @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + MagickCore, C API: Composite an Image @ ImageMagick + + + + + + + + + + + + + + + + + + + +
    -
    +
    -

    Example Usage • Option Summary

    +

    CompositeImageCommand

    -

    Use the composite program to overlap one image over another. See Command Line Processing for advice on how to structure your composite command or see below for example usages of the command.

    +

    CompositeImageCommand

    -

    Example Usage

    +

    CompositeImageCommand() reads one or more images and an optional mask and composites them into a new image.

    -

    We list a few examples of the composite command here to illustrate its usefulness and ease of use. To get started, lets overlay a smiley face over a rose:

    +

    The format of the CompositeImageCommand method is:

    -
    magick composite -gravity center smile.gif  rose: rose-over.png
    -
    +
    +MagickBooleanType CompositeImageCommand(ImageInfo *image_info,int argc,
    +  char **argv,char **metadata,ExceptionInfo *exception)
    +
    -
      - smile - over - rose - ==> - rose -
    +

    A description of each parameter follows:

    -

    You can create three-dimensional effect with the Atop:

    +
    +
    -
    magick convert -size 70x70 canvas:none -fill red -draw 'circle 35,35 10,30' red-circle.png
    -magick convert -size 70x70 canvas:none -draw 'circle 35,35 35,20' -negate \
    --channel A -gaussian-blur 0x8 white-highlight.png
    -magick composite -compose atop -geometry -13-17 white-highlight.png red-circle.png red-ball.png
    -
    +
    +
    +
    image_info
    +
    the image info.
    -
      - white highlight - atop - red circle - ==> - red ball -
    +
    +
    argc
    +
    the number of elements in the argument vector.
    -

    You can find additional examples of using composite in Examples of ImageMagick Usage. You can find out more about them and the mathematics by looking at SVG Alpha Compositing

    +
    +
    argv
    +
    A text array containing the command line arguments.
    -

    Option Summary

    +
    +
    metadata
    +
    any metadata is returned here.
    -

    The composite command recognizes these options. Click on an option to get more details about how that option works.

    +
    +
    exception
    +
    return any errors or warnings in this structure.
    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    OptionDescription
    -affine matrixaffine transform matrix
    -alphaon, activate, off, deactivate, set, opaque, copy", -transparent, extract, background, or shape the alpha channel
    -authenticate valuedecrypt image with this password
    -blend geometryblend images
    -blue-primary pointchromaticity blue primary point
    -border geometrysurround image with a border of color
    -bordercolor colorborder color
    -channel typeapply option to select image channels
    -colors valuepreferred number of colors in the image
    -colorspace typeset image colorspace
    -comment stringannotate image with comment
    -compose operatorset image composite operator
    -compress typeimage compression type
    -debug eventsdisplay copious debugging information
    -decipher filenameconvert cipher pixels to plain
    -define format:optiondefine one or more image format options
    -density geometryhorizontal and vertical density of the image
    -depth valueimage depth
    -displace geometryshift image pixels defined by a displacement map
    -dissolve valuedissolve the two images a given percent
    -dither methodapply error diffusion to image
    -encipher filenameconvert plain pixels to cipher pixels
    -encoding typetext encoding type
    -endian typeendianness (MSB or LSB) of the image
    -extract geometryextract area from image
    -filter typeuse this filter when resizing an image
    -font namerender text with this font
    -geometry geometrypreferred size or location of the image
    -gravity typehorizontal and vertical text placement
    -green-primary pointchromaticity green primary point
    -helpprint program options
    -identifyidentify the format and characteristics of the image
    -interlace typetype of image interlacing scheme
    -interpolate methodpixel color interpolation method
    -label stringassign a label to an image
    -level valueadjust the level of image contrast
    -limit type valuepixel cache resource limit
    -log formatformat of debugging information
    -monitormonitor progress
    -monochrometransform image to black and white
    -negatereplace each pixel with its complementary color
    -page geometrysize and location of an image canvas (setting)
    -pointsize valuefont point size
    -profile filenameadd, delete, or apply an image profile
    -quality valueJPEG/MIFF/PNG compression level
    -quantize colorspacereduce image colors in this colorspace
    -quietsuppress all warning messages
    -red-primary pointchromaticity red primary point
    -regard-warningspay attention to warning messages.
    -respect-parenthesessettings remain in effect until parenthesis boundary.
    -rotate degreesapply Paeth rotation to the image
    -sampling-factor geometryhorizontal and vertical sampling factor
    -scene valueimage scene number
    -seed valueseed a new sequence of pseudo-random numbers
    -set attribute valueset an image attribute
    -sharpen geometrysharpen the image
    -shave geometryshave pixels from the image edges
    -size geometrywidth and height of image
    -stegano offsethide watermark within an image
    -stereo geometrycombine two image to create a stereo anaglyph
    -stripstrip image of all profiles and comments
    -swap indexesswap two images in the image sequence
    -synchronizesynchronize image to storage device
    -taintmark the image as modified
    -thumbnail geometrycreate a thumbnail of the image
    -tilerepeat composite operation across and down image
    -transformaffine transform image
    -transparent-color colortransparent color
    -treedepth valuecolor tree depth
    -type typeimage type
    -units typethe units of image resolution
    -unsharp geometrysharpen the image
    -verboseprint detailed information about the image
    -versionprint version information
    -virtual-pixel methodaccess method for pixels outside the boundaries of the image
    -watermark geometrypercent brightness and saturation of a watermark
    -white-point pointchromaticity white point
    -white-threshold valueforce all pixels above the threshold into white
    -write filenamewrite images to this file
    +
    +
    @@ -549,4 +143,4 @@ transparent, extract, background, or shape the alpha channel - \ No newline at end of file + \ No newline at end of file diff --git a/www/conjure.html b/www/conjure.html index 0ee555e66..a2e208f74 100644 --- a/www/conjure.html +++ b/www/conjure.html @@ -5,34 +5,34 @@ - - + + Command-line Tools: Conjure @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    -
    +

    Example Usage • Option Summary • Magick Scripting Language (MSL)

    -

    The conjure program gives you the ability to perform custom image processing tasks from a script written in the Magick Scripting Language (MSL). MSL is XML-based and consists of action statements with attributes. Actions include reading an image, processing an image, getting attributes from an image, writing an image, and more. An attribute is a key/value pair that modifies the behavior of an action. See Command Line Processing for advice on how to structure your conjure command or see below for example usages of the command.

    +

    The conjure program gives you the ability to perform custom image processing tasks from a script written in the Magick Scripting Language (MSL). MSL is XML-based and consists of action statements with attributes. Actions include reading an image, processing an image, getting attributes from an image, writing an image, and more. An attribute is a key/value pair that modifies the behavior of an action. See Command Line Processing for advice on how to structure your conjure command or see below for example usages of the command.

    Example Usage

    @@ -1141,13 +1141,13 @@ fill="color name", channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray,
    -

    Security • - Architecture • - Related • - Sitemap • +

    Security • + Architecture • + Related • + Sitemap • Public Key

    -

    Donate • +

    Donate • Back to top • Contact Us

    © 1999-2018 ImageMagick Studio LLC

    @@ -1158,4 +1158,4 @@ fill="color name", channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, - \ No newline at end of file + \ No newline at end of file diff --git a/www/connected-components.html b/www/connected-components.html index 839314c8c..768875535 100644 --- a/www/connected-components.html +++ b/www/connected-components.html @@ -5,34 +5,34 @@ - - + + Connected Components Labeling @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    Connected-component labeling (alternatively connected-component analysis, blob extraction, region labeling, blob discovery, or region extraction) uniquely labels connected components in an image. The labeling process scans the image, pixel-by-pixel from top-left to bottom-right, in order to identify connected pixel regions, i.e. regions of adjacent pixels which share the same set of intensity values. For example, let's find the objects in this image:

    @@ -101,7 +101,7 @@ 4: 21x23+0+45 8.8,55.9 409 srgb(255,255,255) 1: 4x10+252+0 253.9,4.1 31 srgb(255,255,255)
    -

    Use -connected-components 8 to visit 8 neighbors rather than 4. By default, neighbor colors must be exact to be part of a unique object. Use the -fuzz option to include pixels as part of an object that are close in color.

    +

    Use -connected-components 8 to visit 8 neighbors rather than 4. By default, neighbor colors must be exact to be part of a unique object. Use the -fuzz option to include pixels as part of an object that are close in color.

    You might want to eliminate small objects by merging them with their larger neighbors. If so, use this command:

    magick objects.gif -define connected-components:area-threshold=410 -connected-components 4 \
       -auto-level objects.jpg
    @@ -140,4 +140,4 @@ - \ No newline at end of file + \ No newline at end of file diff --git a/www/contact.html b/www/contact.html index 84dfe9c57..fa522c7a9 100644 --- a/www/contact.html +++ b/www/contact.html @@ -5,34 +5,34 @@ - - + + Contact the Development Team @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +
    -

    Post here for any of the issues listed below. You can expect a response from our team if your issue is a sponsorship, license, security, or paid support issue. If you require a response for any other issue, post to the ImageMagick public forums. You can also post bug reports to the issues forum. Note, we do not offer sponsored links nor do we respond to solicitations.

    +

    Post here for any of the issues listed below. You can expect a response from our team if your issue is a sponsorship, license, security, or paid support issue. If you require a response for any other issue, post to the ImageMagick public forums. You can also post bug reports to the issues forum. Note, we do not offer sponsored links nor do we respond to solicitations.

    Contact the Wizards

    Enter this code, diff --git a/www/convert.html b/www/convert.html index 49965d743..9dfad9a39 100644 --- a/www/convert.html +++ b/www/convert.html @@ -5,34 +5,34 @@ - - + + Command-line Tools: Convert @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +

    -
    +

    Use the convert program to convert between image formats as well as resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more. See Command Line Processing for advice on how to structure your convert command or see below for example usages of the command.

    @@ -130,1198 +130,1198 @@
    - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + @@ -1348,4 +1348,4 @@ transparent, extract, background, or shape the alpha channel - \ No newline at end of file + \ No newline at end of file diff --git a/www/develop.html b/www/develop.html index 460f435a5..64fa1b7ca 100644 --- a/www/develop.html +++ b/www/develop.html @@ -5,34 +5,34 @@ - - + + Develop @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +
    @@ -91,7 +91,7 @@
    C
    -
    Use MagickWand to convert, compose, and edit images from the C language. There is also the low-level MagickCore library for wizard-level developers.
    +
    Use MagickWand to convert, compose, and edit images from the C language. There is also the low-level MagickCore library for wizard-level developers.
    Ch
    @@ -99,11 +99,11 @@
    COM+
    -
    Use ImageMagickObject to convert, compose, and edit images from a Windows COM+ compatible component.
    +
    Use ImageMagickObject to convert, compose, and edit images from a Windows COM+ compatible component.
    C++
    -
    Magick++ provides an object-oriented C++ interface to ImageMagick. See A Gentle Introduction to Magick++ for an introductory tutorial to Magick++. We include the source if you want to correct, enhance, or expand the tutorial.
    +
    Magick++ provides an object-oriented C++ interface to ImageMagick. See A Gentle Introduction to Magick++ for an introductory tutorial to Magick++. We include the source if you want to correct, enhance, or expand the tutorial.
    GO
    GoImagick is a set of Go bindings to ImageMagick's MagickWand and MagickCore C APIs.
    @@ -147,7 +147,7 @@
    Perl
    -
    Use PerlMagick to convert, compose, and edit images from the Perl language.
    +
    Use PerlMagick to convert, compose, and edit images from the Perl language.
    PHP
    @@ -181,10 +181,10 @@
    Ruby
    -
    RMagick is an interface between the Ruby programming language and the MagickCore image processing libraries. Get started with RMagick by perusing the documentation.
    +
    RMagick is an interface between the Ruby programming language and the MagickCore image processing libraries. Get started with RMagick by perusing the documentation.
    -
    MagickWand for Ruby is an interface between the Ruby programming language and the MagickWand image processing libraries. Get started with MagickWand for PHP by perusing the documentation.
    +
    MagickWand for Ruby is an interface between the Ruby programming language and the MagickWand image processing libraries. Get started with MagickWand for PHP by perusing the documentation.
    MiniMagick is a Ruby wrapper for ImageMagick command line. MiniMagick gives you convenient access to all the command line options ImageMagick supports.
    @@ -225,4 +225,4 @@ - \ No newline at end of file + \ No newline at end of file diff --git a/www/display.html b/www/display.html index fdd103a5b..40c74bc42 100644 --- a/www/display.html +++ b/www/display.html @@ -5,34 +5,34 @@ - - - Command-line Tools: Display @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + MagickCore, C API: Interactively Display and Edit an Image @ ImageMagick + + + + + + + + + + + + + + + + + + + +
    -
    -
    +
    -

    Example Usage • Option Summary

    - -

    Use the display program to display an image or image sequence on any X server. See Command Line Processing for advice on how to structure your display command or see below for example usages of the command.

    - -

    Example Usage

    - -

    We list a few examples of the display command here to illustrate its usefulness and ease of use. To get started, lets display an image in the JPEG format:

    - -
    magick display rose.jpg
    -
    - -

    To tile a slate texture onto the root window, use:

    - -
    magick display -size 1280x1024 -window root slate.png
    -
    - -

    To display a visual image directory of all your JPEG images, use:

    - -
    magick display 'vid:*.jpg'
    -
    - -

    The display program defaults to the X screen resolution. To display vecotr formats at their intended size, override the default resolution:

    - -
    magick display -density 72 drawing.svg
    -
    - -

    You can find additional examples of using display in Graphics from the Command Line. Further discussion is available in More Graphics from the Command Line and Examples of ImageMagick Usage.

    - -

    Option Summary

    - -

    The display command recognizes these options. Click on an option to get more details about how that option works.

    - -
    -adaptive-blur geometry-adaptive-blur geometry adaptively blur pixels; decrease effect near edges
    -adaptive-resize geometry-adaptive-resize geometry adaptively resize image with data dependent triangulation.
    -adaptive-sharpen geometry-adaptive-sharpen geometry adaptively sharpen pixels; increase effect near edges
    -adjoin-adjoin join images into a single multi-image file
    -affine matrix-affine matrix affine transform matrix
    -alpha-alpha on, activate, off, deactivate, set, opaque, copy", transparent, extract, background, or shape the alpha channel
    -annotate geometry text-annotate geometry text annotate the image with text
    -antialias-antialias remove pixel-aliasing
    -append-append append an image sequence
    -authenticate value-authenticate value decipher image with this password
    -auto-gamma-auto-gamma automagically adjust gamma level of image
    -auto-level-auto-level automagically adjust color levels of image
    -auto-orient-auto-orient automagically orient image
    -auto-threshold method-auto-threshold method automatically perform image thresholding
    -background color-background color background color
    -bench iterations-bench iterations measure performance
    -bias value-bias value add bias when convolving an image
    -black-threshold value-black-threshold value force all pixels below the threshold into black
    -blue-primary point-blue-primary point chromaticity blue primary point
    -blue-shift factor-blue-shift factor simulate a scene at nighttime in the moonlight
    -blur geometry-blur geometry reduce image noise and reduce detail levels
    -border geometry-border geometry surround image with a border of color
    -bordercolor color-bordercolor color border color
    -brightness-contrast geometry-brightness-contrast geometry improve brightness / contrast of the image
    -canny geometry-canny geometry use a multi-stage algorithm to detect a wide range of edges in the image
    -caption string-caption string assign a caption to an image
    -cdl filename-cdl filename color correct with a color decision list
    -channel type-channel type apply option to select image channels
    -charcoal radius-charcoal radius simulate a charcoal drawing
    -chop geometry-chop geometry remove pixels from the image interior
    -clamp-clamp set each pixel whose value is below zero to zero and any the pixel whose value is above the quantum range to the quantum range (e.g. 65535) otherwise the pixel value remains unchanged.
    -clip-clip clip along the first path from the 8BIM profile
    -clip-mask filename-clip-mask filename associate clip mask with the image
    -clip-path id-clip-path id clip along a named path from the 8BIM profile
    -clone index-clone index clone an image
    -clut-clut apply a color lookup table to the image
    -connected-components connectivity-connected-components connectivity connected-components uniquely labeled, choose from 4 or 8 way connectivity
    -contrast-stretch geometry-contrast-stretch geometry improve the contrast in an image by `stretching' the range of intensity value
    -coalesce-coalesce merge a sequence of images
    -colorize value-colorize value colorize the image with the fill color
    -color-matrix matrix-color-matrix matrix apply color correction to the image.
    -colors value-colors value preferred number of colors in the image
    -colorspace type-colorspace type set image colorspace
    -combine-combine combine a sequence of images
    -comment string-comment string annotate image with comment
    -compare-compare compare image
    -complexoperator-complexoperator perform complex mathematics on an image sequence
    -compose operator-compose operator set image composite operator
    -composite-composite composite image
    -compress type-compress type image compression type
    -contrast-contrast enhance or reduce the image contrast
    -convolve coefficients-convolve coefficients apply a convolution kernel to the image
    -copy geometry offset-copy geometry offset copy pixels from one area of an image to another
    -crop geometry-crop geometry crop the image
    -cycle amount-cycle amount cycle the image colormap
    -decipher filename-decipher filename convert cipher pixels to plain
    -debug events-debug events display copious debugging information
    -define format:option-define format:option define one or more image format options
    -deconstruct-deconstruct break down an image sequence into constituent parts
    -delay value-delay value display the next image after pausing
    -delete index-delete index delete the image from the image sequence
    -density geometry-density geometry horizontal and vertical density of the image
    -depth value-depth value image depth
    -despeckle-despeckle reduce the speckles within an image
    -direction type-direction type render text right-to-left or left-to-right
    -display server-display server get image or font from this X server
    -dispose method-dispose method layer disposal method
    -distribute-cache port-distribute-cache port launch a distributed pixel cache server
    -distort type coefficients-distort type coefficients distort image
    -dither method-dither method apply error diffusion to image
    -draw string-draw string annotate the image with a graphic primitive
    -duplicate count,indexes-duplicate count,indexes duplicate an image one or more times
    -edge radius-edge radius apply a filter to detect edges in the image
    -emboss radius-emboss radius emboss an image
    -encipher filename-encipher filename convert plain pixels to cipher pixels
    -encoding type-encoding type text encoding type
    -endian type-endian type endianness (MSB or LSB) of the image
    -enhance-enhance apply a digital filter to enhance a noisy image
    -equalize-equalize perform histogram equalization to an image
    -evaluate operator value-evaluate operator value evaluate an arithmetic, relational, or logical expression
    -evaluate-sequence operator-evaluate-sequence operator evaluate an arithmetic, relational, or logical expression for an image sequence
    -extent geometry-extent geometry set the image size
    -extract geometry-extract geometry extract area from image
    -family name-family name render text with this font family
    -features distance-features distance analyze image features (e.g. contract, correlations, etc.).
    -fft-fft implements the discrete Fourier transform (DFT)
    -fill color-fill color color to use when filling a graphic primitive
    -filter type-filter type use this filter when resizing an image
    -flatten-flatten flatten a sequence of images
    -flip-flip flip image in the vertical direction
    -floodfill geometry color-floodfill geometry color floodfill the image with color
    -flop-flop flop image in the horizontal direction
    -font name-font name render text with this font
    -format string-format string output formatted image characteristics
    -frame geometry-frame geometry surround image with an ornamental border
    -function name-function name apply a function to the image
    -fuzz distance-fuzz distance colors within this distance are considered equal
    -fx expression-fx expression apply mathematical expression to an image channel(s)
    -gamma value-gamma value level of gamma correction
    -gaussian-blur geometry-gaussian-blur geometry reduce image noise and reduce detail levels
    -geometry geometry-geometry geometry preferred size or location of the image
    -gravity type-gravity type horizontal and vertical text placement
    -grayscale method-grayscale method convert image to grayscale
    -green-primary point-green-primary point chromaticity green primary point
    -help-help print program options
    -hough-lines geometry-hough-lines geometry identify lines in the image
    -identify-identify identify the format and characteristics of the image
    -ift-ift implements the inverse discrete Fourier transform (DFT)
    -implode amount-implode amount implode image pixels about the center
    -insert index-insert index insert last image into the image sequence
    -intensity method-intensity method method to generate an intensity value from a pixel
    -intent type-intent type type of rendering intent when managing the image color
    -interlace type-interlace type type of image interlacing scheme
    -interline-spacing value-interline-spacing value the space between two text lines
    -interpolate method-interpolate method pixel color interpolation method
    -interword-spacing value-interword-spacing value the space between two words
    -kerning value-kerning value the space between two characters
    -kuwahara geometry-kuwahara geometry edge preserving noise reduction filter
    -label string-label string assign a label to an image
    -lat geometry-lat geometry local adaptive thresholding
    -layers method-layers method optimize or compare image layers
    -level value-level value adjust the level of image contrast
    -limit type value-limit type value pixel cache resource limit
    -linear-stretch geometry-linear-stretch geometry linear with saturation histogram stretch
    -liquid-rescale geometry-liquid-rescale geometry rescale image with seam-carving
    -list type-list type Color, Configure, Delegate, Format, Magic, Module, Resource, or Type
    -log format-log format format of debugging information
    -loop iterations-loop iterations add Netscape loop extension to your GIF animation
    -mattecolor color-mattecolor color frame color
    -median radius-median radius apply a median filter to the image
    -mean-shift geometry-mean-shift geometry delineate arbitrarily shaped clusters in the image
    -metric type-metric type measure differences between images with this metric
    -mode radius-mode radius make each pixel the 'predominant color' of the neighborhood
    -modulate value-modulate value vary the brightness, saturation, and hue
    -moments-moments display image moments.
    -monitor-monitor monitor progress
    -monochrome-monochrome transform image to black and white
    -morph value-morph value morph an image sequence
    -morphology method kernel-morphology method kernel apply a morphology method to the image
    -motion-blur geometry-motion-blur geometry simulate motion blur
    -negate-negate replace each pixel with its complementary color
    -noise radius-noise radius add or reduce noise in an image
    -normalize-normalize transform image to span the full range of colors
    -opaque color-opaque color change this color to the fill color
    -ordered-dither NxN-ordered-dither NxN ordered dither the image
    -orient type-orient type image orientation
    -page geometry-page geometry size and location of an image canvas (setting)
    -paint radius-paint radius simulate an oil painting
    -perceptible-perceptible set each pixel whose value is less than |epsilon| to -epsilon or epsilon (whichever is closer) otherwise the pixel value remains unchanged.
    -ping-ping efficiently determine image attributes
    -pointsize value-pointsize value font point size
    -polaroid angle-polaroid angle simulate a Polaroid picture
    -poly terms-poly terms build a polynomial from the image sequence and the corresponding terms (coefficients and degree pairs).
    -posterize levels-posterize levels reduce the image to a limited number of color levels
    -precision value-precision value set the maximum number of significant digits to be printed
    -preview type-preview type image preview type
    -print string-print string interpret string and print to console
    -process image-filter-process image-filter process the image with a custom image filter
    -profile filename-profile filename add, delete, or apply an image profile
    -quality value-quality value JPEG/MIFF/PNG compression level
    -quantize colorspace-quantize colorspace reduce image colors in this colorspace
    -quiet-quiet suppress all warning messages
    -radial-blur angle-radial-blur angle radial blur the image
    -raise value-raise value lighten/darken image edges to create a 3-D effect
    -random-threshold low,high-random-threshold low,high random threshold the image
    -read-mask filename-read-mask filename associate a read mask with the image
    -red-primary point-red-primary point chromaticity red primary point
    -regard-warnings-regard-warnings pay attention to warning messages.
    -region geometry-region geometry apply options to a portion of the image
    -remap filename-remap filename transform image colors to match this set of colors
    -render-render render vector graphics
    -repage geometry-repage geometry size and location of an image canvas
    -resample geometry-resample geometry change the resolution of an image
    -resize geometry-resize geometry resize the image
    -respect-parentheses-respect-parentheses settings remain in effect until parenthesis boundary.
    -roll geometry-roll geometry roll an image vertically or horizontally
    -rotate degrees-rotate degrees apply Paeth rotation to the image
    -sample geometry-sample geometry scale image with pixel sampling
    -sampling-factor geometry-sampling-factor geometry horizontal and vertical sampling factor
    -scale geometry-scale geometry scale the image
    -scene value-scene value image scene number
    -seed value-seed value seed a new sequence of pseudo-random numbers
    -segment values-segment values segment an image
    -selective-blur geometry-selective-blur geometry selectively blur pixels within a contrast threshold
    -separate-separate separate an image channel into a grayscale image
    -sepia-tone threshold-sepia-tone threshold simulate a sepia-toned photo
    -set attribute value-set attribute value set an image attribute
    -shade degrees-shade degrees shade the image using a distant light source
    -shadow geometry-shadow geometry simulate an image shadow
    -sharpen geometry-sharpen geometry sharpen the image
    -shave geometry-shave geometry shave pixels from the image edges
    -shear geometry-shear geometry slide one edge of the image along the X or Y axis
    -sigmoidal-contrast geometry-sigmoidal-contrast geometry increase the contrast without saturating highlights or shadows
    -smush offset-smush offset smush an image sequence together
    -size geometry-size geometry width and height of image
    -sketch geometry-sketch geometry simulate a pencil sketch
    -solarize threshold-solarize threshold negate all pixels above the threshold level
    -splice geometry-splice geometry splice the background color into the image
    -spread radius-spread radius displace image pixels by a random amount
    -statistic type geometry-statistic type geometry replace each pixel with corresponding statistic from the neighborhood
    -strip-strip strip image of all profiles and comments
    -stroke color-stroke color graphic primitive stroke color
    -strokewidth value-strokewidth value graphic primitive stroke width
    -stretch type-stretch type render text with this font stretch
    -style type-style type render text with this font style
    -swap indexes-swap indexes swap two images in the image sequence
    -swirl degrees-swirl degrees swirl image pixels about the center
    -synchronize-synchronize synchronize image to storage device
    -taint-taint mark the image as modified
    -texture filename-texture filename name of texture to tile onto the image background
    -threshold value-threshold value threshold the image
    -thumbnail geometry-thumbnail geometry create a thumbnail of the image
    -tile filename-tile filename tile image when filling a graphic primitive
    -tile-offset geometry-tile-offset geometry set the image tile offset
    -tint value-tint value tint the image with the fill color
    -transform-transform affine transform image
    -transparent color-transparent color make this color transparent within the image
    -transparent-color color-transparent-color color transparent color
    -transpose-transpose flip image in the vertical direction and rotate 90 degrees
    -transverse-transverse flop image in the horizontal direction and rotate 270 degrees
    -treedepth value-treedepth value color tree depth
    -trim-trim trim image edges
    -type type-type type image type
    -undercolor color-undercolor color annotation bounding box color
    -unique-colors-unique-colors discard all but one of any pixel color.
    -units type-units type the units of image resolution
    -unsharp geometry-unsharp geometry sharpen the image
    -verbose-verbose print detailed information about the image
    -version-version print version information
    -view-view FlashPix viewing transforms
    -vignette geometry-vignette geometry soften the edges of the image in vignette style
    -virtual-pixel method-virtual-pixel method access method for pixels outside the boundaries of the image
    -wave geometry-wave geometry alter an image along a sine wave
    -wavelet-denoise threshold-wavelet-denoise threshold removes noise from the image using a wavelet transform
    -weight type-weight type render text with this font weight
    -white-point point-white-point point chromaticity white point
    -white-threshold value-white-threshold value force all pixels above the threshold into white
    -write filename-write filename write images to this file
    -write-mask filename-write-mask filename associate a write mask with the image
    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    OptionDescription
    -alphaon, activate, off, deactivate, set, opaque, copy", -transparent, extract, background, or shape the alpha channel
    -antialiasremove pixel-aliasing
    -authenticate valuedecrypt image with this password
    -backdropdisplay image centered on a backdrop
    -background colorbackground color
    -border geometrysurround image with a border of color
    -bordercolor colorborder color
    -channel typeapply option to select image channels
    -clipclip along the first path from the 8BIM profile
    -clip-path idclip along a named path from the 8BIM profile
    -coalescemerge a sequence of images
    -colormap typeShared or Private
    -colors valuepreferred number of colors in the image
    -colorspace typeset image colorspace
    -comment stringannotate image with comment
    -compress typeimage compression type
    -contrastenhance or reduce the image contrast
    -crop geometrypreferred size and location of the cropped image
    -debug eventsdisplay copious debugging information
    -decipher filenameconvert cipher pixels to plain
    -define format:optiondefine one or more image format options
    -delay valuedisplay the next image after pausing
    -density geometryhorizontal and vertical density of the image
    -depth valueimage depth
    -despecklereduce the speckles within an image
    -display serverget image or font from this X server
    -dispose methodlayer disposal method
    -dither methodapply error diffusion to image
    -edge radiusapply a filter to detect edges in the image
    -endian typeendianness (MSB or LSB) of the image
    -enhanceapply a digital filter to enhance a noisy image
    -equalizeperform histogram equalization to an image
    -extract geometryextract area from image
    -filter typeuse this filter when resizing an image
    -flattenflatten a sequence of images
    -flipflip image in the vertical direction
    -flopflop image in the horizontal direction
    -frame geometrysurround image with an ornamental border
    -fuzz distancecolors within this distance are considered equal
    -gamma valuelevel of gamma correction
    -geometry geometrypreferred size or location of the image
    -gravity geometryhorizontal and vertical backdrop placement
    -helpprint program options
    -identifyidentify the format and characteristics of the image
    -immutable typeprohibit image edits
    -interlace typetype of image interlacing scheme
    -interpolate methodpixel color interpolation method
    -label nameassign a label to an image
    -limit type valuepixel cache resource limit
    -log formatformat of debugging information
    -map filenametransform image colors to match this set of colors
    -mattecolor colorframe color
    -monitormonitor progress
    -monochrometransform image to black and white
    -negatereplace each pixel with its complementary color
    -normalizetransform image to span the full range of colors
    -page geometrysize and location of an image canvas (setting)
    -profile filenameadd, delete, or apply an image profile
    -quantize colorspacereduce image colors in this colorspace
    -quietsuppress all warning messages
    -raise valuelighten/darken image edges to create a 3-D effect
    -regard-warningspay attention to warning messages.
    -remote commandexecute a command in an remote display process
    -resample geometrychange the resolution of an image
    -resize geometryresize the image
    -respect-parenthesessettings remain in effect until parenthesis boundary.
    -roll geometryroll an image vertically or horizontally
    -rotate degreesapply Paeth rotation to the image
    -sample geometryscale image with pixel sampling
    -sampling-factor geometryhorizontal and vertical sampling factor
    -scene valueimage scene number
    -seed valueseed a new sequence of pseudo-random numbers
    -segment valuessegment an image
    -set attribute valueset an image attribute
    -sharpen geometrysharpen the image
    -size geometrywidth and height of image
    -stripstrip image of all profiles and comments
    -thumbnail geometrycreate a thumbnail of the image
    -transparent-color colortransparent color
    -black-threshold valueforce all pixels below the threshold into black
    -trimtrim image edges
    -update secondsdetect when image file is modified and redisplay
    -verboseprint detailed information about the image
    -versionprint version information
    -virtual-pixel methodaccess method for pixels outside the boundaries of the image
    -visualdisplay image using this visual type
    -window iddisplay image to background of this window
    -window-group idexit program when this window id is destroyed
    -write filenamewrite images to this file
    +

    Unknown method

    -

    Security • - Architecture • - Related • - Sitemap • +

    Security • + Architecture • + Related • + Sitemap • Public Key

    -

    Donate • +

    Donate • Back to top • Contact Us

    © 1999-2018 ImageMagick Studio LLC

    @@ -589,4 +104,4 @@ transparent, extract, background, or shape the alpha channel - \ No newline at end of file + \ No newline at end of file diff --git a/www/distribute-pixel-cache.html b/www/distribute-pixel-cache.html index fb337e720..126b3b2f6 100644 --- a/www/distribute-pixel-cache.html +++ b/www/distribute-pixel-cache.html @@ -5,34 +5,34 @@ - - + + Distributed Pixel Cache @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    A distributed pixel cache is an extension of the traditional pixel cache available on a single host. The distributed pixel cache may span multiple servers so that it can grow in size and transactional capacity to support very large images or large image sequences. Start up the pixel cache server on one or more hosts. When you read or operate on an image and the local pixel cache resources are exhausted, ImageMagick contacts one or more of these remote pixel servers to store or retrieve pixels.

    @@ -118,4 +118,4 @@ convert -limit memory 1GiB -limit map 2GiB -limit disk 4GiB \ - \ No newline at end of file + \ No newline at end of file diff --git a/www/download.html b/www/download.html index 84f2bf010..e34d59e59 100644 --- a/www/download.html +++ b/www/download.html @@ -5,34 +5,34 @@ - - + + Download @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    Unix Binary Release • Mac OS X Binary Release • iOS Binary Release • Windows Binary Release

    -

    You can install ImageMagick from source. However, if you don't have a proper development environment or if you're anxious to get started, download a ready-to-run Unix or Windows executable. Before you download, you may want to review recent changes to the ImageMagick distribution.

    +

    You can install ImageMagick from source. However, if you don't have a proper development environment or if you're anxious to get started, download a ready-to-run Unix or Windows executable. Before you download, you may want to review recent changes to the ImageMagick distribution.

    -

    ImageMagick source and binary distributions are available from a variety of FTP and Web mirrors around the world.

    +

    ImageMagick source and binary distributions are available from a variety of FTP and Web mirrors around the world.

    Unix Binary Release

    -

    These are the Unix variations that we support. If your system is not on the list, try installing from source. Although ImageMagick runs fine on a single core computer, it automagically runs in parallel on dual and quad-core systems reducing run times considerably.

    +

    These are the Unix variations that we support. If your system is not on the list, try installing from source. Although ImageMagick runs fine on a single core computer, it automagically runs in parallel on dual and quad-core systems reducing run times considerably.

    @@ -233,7 +233,7 @@ display logo.gif identify logo.gif display logo.gif -

    Note, the display program requires the X11 server available on your Mac OS X installation DVD. Once that is installed, you will also need to set export DISPLAY=:0.

    +

    Note, the display program requires the X11 server available on your Mac OS X installation DVD. Once that is installed, you will also need to set export DISPLAY=:0.

    The best way to deal with all the exports is to put them at the end of your .profile file

    @@ -460,4 +460,4 @@ objShell.Exec("magick ""e:/myimages/image.png"" ""e:/myimages/image.jpg""")window.jQuery || document.write(' - \ No newline at end of file + \ No newline at end of file diff --git a/www/escape.html b/www/escape.html index 4a5e87870..d4a57da23 100644 --- a/www/escape.html +++ b/www/escape.html @@ -5,34 +5,34 @@ - - + + Format and Print Image Properties @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    There are copious amounts of extra data associated with images (metadata), beyond the actual image pixels. This metadata can be useful, either for display, or for various calculations, or in modifying the behavior of later image processing operations. You can utilize percent escapes in a number of options, for example in -format or in montage -label, to print various properties and other settings associated with an image.

    @@ -676,13 +676,13 @@ used for image processing use.

    There are some special prefixes (before the first ':') which performs calculations based on the user provided string that follows that prefix. For example you can do a numerical calculation use %[fx:...] to -evaluate the given FX expressions:

    +evaluate the given FX expressions:

    %[fx:expression]
     

    Use pixel: or hex: to evaluate a pixel color as defined by the FX +href="fx.html">FX expression:

    %[pixel:expression]
    @@ -888,13 +888,13 @@ Post ObjectData Descriptor Record
         
    -

    Security • - Architecture • - Related • - Sitemap • +

    Security • + Architecture • + Related • + Sitemap • Public Key

    -

    Donate • +

    Donate • Back to top • Contact Us

    © 1999-2018 ImageMagick Studio LLC

    @@ -905,4 +905,4 @@ Post ObjectData Descriptor Record - \ No newline at end of file + \ No newline at end of file diff --git a/www/examples.html b/www/examples.html index e64d6bca8..045fe6cb1 100644 --- a/www/examples.html +++ b/www/examples.html @@ -5,34 +5,34 @@ - - + + Examples of ImageMagick Usage @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +
    -

    Here are a few examples of what you can do with an image using ImageMagick from the command line, a program interface, or script. You can generate this image yourself with this PerlMagick script, examples.pl.

    +

    Here are a few examples of what you can do with an image using ImageMagick from the command line, a program interface, or script. You can generate this image yourself with this PerlMagick script, examples.pl.

    [ImageMagick Examples]

    @@ -105,4 +105,4 @@ - \ No newline at end of file + \ No newline at end of file diff --git a/www/exception.html b/www/exception.html index 9d8b5532c..eab2d2a7f 100644 --- a/www/exception.html +++ b/www/exception.html @@ -5,34 +5,34 @@ - - + + Exceptions @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +
    @@ -285,7 +285,7 @@

    Donate • Back to top • - Contact Us

    + Contact Us

    © 1999-2018 ImageMagick Studio LLC

    @@ -294,3 +294,4 @@ + \ No newline at end of file diff --git a/www/export.html b/www/export.html index 613bc69c0..573090a47 100644 --- a/www/export.html +++ b/www/export.html @@ -5,34 +5,34 @@ - - + + Export Classification @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    -
    +

    ImageMagick Studio LLC is a limited liability corporation based in the United States of America. All of our products are developed via online collaboration in public forums and distributed from a central server within the U.S. Therefore, U.S. export laws and regulations apply to our distributions and remain in force as products and technology are re-exported to different parties and places around the world. Information on export control classifications and associated restrictions may be required for exporting, re-exporting, record keeping, bundling/embedding of ImageMagick products, encryption reporting, and shipping documentation. More information on U.S. Export Regulations can be found at the U. S. Bureau of Industry and Security.

    @@ -88,13 +88,13 @@
    - + @@ -233,21 +233,21 @@ the supported image formats.

    - + - + - + @@ -282,7 +282,7 @@ the supported image formats.

    - + @@ -303,7 +303,7 @@ the supported image formats.

    - + @@ -332,21 +332,21 @@ the supported image formats.

    - + - + - + @@ -409,7 +409,7 @@ the supported image formats.

    - + @@ -437,14 +437,14 @@ the supported image formats.

    - + - + @@ -458,7 +458,7 @@ the supported image formats.

    - + @@ -511,14 +511,14 @@ the supported image formats.

    - + - + @@ -542,35 +542,35 @@ the supported image formats.

    - + - + - + - + - + @@ -584,7 +584,7 @@ the supported image formats.

    - + @@ -602,7 +602,7 @@ the supported image formats.

    - + @@ -665,7 +665,7 @@ the supported image formats.

    - + @@ -676,10 +676,10 @@ the supported image formats.

    - + - + @@ -741,7 +741,7 @@ the supported image formats.

    - + @@ -755,7 +755,7 @@ the supported image formats.

    - + @@ -776,7 +776,7 @@ the supported image formats.

    - + @@ -846,7 +846,7 @@ the supported image formats.

    - + @@ -895,7 +895,7 @@ the supported image formats.

    - + @@ -909,7 +909,7 @@ the supported image formats.

    - + @@ -937,7 +937,7 @@ the supported image formats.

    - + @@ -972,14 +972,14 @@ the supported image formats.

    - + - + @@ -1042,7 +1042,7 @@ the supported image formats.

    - + @@ -1056,7 +1056,7 @@ the supported image formats.

    - + @@ -1077,7 +1077,7 @@ the supported image formats.

    - + @@ -1091,14 +1091,14 @@ the supported image formats.

    - + - + @@ -1126,7 +1126,7 @@ the supported image formats.

    - + @@ -1161,7 +1161,7 @@ the supported image formats.

    - + @@ -1182,7 +1182,7 @@ the supported image formats.

    - + @@ -1224,21 +1224,21 @@ the supported image formats.

    - + - + - +
    BPG RW Better Portable GraphicsUse -quality to specify the image compression quality. To meet the requirements of BPG, the quality argument divided by 2 (e.g. -quality 92 assigns 46 as the BPG compression.Use -quality to specify the image compression quality. To meet the requirements of BPG, the quality argument divided by 2 (e.g. -quality 92 assigns 46 as the BPG compression.
    CIN RW Kodak Cineon Image FormatUse -set to specify the image gamma or black and white points (e.g. -set gamma 1.7, -set reference-black 95, -set reference-white 685). Properties include cin:file.create_date, cin:file.create_time, cin:file.filename, cin:file.version, cin:film.count, cin:film.format, cin:film.frame_id, cin:film.frame_position, cin:film.frame_rate, cin:film.id, cin:film.offset, cin:film.prefix, cin:film.slate_info, cin:film.type, cin:image.label, cin:origination.create_date, cin:origination.create_time, cin:origination.device, cin:origination.filename, cin:origination.model, cin:origination.serial, cin:origination.x_offset, cin:origination.x_pitch, cin:origination.y_offset, cin:origination.y_pitch, cin:user.data.Use -set to specify the image gamma or black and white points (e.g. -set gamma 1.7, -set reference-black 95, -set reference-white 685). Properties include cin:file.create_date, cin:file.create_time, cin:file.filename, cin:file.version, cin:film.count, cin:film.format, cin:film.frame_id, cin:film.frame_position, cin:film.frame_rate, cin:film.id, cin:film.offset, cin:film.prefix, cin:film.slate_info, cin:film.type, cin:image.label, cin:origination.create_date, cin:origination.create_time, cin:origination.device, cin:origination.filename, cin:origination.model, cin:origination.serial, cin:origination.x_offset, cin:origination.x_pitch, cin:origination.y_offset, cin:origination.y_pitch, cin:user.data.
    CMYK RW Raw cyan, magenta, yellow, and black samplesUse -size and -depth to specify the image width, height, and depth. To specify a single precision floating-point format, use -define quantum:format=floating-point. Set the depth to 32 for single precision floats, 64 for double precision, and 16 for half-precision.Use -size and -depth to specify the image width, height, and depth. To specify a single precision floating-point format, use -define quantum:format=floating-point. Set the depth to 32 for single precision floats, 64 for double precision, and 16 for half-precision.
    CMYKA RW Raw cyan, magenta, yellow, black, and alpha samplesUse -size and -depth to specify the image width, height, and depth. To specify a single precision floating-point format, use -define quantum:format=floating-point. Set the depth to 32 for single precision floats, 64 for double precision, and 16 for half-precision.Use -size and -depth to specify the image width, height, and depth. To specify a single precision floating-point format, use -define quantum:format=floating-point. Set the depth to 32 for single precision floats, 64 for double precision, and 16 for half-precision.
    DCM R Digital Imaging and Communications in Medicine (DICOM) imageUsed by the medical community for images like X-rays. ImageMagick sets the initial display range based on the Window Center (0028,1050) and Window Width (0028,1051) tags. Use -define dcm:display-range=reset to set the display range to the minimum and maximum pixel values. Use -define dcm:rescale=true to enable interpretation of the rescale slope and intercept settings in the file. Use -define dcm:window=centerXwidth to override the center and width settings in the file with your own values.Used by the medical community for images like X-rays. ImageMagick sets the initial display range based on the Window Center (0028,1050) and Window Width (0028,1051) tags. Use -define dcm:display-range=reset to set the display range to the minimum and maximum pixel values. Use -define dcm:rescale=true to enable interpretation of the rescale slope and intercept settings in the file. Use -define dcm:window=centerXwidth to override the center and width settings in the file with your own values.
    DDS RW Microsoft Direct Draw SurfaceUse -define to specify the compression (e.g. -define dds:compression={dxt1, dxt5, none}). Other defines include dds:cluster-fit={true,false}, dds:weight-by-alpha={true,false}, dds:fast-mipmaps={true,false}, and use dds:mipmaps to set the number of mipmaps (use fromlist to use the image list).Use -define to specify the compression (e.g. -define dds:compression={dxt1, dxt5, none}). Other defines include dds:cluster-fit={true,false}, dds:weight-by-alpha={true,false}, dds:fast-mipmaps={true,false}, and use dds:mipmaps to set the number of mipmaps (use fromlist to use the image list).
    DOT R Graph VisualizationUse -define to specify the layout engine (e.g. -define dot:layout-engine=twopi).Use -define to specify the layout engine (e.g. -define dot:layout-engine=twopi).
    DPX RW SMPTE Digital Moving Picture Exchange 2.0 (SMPTE 268M-2003)Use -set to specify the image gamma or black and white points (e.g. -set gamma 1.7, -set reference-black 95, -set reference-white 685).Use -set to specify the image gamma or black and white points (e.g. -set gamma 1.7, -set reference-black 95, -set reference-white 685).
    EMF R Microsoft Enhanced Metafile (32-bit)Only available under Microsoft Windows. Use -size command line option to specify the maximum width and height.Only available under Microsoft Windows. Use -size command line option to specify the maximum width and height.
    EXR RW High dynamic-range (HDR) file format developed by Industrial Light & MagicSee High Dynamic-Range Images for details on this image format. To specify the output color type, use -define exr:color-type={RGB,RGBA,YC,YCA,Y,YA,R,G,B,A}. Use -sampling-factor to specify the sampling rate for YC(A) (e.g. 2x2 or 4:2:0). Requires the OpenEXR delegate library.See High Dynamic-Range Images for details on this image format. To specify the output color type, use -define exr:color-type={RGB,RGBA,YC,YCA,Y,YA,R,G,B,A}. Use -sampling-factor to specify the sampling rate for YC(A) (e.g. 2x2 or 4:2:0). Requires the OpenEXR delegate library.
    FPX RW FlashPix FormatFlashPix has the option to store mega- and giga-pixel images at various resolutions in a single file which permits conservative bandwidth and fast reveal times when displayed within a Web browser. Requires the FlashPix SDK. Specify the FlashPix viewing parameters with the -define fpx:view.FlashPix has the option to store mega- and giga-pixel images at various resolutions in a single file which permits conservative bandwidth and fast reveal times when displayed within a Web browser. Requires the FlashPix SDK. Specify the FlashPix viewing parameters with the -define fpx:view.
    GIF RW CompuServe Graphics Interchange Format8-bit RGB PseudoColor with up to 256 palette entries. Specify the format GIF87 to write the older version 87a of the format. Use -transparent-color to specify the GIF transparent color (e.g. -transparent-color wheat).8-bit RGB PseudoColor with up to 256 palette entries. Specify the format GIF87 to write the older version 87a of the format. Use -transparent-color to specify the GIF transparent color (e.g. -transparent-color wheat).
    GRAY RW Raw gray samplesUse -size and -depth to specify the image width, height, and depth. To specify a single precision floating-point format, use -define quantum:format=floating-point. Set the depth to 32 for single precision floats, 64 for double precision, and 16 for half-precision.Use -size and -depth to specify the image width, height, and depth. To specify a single precision floating-point format, use -define quantum:format=floating-point. Set the depth to 32 for single precision floats, 64 for double precision, and 16 for half-precision.
    ISOBRLISOBRL W ISO/TR 11548-1 BRaiLle Uses juxtaposition of 8-dot braille patterns (thus 8x2 dot matrices) to reproduce images, using the ISO/TR 11548-1 Braille encoding.
    ISOBRL6ISOBRL6 W ISO/TR 11548-1 BRaiLle 6 dots Uses juxtaposition of 6-dot braille patterns (thus 6x2 dot matrices) to reproduce images, using the ISO/TR 11548-1 Braille encoding.JP2 RW JPEG-2000 JP2 File Format SyntaxSpecify the encoding options with the -define option. See JP2 Encoding Options for more details.Specify the encoding options with the -define option. See JP2 Encoding Options for more details.
    JPT RW JPEG-2000 Code Stream SyntaxSpecify the encoding options with the -define option See JP2 Encoding Options for more details.Specify the encoding options with the -define option See JP2 Encoding Options for more details.
    J2C RW JPEG-2000 Code Stream SyntaxSpecify the encoding options with the -define option See JP2 Encoding Options for more details.Specify the encoding options with the -define option See JP2 Encoding Options for more details.
    J2K RW JPEG-2000 Code Stream SyntaxSpecify the encoding options with the -define option See JP2 Encoding Options for more details.Specify the encoding options with the -define option See JP2 Encoding Options for more details.
    JPEG RW Joint Photographic Experts Group JFIF formatNote, JPEG is a lossy compression. In addition, you cannot create black and white images with JPEG nor can you save transparency.

    Requires jpegsrc.v8c.tar.gz. You can set quality scaling for luminance and chrominance separately (e.g. -quality 90,70). You can optionally define the DCT method, for example to specify the float method, use -define jpeg:dct-method=float. By default we compute optimal Huffman coding tables. Specify -define jpeg:optimize-coding=false to use the default Huffman tables. Two other options include -define jpeg:block-smoothing and -define jpeg:fancy-upsampling. Set the sampling factor with -define jpeg:sampling-factor. You can size the image with jpeg:size, for example -define jpeg:size=128x128. To restrict the maximum file size, use jpeg:extent, for example -define jpeg:extent=400KB. To define one or more custom quantization tables, use -define jpeg:q-table=filename. To avoid reading a particular associated image profile, use -define profile:skip=name (e.g. profile:skip=ICC).
    Note, JPEG is a lossy compression. In addition, you cannot create black and white images with JPEG nor can you save transparency.

    Requires jpegsrc.v8c.tar.gz. You can set quality scaling for luminance and chrominance separately (e.g. -quality 90,70). You can optionally define the DCT method, for example to specify the float method, use -define jpeg:dct-method=float. By default we compute optimal Huffman coding tables. Specify -define jpeg:optimize-coding=false to use the default Huffman tables. Two other options include -define jpeg:block-smoothing and -define jpeg:fancy-upsampling. Set the sampling factor with -define jpeg:sampling-factor. You can size the image with jpeg:size, for example -define jpeg:size=128x128. To restrict the maximum file size, use jpeg:extent, for example -define jpeg:extent=400KB. To define one or more custom quantization tables, use -define jpeg:q-table=filename. To avoid reading a particular associated image profile, use -define profile:skip=name (e.g. profile:skip=ICC).
    JSON W JavaScript Object Notation, a lightweight data-interchange formatInclude additional attributes about the image with these defines: -define json:locate, -define json:limit, -define json:moments, or -define json:features.Include additional attributes about the image with these defines: -define json:locate, -define json:limit, -define json:moments, or -define json:features.
    MIFFMIFF RW Magick image file format This format persists all image attributes known to ImageMagick. To specify a single precision floating-point format, use -define quantum:format=floating-point. Set the depth to 32 for single precision floats, 64 for double precision, and 16 for half-precision.MSL RW Magick Scripting LanguageMSL is the XML-based scripting language supported by the conjure utility. MSL requires the libxml2 delegate library.MSL is the XML-based scripting language supported by the conjure utility. MSL requires the libxml2 delegate library.
    MVGMVG RW Magick Vector Graphics.The native ImageMagick vector metafile format. A text file containing vector drawing commands accepted by convert's -draw option.The native ImageMagick vector metafile format. A text file containing vector drawing commands accepted by convert's -draw option.
    PCD RW Photo CDThe maximum resolution written is 768x512 pixels since larger images require huffman compression (which is not supported). Use -bordercolor to specify the border color (e.g. -bordercolor black).The maximum resolution written is 768x512 pixels since larger images require huffman compression (which is not supported). Use -bordercolor to specify the border color (e.g. -bordercolor black).
    PCL W HP Page Control LanguageUse -define to specify fit to page option (e.g. -define pcl:fit-to-page=true).Use -define to specify fit to page option (e.g. -define pcl:fit-to-page=true).
    PDF RW Portable Document FormatRequires Ghostscript to read. By default, ImageMagick sets the page size to the MediaBox. Some PDF files, however, have a CropBox or TrimBox that is smaller than the MediaBox and may include white space, registration or cutting marks outside the CropBox or TrimBox. To force ImageMagick to use the CropBox or TrimBox rather than the MediaBox, use -define (e.g. -define pdf:use-cropbox=true or -define pdf:use-trimbox=true). Use -density to improve the appearance of your PDF rendering (e.g. -density 300x300). Use -alpha remove to remove transparency. To specify direct conversion from Postscript to PDF, use -define delegate:bimodel=true. Use -define pdf:fit-page=true to scale to the page size. To immediately stop processing upon an error, set -define pdf:stop-on-error to true. To set the page direction preferences to right-to-left, try -define pdf:page-direction=right-to-left.Requires Ghostscript to read. By default, ImageMagick sets the page size to the MediaBox. Some PDF files, however, have a CropBox or TrimBox that is smaller than the MediaBox and may include white space, registration or cutting marks outside the CropBox or TrimBox. To force ImageMagick to use the CropBox or TrimBox rather than the MediaBox, use -define (e.g. -define pdf:use-cropbox=true or -define pdf:use-trimbox=true). Use -density to improve the appearance of your PDF rendering (e.g. -density 300x300). Use -alpha remove to remove transparency. To specify direct conversion from Postscript to PDF, use -define delegate:bimodel=true. Use -define pdf:fit-page=true to scale to the page size. To immediately stop processing upon an error, set -define pdf:stop-on-error to true. To set the page direction preferences to right-to-left, try -define pdf:page-direction=right-to-left.
    PNG RW Portable Network GraphicsRequires libpng-1.0.11 or later, libpng-1.2.5 or later recommended. The PNG specification does not support pixels-per-inch units, only pixels-per-centimeter. To avoid reading a particular associated image profile, use -define profile:skip=name (e.g. profile:skip=ICC).Requires libpng-1.0.11 or later, libpng-1.2.5 or later recommended. The PNG specification does not support pixels-per-inch units, only pixels-per-centimeter. To avoid reading a particular associated image profile, use -define profile:skip=name (e.g. profile:skip=ICC).
    PNM RW Portable anymapPNM is a family of formats supporting portable bitmaps (PBM) , graymaps (PGM), and pixmaps (PPM). There is no file format associated with pnm itself. If PNM is used as the output format specifier, then ImageMagick automagically selects the most appropriate format to represent the image. The default is to write the binary version of the formats. Use -compress none to write the ASCII version of the formats.PNM is a family of formats supporting portable bitmaps (PBM) , graymaps (PGM), and pixmaps (PPM). There is no file format associated with pnm itself. If PNM is used as the output format specifier, then ImageMagick automagically selects the most appropriate format to represent the image. The default is to write the binary version of the formats. Use -compress none to write the ASCII version of the formats.
    PS RW Adobe PostScript fileRequires Ghostscript to read. To force ImageMagick to respect the crop box, use -define (e.g. -define eps:use-cropbox=true). Use -density to improve the appearance of your Postscript rendering (e.g. -density 300x300). Use -alpha remove to remove transparency. To specify direct conversion from PDF to Postscript, use -define delegate:bimodel=true.Requires Ghostscript to read. To force ImageMagick to respect the crop box, use -define (e.g. -define eps:use-cropbox=true). Use -density to improve the appearance of your Postscript rendering (e.g. -density 300x300). Use -alpha remove to remove transparency. To specify direct conversion from PDF to Postscript, use -define delegate:bimodel=true.
    PSD RW Adobe Photoshop bitmap fileUse -define psd:alpha-unblend=off to disable alpha blenning in the merged image. Use -define psd:additional-info=all|selective to transfer additional information from the input PSD file to output PSD file. The 'selective' option will preserve all additional information that is not related to the geometry of the image. The 'all' option should only be used when the geometry of the image has not been changed. This option is helpful when transferring non-simple layers, such as adjustment layers from the input PSD file to the output PSD file. This define is available as of Imagemagick version 6.9.5-8. Use -define psd:preserve-opacity-mask=true to preserve the opacity mask of a layer and add it back to the layer when the image is saved.Use -define psd:alpha-unblend=off to disable alpha blenning in the merged image. Use -define psd:additional-info=all|selective to transfer additional information from the input PSD file to output PSD file. The 'selective' option will preserve all additional information that is not related to the geometry of the image. The 'all' option should only be used when the geometry of the image has not been changed. This option is helpful when transferring non-simple layers, such as adjustment layers from the input PSD file to the output PSD file. This define is available as of Imagemagick version 6.9.5-8. Use -define psd:preserve-opacity-mask=true to preserve the opacity mask of a layer and add it back to the layer when the image is saved.
    RGB RW Raw red, green, and blue samplesUse -size and -depth to specify the image width, height, and depth. To specify a single precision floating-point format, use -define quantum:format=floating-point. Set the depth to 32 for single precision floats, 64 for double precision, and 16 for half-precision.Use -size and -depth to specify the image width, height, and depth. To specify a single precision floating-point format, use -define quantum:format=floating-point. Set the depth to 32 for single precision floats, 64 for double precision, and 16 for half-precision.
    RGBA RW Raw red, green, blue, and alpha samplesUse -size and -depth to specify the image width, height, and depth. To specify a single precision floating-point format, use -define quantum:format=floating-point. Set the depth to 32 for single precision floats, 64 for double precision, and 16 for half-precision.Use -size and -depth to specify the image width, height, and depth. To specify a single precision floating-point format, use -define quantum:format=floating-point. Set the depth to 32 for single precision floats, 64 for double precision, and 16 for half-precision.
    SPARSE-COLOR W Raw text fileFormat compatible with the -sparse-color option. Lists only non-fully-transparent pixels.Format compatible with the -sparse-color option. Lists only non-fully-transparent pixels.
    SVG RW Scalable Vector GraphicsImageMagick utilizes inkscape if its in your execution path otherwise RSVG. If neither are available, ImageMagick reverts to its internal SVG renderer. The default resolution is 96 DPI. Use -size command line option to specify the maximum width and height.ImageMagick utilizes inkscape if its in your execution path otherwise RSVG. If neither are available, ImageMagick reverts to its internal SVG renderer. The default resolution is 96 DPI. Use -size command line option to specify the maximum width and height.
    TIFF RW Tagged Image File FormatAlso known as TIF. Requires tiff-v3.6.1.tar.gz or later. Use -define to specify the rows per strip (e.g. -define tiff:rows-per-strip=8). To define the tile geometry, use for example, -define tiff:tile-geometry=128x128. To specify a signed format, use -define quantum:format=signed. To specify a single-precision floating-point format, use -define quantum:format=floating-point. Set the depth to 64 for a double-precision floating-point format. Use -define quantum:polarity=min-is-black or -define quantum:polarity=min-is-white toggle the photometric interpretation for a bilevel image. Specify the extra samples as associated or unassociated alpha with, for example, -define tiff:alpha=unassociated. Set the fill order with -define tiff:fill-order=msb|lsb. Set the TIFF endianess with -define tiff:endian=msb|lsb. Use -define tiff:exif-properties=false to skip reading the EXIF properties. You can set a number of TIFF software attributes including document name, host computer, artist, timestamp, make, model, software, and copyright. For example, -set tiff:software "My Company". If you want to ignore certain TIFF tags, use this option: -define tiff:ignore-tags=comma-separated-list-of-tag-IDs. Since version 6.9.1-4 there is support for reading photoshop layers in TIFF files, this can be disabled with -define tiff:ignore-layers=trueAlso known as TIF. Requires tiff-v3.6.1.tar.gz or later. Use -define to specify the rows per strip (e.g. -define tiff:rows-per-strip=8). To define the tile geometry, use for example, -define tiff:tile-geometry=128x128. To specify a signed format, use -define quantum:format=signed. To specify a single-precision floating-point format, use -define quantum:format=floating-point. Set the depth to 64 for a double-precision floating-point format. Use -define quantum:polarity=min-is-black or -define quantum:polarity=min-is-white toggle the photometric interpretation for a bilevel image. Specify the extra samples as associated or unassociated alpha with, for example, -define tiff:alpha=unassociated. Set the fill order with -define tiff:fill-order=msb|lsb. Set the TIFF endianess with -define tiff:endian=msb|lsb. Use -define tiff:exif-properties=false to skip reading the EXIF properties. You can set a number of TIFF software attributes including document name, host computer, artist, timestamp, make, model, software, and copyright. For example, -set tiff:software "My Company". If you want to ignore certain TIFF tags, use this option: -define tiff:ignore-tags=comma-separated-list-of-tag-IDs. Since version 6.9.1-4 there is support for reading photoshop layers in TIFF files, this can be disabled with -define tiff:ignore-layers=true
    TTF R TrueType font fileRequires freetype 2. Opening as file returns a preview image. Use -set if you do not want to hint glyph outlines after their scaling to device pixels (e.g. -set type:hinting off).Requires freetype 2. Opening as file returns a preview image. Use -set if you do not want to hint glyph outlines after their scaling to device pixels (e.g. -set type:hinting off).
    TXT RW Raw text fileUse -define to specify the color compliance (e.g. -define txt:compliance=css).Use -define to specify the color compliance (e.g. -define txt:compliance=css).
    UYVY RW Interleaved YUV raw imageUse -size and -depth command line options to specify width and height. Use -sampling-factor to set the desired subsampling (e.g. -sampling-factor 4:2:2).Use -size and -depth command line options to specify width and height. Use -sampling-factor to set the desired subsampling (e.g. -sampling-factor 4:2:2).
    WEBP RW Weppy image formatRequires the WEBP delegate library. Specify the encoding options with the -define option See WebP Encoding Options for more details.Requires the WEBP delegate library. Specify the encoding options with the -define option See WebP Encoding Options for more details.
    X RW display or import an image to or from an X11 serverUse -define to obtain the image from the root window (e.g. -define x:screen=true). Set x:silent=true to turn off the beep when importing an image.Use -define to obtain the image from the root window (e.g. -define x:screen=true). Set x:silent=true to turn off the beep when importing an image.
    YCbCr RW Raw Y, Cb, and Cr samplesUse -size and -depth to specify the image width, height, and depth.Use -size and -depth to specify the image width, height, and depth.
    YCbCrA RW Raw Y, Cb, Cr, and alpha samplesUse -size and -depth to specify the image width, height, and depth.Use -size and -depth to specify the image width, height, and depth.
    YUV RW CCIR 601 4:1:1Use -size and -depth command line options to specify width, height, and depth. Use -sampling-factor to set the desired subsampling (e.g. -sampling-factor 4:2:2).Use -size and -depth command line options to specify width, height, and depth. Use -sampling-factor to set the desired subsampling (e.g. -sampling-factor 4:2:2).
    @@ -1262,13 +1262,13 @@ the supported image formats.

    R Canvas image of specified color Useful to create solid color canvas images. Use - -size and -depth to specify the + -size and -depth to specify the image width, height, and depth. Example canvas color specifications include canvas:red and canvas:#FF0000.
    If no color is specified a 'white' canvas image is - generated. If no -size is specified + generated. If no -size is specified a single pixel image of the specified color is generated. @@ -1419,14 +1419,14 @@ the supported image formats.

    STEGANO R Steganographic image - Use -size command line option to specify width, height, and offset of the steganographic image + Use -size command line option to specify width, height, and offset of the steganographic image TILE R Tiled image - Create a tiled version of an image at by tiling a image. Use -size to specify the tiled image size. Tiles are composited on an image background and therefore is responsive to the -compose option. The image is specified similar to + Create a tiled version of an image at by tiling a image. Use -size to specify the tiled image size. Tiles are composited on an image background and therefore is responsive to the -compose option. The image is specified similar to TILE:image.miff. @@ -1441,7 +1441,7 @@ the supported image formats.

    VID RW Visual Image Directory - Used to create a thumbnailed directory (tiled thumbnails) of a set of images which may be used to select images to view via the display program, or saved to a MIFF or SHTML file. + Used to create a thumbnailed directory (tiled thumbnails) of a set of images which may be used to select images to view via the display program, or saved to a MIFF or SHTML file. @@ -1455,7 +1455,7 @@ the supported image formats.

    X RW Select image from or display image to your X server screen - Also see the import and display + Also see the import and display programs. @@ -1501,7 +1501,7 @@ the supported image formats.

    NETSCAPE R image using colors in Netscape 216 (6x6x6 ) color cube, 216x144 - Most commonly used with the convert and mogrify programs with the -map option to create web safe images. + Most commonly used with the convert and mogrify programs with the -map option to create web safe images. @@ -1522,7 +1522,7 @@ the supported image formats.

    Built-in Patterns

    -

    ImageMagick includes a number of built-in (embedded) patterns which may be referenced as if they were an image file. The pattern: format tag may be used via the syntax pattern:name to request an embedded pattern (e.g. pattern:checkerboard). The pattern size is controlled with the -size command line option.

    +

    ImageMagick includes a number of built-in (embedded) patterns which may be referenced as if they were an image file. The pattern: format tag may be used via the syntax pattern:name to request an embedded pattern (e.g. pattern:checkerboard). The pattern size is controlled with the -size command line option.

    @@ -1958,7 +1958,7 @@ the supported image formats.

    - @@ -1966,7 +1966,7 @@ the supported image formats.

    - + @@ -1999,4 +1999,4 @@ the supported image formats.

    - \ No newline at end of file + \ No newline at end of file diff --git a/www/fx.html b/www/fx.html index 270a951a4..5179a0f53 100644 --- a/www/fx.html +++ b/www/fx.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Add a Special Effect @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    AddNoiseImageBlueShiftImageCharcoalImageColorizeImageColorMatrixImageFxImageImplodeImageThe MorphImagesPlasmaImagePolaroidImageMagickSepiaToneImageShadowImageSketchImageSolarizeImageSteganoImageStereoAnaglyphImageSwirlImageTintImageVignetteImageWaveImageWaveletDenoiseImage

    @@ -860,4 +860,4 @@ Image *WaveletDenoiseImage(const Image *image,const double threshold, - \ No newline at end of file + \ No newline at end of file diff --git a/www/gradient.html b/www/gradient.html index 2743c545f..a949cb491 100644 --- a/www/gradient.html +++ b/www/gradient.html @@ -5,34 +5,34 @@ - - + + Image Gradients @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +
    @@ -107,14 +107,14 @@ radial-gradient:color1-color2
    convert -size 256x256 gradient: linear_gradient.png
     convert -size 256x256 gradient:white-black linear_gradient.png
     
    -

    +

    If you want a radial gradient, try:

    convert -size 256x256 radial-gradient: radial_gradient.png
     convert -size 256x256 radial-gradient:white-black radial_gradient.png
     
    -

    +

    As of IM 6.9.2.5, gradients have been enhanced through the use of several -defines.

    @@ -191,7 +191,7 @@ convert -size 256x256 radial-gradient:white-black radial_gradient.png
    convert -size 256x128 -define gradient:direction=north gradient:black-white linear_gradient_default.png
     convert -size 256x128 -define gradient:angle=0 gradient:black-white linear_gradient_default.png
     
    -

    +

    The equivalent of

    @@ -203,7 +203,7 @@ convert -size 256x128 -define gradient:angle=0 gradient:black-white linear_gradi
    convert -size 256x128 -define gradient:direction=east gradient:black-white linear_gradient_east.png
     convert -size 256x128 -define gradient:angle=90 gradient:black-white linear_gradient_east.png
     
    -

    +

    Examples of radial gradients going from black in the center to white at the boundary for the cases of "maximum/circle/default", "minimum", "diagonal", "ellipse" and 45 degree rotated ellipse, respectively, follow below.

    @@ -212,25 +212,25 @@ convert -size 256x128 -define gradient:angle=90 gradient:black-white linear_grad
    convert -size 256x128 radial-gradient:black-white radial_gradient_maximum.png
     convert -size 256x128 -define gradient:radii=128,128 radial-gradient:black-white radial_gradient_maximum.png
     
    -

    +

    convert -size 256x128 -define gradient:extent=minimum radial-gradient:black-white radial_gradient_minimum.png
     convert -size 256x128 -define gradient:radii=64,64 radial-gradient:black-white radial_gradient_minimum.png
     
    -

    +

    convert -size 256x128 -define gradient:extent=diagonal radial-gradient:black-white radial_gradient_diagonal.png
     
    -

    +

    convert -size 256x128 -define gradient:extent=ellipse radial-gradient:black-white radial_gradient_ellipse.png
     convert -size 256x128 -define gradient:radii=128,64 radial-gradient:black-white radial_gradient_ellipse.png
     
    -

    +

    convert -size 256x256 -define gradient:radii=128,64 -define gradient:angle=45 radial-gradient:black-white radial_gradient_ellipse_angle45.png
     
    -

    +

    @@ -254,4 +254,4 @@ convert -size 256x128 -define gradient:radii=128,64 radial-gradient:black-white - \ No newline at end of file + \ No newline at end of file diff --git a/www/high-dynamic-range.html b/www/high-dynamic-range.html index 7a320b1e9..65b04d005 100644 --- a/www/high-dynamic-range.html +++ b/www/high-dynamic-range.html @@ -5,34 +5,34 @@ - - + + High Dynamic-Range Images @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +
    @@ -130,4 +130,4 @@ Features: HDRI - \ No newline at end of file + \ No newline at end of file diff --git a/www/history.html b/www/history.html index c44541203..0505e2e86 100644 --- a/www/history.html +++ b/www/history.html @@ -5,34 +5,34 @@ - - + + History @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    @@ -105,13 +105,13 @@ I swear by my life and my love of it that I will never live for the sake of anot

    -

    Security • - Architecture • - Related • - Sitemap • +

    Security • + Architecture • + Related • + Sitemap • Public Key

    -

    Donate • +

    Donate • Back to top • Contact Us

    © 1999-2018 ImageMagick Studio LLC

    @@ -122,4 +122,4 @@ I swear by my life and my love of it that I will never live for the sake of anot - \ No newline at end of file + \ No newline at end of file diff --git a/www/identify.html b/www/identify.html index b74e7cc5b..17471891b 100644 --- a/www/identify.html +++ b/www/identify.html @@ -5,34 +5,34 @@ - - + + Command-line Tools: Identify @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    Example Usage • Option Summary

    @@ -215,213 +215,213 @@ image.raw RGB 640x480 sRGB 9kb 0.000u 0:01
    - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + @@ -449,4 +449,4 @@ transparent, extract, background, or shape the alpha channel - \ No newline at end of file + \ No newline at end of file diff --git a/www/import.html b/www/import.html index ad5324e8d..ddf86b125 100644 --- a/www/import.html +++ b/www/import.html @@ -5,34 +5,34 @@ - - + + Command-line Tools: Import @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    -
    +

    Example Usage • Option Summary

    -

    Use the import program to capture some or all of an X server screen and save the image to a file. import captures the window selected by clicking or program argument. See Command Line Processing for advice on how to structure your import command or see below for example usages of the command.

    +

    Use the import program to capture some or all of an X server screen and save the image to a file. import captures the window selected by clicking or program argument. See Command Line Processing for advice on how to structure your import command or see below for example usages of the command.

    Example Usage

    @@ -433,13 +433,13 @@
    -

    Security • - Architecture • - Related • - Sitemap • +

    Security • + Architecture • + Related • + Sitemap • Public Key

    -

    Donate • +

    Donate • Back to top • Contact Us

    © 1999-2018 ImageMagick Studio LLC

    @@ -450,4 +450,4 @@ - \ No newline at end of file + \ No newline at end of file diff --git a/www/index.html b/www/index.html index 9413a9561..af3f10b51 100644 --- a/www/index.html +++ b/www/index.html @@ -5,34 +5,34 @@ - - + + Convert, Edit, Or Compose Bitmap Images @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    Features and Capabilities • News • Community

    @@ -88,7 +88,7 @@ Use ImageMagickcommand-line or you can use the features from programs written in your favorite language. Choose from these interfaces: G2F (Ada), MagickCore (C), MagickWand (C), ChMagick (Ch), ImageMagickObject (COM+), Magick++ (C++), JMagick (Java), JuliaIO (Julia), L-Magick (Lisp), Lua (LuaJIT), NMagick (Neko/haXe), Magick.NET (.NET), PascalMagick (Pascal), PerlMagick (Perl), MagickWand for PHP (PHP), IMagick (PHP), PythonMagick (Python), magick (R), RMagick (Ruby), or TclMagick (Tcl/TK). With a language interface, use ImageMagick to modify or create images dynamically and automagically.

    ImageMagick utilizes multiple computational threads to increase performance and can read, process, or write mega-, giga-, or tera-pixel image sizes.

    -

    ImageMagick is free software delivered as a ready-to-run binary distribution or as source code that you may use, copy, modify, and distribute in both open and proprietary applications. It is distributed under the Apache 2.0 license.

    +

    ImageMagick is free software delivered as a ready-to-run binary distribution or as source code that you may use, copy, modify, and distribute in both open and proprietary applications. It is distributed under the Apache 2.0 license.

    The ImageMagick development process ensures a stable API and ABI. Before each ImageMagick release, we perform a comprehensive security assessment that includes memory error and thread data race detection to help prevent security vulnerabilities.

    @@ -131,7 +131,7 @@ Use ImageMagickDelineate image features +
    @@ -199,7 +199,7 @@ Use ImageMagickNoise and color reduction + @@ -264,7 +264,7 @@ Use ImageMagickDonate • Back to top • - Contact Us

    + Contact Us

    © 1999-2018 ImageMagick Studio LLC

    @@ -273,4 +273,4 @@ Use ImageMagick<\/script>') - \ No newline at end of file + \ No newline at end of file diff --git a/www/install-source.html b/www/install-source.html index d8af6bd56..1205dc37a 100644 --- a/www/install-source.html +++ b/www/install-source.html @@ -5,34 +5,34 @@ - - + + Install from Source @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    -
    +

    Install from Unix Source • Install from Windows Source

    @@ -88,7 +88,7 @@
    identify -version
     
    -

    If the identify program executes and identifies itself as ImageMagick, you may not need to install ImageMagick from source unless you want to add support for additional image formats or upgrade to a newer version. You also have the option of installing a pre-compiled binary release. However, if you still want to install from source, choose a platform, Unix or Windows. Before installing from source, you may want to review recent changes to the ImageMagick distribution.

    +

    If the identify program executes and identifies itself as ImageMagick, you may not need to install ImageMagick from source unless you want to add support for additional image formats or upgrade to a newer version. You also have the option of installing a pre-compiled binary release. However, if you still want to install from source, choose a platform, Unix or Windows. Before installing from source, you may want to review recent changes to the ImageMagick distribution.

    The authoritative source code repository is https://github.com/ImageMagick. We maintain a source code mirror at https://git.imagemagick.org/repos/ImageMagick. We test and deploy ImageMagick with Travis CI and AppVeyor.

    @@ -124,13 +124,13 @@
    make check
     
    -

    Congratulations, you have a working ImageMagick distribution and you are ready to use ImageMagick to convert, compose, or edit your images or perhaps you'll want to use one of the Application Program Interfaces for C, C++, Perl, and others.

    +

    Congratulations, you have a working ImageMagick distribution and you are ready to use ImageMagick to convert, compose, or edit your images or perhaps you'll want to use one of the Application Program Interfaces for C, C++, Perl, and others.

    -

    The above instructions will satisfy a great number of ImageMagick users, but we suspect a few will have additional questions or problems to consider. For example, what does one do if ImageMagick fails to configure or compile? Or what if you don't have administrator privileges and what if you don't want to install ImageMagick in the default /../usr/local folder? You will find the answer to these questions, and more, in Advanced Unix Source Installation.

    +

    The above instructions will satisfy a great number of ImageMagick users, but we suspect a few will have additional questions or problems to consider. For example, what does one do if ImageMagick fails to configure or compile? Or what if you don't have administrator privileges and what if you don't want to install ImageMagick in the default /../usr/local folder? You will find the answer to these questions, and more, in Advanced Unix Source Installation.

    Install from Windows Source

    -

    Building ImageMagick source for Windows requires a modern version of Microsoft Visual Studio IDE. Users have reported success with the Borland C++ compiler as well. If you don't have a compiler you can still install a self-installing binary release.

    +

    Building ImageMagick source for Windows requires a modern version of Microsoft Visual Studio IDE. Users have reported success with the Borland C++ compiler as well. If you don't have a compiler you can still install a self-installing binary release.

    Download ImageMagick-windows.zip from www.imagemagick.org or a mirrors and verify its message digest.

    @@ -154,21 +154,21 @@ to compile the program and on completion run the program.

    validate
     
    -

    Congratulations, you have a working ImageMagick distribution under Windows and you are ready to use ImageMagick to convert, compose, or edit your images or perhaps you'll want to use one of the Application Program Interfaces for C, C++, Perl, and others.

    +

    Congratulations, you have a working ImageMagick distribution under Windows and you are ready to use ImageMagick to convert, compose, or edit your images or perhaps you'll want to use one of the Application Program Interfaces for C, C++, Perl, and others.

    -

    The above instructions will satisfy a great number of ImageMagick users, but we suspect a few will have additional questions or problems to consider. For example, what does one do if ImageMagick fails to configure or compile? Or what if you want to install ImageMagick in a place other than the ImageMagick-7.0.7/VisualMagick/bin folder? Or perhaps you want to build and install the ImageMagickObject COM+ component. You will find the answer to these questions, and more, in Advanced Windows Source Installation.

    +

    The above instructions will satisfy a great number of ImageMagick users, but we suspect a few will have additional questions or problems to consider. For example, what does one do if ImageMagick fails to configure or compile? Or what if you want to install ImageMagick in a place other than the ImageMagick-7.0.7/VisualMagick/bin folder? Or perhaps you want to build and install the ImageMagickObject COM+ component. You will find the answer to these questions, and more, in Advanced Windows Source Installation.

    ICC RW International Color Consortium color profileAlso known as ICM. To read, use -profile with + Also known as ICM. To read, use -profile with convert.
    IPTC RW IPTC Newsphoto (binary)To read, use -profile with convertTo read, use -profile with convert
    -alpha-alpha on, activate, off, deactivate, set, opaque, copy", transparent, extract, background, or shape the alpha channel
    -antialias-antialias remove pixel-aliasing
    -authenticate value-authenticate value decrypt image with this password
    -channel type-channel type apply option to select image channels
    -clip-clip clip along the first path from the 8BIM profile
    -clip-mask filename-clip-mask filename associate clip mask with the image
    -clip-path id-clip-path id clip along a named path from the 8BIM profile
    -colorspace type-colorspace type set image colorspace
    -crop geometry-crop geometry crop the image
    -debug events-debug events display copious debugging information
    -define format:option-define format:option define one or more image format options
    -density geometry-density geometry horizontal and vertical density of the image
    -depth value-depth value image depth
    -endian type-endian type endianness (MSB or LSB) of the image
    -extract geometry-extract geometry extract area from image
    -features distance-features distance analyze image features (e.g. contract, correlations, etc.).
    -format string-format string output formatted image characteristics
    -gamma value-gamma value level of gamma correction
    -grayscale method-grayscale method convert image to grayscale
    -help-help print program options
    -interlace type-interlace type type of image interlacing scheme
    -interpolate method-interpolate method pixel color interpolation method
    -limit type value-limit type value pixel cache resource limit
    -list type-list type Color, Configure, Delegate, Format, Magic, Module, Resource, or Type
    -log format-log format format of debugging information
    -mask filename-mask filename associate a mask with the image
    -moments-moments display image moments and perceptual hash.
    -monitor-monitor monitor progress
    -negate-negate replace each pixel with its complementary color
    -precision value-precision value set the maximum number of significant digits to be printed
    -quiet-quiet suppress all warning messages
    -regard-warnings-regard-warnings pay attention to warning messages.
    -respect-parentheses-respect-parentheses settings remain in effect until parenthesis boundary.
    -sampling-factor geometry-sampling-factor geometry horizontal and vertical sampling factor
    -set attribute value-set attribute value set an image attribute
    -size geometry-size geometry width and height of image
    -strip-strip strip image of all profiles and comments
    -unique-unique display image the number of unique colors in the image.
    -units type-units type the units of image resolution
    -verbose-verbose print detailed information about the image
    -version-version print version information
    -virtual-pixel method-virtual-pixel method access method for pixels outside the boundaries of the image
    Delineate image features Canny edge detection, Hough lines.
    Noise and color reduction Kuwahara Filter, mean-shift.
    - - - - +

    The format of the IsMagickCoreInstantiated method is:

    - - - - +
    +MagickBooleanType IsMagickCoreInstantiated(void)
    +
    - - - - +

    MagickCoreGenesis

    - - - - +

    MagickCoreGenesis() initializes the MagickCore environment.

    - - - - +

    The format of the MagickCoreGenesis function is:

    - - - - +
    +MagickCoreGenesis(const char *path,
    +  const MagickBooleanType establish_signal_handlers)
    +
    - - - - +

    A description of each parameter follows:

    - - - - +
    +
    - - - - +
    +
    +
    path
    +
    the execution path of the current ImageMagick client.
    -
    - - - +
    +
    establish_signal_handlers
    +
    set to MagickTrue to use MagickCore's own signal handlers for common signals.
    - - - - +
    + +

    MagickCoreTerminus

    - - - - +

    MagickCoreTerminus() destroys the MagickCore environment.

    - - - - +

    The format of the MagickCoreTerminus function is:

    - - - - +
    +MagickCoreTerminus(void)
    +
    - - - - +

    SetMagickPrecision

    - - - - +

    SetMagickPrecision() sets the maximum number of significant digits to be printed.

    - - - - +

    An input argument of 0 returns the current precision setting.

    - - - - +

    A negative value forces the precision to reset to a default value according to the environment variable "MAGICK_PRECISION", the current 'policy' configuration setting, or the default value of '6', in that order.

    - - - - +

    The format of the SetMagickPrecision method is:

    - - - - +
    +int SetMagickPrecision(const int precision)
    +
    - - - - +

    A description of each parameter follows:

    - - - - +
    +
    - - - - +
    +
    +
    precision
    +
    set the maximum number of significant digits to be printed.
    -
    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    -adaptive-blur geometryadaptively blur pixels; decrease effect near edges
    -adaptive-resize geometryadaptively resize image with data dependent triangulation.
    -adaptive-sharpen geometryadaptively sharpen pixels; increase effect near edges
    -adjoinjoin images into a single multi-image file
    -affine matrixaffine transform matrix
    -alphaon, activate, off, deactivate, set, opaque, copy", -transparent, extract, background, or shape the alpha channel
    -annotate geometry textannotate the image with text
    -antialiasremove pixel-aliasing
    -appendappend an image sequence
    -authenticate valuedecipher image with this password
    -auto-gammaautomagically adjust gamma level of image
    -auto-levelautomagically adjust color levels of image
    -auto-orientautomagically orient image
    -background colorbackground color
    -bench iterationsmeasure performance
    -bias valueadd bias when convolving an image
    -black-threshold valueforce all pixels below the threshold into black
    -blue-primary pointchromaticity blue primary point
    -blue-shift factorsimulate a scene at nighttime in the moonlight
    -blur geometryreduce image noise and reduce detail levels
    -border geometrysurround image with a border of color
    -bordercolor colorborder color
    -brightness-contrast geometryimprove brightness / contrast of the image
    -canny geometryuse a multi-stage algorithm to detect a wide range of edges in the image
    -caption stringassign a caption to an image
    -cdl filenamecolor correct with a color decision list
    -channel typeapply option to select image channels
    -charcoal radiussimulate a charcoal drawing
    -chop geometryremove pixels from the image interior
    -clampset each pixel whose value is below zero to zero and any the pixel whose value is above the quantum range to the quantum range (e.g. 65535) otherwise the pixel value remains unchanged.
    -clipclip along the first path from the 8BIM profile
    -clip-mask filenameassociate clip mask with the image
    -clip-path idclip along a named path from the 8BIM profile
    -clone indexclone an image
    -clutapply a color lookup table to the image
    -connected-components connectivityconnected-components uniquely labeled, choose from 4 or 8 way connectivity
    -contrast-stretch geometryimprove the contrast in an image by `stretching' the range of intensity value
    -coalescemerge a sequence of images
    -colorize valuecolorize the image with the fill color
    -color-matrix matrixapply color correction to the image.
    -colors valuepreferred number of colors in the image
    -colorspace typeset image colorspace
    -combinecombine a sequence of images
    -comment stringannotate image with comment
    -comparecompare image
    -complexoperatorperform complex mathematics on an image sequence
    -compose operatorset image composite operator
    -compositecomposite image
    -compress typeimage compression type
    -contrastenhance or reduce the image contrast
    -convolve coefficientsapply a convolution kernel to the image
    -copy geometry offsetcopy pixels from one area of an image to another
    -crop geometrycrop the image
    -cycle amountcycle the image colormap
    -decipher filenameconvert cipher pixels to plain
    -debug eventsdisplay copious debugging information
    -define format:optiondefine one or more image format options
    -deconstructbreak down an image sequence into constituent parts
    -delay valuedisplay the next image after pausing
    -delete indexdelete the image from the image sequence
    -density geometryhorizontal and vertical density of the image
    -depth valueimage depth
    -despecklereduce the speckles within an image
    -direction typerender text right-to-left or left-to-right
    -display serverget image or font from this X server
    -dispose methodlayer disposal method
    -distribute-cache portlaunch a distributed pixel cache server
    -distort type coefficientsdistort image
    -dither methodapply error diffusion to image
    -draw stringannotate the image with a graphic primitive
    -duplicate count,indexesduplicate an image one or more times
    -edge radiusapply a filter to detect edges in the image
    -emboss radiusemboss an image
    -encipher filenameconvert plain pixels to cipher pixels
    -encoding typetext encoding type
    -endian typeendianness (MSB or LSB) of the image
    -enhanceapply a digital filter to enhance a noisy image
    -equalizeperform histogram equalization to an image
    -evaluate operator valueevaluate an arithmetic, relational, or logical expression
    -evaluate-sequence operatorevaluate an arithmetic, relational, or logical expression for an image sequence
    -extent geometryset the image size
    -extract geometryextract area from image
    -family namerender text with this font family
    -features distanceanalyze image features (e.g. contract, correlations, etc.).
    -fftimplements the discrete Fourier transform (DFT)
    -fill colorcolor to use when filling a graphic primitive
    -filter typeuse this filter when resizing an image
    -flattenflatten a sequence of images
    -flipflip image in the vertical direction
    -floodfill geometry colorfloodfill the image with color
    -flopflop image in the horizontal direction
    -font namerender text with this font
    -format stringoutput formatted image characteristics
    -frame geometrysurround image with an ornamental border
    -function nameapply a function to the image
    -fuzz distancecolors within this distance are considered equal
    -fx expressionapply mathematical expression to an image channel(s)
    -gamma valuelevel of gamma correction
    -gaussian-blur geometryreduce image noise and reduce detail levels
    -geometry geometrypreferred size or location of the image
    -gravity typehorizontal and vertical text placement
    -grayscale methodconvert image to grayscale
    -green-primary pointchromaticity green primary point
    -helpprint program options
    -hough-lines geometryidentify lines in the image
    -identifyidentify the format and characteristics of the image
    -iftimplements the inverse discrete Fourier transform (DFT)
    -implode amountimplode image pixels about the center
    -insert indexinsert last image into the image sequence
    -intensity methodmethod to generate an intensity value from a pixel
    -intent typetype of rendering intent when managing the image color
    -interlace typetype of image interlacing scheme
    -interline-spacing valuethe space between two text lines
    -interpolate methodpixel color interpolation method
    -interword-spacing valuethe space between two words
    -kerning valuethe space between two characters
    -kuwahara geometryedge preserving noise reduction filter
    -label stringassign a label to an image
    -lat geometrylocal adaptive thresholding
    -layers methodoptimize or compare image layers
    -level valueadjust the level of image contrast
    -limit type valuepixel cache resource limit
    -linear-stretch geometrylinear with saturation histogram stretch
    -liquid-rescale geometryrescale image with seam-carving
    -list typeColor, Configure, Delegate, Format, Magic, Module, Resource, or Type
    -log formatformat of debugging information
    -loop iterationsadd Netscape loop extension to your GIF animation
    -mask filenameassociate a mask with the image
    -mattecolor colorframe color
    -median radiusapply a median filter to the image
    -mean-shift geometrydelineate arbitrarily shaped clusters in the image
    -metric typemeasure differences between images with this metric
    -mode radiusmake each pixel the 'predominant color' of the neighborhood
    -modulate valuevary the brightness, saturation, and hue
    -momentsdisplay image moments.
    -monitormonitor progress
    -monochrometransform image to black and white
    -morph valuemorph an image sequence
    -morphology method kernelapply a morphology method to the image
    -motion-blur geometrysimulate motion blur
    -negatereplace each pixel with its complementary color
    -noise radiusadd or reduce noise in an image
    -normalizetransform image to span the full range of colors
    -opaque colorchange this color to the fill color
    -ordered-dither NxNordered dither the image
    -orient typeimage orientation
    -page geometrysize and location of an image canvas (setting)
    -paint radiussimulate an oil painting
    -perceptibleset each pixel whose value is less than |epsilon| to -epsilon or epsilon (whichever is closer) otherwise the pixel value remains unchanged.
    -pingefficiently determine image attributes
    -pointsize valuefont point size
    -polaroid anglesimulate a Polaroid picture
    -poly termsbuild a polynomial from the image sequence and the corresponding terms (coefficients and degree pairs).
    -posterize levelsreduce the image to a limited number of color levels
    -precision valueset the maximum number of significant digits to be printed
    -preview typeimage preview type
    -print stringinterpret string and print to console
    -process image-filterprocess the image with a custom image filter
    -profile filenameadd, delete, or apply an image profile
    -quality valueJPEG/MIFF/PNG compression level
    -quantize colorspacereduce image colors in this colorspace
    -quietsuppress all warning messages
    -radial-blur angleradial blur the image
    -raise valuelighten/darken image edges to create a 3-D effect
    -random-threshold low,highrandom threshold the image
    -red-primary pointchromaticity red primary point
    -regard-warningspay attention to warning messages.
    -region geometryapply options to a portion of the image
    -remap filenametransform image colors to match this set of colors
    -renderrender vector graphics
    -repage geometrysize and location of an image canvas
    -resample geometrychange the resolution of an image
    -resize geometryresize the image
    -respect-parenthesessettings remain in effect until parenthesis boundary.
    -roll geometryroll an image vertically or horizontally
    -rotate degreesapply Paeth rotation to the image
    -sample geometryscale image with pixel sampling
    -sampling-factor geometryhorizontal and vertical sampling factor
    -scale geometryscale the image
    -scene valueimage scene number
    -seed valueseed a new sequence of pseudo-random numbers
    -segment valuessegment an image
    -selective-blur geometryselectively blur pixels within a contrast threshold
    -separateseparate an image channel into a grayscale image
    -sepia-tone thresholdsimulate a sepia-toned photo
    -set attribute valueset an image attribute
    -shade degreesshade the image using a distant light source
    -shadow geometrysimulate an image shadow
    -sharpen geometrysharpen the image
    -shave geometryshave pixels from the image edges
    -shear geometryslide one edge of the image along the X or Y axis
    -sigmoidal-contrast geometryincrease the contrast without saturating highlights or shadows
    -smush offsetsmush an image sequence together
    -size geometrywidth and height of image
    -sketch geometrysimulate a pencil sketch
    -solarize thresholdnegate all pixels above the threshold level
    -splice geometrysplice the background color into the image
    -spread radiusdisplace image pixels by a random amount
    -statistic type geometryreplace each pixel with corresponding statistic from the neighborhood
    -stripstrip image of all profiles and comments
    -stroke colorgraphic primitive stroke color
    -strokewidth valuegraphic primitive stroke width
    -stretch typerender text with this font stretch
    -style typerender text with this font style
    -swap indexesswap two images in the image sequence
    -swirl degreesswirl image pixels about the center
    -synchronizesynchronize image to storage device
    -taintmark the image as modified
    -texture filenamename of texture to tile onto the image background
    -threshold valuethreshold the image
    -thumbnail geometrycreate a thumbnail of the image
    -tile filenametile image when filling a graphic primitive
    -tile-offset geometryset the image tile offset
    -tint valuetint the image with the fill color
    -transformaffine transform image
    -transparent colormake this color transparent within the image
    -transparent-color colortransparent color
    -transposeflip image in the vertical direction and rotate 90 degrees
    -transverseflop image in the horizontal direction and rotate 270 degrees
    -treedepth valuecolor tree depth
    -trimtrim image edges
    -type typeimage type
    -undercolor colorannotation bounding box color
    -unique-colorsdiscard all but one of any pixel color.
    -units typethe units of image resolution
    -unsharp geometrysharpen the image
    -verboseprint detailed information about the image
    -versionprint version information
    -viewFlashPix viewing transforms
    -vignette geometrysoften the edges of the image in vignette style
    -virtual-pixel methodaccess method for pixels outside the boundaries of the image
    -wave geometryalter an image along a sine wave
    -wavelet-denoise thresholdremoves noise from the image using a wavelet transform
    -weight typerender text with this font weight
    -white-point pointchromaticity white point
    -white-threshold valueforce all pixels above the threshold into white
    -write filenamewrite images to this file
    -
    +
    +
    -
    -
    +

    MIFF Header • MIFF Binary Data

    @@ -104,7 +104,7 @@ matte-color = color - these optional keys reflect the image background, border, and matte colors respectively. A color can be a name (e.g. white) or a hex value (e.g. #ccc). + these optional keys reflect the image background, border, and matte colors respectively. A color can be a name (e.g. white) or a hex value (e.g. #ccc). class = { DirectClass, PseudoClass } @@ -252,13 +252,13 @@ or fewer colors in the image, each byte of image data contains an index value. I
    -
    -
    +

    ImageMagick source and binary distributions are available from a variety of FTP and Web mirrors around the world listed below. ImageMagick stable and development source releases are also available from Git. Before you download, you may want to review recent changes to the ImageMagick distribution. The authoritative source code repository is http://git.imagemagick.org/repos/ImageMagick.

    @@ -123,13 +123,13 @@
    -
    -
    +
    -

    Example Usage • Option Summary

    +

    MagickCommandGenesis

    -

    Use the mogrify program to resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more. This tool is similar to convert except that the original image file is overwritten (unless you change the file suffix with the -format option) with any changes you request. See Command Line Processing for advice on how to structure your mogrify command or see below for sample usages of the command.

    +

    MagickCommandGenesis

    -

    Example Usage

    +

    MagickCommandGenesis() applies image processing options to an image as prescribed by command line options.

    -

    We list a few examples of the mogrify command here to illustrate its usefulness and ease of use. To get started, let's reduce the size of our -rose:

    +

    It wiil look for special options like "-debug", "-bench", and "-distribute-cache" that needs to be applied even before the main processing begins, and may completely overrule normal command processing. Such 'Genesis' Options can only be given on the CLI, (not in a script) and are typically ignored (as they have been handled) if seen later.

    -
    magick mogrify -resize 50% rose.jpg
    -
    +

    The format of the MagickCommandGenesis method is:

    - +
    +MagickBooleanType MagickCommandGenesis(ImageInfo *image_info,
    +  MagickCommand command,int argc,char **argv,char **metadata,
    +  ExceptionInfo *exception)
    +
    -

    You can resize all your JPEG images in a folder to a maximum dimension of 256x256 with this command:

    +

    A description of each parameter follows:

    -
    magick mogrify -resize 256x256 *.jpg
    -
    +
    +
    -

    Finally, we convert all our PNG images in a folder to the JPEG format:

    +
    +
    +
    image_info
    +
    the image info.
    -
    magick mogrify -format jpg *.png
    -
    +
    +
    command
    +
    Choose from ConvertImageCommand, IdentifyImageCommand, MogrifyImageCommand, CompositeImageCommand, CompareImagesCommand, ConjureImageCommand, StreamImageCommand, ImportImageCommand, DisplayImageCommand, or AnimateImageCommand.
    -

    Here image files 1.png, 2.png, etc., are left untouched and files 1.jpg, 2.jpg, etc., are created. They are copies of their respective PNG images except are stored in the JPEG image format.

    +
    +
    argc
    +
    Specifies a pointer to an integer describing the number of elements in the argument vector.
    +
    +
    argv
    +
    Specifies a pointer to a text array containing the command line arguments.
    -

    You can find additional examples of using mogrify in Graphics from the Command Line. Further discussion is available in More Graphics from the Command Line and Examples of ImageMagick Usage.

    +
    +
    metadata
    +
    any metadata is returned here.
    -

    Option Summary

    - -

    The mogrify command recognizes these options. Click on an option to get more details about how that option works.

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    OptionDescription
    -adaptive-blur geometryadaptively blur pixels; decrease effect near edges
    -adaptive-resize geometryadaptively resize image with data dependent triangulation.
    -adaptive-sharpen geometryadaptively sharpen pixels; increase effect near edges
    -adjoinjoin images into a single multi-image file
    -affine matrixaffine transform matrix
    -alphaon, activate, off, deactivate, set, opaque, copy", -transparent, extract, background, or shape the alpha channel
    -annotate geometry textannotate the image with text
    -antialiasremove pixel-aliasing
    -appendappend an image sequence
    -authenticate valuedecipher image with this password
    -auto-gammaautomagically adjust gamma level of image
    -auto-levelautomagically adjust color levels of image
    -auto-orientautomagically orient image
    -auto-threshold methodautomatically perform image thresholding
    -background colorbackground color
    -bench iterationsmeasure performance
    -bias valueadd bias when convolving an image
    -black-threshold valueforce all pixels below the threshold into black
    -blue-primary pointchromaticity blue primary point
    -blue-shift factorsimulate a scene at nighttime in the moonlight
    -blur geometryreduce image noise and reduce detail levels
    -border geometrysurround image with a border of color
    -bordercolor colorborder color
    -brightness-contrast geometryimprove brightness / contrast of the image
    -canny geometryuse a multi-stage algorithm to detect a wide range of edges in the image
    -caption stringassign a caption to an image
    -cdl filenamecolor correct with a color decision list
    -channel typeapply option to select image channels
    -charcoal radiussimulate a charcoal drawing
    -chop geometryremove pixels from the image interior
    -clipclip along the first path from the 8BIM profile
    -clampset each pixel whose value is below zero to zero and any the pixel whose value is above the quantum range to the quantum range (e.g. 65535) otherwise the pixel value remains unchanged.
    -clip-mask filenameassociate clip mask with the image
    -clip-path idclip along a named path from the 8BIM profile
    -clutapply a color lookup table to the image
    -complexoperatorperform complex mathematics on an image sequence
    -connected-components connectivityconnected-components uniquely labeled, choose from 4 or 8 way connectivity
    -contrast-stretch geometryimprove the contrast in an image by `stretching' the range of intensity value
    -coalescemerge a sequence of images
    -colorize valuecolorize the image with the fill color
    -color-matrix matrixapply color correction to the image.
    -colors valuepreferred number of colors in the image
    -colorspace typeset image colorspace
    -combinecombine a sequence of images
    -comment stringannotate image with comment
    -compose operatorset image composite operator
    -compositecomposite image
    -compress typeimage compression type
    -contrastenhance or reduce the image contrast
    -convolve coefficientsapply a convolution kernel to the image
    -copy geometry offsetcopy pixels from one area of an image to another
    -crop geometrycrop the image
    -cycle amountcycle the image colormap
    -decipher filenameconvert cipher pixels to plain
    -debug eventsdisplay copious debugging information
    -define format:optiondefine one or more image format options
    -deconstructbreak down an image sequence into constituent parts
    -delay valuedisplay the next image after pausing
    -delete indexdelete the image from the image sequence
    -density geometryhorizontal and vertical density of the image
    -depth valueimage depth
    -despecklereduce the speckles within an image
    -direction typerender text right-to-left or left-to-right
    -display serverget image or font from this X server
    -dispose methodlayer disposal method
    -distort type coefficientsdistort image
    -distribute-cache portlaunch a pixel cache server
    -dither methodapply error diffusion to image
    -draw stringannotate the image with a graphic primitive
    -duplicate count,indexesduplicate an image one or more times
    -edge radiusapply a filter to detect edges in the image
    -emboss radiusemboss an image
    -encipher filenameconvert plain pixels to cipher pixels
    -encoding typetext encoding type
    -endian typeendianness (MSB or LSB) of the image
    -enhanceapply a digital filter to enhance a noisy image
    -equalizeperform histogram equalization to an image
    -evaluate operator valueevaluate an arithmetic, relational, or logical expression
    -evaluate-sequence operatorevaluate an arithmetic, relational, or logical expression for an image sequence
    -extent geometryset the image size
    -extract geometryextract area from image
    -family namerender text with this font family
    -features distanceanalyze image features (e.g. contract, correlations, etc.).
    -fftimplements the discrete Fourier transform (DFT)
    -fill colorcolor to use when filling a graphic primitive
    -filter typeuse this filter when resizing an image
    -flattenflatten a sequence of images
    -flipflip image in the vertical direction
    -floodfill geometry colorfloodfill the image with color
    -flopflop image in the horizontal direction
    -font namerender text with this font
    -format typeoutput formatted image characteristics
    -frame geometrysurround image with an ornamental border
    -function nameapply a function to the image
    -fuzz distancecolors within this distance are considered equal
    -fx expressionapply mathematical expression to an image channel(s)
    -gamma valuelevel of gamma correction
    -gaussian-blur geometryreduce image noise and reduce detail levels
    -geometry geometrypreferred size or location of the image
    -gravity typehorizontal and vertical text placement
    -grayscale methodconvert image to grayscale
    -green-primary pointchromaticity green primary point
    -helpprint program options
    -hough-lines geometryidentify lines in the image
    -identifyidentify the format and characteristics of the image
    -ifftimplements the inverse discrete Fourier transform (DFT)
    -implode amountimplode image pixels about the center
    -insert indexinsert last image into the image sequence
    -intensity methodmethod to generate an intensity value from a pixel
    -intent typetype of rendering intent when managing the image color
    -interlace typetype of image interlacing scheme
    -interline-spacing valuethe space between two text lines
    -interpolate methodpixel color interpolation method
    -interword-spacing valuethe space between two words
    -kerning valuethe space between two characters
    -kuwahara geometryedge preserving noise reduction filter
    -label stringassign a label to an image
    -lat geometrylocal adaptive thresholding
    -layers methodoptimize or compare image layers
    -level valueadjust the level of image contrast
    -limit type valuepixel cache resource limit
    -linear-stretch geometrylinear with saturation histogram stretch
    -liquid-rescale geometryrescale image with seam-carving
    -log formatformat of debugging information
    -loop iterationsadd Netscape loop extension to your GIF animation
    -mattecolor colorframe color
    -median radiusapply a median filter to the image
    -mean-shift geometrydelineate arbitrarily shaped clusters in the image
    -metric typemeasure differences between images with this metric
    -mode radiusmake each pixel the 'predominant color' of the neighborhood
    -modulate valuevary the brightness, saturation, and hue
    -monitormonitor progress
    -monochrometransform image to black and white
    -morph valuemorph an image sequence
    -morphology method kernelapply a morphology method to the image
    -motion-blur geometrysimulate motion blur
    -negatereplace each pixel with its complementary color
    -noise radiusadd or reduce noise in an image
    -normalizetransform image to span the full range of colors
    -opaque colorchange this color to the fill color
    -ordered-dither NxNordered dither the image
    -orient typeimage orientation
    -page geometrysize and location of an image canvas (setting)
    -paint radiussimulate an oil painting
    -perceptibleset each pixel whose value is less than |epsilon| to -epsilon or epsilon (whichever is closer) otherwise the pixel value remains unchanged.
    -pingefficiently determine image attributes
    -pointsize valuefont point size
    -polaroid anglesimulate a Polaroid picture
    -poly termsbuild a polynomial from the image sequence and the corresponding terms (coefficients and degree pairs).
    -posterize levelsreduce the image to a limited number of color levels
    -precision valueset the maximum number of significant digits to be printed
    -preview typeimage preview type
    -print stringinterpret string and print to console
    -process image-filterprocess the image with a custom image filter
    -profile filenameadd, delete, or apply an image profile
    -quality valueJPEG/MIFF/PNG compression level
    -quantize colorspacereduce image colors in this colorspace
    -quietsuppress all warning messages
    -radial-blur angleradial blur the image
    -raise valuelighten/darken image edges to create a 3-D effect
    -random-threshold low,highrandom threshold the image
    -read-mask filenameassociate a read mask with the image
    -red-primary pointchromaticity red primary point
    -regard-warningspay attention to warning messages.
    -region geometryapply options to a portion of the image
    -remap filenametransform image colors to match this set of colors
    -renderrender vector graphics
    -repage geometrysize and location of an image canvas
    -resample geometrychange the resolution of an image
    -resize geometryresize the image
    -respect-parenthesessettings remain in effect until parenthesis boundary.
    -roll geometryroll an image vertically or horizontally
    -rotate degreesapply Paeth rotation to the image
    -sample geometryscale image with pixel sampling
    -sampling-factor geometryhorizontal and vertical sampling factor
    -scale geometryscale the image
    -scene valueimage scene number
    -seed valueseed a new sequence of pseudo-random numbers
    -segment valuessegment an image
    -selective-blur geometryselectively blur pixels within a contrast threshold
    -separateseparate an image channel into a grayscale image
    -sepia-tone thresholdsimulate a sepia-toned photo
    -set attribute valueset an image attribute
    -shade degreesshade the image using a distant light source
    -shadow geometrysimulate an image shadow
    -sharpen geometrysharpen the image
    -shave geometryshave pixels from the image edges
    -shear geometryslide one edge of the image along the X or Y axis
    -sigmoidal-contrast geometryincrease the contrast without saturating highlights or shadows
    -size geometrywidth and height of image
    -sketch geometrysimulate a pencil sketch
    -smush offsetsmush an image sequence together
    -solarize thresholdnegate all pixels above the threshold level
    -splice geometrysplice the background color into the image
    -spread radiusdisplace image pixels by a random amount
    -statistic type geometryreplace each pixel with corresponding statistic from the neighborhood
    -stripstrip image of all profiles and comments
    -stroke colorgraphic primitive stroke color
    -strokewidth valuegraphic primitive stroke width
    -stretch typerender text with this font stretch
    -style typerender text with this font style
    -swap indexesswap two images in the image sequence
    -swirl degreesswirl image pixels about the center
    -synchronizesynchronize image to storage device
    -texture filenamename of texture to tile onto the image background
    -threshold valuethreshold the image
    -thumbnail geometrycreate a thumbnail of the image
    -tile filenametile image when filling a graphic primitive
    -tile-offset geometryset the image tile offset
    -tint valuetint the image with the fill color
    -transformaffine transform image
    -transparent colormake this color transparent within the image
    -transparent-color colortransparent color
    -transposeflip image in the vertical direction and rotate 90 degrees
    -transverseflop image in the horizontal direction and rotate 270 degrees
    -treedepth valuecolor tree depth
    -trimtrim image edges
    -type typeimage type
    -undercolor colorannotation bounding box color
    -unique-colorsdiscard all but one of any pixel color.
    -units typethe units of image resolution
    -unsharp geometrysharpen the image
    -verboseprint detailed information about the image
    -versionprint version information
    -viewFlashPix viewing transforms
    -vignette geometrysoften the edges of the image in vignette style
    -virtual-pixel methodaccess method for pixels outside the boundaries of the image
    -wave geometryalter an image along a sine wave
    -wavelet-denoise thresholdremoves noise from the image using a wavelet transform
    -weight typerender text with this font weight
    -white-point pointchromaticity white point
    -white-threshold valueforce all pixels above the threshold into white
    -write filenamewrite images to this file
    -write-mask filenameassociate a write mask with the image
    +
    +
    exception
    +
    return any errors or warnings in this structure.
    +
    +
    -

    Security • - Architecture • - Related • - Sitemap • +

    Security • + Architecture • + Related • + Sitemap • Public Key

    -

    Donate • +

    Donate • Back to top • Contact Us

    © 1999-2018 ImageMagick Studio LLC

    @@ -1324,4 +150,4 @@ transparent, extract, background, or shape the alpha channel - \ No newline at end of file + \ No newline at end of file diff --git a/www/montage.html b/www/montage.html index 2637916a6..55069da06 100644 --- a/www/montage.html +++ b/www/montage.html @@ -5,34 +5,34 @@ - - + + MagickCore, C API: Create an Image Thumbnail @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    Unknown method

    @@ -104,4 +104,4 @@ - \ No newline at end of file + \ No newline at end of file diff --git a/www/motion-picture.html b/www/motion-picture.html index 94f4ce4e2..0f3d9944d 100644 --- a/www/motion-picture.html +++ b/www/motion-picture.html @@ -5,34 +5,34 @@ - - + + Motion Picture Digital Images @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    Log Format • DPX Properties • DPX Settings

    @@ -184,7 +184,7 @@ dpx:user.data

    DPX Settings

    -

    Use -set to specify the image or film gamma or black and white points. For example use: +

    Use -set to specify the image or film gamma or black and white points. For example use:

    -set gamma 1.7
    @@ -215,4 +215,4 @@ dpx:user.data
       
     
     
    -
    \ No newline at end of file
    +
    \ No newline at end of file
    diff --git a/www/opencl.html b/www/opencl.html
    index 5b0823426..56f9c6bef 100644
    --- a/www/opencl.html
    +++ b/www/opencl.html
    @@ -5,34 +5,34 @@
     
     
     
    -  
    -  
    +  
    +  
       Parallel Execution with OpenCL @ ImageMagick
    -  
    -  
    -  
    -  
    -  
    -  
    -  
    -  
    -  
    -  
    -  
    -  
    -  
    -  
    -  
    -  
    -  
    -  
    -  
    -  
    +  
    +  
    +  
    +  
    +  
    +  
    +  
    +  
    +  
    +  
    +  
    +  
    +  
    +  
    +  
    +  
    +  
    +  
    +  
    +  
     
     
       
    -
    +
    @@ -139,4 +139,4 @@ InitImageMagickOpenCL(MAGICK_OPENCL_DEVICE_SELECT_USER, (void*)(myDevices+2), NU - \ No newline at end of file + \ No newline at end of file diff --git a/www/openmp.html b/www/openmp.html index aa095f9af..64a93f110 100644 --- a/www/openmp.html +++ b/www/openmp.html @@ -5,34 +5,34 @@ - - + + Parallel Execution with OpenMP @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +
    @@ -122,4 +122,4 @@ Performance[8]: 40i 4.831ips 0.872e 15.680u 0:02.070 - \ No newline at end of file + \ No newline at end of file diff --git a/www/perl-magick.html b/www/perl-magick.html index 87c3b6ed6..5be5aae7e 100644 --- a/www/perl-magick.html +++ b/www/perl-magick.html @@ -5,34 +5,34 @@ - - + + PerlMagick, Perl API @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    -
    +

    Installation • Overview • Example Script • Read or Write an Image • Manipulate an Image • Set an Image Attribute • Get an Image Attribute • Compare an Image to its Reconstruction • Create an Image Montage • Working with Blobs • Direct-access to Image Pixels • Miscellaneous Methods • Handling Exceptions• Constant

    -

    PerlMagick is an objected-oriented Perl interface to ImageMagick. Use the module to read, manipulate, or write an image or image sequence from within a Perl script. This makes it very suitable for Web CGI scripts. You must have ImageMagick 6.5.5 or above and Perl version 5.005_02 or greater installed on your system for PerlMagick to build properly.

    +

    PerlMagick is an objected-oriented Perl interface to ImageMagick. Use the module to read, manipulate, or write an image or image sequence from within a Perl script. This makes it very suitable for Web CGI scripts. You must have ImageMagick 6.5.5 or above and Perl version 5.005_02 or greater installed on your system for PerlMagick to build properly.

    There are a number of useful scripts available to show you the value of PerlMagick. You can do Web based image manipulation and conversion with MagickStudio, or use L-systems to create images of plants using mathematical constructs, and finally navigate through collections of thumbnail images and select the image to view with the WebMagick Image Navigator.

    -

    You can try PerlMagick from your Web browser at the ImageMagick Studio. Or, you can see examples of select PerlMagick functions.

    +

    You can try PerlMagick from your Web browser at the ImageMagick Studio. Or, you can see examples of select PerlMagick functions.

    Installation

    @@ -129,7 +129,7 @@

    Windows XP / Windows 2000

    -

    ImageMagick must already be installed on your system. Also, the ImageMagick source distribution for Windows 2000 is required. You must also have the nmake from the Visual C++ or J++ development environment. Copy \bin\IMagick.dll and \bin\X11.dll to a directory in your dynamic load path such as c:\perl\site\5.00502.

    +

    ImageMagick must already be installed on your system. Also, the ImageMagick source distribution for Windows 2000 is required. You must also have the nmake from the Visual C++ or J++ development environment. Copy \bin\IMagick.dll and \bin\X11.dll to a directory in your dynamic load path such as c:\perl\site\5.00502.

    Next, type

    @@ -371,7 +371,7 @@ close(IMAGE);

    Manipulate an Image

    -

    Once you create an image with, for example, method ReadImage() you may want to operate on it. Below is a list of all the image manipulations methods available to you with PerlMagick. There are examples of select PerlMagick methods. Here is an example call to an image manipulation method:

    +

    Once you create an image with, for example, method ReadImage() you may want to operate on it. Below is a list of all the image manipulations methods available to you with PerlMagick. There are examples of select PerlMagick methods. Here is an example call to an image manipulation method:

    $image->Crop(geometry=>'100x100+10+20');
     $image->[$x]->Frame("100x200");
    @@ -420,7 +420,7 @@ $image->[$x]->Frame("100x200");
     
       
         AffineTransform
    -    affine=>array of float values, translate=>float, float, scale=> float, float, rotate=>float, skewX=>float, skewY=>float, interpolate={Average, Bicubic, Bilinear, Filter, Integer, Mesh, NearestNeighbor}, background=>color name
    +    affine=>array of float values, translate=>float, float, scale=> float, float, rotate=>float, skewX=>float, skewY=>float, interpolate={Average, Bicubic, Bilinear, Filter, Integer, Mesh, NearestNeighbor}, background=>color name
         affine transform image
       
     
    @@ -432,7 +432,7 @@ $image->[$x]->Frame("100x200");
     
       
         Annotate
    -    text=>string, font=>string, family=>string, style=>{Normal, Italic, Oblique, Any}, stretch=>{Normal, UltraCondensed, ExtraCondensed, Condensed, SemiCondensed, SemiExpanded, Expanded, ExtraExpanded, UltraExpanded}, weight=>integer, pointsize=>integer, density=>geometry, stroke=>color name, strokewidth=>integer, fill=>color name, undercolor=>color name, kerning=>float, geometry=>geometry, gravity=>{NorthWest, North, NorthEast, West, Center, East, SouthWest, South, SouthEast}, antialias=>{true, false}, x=>integer, y=>integer, affine=>array of float values, translate=>float, float, scale=>float, float, rotate=>float. skewX=>float, skewY=> float, align=>{Left, Center, Right}, encoding=>{UTF-8}, interline-spacing=>double, interword-spacing=>double, direction=>{right-to-left, left-to-right}
    +    text=>string, font=>string, family=>string, style=>{Normal, Italic, Oblique, Any}, stretch=>{Normal, UltraCondensed, ExtraCondensed, Condensed, SemiCondensed, SemiExpanded, Expanded, ExtraExpanded, UltraExpanded}, weight=>integer, pointsize=>integer, density=>geometry, stroke=>color name, strokewidth=>integer, fill=>color name, undercolor=>color name, kerning=>float, geometry=>geometry, gravity=>{NorthWest, North, NorthEast, West, Center, East, SouthWest, South, SouthEast}, antialias=>{true, false}, x=>integer, y=>integer, affine=>array of float values, translate=>float, float, scale=>float, float, rotate=>float. skewX=>float, skewY=> float, align=>{Left, Center, Right}, encoding=>{UTF-8}, interline-spacing=>double, interword-spacing=>double, direction=>{right-to-left, left-to-right}
         annotate an image with text. See QueryFontMetrics to get font metrics without rendering any text.
       
     
    @@ -480,7 +480,7 @@ $image->[$x]->Frame("100x200");
     
       
         Border
    -    geometry=>geometry, width=>integer, height=>integer, bordercolor=>color name,  compose=>{Undefined, Add, Atop, Blend, Bumpmap, Clear, ColorBurn, ColorDodge, Colorize, CopyBlack, CopyBlue, CopyCMYK, Cyan, CopyGreen, Copy, CopyMagenta, CopyAlpha, CopyRed, RGB, CopyYellow, Darken, Dst, Difference, Displace, Dissolve, DstAtop, DstIn, DstOut, DstOver, Dst, Exclusion, HardLight, Hue, In, Lighten, Luminize, Minus, Modulate, Multiply, None, Out, Overlay, Over, Plus, ReplaceCompositeOp, Saturate, Screen, SoftLight, Src, SrcAtop, SrcIn, SrcOut, SrcOver, Src, Subtract, Threshold, Xor },
    +    geometry=>geometry, width=>integer, height=>integer, bordercolor=>color name,  compose=>{Undefined, Add, Atop, Blend, Bumpmap, Clear, ColorBurn, ColorDodge, Colorize, CopyBlack, CopyBlue, CopyCMYK, Cyan, CopyGreen, Copy, CopyMagenta, CopyAlpha, CopyRed, RGB, CopyYellow, Darken, Dst, Difference, Displace, Dissolve, DstAtop, DstIn, DstOut, DstOver, Dst, Exclusion, HardLight, Hue, In, Lighten, Luminize, Minus, Modulate, Multiply, None, Out, Overlay, Over, Plus, ReplaceCompositeOp, Saturate, Screen, SoftLight, Src, SrcAtop, SrcIn, SrcOut, SrcOver, Src, Subtract, Threshold, Xor },
         surround the image with a border of color
       
     
    @@ -534,7 +534,7 @@ $image->[$x]->Frame("100x200");
     
       
         Color
    -    color=>color name
    +    color=>color name
         set the entire image to this color.
       
     
    @@ -546,7 +546,7 @@ $image->[$x]->Frame("100x200");
     
       
         Colorize
    -    fill=>color name, blend=>string
    +    fill=>color name, blend=>string
         colorize the image with the fill color
       
     
    @@ -576,7 +576,7 @@ $image->[$x]->Frame("100x200");
     
       
         Composite
    -    image=>image-handle, compose=>{Undefined, Add, Atop, Blend, Bumpmap, Clear, ColorBurn, ColorDodge, Colorize, CopyBlack, CopyBlue, CopyCMYK, Cyan, CopyGreen, Copy, CopyMagenta, CopyAlpha, CopyRed, RGB, CopyYellow, Darken, Dst, Difference, Displace, Dissolve, DstAtop, DstIn, DstOut, DstOver, Dst, Exclusion, HardLight, Hue, In, Lighten, Luminize, Minus, Modulate, Multiply, None, Out, Overlay, Over, Plus, ReplaceCompositeOp, Saturate, Screen, SoftLight, Src, SrcAtop, SrcIn, SrcOut, SrcOver, Src, Subtract, Threshold, Xor }, mask=>image-handle, geometry=>geometry, x=>integer, y=>integer, gravity=>{NorthWest, North, NorthEast, West, Center, East, SouthWest, South, SouthEast}, opacity=>integer, tile=>{True, False}, rotate=>double, color=>color name, blend=>geometry, interpolate=>{undefined, average, bicubic, bilinear, filter, integer, mesh, nearest-neighbor, spline}
    +    image=>image-handle, compose=>{Undefined, Add, Atop, Blend, Bumpmap, Clear, ColorBurn, ColorDodge, Colorize, CopyBlack, CopyBlue, CopyCMYK, Cyan, CopyGreen, Copy, CopyMagenta, CopyAlpha, CopyRed, RGB, CopyYellow, Darken, Dst, Difference, Displace, Dissolve, DstAtop, DstIn, DstOut, DstOver, Dst, Exclusion, HardLight, Hue, In, Lighten, Luminize, Minus, Modulate, Multiply, None, Out, Overlay, Over, Plus, ReplaceCompositeOp, Saturate, Screen, SoftLight, Src, SrcAtop, SrcIn, SrcOut, SrcOver, Src, Subtract, Threshold, Xor }, mask=>image-handle, geometry=>geometry, x=>integer, y=>integer, gravity=>{NorthWest, North, NorthEast, West, Center, East, SouthWest, South, SouthEast}, opacity=>integer, tile=>{True, False}, rotate=>double, color=>color name, blend=>geometry, interpolate=>{undefined, average, bicubic, bilinear, filter, integer, mesh, nearest-neighbor, spline}
         composite one image onto another.  Use the rotate parameter in concert with the tile parameter.
       
     
    @@ -660,7 +660,7 @@ $image->[$x]->Frame("100x200");
     
       
         Draw
    -    primitive=>{point, line, rectangle, arc, ellipse, circle, path, polyline, polygon, bezier, color, matte, text, @filename}, points=>string , method=>{Point, Replace, Floodfill, FillToBorder, Reset}, stroke=>color name, fill=>color name, font=>string, pointsize=>integer, strokewidth=>float, antialias=>{true, false}, bordercolor=>color name, x=>float, y=>float, dash-offset=>float, dash-pattern=>array of float values, affine=>array of float values, translate=>float, float, scale=>float, float, rotate=>float,  skewX=>float, skewY=>float, interpolate=>{undefined, average, bicubic, bilinear, mesh, nearest-neighbor, spline}, kerning=>float, text=>string, vector-graphics=>string, interline-spacing=>double, interword-spacing=>double, direction=>{right-to-left, left-to-right}
    +    primitive=>{point, line, rectangle, arc, ellipse, circle, path, polyline, polygon, bezier, color, matte, text, @filename}, points=>string , method=>{Point, Replace, Floodfill, FillToBorder, Reset}, stroke=>color name, fill=>color name, font=>string, pointsize=>integer, strokewidth=>float, antialias=>{true, false}, bordercolor=>color name, x=>float, y=>float, dash-offset=>float, dash-pattern=>array of float values, affine=>array of float values, translate=>float, float, scale=>float, float, rotate=>float,  skewX=>float, skewY=>float, interpolate=>{undefined, average, bicubic, bilinear, mesh, nearest-neighbor, spline}, kerning=>float, text=>string, vector-graphics=>string, interline-spacing=>double, interword-spacing=>double, direction=>{right-to-left, left-to-right}
         annotate an image with one or more graphic primitives.
       
     
    @@ -696,7 +696,7 @@ $image->[$x]->Frame("100x200");
     
       
         Extent
    -    geometry=>geometry, width=>integer, height=>integer, x=>integer, y=>integer, fuzz=>double, background=>color name, gravity=>{NorthWest, North, NorthEast, West, Center, East, SouthWest, South, SouthEast}
    +    geometry=>geometry, width=>integer, height=>integer, x=>integer, y=>integer, fuzz=>double, background=>color name, gravity=>{NorthWest, North, NorthEast, West, Center, East, SouthWest, South, SouthEast}
         set the image size
       
     
    @@ -726,7 +726,7 @@ $image->[$x]->Frame("100x200");
     
       
         FloodfillPaint
    -    geometry=>geometry, channel=>{All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Alpha, Red, RGB, Yellow}, x=>integer, y=>integer , fill=>color name, bordercolor=>color name, fuzz=>double, invert=>{True, False}
    +    geometry=>geometry, channel=>{All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Alpha, Red, RGB, Yellow}, x=>integer, y=>integer , fill=>color name, bordercolor=>color name, fuzz=>double, invert=>{True, False}
         changes the color value of any pixel that matches the color of the target pixel and is a neighbor. If you specify a border color, the color value is changed for any neighbor pixel that is not that color.
       
     
    @@ -738,7 +738,7 @@ $image->[$x]->Frame("100x200");
     
       
         Frame
    -    geometry=>geometry, width=>integer, height=>integer, inner=>integer, outer=>integer, fill=>color name,  compose=>{Undefined, Add, Atop, Blend, Bumpmap, Clear, ColorBurn, ColorDodge, Colorize, CopyBlack, CopyBlue, CopyCMYK, Cyan, CopyGreen, Copy, CopyMagenta, CopyAlpha, CopyRed, RGB, CopyYellow, Darken, Dst, Difference, Displace, Dissolve, DstAtop, DstIn, DstOut, DstOver, Dst, Exclusion, HardLight, Hue, In, Lighten, Luminize, Minus, Modulate, Multiply, None, Out, Overlay, Over, Plus, ReplaceCompositeOp, Saturate, Screen, SoftLight, Src, SrcAtop, SrcIn, SrcOut, SrcOver, Src, Subtract, Threshold, Xor },
    +    geometry=>geometry, width=>integer, height=>integer, inner=>integer, outer=>integer, fill=>color name,  compose=>{Undefined, Add, Atop, Blend, Bumpmap, Clear, ColorBurn, ColorDodge, Colorize, CopyBlack, CopyBlue, CopyCMYK, Cyan, CopyGreen, Copy, CopyMagenta, CopyAlpha, CopyRed, RGB, CopyYellow, Darken, Dst, Difference, Displace, Dissolve, DstAtop, DstIn, DstOut, DstOver, Dst, Exclusion, HardLight, Hue, In, Lighten, Luminize, Minus, Modulate, Multiply, None, Out, Overlay, Over, Plus, ReplaceCompositeOp, Saturate, Screen, SoftLight, Src, SrcAtop, SrcIn, SrcOut, SrcOver, Src, Subtract, Threshold, Xor },
         surround the image with an ornamental border
       
     
    @@ -864,7 +864,7 @@ $image->[$x]->Frame("100x200");
     
       
         MatteFloodfill
    -    geometry=>geometry, x=>integer, y=>integer , matte=>integer, bordercolor=>color name, fuzz=>double, invert=>{True, False}
    +    geometry=>geometry, x=>integer, y=>integer , matte=>integer, bordercolor=>color name, fuzz=>double, invert=>{True, False}
         changes the matte value of any pixel that matches the color of the target pixel and is a neighbor. If you specify a border color, the matte value is changed for any neighbor pixel that is not that color.
       
     
    @@ -930,8 +930,8 @@ $image->[$x]->Frame("100x200");
     
       
         Opaque
    -    color=>color name,
    -fill=>color name, channel=>{All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Alpha, Red, RGB, Yellow}, invert=>{True, False}
    +    color=>color name,
    +fill=>color name, channel=>{All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Alpha, Red, RGB, Yellow}, invert=>{True, False}
         change this color to the fill color within the image
       
     
    @@ -949,7 +949,7 @@ fill=>color name, channel=>{All, De
     
       
         Polaroid
    -    caption=>string, angle=>double, pointsize=>double, font=>string, stroke=> color name, strokewidth=>integer, fill=>color name, gravity=>{NorthWest, North, NorthEast, West, Center, East, SouthWest, South, SouthEast},  background=>color name
    +    caption=>string, angle=>double, pointsize=>double, font=>string, stroke=> color name, strokewidth=>integer, fill=>color name, gravity=>{NorthWest, North, NorthEast, West, Center, East, SouthWest, South, SouthEast},  background=>color name
         simulate a Polaroid picture.
       
     
    @@ -1009,7 +1009,7 @@ fill=>color name, channel=>{All, De
     
       
         Rotate
    -    degrees=>double, background=>color name
    +    degrees=>double, background=>color name
         rotate an image
       
     
    @@ -1080,7 +1080,7 @@ fill=>color name, channel=>{All, De
     
       
         Shear
    -    geometry=>geometry, x=>double, y=>double fill=>color name
    +    geometry=>geometry, x=>double, y=>double fill=>color name
         shear the image along the X or Y axis by a positive or negative shear angle
       
     
    @@ -1116,7 +1116,7 @@ fill=>color name, channel=>{All, De
     
       
         Splice
    -    geometry=>geometry, width=>integer, height=>integer, x=>integer, y=>integer, fuzz=>double, background=>color name, gravity=>{NorthWest, North, NorthEast, West, Center, East, SouthWest, South, SouthEast}
    +    geometry=>geometry, width=>integer, height=>integer, x=>integer, y=>integer, fuzz=>double, background=>color name, gravity=>{NorthWest, North, NorthEast, West, Center, East, SouthWest, South, SouthEast}
         splice an image
       
     
    @@ -1175,13 +1175,13 @@ fill=>color name, channel=>{All, De
     
       
         Tint
    -    fill=>color name, blend=>string
    +    fill=>color name, blend=>string
         tint the image with the fill color.
       
     
       
         Transparent
    -    color=>color name, invert=>{True, False}
    +    color=>color name, invert=>{True, False}
         make this color transparent within the image
       
     
    @@ -1211,7 +1211,7 @@ fill=>color name, channel=>{All, De
     
       
         Vignette
    -    geometry=>geometry, radius=>double, sigma=>double, x=>integer, y=>integer, background=>color name
    +    geometry=>geometry, radius=>double, sigma=>double, x=>integer, y=>integer, background=>color name
         offset the edges of the image in vignette style
       
     
    @@ -1304,7 +1304,7 @@ rectangle 60, 60 300, 300
     
     

    You can optionally add Image to any method name. For example, TrimImage() is an alias for method Trim().

    -

    Most of the attributes listed above have an analog in convert. See the documentation for a more detailed description of these attributes.

    +

    Most of the attributes listed above have an analog in convert. See the documentation for a more detailed description of these attributes.

    Set an Image Attribute

    @@ -1369,7 +1369,7 @@ can use the integers 1 and 0.

    background - color name + color name image background color @@ -1381,7 +1381,7 @@ can use the integers 1 and 0.

    bordercolor - color name + color name set the image border color @@ -1393,7 +1393,7 @@ can use the integers 1 and 0.

    colormap[i] - color name + color name color name (e.g. red) or hex value (e.g. #ccc) at position i @@ -1574,7 +1574,7 @@ can use the integers 1 and 0.

    mattecolor - color name + color name set the image matte color @@ -1717,7 +1717,7 @@ can use the integers 1 and 0.

    SetAttribute() is an alias for method Set().

    Most of the attributes listed above have an analog in -convert. See the documentation for a more detailed description of these attributes.

    +convert. See the documentation for a more detailed description of these attributes.

    Get an Image Attribute

    @@ -1944,7 +1944,7 @@ $width = $image->[3]->Get('columns'); transparent-color - color name + color name set the image transparent color @@ -1989,7 +1989,7 @@ $width = $image->[3]->Get('columns');

    GetAttribute() is an alias for method Get().

    Most of the attributes listed above have an analog in -convert. See the documentation for a more detailed description of these attributes.

    +convert. See the documentation for a more detailed description of these attributes.

    Compare an Image to its Reconstruction

    @@ -2066,7 +2066,7 @@ $difference->Display(); background - color name + color name background color name @@ -2084,7 +2084,7 @@ $difference->Display(); fill - color name + color name fill color for annotations @@ -2140,7 +2140,7 @@ South, SouthEast stroke - color name + color name stroke color for annotations @@ -2174,13 +2174,13 @@ South, SouthEast

    MontageImage() is an alias for method Montage().

    -

    Most of the attributes listed above have an analog in montage. See the documentation for a more detailed description of these attributes.

    +

    Most of the attributes listed above have an analog in montage. See the documentation for a more detailed description of these attributes.

    Working with Blobs

    A blob contains data that directly represent a particular image format in memory instead of on disk. PerlMagick supports -blobs in any of these image formats and provides methods to convert a blob to or from a particular image format.

    +blobs in any of these image formats and provides methods to convert a blob to or from a particular image format.

    @@ -2325,7 +2325,7 @@ $p->Write('fx.miff');

    replaces the red channel with the average of the green and blue channels.

    -

    See FX, The Special Effects Image Operator for a detailed discussion of this method.

    +

    See FX, The Special Effects Image Operator for a detailed discussion of this method.

    Histogram() returns the unique colors in the image and a count for each one. The returned values are an array of red, green, blue, opacity, and count values.

    @@ -2483,7 +2483,7 @@ print $1; # print the error number
    Error 400: Memory allocation failed
     
    -

    Review the complete list of error and warning codes.

    +

    Review the complete list of error and warning codes.

    The following illustrates how you can use a numeric status code:

    @@ -2549,13 +2549,13 @@ XServerWarning
    -

    Security • - Architecture • - Related • - Sitemap • +

    Security • + Architecture • + Related • + Sitemap • Public Key

    -

    Donate • +

    Donate • Back to top • Contact Us

    © 1999-2018 ImageMagick Studio LLC

    @@ -2566,4 +2566,4 @@ XServerWarning - \ No newline at end of file + \ No newline at end of file diff --git a/www/porting.html b/www/porting.html index 6264e71b2..214ac9f43 100644 --- a/www/porting.html +++ b/www/porting.html @@ -5,34 +5,34 @@ - - + + Porting to ImageMagick Version 7 @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +
    @@ -669,4 +669,4 @@ example "+annotate", "+resize", "+clut", and "+draw" .

    - \ No newline at end of file + \ No newline at end of file diff --git a/www/quantize.html b/www/quantize.html index e004b1d66..fa34a5f08 100644 --- a/www/quantize.html +++ b/www/quantize.html @@ -5,34 +5,34 @@ - - + + Color Reduction Utilizing Adaptive Spatial Subdivision @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    Algorithm Description • Measuring Color Reduction Error

    @@ -185,7 +185,7 @@ while number of nodes with (n2 > 0) > required maximum number of colors

    The normalized error measurement can be used to compare images. In general, the closer the mean error is to zero the more the quantized image resembles the source image. Ideally, the error should be perceptually-based, since the human eye is the final judge of quantization quality.

    -

    These errors are measured and printed when the -colors and -verbose options are specified on the convert command line:

    +

    These errors are measured and printed when the -colors and -verbose options are specified on the convert command line:

    Blob Methods
    @@ -215,7 +215,7 @@ while number of nodes with (n2 > 0) > required maximum number of colors

    Donate • Back to top • - Contact Us

    + Contact Us

    © 1999-2018 ImageMagick Studio LLC

    @@ -224,3 +224,4 @@ while number of nodes with (n2 > 0) > required maximum number of colors + \ No newline at end of file diff --git a/www/resources.html b/www/resources.html index b6405199c..798e7be77 100644 --- a/www/resources.html +++ b/www/resources.html @@ -5,34 +5,34 @@ - - + + Resources @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    Configuration Files • Modules • Fonts • Environment Variables

    @@ -281,7 +281,7 @@ $MAGICK_FONT_PATH
    - + @@ -293,7 +293,7 @@ $MAGICK_FONT_PATH - + @@ -388,4 +388,4 @@ $MAGICK_FONT_PATH - \ No newline at end of file + \ No newline at end of file diff --git a/www/search.html b/www/search.html index 1ff895a6b..fd024f314 100644 --- a/www/search.html +++ b/www/search.html @@ -5,34 +5,34 @@ - - + + Search @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    -
    +

    @@ -120,13 +120,13 @@
    -

    Security • - Architecture • - Related • - Sitemap • +

    Security • + Architecture • + Related • + Sitemap • Public Key

    -

    Donate • +

    Donate • Back to top • Contact Us

    © 1999-2018 ImageMagick Studio LLC

    diff --git a/www/security-policy.html b/www/security-policy.html index 83eac5fba..fff7d3cf8 100644 --- a/www/security-policy.html +++ b/www/security-policy.html @@ -5,34 +5,34 @@ - - + + Security Policy @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    Security Policy • Pixel Cache Synchronize Policy • Zero Configuration Security Policy • Other Security Considerations

    @@ -239,4 +239,4 @@ Path: [built-in] - \ No newline at end of file + \ No newline at end of file diff --git a/www/sitemap.html b/www/sitemap.html index 823198966..30bb3d768 100644 --- a/www/sitemap.html +++ b/www/sitemap.html @@ -5,34 +5,34 @@ - - + + Sitemap @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    ImageMagick Overview • Download ImageMagick • Install ImageMagick • Command-line Tools • Program Interfaces • Image Formats • Getting Help • Support ImageMagick • Miscellaneous Topics

    @@ -97,10 +97,10 @@
  • Parallel execution: ImageMagick is threaded to take advantage of speed-ups offered by the multicore processor chips.
  • Security policy: best practices strongly encourages you to configure a security policy that suits your local environment.
  • Architecture: get to know more about the software and algorithms behind ImageMagick.
  • -
  • License: the legally binding and authoritative terms and conditions for use, reproduction, and distribution of ImageMagick.
  • -
  • Export classification: export control status of ImageMagick.
  • +
  • License: the legally binding and authoritative terms and conditions for use, reproduction, and distribution of ImageMagick.
  • +
  • Export classification: export control status of ImageMagick.
  • ImageMagick version 7: learn how ImageMagick version 7 differs from previous versions.
  • -
  • History: how ImageMagick was conceived and developed.
  • +
  • History: how ImageMagick was conceived and developed.
  • Download ImageMagick

    @@ -121,29 +121,29 @@

    You can install ImageMagick from source. However, if you don't have a proper development environment or if you're anxious to get started, download a ready-to-run Unix or Windows executable.

    -
  • Install from source: ImageMagick builds under Windows, Mac OS X, and Linux.
  • +
  • Install from source: ImageMagick builds under Windows, Mac OS X, and Linux.
  • Install from a binary distribution: install a ready-to-run Unix or Windows executable.
  • -
  • Install ImageMagickObject COM+ component: install the Windows ImageMagick COM+ component.
  • +
  • Install ImageMagickObject COM+ component: install the Windows ImageMagick COM+ component.
  • Command-line Tools

  • Command-line tools: overview of the ImageMagick commands.
  • -
  • animate: animates an image sequence on any X server.
  • -
  • compare: mathematically and visually annotate the difference between an image and its reconstruction.
  • +
  • animate: animates an image sequence on any X server.
  • +
  • compare: mathematically and visually annotate the difference between an image and its reconstruction.
  • composite: overlaps one image over another.
  • -
  • conjure: interprets and executes scripts written in the Magick Scripting Language (MSL).
  • +
  • conjure: interprets and executes scripts written in the Magick Scripting Language (MSL).
  • convert: convert between image formats as well as resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and more.
  • -
  • display: displays an image or image sequence on any X server.
  • +
  • display: displays an image or image sequence on any X server.
  • identify: describes the format and characteristics of one or more image files.
  • -
  • import: saves any visible window on an X server and outputs it as an image file.
  • -
  • mogrify: resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and more.
  • +
  • import: saves any visible window on an X server and outputs it as an image file.
  • +
  • mogrify: resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and more.
  • montage: create a composite image by combining several separate images.
  • -
  • stream: a lightweight tool to stream one or more pixel components of the image or portion of the image to your choice of storage formats.
  • +
  • stream: a lightweight tool to stream one or more pixel components of the image or portion of the image to your choice of storage formats.
  • Command line processing: the anatomy of the command line.
  • -
  • Command line options: annotated list of all options that can appear on the command-line.
  • +
  • Command line options: annotated list of all options that can appear on the command-line.
  • Fx: apply a mathematical expression to an image or image channels.
  • Fred's ImageMagick Scripts: a plethora of command-line scripts that perform geometric transforms, blurs, sharpens, edging, noise removal, and color manipulations.
  • @@ -160,12 +160,12 @@
  • Magick++: provides an object-oriented C++ interface to ImageMagick.
  • IMagick: is a native PHP extension to create and modify images using the ImageMagick API.
  • JMagick: provides an object-oriented Java interface to ImageMagick.
  • -
  • MagickCore: C API, recommended for wizard-level developers.
  • -
  • MagickWand: convert, compose, and edit images from the C language.
  • +
  • MagickCore: C API, recommended for wizard-level developers.
  • +
  • MagickWand: convert, compose, and edit images from the C language.
  • MagickWand for PHP: a native PHP-extension to the ImageMagick MagickWand API.
  • nMagick: is a port of the ImageMagick library to the haXe and Neko platforms.
  • PascalMagick: a Pascal binding for the MagickWand API and also the low-level MagickCore library.
  • -
  • PerlMagick: convert, compose, and edit images from the Perl language.
  • +
  • PerlMagick: convert, compose, and edit images from the Perl language.
  • PythonMagick: an object-oriented Python interface to ImageMagick.
  • RMagick: is an interface between the Ruby programming language and ImageMagick.
  • TclMagick: a native Tcl-extension to the ImageMagick MagickWand API.
  • @@ -177,8 +177,8 @@
  • Supported image formats: annotated list of all image formats that ImageMagick can read and/or write.
  • Motion picture digital images: use SMPTE DPX Version 2.0 to process images used by the motion picture (film and high-definition) industry.
  • High dynamic-range images: accurately represent the wide range of intensity levels found in real scenes ranging from the brightest direct sunlight to the deepest darkest shadows.
  • -
  • Magick Vector Graphics: a modularized language for describing two-dimensional vector and mixed vector/raster graphics in ImageMagick.
  • -
  • Magick Image File Format: MIFF is ImageMagick's own platform-independent format for storing bitmap images.
  • +
  • Magick Vector Graphics: a modularized language for describing two-dimensional vector and mixed vector/raster graphics in ImageMagick.
  • +
  • Magick Image File Format: MIFF is ImageMagick's own platform-independent format for storing bitmap images.
  • Getting Help

    @@ -212,8 +212,8 @@
  • Distributed pixel cache: offload intermediate pixel storage to one or more remote servers .
  • Draw: add shapes or text to an image.
  • Encipher or decipher an image: convert ordinary images into unintelddgible gibberish and back again.
  • -
  • Escapes: utilize percent escapes in a number of options, for example in -format or in montage Escapes: utilize percent escapes in a number of options, for example in -format or in montage -label, to print various properties and other settings associated with an image.
  • Format conversion: convert an image from one format to another (e.g. PNG to JPEG).
  • @@ -262,4 +262,4 @@ - \ No newline at end of file + \ No newline at end of file diff --git a/www/stream.html b/www/stream.html index 2feb7fd55..99b955e41 100644 --- a/www/stream.html +++ b/www/stream.html @@ -5,34 +5,34 @@ - - - Command-line Tools: Stream @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + MagickCore, C API: The Pixel FIFO @ ImageMagick + + + + + + + + + + + + + + + + + + + +
    -
    -
    +
    -

    Example Usage • Option Summary

    +

    StreamImageCommand

    -

    Stream is a lightweight tool to stream one or more pixel components of the image or portion of the image to your choice of storage formats. It writes the pixel components as they are read from the input image a row at a time making stream desirable when working with large images or when you require raw pixel components.

    +

    StreamImageCommand

    -

    Example Usage

    +

    StreamImageCommand() is a lightweight method designed to extract pixels from large image files to a raw format using a minimum of system resources. The entire image or any regular portion of the image can be extracted.

    -

    We list a few examples of the stream command here to illustrate its usefulness and ease of use. To get started, lets stream the red, green, blue components of a 640x480 JPEG image to disk as unsigned characters:

    +

    The format of the StreamImageCommand method is:

    -
    magick stream -map rgb -storage-type char image.jpg pixels.dat
    -magick display -depth 8 -size 640x480 rgb:pixels.dat
    -
    +
    +MagickBooleanType StreamImageCommand(ImageInfo *image_info,int argc,
    +  char **argv,char **metadata,ExceptionInfo *exception)
    +
    -

    Here we extract a 100x100 region from a TIFF image in the grayscale format as doubles:

    +

    A description of each parameter follows:

    -
    magick stream -map i -storage-type double -extract 100x100+30+40 image.tif gray.raw
    -
    +
    +
    -

    You can also associate the region to extract with the image filename:

    +
    +
    +
    image_info
    +
    the image info.
    -
    magick stream -map i -storage-type double 'image.tif[100x100+30+40]' gray.raw
    -
    +
    +
    argc
    +
    the number of elements in the argument vector.
    +
    +
    argv
    +
    A text array containing the command line arguments.
    -

    Option Summary

    +
    +
    metadata
    +
    any metadata is returned here.
    -

    The stream command recognizes these options. Click on an option to get more details about how that option works.

    - -
    MAGICK_CODER_FILTER_PATHSet search path to use when searching for filter process modules (invoked via -process). This path permits the user to extend ImageMagick's image processing functionality by adding loadable modules to a preferred location rather than copying them into the ImageMagick installation directory. The formatting of the search path is similar to operating system search paths (i.e. colon delimited for Unix, and semi-colon delimited for Microsoft Windows). This user specified search path is searched before trying the default search path.Set search path to use when searching for filter process modules (invoked via -process). This path permits the user to extend ImageMagick's image processing functionality by adding loadable modules to a preferred location rather than copying them into the ImageMagick installation directory. The formatting of the search path is similar to operating system search paths (i.e. colon delimited for Unix, and semi-colon delimited for Microsoft Windows). This user specified search path is searched before trying the default search path.
    MAGICK_CODER_MODULE_PATH
    MAGICK_DEBUGSet debug options. See -debug for a description of debugging options.Set debug options. See -debug for a description of debugging options.
    MAGICK_DISK_LIMIT
    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    OptionDescription
    -authenticate valuedecrypt image with this password
    -channel typeapply option to select image channels
    -colorspace typeset image colorspace
    -debug eventsdisplay copious debugging information
    -define format:optiondefine one or more image format options
    -density geometryhorizontal and vertical density of the image
    -depth valueimage depth
    -extract geometryextract area from image
    -helpprint program options
    -interlace typetype of image interlacing scheme
    -interpolate methodpixel color interpolation method
    -limit type valuepixel cache resource limit
    -list typeColor, Configure, Delegate, Format, Magic, Module, Resource, or Type
    -log formatformat of debugging information
    -map componentsstore pixels in this format.
    -monitormonitor progress
    -quantize colorspacereduce image colors in this colorspace
    -quietsuppress all warning messages
    -regard-warningspay attention to warning messages.
    -respect-parenthesessettings remain in effect until parenthesis boundary.
    -sampling-factor geometryhorizontal and vertical sampling factor
    -seed valueseed a new sequence of pseudo-random numbers
    -set attribute valueset an image attribute
    -size geometrywidth and height of image
    -storage-type typestore pixels with this storage type.
    -synchronizesynchronize image to storage device
    -taintmark the image as modified
    -transparent-color colortransparent color
    -verboseprint detailed information about the image
    -versionprint version information
    -virtual-pixel methodaccess method for pixels outside the boundaries of the image
    +
    +
    exception
    +
    return any errors or warnings in this structure.
    +
    +
    diff --git a/www/support.html b/www/support.html index 495693b46..825ed37f1 100644 --- a/www/support.html +++ b/www/support.html @@ -5,34 +5,34 @@ - - + + Support ImageMagick Development @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    +

    Contribute a Bug Fix or Enhancement • Support the ImageMagick Project

    @@ -135,7 +135,7 @@

    Flattr is a microdonation system. You donate a small amount every month and click Flattr buttons on worthy sites to share the donation among those sites, similar to a tip jar (for more details see Wikipedia's Flattr article).

      -
      Flattr this
      +
      Flattr this

    Litecoin

    Our Litecoin Address is: LcZLAmym4EMvUPc9koagkccRLYQbsgGwmj. Or you can reference the below QR code:

    @@ -179,4 +179,4 @@ USA - \ No newline at end of file + \ No newline at end of file diff --git a/www/webp.html b/www/webp.html index 8f3900820..4128a68a1 100644 --- a/www/webp.html +++ b/www/webp.html @@ -5,34 +5,34 @@ - - + + WebP Encoding Options @ ImageMagick - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
    -
    -
    +

    ImageMagick's WebP image format accepts a plethora of encoding options as detailed below. As an example, suppose you are interested in these options:

    @@ -189,13 +189,13 @@