From: Cristy Date: Fri, 8 Dec 2017 20:08:14 +0000 (-0500) Subject: ... X-Git-Tag: 7.0.7-15~30 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=7272787ba1de6db483b199be62742aaaa840eeaa;p=imagemagick ... --- diff --git a/index.html b/index.html index 4359af1a5..f809dd138 100644 --- a/index.html +++ b/index.html @@ -5,30 +5,30 @@ - - + + Convert, Edit, Or Compose Bitmap Images @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
@@ -83,7 +83,7 @@ Use ImageMagickABI. Before each ImageMagick release, we perform a comprehensive security assessment that includes memory error and thread data race detection to help prevent security vulnerabilities.

-

The current release is ImageMagick 7.0.7-14. It runs on Linux, Windows, Mac Os X, iOS, Android OS, and others.

+

The current release is ImageMagick 7.0.7-14. It runs on Linux, Windows, Mac Os X, iOS, Android OS, and others.

The authoritative ImageMagick web site is https://www.imagemagick.org. The authoritative source code repository is https://github.com/ImageMagick. We maintain a source code mirror at https://gitlab.com/ImageMagick.

@@ -235,11 +235,11 @@ Use ImageMagickthe pixel cache; -
  • Add more cores to your system (up to 20), see threads of execution support;
  • -
  • push large images to a solid-state drive, see large image support.
  • +
  • Add more memory to your system, see the pixel cache;
  • +
  • Add more cores to your system (up to 20), see threads of execution support;
  • +
  • push large images to a solid-state drive, see large image support.
  • -

    If these options are prohibitive, you can reduce the quality of the image results. The default build is Q16 HDRI. If you disable HDRI, you use half the memory and instead of predominately floating point operations, you use the typically more efficient integer operations. The tradeoff is reduced percision and you cannot process out of range pixel values (e.g. negative). If you build the Q8 non-HDRI version of ImageMagick, you again reduce the memory requirements in half-- and once again there is a tradeoff, even less percision and no out of range pixel values. For a Q8 non-HDRI build of ImageMagick, use these configure script options: --with-quantum-depth=8 --disable-hdri.

    +

    If these options are prohibitive, you can reduce the quality of the image results. The default build is Q16 HDRI. If you disable HDRI, you use half the memory and instead of predominately floating point operations, you use the typically more efficient integer operations. The tradeoff is reduced percision and you cannot process out of range pixel values (e.g. negative). If you build the Q8 non-HDRI version of ImageMagick, you again reduce the memory requirements in half-- and once again there is a tradeoff, even less percision and no out of range pixel values. For a Q8 non-HDRI build of ImageMagick, use these configure script options: --with-quantum-depth=8 --disable-hdri.

    Community

    To join the ImageMagick community, try the discourse server. You can review questions or comments (with informed responses) posed by ImageMagick users or ask your own questions. If you want to contribute image processing algorithms, other enhancements, or bug fixes, open an issue.

    @@ -260,11 +260,11 @@ Use ImageMagick - - - + + + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/ImageMagickObject.html b/www/ImageMagickObject.html index e58698cf3..f9742e87c 100644 --- a/www/ImageMagickObject.html +++ b/www/ImageMagickObject.html @@ -5,30 +5,30 @@ - - + + Install the ImageMagickObject COM+ Component @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -137,11 +137,11 @@ 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 900bc5849..5b756eb7b 100644 --- a/www/advanced-unix-installation.html +++ b/www/advanced-unix-installation.html @@ -5,30 +5,30 @@ - - + + Advanced Unix Source Installation @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -631,3 +631,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 b1a2bf2a6..c7184a62e 100644 --- a/www/advanced-windows-installation.html +++ b/www/advanced-windows-installation.html @@ -5,30 +5,30 @@ - - + + Advanced Windows Source Installation @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -404,3 +404,4 @@ _MAGICKMOD_ + \ No newline at end of file diff --git a/www/animate.html b/www/animate.html index 0c769c084..79746b724 100644 --- a/www/animate.html +++ b/www/animate.html @@ -5,30 +5,30 @@ - - + + Command-line Tools: Animate @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -542,11 +542,11 @@ 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.html b/www/api.html index 9e71d8194..a44319057 100644 --- a/www/api.html +++ b/www/api.html @@ -45,7 +45,7 @@ Command-line Resources Develop - Search + Search Community @@ -164,7 +164,7 @@

    Back to top • Public Key • - Contact Us

    + Contact Us

    © 1999-2016 ImageMagick Studio LLC

    diff --git a/www/api/Image++.html b/www/api/Image++.html index 36d81d419..c80af516b 100644 --- a/www/api/Image++.html +++ b/www/api/Image++.html @@ -5,59 +5,78 @@ - - + + 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 +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 @@ -65,7 +84,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++ @@ -194,7 +213,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 @@ -253,7 +272,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:

    @@ -275,15 +294,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 @@ -296,22 +315,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_ @@ -319,7 +338,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 @@ -351,7 +370,7 @@ order of the pixels in the supplied pixel array. type_ - Pixel + Pixel storage type (CharPixel, ShortPixel, IntegerPixel, FloatPixel, or DoublePixel) @@ -376,7 +395,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:

    @@ -420,7 +439,7 @@ compute the threshold.
    addNoise
    - NoiseType + NoiseType noiseType_ Add noise to image with specified noise type. @@ -454,13 +473,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 @@ -468,8 +487,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_ @@ -477,7 +496,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. @@ -512,7 +531,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. @@ -528,7 +547,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 @@ -550,7 +569,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) @@ -582,7 +601,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 @@ -614,8 +633,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 @@ -623,8 +642,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 @@ -654,7 +673,7 @@ kernel to apply.
    crop
    - const Geometry + const Geometry &geometry_ Crop image (subregion of original image) @@ -695,12 +714,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 @@ -752,22 +771,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_ @@ -784,28 +803,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_ @@ -857,7 +876,7 @@ horizontal direction)
    frame
    - const Geometry + const Geometry &geometry_ = "25x25+6+6" Add decorative frame around image @@ -945,7 +964,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 @@ -1019,10 +1038,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. @@ -1037,7 +1056,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. @@ -1129,8 +1148,8 @@ respectively.
    opaque
    - const Color -&opaqueColor_, const Color &penColor_ + const Color +&opaqueColor_, const Color &penColor_ Change color of pixels matching opaqueColor_ to specified penColor_. @@ -1178,7 +1197,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) @@ -1191,7 +1210,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 @@ -1201,9 +1220,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 @@ -1214,22 +1233,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_ @@ -1336,7 +1355,7 @@ number of degrees.
    sample
    - const Geometry + const Geometry &geometry_ Resize image by using pixel sampling algorithm @@ -1344,7 +1363,7 @@ number of degrees.
    scale
    - const Geometry + const Geometry &geometry_ Resize image by using simple ratio algorithm @@ -1451,7 +1470,7 @@ exposing a photographic film to light during the development process)
    splice
    - const Geometry + const Geometry &geometry_ splice the background color into the image @@ -1520,21 +1539,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. @@ -1605,9 +1624,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 ).
    @@ -1618,11 +1637,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_ @@ -1688,7 +1707,7 @@ values and type_ parameters.
    resize
    - const Geometry + const Geometry &geometry_ Resize image to specified size. @@ -1805,9 +1824,9 @@ similar to "EXIF:DateTime".

    Color - Color + Color void - const Color + const Color &color_ Image background color @@ -1854,9 +1873,9 @@ texture. Does not modify image pixels.
    borderColor
    - Color + Color void - const Color + const Color &color_ Image border color @@ -1874,9 +1893,9 @@ crop(Geometry(0,0)).
    boxColor
    - Color + Color void - const Color + const Color &boxColor_ Base color that annotation text is rendered on. @@ -1971,10 +1990,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 @@ -2010,10 +2029,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. @@ -2041,10 +2060,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 @@ -2072,11 +2091,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). @@ -2087,11 +2106,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. @@ -2157,10 +2176,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 @@ -2182,10 +2201,10 @@ ImageMagick is compiled with.
    endian
    - EndianType + EndianType void - EndianType + EndianType endian_ Specify (or obtain) endian option for formats which support it. @@ -2249,7 +2268,7 @@ objects.
    fillRule
    - FillRule + FillRule void const Magick::FillRule &fillRule_ @@ -2259,10 +2278,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 @@ -2296,9 +2315,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. @@ -2357,12 +2376,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. @@ -2373,10 +2392,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 @@ -2393,12 +2412,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. @@ -2436,9 +2455,9 @@ an opaque one.
    matteColor
    - Color + Color void - const Color + const Color &matteColor_ Image matte (frame) color @@ -2493,7 +2512,7 @@ using this method.

    Geometry - Geometry + Geometry void Tile size and offset within an image montage. @@ -2530,11 +2549,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 @@ -2565,11 +2584,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 @@ -2584,10 +2603,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. @@ -2595,7 +2614,7 @@ image (such as for a scene in an animation)

    profile
    - Blob
    +
    Blob
    const std::string name_
    @@ -2636,10 +2655,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 @@ -2686,10 +2705,10 @@ may be used to manually adjust the tree depth.
    Intent - RenderingIntent + RenderingIntent void - RenderingIntent + RenderingIntent render_ The type of rendering intent @@ -2699,10 +2718,10 @@ render_
    Units - ResolutionType + ResolutionType void - ResolutionType + ResolutionType units_ Units of image resolution @@ -2738,9 +2757,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 @@ -2915,11 +2934,11 @@ designed to support Unicode.

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

    virtualPixelMethod
    - VirtualPixelMethod + VirtualPixelMethod void VirtualPixelMethod + href="../Magick++/Enumerations.html#VirtualPixelMethod">VirtualPixelMethod virtualPixelMethod_ Image virtual pixel method. @@ -2993,12 +3012,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().

    @@ -3023,7 +3042,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(); @@ -3158,7 +3177,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 @@ -3170,7 +3189,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 @@ -3182,21 +3201,27 @@ 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 22dc3a4c7..a209d2de4 100644 --- a/www/api/animate.html +++ b/www/api/animate.html @@ -5,72 +5,548 @@ - - - MagickCore, C API: Interactively Animate an Image Sequence @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + Command-line Tools: Animate @ ImageMagick + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +
    -

    Unknown method

    +

    Example Usage • Option Summary

    + +

    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
    +
    +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/annotate.html b/www/api/annotate.html index e22a2f41a..d84c670f7 100644 --- a/www/api/annotate.html +++ b/www/api/annotate.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Annotate an Image @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +

    AnnotateImageFormatMagickCaptionGetMultilineTypeMetricsGetTypeMetrics

    @@ -277,21 +296,27 @@ 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 66b285cd8..211e1013e 100644 --- a/www/api/attribute.html +++ b/www/api/attribute.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Set Text Attributes @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +

    GetImageDepthGetImageQuantumDepthGetImageTypeIdentifyImageGrayIdentifyImageMonochromeIdentifyImageTypeIsImageGrayIsImageMonochromeIsImageOpaqueSetImageDepthSetImageType

    @@ -361,21 +380,27 @@ 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 482b8e82c..a2735e695 100644 --- a/www/api/blob.html +++ b/www/api/blob.html @@ -5,55 +5,74 @@ - - + + MagickCore, C API: Read or Write Binary Large OBjects @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +
    -

    BlobToImageFileToBlobFileToImageGetBlobPropertiesImageToBlobImageToFileImagesToBlobInjectImageBlobIsBlobExemptIsBlobSeekableIsBlobTemporaryCustomStreamToImage

    +

    BlobToImageCustomStreamToImageFileToBlobFileToImageGetBlobPropertiesImageToBlobImageToFileImagesToBlobInjectImageBlobIsBlobExemptIsBlobSeekableIsBlobTemporary

    BlobToImage

    @@ -88,6 +107,33 @@ Image *BlobToImage(const ImageInfo *image_info,const void *blob,
    exception
    return any errors or warnings in this structure.
    +
    + +

    CustomStreamToImage

    + +

    CustomStreamToImage() is the equivalent of ReadImage(), but reads the formatted "file" from the suplied method rather than to an actual file.

    + +

    The format of the CustomStreamToImage method is:

    + +
    +Image *CustomStreamToImage(const ImageInfo *image_info,
    +   ExceptionInfo *exception)
    +
    + +

    A description of each parameter follows:

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

    FileToBlob

    @@ -384,51 +430,30 @@ MagickBooleanType InjectImageBlob(const ImageInfo *image_info,
    image
    the image.
    -
    - -

    CustomStreamToImage

    - -

    CustomStreamToImage() is the equivalent of ReadImage(), but reads the formatted "file" from the suplied method rather than to an actual file.

    - -

    The format of the CustomStreamToImage method is:

    - -
    -Image *CustomStreamToImage(const ImageInfo *image_info,
    -   ExceptionInfo *exception)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    image_info
    -
    the image info.
    - -
    -
    exception
    -
    return any errors or warnings in this structure.
    -
    +
    +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/cache-view.html b/www/api/cache-view.html index ed0d0e7ff..4092b834c 100644 --- a/www/api/cache-view.html +++ b/www/api/cache-view.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Cache Views @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    + +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/cache.html b/www/api/cache.html index 6832433bd..0fbbbf96b 100644 --- a/www/api/cache.html +++ b/www/api/cache.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Get or Set Image Pixels @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    + +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/channel.html b/www/api/channel.html index f40b9e5fb..ee19671fe 100644 --- a/www/api/channel.html +++ b/www/api/channel.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Get or Set Image Channels @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +

    ChannelFxImageCombineImagesGetImageAlphaChannelSeparateImageSeparateImagesSetImageAlphaChannel

    @@ -241,21 +260,27 @@ MagickBooleanType SetImageAlphaChannel(Image *image,
    +
    +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/cipher.html b/www/api/cipher.html index bc739580b..30b81f164 100644 --- a/www/api/cipher.html +++ b/www/api/cipher.html @@ -5,305 +5,155 @@ - - - MagickCore, C API: Convert to and from Cipher Pixels @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + Encipher or Decipher an Image @ ImageMagick + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +
    -

    AcquireAESInfoDestroyAESInfoEncipherAESBlockPasskeyDecipherImagePasskeyEncipherImageSetAESKeyPasskeyDecipherImagePasskeyEncipherImage

    - -

    AcquireAESInfo

    - -

    AcquireAESInfo() allocate the AESInfo structure.

    - -

    The format of the AcquireAESInfo method is:

    - -
    -AESInfo *AcquireAESInfo(void)
    -
    - -

    DestroyAESInfo

    - -

    DestroyAESInfo() zeros memory associated with the AESInfo structure.

    - -

    The format of the DestroyAESInfo method is:

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

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    aes_info
    -
    the cipher context.
    - -
    -
    -

    EncipherAESBlock

    - -

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

    - -

    The format of the EncipherAESBlock method is:

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

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    aes_info
    -
    the cipher context.
    - -
    -
    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)
    -
    +

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

    -

    A description of each parameter follows:

    +

    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.

    -
    -
    +

    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.

    -
    -
    -
    image
    -
    the image.
    +

    Encipher an Image

    -
    -
    passphrase
    -
    decipher cipher pixels with this passphrase.
    +

    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:

    -
    -
    passkey
    -
    decrypt cipher pixels with this passkey.
    +
    convert rose.jpg -encipher passphrase.txt rose.png
    +
    -
    -
    exception
    -
    return any errors or warnings in this structure.
    +

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

    -
    -
    -

    PasskeyEncipherImage

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

    PasskeyEncipherImage() converts pixels to cipher-pixels.

    +

    Decipher an Image

    -

    The format of the PasskeyEncipherImage method is:

    +

    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:

    -
    -MagickBooleanType PasskeyEncipherImage(Image *image,
    -  const StringInfo *passkey,ExceptionInfo *exception)
    -MagickBooleanType EncipherImage(Image *image,const char *passphrase,
    -  ExceptionInfo *exception)
    -
    +
    convert rose.png -decipher passphrase.txt rose.jpg
    +
    -

    A description of each parameter follows:

    +

    Encipher and Decipher Caveats

    -
    -
    +

    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.

    -
    -
    -
    image
    -
    the image.
    +

    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.

    -
    -
    passphrase
    -
    encipher pixels with this passphrase.
    +

    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.

    -
    -
    passkey
    -
    decrypt cipher pixels with this passkey.
    +

    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.

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

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

    -
    -
    -

    SetAESKey

    +

    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.

    -

    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.

    +

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

    -

    The format of the SetAESKey method is:

    +

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

    -
    -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.
    - -
    -
    +
    +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/color.html b/www/api/color.html index cce3d7f94..7199874f7 100644 --- a/www/api/color.html +++ b/www/api/color.html @@ -5,210 +5,4947 @@ - - - MagickCore, C API: Count the Colors in an Image @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + Color Names @ ImageMagick + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +
    -

    AcquireColorCacheGetColorInfoListGetColorListListColorInfoQueryColorname

    +

    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.

    + +

    Example Usage

    + +

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

    + +
    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.

    + +

    Color Model Specification

    + +

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

    + +
    #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
    + +

    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 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.

    + +

    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).

    + +

    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
    + +

    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).

    + +

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

    + +

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

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

    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 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.

    + +

    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.

    + +

    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.)

    + +

    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.

    + +

    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.

    + +

    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%

    + +
    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
    + +

    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%

    + +
    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
    + +

    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).

    + +

    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:

    + +
    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
    +
    +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
    + +

    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%.

    + +

    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%)
    +
    +-> magick -size 100x100 xc:"cielab(91.1131%,-18.8571%,-5.5436%)" -colorspace sRGB cyan.png
    + +

    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)
    + +

    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)
    + +

    List of Color Names

    + +

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

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + -

    AcquireColorCache

    + + + + + + -

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

    + + + + + + -

    The format of the AcquireColorCache method is:

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

    A description of each parameter follows:

    + + + + + + -
    -
    + + + + + + -
    -
    -
    filename
    -
    the font file name.
    +
    + + + + + -
    -
    exception
    -
    return any errors or warnings in this structure.
    + + + + + + -
    - -

    GetColorInfoList

    + + + + + + -

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

    + + + + + + -

    The format of the GetColorInfoList function is:

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

    A description of each parameter follows:

    + + + + + + -
    -
    + + + + + + -
    -
    -
    pattern
    -
    Specifies a pointer to a text string containing a pattern.
    +
    + + + + + -
    -
    number_colors
    -
    This integer returns the number of colors in the list.
    + + + + + + -
    -
    exception
    -
    return any errors or warnings in this structure.
    + + + + + + -
    - -

    GetColorList

    + + + + + + -

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

    + + + + + + -

    The format of the GetColorList function is:

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

    A description of each parameter follows:

    + + + + + + -
    -
    + + + + + + -
    -
    -
    pattern
    -
    Specifies a pointer to a text string containing a pattern.
    +
    + + + + + -
    -
    number_colors
    -
    This integer returns the number of colors in the list.
    + + + + + + -
    -
    exception
    -
    return any errors or warnings in this structure.
    + + + + + + -
    - -

    ListColorInfo

    + + + + + + -

    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.

    + + + + + + -

    The format of the ListColorInfo method is:

    + + + + + + -
    -MagickBooleanType ListColorInfo(FILE *file,ExceptionInfo *exception)
    -
    + + + + + + -

    A description of each parameter follows.

    + + + + + + -
    file
    -

    List color names to this file handle.

    + + + + + + -
    exception
    -

    return any errors or warnings in this structure.

    + + + + + + -

    QueryColorname

    + + + + + + -

    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.

    + + + + + + -

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

    + + + + + + -

    The format of the QueryColorname method is:

    + + + + + + -
    -MagickBooleanType QueryColorname(const Image *image,
    -  const PixelInfo *color,const ComplianceType compliance,char *name,
    -  ExceptionInfo *exception)
    -
    + + + + + + -

    A description of each parameter follows.

    + + + + + + -
    image
    -

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

    + + + + + + -
    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
    +
    +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/colormap.html b/www/api/colormap.html index 194192041..8f20e5a80 100644 --- a/www/api/colormap.html +++ b/www/api/colormap.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Colormap Methods @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +

    AcquireImageColormapCycleColormap

    @@ -120,21 +139,27 @@ 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 83d4226a2..ec9408314 100644 --- a/www/api/colorspace.html +++ b/www/api/colorspace.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Dealing with Image Colorspaces @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +

    SetImageColorspaceSetImageGraySetImageMonochromeTransformImageColorspace

    @@ -172,21 +191,27 @@ MagickBooleanType TransformImageColorspace(Image *image,
    +
    +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/compare.html b/www/api/compare.html index 3ed35f598..2743d3e63 100644 --- a/www/api/compare.html +++ b/www/api/compare.html @@ -5,111 +5,438 @@ - - - MagickCore, C API: Compare an Image to a Reconstructed Image @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + Command-line Tools: Compare @ ImageMagick + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +
    -

    CompareImagesCommand

    +

    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.

    + +

    Example Usage

    + +

    We list a few examples of the compare command here to illustrate its usefulness and ease of use. To get started, lets compare an image to one thats been sharpened:

    + +
    magick convert rose.jpg -sharpen 0x1 reconstruct.jpg
    +magick compare rose.jpg reconstruct.jpg difference.png
    +magick compare -compose src rose.jpg reconstruct.jpg difference.png
    +
    + +
      + 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.

    + +

    In addition to the visual interpretation of the difference in an image and its reconstruction, we report a mathematical measure of the difference:

    + +
    -> magick compare -verbose -metric mae rose.jpg reconstruct.jpg difference.png
    +Image: rose.jpg
    + Channel distortion: MAE
    +  red: 2282.91 (0.034835)
    +  green: 1853.99 (0.0282901)
    +  blue: 2008.67 (0.0306503)
    +  all: 1536.39 (0.0234439)
    +
    +

    Or, if you just want the red channel distortion, use this command:

    + +
    -> magick compare -channel red -metric PSNR rose.jpg reconstruct.jpg difference.png
    +19.63
    +
    + +

    Or, if you just want the overall image distortion, use this command:

    + +
    -> magick compare -metric PSNR rose.jpg reconstruct.jpg difference.png
    +28.31
    +
    + +

    If the reconstructed image is a subimage of the image, the compare program returns the best match offset. In addition, it returns a similarity image such that an exact match location is completely white and if none of the pixels match, black, otherwise some gray level in-between:

    + +
    -> magick compare -metric RMSE -subimage-search logo.png wizard.jpg similarity.gif
    +85.05 (0.00129778) @ 353,157
    +
    + +

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

    + +

    The compare program returns 2 on error otherwise 0 if the images are similar or 1 if they are dissimilar.

    + +

    Option Summary

    + +

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

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + -

    CompareImagesCommand

    + + + + -

    CompareImagesCommand() compares two images and returns the difference between them as a distortion metric and as a new image visually annotating their differences.

    + + + + -

    The format of the CompareImagesCommand method is:

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

    A description of each parameter follows:

    + + + + -
    -
    + + + + -
    -
    -
    image_info
    -
    the image info.
    +
    + + + -
    -
    argc
    -
    the number of elements in the argument vector.
    + + + + -
    -
    argv
    -
    A text array containing the command line arguments.
    + + + + -
    -
    metadata
    -
    any metadata is returned here.
    + + + + -
    -
    exception
    -
    return any errors or warnings in this structure.
    + + + + -
    - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    OptionDescription
    -alphaon, activate, off, deactivate, set, opaque, copy", +transparent, extract, background, or shape the alpha channel
    -authenticate valuedecrypt image with this password
    -background colorbackground color
    -brightness-contrast geometryimprove brightness / contrast of the image
    -channel typeapply option to select image channels
    -colorspace typeset image colorspace
    -compose operatorset image composite operator
    -crop geometrycrop the image
    -decipher filenameconvert cipher pixels to plain
    -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
    -dissimilarity-threshold valuemaximum distortion for (sub)image match (default 0.2)
    -distort type coefficientsdistort image
    -encipher filenameconvert plain pixels to cipher pixels
    -extract geometryextract area from image
    -fuzz distancecolors within this distance are considered equal
    -gravity typehorizontal and vertical text placement
    -helpprint program options
    -highlight-color coloremphasize pixel differences with this color
    -identifyidentify the format and characteristics of the image
    -interlace typetype of image interlacing scheme
    -level valueadjust the level of image contrast
    -limit type valuepixel cache resource limit
    -log formatformat of debugging information
    -lowlight-color colorde-emphasize pixel differences with this color
    -metric typemeasure differences between images with this metric
    -negatereplace each pixel with its complementary color
    -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
    -read-mask filenameassociate a read mask with the image
    -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
    -seed valueseed a new sequence of pseudo-random numbers
    -separateseparate an image channel into a grayscale image
    -set attribute valueset an image attribute
    -sigmoidal-contrast geometryincrease the contrast without saturating highlights or shadows
    -similarity-threshold valueminimum distortion for (sub)image match (default 0.0)
    -size geometrywidth and height of image
    -subimage-searchsearch for subimage
    -synchronizesynchronize image to storage device
    -taintmark the image as modified
    -transparent-color colortransparent color
    -trimtrim image edges
    -verboseprint detailed information about the image
    -versionprint version information
    -virtual-pixel methodaccess method for pixels outside the boundaries of the image
    -read-mask filenameassociate a write mask with the image
    +
    +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/composite.html b/www/api/composite.html index 4cf0a9d81..247359ce1 100644 --- a/www/api/composite.html +++ b/www/api/composite.html @@ -5,96 +5,523 @@ - - - MagickCore, C API: Composite an Image @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + Command-line Tools: Composite @ ImageMagick + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +
    -

    CompositeImageCommand

    +

    Example Usage • Option Summary

    + +

    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.

    + +

    Example Usage

    + +

    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:

    + +
    magick composite -gravity center smile.gif  rose: rose-over.png
    +
    + +
      + smile + over + rose + ==> + rose +
    + +

    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
    +
    + +
      + white highlight + atop + red circle + ==> + red ball +
    + +

    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

    + +

    Option Summary

    + +

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

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + -

    CompositeImageCommand

    + + + + -

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

    + + + + -

    The format of the CompositeImageCommand method is:

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

    A description of each parameter follows:

    + + + + -
    -
    + + + + -
    -
    -
    image_info
    -
    the image info.
    +
    + + + -
    -
    argc
    -
    the number of elements in the argument vector.
    + + + + -
    -
    argv
    -
    A text array containing the command line arguments.
    + + + + -
    -
    metadata
    -
    any metadata is returned here.
    + + + + -
    -
    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 diff --git a/www/api/constitute.html b/www/api/constitute.html index 078c02fbf..4deff7a98 100644 --- a/www/api/constitute.html +++ b/www/api/constitute.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Constitute an Image @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +

    ConstituteImagePingImagePingImagesReadImageReadImagesWriteImageWriteImages

    @@ -284,21 +303,27 @@ 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 2c8299ce4..72db93cff 100644 --- a/www/api/decorate.html +++ b/www/api/decorate.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Decorate an Image @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +

    BorderImageFrameImageRaiseImage

    @@ -162,21 +181,27 @@ MagickBooleanType RaiseImage(const Image *image,
    +
    +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/deprecate.html b/www/api/deprecate.html index 2766211f6..b18a2557a 100644 --- a/www/api/deprecate.html +++ b/www/api/deprecate.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Deprecated Methods @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +

    MagickGetImageAlphaColorMagickSetImageAlphaColor

    @@ -110,21 +129,27 @@ MagickBooleanType MagickSetImageAlphaColor(MagickWand *wand,
    +
    +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/display.html b/www/api/display.html index 1bd95b9fb..b28eb1f04 100644 --- a/www/api/display.html +++ b/www/api/display.html @@ -5,72 +5,582 @@ - - - MagickCore, C API: Interactively Display and Edit an Image @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + Command-line Tools: Display @ ImageMagick + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +
    -

    Unknown method

    +

    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
    +
    +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/distort.html b/www/api/distort.html index eeff755d1..122dbf666 100644 --- a/www/api/distort.html +++ b/www/api/distort.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Image Distortions @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +

    AffineTransformImageDistortImageRotateImageSparseColorImage

    @@ -219,21 +238,27 @@ Image *SparseColorImage(const Image *image,
    +
    +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/draw.html b/www/api/draw.html index 8ce6d78fa..93f5fa64d 100644 --- a/www/api/draw.html +++ b/www/api/draw.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Draw on an Image @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +

    AcquireDrawInfoCloneDrawInfoDestroyDrawInfoDrawAffineImageDrawClipPathDrawImageDrawGradientImageDrawPatternPathDrawPrimitiveGetAffineMatrix

    @@ -343,21 +362,27 @@ 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 d3fb41a54..84ce82fc3 100644 --- a/www/api/drawing-wand.html +++ b/www/api/drawing-wand.html @@ -5,53 +5,72 @@ - - + + MagickWand, C API: Drawing Wand Methods @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +

    ClearDrawingWandCloneDrawingWandDestroyDrawingWandDrawAffineDrawAlphaDrawAnnotationDrawArcDrawBezierDrawCircleDrawClearExceptionDrawCloneExceptionInfoDrawColorDrawCompositeDrawCommentDrawEllipseDrawGetBorderColorDrawGetClipPathDrawGetClipRuleDrawGetClipUnitsDrawGetDensityDrawGetExceptionDrawGetExceptionTypeDrawGetFillColorDrawGetFillOpacityDrawGetFillRuleDrawGetFontDrawGetFontFamilyDrawGetFontResolutionDrawGetFontSizeDrawGetFontStretchDrawGetFontStyleDrawGetFontWeightDrawGetGravityDrawGetOpacityDrawGetStrokeAntialiasDrawGetStrokeColorDrawGetStrokeDashArrayDrawGetStrokeDashOffsetDrawGetStrokeLineCapDrawGetStrokeLineJoinDrawGetStrokeMiterLimitDrawGetStrokeOpacityDrawGetStrokeWidthDrawGetTextAlignmentDrawGetTextAntialiasDrawGetTextDecorationDrawGetTextDirectionDrawGetTextEncodingDrawGetTextKerningDrawGetTextInterlineSpacingDrawGetTextInterwordSpacingDrawGetVectorGraphicsDrawGetTextUnderColorDrawLineDrawPathCloseDrawPathCurveToAbsoluteDrawPathCurveToRelativeDrawPathCurveToQuadraticBezierAbsoluteDrawPathCurveToQuadraticBezierRelativeDrawPathCurveToQuadraticBezierSmoothAbsoluteDrawPathCurveToQuadraticBezierSmoothRelativeDrawPathCurveToSmoothAbsoluteDrawPathCurveToSmoothRelativeDrawPathEllipticArcAbsoluteDrawPathEllipticArcRelativeDrawPathFinishDrawPathLineToAbsoluteDrawPathLineToRelativeDrawPathLineToHorizontalAbsoluteDrawPathLineToHorizontalRelativeDrawPathLineToVerticalAbsoluteDrawPathLineToVerticalRelativeDrawPathMoveToAbsoluteDrawPathMoveToRelativeDrawPathStartDrawPointDrawPolygonDrawPolylineDrawPopClipPathDrawPopDefsDrawPopPatternDrawPushClipPathDrawPushDefsDrawPushPatternDrawRectangleDrawResetVectorGraphicsDrawRotateDrawRoundRectangleDrawScaleDrawSetBorderColorDrawSetClipPathDrawSetClipRuleDrawSetClipUnitsDrawSetDensityDrawSetFillColorDrawSetFillOpacityDrawSetFontResolutionDrawSetOpacityDrawSetFillPatternURLDrawSetFillRuleDrawSetFontDrawSetFontFamilyDrawSetFontSizeDrawSetFontStretchDrawSetFontStyleDrawSetFontWeightDrawSetGravityDrawSetStrokeColorDrawSetStrokePatternURLDrawSetStrokeAntialiasDrawSetStrokeDashArrayDrawSetStrokeDashOffsetDrawSetStrokeLineCapDrawSetStrokeLineJoinDrawSetStrokeMiterLimitDrawSetStrokeOpacityDrawSetStrokeWidthDrawSetTextAlignmentDrawSetTextAntialiasDrawSetTextDecorationDrawSetTextDirectionDrawSetTextEncodingDrawSetTextKerningDrawSetTextInterlineSpacingDrawSetTextInterwordSpacingDrawSetTextUnderColorDrawSetVectorGraphicsDrawSkewXDrawSkewYDrawTranslateDrawSetViewboxIsDrawingWandNewDrawingWandPeekDrawingWandPopDrawingWandPushDrawingWand

    @@ -3820,21 +3839,27 @@ MagickBooleanType PushDrawingWand(DrawingWand *wand)
    +
    +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/effect.html b/www/api/effect.html index 665f65454..d9137fa46 100644 --- a/www/api/effect.html +++ b/www/api/effect.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Add an Effect @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    + +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/enhance.html b/www/api/enhance.html index 347339376..a8c2f5016 100644 --- a/www/api/enhance.html +++ b/www/api/enhance.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Enhance an Image @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    + +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/exception.html b/www/api/exception.html index d29a59d3f..b75807509 100644 --- a/www/api/exception.html +++ b/www/api/exception.html @@ -5,462 +5,287 @@ - - - MagickCore, C API: Dealing with Exceptions @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + Exceptions @ ImageMagick + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +
    -

    AcquireExceptionInfoClearMagickExceptionCatchExceptionCloneExceptionInfoDestroyExceptionInfoGetExceptionMessageGetLocaleExceptionMessageInheritExceptionInitializeExceptionInfoMagickErrorMagickFatalErrorMagickWarningSetErrorHandlerSetFatalErrorHandlerSetWarningHandlerThrowException

    - -

    AcquireExceptionInfo

    - -

    AcquireExceptionInfo() allocates the ExceptionInfo structure.

    - -

    The format of the AcquireExceptionInfo method is:

    - -
    -ExceptionInfo *AcquireExceptionInfo(void)
    -
    - -

    ClearMagickException

    - -

    ClearMagickException() clears any exception that may not have been caught yet.

    - -

    The format of the ClearMagickException method is:

    - -
    -ClearMagickException(ExceptionInfo *exception)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    exception
    -
    the exception info.
    - -
    -
    -

    CatchException

    - -

    CatchException() returns if no exceptions is found otherwise it reports the exception as a warning, error, or fatal depending on the severity.

    - -

    The format of the CatchException method is:

    - -
    -CatchException(ExceptionInfo *exception)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    exception
    -
    the exception info.
    - -
    -
    -

    CloneExceptionInfo

    - -

    CloneExceptionInfo() clones the ExceptionInfo structure.

    - -

    The format of the CloneExceptionInfo method is:

    - -
    -ExceptionInfo *CloneException(ExceptionInfo *exception)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    exception
    -
    the exception info.
    - -
    -
    -

    DestroyExceptionInfo

    - -

    DestroyExceptionInfo() deallocates memory associated with an exception.

    - -

    The format of the DestroyExceptionInfo method is:

    - -
    -ExceptionInfo *DestroyExceptionInfo(ExceptionInfo *exception)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    exception
    -
    the exception info.
    - -
    -
    -

    GetExceptionMessage

    - -

    GetExceptionMessage() returns the error message defined by the specified error code.

    - -

    The format of the GetExceptionMessage method is:

    - -
    -char *GetExceptionMessage(const int error)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    error
    -
    the error code.
    - -
    -
    -

    GetLocaleExceptionMessage

    - -

    GetLocaleExceptionMessage() converts a enumerated exception severity and tag to a message in the current locale.

    - -

    The format of the GetLocaleExceptionMessage method is:

    - -
    -const char *GetLocaleExceptionMessage(const ExceptionType severity,
    -  const char *tag)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    severity
    -
    the severity of the exception.
    - -
    -
    tag
    -
    the message tag.
    - -
    -
    -

    InheritException

    - -

    InheritException() inherits an exception from a related exception.

    - -

    The format of the InheritException method is:

    - -
    -InheritException(ExceptionInfo *exception,const ExceptionInfo *relative)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    exception
    -
    the exception info.
    - -
    -
    relative
    -
    the related exception info.
    - -
    -
    -

    InitializeExceptionInfo

    - -

    InitializeExceptionInfo() initializes an exception to default values.

    - -

    The format of the InitializeExceptionInfo method is:

    - -
    -InitializeExceptionInfo(ExceptionInfo *exception)
    -
    - -

    A description of each parameter follows:

    -
    -
    +

    ImageMagick returns a status of 0 whenever a command or algorithm successfully complete without complaint. A warning code generally is typically just a notice that something unusual occurred but the command or algorithm still completed and most likely the results are still usable. An error means the command or algorithm could not complete as expected and any results are unreliable. A fatal error means the command or algorithm could not complete and the process exits prematurely and no results are returned.

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    ImageMagick Error and Warning Codes
    DomainDescriptionWarningErrorFatal Error
    Successthe command or algorithm completed successfully without complaint000
    Resource Limita program resource is exhausted (e.g. not enough memory)300400700
    TypeA font is unavailable; a substitution may have occurred305405705
    Optiona command-line option was malformed310410710
    Delegatean ImageMagick delegate failed to complete315415715
    Missing Delegatethe image type can not be read or written because the appropriate Delegate is missing320420720
    Corrupt Imagethe image file may be corrupt325425725
    FileOpenthe image file could not be opened for reading or writing330430730
    Bloba binary large object could not be allocated, read, or written335435735
    Streamthere was a problem reading or writing from a stream340440740
    Cachepixels could not be read or written to the pixel cache345445745
    Coderthere was a problem with an image coder350450750
    Modulethere was a problem with an image module355455755
    Drawa drawing operation failed360460760
    Imagethe operation could not complete due to an incompatible image365465765
    Wandthere was a problem specific to the MagickWand API370470770
    Randomthere is a problem generating a true or pseudo-random number375475775
    XServeran X resource is unavailable380480780
    Monitorthere was a problem activating the progress monitor385485785
    Registrythere was a problem getting or setting the registry390490790
    Configurethere was a problem getting a configuration file395495795
    Policya policy denies access to a delegate, coder, filter, path, or resource.399499799
    -
    -
    -
    exception
    -
    the exception info.
    - -
    -
    -

    MagickError

    - -

    MagickError() calls the exception handler methods with an error reason.

    - -

    The format of the MagickError method is:

    - -
    -void MagickError(const ExceptionType error,const char *reason,
    -  const char *description)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    exception
    -
    Specifies the numeric error category.
    - -
    -
    reason
    -
    Specifies the reason to display before terminating the program.
    - -
    -
    description
    -
    Specifies any description to the reason.
    - -
    -
    -

    MagickFatalError

    - -

    MagickFatalError() calls the fatal exception handler methods with an error reason.

    - -

    The format of the MagickError method is:

    - -
    -void MagickFatalError(const ExceptionType error,const char *reason,
    -  const char *description)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    exception
    -
    Specifies the numeric error category.
    - -
    -
    reason
    -
    Specifies the reason to display before terminating the program.
    - -
    -
    description
    -
    Specifies any description to the reason.
    - -
    -
    -

    MagickWarning

    - -

    MagickWarning() calls the warning handler methods with a warning reason.

    - -

    The format of the MagickWarning method is:

    - -
    -void MagickWarning(const ExceptionType warning,const char *reason,
    -  const char *description)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    warning
    -
    the warning severity.
    - -
    -
    reason
    -
    Define the reason for the warning.
    - -
    -
    description
    -
    Describe the warning.
    - -
    -
    -

    SetErrorHandler

    - -

    SetErrorHandler() sets the exception handler to the specified method and returns the previous exception handler.

    - -

    The format of the SetErrorHandler method is:

    - -
    -ErrorHandler SetErrorHandler(ErrorHandler handler)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    handler
    -
    the method to handle errors.
    - -
    -
    -

    SetFatalErrorHandler

    - -

    SetFatalErrorHandler() sets the fatal exception handler to the specified method and returns the previous fatal exception handler.

    - -

    The format of the SetErrorHandler method is:

    - -
    -ErrorHandler SetErrorHandler(ErrorHandler handler)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    handler
    -
    the method to handle errors.
    - -
    -
    -

    SetWarningHandler

    - -

    SetWarningHandler() sets the warning handler to the specified method and returns the previous warning handler.

    - -

    The format of the SetWarningHandler method is:

    - -
    -ErrorHandler SetWarningHandler(ErrorHandler handler)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    handler
    -
    the method to handle warnings.
    - -
    -
    -

    ThrowException

    - -

    ThrowException() throws an exception with the specified severity code, reason, and optional description.

    - -

    The format of the ThrowException method is:

    - -
    -MagickBooleanType ThrowException(ExceptionInfo *exception,
    -  const ExceptionType severity,const char *reason,
    -  const char *description)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    exception
    -
    the exception info.
    - -
    -
    severity
    -
    the severity of the exception.
    - -
    -
    reason
    -
    the reason for the exception.
    - -
    -
    description
    -
    the exception description.
    - -
    -
    +
    +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/feature.html b/www/api/feature.html index 4727f12d2..839fa1580 100644 --- a/www/api/feature.html +++ b/www/api/feature.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Image Features @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +

    CannyEdgeImageGetImageFeaturesUse HoughLineImageMeanShiftImage

    @@ -209,21 +228,27 @@ 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 b5cd9bd11..8a58d8420 100644 --- a/www/api/fourier.html +++ b/www/api/fourier.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Fourier Transform @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +

    ComplexImagesForwardFourierTransformImageInverseFourierTransformImage

    @@ -154,21 +173,27 @@ 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 11714b483..3f00b232d 100644 --- a/www/api/fx.html +++ b/www/api/fx.html @@ -5,828 +5,427 @@ - - - MagickCore, C API: Add a Special Effect @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + The Fx Special Effects Image Operator @ ImageMagick + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +
    -

    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.
    - -
    +

    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()
    -

    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.
    - -
    +

    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
    -

    ShadowImage

    - -

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

    +
    +

    The expression semantics include these rules:

    -

    The format of the ShadowImage method is:

    +
      +
    • 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.
    • +
    +
    -
    -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:

    +

    Source Images

    -
    -
    +

    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.

    -
    -
    -
    image
    -
    the image.
    +

    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):

    -
    -
    alpha
    -
    percentage transparency.
    +
    convert image1.jpg image2.jpg image3.jpg -fx "(u+u[2])/2.0" image.jpg
    +
    -
    -
    sigma
    -
    the standard deviation of the Gaussian, in pixels.
    +

    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:...].

    -
    -
    x_offset
    -
    the shadow x-offset.
    +

    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.

    -
    -
    y_offset
    -
    the shadow y-offset.
    +
    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 +
    -
    -
    -

    SketchImage

    +
    +

    Accessing Pixels

    -

    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.

    +

    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 SketchImage 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 *SketchImage(const Image *image,const double radius,
    -const double sigma,const double angle,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.
    - -
    -
    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

    +

    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.

    -

    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.

    +

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

    -

    The format of the SolarizeImage method is:

    +

    Apply an Expression to Select Image Channels

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

    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:

    -

    A description of each parameter follows:

    +
    convert alpha.png beta.png -channel red -fx "(u.g+v.g)/2" gamma.png
    +
    -
    -
    -
    -
    -
    image
    -
    the image.
    +

    Results

    -
    -
    threshold
    -
    Define the extent of the solarization.
    +

    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.

    -
    -
    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

    +

    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.

    -

    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:

    +

    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 *SwirlImage(const Image *image,double degrees,
    -  const PixelInterpolateMethod method,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.

    -
    -
    degrees
    -
    Define the tightness of the swirling effect.
    - -
    -
    method
    -
    the pixel interpolation method.
    - -
    -
    exception
    -
    return any errors or warnings in this structure.
    - -
    -
    -

    TintImage

    - -

    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:

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

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    image
    -
    the image.
    - -
    -
    blend
    -
    A color value used for tinting.
    - -
    -
    tint
    -
    A color value used for tinting.
    - -
    -
    exception
    -
    return any errors or warnings in this structure.
    - -
    -
    -

    VignetteImage

    - -

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

    - -

    The format of the VignetteImage method is:

    - -
    -Image *VignetteImage(const Image *image,const double radius,
    -  const double sigma,const ssize_t x,const ssize_t y,
    -  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.
    - -
    -
    x, y
    -
    Define the x and y ellipse offset.
    - -
    -
    exception
    -
    return any errors or warnings in this structure.
    - -
    -
    -

    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.
    - -
    -
    amplitude, wave_length
    -
    Define the amplitude and wave length of the sine wave.
    - -
    -
    interpolate
    -
    the pixel interpolation method.
    - -
    -
    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:

    - -
    -Image *WaveletDenoiseImage(const Image *image,const double threshold,
    -  const double softness,ExceptionInfo *exception)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    image
    -
    the image.
    - -
    -
    threshold
    -
    set the threshold for smoothing.
    - -
    -
    softness
    -
    attenuate the smoothing threshold.
    - -
    -
    exception
    -
    return any errors or warnings in this structure.
    - -
    -
    +
    +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/histogram.html b/www/api/histogram.html index 009a49bb0..a0f0bf345 100644 --- a/www/api/histogram.html +++ b/www/api/histogram.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Image Histograms @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +

    GetImageHistogramIdentifyPaletteImageIsHistogramImageIsPaletteImageMinMaxStretchImageGetNumberColorsUniqueImageColors

    @@ -214,21 +233,27 @@ Image *UniqueImageColors(const Image *image,ExceptionInfo *exception)

    return any errors or warnings in this structure.

    +
    +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/image-view.html b/www/api/image-view.html index 1289230fa..b951bce0f 100644 --- a/www/api/image-view.html +++ b/www/api/image-view.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Image View Methods @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    + +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/image.html b/www/api/image.html index 028c71991..623137de5 100644 --- a/www/api/image.html +++ b/www/api/image.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Image Methods @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    - - - + + + + + + + \ No newline at end of file diff --git a/www/api/layer.html b/www/api/layer.html index f7beaaaa1..283236bd3 100644 --- a/www/api/layer.html +++ b/www/api/layer.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Dealing with Image Layers @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    + +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/list.html b/www/api/list.html index 2cd1c76e2..456a6173b 100644 --- a/www/api/list.html +++ b/www/api/list.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Working with Image Lists @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    - - - + + + + + + + \ No newline at end of file diff --git a/www/api/magick++-classes.html b/www/api/magick++-classes.html index fe58762aa..c01994c88 100644 --- a/www/api/magick++-classes.html +++ b/www/api/magick++-classes.html @@ -5,61 +5,80 @@ - - + + Magick++, C++ API: Classes @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +

    Magick++ Classes

    -

    Magick++ provides a simple C++ API to the ImageMagick image processing library which supports reading and writing a huge number of image formats as well as supporting a broad spectrum of traditional image processing operations. The ImageMagick C API is complex and the data structures are currently not documented. Magick++ provides access to most of the features available from the C API but in a simple object-oriented and well-documented framework.

    +

    Magick++ provides a simple C++ API to the ImageMagick image processing library which supports reading and writing a huge number of image formats as well as supporting a broad spectrum of traditional image processing operations. The ImageMagick C API is complex and the data structures are currently not documented. Magick++ provides access to most of the features available from the C API but in a simple object-oriented and well-documented framework.

    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 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.

    -

    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.

    +

    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.


    +
    +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/magick-deprecate.html b/www/api/magick-deprecate.html index 8b438d4aa..a2994dfc7 100644 --- a/www/api/magick-deprecate.html +++ b/www/api/magick-deprecate.html @@ -5,72 +5,97 @@ - - + + MagickWand, C API: Deprecated Methods @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +

    +
    +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/magick-image.html b/www/api/magick-image.html index 464feb87f..5edca68db 100644 --- a/www/api/magick-image.html +++ b/www/api/magick-image.html @@ -5,53 +5,72 @@ - - + + MagickWand, C API: Image Methods @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +

    GetImageFromMagickWandMagickAdaptiveBlurImageMagickAdaptiveResizeImageMagickAdaptiveSharpenImageMagickAdaptiveThresholdImageMagickAddImageMagickAddNoiseImageMagickAffineTransformImageMagickAnnotateImageMagickAnimateImagesMagickAppendImagesMagickAutoGammaImageMagickAutoLevelImageMagickAutoOrientImageMagickBlackThresholdImageMagickBlueShiftImageMagickBlurImageMagickBorderImageUse MagickBrightnessContrastImageMagickChannelFxImageMagickCharcoalImageMagickChopImageMagickClampImageMagickClipImageMagickClipImagePathMagickClutImageMagickCoalesceImagesMagickColorDecisionListImageMagickColorizeImageMagickColorMatrixImageMagickCombineImagesMagickCommentImageMagickCompareImagesLayersMagickCompareImagesMagickCompositeImageMagickCompositeImageGravityMagickCompositeLayersMagickContrastImageMagickContrastStretchImageMagickConvolveImageMagickCropImageMagickCycleColormapImageMagickConstituteImageMagickDecipherImageMagickDeconstructImagesMagickDeskewImageMagickDespeckleImageMagickDestroyImageMagickDisplayImageMagickDisplayImagesMagickDistortImageMagickDrawImageMagickEdgeImageMagickEmbossImageMagickEncipherImageMagickEnhanceImageMagickEqualizeImageMagickEvaluateImageMagickExportImagePixelsMagickExtentImageMagickFlipImageMagickFloodfillPaintImageMagickFlopImageMagickForwardFourierTransformImageMagickFrameImageMagickFunctionImageMagickFxImageMagickGammaImageMagickGaussianBlurImageMagickGetImageMagickGetImageAlphaChannelMagickGetImageMaskMagickGetImageBackgroundColorMagickGetImageBlobMagickGetImageBlobMagickGetImageBluePrimaryMagickGetImageBorderColorMagickGetImageFeaturesMagickGetImageKurtosisMagickGetImageMeanMagickGetImageRangeMagickGetImageStatisticsMagickGetImageColormapColorMagickGetImageColorsMagickGetImageColorspaceMagickGetImageComposeMagickGetImageCompressionMagickGetImageCompressionQualityMagickGetImageDelayMagickGetImageDepthMagickGetImageDisposeMagickGetImageDistortionMagickGetImageDistortionsMagickGetImageEndianMagickGetImageFilenameMagickGetImageFormatMagickGetImageFuzzMagickGetImageGammaMagickGetImageGravityMagickGetImageGreenPrimaryMagickGetImageHeightMagickGetImageHistogramMagickGetImageInterlaceSchemeMagickGetImageInterpolateMethodMagickGetImageIterationsMagickGetImageLengthMagickGetImageMatteColorMagickGetImageOrientationMagickGetImagePageMagickGetImagePixelColorMagickGetImageRedPrimaryMagickGetImageRegionMagickGetImageRenderingIntentMagickGetImageResolutionMagickGetImageSceneMagickGetImageSignatureMagickGetImageTicksPerSecondMagickGetImageTypeMagickGetImageUnitsMagickGetImageVirtualPixelMethodMagickGetImageWhitePointMagickGetImageWidthMagickGetNumberImagesMagickGetImageTotalInkDensityMagickHaldClutImageMagickHasNextImageMagickHasPreviousImageMagickIdentifyImageMagickIdentifyImageTypeMagickImplodeImageMagickImportImagePixelsMagickInterpolativeResizeImageMagickInverseFourierTransformImageMagickLabelImageMagickLevelImageMagickLinearStretchImageMagickLiquidRescaleImageMagickLocalContrastImageMagickMagnifyImageMagickMergeImageLayersMagickMinifyImageMagickModulateImageMagickMontageImageMagickMorphImagesMagickMorphologyImageMagickMotionBlurImageMagickNegateImageMagickNewImageMagickNextImageMagickNormalizeImageMagickOilPaintImageMagickOpaquePaintImageMagickOptimizeImageLayersMagickOptimizeImageTransparencyMagickOrderedDitherImageMagickPingImageMagickPingImageBlobMagickPingImageFileMagickPolaroidImageMagickPosterizeImageMagickPreviewImagesMagickPreviousImageMagickQuantizeImageMagickQuantizeImagesMagickRotationalBlurImageMagickRaiseImageMagickRandomThresholdImageMagickReadImageMagickReadImageBlobMagickReadImageFileMagickRemapImageMagickRemoveImageMagickResampleImageMagickResetImagePageMagickResizeImageMagickRollImageMagickRotateImageMagickSampleImageMagickScaleImageMagickSegmentImageMagickSelectiveBlurImageMagickSeparateImageMagickSepiaToneImageMagickSetImageMagickSetImageAlphaChannelMagickSetImageBackgroundColorMagickSetImageBluePrimaryMagickSetImageBorderColorMagickSetImageChannelMaskMagickSetImageMaskMagickSetImageColorMagickSetImageColormapColorMagickSetImageColorspaceMagickSetImageComposeMagickSetImageCompressionMagickSetImageCompressionQualityMagickSetImageDelayMagickSetImageDepthMagickSetImageDisposeMagickSetImageEndianMagickSetImageExtentMagickSetImageFilenameMagickSetImageFormatMagickSetImageFuzzMagickSetImageGammaMagickSetImageGravityMagickSetImageGreenPrimaryMagickSetImageInterlaceSchemeMagickSetImageInterpolateMethodMagickSetImageIterationsMagickSetImageMatteMagickSetImageMatteColorMagickSetImageAlphaMagickSetImageOrientationMagickSetImagePageMagickSetImageProgressMonitorMagickSetImageRedPrimaryMagickSetImageRenderingIntentMagickSetImageResolutionMagickSetImageSceneMagickSetImageTicksPerSecondMagickSetImageTypeMagickSetImageUnitsMagickSetImageVirtualPixelMethodMagickSetImageWhitePointMagickShadeImageMagickShadowImageMagickSharpenImageMagickShaveImageMagickShearImageMagickSigmoidalContrastImageMagickSimilarityImageMagickSketchImageMagickSmushImagesMagickSolarizeImageMagickSparseColorImageMagickSpliceImageMagickSpreadImageMagickStatisticImageMagickSteganoImageMagickStereoImageMagickStripImageMagickSwirlImageMagickTextureImageMagickThresholdImageMagickThumbnailImageMagickTintImageMagickTransformImageColorspaceMagickTransparentPaintImageMagickTransposeImageMagickTransverseImageMagickTrimImageMagickUniqueImageColorsMagickUnsharpMaskImageMagickVignetteImageMagickWaveImageMagickWhiteThresholdImageMagickWriteImageMagickWriteImageFileMagickWriteImagesMagickWriteImagesFile

    @@ -7798,21 +7817,27 @@ MagickBooleanType MagickWriteImagesFile(MagickWand *wand,FILE *file)
    +
    +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/magick-property.html b/www/api/magick-property.html index 85b17cd04..8d3136a0d 100644 --- a/www/api/magick-property.html +++ b/www/api/magick-property.html @@ -5,53 +5,72 @@ - - + + MagickWand, C API: Property Methods @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +

    MagickDeleteImageArtifactMagickDeleteImagePropertyMagickDeleteOptionMagickGetAntialiasMagickGetBackgroundColorMagickGetColorspaceMagickGetCompressionMagickGetCompressionQualityMagickGetCopyrightMagickGetFilenameMagickGetFontMagickGetFormatMagickGetGravityMagickGetHomeURLMagickGetImageArtifactMagickGetImageArtifactsMagickGetImageProfileMagickGetImageProfilesMagickGetImagePropertyMagickGetImagePropertiesMagickGetInterlaceSchemeMagickGetInterpolateMethodMagickGetOptionMagickGetOptionsMagickGetOrientationMagickGetPackageNameMagickGetPageMagickGetPointsizeMagickGetQuantumDepthMagickGetQuantumRangeMagickGetReleaseDateMagickGetResolutionMagickGetResourceMagickGetResourceLimitMagickGetSamplingFactorsMagickGetSizeMagickGetSizeOffsetMagickGetTypeMagickGetVersionMagickProfileImageMagickRemoveImageProfileMagickSetAntialiasMagickSetBackgroundColorMagickSetColorspaceMagickSetCompressionMagickSetCompressionQualityMagickSetDepthMagickSetExtractMagickSetFilenameMagickSetFontMagickSetFormatMagickSetGravityMagickSetImageArtifactMagickSetImageProfileMagickSetImagePropertyMagickSetInterlaceSchemeMagickSetInterpolateMethodMagickSetOptionMagickSetOrientationMagickSetPageMagickSetPassphraseMagickSetPointsizeMagickSetProgressMonitorMagickSetResourceLimitMagickSetResolutionMagickSetSamplingFactorsMagickSetSecurityPolicyMagickSetSizeMagickSetSizeOffsetMagickSetType

    @@ -1895,21 +1914,27 @@ 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 208c2efa1..1425ba6b0 100644 --- a/www/api/magick-wand.html +++ b/www/api/magick-wand.html @@ -5,656 +5,399 @@ - - - MagickWand, C API: Wand Methods @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + MagickWand, C API @ ImageMagick + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +
    -

    ClearMagickWandCloneMagickWandDestroyMagickWandIsMagickWandMagickClearExceptionMagickGetExceptionMagickGetExceptionTypeMagickGetIteratorIndexMagickQueryConfigureOptionMagickQueryConfigureOptionsMagickQueryFontMetricsMagickQueryMultilineFontMetricsMagickQueryFontsMagickQueryFormatsMagickRelinquishMemoryMagickResetIteratorMagickSetFirstIteratorMagickSetIteratorIndexMagickSetLastIteratorMagickWandGenesisMagickWandTerminusNewMagickWandNewMagickWandFromImageIsMagickWandInstantiated

    - -

    ClearMagickWand

    - -

    ClearMagickWand() clears resources associated with the wand, leaving the wand blank, and ready to be used for a new set of images.

    - -

    The format of the ClearMagickWand method is:

    - -
    -void ClearMagickWand(MagickWand *wand)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    wand
    -
    the magick wand.
    - -
    -
    -

    CloneMagickWand

    - -

    CloneMagickWand() makes an exact copy of the specified wand.

    - -

    The format of the CloneMagickWand method is:

    - -
    -MagickWand *CloneMagickWand(const MagickWand *wand)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    wand
    -
    the magick wand.
    - -
    -
    -

    DestroyMagickWand

    - -

    DestroyMagickWand() deallocates memory associated with an MagickWand.

    - -

    The format of the DestroyMagickWand method is:

    - -
    -MagickWand *DestroyMagickWand(MagickWand *wand)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    wand
    -
    the magick wand.
    - -
    -
    -

    IsMagickWand

    - -

    IsMagickWand() returns MagickTrue if the wand is verified as a magick wand.

    - -

    The format of the IsMagickWand method is:

    - -
    -MagickBooleanType IsMagickWand(const MagickWand *wand)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    wand
    -
    the magick wand.
    - -
    -
    -

    MagickClearException

    - -

    MagickClearException() clears any exceptions associated with the wand.

    - -

    The format of the MagickClearException method is:

    - -
    -MagickBooleanType MagickClearException(MagickWand *wand)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    wand
    -
    the magick wand.
    - -
    -
    -

    MagickGetException

    - -

    MagickGetException() returns the severity, reason, and description of any error that occurs when using other methods in this API.

    - -

    The format of the MagickGetException method is:

    - -
    -char *MagickGetException(const MagickWand *wand,ExceptionType *severity)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    wand
    -
    the magick wand.
    - -
    -
    severity
    -
    the severity of the error is returned here.
    - -
    -
    -

    MagickGetExceptionType

    - -

    MagickGetExceptionType() returns the exception type associated with the wand. If no exception has occurred, UndefinedExceptionType is returned.

    - -

    The format of the MagickGetExceptionType method is:

    - -
    -ExceptionType MagickGetExceptionType(const MagickWand *wand)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    wand
    -
    the magick wand.
    - -
    -
    -

    MagickGetIteratorIndex

    - -

    MagickGetIteratorIndex() returns the position of the iterator in the image list.

    - -

    The format of the MagickGetIteratorIndex method is:

    - -
    -ssize_t MagickGetIteratorIndex(MagickWand *wand)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    wand
    -
    the magick wand.
    - -
    -
    -

    MagickQueryConfigureOption

    - -

    MagickQueryConfigureOption() returns the value associated with the specified configure option.

    - -

    The format of the MagickQueryConfigureOption function is:

    - -
    -char *MagickQueryConfigureOption(const char *option)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    option
    -
    the option name.
    - -
    -
    -

    MagickQueryConfigureOptions

    - -

    MagickQueryConfigureOptions() returns any configure options that match the specified pattern (e.g. "*" for all). Options include NAME, VERSION, LIB_VERSION, etc.

    - -

    The format of the MagickQueryConfigureOptions function is:

    - -
    -char **MagickQueryConfigureOptions(const char *pattern,
    -  size_t *number_options)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    pattern
    -
    Specifies a pointer to a text string containing a pattern.
    - -
    -
    number_options
    -
    Returns the number of configure options in the list.
    - -
    - -
    -
    -

    MagickQueryFontMetrics

    - -

    MagickQueryFontMetrics() returns a 13 element array representing the following font metrics:

    - -
    -    Element Description
    -    -------------------------------------------------
    -    0 character width
    -    1 character height
    -    2 ascender
    -    3 descender
    -    4 text width
    -    5 text height
    -    6 maximum horizontal advance
    -    7 bounding box: x1
    -    8 bounding box: y1
    -    9 bounding box: x2
    -   10 bounding box: y2
    -   11 origin: x
    -   12 origin: y
    -
    - -

    The format of the MagickQueryFontMetrics method is:

    - -
    -double *MagickQueryFontMetrics(MagickWand *wand,
    -  const DrawingWand *drawing_wand,const char *text)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    wand
    -
    the Magick wand.
    - -
    -
    drawing_wand
    -
    the drawing wand.
    - -
    -
    text
    -
    the text.
    - -
    -
    -

    MagickQueryMultilineFontMetrics

    - -

    MagickQueryMultilineFontMetrics() returns a 13 element array representing the following font metrics:

    - -
    -    Element Description
    -    -------------------------------------------------
    -    0 character width
    -    1 character height
    -    2 ascender
    -    3 descender
    -    4 text width
    -    5 text height
    -    6 maximum horizontal advance
    -    7 bounding box: x1
    -    8 bounding box: y1
    -    9 bounding box: x2
    -   10 bounding box: y2
    -   11 origin: x
    -   12 origin: y
    -
    - -

    This method is like MagickQueryFontMetrics() but it returns the maximum text width and height for multiple lines of text.

    - -

    The format of the MagickQueryFontMetrics method is:

    - -
    -double *MagickQueryMultilineFontMetrics(MagickWand *wand,
    -  const DrawingWand *drawing_wand,const char *text)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    wand
    -
    the Magick wand.
    - -
    -
    drawing_wand
    -
    the drawing wand.
    - -
    -
    text
    -
    the text.
    - -
    -
    -

    MagickQueryFonts

    - -

    MagickQueryFonts() returns any font that match the specified pattern (e.g. "*" for all).

    - -

    The format of the MagickQueryFonts function is:

    - -
    -char **MagickQueryFonts(const char *pattern,size_t *number_fonts)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    pattern
    -
    Specifies a pointer to a text string containing a pattern.
    - -
    -
    number_fonts
    -
    Returns the number of fonts in the list.
    - -
    - -
    -
    -

    MagickQueryFormats

    - -

    MagickQueryFormats() returns any image formats that match the specified pattern (e.g. "*" for all).

    - -

    The format of the MagickQueryFormats function is:

    - -
    -char **MagickQueryFormats(const char *pattern,size_t *number_formats)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    pattern
    -
    Specifies a pointer to a text string containing a pattern.
    - -
    -
    number_formats
    -
    This integer returns the number of image formats in the list.
    - -
    -
    -

    MagickRelinquishMemory

    - -

    MagickRelinquishMemory() relinquishes memory resources returned by such methods as MagickIdentifyImage(), MagickGetException(), etc.

    - -

    The format of the MagickRelinquishMemory method is:

    - -
    -void *MagickRelinquishMemory(void *resource)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    resource
    -
    Relinquish the memory associated with this resource.
    - -
    -
    -

    MagickResetIterator

    - -

    MagickResetIterator() resets the wand iterator.

    - -

    It is typically used either before iterating though images, or before calling specific functions such as MagickAppendImages() to append all images together.

    - -

    Afterward you can use MagickNextImage() to iterate over all the images in a wand container, starting with the first image.

    - -

    Using this before MagickAddImages() or MagickReadImages() will cause new images to be inserted between the first and second image.

    - -

    The format of the MagickResetIterator method is:

    - -
    -void MagickResetIterator(MagickWand *wand)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    wand
    -
    the magick wand.
    - -
    -
    -

    MagickSetFirstIterator

    - -

    MagickSetFirstIterator() sets the wand iterator to the first image.

    - -

    After using any images added to the wand using MagickAddImage() or MagickReadImage() will be prepended before any image in the wand.

    - -

    Also the current image has been set to the first image (if any) in the Magick Wand. Using MagickNextImage() will then set teh current image to the second image in the list (if present).

    - -

    This operation is similar to MagickResetIterator() but differs in how MagickAddImage(), MagickReadImage(), and MagickNextImage() behaves afterward.

    - -

    The format of the MagickSetFirstIterator method is:

    - -
    -void MagickSetFirstIterator(MagickWand *wand)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    wand
    -
    the magick wand.
    - -
    -
    -

    MagickSetIteratorIndex

    - -

    MagickSetIteratorIndex() set the iterator to the given position in the image list specified with the index parameter. A zero index will set the first image as current, and so on. Negative indexes can be used to specify an image relative to the end of the images in the wand, with -1 being the last image in the wand.

    - -

    If the index is invalid (range too large for number of images in wand) the function will return MagickFalse, but no 'exception' will be raised, as it is not actually an error. In that case the current image will not change.

    - -

    After using any images added to the wand using MagickAddImage() or MagickReadImage() will be added after the image indexed, regardless of if a zero (first image in list) or negative index (from end) is used.

    - -

    Jumping to index 0 is similar to MagickResetIterator() but differs in how MagickNextImage() behaves afterward.

    - -

    The format of the MagickSetIteratorIndex method is:

    - -
    -MagickBooleanType MagickSetIteratorIndex(MagickWand *wand,
    -  const ssize_t index)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    wand
    -
    the magick wand.
    - -
    -
    index
    -
    the scene number.
    - -
    -
    -

    MagickSetLastIterator

    - -

    MagickSetLastIterator() sets the wand iterator to the last image.

    - -

    The last image is actually the current image, and the next use of MagickPreviousImage() will not change this allowing this function to be used to iterate over the images in the reverse direction. In this sense it is more like MagickResetIterator() than MagickSetFirstIterator().

    - -

    Typically this function is used before MagickAddImage(), MagickReadImage() functions to ensure new images are appended to the very end of wand's image list.

    - -

    The format of the MagickSetLastIterator method is:

    - -
    -void MagickSetLastIterator(MagickWand *wand)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    wand
    -
    the magick wand.
    - -
    -
    -

    MagickWandGenesis

    - -

    MagickWandGenesis() initializes the MagickWand environment.

    - -

    The format of the MagickWandGenesis method is:

    - -
    -void MagickWandGenesis(void)
    -
    - -

    MagickWandTerminus

    - -

    MagickWandTerminus() terminates the MagickWand environment.

    - -

    The format of the MaickWandTerminus method is:

    - -
    -void MagickWandTerminus(void)
    -
    - -

    NewMagickWand

    - -

    NewMagickWand() returns a wand required for all other methods in the API. A fatal exception is thrown if there is not enough memory to allocate the wand. Use DestroyMagickWand() to dispose of the wand when it is no longer needed.

    - -

    The format of the NewMagickWand method is:

    - -
    -MagickWand *NewMagickWand(void)
    -
    - -

    NewMagickWandFromImage

    - -

    NewMagickWandFromImage() returns a wand with an image.

    - -

    The format of the NewMagickWandFromImage method is:

    - -
    -MagickWand *NewMagickWandFromImage(const Image *image)
    -
    - -

    A description of each parameter follows:

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

    IsMagickWandInstantiated

    - -

    IsMagickWandInstantiated() returns MagickTrue if the ImageMagick environment is currently instantiated-- that is, MagickWandGenesis() has been called but MagickWandTerminus() has not.

    - -

    The format of the IsMagickWandInstantiated method is:

    - -
    -MagickBooleanType IsMagickWandInstantiated(void)
    -
    +

    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:

    + + + +

    After you write your MagickWand program, compile it like this:

    + +
    cc -o wand wand.c `pkg-config --cflags --libs MagickWand`
    +
    + +

    Set the PKG_CONFIG_PATH environment variable if ImageMagick is not in your default system path:

    + +
    export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig
    +
    + +

    Here is a example program that utilizes the MagickWand API to get you started, wand.c. It reads an image, creates a thumbnail, and writes the result to disk.

    + +
    #include <stdio.h>
    +#include <stdlib.h>
    +#include <wand/MagickWand.h>
    +
    +int main(int argc,char **argv)
    +{
    +#define ThrowWandException(wand) \
    +{ \
    +  char \
    +    *description; \
    + \
    +  ExceptionType \
    +    severity; \
    + \
    +  description=MagickGetException(wand,&severity); \
    +  (void) fprintf(stderr,"%s %s %lu %s\n",GetMagickModule(),description); \
    +  description=(char *) MagickRelinquishMemory(description); \
    +  exit(-1); \
    +}
    +
    +  MagickBooleanType
    +    status;
    +
    +  MagickWand
    +    *magick_wand;
    +
    +  if (argc != 3)
    +    {
    +      (void) fprintf(stdout,"Usage: %s image thumbnail\n",argv[0]);
    +      exit(0);
    +    }
    +  /*
    +    Read an image.
    +  */
    +  MagickWandGenesis();
    +  magick_wand=NewMagickWand();
    +  status=MagickReadImage(magick_wand,argv[1]);
    +  if (status == MagickFalse)
    +    ThrowWandException(magick_wand);
    +  /*
    +    Turn the images into a thumbnail sequence.
    +  */
    +  MagickResetIterator(magick_wand);
    +  while (MagickNextImage(magick_wand) != MagickFalse)
    +    MagickResizeImage(magick_wand,106,80,LanczosFilter,1.0);
    +  /*
    +    Write the image then destroy it.
    +  */
    +  status=MagickWriteImages(magick_wand,argv[2],MagickTrue);
    +  if (status == MagickFalse)
    +    ThrowWandException(magick_wand);
    +  magick_wand=DestroyMagickWand(magick_wand);
    +  MagickWandTerminus();
    +  return(0);
    +}
    +
    + +

    Here is another program that shows one way to get and set image pixels with the MagickWand API, contrast.c. It reads an image, applies sigmoidal non-linearity contrast control, and writes the result to disk.

    + +
    #include <stdio.h>
    +#include <stdlib.h>
    +#include <math.h>
    +#include <wand/MagickWand.h>
    +
    +int main(int argc,char **argv)
    +{
    +#define QuantumScale  ((MagickRealType) 1.0/(MagickRealType) QuantumRange)
    +#define SigmoidalContrast(x) \
    +  (QuantumRange*(1.0/(1+exp(10.0*(0.5-QuantumScale*x)))-0.0066928509)*1.0092503)
    +#define ThrowWandException(wand) \
    +{ \
    +  char \
    +    *description; \
    + \
    +  ExceptionType \
    +    severity; \
    + \
    +  description=MagickGetException(wand,&severity); \
    +  (void) fprintf(stderr,"%s %s %lu %s\n",GetMagickModule(),description); \
    +  description=(char *) MagickRelinquishMemory(description); \
    +  exit(-1); \
    +}
    +
    +  long
    +    y;
    +
    +  MagickBooleanType
    +    status;
    +
    +  MagickPixelPacket
    +    pixel;
    +
    +  MagickWand
    +    *contrast_wand,
    +    *image_wand;
    +
    +  PixelIterator
    +    *contrast_iterator,
    +    *iterator;
    +
    +  PixelWand
    +    **contrast_pixels,
    +    **pixels;
    +
    +  register long
    +    x;
    +
    +  unsigned long
    +    width;
    +
    +  if (argc != 3)
    +    {
    +      (void) fprintf(stdout,"Usage: %s image sigmoidal-image\n",argv[0]);
    +      exit(0);
    +    }
    +  /*
    +    Read an image.
    +  */
    +  MagickWandGenesis();
    +  image_wand=NewMagickWand();
    +  status=MagickReadImage(image_wand,argv[1]);
    +  if (status == MagickFalse)
    +    ThrowWandException(image_wand);
    +  contrast_wand=CloneMagickWand(image_wand);
    +  /*
    +    Sigmoidal non-linearity contrast control.
    +  */
    +  iterator=NewPixelIterator(image_wand);
    +  contrast_iterator=NewPixelIterator(contrast_wand);
    +  if ((iterator == (PixelIterator *) NULL) ||
    +      (contrast_iterator == (PixelIterator *) NULL))
    +    ThrowWandException(image_wand);
    +  for (y=0; y < (long) MagickGetImageHeight(image_wand); y++)
    +  {
    +    pixels=PixelGetNextIteratorRow(iterator,&width);
    +    contrast_pixels=PixelGetNextIteratorRow(contrast_iterator,&width);
    +    if ((pixels == (PixelWand **) NULL) ||
    +        (contrast_pixels == (PixelWand **) NULL))
    +      break;
    +    for (x=0; x < (long) width; x++)
    +    {
    +      PixelGetMagickColor(pixels[x],&pixel);
    +      pixel.red=SigmoidalContrast(pixel.red);
    +      pixel.green=SigmoidalContrast(pixel.green);
    +      pixel.blue=SigmoidalContrast(pixel.blue);
    +      pixel.index=SigmoidalContrast(pixel.index);
    +      PixelSetMagickColor(contrast_pixels[x],&pixel);
    +    }
    +    (void) PixelSyncIterator(contrast_iterator);
    +  }
    +  if (y < (long) MagickGetImageHeight(image_wand))
    +    ThrowWandException(image_wand);
    +  contrast_iterator=DestroyPixelIterator(contrast_iterator);
    +  iterator=DestroyPixelIterator(iterator);
    +  image_wand=DestroyMagickWand(image_wand);
    +  /*
    +    Write the image then destroy it.
    +  */
    +  status=MagickWriteImages(contrast_wand,argv[2],MagickTrue);
    +  if (status == MagickFalse)
    +    ThrowWandException(image_wand);
    +  contrast_wand=DestroyMagickWand(contrast_wand);
    +  MagickWandTerminus();
    +  return(0);
    +}
    +
    +

    Now lets perform the same contrast enhancement while taking advantage of our dual or quad-core processing system by running the algorithm in parallel utilizing wand views. The sigmoidal-contrast.c module reads an image, applies sigmoidal non-linearity contrast control, and writes the result to disk just like the previous contrast enhancement program, but now it does its work in parallel (assumes ImageMagick is built with OpenMP support).

    + +
    #include <stdio.h>
    +#include <stdlib.h>
    +#include <math.h>
    +#include <wand/MagickWand.h>
    +
    +static MagickBooleanType SigmoidalContrast(WandView *pixel_view,
    +  const ssize_t y,const int id,void *context)
    +{
    +#define QuantumScale  ((MagickRealType) 1.0/(MagickRealType) QuantumRange)
    +#define SigmoidalContrast(x) \
    +  (QuantumRange*(1.0/(1+exp(10.0*(0.5-QuantumScale*x)))-0.0066928509)*1.0092503)
    +
    +  RectangleInfo
    +    extent;
    +
    +  MagickPixelPacket
    +    pixel;
    +
    +  PixelWand
    +    **pixels;
    +
    +  register long
    +    x;
    +
    +  extent=GetWandViewExtent(contrast_view);
    +  pixels=GetWandViewPixels(contrast_view);
    +  for (x=0; x < (long) (extent.width-extent.height); x++)
    +  {
    +    PixelGetMagickColor(pixels[x],&pixel);
    +    pixel.red=SigmoidalContrast(pixel.red);
    +    pixel.green=SigmoidalContrast(pixel.green);
    +    pixel.blue=SigmoidalContrast(pixel.blue);
    +    pixel.index=SigmoidalContrast(pixel.index);
    +    PixelSetMagickColor(contrast_pixels[x],&pixel);
    +  }
    +  return(MagickTrue);
    +}
    +
    +int main(int argc,char **argv)
    +{
    +#define ThrowViewException(view) \
    +{ \
    +  description=GetWandViewException(view,&severity); \
    +  (void) fprintf(stderr,"%s %s %lu %s\n",GetMagickModule(),description); \
    +  description=(char *) MagickRelinquishMemory(description); \
    +  exit(-1); \
    +}
    +#define ThrowWandException(wand) \
    +{ \
    +  description=MagickGetException(wand,&severity); \
    +  (void) fprintf(stderr,"%s %s %lu %s\n",GetMagickModule(),description); \
    +  description=(char *) MagickRelinquishMemory(description); \
    +  exit(-1); \
    +}
    +
    +  char
    +    *description;
    +
    +  ExceptionType
    +    severity;
    +
    +  MagickBooleanType
    +    status;
    +
    +  MagickPixelPacket
    +    pixel;
    +
    +  MagickWand
    +    *contrast_wand;
    +
    +  WandView
    +    *contrast_view;
    +
    +  if (argc != 3)
    +    {
    +      (void) fprintf(stdout,"Usage: %s image sigmoidal-image\n",argv[0]);
    +      exit(0);
    +    }
    +  /*
    +    Read an image.
    +  */
    +  MagickWandGenesis();
    +  contrast_wand=NewMagickWand();
    +  status=MagickReadImage(contrast_wand,argv[1]);
    +  if (status == MagickFalse)
    +    ThrowWandException(contrast_wand);
    +  /*
    +    Sigmoidal non-linearity contrast control.
    +  */
    +  contrast_view=NewWandView(contrast_wand);
    +  if (contrast_view == (WandView *) NULL)
    +    ThrowWandException(contrast_wand);
    +  status=UpdateWandViewIterator(contrast_view,SigmoidalContrast,(void *) NULL);
    +  if (status == MagickFalse)
    +    ThrowWandException(contrast_wand);
    +  contrast_view=DestroyWandView(contrast_view);
    +  /*
    +    Write the image then destroy it.
    +  */
    +  status=MagickWriteImages(contrast_wand,argv[2],MagickTrue);
    +  if (status == MagickFalse)
    +    ThrowWandException(contrast_wand);
    +  contrast_wand=DestroyMagickWand(contrast_wand);
    +  MagickWandTerminus();
    +  return(0);
    +}
    +
    +

    MagickWand Examples in C illustrates how to use the ImageMagick MagickWand API. Each example is presented as a C function, complete with headers, so that it can be copied to a file and then included in your own C project.

    +
    +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/magick.html b/www/api/magick.html index d360e9fdf..6da401ca0 100644 --- a/www/api/magick.html +++ b/www/api/magick.html @@ -5,185 +5,1337 @@ - - - MagickCore, C API: Read or List Image formats @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + Command-line Tools: Magick @ ImageMagick + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +
    -

    AcquireMagickInfoGetMagickPrecisionIsMagickCoreInstantiatedMagickCoreGenesisMagickCoreTerminusSetMagickPrecision

    +

    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.

    + +

    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:

    + +
    magick rose.jpg rose.png
    +
    + +

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

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

    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
    +
    + +
      + fuzzy-magick +
    + +

    or here we resize an image with improved quality:

    + +
    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');
    +
    + +

    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:

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

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

    + +

    Option Summary

    + +

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

    + +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + -

    AcquireMagickInfo

    + + + + -

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

    + + + + -

    The format of the AcquireMagickInfo method is:

    + + + + -
    -MagickInfo *AcquireMagickInfo(const char *module, const char *name,)
    -
    + + + + -

    A description of each parameter follows:

    + + + + -
    -
    + + + + -
    -
    -
    module
    -
    a character string that represents the module associated with the MagickInfo structure.
    +
    + + + -
    -
    name
    -
    a character string that represents the image format associated with the MagickInfo structure.
    + + + + -
    -
    description
    -
    a character string that represents the image format associated with the MagickInfo structure.
    + + + + -
    - -

    GetMagickPrecision

    + + + + -

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

    + + + + -

    The format of the GetMagickPrecision method is:

    + + + + -
    -int GetMagickPrecision(void)
    -
    + + + + -

    IsMagickCoreInstantiated

    + + + + -

    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
    +
    +
    +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/memory.html b/www/api/memory.html index e307d723e..283d9e9f8 100644 --- a/www/api/memory.html +++ b/www/api/memory.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Memory Allocation @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    + +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/mime.html b/www/api/mime.html index 26561078a..629bbffae 100644 --- a/www/api/mime.html +++ b/www/api/mime.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Mime Methods @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +

    AcquireMimeCacheGetMimeInfoListGetMimeListGetMimeDescriptionGetMimeTypeListMimeInfo

    @@ -207,21 +226,27 @@ MagickBooleanType ListMimeInfo(FILE *file,ExceptionInfo *exception)

    return any errors or warnings in this structure.

    +
    +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/module.html b/www/api/module.html index 1585efc8c..5b9fb1712 100644 --- a/www/api/module.html +++ b/www/api/module.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Loadable Modules @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    + +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/mogrify.html b/www/api/mogrify.html index 5da5cb817..de39432f7 100644 --- a/www/api/mogrify.html +++ b/www/api/mogrify.html @@ -5,118 +5,1317 @@ - - - MagickWand, C API: Command-line Interface @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + Command-line Tools: Mogrify @ ImageMagick + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +
    -

    MagickCommandGenesis

    +

    Example Usage • Option Summary

    + +

    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.

    + +

    Example Usage

    + +

    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:

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

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

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

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

    + +
    magick mogrify -format jpg *.png
    +
    + +

    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.

    + + +

    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.

    + +

    Option Summary

    + +

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

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + -

    MagickCommandGenesis

    + + + + -

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

    + + + + -

    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.

    + + + + -

    The format of the MagickCommandGenesis method is:

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

    A description of each parameter follows:

    + + + + -
    -
    + + + + -
    -
    -
    image_info
    -
    the image info.
    +
    + + + -
    -
    command
    -
    Choose from ConvertImageCommand, IdentifyImageCommand, MogrifyImageCommand, CompositeImageCommand, CompareImagesCommand, ConjureImageCommand, StreamImageCommand, ImportImageCommand, DisplayImageCommand, or AnimateImageCommand.
    + + + + -
    -
    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.
    + + + + -
    -
    metadata
    -
    any metadata is returned here.
    + + + + -
    -
    exception
    -
    return any errors or warnings in this structure.
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    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
    -
    -
    +
    +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/monitor.html b/www/api/monitor.html index d0dc05562..acf97cd48 100644 --- a/www/api/monitor.html +++ b/www/api/monitor.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Monitor the Progress of an Image Operation @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +

    SetImageProgressMonitorSetImageInfoProgressMonitor

    @@ -134,21 +153,27 @@ MagickProgressMonitor SetImageInfoProgressMonitor(ImageInfo *image_info,
    +
    +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/montage.html b/www/api/montage.html index f46750773..87d4efd4a 100644 --- a/www/api/montage.html +++ b/www/api/montage.html @@ -5,72 +5,654 @@ - - - MagickCore, C API: Create an Image Thumbnail @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + Command-line Tools: Montage @ ImageMagick + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +
    -

    Unknown method

    +

    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
    +
    +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/morphology.html b/www/api/morphology.html index 138cf1b0d..736d3674a 100644 --- a/www/api/morphology.html +++ b/www/api/morphology.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Morphological Erosions, Dilations, Openings, and Closings @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    + +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/paint.html b/www/api/paint.html index 1053b2b30..57fcb3be9 100644 --- a/www/api/paint.html +++ b/www/api/paint.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Paint on an Image @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +

    FloodfillPaintImageOilPaintImageOpaquePaintImageTransparentPaintImageTransparentPaintImageChroma

    @@ -268,21 +287,27 @@ 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 de17d778e..e82c653b0 100644 --- a/www/api/pixel-iterator.html +++ b/www/api/pixel-iterator.html @@ -5,53 +5,72 @@ - - + + MagickWand, C API: Pixel Iterator Methods @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    + +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/pixel-wand.html b/www/api/pixel-wand.html index cf4888424..8729396f4 100644 --- a/www/api/pixel-wand.html +++ b/www/api/pixel-wand.html @@ -5,53 +5,72 @@ - - + + MagickWand, C API: Pixel Wand Methods @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    + +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/profile.html b/www/api/profile.html index 17559c712..d0da2be98 100644 --- a/www/api/profile.html +++ b/www/api/profile.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Dealing with Image Profiles @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +
    +
    +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/property.html b/www/api/property.html index 493c0b14f..4b2b31bcb 100644 --- a/www/api/property.html +++ b/www/api/property.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Get/Set Image Properties @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    + +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/quantize.html b/www/api/quantize.html index 10f54383b..fb92880c6 100644 --- a/www/api/quantize.html +++ b/www/api/quantize.html @@ -5,476 +5,217 @@ - - - MagickCore, C API: Reduce the Number of Unique Colors in an Image @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + Color Reduction Utilizing Adaptive Spatial Subdivision @ ImageMagick + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +
    -

    QuantizeImageAcquireQuantizeInfoCloneQuantizeInfoCompressImageColormapDestroyQuantizeInfoGetImageQuantizeErrorGetQuantizeInfoPosterizeImageQuantizeImageQuantizeImagesRemapImageRemapImagesSetGrayscaleImage

    - -

    QuantizeImage

    - -

    QuantizeImage() takes a standard RGB or monochrome images and quantizes them down to some fixed number of colors.

    - -

    For purposes of color allocation, an image is a set of n pixels, where each pixel is a point in RGB space. RGB space is a 3-dimensional vector space, and each pixel, Pi, is defined by an ordered triple of red, green, and blue coordinates, (Ri, Gi, Bi).

    - -

    Each primary color component (red, green, or blue) represents an intensity which varies linearly from 0 to a maximum value, Cmax, which corresponds to full saturation of that color. Color allocation is defined over a domain consisting of the cube in RGB space with opposite vertices at (0,0,0) and (Cmax, Cmax, Cmax). QUANTIZE requires Cmax = 255.

    - -

    The algorithm maps this domain onto a tree in which each node represents a cube within that domain. In the following discussion these cubes are defined by the coordinate of two opposite vertices (vertex nearest the origin in RGB space and the vertex farthest from the origin).

    - -

    The tree's root node represents the entire domain, (0,0,0) through (Cmax,Cmax,Cmax). Each lower level in the tree is generated by subdividing one node's cube into eight smaller cubes of equal size. This corresponds to bisecting the parent cube with planes passing through the midpoints of each edge.

    - -

    The basic algorithm operates in three phases: Classification, Reduction, and Assignment. Classification builds a color description tree for the image. Reduction collapses the tree until the number it represents, at most, the number of colors desired in the output image. Assignment defines the output image's color map and sets each pixel's color by restorage_class in the reduced tree. Our goal is to minimize the numerical discrepancies between the original colors and quantized colors (quantization error).

    - -

    Classification begins by initializing a color description tree of sufficient depth to represent each possible input color in a leaf. However, it is impractical to generate a fully-formed color description tree in the storage_class phase for realistic values of Cmax. If colors components in the input image are quantized to k-bit precision, so that Cmax= 2k-1, the tree would need k levels below the root node to allow representing each possible input color in a leaf. This becomes prohibitive because the tree's total number of nodes is 1 + sum(i=1, k, 8k).

    - -

    A complete tree would require 19,173,961 nodes for k = 8, Cmax = 255.

    -
    avoid building a fully populated tree, QUANTIZE
    -

    (1) Initializes data structures for nodes only as they are needed; (2) Chooses a maximum depth for the tree as a function of the desired number of colors in the output image (currently log2(colormap size)).

    - -

    For each pixel in the input image, storage_class scans downward from the root of the color description tree. At each level of the tree it identifies the single node which represents a cube in RGB space containing the pixel's color. It updates the following data for each such node:

    - -
    -    n1: Number of pixels whose color is contained in the RGB cube which
    -    this node represents;
    -
    - -

    n2: Number of pixels whose color is not represented in a node at lower depth in the tree; initially, n2 = 0 for all nodes except leaves of the tree.

    - -

    Sr, Sg, Sb: Sums of the red, green, and blue component values for all pixels not classified at a lower depth. The combination of these sums and n2 will ultimately characterize the mean color of a set of pixels represented by this node.

    - -

    E: the distance squared in RGB space between each pixel contained within a node and the nodes' center. This represents the quantization error for a node.

    - -

    Reduction repeatedly prunes the tree until the number of nodes with n2 > 0 is less than or equal to the maximum number of colors allowed in the output image. On any given iteration over the tree, it selects those nodes whose E count is minimal for pruning and merges their color statistics upward. It uses a pruning threshold, Ep, to govern node selection as follows:

    - -
    -
    - -
    Ep = 0 while number of nodes with (n2 > 0) > required maximum number of colors prune all nodes such that E <= Ep Set Ep to minimum E in remaining nodes
    - -
    This has the effect of minimizing any quantization error when merging two nodes together.
    - -
    When a node to be pruned has offspring, the pruning procedure invokes itself recursively in order to prune the tree from the leaves upward. n2, Sr, Sg, and Sb in a node being pruned are always added to the corresponding data in that node's parent. This retains the pruned node's color characteristics for later averaging.
    - -
    For each node, n2 pixels exist for which that node represents the smallest volume in RGB space containing those pixel's colors. When n2 > 0 the node will uniquely define a color in the output image. At the beginning of reduction, n2 = 0 for all nodes except a the leaves of the tree which represent colors present in the input image.
    - -
    The other pixel count, n1, indicates the total number of colors within the cubic volume which the node represents. This includes n1 - n2 pixels whose colors should be defined by nodes at a lower level in the tree.
    - -
    Assignment generates the output image from the pruned tree. The output
    -
    -
    parts
    -
    (1) A color map, which is an array of color descriptions (RGB triples) for each color present in the output image; (2) A pixel array, which represents each pixel as an index into the color map array.
    - -
    First, the assignment phase makes one pass over the pruned color description tree to establish the image's color map. For each node with n2 > 0, it divides Sr, Sg, and Sb by n2 . This produces the mean color of all pixels that classify no lower than this node. Each of these colors becomes an entry in the color map.
    - -
    Finally, the assignment phase reclassifies each pixel in the pruned tree to identify the deepest node containing the pixel's color. The pixel's value in the pixel array becomes the index of this node's mean color in the color map.
    - -
    This method is based on a similar algorithm written by Paul Raveling.
    +

    Algorithm Description • Measuring Color Reduction Error

    -
    -
    -

    AcquireQuantizeInfo

    - -

    AcquireQuantizeInfo() allocates the QuantizeInfo structure.

    - -

    The format of the AcquireQuantizeInfo method is:

    - -
    -QuantizeInfo *AcquireQuantizeInfo(const ImageInfo *image_info)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    image_info
    -
    the image info.
    - -
    -
    -

    CloneQuantizeInfo

    - -

    CloneQuantizeInfo() makes a duplicate of the given quantize info structure, or if quantize info is NULL, a new one.

    - -

    The format of the CloneQuantizeInfo method is:

    - -
    -QuantizeInfo *CloneQuantizeInfo(const QuantizeInfo *quantize_info)
    -
    - -

    A description of each parameter follows:

    +

    This document describes how ImageMagick performs color reduction on an image. To fully understand what follows, you should have a knowledge of basic imaging techniques and the tree data structure and terminology.

    -
    -
    +

    Algorithm Description

    -
    -
    -
    clone_info
    -
    Method CloneQuantizeInfo returns a duplicate of the given quantize info, or if image info is NULL a new one.
    +

    For purposes of color allocation, an image is a set of n pixels, where each pixel is a point in RGB space. RGB space is a 3-dimensional vector space, and each pixel, p(i), is defined by an ordered triple of red, green, and blue coordinates, (r(i), g(i), b(i)).

    -
    -
    quantize_info
    -
    a structure of type info.
    +

    Each primary color component (red, green, or blue) represents an intensity which varies linearly from 0 to a maximum value, Cmax, which corresponds to full saturation of that color. Color allocation is defined over a domain consisting of the cube in RGB space with opposite vertices at (0, 0, 0) and (Cmax, Cmax, Cmax). ImageMagick requires Cmax= 255.

    -
    -
    -

    CompressImageColormap

    - -

    CompressImageColormap() compresses an image colormap by removing any duplicate or unused color entries.

    +

    The algorithm maps this domain onto a tree in which each node represents a cube within that domain. In the following discussion, these cubes are defined by the coordinate of two opposite vertices: The vertex nearest the origin in RGB space and the vertex farthest from the origin.

    -

    The format of the CompressImageColormap method is:

    +

    The tree's root node represents the entire domain, (0,0,0) through (Cmax, Cmax, Cmax). Each lower level in the tree is generated by subdividing one node's cube into eight smaller cubes of equal size. This corresponds to bisecting the parent cube with planes passing through the midpoints of each edge.

    -
    -MagickBooleanType CompressImageColormap(Image *image,
    -  ExceptionInfo *exception)
    -
    +

    The basic algorithm operates in three phases:

    -

    A description of each parameter follows:

    +
      +
    1. Classification
    2. +
    3. Reduction
    4. +
    5. Assignment
    6. +
    -
    -
    +

    Classification

    -
    -
    -
    image
    -
    the image.
    +

    Classification builds a color description tree for the image. Reduction collapses the tree until the number it represents, at most, is the number of colors desired in the output image. Assignment defines the output image's color map and sets each pixel's color by reclassification in the reduced tree. Our goal is to minimize the numerical discrepancies between the original colors and quantized colors. To learn more about quantization error, see Measuring Color Reduction Error.

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

    Classification begins by initializing a color description tree of sufficient depth to represent each possible input color in a leaf. However, it is impractical to generate a fully-formed color description tree in the classification phase for realistic values of Cmax. If color components in the input image are quantized to k-bit precision, so that Cmax = 2^k-1, the tree would need k levels below the root node to allow representing each possible input color in a leaf. This becomes prohibitive because the tree's total number of nodes:

    -
    -
    -

    DestroyQuantizeInfo

    +
    total nodes = 1+Sum(8^i), i=1,k
     
    -

    DestroyQuantizeInfo() deallocates memory associated with an QuantizeInfo structure.

    +For k=8, +nodes = 1 + (8^1+8^2+....+8^8) + = 1 + 8(8^8 - 1)/(8 - 1) + = 19,173,961 +
    -

    The format of the DestroyQuantizeInfo method is:

    +

    Therefore, to avoid building a fully populated tree, ImageMagick:

    -
    -QuantizeInfo *DestroyQuantizeInfo(QuantizeInfo *quantize_info)
    -
    +
      +
    1. initializes data structures for nodes only as they are needed;
    2. +
    3. chooses a maximum depth for the tree as a function of the desired number of colors in the output image (currently the base-two logarithm of Cmax).
    4. +
    -

    A description of each parameter follows:

    +
    For Cmax=255,
    +maximum tree depth = log2(256)
    +                   = 8
    +
    -
    -
    +

    A tree of this depth generally allows the best representation of the source image with the fastest computational speed and the least amount of memory. However, the default depth is inappropriate for some images. Therefore, the caller can request a specific tree depth.

    -
    -
    -
    quantize_info
    -
    Specifies a pointer to an QuantizeInfo structure.
    +

    For each pixel in the input image, classification scans downward from the root of the color description tree. At each level of the tree, it identifies the single node which represents a cube in RGB space containing the pixels' color. It updates the following data for each such node:

    -
    +
    +
    n1
    +
    number of pixels whose color is contained in the RGB cube which this node represents;
    +
    n2
    +
    number of pixels whose color is not represented in a node at lower depth in the tree; initially, n2=0 for all nodes except leaves of the tree.
    +
    Sr,Sg,Sb
    +
    sums of the red, green, and blue component values for all pixels not classified at a lower depth. The combination of these sums and n2 will ultimately characterize the mean color of a set of pixels represented by this node.
    +
    E
    +
    the distance squared in RGB space between each pixel contained within a node and the nodes' center. This represents the quantization error for a node.
    -

    GetImageQuantizeError

    - -

    GetImageQuantizeError() measures the difference between the original and quantized images. This difference is the total quantization error. The error is computed by summing over all pixels in an image the distance squared in RGB space between each reference pixel value and its quantized value. These values are computed:

    -
    -    o mean_error_per_pixel:  This value is the mean error for any single
    -pixel in the image.
    -
    +

    Reduction

    -
    normalized_mean_square_error
    -

    This value is the normalized mean quantization error for any single pixel in the image. This distance measure is normalized to a range between 0 and 1. It is independent of the range of red, green, and blue values in the image.

    +

    Reduction repeatedly prunes the tree until the number of nodes with n2 > 0 is less than or equal to the maximum number of colors allowed in the output image. On any given iteration over the tree, it selects those nodes whose E value is minimal for pruning and merges their color statistics upward. It uses a pruning threshold, Ep, to govern node selection as follows:

    -
    normalized_maximum_square_error
    -

    Thsi value is the normalized maximum quantization error for any single pixel in the image. This distance measure is normalized to a range between 0 and 1. It is independent of the range of red, green, and blue values in your image.

    +
    Ep = 0
    +while number of nodes with (n2 > 0) > required maximum number of colors
    +   prune all nodes such that E <= Ep
    +   Set Ep  to minimum E in remaining nodes
    +
    -

    The format of the GetImageQuantizeError method is:

    +

    This has the effect of minimizing any quantization error when merging two nodes together.

    -
    -MagickBooleanType GetImageQuantizeError(Image *image,
    -  ExceptionInfo *exception)
    -
    +

    When a node to be pruned has offspring, the pruning procedure invokes itself recursively in order to prune the tree from the leaves upward. The values of n2, Sr, Sg, and Sb in a node being pruned are always added to the corresponding data in that node's parent. This retains the pruned node's color characteristics for later averaging.

    -

    A description of each parameter follows.

    +

    For each node, n2 pixels exist for which that node represents the smallest volume in RGB space containing those pixel's colors. When n2 > 0 the node will uniquely define a color in the output image. At the beginning of reduction, n2 = 0 for all nodes except the leaves of the tree which represent colors present in the input image.

    -
    image
    -

    the image.

    +

    The other pixel count, n1, indicates the total number of colors within the cubic volume which the node represents. This includes n1 - n2 pixels whose colors should be defined by nodes at a lower level in the tree.

    -
    exception
    -

    return any errors or warnings in this structure.

    +

    Assignment

    -

    GetQuantizeInfo

    +

    Assignment generates the output image from the pruned tree. The output image consists of two parts:

    +
      +
    1. A color map, which is an array of color descriptions (RGB triples) for each color present in the output image.
    2. -

      GetQuantizeInfo() initializes the QuantizeInfo structure.

      +
    3. A pixel array, which represents each pixel as an index into the color map array.
    4. +
    -

    The format of the GetQuantizeInfo method is:

    +

    First, the assignment phase makes one pass over the pruned color description tree to establish the image's color map. For each node with n2 > 0, it divides Sr, Sg, and Sb by n2. This produces the mean color of all pixels that classify no lower than this node. Each of these colors becomes an entry in the color map.

    -
    -GetQuantizeInfo(QuantizeInfo *quantize_info)
    -
    +

    Finally, the assignment phase reclassifies each pixel in the pruned tree to identify the deepest node containing the pixel's color. The pixel's value in the pixel array becomes the index of this node's mean color in the color map.

    -

    A description of each parameter follows:

    +

    Empirical evidence suggests that the distances in color spaces such as YUV, or YIQ correspond to perceptual color differences more closely than do distances in RGB space. These color spaces may give better results when color reducing an image. Here the algorithm is as described except each pixel is a point in the alternate color space. For convenience, the color components are normalized to the range 0 to a maximum value, Cmax. The color reduction can then proceed as described.

    -
    -
    - -
    -
    -
    quantize_info
    -
    Specifies a pointer to a QuantizeInfo structure.
    - -
    -
    -

    PosterizeImage

    +

    Measuring Color Reduction Error

    -

    PosterizeImage() reduces the image to a limited number of colors for a "poster" effect.

    +

    Depending on the image, the color reduction error may be obvious or invisible. Images with high spatial frequencies (such as hair or grass) will show error much less than pictures with large smoothly shaded areas (such as faces). This because the high-frequency contour edges introduced by the color reduction process are masked by the high frequencies in the image.

    -

    The format of the PosterizeImage method is:

    +

    To measure the difference between the original and color reduced images (the total color reduction error), ImageMagick sums over all pixels in an image the distance squared in RGB space between each original pixel value and its color reduced value. ImageMagick prints several error measurements including the mean error per pixel, the normalized mean error, and the normalized maximum error.

    -
    -MagickBooleanType PosterizeImage(Image *image,const size_t levels,
    -  const DitherMethod dither_method,ExceptionInfo *exception)
    -
    +

    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.

    -

    A description of each parameter follows:

    +

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

    -
    -
    - -
    -
    -
    image
    -
    Specifies a pointer to an Image structure.
    - -
    -
    levels
    -
    Number of color levels allowed in each channel. Very low values (2, 3, or 4) have the most visible effect.
    - -
    -
    dither_method
    -
    choose from UndefinedDitherMethod, NoDitherMethod, RiemersmaDitherMethod, FloydSteinbergDitherMethod.
    - -
    -
    exception
    -
    return any errors or warnings in this structure.
    - -
    -
    -

    QuantizeImage

    +
    + + + + + + + + + + + + + +
    mean error per pixelis the mean error for any single pixel in the image.
    normalized mean square erroris the normalized mean square quantization error for any single pixel in the image. This distance measure is normalized to a range between 0 and 1. It is independent of the range of red, green, and blue values in the image.
    normalized maximum square erroris the largest normalized square quantization error for any single pixel in the image. This distance measure is normalized to a range between of red, green, and blue values in the image.
    -

    QuantizeImage() analyzes the colors within a reference image and chooses a fixed number of colors to represent the image. The goal of the algorithm is to minimize the color difference between the input and output image while minimizing the processing time.

    - -

    The format of the QuantizeImage method is:

    - -
    -MagickBooleanType QuantizeImage(const QuantizeInfo *quantize_info,
    -  Image *image,ExceptionInfo *exception)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    quantize_info
    -
    Specifies a pointer to an QuantizeInfo structure.
    - -
    -
    image
    -
    the image.
    - -
    -
    exception
    -
    return any errors or warnings in this structure.
    - -
    -
    -

    QuantizeImages

    - -

    QuantizeImages() analyzes the colors within a set of reference images and chooses a fixed number of colors to represent the set. The goal of the algorithm is to minimize the color difference between the input and output images while minimizing the processing time.

    - -

    The format of the QuantizeImages method is:

    - -
    -MagickBooleanType QuantizeImages(const QuantizeInfo *quantize_info,
    -  Image *images,ExceptionInfo *exception)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    quantize_info
    -
    Specifies a pointer to an QuantizeInfo structure.
    - -
    -
    images
    -
    Specifies a pointer to a list of Image structures.
    - -
    -
    exception
    -
    return any errors or warnings in this structure.
    - -
    -
    -

    RemapImage

    - -

    RemapImage() replaces the colors of an image with the closest of the colors from the reference image.

    - -

    The format of the RemapImage method is:

    - -
    -MagickBooleanType RemapImage(const QuantizeInfo *quantize_info,
    -  Image *image,const Image *remap_image,ExceptionInfo *exception)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    quantize_info
    -
    Specifies a pointer to an QuantizeInfo structure.
    - -
    -
    image
    -
    the image.
    - -
    -
    remap_image
    -
    the reference image.
    - -
    -
    exception
    -
    return any errors or warnings in this structure.
    - -
    -
    -

    RemapImages

    - -

    RemapImages() replaces the colors of a sequence of images with the closest color from a reference image.

    - -

    The format of the RemapImage method is:

    - -
    -MagickBooleanType RemapImages(const QuantizeInfo *quantize_info,
    -  Image *images,Image *remap_image,ExceptionInfo *exception)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    quantize_info
    -
    Specifies a pointer to an QuantizeInfo structure.
    - -
    -
    images
    -
    the image sequence.
    - -
    -
    remap_image
    -
    the reference image.
    - -
    -
    exception
    -
    return any errors or warnings in this structure.
    - -
    -
    -

    SetGrayscaleImage

    - -

    SetGrayscaleImage() converts an image to a PseudoClass grayscale image.

    - -

    The format of the SetGrayscaleImage method is:

    - -
    -MagickBooleanType SetGrayscaleImage(Image *image,
    -  ExceptionInfo *exception)
    -
    - -

    A description of each parameter follows:

    - -
    -
    - -
    -
    -
    image
    -
    The image.
    - -
    -
    exception
    -
    return any errors or warnings in this structure.
    - -
    -
    +
    +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/registry.html b/www/api/registry.html index ec8728141..ea519f3b6 100644 --- a/www/api/registry.html +++ b/www/api/registry.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: The Image Registry @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +

    DefineImageRegistryDeleteImageRegistryGetImageRegistryGetNextImageRegistryRegistryComponentTerminusRemoveImageRegistryResetImageRegistryIteratorSetImageRegistry

    @@ -227,21 +246,27 @@ MagickBooleanType SetImageRegistry(const RegistryType type,
    +
    +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/resize.html b/www/api/resize.html index aad0128f5..4c6014465 100644 --- a/www/api/resize.html +++ b/www/api/resize.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Resize an Image @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +

    AdaptiveResizeImageInterpolativeResizeImageLiquidRescaleImageMagnifyImageMinifyImageResampleImageResizeImageSampleImageScaleImageThumbnailImage

    @@ -417,21 +436,27 @@ 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 6d6ffc5b1..06ddb79f1 100644 --- a/www/api/resource.html +++ b/www/api/resource.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Monitor or Limit Resource Consumption @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +

    AcquireMagickResourceAcquireUniqueFileResourceGetMagickResourceGetMagickResourceLimitListMagickResourceInfoRelinquishMagickResourceRelinquishUniqueFileResourceSetMagickResourceLimit

    @@ -244,6 +263,8 @@ MagickBooleanType SetMagickResourceLimit(const ResourceType type,
    +
    +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/segment.html b/www/api/segment.html index ef35f692c..ef43a4db7 100644 --- a/www/api/segment.html +++ b/www/api/segment.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Segment an Image with Thresholding Fuzzy c-Means @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +

    SegmentImage

    @@ -89,21 +108,27 @@ MagickBooleanType SegmentImage(Image *image,

    return any errors or warnings in this structure.

    +
    +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/shear.html b/www/api/shear.html index 9753d1772..624207a6b 100644 --- a/www/api/shear.html +++ b/www/api/shear.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Shear or Rotate an Image by an Arbitrary Angle @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +

    The XShearImageDeskewImageIntegralRotateImageShearImageShearRotateImage

    @@ -160,21 +179,27 @@ Image *ShearRotateImage(const Image *image,const double degrees,

    return any errors or warnings in this structure.

    +
    +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/signature.html b/www/api/signature.html index 486d8c7c0..c1aabd506 100644 --- a/www/api/signature.html +++ b/www/api/signature.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Compute a Message Digest for an Image @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +

    SignatureImage

    @@ -82,21 +101,27 @@ 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 368075b32..6c1afb55a 100644 --- a/www/api/statistic.html +++ b/www/api/statistic.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Image Statistics @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +

    EvaluateImageFunctionImageGetImageEntropyGetImageExtremaGetImageKurtosisGetImageMeanGetImageMomentsGetImagePerceptualHashGetImageRangeGetImageStatisticsPolynomialImageStatisticImage

    @@ -464,21 +483,27 @@ 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 2799274fd..3c404bbf9 100644 --- a/www/api/stream.html +++ b/www/api/stream.html @@ -5,96 +5,268 @@ - - - MagickCore, C API: The Pixel FIFO @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + Command-line Tools: Stream @ ImageMagick + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +
    -

    StreamImageCommand

    +

    Example Usage • Option Summary

    + +

    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.

    + +

    Example Usage

    + +

    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:

    + +
    magick stream -map rgb -storage-type char image.jpg pixels.dat
    +magick display -depth 8 -size 640x480 rgb:pixels.dat
    +
    + +

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

    + +
    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:

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

    Option Summary

    + +

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

    + + + + + + + + + + + + + + + + + + + + + + + + + + + -

    StreamImageCommand

    + + + + -

    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.

    + + + + -

    The format of the StreamImageCommand method is:

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

    A description of each parameter follows:

    + + + + -
    -
    + + + + -
    -
    -
    image_info
    -
    the image info.
    +
    + + + -
    -
    argc
    -
    the number of elements in the argument vector.
    + + + + -
    -
    argv
    -
    A text array containing the command line arguments.
    + + + + -
    -
    metadata
    -
    any metadata is returned here.
    + + + + -
    -
    exception
    -
    return any errors or warnings in this structure.
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    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
    -
    -
    +
    +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/transform.html b/www/api/transform.html index 9bbc217be..3cc223dd1 100644 --- a/www/api/transform.html +++ b/www/api/transform.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Transform an Image @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    +

    AutoOrientImageChopImageCropImageCropImageToTilesExcerptImageExtentImageFlipImageFlopImageRollImageShaveImageSpliceImageTransformImageTransposeImageTransverseImageTrimImage

    @@ -511,21 +530,27 @@ 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 2a8b49cc4..f006db04f 100644 --- a/www/api/version.html +++ b/www/api/version.html @@ -5,53 +5,72 @@ - - + + MagickCore, C API: Get the Version and Copyrights @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    + +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/api/wand-view.html b/www/api/wand-view.html index 034bc931c..4e2126eb2 100644 --- a/www/api/wand-view.html +++ b/www/api/wand-view.html @@ -5,53 +5,72 @@ - - + + MagickWand, C API: Wand View Methods @ ImageMagick - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + -
    -
    - - - -
    -
    -
    +
    + +
    +
    + +
    -
    - - + + + + + + + \ No newline at end of file diff --git a/www/architecture.html b/www/architecture.html index 062a8fc67..057fddb12 100644 --- a/www/architecture.html +++ b/www/architecture.html @@ -5,30 +5,30 @@ - - + + Architecture @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -1464,11 +1464,11 @@ 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 d7dc8fbb1..e4549ffa5 100644 --- a/www/binary-releases.html +++ b/www/binary-releases.html @@ -45,7 +45,7 @@ Command-line Resources Develop - Search + Search Community @@ -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 45dfef52b..e1487bf13 100644 --- a/www/changelog.html +++ b/www/changelog.html @@ -5,30 +5,30 @@ - - + + Changelog @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -589,11 +589,11 @@ - - - - + + + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/cipher.html b/www/cipher.html index 398f50070..6e0ccd431 100644 --- a/www/cipher.html +++ b/www/cipher.html @@ -5,30 +5,30 @@ - - + + Encipher or Decipher an Image @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -149,11 +149,11 @@ Examples - - - - + + + + - \ 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 99cd3c964..8a5526524 100644 --- a/www/color-management.html +++ b/www/color-management.html @@ -5,30 +5,30 @@ - - + + Color Management @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -143,11 +143,11 @@ 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 e57609415..a7104721e 100644 --- a/www/color.html +++ b/www/color.html @@ -5,30 +5,30 @@ - - + + Color Names @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -4941,11 +4941,11 @@ 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/command-line-options.html b/www/command-line-options.html index 90804c1a0..c65c42d2e 100644 --- a/www/command-line-options.html +++ b/www/command-line-options.html @@ -5,30 +5,30 @@ - - + + Command-line Options @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -8032,11 +8032,11 @@ 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 3fcb7065e..53879a2a4 100644 --- a/www/command-line-processing.html +++ b/www/command-line-processing.html @@ -5,30 +5,30 @@ - - + + Command-line Processing @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -620,11 +620,11 @@ 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 dbedf284e..35da6d351 100644 --- a/www/command-line-tools.html +++ b/www/command-line-tools.html @@ -5,30 +5,30 @@ - - + + Command-line Tools @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -117,11 +117,11 @@ - - - - + + + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/compare.html b/www/compare.html index 65a4be4ee..6ca0d1a45 100644 --- a/www/compare.html +++ b/www/compare.html @@ -5,30 +5,30 @@ - - + + Command-line Tools: Compare @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -432,11 +432,11 @@ 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 775422e7c..543a816bc 100644 --- a/www/compose.html +++ b/www/compose.html @@ -5,30 +5,30 @@ - - + + Alpha Compositing @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -640,3 +640,4 @@ href="https://www.imagemagick.org/script/command-line-options.html#list">-list c + \ No newline at end of file diff --git a/www/composite.html b/www/composite.html index 7a51680ac..9087bd5c3 100644 --- a/www/composite.html +++ b/www/composite.html @@ -5,30 +5,30 @@ - - + + Command-line Tools: Composite @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -536,11 +536,11 @@ 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 c171acb6f..04debcbff 100644 --- a/www/conjure.html +++ b/www/conjure.html @@ -5,30 +5,30 @@ - - + + Command-line Tools: Conjure @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -1145,11 +1145,11 @@ 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 cba9c7daf..df0469582 100644 --- a/www/connected-components.html +++ b/www/connected-components.html @@ -5,30 +5,30 @@ - - + + Connected Components Labeling @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -127,11 +127,11 @@ - - - - + + + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/contact.html b/www/contact.html index c5031110b..329b91a7f 100644 --- a/www/contact.html +++ b/www/contact.html @@ -5,30 +5,30 @@ - - + + Contact the Development Team @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -146,10 +146,10 @@ - - - - + + + + diff --git a/www/convert.html b/www/convert.html index 22afe8221..4aad9d3e4 100644 --- a/www/convert.html +++ b/www/convert.html @@ -5,30 +5,30 @@ - - + + Command-line Tools: Convert @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -1335,11 +1335,11 @@ 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 3b2b4efdf..8e77590a6 100644 --- a/www/develop.html +++ b/www/develop.html @@ -5,30 +5,30 @@ - - + + Develop @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -212,11 +212,11 @@ - - - - + + + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/display.html b/www/display.html index 85a9211f0..70a761a58 100644 --- a/www/display.html +++ b/www/display.html @@ -5,30 +5,30 @@ - - + + Command-line Tools: Display @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -576,11 +576,11 @@ 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 b3ab9cf36..bfe0882b5 100644 --- a/www/distribute-pixel-cache.html +++ b/www/distribute-pixel-cache.html @@ -5,30 +5,30 @@ - - + + Distributed Pixel Cache @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -105,11 +105,11 @@ 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 82676951e..27017c769 100644 --- a/www/download.html +++ b/www/download.html @@ -5,30 +5,30 @@ - - + + Download @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -447,11 +447,11 @@ objShell.Exec("magick ""e:/myimages/image.png"" ""e:/myimages/image.jpg""") - - - - + + + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/escape.html b/www/escape.html index 6fafd40dc..5a81c95ef 100644 --- a/www/escape.html +++ b/www/escape.html @@ -5,30 +5,30 @@ - - + + Format and Print Image Properties @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -892,11 +892,11 @@ 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 8cff1e702..b1d1bed92 100644 --- a/www/examples.html +++ b/www/examples.html @@ -5,30 +5,30 @@ - - + + Examples of ImageMagick Usage @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -92,11 +92,11 @@ - - - - + + + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/exception.html b/www/exception.html index 06ba41ebc..cde8002e9 100644 --- a/www/exception.html +++ b/www/exception.html @@ -5,30 +5,30 @@ - - + + Exceptions @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -288,3 +288,4 @@ + \ No newline at end of file diff --git a/www/export.html b/www/export.html index 36f9b2e26..12a7c2365 100644 --- a/www/export.html +++ b/www/export.html @@ -5,30 +5,30 @@ - - + + Export Classification @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -92,11 +92,11 @@ - - - - + + + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/formats.html b/www/formats.html index 910f39b9c..13ad352e3 100644 --- a/www/formats.html +++ b/www/formats.html @@ -5,30 +5,30 @@ - - + + Formats @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -1986,11 +1986,11 @@ 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 9ca24b002..15efe1c77 100644 --- a/www/fx.html +++ b/www/fx.html @@ -5,30 +5,30 @@ - - + + The Fx Special Effects Image Operator @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -421,11 +421,11 @@ 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/gradient.html b/www/gradient.html index 773ea2c65..0455534c3 100644 --- a/www/gradient.html +++ b/www/gradient.html @@ -5,30 +5,30 @@ - - + + Image Gradients @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -98,14 +98,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.

    @@ -182,7 +182,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

    @@ -194,7 +194,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.

    @@ -203,25 +203,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
     
    -

    +

    @@ -241,11 +241,11 @@ 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 73cadbe13..1f10ea35c 100644 --- a/www/high-dynamic-range.html +++ b/www/high-dynamic-range.html @@ -5,30 +5,30 @@ - - + + High Dynamic-Range Images @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -117,11 +117,11 @@ 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 d96d2ae3e..175f2b38c 100644 --- a/www/history.html +++ b/www/history.html @@ -5,30 +5,30 @@ - - + + History @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -109,11 +109,11 @@ 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 4462ae09e..e24f6e89b 100644 --- a/www/identify.html +++ b/www/identify.html @@ -5,30 +5,30 @@ - - + + Command-line Tools: Identify @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -436,11 +436,11 @@ 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 5fcb45a16..320917546 100644 --- a/www/import.html +++ b/www/import.html @@ -5,30 +5,30 @@ - - + + Command-line Tools: Import @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -437,11 +437,11 @@ - - - - + + + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/index.html b/www/index.html index 7ccbebfc7..00d5ce3fd 100644 --- a/www/index.html +++ b/www/index.html @@ -5,30 +5,30 @@ - - + + Convert, Edit, Or Compose Bitmap Images @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -267,4 +267,4 @@ Use ImageMagick - - + + Install from Source @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -166,11 +166,11 @@ to compile the program and on completion run the program.

    - - - - + + + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/jp2.html b/www/jp2.html index 5d0d3c47b..79ffadbf4 100644 --- a/www/jp2.html +++ b/www/jp2.html @@ -5,30 +5,30 @@ - - + + JP2 Encoding Options @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -169,11 +169,11 @@ - - - - + + + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/license.html b/www/license.html index 6360e8fec..390054816 100644 --- a/www/license.html +++ b/www/license.html @@ -5,30 +5,30 @@ - - + + License @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -214,11 +214,11 @@ - - - - + + + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/links.html b/www/links.html index 56a7062cf..86eec5759 100644 --- a/www/links.html +++ b/www/links.html @@ -5,30 +5,30 @@ - - + + Related Web Sites @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -175,11 +175,11 @@ - - - - + + + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/magick++.html b/www/magick++.html index 784032ce8..c950026c7 100644 --- a/www/magick++.html +++ b/www/magick++.html @@ -5,30 +5,30 @@ - - + + Magick++, C++ API @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -196,11 +196,11 @@ int main(int argc,char **argv) - - - - + + + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/magick-core.html b/www/magick-core.html index 6d9ca39b2..905afd39a 100644 --- a/www/magick-core.html +++ b/www/magick-core.html @@ -5,30 +5,30 @@ - - + + MagickCore, Low-level C API @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -341,11 +341,11 @@ int main(int argc,char **argv) - - - - + + + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/magick-script.html b/www/magick-script.html index b8f4052d4..c26010310 100644 --- a/www/magick-script.html +++ b/www/magick-script.html @@ -5,30 +5,30 @@ - - + + Command-line Tools: Magick-script @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -1294,11 +1294,11 @@ transparent, extract, background, or shape the alpha channel - - - - + + + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/magick-vector-graphics.html b/www/magick-vector-graphics.html index b1773e6fe..5896aa7cb 100644 --- a/www/magick-vector-graphics.html +++ b/www/magick-vector-graphics.html @@ -5,30 +5,30 @@ - - + + Magick Vector Graphics @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -85,7 +85,7 @@ command line, from an MVG file, from an SVG

    and here is the result:

    When the drawing gets sufficiently complex, we recommend you assemble the graphic primitives into a MVG file. For our example, we use piechart.mvg:

    @@ -250,7 +250,7 @@ pop graphic-context

    which produces this rendering:

      - piechart + piechart

    However, in general, MVG is sufficiently difficult to work with that you probably want to use a program to generate your graphics in the SVG format. ImageMagick automagically converts SVG to MVG and renders your image, for example, we render piechart.svg with this command:

    @@ -883,11 +883,11 @@ round - - - - + + + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/magick-wand.html b/www/magick-wand.html index a824876a6..6749c0561 100644 --- a/www/magick-wand.html +++ b/www/magick-wand.html @@ -5,30 +5,30 @@ - - + + MagickWand, C API @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -393,11 +393,11 @@ int main(int argc,char **argv) - - - - + + + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/magick.html b/www/magick.html index 7d2c5d08a..a5a9d798f 100644 --- a/www/magick.html +++ b/www/magick.html @@ -5,30 +5,30 @@ - - + + Command-line Tools: Magick @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -1331,11 +1331,11 @@ transparent, extract, background, or shape the alpha channel - - - - + + + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/miff.html b/www/miff.html index 657d82dd1..b1d98729b 100644 --- a/www/miff.html +++ b/www/miff.html @@ -5,30 +5,30 @@ - - + + Magick Image File Format @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -256,11 +256,11 @@ or fewer colors in the image, each byte of image data contains an index value. I - - - - + + + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/mirror.html b/www/mirror.html index 2dbf53e7c..48e166206 100644 --- a/www/mirror.html +++ b/www/mirror.html @@ -5,30 +5,30 @@ - - + + Mirror @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -127,11 +127,11 @@ - - - - + + + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/mogrify.html b/www/mogrify.html index ed5353cb6..c3a4d820f 100644 --- a/www/mogrify.html +++ b/www/mogrify.html @@ -5,30 +5,30 @@ - - + + Command-line Tools: Mogrify @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -1311,11 +1311,11 @@ 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 7a37fb902..a2b974ed4 100644 --- a/www/montage.html +++ b/www/montage.html @@ -5,30 +5,30 @@ - - + + Command-line Tools: Montage @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -648,11 +648,11 @@ transparent, extract, background, or shape the alpha channel - - - - + + + + - \ 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 daf961def..e32f8499b 100644 --- a/www/motion-picture.html +++ b/www/motion-picture.html @@ -5,30 +5,30 @@ - - + + Motion Picture Digital Images @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -202,11 +202,11 @@ 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 6557969d7..12c95159f 100644 --- a/www/opencl.html +++ b/www/opencl.html @@ -5,30 +5,30 @@ - - + + Parallel Execution with OpenCL @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -126,11 +126,11 @@ 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 1f8482cce..03f3fa6dd 100644 --- a/www/openmp.html +++ b/www/openmp.html @@ -5,30 +5,30 @@ - - + + Parallel Execution with OpenMP @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -109,11 +109,11 @@ 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 d48df8b05..255cce963 100644 --- a/www/perl-magick.html +++ b/www/perl-magick.html @@ -5,30 +5,30 @@ - - + + PerlMagick, Perl API @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -2553,11 +2553,11 @@ XServerWarning - - - - + + + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/porting.html b/www/porting.html index 20fe0dbd7..0b26f6d9b 100644 --- a/www/porting.html +++ b/www/porting.html @@ -5,30 +5,30 @@ - - + + Porting to ImageMagick Version 7 @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -656,11 +656,11 @@ 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 482d04ed5..906fd66cb 100644 --- a/www/quantize.html +++ b/www/quantize.html @@ -5,30 +5,30 @@ - - + + Color Reduction Utilizing Adaptive Spatial Subdivision @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -218,3 +218,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 90ca6e507..cbcf02a87 100644 --- a/www/resources.html +++ b/www/resources.html @@ -5,30 +5,30 @@ - - + + Resources @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -375,11 +375,11 @@ $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 242541764..1e08134ca 100644 --- a/www/search.html +++ b/www/search.html @@ -5,30 +5,30 @@ - - + + Search @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -124,10 +124,10 @@ - - - - + + + + diff --git a/www/security-policy.html b/www/security-policy.html index abac7c3a8..fb6d98d43 100644 --- a/www/security-policy.html +++ b/www/security-policy.html @@ -5,30 +5,30 @@ - - + + Security Policy @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -226,11 +226,11 @@ 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 04746f1c2..e6d9a4ff1 100644 --- a/www/sitemap.html +++ b/www/sitemap.html @@ -5,30 +5,30 @@ - - + + Sitemap @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -249,11 +249,11 @@ - - - - + + + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/stream.html b/www/stream.html index 89235ad4c..713538c25 100644 --- a/www/stream.html +++ b/www/stream.html @@ -5,30 +5,30 @@ - - + + Command-line Tools: Stream @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -281,11 +281,11 @@ magick display -depth 8 -size 640x480 rgb:pixels.dat - - - - + + + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/subversion.html b/www/subversion.html index 5cdafa05f..bb375552b 100644 --- a/www/subversion.html +++ b/www/subversion.html @@ -46,7 +46,7 @@ Command-line Resources Develop - Search + Search Community @@ -82,7 +82,7 @@ svn update

    Back to top • Public Key • - Contact Us

    + Contact Us

    © 1999-2018 ImageMagick Studio LLC

    diff --git a/www/support.html b/www/support.html index e62ce9e76..3ac376f64 100644 --- a/www/support.html +++ b/www/support.html @@ -5,30 +5,30 @@ - - + + Support ImageMagick Development @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -126,7 +126,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:

    @@ -166,11 +166,11 @@ USA - - - - + + + + - \ No newline at end of file + \ No newline at end of file diff --git a/www/webp.html b/www/webp.html index 82ea93efc..368cf7edd 100644 --- a/www/webp.html +++ b/www/webp.html @@ -5,30 +5,30 @@ - - + + WebP Encoding Options @ ImageMagick - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + +
    @@ -193,11 +193,11 @@ - - - - + + + + - \ No newline at end of file + \ No newline at end of file