From: Cristy Date: Sat, 19 May 2018 13:56:35 +0000 (-0400) Subject: https://bugs.chromium.org/p/oss-fuzz/issues/detail?id=8344 X-Git-Tag: 7.0.7-34~12 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=a41243695fcbbc02f19b77e16cd08cd4cd6e1039;p=imagemagick https://bugs.chromium.org/p/oss-fuzz/issues/detail?id=8344 --- diff --git a/ImageMagick/Magick++/Blob.html b/ImageMagick/Magick++/Blob.html deleted file mode 100644 index a309e6c53..000000000 --- a/ImageMagick/Magick++/Blob.html +++ /dev/null @@ -1,93 +0,0 @@ - - - - - -Magick++ API: Working with Blobs - - - -

Magick::Blob

Blob provides the means to contain any opaque data. It is named after the term "Binary Large OBject" commonly used to describe unstructured data (such as encoded images) which is stored in a database. While the function of Blob is very simple (store a pointer and and size associated with allocated data), the Blob class provides some very useful capabilities. In particular, it is fully reference counted just like the Image class.

The Blob class supports value assignment while preserving any outstanding earlier versions of the object. Since assignment is via a pointer internally, Blob is efficient enough to be stored directly in an STL container or any other data structure which requires assignment. In particular, by storing a Blob in an associative container (such as STL's 'map') it is possible to create simple indexed in-memory "database" of Blobs.

Magick++ currently uses Blob to contain encoded images (e.g. JPEG) as well as ICC and IPTC profiles. Since Blob is a general-purpose class, it may be used for other purposes as well.

The methods Blob provides are shown in the following table:

-
-

Blob Methods

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

- Method	- Return Type	- Signature(s)	- Description
- Blob		- void	- Default constructor
		- const void* data_, size_t length_	- Construct object with data, making a copy of the supplied data
		- const Blob& blob_	- Copy constructor (reference counted)
- operator=	- Blob	- const Blob& blob_	- Assignment operator (reference counted)
- update	- void	- const void* data_, size_t length_	- Update object contents, making a copy of the supplied data. Any existing data in the object is deallocated.
- data	- const void*	- void	- Obtain pointer to data
- length	- size_t	- void	- Obtain data length
- updateNoCopy	- void	- void* data_, size_t length_, Blob::Allocator allocator_ = Blob::NewAllocator	- Update object contents, using supplied pointer directly (no copy) Any existing data in the object is deallocated. The user must ensure that the pointer supplied is not deleted or otherwise modified after it has been supplied to this method. The optional allocator_ parameter allows the user to specify if the C (MallocAllocator) or C++ (NewAllocator) memory allocation system was used to allocate the memory. The default is to use the C++ memory allocator.

- - diff --git a/ImageMagick/Magick++/CoderInfo.html b/ImageMagick/Magick++/CoderInfo.html deleted file mode 100644 index dfab62a84..000000000 --- a/ImageMagick/Magick++/CoderInfo.html +++ /dev/null @@ -1,104 +0,0 @@ - - - - - -Magick++ API: Access Raw Image Pixels - - - -

Magick::CoderInfo

The CoderInfo class provides the means to provide information regarding ImageMagick support for an image format (designated by a magick string). It may be used to provide support for a specific named format (provided as an argument to the constructor), or as an element of a container when format support is queried using the coderInfoList() templated function.

The following code fragment illustrates how CoderInfo may be used.

-CoderInfo info("GIF"); 
-cout < info->name() << ": (" << info->description() << ") : "; 
-cout << "Readable = "; 
-if ( info->isReadable() ) 
-  cout << "true"; 
-else 
-  cout << "false"; 
-cout << ", "; 
-cout << "Writable = "; 
-if ( info->isWritable() ) 
-  cout << "true"; 
-else 
-  cout << "false"; 
-cout << ", "; 
-cout << "Multiframe = "; 
-if ( info->isMultiframe() ) 
-  cout << "true"; 
-else 
-  cout << "false"; 
-cout << endl;
-

The methods available in the CoderInfo class are shown in the following table:

-
-

CoderInfo Methods

- Method	- Returns	- Signature	- Description
- CoderInfo		- void	- Construct object corresponding to named format (e.g. "GIF"). An exception is thrown if the format is not supported.
- name	- std::string	- void	- Format name (e.g. "GIF").
- description	- std::string	- void	- Format description (e.g. "CompuServe graphics interchange format").
- isReadable	- bool	- void	- Format is readable.
- isWritable	- bool	- void	- Format is writeable.
- isMultiFrame	- bool	- void	- Format supports multiple frames.

- - diff --git a/ImageMagick/Magick++/Color.html b/ImageMagick/Magick++/Color.html deleted file mode 100644 index 3df33a428..000000000 --- a/ImageMagick/Magick++/Color.html +++ /dev/null @@ -1,260 +0,0 @@ - - - - - -Magick++ API: Working with Color - - - -

Magick::Color

Color is the base color class in Magick++. It is a simple container class for the pixel red, green, blue, and alpha values scaled to fit ImageMagick's Quantum size. Normally users will instantiate a class derived from Color which supports the color model that fits the needs of the application. The Color class may be constructed directly from an SVG-style color string.

Quantum

- -The base type used to represent color samples in ImageMagick is the Quantum type. Pixels are represented by a structure of Quantum values. For example, an RGB pixel contains red, green, and blue quantums, while an RGBA pixel contains red, green, blue, and opacity quantums. The maximum value that a Quantum can attain is specified by a constant value represented by the MaxRGB define, which is itself determined by the number of bits in a Quantum. The QuantumDepth build option determines the number of bits in a Quantum. - -

Quantum

- -Quantum is the internal representation of a pixel in ImageMagick. ImageMagick may be compiled to support 32, 64, or 128 bit pixels of type Quantum. This is controlled by the value of the QuantumDepth define. The default is 32 bit pixels (QuantumDepth=8), which provides the best performance and the least resource consumption. If additional color precision or range is desired, then ImageMagick may be compiled with QuantumDepth=16 or QuantumDepth=32. The following table shows the relationship between QuantumDepth, the type of Quantum, and the overall Quantum size. -

Effect Of QuantumDepth Values

- - ---- - - - - - - - - - - - - - - - -

- QuantumDepth	- Quantum Typedef	- Quantum Size
- 8	- unsigned char	- 32 bits
- 16	- unsigned short	- 64 bits
- 32	- unsigned int	- 128 bits

Color Class

The Color base class is not intended to be used directly. Normally a user will construct a derived class or inherit from this class. Color arguments are must be scaled to fit the Quantum size. The Color class contains a pointer to a Quantum, which may be allocated by the Color class, or may refer to an existing pixel in an image.

An alternate way to construct the class is via an SVG-compatible color specification string (e.g. Color("red") or Color ("#FF0000")). Since the class may be constructed from a string, convenient strings may be passed in place of an explicit Color object in methods which accept a reference to Color. Color may also be converted to a std::string for convenience in user interfaces, and for saving settings to a text file.

-class Color -{ - public: - Color ( Quantum red_, - Quantum green_, - Quantum blue_ ); - Color ( Quantum red_, - Quantum green_, - Quantum blue_, - Quantum alpha_ ); - Color ( const std::string &svgColor_ ); - Color ( const char * svgColor_ ); - Color ( void ); - virtual ~Color ( void ); - Color ( const Color & color_ ); - - // Red color (range 0 to MaxRGB) - void redQuantum ( Quantum red_ ); - Quantum redQuantum ( void ) const; - - // Green color (range 0 to MaxRGB) - void greenQuantum ( Quantum green_ ); - Quantum greenQuantum ( void ) const; - - // Blue color (range 0 to MaxRGB) - void blueQuantum ( Quantum blue_ ); - Quantum blueQuantum ( void ) const; - - // Alpha level (range OpaqueOpacity=0 to TransparentOpacity=MaxRGB) - void alphaQuantum ( Quantum alpha_ ); - Quantum alphaQuantum ( void ) const; - - // Scaled (to 1.0) version of alpha for use in sub-classes - // (range opaque=0 to transparent=1.0) - void alpha ( double alpha_ ); - double alpha ( void ) const; - - // Does object contain valid color? - void isValid ( bool valid_ ); - bool isValid ( void ) const; - - // Set color via SVG color specification string - const Color& operator= ( const std::string & svgColor_ ); - const Color& operator= ( const char * svgColor_ ); - - // Assignment operator - Color& operator= ( const Color& color_ ); - - // Return SVG color specification string - /* virtual */ operator std::string() const; - - // Return ImageMagick Quantum - operator Quantum() const; - - // Construct color via ImageMagick Quantum - Color ( const Quantum &color_ ); - - // Set color via ImageMagick Quantum - const Color& operator= ( Quantum &color_ ); -}; -

Color Derived Classes

- --- - - - - - - - - - - -

- ColorRGB	- Representation of RGB color with red, green, and blue specified as ratios (0 to 1)
- ColorGray	- Representation of grayscale sRGB color (equal parts red, green, and blue) specified as a ratio (0 to 1)
- ColorMono	- Representation of a black/white color (true/false)
- ColorYUV	- Representation of a color in the YUV colorspace

ColorRGB

Representation of an sRGB color. All color arguments have a valid range of 0.0 - 1.0.

-class ColorRGB : public Color 
-{ 
-  public: 
-    ColorRGB ( double red_, double green_, double blue_ ); 
-    ColorRGB ( void ); 
-    ColorRGB ( const Color & color_ ); 
-    /* virtual */  ~ColorRGB ( void ); 
-  
-    void           red ( double red_ ); 
-    double         red ( void ) const; 
-  
-    void           green ( double green_ ); 
-    double         green ( void ) const; 
-  
-    void           blue ( double blue_ ); 
-    double         blue ( void ) const;
-
-    // Assignment operator from base class 
-    ColorRGB& operator= ( const Color& color_ ); 
-}; 
-

ColorGray

Representation of a grayscale color (in linear colorspace). Grayscale is simply RGB with equal parts of red, green, and blue. All double arguments have a valid range of 0.0 - 1.0.

-class ColorGray : public Color 
-{ 
-  public: 
-    ColorGray ( double shade_ ); 
-    ColorGray ( void ); 
-    ColorGray ( const Color & color_ ); 
-    /* virtual */ ~ColorGray ();
-
-    void           shade ( double shade_ ); 
-    double         shade ( void ) const;
-
-    // Assignment operator from base class 
-    ColorGray& operator= ( const Color& color_ ); 
-}; 
-

ColorMono

Representation of a black/white pixel (in RGB colorspace). Color arguments are constrained to 'false' (black pixel) and 'true' (white pixel).

-class ColorMono : public Color 
-{ 
-  public: 
-    ColorMono ( bool mono_ ); 
-    ColorMono ( void ); 
-    ColorMono ( const Color & color_ ); 
-    /* virtual */ ~ColorMono (); 
-  
-    void           mono ( bool mono_ ); 
-    bool           mono ( void ) const;
-
-    // Assignment operator from base class 
-    ColorMono& operator= ( const Color& color_ ); 
-}; 
-

ColorHSL

Representation of a color in Hue/Saturation/Luminosity (HSL) colorspace.

-class ColorHSL : public Color 
-{ 
-  public: 
-    ColorHSL ( double hue_, double saturation_, double luminosity_ ); 
-    ColorHSL ( void ); 
-    ColorHSL ( const Color & color_ ); 
-    /* virtual */  ~ColorHSL ( ); 
-  
-    void           hue ( double hue_ ); 
-    double         hue ( void ) const; 
-  
-    void           saturation ( double saturation_ ); 
-    double         saturation ( void ) const; 
-  
-    void           luminosity ( double luminosity_ ); 
-    double         luminosity ( void ) const;
-
-    // Assignment operator from base class 
-    ColorHSL& operator= ( const Color& color_ ); 
-}; 
-

ColorYUV

Representation of a color in YUV colorspace (used to encode color for television transmission).

Argument ranges:

Y: 0.0 through 1.0

U: -0.5 through 0.5

V: -0.5 through 0.5

- -

-class ColorYUV : public Color 
-{ 
-  public: 
-    ColorYUV ( double y_, double u_, double v_ ); 
-    ColorYUV ( void ); 
-    ColorYUV ( const Color & color_ ); 
-    /* virtual */ ~ColorYUV ( void ); 
-  
-    void           u ( double u_ ); 
-    double         u ( void ) const; 
-  
-    void           v ( double v_ ); 
-    double         v ( void ) const; 
-  
-    void           y ( double y_ ); 
-    double         y ( void ) const;
-
-    // Assignment operator from base class 
-    ColorYUV& operator= ( const Color& color_ ); 
-}; 
-

- - diff --git a/ImageMagick/Magick++/Drawable.html b/ImageMagick/Magick++/Drawable.html deleted file mode 100644 index 24497b285..000000000 --- a/ImageMagick/Magick++/Drawable.html +++ /dev/null @@ -1,798 +0,0 @@ - - - - - -Magick++ API: Drawing on Images - - - -

Magick::Drawable

Drawable provides a convenient interface for preparing vector, image, or text arguments for the Image::draw() method. Each instance of a Drawable sub-class represents a single drawable object. Drawable objects may be drawn "one-by-one" via multiple invocations of the Image draw() method, or may be drawn "all-at-once" by passing a list of Drawable objects to the Image draw() method. The one-by-one approach is convenient for simple drawings, while the list-based approach is appropriate for drawings which require more sophistication.

The following is an example using the Drawable subclasses with a one-by-one approach to draw the following figure:

example -

-#include <string> -#include <iostream> -#include <Magick++.h> - -using namespace std; -using namespace Magick; - -int main(int /*argc*/,char **argv) -{ - try { - InitializeMagick(*argv); - - // Create base image (white image of 300 by 200 pixels) - Image image( Geometry(300,200), Color("white") ); - - // Set draw options - image.strokeColor("red"); // Outline color - image.fillColor("green"); // Fill color - image.strokeWidth(5); - - // Draw a circle - image.draw( DrawableCircle(100,100, 50,100) ); - - // Draw a rectangle - image.draw( DrawableRectangle(200,200, 270,170) ); - - // Display the result - image.display( ); - } - catch( exception & error_ ) - { - cout << "Caught exception: " << error_.what() << endl; - return 1; - } - - return 0; -} -

Since Drawable is an object it may be saved in an array or a list for later (perhaps repeated) use. The following example shows how to draw the same figure using the list-based approach:

-#include <string> -#include <iostream> -#include <list> -#include <Magick++.h> - -using namespace std; -using namespace Magick; - -int main(int /*argc*/,char **/*argv*/) -{ - try { - - InitializeMagick(*argv); - - // Create base image (white image of 300 by 200 pixels) - Image image( Geometry(300,200), Color("white") ); - - // Construct drawing list - std::list<Magick::Drawable> drawList; - - // Add some drawing options to drawing list - drawList.push_back(DrawableStrokeColor("red")); // Outline color - drawList.push_back(DrawableStrokeWidth(5)); // Stroke width - drawList.push_back(DrawableFillColor("green")); // Fill color - - // Add a Circle to drawing list - drawList.push_back(DrawableCircle(100,100, 50,100)); - - // Add a Rectangle to drawing list - drawList.push_back(DrawableRectangle(200,100, 270,170)); - - // Draw everything using completed drawing list - image.draw(drawList); - - // Display the result - image.display( ); - } - catch( exception & error_ ) - { - cout << "Caught exception: " << error_.what() << endl; - return 1; - } - - return 0; -} -

Drawable depends on the simple Coordinate structure which represents a pair of x,y coodinates. The methods provided by the Coordinate structure are shown in the following table:

Coordinate Structure Methods

- - - - - - - - - - - - - - - - - - - -

- Method/Member	- Signature	- Description
- Coordinate	- void	- Default Constructor
- Coordinate	- double x_, double y_	- Constructor, setting first & second
- x	- double x_	- x coordinate member
- y	- double y_	- y coordinate member

The Drawable classes are shown in the following table. Only constructor signatures are documented here. Each Drawable class also provides methods by which each individual parameter may be adjusted.

Drawable Classes

- Sub-Class	- Constructor Signature	- Description
- DrawableAffine	- double sx_, double sy_, double rx_, double ry_, double tx_, double ty_	- Specify a transformation matrix to adjust scaling, rotation, and translation (coordinate transformation) for subsequently drawn objects in the same or decendent drawing context. The sx_ & sy_ parameters represent the x & y scale factors, the rx_ & ry_ parameters represent the x & y rotation, and the tx_ & ty_ parameters represent the x & y translation.
- DrawableAffine	- void	- Specify a transformation matrix to adjust scaling, rotation, and translation (coordinate transformation) for subsequently drawn objects in the same or decendent drawing context. Initialized to unity (no effect) affine values. Use class methods (not currently documented) to adjust individual parameters from their unity values.
- DrawableAngle	- double angle_	- Set drawing angle
- DrawableArc	- double startX_, double startY_, double endX_, double endY_, double startDegrees, double endDegrees_	- Draw an arc using the stroke color and based on the circle starting at coordinates startX_,startY_, and ending with coordinates endX_,endY_, and bounded by the rotational arc startDegrees_,endDegrees_
- DrawableBezier	- const std::list<Magick::Coordinate> &coordinates_	- Draw a bezier curve using the stroke color and based on the coordinates specified by the coordinates_ list.
- DrawableClipPath	- const std::string &id_	- Select a drawing clip path matching id_.
- DrawableCircle	- double originX_, double originY_, double perimX_, double perimY_	- Draw a circle using the stroke color and thickness using specified origin and perimeter coordinates. If a fill color is specified, then the object is filled.
- DrawableColor	- double x_, double y_, PaintMethod paintMethod_	- Color image according to paintMethod. The point method recolors the target pixel. The replace method recolors any pixel that matches the color of the target pixel. Floodfill recolors any pixel that matches the color of the target pixel and is a neighbor, whereas filltoborder recolors any neighbor pixel that is not the border color. Finally, reset recolors all pixels.
- DrawableCompositeImage	- double x_, double y_, const std::string &filename_	- Composite current image with contents of specified image, at specified coordinates. If the matte attribute is set to true, then the image composition will consider an alpha channel, or transparency, present in the image file so that non-opaque portions allow part (or all) of the composite image to show through.
	- double x_, double y_, const Image &image_
	- double x_, double y_, double width_, double height_, const std::string &filename_	- Composite current image with contents of specified image, rendered with specified width and height, at specified coordinates. If the matte attribute is set to true, then the image composition will consider an alpha channel, or transparency, present in the image file so that non-opaque portions allow part (or all) of the composite image to show through. If the specified width or height is zero, then the image is composited at its natural size, without enlargement or reduction.
	- double x_, double y_, double width_, double height_, const Image &image_
	- double x_, double y_, double width_, double height_, const std::string &filename_, CompositeOperator composition_	- Composite current image with contents of specified image, rendered with specified width and height, using specified composition algorithm, at specified coordinates. If the matte attribute is set to true, then the image composition will consider an alpha channel, or transparency, present in the image file so that non-opaque portions allow part (or all) of the composite image to show through. If the specified width or height is zero, then the image is composited at its natural size, without enlargement or reduction.
	- double x_, double y_, double width_, double height_, const Image &image_, CompositeOperator composition_
- DrawableDashArray	- const double* dasharray_	- Specify the pattern of dashes and gaps used to stroke paths. The strokeDashArray represents a zero-terminated array of numbers that specify the lengths of alternating dashes and gaps in pixels. If an odd number of values is provided, then the list of values is repeated to yield an even number of values. A typical strokeDashArray_ array might contain the members 5 3 2 0, where the zero value indicates the end of the pattern array.
- DrawableDashOffset	- double offset_	- Specify the distance into the dash pattern to start the dash. See documentation on SVG's stroke-dashoffset property for usage details.
- DrawableEllipse	- double originX_, double originY_, double radiusX_, double radiusY_, double arcStart_, double arcEnd_	- Draw an ellipse using the stroke color and thickness, specified origin, x & y radius, as well as specified start and end of arc in degrees. If a fill color is specified, then the object is filled.
- DrawableFillColor	- const Color &color_	- Specify drawing object fill color.
- DrawableFillRule	- FillRule fillRule_	- Specify the algorithm which is to be used to determine what parts of the canvas are included inside the shape. See documentation on SVG's fill-rule property for usage details.
- DrawableFillOpacity	- double opacity_	- Specify opacity to use when drawing using fill color.
- DrawableFont	- const std::string &font_	- Specify font name to use when drawing text.
- DrawableFont	- const std::string &family_, -StyleType style_, -unsigned int weight_, -StretchType stretch_	- Specify font family, style, weight (one of the set { 100 \| 200 \| 300 \| 400 \| 500 \| 600 \| 700 \| 800 \| 900 } with 400 being the normal size), and stretch to be used to select the font used when drawing text. Wildcard matches may be applied to style via the AnyStyle enumeration, applied to weight if weight is zero, and applied to stretch via the AnyStretch enumeration.
- DrawableGravity	- GravityType gravity_	- Specify text positioning gravity.
- DrawableLine	- double startX_, double startY_, double endX_, double endY_	- Draw a line using stroke color and thickness using starting and ending coordinates
- DrawableMatte	- double x_, double y_, PaintMethod paintMethod_	- Change the pixel matte value to transparent. The point method changes the matte value of the target pixel. The replace method changes the matte value of any pixel that matches the color of the target pixel. Floodfill changes the matte value of any pixel that matches the color of the target pixel and is a neighbor, whereas filltoborder changes the matte value of any neighbor pixel that is not the border color, Finally reset changes the matte value of all pixels.
- DrawableMiterLimit	- size_t miterLimit_	- Specify miter limit. When two line segments meet at a sharp angle and miter joins have been specified for 'lineJoin', it is possible for the miter to extend far beyond the thickness of the line stroking the path. The miterLimit' imposes a limit on the ratio of the miter length to the 'lineWidth'. The default value of this parameter is 4.
- DrawablePath	- const std::list<Magick::VPath> &path_	- Draw on image using vector path.
- DrawablePoint	- double x_, double y_	- Draw a point using stroke color and thickness at coordinate
- DrawablePointSize	- double pointSize_	- Set font point size.
- DrawablePolygon	- const std::list<Magick::Coordinate> &coordinates_	- Draw an arbitrary polygon using stroke color and thickness consisting of three or more coordinates contained in an STL list. If a fill color is specified, then the object is filled.
- DrawablePolyline	- const std::list<Magick::Coordinate> &coordinates_	- Draw an arbitrary polyline using stroke color and thickness consisting of three or more coordinates contained in an STL list. If a fill color is specified, then the object is filled.
- DrawablePopClipPath	- void	- Pop (terminate) clip path definition started by DrawablePushClipPath.
- DrawablePopGraphicContext	- void	- Pop Graphic Context. Removing the current graphic context from the graphic context stack restores the options to the values they had prior to the preceding DrawablePushGraphicContext operation.
- DrawablePushClipPath	- const std::string &id_	- Push (create) clip path definition with id_. Clip patch definition consists of subsequent drawing commands, terminated by DrawablePopClipPath.
- DrawablePushGraphicContext	- void	- Push Graphic Context. When a graphic context is pushed, options set after the context is pushed (such as coordinate transformations, color settings, etc.) are saved to a new graphic context. This allows related options to be saved on a graphic context "stack" in order to support heirarchical nesting of options. When DrawablePopGraphicContext is used to pop the current graphic context, the options in effect during the last DrawablePushGraphicContext operation are restored.
- DrawablePushPattern	- std::string &id_, ssize_t x_, ssize_t y_, size_t width_, size_t height_	- Start a pattern definition with arbitrary pattern name specified by id_, pattern offset specified by x_ and y_, and pattern size specified by width_ and height_. The pattern is defined within the coordinate system defined by the specified offset and size. Arbitrary drawing objects (including DrawableCompositeImage) may be specified between DrawablePushPattern and DrawablePopPattern in order to draw the pattern. Normally the pair DrawablePushGraphicContext & DrawablePopGraphicContext are used to enclose a pattern definition. Pattern definitions are terminated by a DrawablePopPattern object.
- DrawablePopPattern	- void	- Terminate a pattern definition started via DrawablePushPattern.
- DrawableRectangle	- double upperLeftX_, double upperLeftY_, double lowerRightX_, double lowerRightY	- Draw a rectangle using stroke color and thickness from upper-left coordinates to lower-right coordinates. If a fill color is specified, then the object is filled.
- DrawableRotation	- double angle_	- Set rotation to use when drawing (coordinate transformation).
- DrawableRoundRectangle	- double centerX_, double centerY_, double width_, double hight_, double cornerWidth_, double cornerHeight_	- Draw a rounded rectangle using stroke color and thickness, with specified center coordinate, specified width and height, and specified corner width and height. If a fill color is specified, then the object is filled.
- DrawableScaling	- double x_, double y_	- Apply scaling in x and y direction while drawing objects (coordinate transformation).
- DrawableSkewX	- double angle_	- Apply Skew in X direction (coordinate transformation)
- DrawableSkewY	- double angle_	- Apply Skew in Y direction
- DrawableStrokeAntialias	- bool flag_	- Antialias while drawing lines or object outlines.
- DrawableStrokeColor	- const Color &color_	- Set color to use when drawing lines or object outlines.
- DrawableStrokeLineCap	- LineCap linecap_	- Specify the shape to be used at the end of open subpaths when they are stroked. Values of LineCap are UndefinedCap, ButtCap, RoundCap, and SquareCap.
- DrawableStrokeLineJoin	- LineJoin linejoin_	- Specify the shape to be used at the corners of paths (or other vector shapes) when they are stroked. Values of LineJoin are UndefinedJoin, MiterJoin, RoundJoin, and BevelJoin.
- DrawableStrokeOpacity	- double opacity_	- Opacity to use when drawing lines or object outlines.
- DrawableStrokeWidth	- double width_	- Set width to use when drawing lines or object outlines.
- DrawableText	- double x_, double y_, std::string text_	- Annotate image with text using stroke color, font, font pointsize, and box color (text background color), at specified coordinates. If text contains special format characters the image filename, type, width, height, or other image attributes may be incorporated in the text (see label()).
- DrawableText	- const double x_, const double y_, const std::string &text_, const std::string &encoding_	- Annotate image with text represented with text encoding, using current stroke color, font, font pointsize, and box color (text background color), at specified coordinates. If text contains special format characters the image filename, type, width, height, or other image attributes may be incorporated in the text (see label()). - The text encoding specifies the code set to use for text annotations. The only character encoding which may be specified at this time is "UTF-8" for representing Unicode as a sequence of bytes. Specify an empty string to set text encoding to the system's default. Successful text annotation using Unicode may require fonts designed to support Unicode.
- DrawableTextAntialias	- bool flag_	- Antialias while drawing text (default true). The main reason to disable text antialiasing is to avoid adding new colors to the image.
- DrawableTextDecoration	- DecorationType decoration_	- Specify decoration (e.g. UnderlineDecoration) to apply to text.
- DrawableTextUnderColor	- const Color &color_	- Draw a box under rendered text using the specified color.
- DrawableTranslation	- double x_, double y_	- Apply coordinate translation (set new coordinate origin).
- DrawableViewbox	- ssize_t x1_, ssize_t y1_, ssize_t x2_, ssize_t y2_	- Dimensions of the output viewbox. If the image is to be written to a vector format (e.g. MVG or SVG), then a DrawablePushGraphicContext() object should be pushed to the head of the list, followed by a DrawableViewbox() statement to establish the output canvas size. A matching DrawablePopGraphicContext() object should be pushed to the tail of the list.

Vector Path Classes

The vector paths supported by Magick++ are based on those supported by the SVG XML specification. Vector paths are not directly drawable, they must first be supplied as a constructor argument to the DrawablePath class in order to create a drawable object. The DrawablePath class effectively creates a drawable compound component which may be replayed as desired. If the drawable compound component consists only of vector path objects using relative coordinates then the object may be positioned on the image by preceding it with a DrawablePath which sets the current drawing coordinate. Alternatively coordinate transforms may be used to translate the origin in order to position the object, rotate it, skew it, or scale it.

The "moveto" commands

The "moveto" commands establish a new current point. The effect is as if the "pen" were lifted and moved to a new location. A path data segment must begin with either one of the "moveto" commands or one of the "arc" commands. Subsequent "moveto" commands (i.e., when the "moveto" is not the first command) represent the start of a new subpath:

Moveto Classes

- ---- - - - - - - - - - - - - - -

- Sub-Class	- Constructor Signature	- Description
- PathMovetoAbs	- const Magick::Coordinate &coordinate_	- Start a new sub-path at the given coordinate. PathMovetoAbs indicates that absolute coordinates will follow; PathMovetoRel indicates that relative coordinates will follow. If a relative moveto appears as the first element of the path, then it is treated as a pair of absolute coordinates. If a moveto is followed by multiple pairs of coordinates, the subsequent pairs are treated as implicit lineto commands.
- PathMovetoAbs	- const std::list<Magick::Coordinate> &coordinates_
- PathMovetoRel	- const Magick::Coordinate &coordinate_
- PathMovetoRel	- const std::list<Magick::Coordinate> &coordinates_

The "closepath" command

The "closepath" command causes an automatic straight line to be drawn from the current point to the initial point of the current subpath:

Closepath Classes

- ---- - - - - - - -

- Sub-Class	- Constructor Signature	- Description
- PathClosePath	- void	- Close the current subpath by drawing a straight line from the current point to current subpath's most recent starting point (usually, the most recent moveto point).

The "lineto" commands

The various "lineto" commands draw straight lines from the current point to a new point:

Lineto Classes

- ---- - - - - - - - - - - - - - - - - - - - - - - - - - - - -

- Sub-Class	- Constructor Signature	- Description
- PathLinetoAbs	- const Magick::Coordinate& coordinate_	- Draw a line from the current point to the given coordinate which becomes the new current point. PathLinetoAbs indicates that absolute coordinates are used; PathLinetoRel indicates that relative coordinates are used. A number of coordinates pairs may be specified in a list to draw a polyline. At the end of the command, the new current point is set to the final set of coordinates provided.
- PathLinetoAbs	- const std::list<Magick::Coordinate> &coordinates_
- PathLinetoRel	- const Magick::Coordinate& coordinate_
- PathLinetoRel	- const std::list<Magick::Coordinate> &coordinates_
- PathLinetoHorizontalAbs	- double x_	- Draws a horizontal line from the current point (cpx, cpy) to (x, cpy). PathLinetoHorizontalAbs indicates that absolute coordinates are supplied; PathLinetoHorizontalRel indicates that relative coordinates are supplied. At the end of the command, the new current point becomes (x, cpy) for the final value of x.
- PathLinetoHorizontalRel	- double x_
- PathLinetoVerticalAbs	- double y_	- Draws a vertical line from the current point (cpx, cpy) to (cpx, y). PathLinetoVerticalAbs indicates that absolute coordinates are supplied; PathLinetoVerticalRel indicates that relative coordinates are supplied. At the end of the command, the new current point becomes (cpx, y) for the final value of y.
- PathLinetoVerticalRel	- double y_

The curve commands

These three groups of commands draw curves:

-
Cubic BÃ©zier commands. A cubic BÃ©zier segment is defined by a start point, an end point, and two control points.
-
Quadratic BÃ©zier commands. A quadratic BÃ©zier segment is defined by a start point, an end point, and one control point.
-
Elliptical arc commands. An elliptical arc segment draws a segment of an ellipse.

The cubic BÃ©zier curve commands

The cubic BÃ©zier commands depend on the PathCurvetoArgs argument class, which has the constructor signature

-  PathCurvetoArgs( double x1_, double y1_, 
-                   double x2_, double y2_, 
-                   double x_, double y_ );
-

The commands are as follows:

Cubic BÃ©zier Curve Classes

- ---- - - - - - - - - - - - - - - - - - - - - - - - - -

- Sub-Class	- Constructor Signature	- Description
- PathCurvetoAbs	- const Magick::PathCurvetoArgs &args_	- Draws a cubic BÃ©zier curve from the current point to (x,y) using (x1,y1) as the control point at the beginning of the curve and (x2,y2) as the control point at the end of the curve. PathCurvetoAbs indicates that absolutecoordinates will follow; PathCurvetoRel indicates that relative coordinates will follow. Multiple sets of coordinates may be specified to draw a polybezier. At the end of the command, the new current point becomes the final (x,y) coordinate pair used in the polybezier.
- PathCurvetoAbs	- const std::list<Magick::PathCurvetoArgs> &args_
- PathCurvetoRel	- const Magick::PathCurvetoArgs &args_
- PathCurvetoRel	- const std::list<Magick::PathCurvetoArgs> &args_
- PathSmoothCurvetoAbs	- const Magick::Coordinate &coordinates_	- Draws a cubic BÃ©zier curve from the current point to (x,y). The first control point is assumed to be the reflection of the second control point on the previous command relative to the current point. (If there is no previous command or if the previous command was not an PathCurvetoAbs, PathCurvetoRel, PathSmoothCurvetoAbs or PathSmoothCurvetoRel, assume the first control point is coincident with the current point.) (x2,y2) is the second control point (i.e., the control point at the end of the curve). PathSmoothCurvetoAbs indicates that absolute coordinates will follow; PathSmoothCurvetoRel indicates that relative coordinates will follow. Multiple sets of coordinates may be specified to draw a polybezier. At the end of the command, the new current point becomes the final (x,y) coordinate pair used in the polybezier.
- PathSmoothCurvetoAbs	- const std::list<Magick::Coordinate> &coordinates_
- PathSmoothCurvetoRel	- const Magick::Coordinate &coordinates_
- PathSmoothCurvetoRel	- const std::list<Magick::Coordinate> &coordinates_

The quadratic BÃ©zier curve commands

The quadratic BÃ©zier commands depend on the PathQuadraticCurvetoArgs argument class, which has the constructor signature:

-  PathQuadraticCurvetoArgs( double x1_, double y1_, 
-                            double x_, double y_ );
-

The quadratic BÃ©zier commands are as follows:

Quadratic BÃ©zier Curve Classes

- - - - - - - - - - - - - - - - - - - - - - - - - - -

- Sub-Class	- Constructor Signature	- Description
- PathQuadraticCurvetoAbs	- const Magick::PathQuadraticCurvetoArgs &args_	- Draws a quadratic BÃ©zier curve from the current point to (x,y) using (x1,y1) as the control point. PathQuadraticCurvetoAbs indicates that absolute coordinates will follow; PathQuadraticCurvetoRel indicates that relative coordinates will follow. Multiple sets of coordinates may be specified to draw a polybezier. At the end of the command, the new current point becomes the final (x,y) coordinate pair used in the polybezier.
- PathQuadraticCurvetoAbs	- const std::list<Magick::PathQuadraticCurvetoArgs> &args_
- PathQuadraticCurvetoRel	- const Magick::PathQuadraticCurvetoArgs &args_
- PathQuadraticCurvetoRel	- const std::list<Magick::PathQuadraticCurvetoArgs> &args_
- PathSmoothQuadraticCurvetoAbs	- const Magick::Coordinate &coordinate_	- Draws a quadratic BÃ©zier curve from the current point to (x,y). The control point is assumed to be the reflection of the control point on the previous -command relative to the current point. (If there is no previous command or if the previous command was not a PathQuadraticCurvetoAbs, PathQuadraticCurvetoRel, PathSmoothQuadraticCurvetoAbs or PathSmoothQuadraticCurvetoRel, assume the control point is coincident with the current point.) PathSmoothQuadraticCurvetoAbs indicates that absolute coordinates will follow; PathSmoothQuadraticCurvetoRel indicates that relative coordinates will follow. At the end of the command, the new current point becomes the final (x,y) coordinate pair used in the polybezier.
- PathSmoothQuadraticCurvetoAbs	- const std::list<Magick::Coordinate> &coordinates_
- PathSmoothQuadraticCurvetoRel	- const Magick::Coordinate &coordinate_
- PathSmoothQuadraticCurvetoRel	- const std::list<Magick::Coordinate> &coordinates_

The elliptical arc curve commands

The elliptical arc curve commands depend on the PathArcArgs argument class, which has the constructor signature:

-   PathArcArgs( double radiusX_, double radiusY_, 
-                double xAxisRotation_, bool largeArcFlag_, 
-                bool sweepFlag_, double x_, double y_ );
-

The elliptical arc commands are as follows:

Elliptical Arc Curve Classes

- ---- - - - - - - - - - - - - - -

- Sub-Class	- Constructor Signature	- Description
- PathArcAbs	- const Magick::PathArcArgs &coordinates_	- Draws an elliptical arc from the current point to (x, y). The size and orientation of the ellipse are defined by two radii (radiusX, radiusY) and an xAxisRotation, which indicates how the ellipse as a whole is rotated relative to the current coordinate system. The center (cx, cy) of the ellipse is calculated automagically to satisfy the constraints imposed by the other parameters. largeArcFlag and sweepFlag contribute to the automatic calculations and help determine how the arc is drawn. If largeArcFlag is true then draw the larger of the available arcs. If sweepFlag is true, then draw the arc matching a clock-wise rotation.
- PathArcAbs	- const std::list<Magick::PathArcArgs> &coordinates_
- PathArcRel	- const Magick::PathArcArgs &coordinates_
- PathArcRel	- const std::list<Magick::PathArcArgs> &coordinates_

- - diff --git a/ImageMagick/Magick++/Enumerations.html b/ImageMagick/Magick++/Enumerations.html deleted file mode 100644 index 49e311384..000000000 --- a/ImageMagick/Magick++/Enumerations.html +++ /dev/null @@ -1,2523 +0,0 @@ - - - - - -Magick++ API: Enumerations - - - -

Enumerations

- - - - -

- Contents

ChannelType -
ClassType -
ColorspaceType -
CompositeOperator -
CompressionType -
DecorationType -
FillRule -
FilterTypes -
GravityType -
ImageType -
InterlaceType -
ChannelType -
LineCap -
LineJoin -
NoiseType -
OrientationType
PaintMethod -
QuantumTypes -
RenderingIntent -
ResolutionType -
StorageType -
StretchType -
StyleType
VirtualPixelMethod -

- - - - -

- ChannelType

ChannelType is used as an -argument when doing color separations. Use ChannelType when -extracting a layer from an image. MatteChannel is useful for -extracting the opacity values from an image. Note that an image may -be represented in RGB, RGBA, CMYK, or CMYKA, pixel formats and a -channel may only be extracted if it is valid for the current pixel -format.

ChannelType

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

- Enumeration -	- Description -
- UndefinedChannel -	- Unset value. -
- RedChannel -	- Extract red channel (RGB images only) -
- CyanChannel -	- Extract cyan channel (CMYK images only) -
- GreenChannel -	- Extract green channel (RGB images only) -
- MagentaChannel -	- Extract magenta channel (CMYK images only) -
- BlueChannel -	- Extract blue channel (RGB images only) -
- YellowChannel -	- Extract yellow channel (CMYK images only) -
- OpacityChannel -	- Extract matte (opacity values) channel (CMYKA images only) -
- BlackChannel -	- Extract black channel (CMYK images only) -
- MatteChannel -	- Extract matte (opacity values) channel (RGB images only) -

- - - - -

- - - ClassType

ClassType specifies the image -storage class. -

ClassType

- - - - - - - - - - - - - - - - - -

- Enumeration -	- Description -
- UndefinedClass -	- Unset value. -
- DirectClass -	- Image is composed of pixels which represent literal color - values. -
- PseudoClass -	- Image is composed of pixels which specify an index in a color - palette. -

- - - - -

- - ColorspaceType

The ColorspaceType enumeration is used to specify the colorspace -that quantization (color reduction and mapping) is done under or to -specify the colorspace when encoding an output image. Colorspaces are -ways of describing colors to fit the requirements of a particular -application (e.g. Television, offset printing, color monitors). -Color reduction, by default, takes place in the RGBColorspace. -Empirical evidence suggests that distances in color spaces such as -YUVColorspace or YIQColorspace correspond to perceptual -color differences more closely han do distances in RGB space. These -color spaces may give better results when color reducing an image. -Refer to quantize for more details. -

When encoding an output image, the -colorspaces RGBColorspace, CMYKColorspace, and -GRAYColorspace may be specified. The CMYKColorspace -option is only applicable when writing TIFF, JPEG, and Adobe -Photoshop bitmap (PSD) files. -

ColorspaceType

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

- Enumeration -	- Description -
- UndefinedColorspace -	- Unset value. -
- CMYKColorspace -	- Cyan-Magenta-Yellow-Black colorspace. CYMK is a subtractive - color system used by printers and photographers for the rendering - of colors with ink or emulsion, normally on a white surface. -
- GRAYColorspace -	- Grayscale colorspace -
- HCLColorspace -	- -
- LabColorspace -	- -
- LCHabColorspace -	- -
- LuvColorspace -	- -
- OHTAColorspace -	- -
- RGBColorspace -	- Red-Green-Blue colorspace. -
- sRGBColorspace -	- -
- scRGBColorspace -	- -
- TransparentColorspace -	- The Transparent color space behaves uniquely in that it - preserves the matte channel of the image if it exists. -
- XYZColorspace -	- -
- YCbCrColorspace -	- -
- YCCColorspace -	- -
- YIQColorspace -	- -
- YPbPrColorspace -	- -
- YUVColorspace -	- Y-signal, U-signal, and V-signal colorspace. YUV is most widely - used to encode color for use in television transmission. -

- - - - -

- - CompositeOperator

CompositeOperator is used to -select the image composition algorithm used to compose a composite -image with an image. By default, each of the composite -image pixels are replaced by the corresponding image tile pixel. -Specify CompositeOperator to select a different algorithm. -

CompositeOperator

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

- Enumeration -	- Description -
- UndefinedCompositeOp -	- Unset value. -
- OverCompositeOp -	- The result is the union of the the two image shapes with the - composite image obscuring image in the region of - overlap. -
- InCompositeOp -	- The result is a simply composite image cut by the shape - of image. None of the image data of image is included in - the result. -
- OutCompositeOp -	- The resulting image is composite image with the shape of - image cut out. -
- AtopCompositeOp -	- The result is the same shape as image image, with - composite image obscuring image there the image - shapes overlap. Note that this differs from OverCompositeOp - because the portion of composite image outside of image's - shape does not appear in the result. -
- XorCompositeOp -	- The result is the image data from both composite image - and image that is outside the overlap region. The overlap - region will be blank. -
- PlusCompositeOp -	- The result is just the sum of the image data. Output - values are cropped to 255 (no overflow). This operation is - independent of the matte channels. -
- MinusCompositeOp -	- The result of composite image - image, with - overflow cropped to zero. The matte chanel is ignored (set to 255, - full coverage). -
- AddCompositeOp -	- The result of composite image + image, with - overflow wrapping around (mod 256). -
- SubtractCompositeOp -	- The result of composite image - image, with - underflow wrapping around (mod 256). The add and subtract - operators can be used to perform reverible transformations. -
- DifferenceCompositeOp -	- The result of abs(composite image - image). This - is useful for comparing two very similar images. -
- MultiplyCompositeOp -	- -
- BumpmapCompositeOp -	- The result image shaded by composite image. -
- CopyCompositeOp -	- The resulting image is image replaced with composite - image. Here the matte information is ignored. -
- CopyRedCompositeOp -	- The resulting image is the red layer in image replaced - with the red layer in composite image. The other layers are - copied untouched. -
- CopyGreenCompositeOp -	- The resulting image is the green layer in image replaced - with the green layer in composite image. The other layers - are copied untouched. -
- CopyBlueCompositeOp -	- The resulting image is the blue layer in image replaced - with the blue layer in composite image. The other layers - are copied untouched. -
- CopyOpacityCompositeOp -	- The resulting image is the matte layer in image replaced - with the matte layer in composite image. The other layers - are copied untouched. - - The image compositor requires a matte, or alpha channel in the - image for some operations. This extra channel usually defines a - mask which represents a sort of a cookie-cutter for the image. - This is the case when matte is 255 (full coverage) for pixels - inside the shape, zero outside, and between zero and 255 on the - boundary. For certain operations, if image does not - have a matte channel, it is initialized with 0 for any pixel - matching in color to pixel location (0,0), otherwise 255 (to work - properly borderWidth must be 0). -
- ClearCompositeOp -	- -
- DissolveCompositeOp -	- -
- DisplaceCompositeOp -	- -
- ModulateCompositeOp -	- -
- ThresholdCompositeOp -	- -

- - - - -

CompressionType

CompressionType is used to -express the desired compression type when encoding an image. Be aware -that most image types only support a sub-set of the available -compression types. If the compression type specified is incompatable -with the image, ImageMagick selects a compression type compatable -with the image type. -

CompressionType

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

- Enumeration -	- Description -
- UndefinedCompression -	- Unset value. -
- NoCompression -	- No compression -
- BZipCompression -	- BZip (Burrows-Wheeler block-sorting text compression algorithm - and Huffman coding) as used by bzip2 utilities -
- FaxCompression -	- CCITT Group 3 FAX compression -
- Group4Compression -	- CCITT Group 4 FAX compression (used only for TIFF) -
- JPEGCompression -	- JPEG compression -
- LZWCompression -	- Lempel-Ziv-Welch (LZW) compression (caution, patented by - Unisys) -
- RunlengthEncodedCompression -	- Run-Length encoded (RLE) compression -
- ZipCompression -	- Lempel-Ziv compression (LZ77) as used in PKZIP and GNU gzip. -

- - - - -

- - DecorationType

The DecorationType enumerations -are used to specify line decorations of rendered text. -

DecorationType

- - - - - - - - - - - - - - - - - - - - - -

- Enumeration -	- Description -
- NoDecoration -	- No decoration -
- UnderlineDecoration -	- Underlined text -
- OverlineDecoration -	- Overlined text -
- LineThroughDecoration -	- Strike-through text -

- - - - -

EndianType

The EndianType enumerations are -used to specify the endian option for formats which support it (e.g. -TIFF). -

EndianType

- - - - - - - - - - - - - - - - - -

- Enumeration -	- Description -
- UndefinedEndian -	- Not defined (default) -
- LSBEndian -	- Little endian (like Intel X86 and DEC Alpha) -
- MSBEndian -	- Big endian (like Motorola 68K, Mac PowerPC, & SPARC) -

- - - - -

FillRule

FillRule specifies the algorithm -which is to be used to determine what parts of the canvas are -included inside the shape. See the documentation on SVG's fill-rule -property for usage details. -

FillRule

- - - - - - - - - - - - - -

- UndefinedRule -	- Fill rule not specified -
- EvenOddRule -	- See SVG fill-rule evenodd rule. -
- NonZeroRule -	- See SVG fill-rule nonzero rule. -

- - - - -

FilterTypes

FilterTypes is used to adjust -the filter algorithm used when resizing images. Different filters -experience varying degrees of success with various images and can -take sipngicantly different amounts of processing time. -ImageMagick uses the LanczosFilter by default since this -filter has been shown to provide the best results for most images in -a reasonable amount of time. Other filter types (e.g. TriangleFilter) -may execute much faster but may show artifacts when the image is -re-sized or around diagonal lines. The only way to be sure is to test -the filter with sample images. -

FilterTypes

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

- Enumeration -	- Description -
- UndefinedFilter -	- Unset value. -
- PointFilter -	- Point Filter -
- BoxFilter -	- Box Filter -
- TriangleFilter -	- Triangle Filter -
- HermiteFilter -	- Hermite Filter -
- HanningFilter -	- Hanning Filter -
- HammingFilter -	- Hamming Filter -
- BlackmanFilter -	- Blackman Filter -
- GaussianFilter -	- Gaussian Filter -
- QuadraticFilter -	- Quadratic Filter -
- CubicFilter -	- Cubic Filter -
- CatromFilter -	- Catrom Filter -
- MitchellFilter -	- Mitchell Filter -
- LanczosFilter -	- Lanczos Filter -
- BesselFilter -	- Bessel Filter -
- SincFilter -	- Sinc Filter -

- - - - -

GravityType

GravityType specifies -positioning of an object (e.g. text, image) within a bounding region -(e.g. an image). Gravity provides a convenient way to locate objects -irrespective of the size of the bounding region, in other words, you -don't need to provide absolute coordinates in order to position an -object. A common default for gravity is NorthWestGravity. -

GravityType

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

- Enumeration -	- Description -
- ForgetGravity -	- Don't use gravity. -
- NorthWestGravity -	- Position object at top-left of region. -
- NorthGravity -	- Postiion object at top-center of region -
- NorthEastGravity -	- Position object at top-right of region -
- WestGravity -	- Position object at left-center of region -
- CenterGravity -	- Position object at center of region -
- EastGravity -	- Position object at right-center of region -
- SouthWestGravity -	- Position object at left-bottom of region -
- SouthGravity -	- Position object at bottom-center of region -
- SouthEastGravity -	- Position object at bottom-right of region -

- - - - -

ImageType

ImageType indicates the type -classification of the image. -

ImageType

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

- Enumeration -	- Description -
- UndefinedType -	- Unset value. -
- BilevelType -	- Monochrome image -
- GrayscaleType -	- Grayscale image -
- GrayscaleMatteType -	- Grayscale image with opacity -
- PaletteType -	- Indexed color (palette) image -
- PaletteMatteType -	- Indexed color (palette) image with opacity -
- TrueColorType -	- Truecolor image -
- TrueColorMatteType -	- Truecolor image with opacity -
- ColorSeparationType -	- Cyan/Yellow/Magenta/Black (CYMK) image -

- - - - -

InterlaceType

InterlaceType specifies the ordering of the red, green, and -blue pixel information in the image. Interlacing is usually used to -make image information available to the user faster by taking -advantage of the space vs time tradeoff. For example, interlacing -allows images on the Web to be recognizable sooner and satellite -images to accumulate/render with image resolution increasing over -time. -

Use LineInterlace or -PlaneInterlace to create an interlaced GIF or progressive JPEG -image. -

InterlaceType

- - - - - - - - - - - - - - - - - - - - - - - - - -

- Enumeration -	- Description -
- UndefinedInterlace -	- Unset value. -
- NoInterlace -	- Don't interlace image (RGBRGBRGBRGBRGBRGB...) -
- LineInterlace -	- Use scanline interlacing (RRR...GGG...BBB...RRR...GGG...BBB...) -
- PlaneInterlace -	- Use plane interlacing (RRRRRR...GGGGGG...BBBBBB...) -
- PartitionInterlace -	- Similar to plane interlaing except that the different planes - are saved to individual files (e.g. image.R, image.G, and image.B) -

- - - - -

ChannelType

ChannelType is used as an -argument when doing color separations. Use ChannelType when -extracting a layer from an image. MatteLayer is useful for -extracting the opacity values from an image. -

ChannelType

- - - - - - - - - - - - - - - - - - - - - - - - - -

- Enumeration -	- Description -
- UndefinedLayer -	- Unset value. -
- RedLayer -	- Select red layer -
- GreenLayer -	- Select green layer -
- BlueLayer -	- Select blue layer -
- MatteLayer -	- Select matte (opacity values) layer -

- - - - -

LineCap

The LineCap enumerations specify -shape to be used at the end of open subpaths when they are stroked. -See SVG's 'stroke-linecap' -for examples. -

LineCap

- - - - - - - - - - - - - - - - - - - - - -

- Enumeration -	- Description -
- UndefinedCap -	- Unset value. -
- ButtCap -	- Square ending. -
- RoundCap -	- Rounded ending (half-circle end with radius of 1/2 stroke - width). -
- SquareCap -	- Square ending, extended by 1/2 the stroke width at end. -

- - - - -

LineJoin

The LineJoin enumerations -specify the shape to be used at the corners of paths or basic shapes -when they are stroked. See SVG's 'stroke-linejoin' -for examples. -

ChannelType

- - - - - - - - - - - - - - - - - - - - - -

- Enumeration -	- Description -
- UndefinedJoin -	- Unset value. -
- MiterJoin -	- Sharp-edged join -
- RoundJoin -	- Rounded-edged join -
- BevelJoin -	- Beveled-edged join -

- - - - -

NoiseType

NoiseType is used as an argument -to select the type of noise to be added to the image. -

NoiseType

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

- Enumeration -	- Description -
- UniformNoise -	- Uniform noise -
- GaussianNoise -	- Gaussian noise -
- MultiplicativeGaussianNoise -	- Multiplicative Gaussian noise -
- ImpulseNoise -	- Impulse noise -
- LaplacianNoise -	- Laplacian noise -
- PoissonNoise -	- Poisson noise -

- - - - - -

- OrientationType

OrientationType -specifies the orientation of the image. Useful for when the image is -produced via a different ordinate system, the camera was turned on -its side, or the page was scanned sideways.

OrientationType

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

- Enumeration -	- Scanline Direction -	- Frame Direction -
- UndefinedOrientation -	- Unknown -	- Unknown -
- TopLeftOrientation -	- Left to right -	- Top to bottom -
- TopRightOrientation -	- Right to left -	- Top to bottom -
- BottomRightOrientation -	- Right to left -	- Bottom to top -
- BottomLeftOrientation -	- Left to right -	- Bottom to top -
- LeftTopOrientation -	- Top to bottom -	- Left to right -
- RightTopOrientation -	- Top to bottom -	- Right to left -
- RightBottomOrientation -	- Bottom to top -	- Right to left -
- LeftBottomOrientation -	- Bottom to top -	- Left to right -

- - - - -

PaintMethod

PaintMethod specifies how pixel -colors are to be replaced in the image. It is used to select the -pixel-filling algorithm employed. -

PaintMethod

- - - - - - - - - - - - - - - - - - - - - - - - - -

- Enumeration -	- Description -
- PointMethod -	- Replace pixel color at point. -
- ReplaceMethod -	- Replace color for all image pixels matching color at point. -
- FloodfillMethod -	- Replace color for pixels surrounding point until encountering - pixel that fails to match color at point. -
- FillToBorderMethod -	- Replace color for pixels surrounding point until encountering - pixels matching border color. -
- ResetMethod -	- Replace colors for all pixels in image with pen color. -

- - - - -

QuantumTypes

QuantumTypes is used to indicate -the source or destination format of entire pixels, or components of -pixels ("Quantums") while they are being read, or written -to, a pixel cache. The validity of these format specifications -depends on whether the Image pixels are in RGB format, RGBA format, -or CMYK format. The pixel Quantum size is determined by the Image -depth (eight or sixteen bits). -

RGB(A) Image Quantums

- - - - - - - - - - - - - - - - - - - - - - - - - -

- Enumeration -	- Description -
- IndexQuantum -	- PseudoColor colormap indices (valid only for image with - colormap) -
- RedQuantum -	- Red pixel Quantum -
- GreenQuantum -	- Green pixel Quantum -
- BlueQuantum -	- Blue pixel Quantum -
- AlphaQuantum -	- Alpha Quantum -

CMY(K)(A) Image Quantum

- - - - - - - - - - - - - - - - - - - - - - - - - -

- Enumeration -	- Description -
- CyanQuantum -	- Cyan pixel Quantum -
- MagentaQuantum -	- Magenta pixel Quantum -
- YellowQuantum -	- Yellow pixel Quantum -
- BlackQuantum -	- Black pixel Quantum -
- AlphaQuantum -	- Alpha Quantum -

Grayscale Image -Quantums

- - - - - - - - - - - - - - - - - -

- Enumeration -	- Description -
- GrayQuantum -	- Gray pixel -
- GrayOpacityQuantum -	- Pixel opacity -
- AlphaQuantum -	- Alpha Quantum -

Entire Pixels -(Expressed in Byte Order)

- - - - - - - - - - - - - - - - - - - - - -

- Enumeration -	- Description -
- RGBQuantum -	- RGB pixel (24 or 48 bits) -
- RGBAQuantum -	- RGBA pixel (32 or 64 bits) -
- CMYKQuantum -	- CMYK pixel (32 or 64 bits) -
- CMYKAQuantum -	- CMYKA pixel (40 or 80 bits) -

- - - - -

RenderingIntent

Rendering intent is a concept defined by ICC -Spec ICC.1:1998-09, "File Format for Color Profiles". -ImageMagick uses RenderingIntent in order to support ICC -Color Profiles. -

From the specification: "Rendering -intent specifies the style of reproduction to be used during the -evaluation of this profile in a sequence of profiles. It applies -specifically to that profile in the sequence and not to the entire -sequence. Typically, the user or application will set the rendering -intent dynamically at runtime or embedding time." -

RenderingIntent

- - - - - - - - - - - - - - - - - - - - - - - - - -

- Enumeration -	- Description -
- UndefinedIntent -	- Unset value. -
- SaturationIntent -	- A rendering intent that specifies the saturation of the pixels - in the image is preserved perhaps at the expense of accuracy in - hue and lightness. -
- PerceptualIntent -	- A rendering intent that specifies the full gamut of the image - is compressed or expanded to fill the gamut of the destination - device. Gray balance is preserved but colorimetric accuracy might - not be preserved. -
- AbsoluteIntent -	- Absolute colorimetric -
- RelativeIntent -	- Relative colorimetric -

- - - - -

ResolutionType

By default, ImageMagick defines -resolutions in pixels per inch. ResolutionType provides a -means to adjust this. -

ResolutionType

- - - - - - - - - - - - - - - - - -

- Enumeration -	- Description -
- UndefinedResolution -	- Unset value. -
- PixelsPerInchResolution -	- Density specifications are specified in units of pixels per - inch (english units). -
- PixelsPerCentimeterResolution -	- Density specifications are specified in units of pixels per - centimeter (metric units). -

- - - - -

StorageType

The StorageType enumerations are -used to specify the storage format of pixels in the source or -destination pixel array. -

StorageType

- - - - - - - - - - - - - - - - - - - - - - - - - -

- Enumeration -	- Description -
- CharPixel -	- Character type -
- ShortPixel -	- Short type -
- IntegerPixel -	- Integer type -
- FloatPixel -	- Float type -
- DoublePixel -	- Double type -

- - - - -

StretchType

The StretchType enumerations are -used to specify the relative width of a font to the regular width for -the font family. If the width is not important, the AnyStretch -enumeration may be specified for a wildcard match. -

StretchType

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

- Enumeration -	- Description -
- AnyStretch -	- Wildcard match for font stretch -
- NormalStretch -	- Normal width font -
- UltraCondensedStretch -	- Ultra-condensed (narrowest) font -
- ExtraCondensedStretch -	- Extra-condensed font -
- CondensedStretch -	- Condensed font -
- SemiCondensedStretch -	- Semi-Condensed font -
- SemiExpandedStretch -	- Semi-Expanded font -
- ExpandedStretch -	- Expanded font -
- ExtraExpandedStretch -	- Extra-Expanded font -
- UltraExpandedStretch -	- Ultra-expanded (widest) font -

- - - - -

StyleType

The StyleType enumerations are -used to specify the style (e.g. Italic) of a font. If the style is -not important, the AnyStyle enumeration may be specified for a -wildcard match. -

StyleType

- - - - - - - - - - - - - - - - - - - - - -

- Enumeration -	- Description -
- AnyStyle -	- Wildcard match for font style -
- NormalStyle -	- Normal font style -
- ItalicStyle -	- Italic font style -
- ObliqueStyle -	- Oblique font style -

- - - - -

VirtualPixelMethod

The VirtualPixelMethod enumerations are -used to specify the virtual pixel method. -

VirtualPixelMethod

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

- Enumeration -	- Description -
- UndefinedVirtualPixelMethod -	- Not defined -
- BackgroundVirtualPixelMethod -	- the area surrounding the image is the background color - -
- BlackVirtualPixelMethod -	- the area surrounding the image is black -
- CheckerTileVirtualPixelMethod -	- alternate squares with image and background color - -
- DitherVirtualPixelMethod -	- non-random 32x32 dithered pattern - -
- EdgeVirtualPixelMethod -	- extend the edge pixel toward infinity - -
- GrayVirtualPixelMethod -	- the area surrounding the image is gray - -
- HorizontalTileVirtualPixelMethod -	- horizontally tile the image, background color above/below -
- HorizontalTileEdgeVirtualPixelMethod -	- horizontally tile the image and replicate the side edge pixels -
- MirrorVirtualPixelMethod -	- mirror tile the image - -
- RandomVirtualPixelMethod -	- choose a random pixel from the image - -
- TileVirtualPixelMethod -	- tile the image (default) - -
- TransparentVirtualPixelMethod -	- the area surrounding the image is transparent blackness - -
- VerticalTileVirtualPixelMethod -	- vertically tile the image, sides are background color - -
- VerticalTileEdgeVirtualPixelMethod -	- vertically tile the image and replicate the side edge pixels - -
- WhiteVirtualPixelMethod -	- the area surrounding the image is white - -

- - diff --git a/ImageMagick/Magick++/Exception.html b/ImageMagick/Magick++/Exception.html deleted file mode 100644 index b582f448a..000000000 --- a/ImageMagick/Magick++/Exception.html +++ /dev/null @@ -1,465 +0,0 @@ - - - - - -Magick++ API: Exceptions - - - -

Magick::Exception Classes

Exception represents the base class of objects thrown when -Magick++reports an error. Magick++ throws C++ exceptions synchronous -with the operation where the error occurred. This allows errors to be -trapped within the enclosing code (perhaps the code to process a -single image) while allowing the code to be written with a simple -coding style.

A try/catch block should be placed around any sequence of -operations which can be considered an important body of work. For -example, if your program processes lists of images and some of these -images may be defective, by placing the try/catch block around the -entire sequence of code that processes one image (including -instantiating the image object), you can minimize the overhead of -error checking while ensuring that all objects created to deal with -that object are safely destroyed (C++ exceptions unroll the stack -until the enclosing try block, destroying any created objects). -

The pseudo code for the main loop of your program may look like: -

-using namespace std; -for infile in list -{ - try { - // Construct an image instance first so that we don't have to worry - // about object construction failure due to a minor warning exception - // being thrown. - Magick::Image image; - try { - // Try reading image file - image.read(infile); - } - catch( Magick::WarningCoder &warning ) - { - // Process coder warning while loading file (e.g. TIFF warning) - // Maybe the user will be interested in these warnings (or not). - // If a warning is produced while loading an image, the image - // can normally still be used (but not if the warning was about - // something important!) - cerr << "Coder Warning: " << warning.what() << endl; - } - catch( Magick::Warning &warning ) - { - // Handle any other Magick++ warning. - cerr << "Warning: " << warning.what() << endl; - } - catch( Magick::ErrorFileOpen &error ) - { - // Process Magick++ file open error - cerr << "Error: " << error.what() << endl; - continue; // Try next image. - } - try { - image.rotate(90); - image.write("outfile"); - } - catch ( MagickExeption & error) - { - // Handle problem while rotating or writing outfile. - cerr << "Caught Magick++ exception: " << error.what() << endl; - } - } - catch( std::exception & error ) - { - // Process any other exceptions derived from standard C++ exception - cerr << "Caught C++ STD exception: " << error.what() << endl; - } - catch( ... ) - { - // Process *any* exception (last-ditch effort). There is not a lot - // you can do here other to retry the operation that failed, or exit - } -} -

The desired location and number of try/catch blocks in your program -depends how sophisticated its error handling must be. Very simple -programs may use just one try/catch block.

The Exception class is derived from the C++ standard -exception class. This means that it contains a C++ string containing -additional information about the error (e.g to display to the user). -Obtain access to this string via the what() method. For -example: -

-catch( Exception & error_ ) 
-    { 
-      cout << "Caught exception: " << error_.what() << endl; 
-    }
-

The classes Warning and Error derive from the -Exception class. Exceptions derived from Warning are -thrown to represent non-fatal errors which may effect the -completeness or quality of the result (e.g. one image provided as an -argument to montage is defective). In most cases, a Warning -exception may be ignored by catching it immediately, processing it -(e.g. printing a diagnostic) and continuing on. Exceptions derived -from Error are thrown to represent fatal errors that can not -produce a valid result (e.g. attempting to read a file which does not -exist). -

The specific derived exception classes -are shown in the following tables: -

Warning Sub-Classes

- Warning -	- Warning Description -
- WarningUndefined -	- Unspecified warning type. -
- WarningBlob -	- NOT - CURRENTLY USED -
- WarningCache -	- NOT - CURRENTLY USED -
- WarningCoder -	- Warnings issued by some coders. -
- WarningConfigure -	- NOT - CURRENTLY USED -
- WarningCorruptImage -	- Warning issued when an image is determined to be - corrupt. -
- WarningDelegate -	- Warnings reported by the delegate (interface to - external programs) subsystem. -
- WarningDraw -	- Warnings reported by the rendering subsystem. -
- WarningFileOpen -	- Warning reported when The image file could not be - opened (permission problem, wrong file type, or does not exist). -
- WarningImage -	- NOT CURRENTLY USED -
- WarningMissingDelegate -	- NOT CURRENTLY USED -
- WarningModule -	- NOT CURRENTLY USED -
- WarningMonitor -	- NOT CURRENTLY USED -
- WarningOption -	- Warning reported when an option is malformed or - out of range. -
- WarningRegistry -	- NOT CURRENTLY USED -
- WarningResourceLimit -	- Warning reported when a program resource is - exhausted (e.g. not enough memory). -
- WarningStream -	- NOT CURRENTLY USED -
- WarningType -	- NOT CURRENTLY USED -
- WarningXServer -	- Warnings reported by the X11 subsystem. -

Error Sub-Classes

- Error -	- Error Description -
- ErrorUndefined -	- Unspecified error type. -
- ErrorBlob -	- Error reported by BLOB I/O subsystem. -
- ErrorCache -	- Error reported by the pixel cache subsystem. -
- ErrorCoder -	- Error reported by coders (image format support). -
- ErrorConfigure -	- Errors reported while loading configuration files. -
- ErrorCorruptImage -	- Error reported when the image file is corrupt. -
- ErrorDelegate -	- Errors reported by the delegate (interface to - external programs) subsystem. -
- ErrorDraw -	- Error reported while drawing on image. -
- ErrorFileOpen -	- Error reported when the image file can not be - opened. -
- ErrorImage -	- Errors reported while drawing. -
- ErrorMissingDelegate -	- Error reported when an add-on library or program - is necessary in order to support the requested operation. -
- ErrorModule -	- Errors reported by the module loader subsystem. -
- ErrorMonitor -	- NOT CURRENTLY USED -
- ErrorOption -	- Error reported when an option is malformed or out - of range. -
- ErrorRegistry -	- Errors reported by the image/BLOB registry - subsystem. -
- ErrorResourceLimit -	- Error reported when a program resource is - exhausted (e.g. not enough memory). -
- ErrorStream -	- Errors reported by the pixel stream subsystem. -
- ErrorType -	- Errors reported by the type (font) rendering - subsystem. -
- ErrorXServer -	- Errors reported by the X11 subsystem. -

- - diff --git a/ImageMagick/Magick++/FormatCharacters.html b/ImageMagick/Magick++/FormatCharacters.html deleted file mode 100644 index b38881f52..000000000 --- a/ImageMagick/Magick++/FormatCharacters.html +++ /dev/null @@ -1,96 +0,0 @@ - - - - - -Magick++ API: Annotating an Image - - - -

Special Format Characters

The Magick::Image methods annotate, draw, label, and the template function montageImages support special format characters contained in the argument text. These format characters work similar to C's printf. Whenever a format character appears in the text, it is replaced with the equivalent attribute text. The available format characters are shown in the following table.

-
-

Format Characters

- - --- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

- Format Character	- Description
- %b	- file size
- %d	- directory
- %e	- filename extension
- %f	- filename
- %h	- height
- %m	- magick (e.g GIF)
- %p	- page number
- %s	- scene number
- %t	- top of filename
- %w	- width
- %x	- x resolution
- %y	- y resolution
- \n	- newline
- \r	- carriage return

- - diff --git a/ImageMagick/Magick++/Geometry.html b/ImageMagick/Magick++/Geometry.html deleted file mode 100644 index cfb6bcf7f..000000000 --- a/ImageMagick/Magick++/Geometry.html +++ /dev/null @@ -1,820 +0,0 @@ - - - - - -Magick++ API: Geometry - - - -

Magick::Geometry

Geometry provides a convenient means to specify a geometry -argument. The object may be initialized from a C string or C++ string -containing a geometry specification. It may also be initialized by -more efficient parameterized constructors. -

Geometry -Specifications

Geometry specifications are in the form -"<width>x<height>{+-}<xoffset>{+-}<yoffset>" -(where width, height, xoffset, and yoffset -are numbers) for specifying the size and placement location for an -object. -

The width and height -parts of the geometry specification are measured in pixels. The -xoffset and yoffset parts are also measured in pixels -and are used to specify the distance of the placement coordinate from -the left and top and edges of the image, respectively. Both types of -offsets are measured from the indicated edge of the object to the -corresponding edge of the image. The X offset may be specified in the -following ways: -

- - - - - - - - - - - -

- +xoffset -	- The left edge of the object is to be placed xoffset - pixels in from the left edge of the image. -
- -xoffset -	- The left edge of the object is to be placed outside the image, - xoffset pixels out from the left edge of the image. -

The Y offset has similar meanings: -

- - - - - - - - - - - -

- +yoffset -	- The top edge of the object is to be yoffset pixels - below the top edge of the image. -
- -yoffset -	- The top edge of the object is to be yoffset pixels - above the top edge of the image. -

Offsets must be given as pairs; in other words, in order to -specify either xoffset or yoffset both must be present. -

ImageMagick -Extensions To Geometry Specifications

ImageMagick has added a number of -qualifiers to the standard geometry string for use when resizing -images. The form of an extended geometry string is -"<width>x<height>{+-}<xoffset>{+-}<yoffset>{%}{!}{<}{>}". -Extended geometry strings should only be used when resizing -an image. Using an extended geometry string for other -applications may cause the API call to fail. The available -qualifiers are shown in the following table: -

ImageMagick Geometry -Qualifiers

- - - - - - - - - - - - - - - - - - - - - - - -

- Qualifier -	- Description -
- % -	- Interpret width and height as a percentage of the - current size. -
- ! -	- Resize to width and height exactly, loosing original - aspect ratio. -
- < -	- Resize only if the image is smaller than the geometry - specification. -
- > -	- Resize only if the image is greater than the geometry - specification. -

Postscript Page Size Extension -To Geometry Specifications

Any geometry string specification supplied to the Geometry -constructor is considered to be a Postscript page size nickname if -the first character is not numeric. The Geometry constructor converts -these page size specifications into the equivalent numeric geometry -string specification (preserving any offset component) prior to -conversion to the internal object format. Postscript page size -specifications are short-hand for the pixel geometry required to fill -a page of that size. Since the 11x17 inch page size used in the US -starts with a digit, it is not supported as a Postscript page size -nickname. Instead, substitute the geometry specification "792x1224>" -when 11x17 output is desired. -

An example of a Postscript page size -specification is "letter+43+43>". -

Postscript Page Size -Nicknames

- Postscript Page Size Nickname -	- Equivalent Extended Geometry Specification -
- Ledger -	- 1224x792> -
- Legal -	- 612x1008> -
- Letter -	- 612x792> -
- LetterSmall -	- 612x792> -
- ArchE -	- 2592x3456> -
- ArchD -	- 1728x2592> -
- ArchC -	- 1296x1728> -
- ArchB -	- 864x1296> -
- ArchA -	- 648x864> -
- A0 -	- 2380x3368> -
- A1 -	- 1684x2380> -
- A2 -	- 1190x1684> -
- A3 -	- 842x1190> -
- A4 -	- 595x842> -
- A4Small -	- 595x842> -
- A5 -	- 421x595> -
- A6 -	- 297x421> -
- A7 -	- 210x297> -
- A8 -	- 148x210> -
- A9 -	- 105x148> -
- A10 -	- 74x105> -
- B0 -	- 2836x4008> -
- B1 -	- 2004x2836> -
- B2 -	- 1418x2004> -
- B3 -	- 1002x1418> -
- B4 -	- 709x1002> -
- B5 -	- 501x709> -
- C0 -	- 2600x3677> -
- C1 -	- 1837x2600> -
- C2 -	- 1298x1837> -
- C3 -	- 918x1298> -
- C4 -	- 649x918> -
- C5 -	- 459x649> -
- C6 -	- 323x459> -
- Flsa -	- 612x936> -
- Flse -	- 612x936> -
- HalfLetter -	- 396x612> -

Geometry Methods

Geometry provides methods to initialize -its value from strings, from a set of parameters, or via attributes. -The methods available for use in Geometry are shown in the following -table: -

Geometry Methods

- Method -	- Return Type -	- Signature(s) -	- Description -
- Geometry -	- -	- size_t width_, size_t height_, ssize_t xOff_ = - 0, ssize_t yOff_ = 0, bool xNegative_ = false, bool - yNegative_ = false -	- Construct geometry via explicit parameters. -
		- const string geometry_ -	- Construct geometry from C++ string -
		- const char * geometry_ -	- Construct geometry from C string -
- width -	- void -	- size_t width_ -	- Width -
- width -	- size_t -	- void -	- Width -
- height -	- void -	- size_t height_ -	- Height -
- height -	- size_t -	- void -	- Height -
- xOff -	- void -	- ssize_t xOff_ -	- X offset from origin -
- xOff -	- ssize_t -	- void -	- X offset from origin -
- yOff -	- void -	- ssize_t yOff_ -	- Y offset from origin -
- yOff -	- size_t -	- void -	- Y offset from origin -
- xNegative -	- void -	- bool xNegative_ -	- Sign of X offset negative? (X origin at right) -
- xNegative -	- bool -	- void -	- Sign of X offset negative? (X origin at right) -
- yNegative -	- void -	- bool yNegative_ -	- Sign of Y offset negative? (Y origin at bottom) -
- yNegative -	- bool -	- void -	- Sign of Y offset negative? (Y origin at bottom) -
- percent -	- void -	- bool percent_ -	- Width and height are expressed as percentages -
- percent -	- bool -	- void -	- Width and height are expressed as percentages -
- aspect -	- void -	- bool aspect_ -	- Resize without preserving aspect ratio (!) -
- aspect -	- bool -	- void -	- Resize without preserving aspect ratio (!) -
- greater -	- void -	- bool greater_ -	- Resize if image is greater than size (>) -
- greater -	- bool -	- void -	- Resize if image is greater than size (>) -
- less -	- void -	- bool less_ -	- Resize if image is less than size (<) -
- less -	- bool -	- void -	- Resize if image is less than size (<) -
- isValid -	- void -	- bool isValid_ -	- Does object contain a valid geometry? May be set to false - in order to invalidate an existing geometry object. -
- isValid -	- bool -	- void -
- operator = -	- const Geometry& -	- const string geometry_ -	- Set geometry via C++ string -
- operator = -	- const Geometry& -	- const char * geometry_ -	- Set geometry via C string -
- operator string -	- string -	- Geometry& -	- Obtain C++ string representation of geometry -

In addition, we support these yet to be documented geometry flags: the fill area flag ('^') and the pixel area count limit flag ('@').

- - diff --git a/ImageMagick/Magick++/Image++.html b/ImageMagick/Magick++/Image++.html deleted file mode 100644 index 6f7d166e8..000000000 --- a/ImageMagick/Magick++/Image++.html +++ /dev/null @@ -1,3145 +0,0 @@ - - - - - -Magick++ API: Working with Images - - - -

- -

Magick::Image Class

- -

Quick Contents

Image is the primary object in Magick++ and represents -a single image frame (see design ). The -STL interface must be used to operate on -image sequences or images (e.g. of format GIF, TIFF, MIFF, Postscript, -& MNG) which are comprized of multiple image frames. Individual -frames of a multi-frame image may be requested by adding array-style -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 -image -pixels. As a convenience, including <Magick++.h> -is sufficient in order to use the complete Magick++ API. The Magick++ -API is enclosed within the Magick namespace so you must either -add the prefix " Magick:: " to each class/enumeration name or -add -the statement " using namespace Magick;" after including the Magick++.h -header.

The preferred way to allocate Image objects is via automatic -allocation (on the stack). There is no concern that allocating Image -objects on the stack will excessively enlarge the stack since Magick++ -allocates all large data objects (such as the actual image data) from -the heap. Use of automatic allocation is preferred over explicit -allocation (via new) since it is much less error prone and -allows use of C++ scoping rules to avoid memory leaks. Use of automatic -allocation allows Magick++ objects to be assigned and copied just like -the C++ intrinsic data types (e.g. 'int '), leading to clear and -easy to read code. Use of automatic allocation leads to naturally -exception-safe code since if an exception is thrown, the object is -automagically deallocated once the stack unwinds past the scope of the -allocation (not the case for objects allocated via new ).

Image is very easy to use. For example, here is a the source to a -program which reads an image, crops it, and writes it to a new file -(the -exception handling is optional but strongly recommended):

-#include <Magick++.h> 
-#include <iostream> 
-using namespace std; 
-using namespace Magick; 
-int main(int argc,char **argv) 
-{ 
-  InitializeMagick(*argv);
-
-  // Construct the image object. Seperating image construction from the 
-  // the read operation ensures that a failure to read the image file 
-  // doesn't render the image object useless. 
-  Image image;
-  try { 
-    // Read a file into image object 
-    image.read( "girl.gif" );
-
-    // Crop the image to specified size (width, height, xOffset, yOffset)
-    image.crop( Geometry(100,100, 100, 100) );
-
-    // Write the image to a file 
-    image.write( "x.gif" ); 
-  } 
-  catch( Exception &error_ ) 
-    { 
-      cout << "Caught exception: " << error_.what() << endl; 
-      return 1; 
-    } 
-  return 0; 
-}
-

-The following is the source to a program which illustrates the use of -Magick++'s efficient reference-counted assignment and copy-constructor -operations which minimize use of memory and eliminate unncessary copy -operations (allowing Image objects to be efficiently assigned, and -copied into containers). The program accomplishes the -following: -

Read master image.
Assign master image to second image.
Resize second image to the size 640x480.
Assign master image to a third image.
Resize third image to the size 800x600.
Write the second image to a file.
Write the third image to a file.

-#include <Magick++.h> 
-#include <iostream> 
-using namespace std; 
-using namespace Magick; 
-int main(int argc,char **argv) 
-{ 
-  InitializeMagick(*argv);
-
-  Image master("horse.jpg"); 
-  Image second = master; 
-  second.resize("640x480"); 
-  Image third = master; 
-  third.resize("800x600"); 
-  second.write("horse640x480.jpg"); 
-  third.write("horse800x600.jpg"); 
-  return 0; 
-}
-

-During the entire operation, a maximum of three images exist in memory -and the image data is never copied. -

The following is the source for another simple program which creates -a 100 by 100 pixel white image with a red pixel in the center and -writes it to a file:

-#include <Magick++.h> 
-using namespace std; 
-using namespace Magick; 
-int main(int argc,char **argv) 
-{ 
-  InitializeMagick(*argv);
-  Image image( "100x100", "white" ); 
-  image.pixelColor( 49, 49, "red" ); 
-  image.write( "red_pixel.png" ); 
-  return 0; 
-}
-

-If you wanted to change the color image to grayscale, you could add the -lines: -

-image.quantizeColorSpace( GRAYColorspace ); 
-image.quantizeColors( 256 ); 
-image.quantize( );
-

or, more simply:

- image.type( GrayscaleType );
-

prior to writing the image.

- -

BLOBs

- -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 -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 -has been placed within a Blob, it may be read into a Magick++ Image via -a constructor or read() -. Likewise, a Magick++ image may be written to a Blob via write() . -

An example of using Image to write to a Blob follows:
-

-#include >Magick++.h> 
-using namespace std; 
-using namespace Magick; 
-int main(int argc,char **argv) 
-{ 
-  InitializeMagick(*argv);
-
-  // Read GIF file from disk 
-  Image image( "giraffe.gif" );
-  // Write to BLOB in JPEG format 
-  Blob blob; 
-  image.magick( "JPEG" ) // Set JPEG output format 
-  image.write( &blob );
-
-  [ Use BLOB data (in JPEG format) here ]
-
-  return 0; 
-}
-

-likewise, to read an image from a Blob, you could use one of the -following examples:

[ Entry condition for the following examples -is that data is pointer to encoded image data and length -represents the size of the data ]

-Blob blob( data, length ); 
-Image image( blob );
-

-or -

-Blob blob( data, length ); 
-Image image; 
-image.read( blob);
-

-some images do not contain their size or format so the size and format must be specified in advance: -

-Blob blob( data, length ); 
-Image image; 
-image.size( "640x480") 
-image.magick( "RGBA" ); 
-image.read( blob);
-

- -

Constructors

- -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 -constructors are shown in the following table:
-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Image Constructors

- Signature -

- Description -

const std::string &imageSpec_

Construct Image by reading from file or URL -specified by imageSpec_. Use array notation (e.g. filename[9]) -to select a specific scene from a multi-frame image.

const Geometry &size_, const Color &color_

Construct a blank image canvas of specified -size and color

const Blob &blob_

Construct Image by reading from -encoded image data contained in an in-memory BLOB -. Depending on the constructor arguments, the Blob size -, depth , magick (format) -may -also be specified. Some image formats require that size be specified. -The default ImageMagick uses for depth depends on the compiled-in -Quantum size (8 or 16). If ImageMagick's Quantum size does not -match that of the image, the depth may need to be specified. -ImageMagick can usually automagically detect the image's format. -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, -size_t depth

const Blob -&blob_, const Geometry &size, -size_t depth_, const string &magick_

const Blob -&blob_, const Geometry &size, -const -string &magick_

const size_t width_,
- const size_t height_,
- std::string map_,
- const -StorageType type_,
- const void *pixels_

Construct a new Image based on an array of -image pixels. The pixel data must be in scanline order top-to-bottom. -The data can be character, short int, integer, float, or double. Float -and double require the pixels to be normalized [0..1]. The other types -are [0..MaxRGB]. For example, to create a 640x480 image from -unsigned red-green-blue character data, use -

Image image( 640, 480, "RGB", -0, pixels );

The parameters are as follows:
-

- - - - - - - - - - - - - - - - - - - - - - - -

width_	Width in pixels of the image.
height_	Height in pixels of the image.
map_	This character string can be any -combination or order of R = red, G = green, B = blue, A = alpha, C = -cyan, Y = yellow M = magenta, and K = black. The ordering reflects the -order of the pixels in the supplied pixel array.
type_	Pixel -storage type (CharPixel, ShortPixel, IntegerPixel, FloatPixel, or -DoublePixel)
pixels_	This array of values contain the pixel -components as defined by the map_ and type_ parameters. The length of -the arrays must equal the area specified by the width_ and height_ -values and type_ parameters.

- -

Image Manipulation -Methods

- -Image supports access to all the single-image (versus -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 -abstraction on top of Image, must be used. -

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

-Image image; 
-image.read("myImage.tiff"); 
-image.addNoise(GaussianNoise); 
-image.write("myImage.tiff");
-

-adds gaussian noise to the image file "myImage.tiff". -

The operations supported by Image are shown in the following table:
-

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Image Image Manipulation Methods

Method

Signature(s)

Description

adaptiveThreshold
-

size_t width, size_t -height, size_t offset = 0
-

Apply adaptive thresholding to -the image. Adaptive thresholding is useful if the ideal threshold level -is not known in advance, or if the illumination gradient is not -constant -across the image. Adaptive thresholding works by evaulating the mean -(average) of a pixel region (size specified by width and height) -and using the mean as the thresholding value. In order to remove -residual noise from the background, the threshold may be adjusted by -subtracting a constant offset (default zero) from the mean to -compute the threshold.
-

- addNoise -

NoiseType -noiseType_

Add noise to image with specified noise type.

addNoiseChannel
-

const ChannelType -channel_, const NoiseType noiseType_
-

Add noise to an image -channel with the specified noise type. The channel_ parameter specifies the -channel to add noise to. The noiseType_ parameter -specifies the type of noise.
-

affineTransform
-

const DrawableAffine -&affine
-

Transform image by -specified affine (or free transform) matrix.
-

- annotate -

const std::string &text_, const Geometry &location_

Annotate using specified text, and placement -location

string text_, const Geometry -&boundingArea_, GravityType -gravity_

Annotate using specified text, bounding area, -and placement gravity. If boundingArea_ is invalid, then -bounding area is entire image.

const std::string &text_, const Geometry &boundingArea_, GravityType gravity_, double -degrees_,

Annotate with text using specified text, -bounding area, placement gravity, and rotation. If boundingArea_ -is invalid, then bounding area is entire image.

const std::string &text_, GravityType gravity_

Annotate with text (bounding area is entire -image) and placement gravity.

- blur -

const double radius_ = 1, const double sigma_ -= 0.5

Blur image. The radius_ parameter -specifies the radius of the Gaussian, in pixels, not counting the -center -pixel. The sigma_ parameter specifies the standard -deviation of the Laplacian, in pixels.

blurChannel
-

const ChannelType -channel_, const double radius_ = 0.0, const double sigma_ = 1.0
-

Blur an image -channel. The channel_ -parameter specifies the channel to blur. The radius_ parameter -specifies the radius of the Gaussian, in pixels, not counting the -center -pixel. The sigma_ parameter specifies the standard -deviation of the Laplacian, in pixels.

- border -

const Geometry -&geometry_ = "6x6+0+0"

Border image (add border to image). The -color of the border is specified by the borderColor attribute.

- cdl -

const std::string &cdl_

color correct with a color decision list. See http://en.wikipedia.org/wiki/ASC_CDL for details.

- channel -

ChannelType -layer_

Extract channel from image. Use this option -to extract a particular channel from the image. MatteChannel - for example, is useful for extracting the opacity values -from an image.

- charcoal -

const double radius_ = 1, const double sigma_ -= 0.5

Charcoal effect image (looks like charcoal -sketch). The radius_ parameter specifies the radius of the -Gaussian, in pixels, not counting the center pixel. The sigma_ -parameter specifies the standard deviation of the Laplacian, in pixels.

- chop -

const Geometry -&geometry_

Chop image (remove vertical or horizontal -subregion of image)

- colorize -

const unsigned int opacityRed_, const -unsigned int opacityGreen_, const unsigned int opacityBlue_, const -Color &penColor_

Colorize image with pen color, using -specified percent opacity for red, green, and blue quantums.

- colorMatrix -

const size_t order_, const double *color_matrix_

apply color correction to the image.

- comment -

const std::string &comment_

Comment image (add comment string to -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.

compare
-

const Image &reference_
-

Compare current image with -another image. Sets meanErrorPerPixel -, normalizedMaxError , and normalizedMeanError in the current -image. False is returned if the images are identical. An ErrorOption -exception is thrown if the reference image columns, rows, colorspace, -or -matte differ from the current image.
-

- composite -

const Image -&compositeImage_, ssize_t xOffset_, ssize_t yOffset_, CompositeOperator -compose_ = InCompositeOp

Compose an image onto the current image at -offset specified by xOffset_, yOffset_ using the -composition algorithm specified by compose_.

const Image -&compositeImage_, const Geometry -&offset_, CompositeOperator -compose_ = InCompositeOp

Compose an image onto the current image at -offset specified by offset_ using the composition algorithm -specified by compose_ .

const Image -&compositeImage_, GravityType -gravity_, CompositeOperator -compose_ = InCompositeOp

Compose an image onto the current image with -placement specified by gravity_ using the composition -algorithm -specified by compose_.

- contrast -

size_t sharpen_

Contrast image (enhance intensity differences -in image)

- convolve -

size_t order_, const double *kernel_

Convolve image. Applies a user-specfied -convolution to the image. The order_ parameter represents the -number of columns and rows in the filter kernel, and kernel_ -is a two-dimensional array of doubles representing the convolution -kernel to apply.

- crop -

const Geometry -&geometry_

Crop image (subregion of original image)

- cycleColormap -

int amount_

Cycle image colormap

- despeckle -

void

Despeckle image (reduce speckle noise)

- display -

void

Display image on screen.
- Caution: if -an image format is is not compatible with the display visual (e.g. -JPEG on a colormapped display) then the original image will be -altered. Use a copy of the original if this is a problem.

- distort -

const DistortImageMethod method, const size_t number_arguments, const double *arguments, const bool bestfit = false

Distort image. Applies a user-specfied -distortion to the image.

- draw -

const Drawable -&drawable_

Draw shape or text on image.

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 -drawing performance and allows batching draw objects together in a -list for repeated use.

- edge -

size_t radius_ = 0.0

Edge image (hilight edges in image). -The radius is the radius of the pixel neighborhood.. Specify a radius -of zero for automatic radius selection.

- emboss -

const double radius_ = 1, const double sigma_ -= 0.5

Emboss image (hilight edges with 3D effect). -The radius_ parameter specifies the radius of the Gaussian, in -pixels, not counting the center pixel. The sigma_ -parameter specifies the standard deviation of the Laplacian, in pixels.

- enhance -

void

Enhance image (minimize noise)

- equalize -

void

Equalize image (histogram equalization)

- erase -

void

Set all image pixels to the current -background color.

- extent

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 GravityType -&gravity_

extends the image as defined by the geometry, gravity, and image background color.

const Geometry -&geometry_, const Color &backgroundColor_, -const GravityType &gravity_

- flip -

void

Flip image (reflect each scanline in the -vertical direction)

- floodFill- -
- Color -

ssize_t x_, ssize_t y_, const 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_

ssize_t x_, ssize_t y_, const 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_

floodFillOpacity

const long x_, const long y_, const unsigned int -opacity_, const PaintMethod method_

Floodfill pixels matching color (within fuzz -factor) of target pixel(x,y) with replacement opacity value using -method.

- floodFill- -
- Texture -

ssize_t x_, ssize_t y_, const -Image &texture_

Flood-fill texture 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 Image &texture_

ssize_t x_, ssize_t y_, const Image -&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 -Color -&borderColor_

- flop -

void

Flop image (reflect each scanline in the -horizontal direction)

- frame -

const Geometry -&geometry_ = "25x25+6+6"

Add decorative frame around image

size_t width_, size_t height_, -ssize_t x_, ssize_t y_, ssize_t innerBevel_ = 0, ssize_t outerBevel_ = 0

- fx -

const std::string expression, const Magick::ChannelType channel

Fx image. Applies a mathematical -expression to the image.

- gamma -

double gamma_

Gamma correct image (uniform red, green, and -blue correction).

double gammaRed_, double gammaGreen_, double -gammaBlue_

Gamma correct red, green, and blue channels -of image.

- gaussianBlur -

const double width_, const double sigma_

Gaussian blur image. The number of neighbor -pixels to be included in the convolution mask is specified by -'width_'. For example, a width of one gives a (standard) 3x3 -convolution mask. The standard deviation of the gaussian bell curve is -specified by 'sigma_'.

gaussianBlurChannel
-

const ChannelType -channel_, const double radius_ = 0.0, const double sigma_ = 1.0
-

Gaussian blur -an image channel. The channel_ parameter specifies the -channel to blur. The number of neighbor -pixels to be included in the convolution mask is specified by -'width_'. For example, a width of one gives a (standard) 3x3 -convolution mask. The standard deviation of the gaussian bell curve is -specified by 'sigma_'.

haldClut
-

const Image &reference_
-

apply a Hald color lookup table to the image.
-

- implode -

const double factor_

Implode image (special effect)

- inverseFourierTransform -

const Image &phaseImage_, const bool magnitude_

implements the inverse discrete Fourier transform (DFT) of the image either as a magnitude / phase or real / imaginary image pair.

- label -

const string &label_

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 -special format characters. If the first character of string is @, -the -image label is read from a file titled by the remaining characters in -the string. When converting to Postscript, use this option to -specify a header string to print above the image.

level
-

const double black_point, -const double white_point, const double mid_point=1.0
-

Level image. Adjust the -levels of the image by scaling the colors falling between specified -white and black points to the full available quantum range. The -parameters provided represent the black, mid (gamma), and white -points. The black point specifies the darkest color in the image. -Colors darker than the black point are set to zero. Mid point (gamma) -specifies a gamma correction to apply to the image. White point -specifies the lightest color in the image. Colors brighter than -the white point are set to the maximum quantum value. The black and -white point have the valid range 0 to MaxRGB while mid (gamma) has a -useful range of 0 to ten.
-

levelChannel
-

const ChannelType -channel, const double black_point, const double white_point, const -double mid_point=1.0
-

Level image channel. -Adjust the levels of the image channel by scaling the values falling -between specified white and black points to the full available quantum -range. The parameters provided represent the black, mid (gamma), and -white points. The black point specifies the darkest color in the image. -Colors darker than the black point are set to zero. Mid point (gamma) -specifies a gamma correction to apply to the image. White point -specifies the lightest color in the image. Colors brighter than the -white point are set to the maximum quantum value. The black and white -point have the valid range 0 to MaxRGB while mid (gamma) has a useful -range of 0 to ten.
-

- magnify -

void

Magnify image by integral size

- map -

const Image &mapImage_ , bool dither_ = -false

Remap image colors with closest color from -reference image. Set dither_ to true in to apply -Floyd/Steinberg -error diffusion to the image. By default, color reduction chooses an -optimal set of colors that best represent the original -image. Alternatively, you can choose a -particular set of colors from an image file -with this option.

- matteFloodfill -

const Color -&target_, const unsigned int opacity_, const ssize_t x_, const -ssize_t -y_, PaintMethod method_

Floodfill designated area with a replacement -opacity value.

medianFilter

const double radius_ = 0.0

Filter image by replacing each pixel -component with the median color in a circular neighborhood

- mergeLayers -

LayerMethod -noiseType_

handle multiple images forming a set of image layers or animation frames.

- minify -

void

Reduce image by integral size

modifyImage

void

Prepare to update image. Ensures that there -is only one reference to the underlying image so that the underlying -image may be safely modified without effecting previous generations of -the image. Copies the underlying image to a new image if necessary.

- modulate -

double brightness_, double saturation_, -double hue_

Modulate percent hue, saturation, and -brightness of an image. Modulation of saturation and brightness is as a -ratio of the current value (100.0 for no change). Modulation of hue is an -absolute rotation of -180 degrees to +180 degrees from the current -position corresponding to an argument range of 0 to 200.0 (100.0 for no -change).

motionBlur
-

const double radius_, -const double sigma_, const double angle_
-

Motion blur image with -specified blur factor. The radius_ parameter specifies the radius of -the Gaussian, in pixels, not counting the center pixel. The -sigma_ parameter specifies the standard deviation of the Laplacian, in -pixels. The angle_ parameter specifies the angle the object appears to -be comming from (zero degrees is from the right).
-

- negate -

bool grayscale_ = false

Negate colors in image. Replace every -pixel with its complementary color (white becomes black, yellow becomes -blue, etc.). Set grayscale to only negate grayscale values in -image.

- normalize -

void

Normalize image (increase contrast by -normalizing the pixel values to span the full range of color values).

- oilPaint -

size_t radius_ = 3

Oilpaint image (image looks like oil painting)

- opacity -

unsigned int opacity_

Set or attenuate the opacity channel in the -image. If the image pixels are opaque then they are set to the -specified -opacity value, otherwise they are blended with the supplied opacity -value. The value of opacity_ ranges from 0 (completely opaque) to - MaxRGB -. The defines OpaqueOpacity and TransparentOpacity are -available to specify completely opaque or completely transparent, -respectively.

- opaque -

const Color -&opaqueColor_, const Color &penColor_

Change color of pixels matching opaqueColor_ -to specified penColor_.

- ping -

const std::string &imageSpec_

Ping is similar to read -except only enough of the image is read to determine the image columns, -rows, and filesize. The columns , - rows , and fileSize -attributes are valid after invoking ping. The image data is not -valid after calling ping.

const Blob &blob_

process
-

std::string name_, -const ssize_t argc_, char **argv_
-

Execute the named -process module, passing any arguments via an argument vector, with -argc_ -specifying the number of arguments in the vector, and argv_ passing the -address of an array of null-terminated C strings which constitute the -argument vector. An exception is thrown if the requested process module -does not exist, fails to load, or fails during execution.
-

- quantize -

bool measureError_ = false

Quantize image (reduce number of colors). Set -measureError_ to true in order to calculate error attributes.

- raise -

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)

- read -

const string &imageSpec_

Read image into current object

const Geometry -&size_, const std::string &imageSpec_

Read image of specified size into current -object. This form is useful for images that do not specifiy their size -or to specify a size hint for decoding an image. For example, when -reading a Photo CD, JBIG, or JPEG image, a size request causes the -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_

Read encoded image of specified -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 -Quantum size (8 or 16). If ImageMagick's Quantum size does not -match that of the image, the depth may need to be specified. -ImageMagick can usually automagically detect the image's format. -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_, -size_t depth_

const Blob -&blob_, const Geometry &size_, -size_t depth_, const string &magick_

const Blob -&blob_, const Geometry &size_, -const -string &magick_

const size_t width_, const size_t -height_, std::string map_, const StorageType type_, const void *pixels_

Read image based on an array of image pixels. -The pixel data must be in scanline order top-to-bottom. The data can be -character, short int, integer, float, or double. Float and double -require the pixels to be normalized [0..1]. The other types are -[0..MaxRGB]. For example, to create a 640x480 image from -unsigned red-green-blue character data, use -

image.read( 640, 480, "RGB", CharPixel, -pixels );

The parameters are as follows:
-

- - - - - - - - - - - - - - - - - - - - - - - -

width_	Width in pixels of the image.
height_	Height in pixels of the image.
map_	This character string can be any -combination or order of R = red, G = green, B = blue, A = alpha, C = -cyan, Y = yellow M = magenta, and K = black. The ordering reflects the -order of the pixels in the supplied pixel array.
type_	Pixel storage type (CharPixel, -ShortPixel, IntegerPixel, FloatPixel, or DoublePixel)
pixels_	This array of values contain the pixel -components as defined by the map_ and type_ parameters. The length of -the arrays must equal the area specified by the width_ and height_ -values and type_ parameters.

- reduceNoise -

const double order_

reduce noise in image using a noise peak elimination filter.

randomThreshold
-

const Geometry -&thresholds_
-

Random threshold the -image. Changes the value of individual pixels based on the intensity of -each pixel compared to a random threshold. The result is a -low-contrast, two color image. The thresholds_ argument is a -geometry containing LOWxHIGH thresholds. If the string contains -2x2, 3x3, or 4x4, then an ordered dither of order 2, 3, or 4 will be -performed instead. This is a very fast alternative to 'quantize' based -dithering.
-

randomThresholdChannel
-

const Geometry -&thresholds_, const ChannelType channel_
-

Random threshold an -image channel. Similar to randomThreshold() -but restricted to the specified channel.
-

- roll -

int columns_, ssize_t rows_

Roll image (rolls image vertically and -horizontally) by specified number of columnms and rows)

- rotate -

double degrees_

Rotate image counter-clockwise by specified -number of degrees.

- sample -

const Geometry -&geometry_

Resize image by using pixel sampling algorithm

- scale -

const Geometry -&geometry_

Resize image by using simple ratio algorithm

- segment -

double clusterThreshold_ = 1.0,
- double smoothingThreshold_ = 1.5

Segment (coalesce similar image components) -by analyzing the histograms of the color components and identifying -units that are homogeneous with the fuzzy c-means technique. Also uses quantizeColorSpace -and verbose image attributes. Specify clusterThreshold_ -, -as the number of pixels each cluster must -exceed -the cluster threshold to be considered valid. SmoothingThreshold_ -eliminates noise in the second derivative of the histogram. As -the -value is increased, you can expect a smoother -second derivative. The default is 1.5.

- shade -

double azimuth_ = 30, double elevation_ = 30, -
- bool colorShading_ = false

Shade image using distant light source. -Specify azimuth_ and elevation_ as the -position of the light source. By default, the shading -results as a grayscale image.. Set colorShading_ to true -to -shade the red, green, and blue components of the image.

- shadow -

const double percent_opacity = 80, const double sigma_ -= 0.5, const ssize_t x_ = 0, const ssize_t y_ = 0

simulate an image shadow

- sharpen -

const double radius_ = 1, const double sigma_ -= 0.5

Sharpen pixels in image. The radius_ -parameter specifies the radius of the Gaussian, in pixels, not counting -the center pixel. The sigma_ parameter specifies the -standard deviation of the Laplacian, in pixels.

sharpenChannel
-

const ChannelType -channel_, const double radius_ = 0.0, const double sigma_ = 1.0
-

Sharpen pixel -quantums in an image channel The channel_ parameter specifies the -channel to sharpen.. The radius_ -parameter specifies the radius of the Gaussian, in pixels, not counting -the center pixel. The sigma_ parameter specifies the -standard deviation of the Laplacian, in pixels.

- shave -

const Geometry &geometry_

Shave pixels from image edges.

- shear -

double xShearAngle_, double yShearAngle_

Shear image (create parallelogram by sliding -image by X or Y axis). Shearing slides one edge of an image along -the X or Y axis, creating a -parallelogram. An X direction shear slides an edge along the X -axis, while a Y direction shear slides -an edge along the Y axis. The amount of the shear is controlled -by a shear angle. For X direction shears, x -degrees is measured relative to the Y axis, and similarly, for Y -direction shears y degrees is measured relative to the X -axis. Empty triangles left over from shearing the image are -filled with the color defined as borderColor.

- solarize -

double factor_ = 50.0

Solarize image (similar to effect seen when -exposing a photographic film to light during the development process)

- splice -

const Geometry -&geometry_

splice the background color into the image

- spread -

size_t amount_ = 3

Spread pixels randomly within image by -specified amount

- stegano -

const Image &watermark_

Add a digital watermark to the image (based -on second image)

- sparseColor -

const ChannelType channel, const SparseColorMethod method, const size_t number_arguments, const double *arguments

Sparse color image, given a set of coordinates, interpolates the colors found at those coordinates, across the whole image, using various methods.

- statistics -

ImageStatistics *statistics

Obtain image statistics. Statistics are normalized to the range of 0.0 to 1.0 and are output to the specified ImageStatistics structure. The structure includes members maximum, minimum, mean, standard_deviation, and variance for each of these channels: red, green, blue, and opacity (e.g. statistics->red.maximum).

- stereo -

const Image &rightImage_

Create an image which appears in stereo when -viewed with red-blue glasses (Red image on left, blue on right)

- swirl -

double degrees_

Swirl image (image pixels are rotated by -degrees)

- texture -

const Image &texture_

Layer a texture on pixels matching image -background color.

- threshold -

double threshold_

Threshold image

- transform -

const Geometry -&imageGeometry_

Transform image based on image -and crop geometries. Crop geometry is optional.

const Geometry -&imageGeometry_, const Geometry -&cropGeometry_

- transparent -

const Color -&color_

Add matte image to image, setting pixels -matching color to transparent.

- trim -

void

Trim edges that are the background color from -the image.

- unsharpmask -

double radius_, double sigma_, double -amount_, double threshold_

Sharpen the image using the unsharp mask -algorithm. The radius_ -parameter specifies the radius of the Gaussian, in pixels, not -counting the center pixel. The sigma_ parameter specifies the -standard deviation of the Gaussian, in pixels. The amount_ -parameter specifies the percentage of the difference between the -original and the blur image that is added back into the original. The threshold_ -parameter specifies the threshold in pixels needed to apply the -diffence amount.

unsharpmaskChannel
-

const ChannelType -channel_, const double radius_, const double sigma_, const double -amount_, const double threshold_
-

Sharpen an image -channel using the unsharp mask algorithm. The channel_ parameter specifies the -channel to sharpen. The radius_ -parameter specifies the radius of the Gaussian, in pixels, not -counting the center pixel. The sigma_ parameter specifies the -standard deviation of the Gaussian, in pixels. The amount_ -parameter specifies the percentage of the difference between the -original and the blur image that is added back into the original. The threshold_ -parameter specifies the threshold in pixels needed to apply the -diffence amount.

- wave -

double amplitude_ = 25.0, double wavelength_ -= 150.0

Alter an image along a sine wave.

- write -

const string &imageSpec_

Write image to a file using filename imageSpec_ -.
- Caution: if -an image format is selected which is capable of supporting fewer -colors than the original image or quantization has been requested, the -original image will be quantized to fewer colors. Use a copy of the -original if this is a problem.

Blob *blob_

Write image to a in-memory 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 ).
- Caution: if -an image format is selected which is capable of supporting fewer -colors than the original image or quantization has been requested, the -original image will be quantized to fewer colors. Use a copy of the -original if this is a problem.

Blob *blob_, -std::string &magick_

Blob *blob_, -std::string &magick_, size_t depth_

const ssize_t x_, const ssize_t y_, const size_t -columns_, const size_t rows_, const std::string &map_, -const StorageType type_, void *pixels_

Write pixel data into a buffer you supply. -The data is saved either as char, short int, integer, float or double -format in the order specified by the type_ parameter. For example, we -want to extract scanline 1 of a 640x480 image as character data in -red-green-blue order: -

image.write(0,0,640,1,"RGB",0,pixels); -

The parameters are as follows:
-

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

x_	Horizontal ordinate of left-most -coordinate of region to extract.
y_	Vertical ordinate of top-most -coordinate of region to extract.
columns_	Width in pixels of the region to -extract.
rows_	Height in pixels of the region to -extract.
map_	This character string can be any -combination or order of R = red, G = green, B = blue, A = alpha, C = -cyan, Y = yellow, M = magenta, and K = black. The ordering reflects -the order of the pixels in the supplied pixel array.
type_	Pixel storage type (CharPixel, -ShortPixel, IntegerPixel, FloatPixel, or DoublePixel)
pixels_	This array of values contain the pixel -components as defined by the map_ and type_ parameters. The length of -the arrays must equal the area specified by the width_ and height_ -values and type_ parameters.

- resize -

const Geometry -&geometry_

Resize image to specified size.

- -

Image Attributes

- -Image attributes are set and obtained via methods in Image. Except for -methods which accept pointer arguments (e.g. chromaBluePrimary) -all methods return attributes by value. -

Image attributes are easily used. For example, to set the resolution -of the TIFF file "file.tiff" to 150 dots-per-inch (DPI) in both the -horizontal and vertical directions, you can use the following example -code:

-string filename("file.tiff"); 
-Image image; 
-image.read(filename); 
-image.resolutionUnits(PixelsPerInchResolution); 
-image.density(Geometry(150,150));   // could also use image.density("150x150") 
-image.write(filename)
-

-The supported image attributes and the method arguments required to -obtain them are shown in the following table:
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Image Attributes
- Function -	- Type -	- Get Signature -	- Set Signature -	- Description -
- adjoin -	bool	void	bool flag_	Join images into a single multi-image file.
- antiAlias -	bool	void	bool flag_	Control antialiasing of rendered Postscript -and Postscript or TrueType fonts. Enabled by default.
- animation- - - Delay -	size_t (0 to 65535)	void	size_t delay_	Time in 1/100ths of a second (0 to 65535) -which must expire before displaying the next image in an animated -sequence. This option is useful for regulating the animation of a -sequence of GIF images within Netscape.
- animation- - - Iterations -	size_t	void	size_t iterations_	Number of iterations to loop an animation -(e.g. Netscape loop extension) for.
attribute -	string -	const -std::string name_ -	const -std::string name_, const std::string value_	An arbitrary named -image attribute. Any number of named attributes may be attached to the -image. For example, the image comment is a named image attribute with -the name "comment". EXIF tags are attached to the image as named -attributes. Use the syntax "EXIF:<tag>" to request an EXIF tag -similar to "EXIF:DateTime". -
- background- - - Color -	Color	void	const Color -&color_	Image background color
- background- - - Texture -	string	void	const string &texture_	Image file name to use as the background -texture. Does not modify image pixels.
- baseColumns -	size_t	void		Base image width (before transformations)
- baseFilename -	string	void		Base image filename (before transformations)
- baseRows -	size_t	void		Base image height (before transformations)
- borderColor -	Color	void	const Color -&color_	Image border color
boundingBox	Geometry	void		Return smallest bounding box enclosing -non-border pixels. The current fuzz value is used when discriminating -between pixels. This is the crop bounding box used by -crop(Geometry(0,0)).
- boxColor -	Color	void	const Color -&boxColor_	Base color that annotation text is rendered -on.
cacheThreshold	size_t		const size_t	Pixel cache threshold in bytes. Once this -threshold is exceeded, all subsequent pixels cache operations are -to/from disk. This is a static method and the attribute it sets is -shared by all Image objects.
channelDepth -	size_t - -	const -ChannelType channel_ -	const ChannelType -channel_, const size_t depth_ -	Channel modulus depth. -The channel modulus depth represents the minimum number of bits -required -to support the channel without loss. Setting the channel's modulus -depth -modifies the channel (i.e. discards resolution) if the requested -modulus -depth is less than the current modulus depth, otherwise the channel is -not altered. There is no attribute associated with the modulus depth so -the current modulus depth is obtained by inspecting the pixels. As a -result, the depth returned may be less than the most recently set -channel depth. Subsequent image processing may result in increasing the -channel depth. -
- chroma- - - BluePrimary -	double x & y	double x_, double y_	double x_, double y_	Chromaticity blue primary point (e.g. x=0.15, -y=0.06)
- chroma- - - GreenPrimary -	double x & y	double x_, double y_	double x_, double y_	Chromaticity green primary point (e.g. x=0.3, -y=0.6)
- chroma- - - RedPrimary -	double x & y	double x_, double y_	double x_, double y_	Chromaticity red primary point (e.g. x=0.64, -y=0.33)
- chroma- - - WhitePoint -	double x & y	doublex_, double y_	double x_, double y_	Chromaticity white point (e.g. x=0.3127, -y=0.329)
- classType -	ClassType -	void	ClassType -class_	Image storage class. Note that -conversion from a DirectClass image to a PseudoClass image may result -in a loss of color due to the limited size of the palette (256 or -65535 colors).
- clipMask -	Image	void	const Image &clipMask_	Associate a clip mask image with the current -image. The clip mask image must have the same dimensions as the current -image or an exception is thrown. Clipping occurs wherever pixels are -transparent in the clip mask image. Clipping Pass an invalid image to -unset an existing clip mask.
- colorFuzz -	double	void	double fuzz_	Colors within this distance are considered -equal. A number of algorithms search for a target color. By -default the color must be exact. Use this option to match colors that -are close to the target color in RGB space.
- colorMap -	Color	size_t index_	size_t index_, const Color &color_	Color at colormap index.
- colorMapSize - -	size_t -	void -	size_t entries_ -	Number of entries in the -colormap. Setting the colormap size may extend or truncate the -colormap. -The maximum number of supported entries is specified by the MaxColormapSizeconstant, -and is dependent on the value of QuantumDepth when ImageMagick is -compiled. An exception is thrown if more entries are requested than may -be supported. Care should be taken when truncating the colormap to -ensure that the image colormap indexes reference valid colormap entries. -
- colorSpace -	ColorspaceType -colorSpace_	void	ColorspaceType -colorSpace_	The colorspace (e.g. CMYK) used to represent -the image pixel colors. Image pixels are always stored as RGB(A) except -for the case of CMY(K).
- columns -	size_t	void		Image width
- comment -	string	void		Image comment
- compose -	CompositeOperator -	void	CompositeOperator -compose_	Composition operator to be used when -composition is implicitly used (such as for image flattening).
- compress- - - Type -	CompressionType -	void	CompressionType -compressType_	Image compresion type. The default is the -compression type of the specified image file.
- debug -	bool	void	bool flag_	Enable printing of internal debug messages -from ImageMagick as it executes.
defineValue -	string -	const std::string -&magick_, const std::string &key_ -	const std::string -&magick_, const std::string &key_, const std::string -&value_ -	Set or obtain a -definition string to applied when encoding or decoding the specified -format. The meanings of the definitions are format specific. The format -is designated by the magick_ -argument, the format-specific key is designated by key_, and the associated value is -specified by value_. See the -defineSet() method if the key must be removed entirely. -
defineSet -	bool -	const std::string -&magick_, const std::string &key_ -	const std::string -&magick_, const std::string &key_, bool flag_ -	Set or obtain a -definition flag to applied when encoding or decoding the specified -format.. Similar to the defineValue() method except that -passing the flag_ value -'true' -creates a value-less define with that format and key. Passing the flag_ -value 'false' removes any existing matching definition. The method -returns 'true' if a matching key exists, and 'false' if no matching key -exists. -
- density -	Geometry -(default 72x72)	void	const Geometry -&density_	Vertical and horizontal resolution in pixels -of the image. This option specifies an image density when decoding a -Postscript or Portable Document page. Often used with psPageSize.
- depth -	size_t (8-32)	void	size_t depth_	Image depth. Used to specify the bit depth -when reading or writing raw images or when the output format -supports multiple depths. Defaults to the quantum depth that -ImageMagick is compiled with.
- endian -	EndianType -	void	EndianType -endian_	Specify (or obtain) endian option for formats -which support it.
- directory -	string	void		Tile names from within an image montage
- file -	FILE *	FILE *	FILE *file_	Image file descriptor.
- fileName -	string	void	const string &fileName_	Image file name.
- fileSize -	off_t	void		Number of bytes of the image on disk
- fillColor -	Color	void	const Color &fillColor_	Color to use when filling drawn objects
- fillPattern -	Image	void	const Image &fillPattern_	Pattern image to use when filling drawn -objects.
- fillRule -	FillRule -	void	const Magick::FillRule &fillRule_	Rule to use when filling drawn objects.
- filterType -	FilterTypes -	void	FilterTypes -filterType_	Filter to use when resizing image. The -reduction filter employed has a sigificant effect on the time required -to resize an image and the resulting quality. The default filter is Lanczos -which has been shown to produce high quality results when reducing most -images.
- font -	string	void	const string &font_	Text rendering font. If the font is a fully -qualified X server font name, the font is obtained from an X -server. To use a TrueType font, precede the TrueType filename with an -@. Otherwise, specify a Postscript font name (e.g. -"helvetica").
- fontPointsize -	size_t	void	size_t pointSize_	Text rendering font point size
- fontTypeMetrics -	TypeMetric	const std::string &text_, TypeMetric *metrics		Update metrics with font type metrics using -specified text, and current font and fontPointSize settings.
- format -	string	void		Long form image format description.
- gamma -	double (typical range 0.8 to 2.3)	void		Gamma level of the image. The same color -image displayed on two different workstations may -look different due to differences in the display monitor. -Use gamma correction to adjust for this -color difference.
- geometry -	Geometry	void		Preferred size of the image when encoding.
- gifDispose- - - Method -	size_t - { 0 = Disposal not specified, - 1 = Do not dispose of graphic, - 3 = Overwrite graphic with background color, - - 4 = Overwrite graphic with previous graphic. }	void	size_t disposeMethod_	GIF disposal method. This option is used to -control how successive frames are rendered (how the preceding frame is -disposed of) when creating a GIF animation.
- iccColorProfile -	Blob	void	const Blob -&colorProfile_	ICC color profile. Supplied via a 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.
- interlace- - - Type -	InterlaceType -	void	InterlaceType -interlace_	The type of interlacing scheme (default NoInterlace -). This option is used to specify the type of interlacing -scheme for raw image formats such as RGB or YUV. NoInterlace -means do not interlace, LineInterlace uses scanline -interlacing, and PlaneInterlace uses plane interlacing. -PartitionInterlace is like PlaneInterlace except the -different planes are saved to individual files (e.g. -image.R, image.G, and image.B). Use LineInterlace or -PlaneInterlace to create an interlaced GIF or progressive JPEG -image.
- iptcProfile -	Blob	void	const Blob & -iptcProfile_	IPTC profile. Supplied via a 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.
- label -	string	void	const string &label_	Image label
- magick -	string	void	const string &magick_	Get image format (e.g. "GIF")
- matte -	bool	void	bool matteFlag_	True if the image has transparency. If set -True, store matte channel if the image has one otherwise create -an opaque one.
- matteColor -	Color	void	const Color -&matteColor_	Image matte (frame) color
- meanError- - - PerPixel -	double	void		The mean error per pixel computed when an -image is color reduced. This parameter is only valid if verbose is set -to true and the image has just been quantized.
modulusDepth -	size_t - -	void -	size_t -depth_ -	Image -modulus depth (minimum number of bits required to support -red/green/blue components without loss of accuracy). The pixel modulus -depth may be decreased by supplying a value which is less than the -current value, updating the pixels (reducing accuracy) to the new -depth. -The pixel modulus depth can not be increased over the current value -using this method. -
- monochrome -	bool	void	bool flag_	Transform the image to black and white
- montage- - - Geometry -	Geometry	void		Tile size and offset within an image montage. -Only valid for montage images.
- normalized- - - MaxError -	double	void		The normalized max error per pixel computed -when an image is color reduced. This parameter is only valid if verbose -is set to true and the image has just been quantized.
- normalized- - - MeanError -	double	void		The normalized mean error per pixel computed -when an image is color reduced. This parameter is only valid if verbose -is set to true and the image has just been quantized.
orientation -	OrientationType	void -	OrientationType -orientation_	Image orientation. - Supported by some file formats such as DPX and TIFF. Useful for -turning the right way up. -
- packets -	size_t	void		The number of runlength-encoded packets in - - the image
- packetSize -	size_t	void		The number of bytes in each pixel packet
- page -	Geometry -	void	const Geometry &pageSize_	Preferred size and location of an image -canvas. - Use this option to specify the dimensions -and position of the Postscript page in dots per inch or a TEXT page in -pixels. This option is typically used in concert with density . - Page may also be used to position a GIF -image (such as for a scene in an animation) -
- pixelColor -	Color	ssize_t x_, ssize_t y_	ssize_t x_, ssize_t y_, const Color &color_	Get/set pixel color at location x & y.
- profile - -	Blob -	const std::string name_ -	const std::string name_, const Blob -&colorProfile_ -	Get/set/remove a named -profile. Valid names include "*", -"8BIM", "ICM", "IPTC", or a user/format-defined profile name. -
- quality -	size_t (0 to 100)	void	size_t quality_	JPEG/MIFF/PNG compression level (default 75).
- quantize- - - Colors -	size_t	void	size_t colors_	Preferred number of colors in the image. The -actual number of colors in the image may be less than your request, but -never more. Images with less unique colors than specified with this -option will have any duplicate or unused colors removed.
- quantize- - - ColorSpace -	ColorspaceType -	void	ColorspaceType -colorSpace_	Colorspace to quantize colors in (default -RGB). Empirical evidence suggests that 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.
- quantize- - - Dither -	bool	void	bool flag_	Apply Floyd/Steinberg error diffusion to the -image. The basic strategy of dithering is to trade -intensity -resolution for spatial resolution by -averaging the intensities of several -neighboring pixels. Images which suffer from -severe contouring when reducing colors can be -improved with this option. The quantizeColors or monochrome option must -be set for this option to take effect.
- quantize- - - TreeDepth -	size_t	void	size_t treeDepth_	Depth of the quantization color -classification tree. Values of 0 or 1 allow selection of the optimal -tree depth for the color reduction algorithm. Values between 2 and 8 -may be used to manually adjust the tree depth.
- rendering- - - Intent -	RenderingIntent -	void	RenderingIntent -render_	The type of rendering intent
- resolution- - - Units -	ResolutionType -	void	ResolutionType -units_	Units of image resolution
- rows -	size_t	void		The number of pixel rows in the image
- scene -	size_t	void	size_t scene_	Image scene number
- signature -	string	bool force_ = false		Image MD5 signature. Set force_ to 'true' to -force re-computation of signature.
- size -	Geometry	void	const Geometry -&geometry_	Width and height of a raw image (an image -which does not support width and height information). Size may -also be used to affect the image size read from a multi-resolution -format (e.g. Photo CD, JBIG, or JPEG.
- strip -	void	strips an image of all profiles and comments.
- strokeAntiAlias -	bool	void	bool flag_	Enable or disable anti-aliasing when drawing -object outlines.
- strokeColor -	Color	void	const Color &strokeColor_	Color to use when drawing object outlines
- strokeDashOffset -	size_t	void	double strokeDashOffset_	While drawing using a dash pattern, specify -distance into the dash pattern to start the dash (default 0).
- strokeDashArray -	const double*	void	const double* strokeDashArray_	Specify the pattern of dashes and gaps used -to stroke paths. The strokeDashArray represents a zero-terminated -array of numbers that specify the lengths (in pixels) of alternating -dashes and gaps in user units. If an odd number of values is provided, -then the list of values is repeated to yield an even number of -values. A typical strokeDashArray_ array might contain the -members 5 3 2 0, where the zero value indicates the end of the pattern -array.
- strokeLineCap -	LineCap	void	LineCap lineCap_	Specify the shape to be used at the corners -of paths (or other vector shapes) when they are stroked. Values of -LineJoin are UndefinedJoin, MiterJoin, RoundJoin, and BevelJoin.
- strokeLineJoin -	LineJoin	void	LineJoin lineJoin_	Specify the shape to be used at the corners -of paths (or other vector shapes) when they are stroked. Values of -LineJoin are UndefinedJoin, MiterJoin, RoundJoin, and BevelJoin.
- strokeMiterLimit -	size_t	void	size_t miterLimit_	Specify miter limit. When two line segments -meet at a sharp angle and miter joins have been specified for -'lineJoin', it is possible for the miter to extend far beyond the -thickness of the line stroking the path. The miterLimit' imposes a -limit on the ratio of the miter length to the 'lineWidth'. The default -value of this parameter is 4.
- strokeWidth -	double	void	double strokeWidth_	Stroke width for use when drawing vector -objects (default one)
- strokePattern -	Image	void	const Image &strokePattern_	Pattern image to use while drawing object -stroke (outlines).
- subImage -	size_t	void	size_t subImage_	Subimage of an image sequence
- subRange -	size_t	void	size_t subRange_	Number of images relative to the base image
- textEncoding - -	string -	void -	const std::string &encoding_ -	Specify the code set to use for text -annotations. The only character encoding which may be specified at -this time is "UTF-8" for representing Unicode as a -sequence of bytes. Specify an empty string to use the default ASCII -encoding. Successful text annotation using Unicode may require fonts -designed to support Unicode. -
- tileName -	string	void	const string &tileName_	Tile name
- totalColors -	size_t	void		Number of colors in the image
- type -	ImageType -	void	ImageType	Image type.
- verbose -	bool	void	bool verboseFlag_	Print detailed information about the image
- view -	string	void	const string &view_	FlashPix viewing parameters.
- virtualPixelMethod -	VirtualPixelMethod -	void	VirtualPixelMethod -virtualPixelMethod_	Image virtual pixel method.
- x11Display -	string (e.g. "hostname:0.0")	void	const string &display_	X11 display to display to, obtain fonts from, -or to capture image from
- xResolution -	double	void		x resolution of the image
- yResolution -	double	void		y resolution of the image

- -

Low-Level Image Pixel Access

- -Image pixels (of type Quantum ) -may be accessed directly via the Image Pixel Cache . The -image pixel cache is a rectangular window into the actual image pixels -(which may be in memory, memory-mapped from a disk file, or entirely on -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 -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 -class provides the more general form of the interface. -

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

In order to ensure that only the current generation of the image is -modified, the Image's modifyImage() method -should be invoked to reduce the reference count on the underlying image -to one. If this is not done, then it is possible for a previous -generation of the image to be modified due to the use of reference -counting when copying or constructing an Image.
-

Depending on the capabilities of the operating system, and the -relationship of the window to the image, the pixel cache may be a copy -of the pixels in the selected window, or it may be the actual image -pixels. In any case calling syncPixels() insures that the base -image is updated with the contents of the modified pixel cache. The -method readPixels() supports copying foreign pixel data -formats -into the pixel cache according to the QuantumTypes. The method writePixels() -supports copying the pixels in the cache to a foreign pixel -representation according to the format specified by QuantumTypes.

The pixel region is effectively a small image in which the pixels -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();
-// Set the image type to TrueColor DirectClass representation.
-image.type(TrueColorType);
-// Request pixel region with size 60x40, and top origin at 20x30 
-ssize_t columns = 60; 
-Quantum *pixel_cache = image.getPixels(20,30,columns,40); 
-// Set pixel at column 5, and row 10 in the pixel cache to red. 
-ssize_t column = 5; 
-ssize_t row = 10; 
-Quantum *pixel = pixel_cache+row*columns+column; 
-*pixel = Color("red"); 
-// Save changes to underlying image .
-image.syncPixels();
-  // Save updated image to file.
-image.write("horse.png");
-

The image cache supports the following methods:
-

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Image Cache Methods
- Method -	- Returns -	- Signature -	- Description -
- getConstPixels -	const Quantum -*	const ssize_t x_, const ssize_t y_, const size_t -columns_, const size_t rows_	Transfers pixels from the image to the pixel -cache as defined by the specified rectangular region. The returned pointer remains valid until the next getPixel, -getConstPixels, or setPixels call and should never be deallocated by -the -user.
- getConstIndexes -	const IndexPacket*	void	Returns a pointer to the Image pixel indexes -corresponding to a previous getPixel, -getConstPixels, or setPixels call. The -returned pointer remains valid until the next getPixel, getConstPixels, -or setPixels call and should never be deallocated by the user. Only valid for PseudoClass images or CMYKA images. The -pixel indexes represent an array of type IndexPacket, with each entry -corresponding to an x,y pixel position. For PseudoClass images, the -entry's value is the offset into the colormap (see colorMap -) for that pixel. For CMYKA images, the indexes are used to contain the -alpha channel.
- getIndexes -	IndexPacket*	void	Returns a pointer to the Image pixel indexes -corresponding to the pixel region requested by the last getConstPixels , getPixels -, or setPixels call. The -returned pointer remains valid until the next getPixel, getConstPixels, -or setPixels call and should never be deallocated by the user. Only valid for PseudoClass images -or -CMYKA images. The pixel indexes represent an array of type -IndexPacket, with each entry corresponding to a pixel x,y position. For -PseudoClass images, the entry's value is the offset into the colormap -(see colorMap ) for that pixel. For -CMYKA -images, the indexes are used to contain the alpha channel.
- getPixels -	Quantum *	const ssize_t x_, const ssize_t y_, const size_t -columns_, const size_t rows_	Transfers pixels from the image to the pixel -cache as defined by the specified rectangular region. Modified pixels -may be subsequently transferred back to the image via syncPixels. The returned pointer remains valid until the next getPixel, -getConstPixels, or setPixels call and should never be deallocated by -the -user.
- setPixels -	Quantum *	const ssize_t x_, const ssize_t y_, const size_t -columns_, const size_t rows_	Allocates a pixel cache region to store image -pixels as defined by the region rectangle. This area is -subsequently transferred from the pixel cache to the image via -syncPixels. The returned pointer remains -valid until the next getPixel, getConstPixels, or setPixels call and -should never be deallocated by the user.
- syncPixels -	void	void	Transfers the image cache pixels to the image.
- readPixels -	void	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 -typically used to support image decoders. The region transferred -corresponds to the region set by a preceding setPixels call.
- writePixels -	void	QuantumTypes -quantum_, unsigned char *destination_	Transfers one or more pixel components from -the image pixel cache to a buffer or file. WritePixels is typically -used to support image encoders. The region transferred corresponds to -the region set by a preceding getPixels or getConstPixels call.

- - diff --git a/ImageMagick/Magick++/ImageDesign.html b/ImageMagick/Magick++/ImageDesign.html deleted file mode 100644 index 8473c92c8..000000000 --- a/ImageMagick/Magick++/ImageDesign.html +++ /dev/null @@ -1,17 +0,0 @@ - - - - - -Magick++ API: Design Principles - - - -

- -

Magick::Image Data Structures

-The class Magick::Image is a simple handle which points to a reference-counted image representation. This allows multiple Magick::Image instances to share the same image and attributes. At the point in time that the image data, or image attributes are modified and the current reference count is greater than one, the image data and attributes are copied to create a new image with a reference count of one and the reference count on the old image is decremented. If the reference count on the old image becomes zero, then the associated reference and data are deleted. This strategy represents a simple (but effective) form of garbage collection -

- - diff --git a/ImageMagick/Magick++/Install.html b/ImageMagick/Magick++/Install.html deleted file mode 100644 index 79ff2e727..000000000 --- a/ImageMagick/Magick++/Install.html +++ /dev/null @@ -1,268 +0,0 @@ - - - - - -Magick++ API: Install Magick++ - - - -

Installing Magick++

General

In order to compile Magick++ you must have access to a standard C++ implementation. The author uses gcc 3.4 (GNU C++) which is available under UNIX and under the Cygwin UNIX-emulation environment for Windows. Standards compliant commercial C++ compilers should also work fine. Most modern C++ compilers for Microsoft Windows or the Mac should work (project files are provided for Microsoft Visual C++ 8.0).

It was decided that Magick++ will be around for the long-haul, so its API definition depends on valuable C++ features which should be common in all current and future C++ compilers. The compiler must support the following C++ standard features:

-
templates
-
static constructors
-
C++-style casts (e.g. static_cast)
-
bool type
-
string class (<string>)
-
exceptions (<exception>)
-
namespaces
-
Standard Template Library (STL) (e.g. <list>, <vector>)

The author has personally verified that Magick++ compiles and runs using the following compiler/platform combinations:

-
-

Tested Configurations

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

- Operating System	- Architecture	- Compiler
- SunOS 5.6, 5.7, 5.8 ("Solaris 2.6, 7, & 8)	- SPARC	- GCC 3.0.4
- SunOS 5.7 ("Solaris 7")	- SPARC	- Sun Workshop 5.0 C++
- SunOS 5.8 ("Solaris 8")	- SPARC	- Sun WorkShop 6 update 2 C++ 5.3
- FreeBSD 4.0	- Intel Pentium II	- GCC 2.95
- Windows NT 4.0 SP6a	- Intel Pentium II	- Visual C++ 8.0 Standard Edition
- Windows XP	- Intel Pentium IV	- Visual C++ 8.0 Standard Edition Service Pack 5
- Windows '98 + Cygwin 1.3.10	- Intel Pentium III	- GCC 2.95.3-5
- Windows NT 4.0 SP6a	- Intel Pentium II	- GCC 2.95.3-5
- Windows XP + Cygwin 1.3.10	- Intel Pentium IV	- GCC 2.95.3-5

Users of Magick++ have reported that the following configurations work with Magick++:

-
-

Other Known Working Configurations

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

- Operating System	- Architecture	- Compiler	- Reported By
- Red Hat Linux 8.0	- i386 & alpha	- EGCS 1.1.2	- Dr. Alexander Zimmermann <Alexander.Zimmermann@fmi.uni-passau.de>
- Red Hat Linux 7.0	- i386	- GCC 2.95.2	- Dr. Alexander Zimmermann <Alexander.Zimmermann@fmi.uni-passau.de>
- Red Hat Linux 7.0	- i386	- GCC "2.96" snapshot	- ???
- Red Hat Linux 7.X	- i386 & alpha	- GCC 3.0	- Dr. Alexander Zimmermann <Alexander.Zimmermann@fmi.uni-passau.de>
- SGI IRIX 6.2, 6.5	- MIPS	- IRIX C++ 7.3.1.2m	- Albert Chin-A-Young <china@thewrittenword.com>
- SunOS 5.5.1	- SPARC	- Sun WorkShop CC 5.0	- Albert Chin-A-Young <china@thewrittenword.com>
- SunOS 5.6, 5.7, 5.8	- SPARC	- Sun Forte CC 5.3	- Albert Chin-A-Young <china@thewrittenword.com>
- HP-UX 11.00	- PA-RISC	- HP-UX aCC A.03.30	- Albert Chin-A-Young <china@thewrittenword.com>
- Mac OS 9	- PowerPC	- CodeWarrior Professional Release 6	- Leonard Rosenthol <leonardr@digapp.com>
- Mac OS X 10.1 "Darwin"	- PowerPC	- GCC 2.95.2 (apple gcc -926)	- Cristy

Please let me know if you have successfully built and executed Magick++ using a different configuration so that I can add to the table of verified configurations.

Unix/Linux

Building From Source

Magick++ is now built using the ImageMagick configure script and Makefiles. Please follow the installation instructions provided by its README.txt file. The following instructions pertain to the Magick++ specific configuration and build options.

To install ImageMagick plus Magick++ under Unix, installation should be similar to

./configure [ --prefix=/prefix ]
-make
-make install

The library is currently named similar to 'libMagick++.a' (and/or libMagick++.so.5.0.39) and is installed under prefix/lib while the headers are installed with Magick++.h being installed in prefix/include and the remaining headers in prefix/include/Magick++.

To influence the options the configure script chooses, you may specify 'make' option variables when running the configure script. For example, the command

./configure CXX=CC CXXFLAGS=-O2 LIBS=-lposix

-specifies additional options to the configure script. The following table shows the available options.

-
-

Environment Variables That Effect Configure

- --- - - - - - - - - - - - - - - - - -

- Make Option Variable	- Description
- CXX	- Name of C++ compiler (e.g. 'CC -Xa') to use compiler 'CC -Xa'
- CXXFLAGS	- Compiler flags (e.g. '-g -O2') to compile with
- CPPFLAGS	- Include paths (-I/somedir) to look for header files
- LDFLAGS	- Library paths (-L/somedir) to look for libraries. Systems that support the notion of a library run-path may additionally require -R/somedir or '-rpath /somedir' in order to find shared libraries at run time.
- LIBS	- Extra libraries (-lsomelib) required to link

Installing Linux RPMs

Linux RPMs of ImageMagick and Magick++ can be downloaded from ftp://ftp.imagemagick.org/pub/ImageMagick/linux/.

Windows '9X, NT, 2003, 2008, XP, & Windows 7

Visual C++

Windows NT through Windows Vista are supported by the ImageMagick source package for NT available in the 'win2k' subdirectory of the ImageMagick ftp site (and mirrors). The ImageMagick source package for NT provides sources to ImageMagick, Magick++, add-on libraries (e.g. JPEG), and a ready-made Visual C++ 8.0 build environment. Please read the configuration and build instructions in README.txt (under the heading "Windows Win2K/XP VISUAL C++ 8.0 COMPILATION") in order to build Magick++.

Cygwin & GCC

It is possible to build both ImageMagick and Magick++ under the Cygwin Unix-emulation environment for Windows NT. Obtain and install Cgywin from http://www.cygwin.com/ . An X11R6 environment for Cygwin is available from http://www.cygwin.com/xfree/ .To build using Cygwin and GCC, follow the instructions for building under Unix.

- - diff --git a/ImageMagick/Magick++/Montage.html b/ImageMagick/Magick++/Montage.html deleted file mode 100644 index 6a0c643e2..000000000 --- a/ImageMagick/Magick++/Montage.html +++ /dev/null @@ -1,332 +0,0 @@ - - - - - -Magick++ API: Montage - - - -

Magick::Montage Class

A montage is a single image which is composed of thumbnail images composed in a uniform grid. The size of the montage image is determined by the size of the individual thumbnails and the number of rows and columns in the grid.

The following illustration shows a montage consisting of three columns and two rows of thumbnails rendered on a gray background:

Montages may be either "plain" (undecorated thumbnails) or "framed" (decorated thumbnails). In order to more easily understand the options supplied to MontageImages(), montage options are supplied by two different classes: Magick::Montage and Magick::MontageFramed.

Plain Montages

Magick::Montage is the base class to provide montage options and provides methods to set all options required to render simple (unframed) montages. See Magick::MontageFramedif you would like to create a framed montage.

Unframed thumbnails consist of four components: the thumbnail image, the thumbnail border, an optional thumbnail shadow, and an optional thumbnail label area.

Montage Methods

- Method	- Return Type	- Signature(s)	- Description
- Montage		- void	- Default constructor
- backgroundColor	- void	- const Color &backgroundColor_	- Specifies the background color that thumbnails are imaged upon.
	- Color	- void
- compose	- void	- CompositeOperator compose_	- Specifies the image composition algorithm for thumbnails. This controls the algorithm by which the thumbnail image is placed on the background. Use of OverCompositeOp is recommended for use with images that have transparency. This option may have negative side-effects for images without transparency.
	- CompositeOperator	- void
- fileName	- void	- std::string fileName_	- Specifies the image filename to be used for the generated montage images. To handle the case were multiple montage images are generated, a printf-style format may be embedded within the filename. For example, a filename specification of image%02d.miff names the montage images as image00.miff, image01.miff, etc.
	- std::string	- void
- fill	- void	- const Color &pen_	- Specifies the fill color to use for the label text.
	- Color	- void
- font	- void	- std::string font_	- Specifies the thumbnail label font.
	- std::string	- void
- geometry	- void	- const Geometry &geometry_	- Specifies the size of the generated thumbnail.
	- Geometry	- void
- gravity	- void	- GravityType gravity_	- Specifies the thumbnail positioning within the specified geometry area. If the thumbnail is smaller in any dimension than the geometry, then it is placed according to this specification.
	- GravityType	- void
- label	- void	- std::string label_	- Specifies the format used for the image label. Special format characters may be embedded in the format string to include information about the image.
	- std::string	- void
- penColor	- void	- const Color &pen_	- Specifies the pen color to use for the label text (same as fill).
	- Color	- void
- pointSize	- void	- size_t pointSize_	- Specifies the thumbnail label font size.
	- size_t	- void
- shadow	- void	- bool shadow_	- Enable/disable drop-shadow on thumbnails.
	- bool	- void
- stroke	- void	- const Color &pen_	- Specifies the stroke color to use for the label text .
	- Color	- void
- texture	- void	- std::string texture_	- Specifies a texture image to use as montage background. The built-in textures "`granite:`" and "`plasma:`" are available. A texture is the same as a background image.
	- std::string	- void
- tile	- void	- const Geometry &tile_	- Specifies the maximum number of montage columns and rows in the montage. The montage is built by filling out all cells in a row before advancing to the next row. Once the montage has reached the maximum number of columns and rows, a new montage image is started.
	- Geometry	- void
- transparentColor	- void	- const Color &transparentColor_	- Specifies a montage color to set transparent. This option can be set the same as the background color in order for the thumbnails to appear without a background when rendered on an HTML page. For best effect, ensure that the transparent color selected does not occur in the rendered thumbnail colors.
	- Color	- void

Framed Montages

Magick::MontageFramed provides the means to specify montage options when it is desired to have decorative frames around the image thumbnails. MontageFramed inherits from Montage and therefore provides all the methods of Montage as well as those shown in the table "MontageFramed Methods".

Framed thumbnails consist of four components: the thumbnail image, the thumbnail frame, the thumbnail border, an optional thumbnail shadow, and an optional thumbnail label area.

MontageFramed Methods

- Method	- Return Type	- Signature(s)	- Description
- MontageFramed		- void	- Default constructor (enable frame via frameGeometry).
- borderColor	- void	- const Color &borderColor_	- Specifies the background color within the thumbnail frame.
- borderColor	- Color	- void
- borderWidth	- void	- size_t borderWidth_	- Specifies the border (in pixels) to place between a thumbnail and its surrounding frame. This option only takes effect if thumbnail frames are enabled (via frameGeometry) and the thumbnail geometry specification doesn't also specify the thumbnail border width.
- borderWidth	- size_t	- void
- frameGeometry	- void	- const Geometry &frame_	- Specifies the geometry specification for frame to place around thumbnail. If this parameter is not specified, then the montage is unframed.
- frameGeometry	- Geometry	- void
- matteColor	- void	- const Color &matteColor_	- Specifies the thumbnail frame color.
- matteColor	- Color	- void	- Specifies the thumbnail frame color.

- - diff --git a/ImageMagick/Magick++/PixelPacket.html b/ImageMagick/Magick++/PixelPacket.html deleted file mode 100644 index 78deee53d..000000000 --- a/ImageMagick/Magick++/PixelPacket.html +++ /dev/null @@ -1,111 +0,0 @@ - - - - - -Magick++ API: PixelPacket - - - -

PixelPacket Structure

The PixelPacket structure is used to represent pixels in ImageMagick. ImageMagick may be compiled to support 32 or 64 bit pixels. The size of PixelPacket is controlled by the value of the QuantumDepth define. The default is 64 bit pixels, which provide the best accuracy. If memory consumption must be minimized, or processing time must be minimized, then ImageMagick may be compiled with QuantumDepth=8. The following table shows the relationship between QuantumDepth, the type of Quantum, and the overall PixelPacket size.

-
-

Effect Of QuantumDepth Values

- - ---- - - - - - - - - - - -

- QuantumDepth	- Quantum Type	- PixelPacket Size
- 8	- unsigned char	- 32 bits
- 16	- unsigned short	- 64 bits

The members of the PixelPacket structure, and their interpretation, are shown in the following table:

-
-

PixelPacket Structure Members

- - ------ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

- Member	- Type	- Interpretation
- Member	- Type	- RGBColorspace	- RGBColorspace + matte	- CMYKColorspace
- red	- Quantum	- Red	- Red	- Cyan
- green	- Quantum	- Green	- Green	- Magenta
- blue	- Quantum	- Blue	- Blue	- Yellow
- opacity	- Quantum	- Ignored	- Opacity	- Ignored

- - diff --git a/ImageMagick/Magick++/Pixels.html b/ImageMagick/Magick++/Pixels.html deleted file mode 100644 index cca75136d..000000000 --- a/ImageMagick/Magick++/Pixels.html +++ /dev/null @@ -1,282 +0,0 @@ - - - - - -Magick++ API: Working with Pixels - - - -

Magick::Pixels

The Pixels class provides efficient access to raw image -pixels. Image pixels (of type Quantum) -may be accessed directly via the Image Pixel Cache. The image -pixel cache is a rectangular window (a view) into the actual image -pixels (which may be in memory, memory-mapped from a disk file, or -entirely on disk). Obtain existing image pixels via get(). -Create a new pixel region using set().

Depending on the capabilities of the operating system, and the -relationship of the window to the image, the pixel cache may be a copy -of the pixels in the selected window, or it may be the actual image -pixels. In any case calling sync() insures that the base image -is updated with the contents of the modified pixel cache. The method decode()supports -copying foreign pixel data formats into the pixel cache according to -the QuantumTypes. The method encode() supports copying -the pixels in the cache to a foreign pixel representation according to -the format specified by QuantumTypes.

Setting a view using the Pixels class does not cause the number of -references to the underlying image to be reduced to one. Therefore, in -order to ensure that only the current generation of the image is -modified, the Image's modifyImage() -method should be invoked to reduce the reference count on the underlying -image to one. If this is not done, then it is possible for a previous -generation of the image to be modified due to the use of reference -counting when copying or constructing an Image.

The Quantum* returned by the set and get -methods, and the void* returned by the indexes -method point to pixel data managed by the Pixels class. The Pixels -class is responsible for releasing resources associated with the pixel -view. This means that the pointer should never be passed to delete() or -free().

The pixel view is a small image in which -the pixels may be accessed, addressed, and updated, as shown in the -following example, which produces an image similar to the one on the -right (minus lines and text):

-#include <Magick++.h> -#include <iostream> - -using namespace std; -using namespace Magick; -int main(int argc,char **argv) -{ - InitializeMagick(*argv); - - // Create base image - Image image(Geometry(254,218), "white"); - - - // Set the image type to TrueColor DirectClass representation. - image.type(TrueColorType); - // Ensure that there is only one reference to underlying image - // If this is not done, then image pixels will not be modified. - image.modifyImage(); - - // Allocate pixel view - Pixels view(image); - - // Set all pixels in region anchored at 38x36, with size 160x230 to green. - size_t columns = 196; size_t rows = 162; - Color green("green"); - Quantum *pixels = view.get(38,36,columns,rows); - for ( ssize_t row = 0; row < rows ; ++row ) - for ( ssize_t column = 0; column < columns ; ++column ) - { - *pixels++=QuantumRange*green.quantumRed(); - *pixels++=QuantumRange*green.quantumGreen(); - *pixels++=QuantumRange*green.quantumBlue(); - } - - // Save changes to image. - view.sync(); - - // Set all pixels in region anchored at 86x72, with size 108x67 to yellow. - columns = 108; rows = 67; - Color yellow("yellow"); - pixels = view.get(86,72,columns,rows); - for ( ssize_t row = 0; row < rows ; ++row ) - for ( ssize_t column = 0; column < columns ; ++column ) - { - *pixels++=QuantumRange*yellow.quantumRed(); - *pixels++=QuantumRange*yellow.quantumGreen(); - *pixels++=QuantumRange*yellow.quantumBlue(); - } - view.sync(); - - // Set pixel at position 108,94 to red - Color red("red"); - pixels = view.get(108,94,1,1); - *pixels++=QuantumRange*red.quantumRed(); - *pixels++=QuantumRange*red.quantumGreen(); - *pixels++=QuantumRange*red.quantumBlue(); - - // Save changes to image. - view.sync(); - image.write( "logo.png" ); -} -

Pixels supports the following -methods:

Pixel Cache Methods

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

- Method -	- Returns -	- Signature -	- Description -
- get -	- Quantum* -	- const ssize_t x_, const ssize_t y_, const size_t -columns_, const size_t rows_ -	- Transfers read-write pixels from the image to -the pixel cache as defined by the specified rectangular region. - Modified pixels may be subsequently transferred back to the image - via sync. The value returned is intended for pixel access - only. It should never be deallocated. -
- getConst -	- const Quantum* -	- const ssize_t x_, const ssize_t y_, const size_t - columns_, const size_t rows_ -	- Transfers read-only pixels from the image to -the pixel cache as defined by the specified rectangular region. -
- set -	- Quantum* -	- const ssize_t x_, const ssize_t y_, const size_t - columns_, const size_t rows_ -	- Allocates a pixel cache region to store image - pixels as defined by the region rectangle.Â This area is - subsequently transferred from the pixel cache to the image via sync. -The value returned is intended for pixel access only. It should -never be deallocated. -
- sync -	- void -	- void -	- Transfers the image cache pixels to the image. -
- indexes -	- void* -	- void -	- Returns the PsuedoColor pixel indexes - corresponding to the pixel region defined by the last get - , getConst, or set - call. Only valid for PseudoColor and CMYKA images. The pixel - indexes (an array of type void, which is typedef Quantum, -which is itself typedef unsigned char, or unsigned short, -depending on the value of the QuantumDepth define) provide -the colormap index (see colorMap) for each pixel in the -image. For CMYKA images, the indexes represent the black -channel. The value returned is intended for pixel access only. It -should never be deallocated. -
- x -	- int -	- void -	- Left ordinate of view -
- y -	- int -	- void -	- Top ordinate of view -
- columns -	- size_t -	- void -	- Width of view -
- rows -	- size_t -	- void -	- Height of view -

- - diff --git a/ImageMagick/Magick++/Quantum.html b/ImageMagick/Magick++/Quantum.html deleted file mode 100644 index 7f6ffaedf..000000000 --- a/ImageMagick/Magick++/Quantum.html +++ /dev/null @@ -1,111 +0,0 @@ - - - - - -Magick++ API: Quantum - - - -

Quantum Structure

The Quantum structure is used to represent pixels in ImageMagick. ImageMagick may be compiled to support 32 or 64 bit pixels. The size of Quantum is controlled by the value of the QuantumDepth define. The default is 64 bit pixels, which provide the best accuracy. If memory consumption must be minimized, or processing time must be minimized, then ImageMagick may be compiled with QuantumDepth=8. The following table shows the relationship between QuantumDepth, the type of Quantum, and the overall Quantum size.

-
-

Effect Of QuantumDepth Values

- - ---- - - - - - - - - - - -

- QuantumDepth	- Quantum Type	- Quantum Size
- 8	- unsigned char	- 32 bits
- 16	- unsigned short	- 64 bits

The members of the Quantum structure, and their interpretation, are shown in the following table:

-
-

Quantum Pixel Layout

- - ------ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

- Member	- Type	- Interpretation
- Member	- Type	- RGBColorspace	- RGBColorspace + matte	- CMYKColorspace
- red	- Quantum	- Red	- Red	- Cyan
- green	- Quantum	- Green	- Green	- Magenta
- blue	- Quantum	- Blue	- Blue	- Yellow
- opacity	- Quantum	- Ignored	- Opacity	- Ignored

- - diff --git a/ImageMagick/Magick++/STL.html b/ImageMagick/Magick++/STL.html deleted file mode 100644 index 245ffa802..000000000 --- a/ImageMagick/Magick++/STL.html +++ /dev/null @@ -1,1908 +0,0 @@ - - - - - -Magick++ API: STL Templates - - - -

Magick++ STL Support

-Magick++ provides a set of Standard -Template Libary (STL ) -algorithms for operating across ranges of image frames in a container. -It also provides a set of STL unary function objects to apply an -operation on image frames in a container via an algorithm which uses -unary function objects. A good example of a standard algorithm which is -useful for processing containers of image frames is the STL for_each -algorithm which invokes a unary function object on a range of container -elements. -

Magick++ uses a limited set of template argument types. The current -template argument types are:

-Container -

A container having the properties of a Back -Insertion Sequence . Sequences support forward iterators and Back -Insertion Sequences support the additional abilty to append an element -via push_back(). Common compatable container types are the STL < vector > and <list > template -containers. This template argument is usually used to represent an -output container in which one or more image frames may be appended. -Containers like STL <vector -> which have a given default capacity may need to have their -capacity adjusted via reserve() to a larger capacity -in order to support the expected final size . Since Magick++ -images are very small, it is likely that the default capacity of STL < vector > is -sufficient for most situations.

- InputIterator -

An input iterator used to express a position in a -container. These template arguments are typically used to represent a -range of elements with first_ representing the first element to -be processed and last_ representing the element to stop at. When -processing the entire contents of a container, it is handy to know that -STL containers usually provide the begin() and end() methods to return -input interators which correspond with the first and last elements, -respectively.

The following is an example of how frames from a GIF animation "test_image_anim.gif" may be appended horizontally -with the resulting image written to the file appended_image.miff:

-#include <list> 
-#include <Magick++.h> 
-using namespace std; 
-using namespace Magick;
-
-int main(int /*argc*/,char **/*argv*/) 
-{ 
-   list<Image> imageList; 
-   readImages( &imageList, "test_image_anim.gif" );
-
-   Image appended; 
-   appendImages( &appended, imageList.begin(), imageList.end() ); 
-   appended.write( "appended_image.miff" ); 
-   return 0; 
-}
-

The available Magick++ specific STL algorithms for operating on -sequences of image frames are shown in the following table:
- -

**Magick++ STL Algorithms For Image Sequences**
- Algorithm -	- Signature -	- Description -
- animateImages -	InputIterator -first_, InputIterator -last_	Animate a sequence of image frames. Image -frames are displayed in succession, creating an animated effect. The -animation options are taken from the first image frame. This feature is -only supported under X11 at the moment.
- appendImages -	Image -*appendedImage_, InputIterator -first_, InputIterator -last_, bool stack_ = false	Append a sequence of image frames, writing -the result to appendedImage_. All the input image frames must -have the same width or height. Image frames of the same width are -stacked top-to-bottom. Image frames of the same height are stacked -left-to-right. If the stack_ parameter is false, rectangular -image frames are stacked left-to-right otherwise top-to-bottom.
- averageImages -	Image -*averagedImage_, InputIterator -first_, InputIterator -last_	Average a sequence of image frames, writing -the result to averagedImage_. All the input image frames must -be the same size in pixels.
- coalesceImages -	Container -*coalescedImages_, InputIterator -first_, InputIterator -last_ -	Create a coalesced image sequence obtained by -"playing" the image sequence (observing page offsets and disposal -methods) to create a new image sequence in which all frames are full -size and completely rendered. Note that if the original image sequence -relied on page offsets and disposal methods that the resulting sequence -will be larger (perhaps much larger) then the original. This is useful -for GIF animation sequences that have page offsets and disposal methods. -The resuting image sequence is returned via coalescedImages_.
- deconstructImages -	Container -*deconstructedImages_, InputIterator -first_, InputIterator -last_	Break down an image sequence into constituent -parts. This is useful for creating GIF or MNG animation sequences. -The input sequence is specified by first_ and last_, and -the deconstructed images are returned via deconstructedImages_.
- displayImages -	InputIterator -first_, InputIterator -last_	Display a sequence of image frames. Through -use of a pop-up menu, image frames may be selected in succession. This -feature is fully supported under X11 but may have only limited support -in other environments. - Caution: if -an image format is is not compatable with the display visual (e.g. JPEG -on a colormapped display) then the original image will be altered. Use a -copy of the original if this is a problem.
- flattenImages -	Image -*flattendImage_, InputIterator -first_, InputIterator -last_	Merge a sequence of image frames which -represent image layers into a single composited representation. The flattendImage_ -parameter points to an existing Image to update with the flattened -image. This function is useful for combining Photoshop layers into a -single image.
- forwardFourierTransformImage -	Container -*fourierImages_, const Image &image_	Implements the discrete Fourier transform (DFT) of the image as a magnitude / phase image pair via fourierImages_.
- forwardFourierTransformImage -	Container -*fourierImages_, const Image &image_, const bool magnitude_	Implements the discrete Fourier transform (DFT) of the image either as a magnitude / phase or real / imaginary image pair via fourierImages_.
- mapImages -	InputIterator -first_, InputIterator -last_, const Image & mapImage_, bool -dither_, bool measureError_ = false	Replace the colors of a sequence of images -with the closest color from a reference image. Set dither_ to true -to enable dithering. Set measureError_ to true in -order to evaluate quantization error.
- montageImages -	Container -*montageImages_, InputIterator -first_, InputIterator -last_, const Montage &montageOpts_	Create a composite image by combining several -separate image frames. Multiple frames may be generated in the output -container montageImages_ depending on the tile setting and the -number of image frames montaged. Montage options are provided via the -parameter montageOpts_ . Options set in the first image frame ( backgroundColor, borderColor , matteColor , penColor, font, -and fontPointsize ) are also used -as options by montageImages().
- morphImages -	Container -*morphedImages_, InputIterator -first_, InputIterator -last_, size_t frames_	Morph a seqence of image frames. This -algorithm expands the number of image frames (output to the -container morphedImages_) by adding the number of intervening -frames specified by frames_ such that the original frames morph -(blend) into each other when played as an animation.
- mosaicImages -	Image *mosaicImage_, InputIterator -first_, InputIterator -last_	Inlay a number of images to form a single -coherent picture. The mosicImage_ argument is updated with a -mosaic constructed from the image sequence represented by first_ -through last_ .
quantizeImages	InputIterator -first_, InputIterator -last_, bool measureError_ = false	Quantize colors in images using current -quantization settings. Set measureError_ to true in order -to measure quantization error.
- readImages -	Container -*sequence_, const std::string &imageSpec_	Read a sequence of image frames into existing -container (appending to container sequence_) with image names -specified in the UTF-8 string imageSpec_.
- readImages -	Container -*sequence_, const Blob &blob_	Read a sequence of image frames into existing -container (appending to container sequence_) from Blob -blob_.
- writeImages -	InputIterator -first_, InputIterator -last_, const std::string &imageSpec_, bool adjoin_ = true	Write images in container to file specified -by string imageSpec_. Set adjoin_ to false to write a -set of image frames via a wildcard imageSpec_ (e.g. -image%02d.miff). -The wildcard must be one of `%0Nd, %0No, or %0Nx`. - Caution: if -an image format is selected which is capable of supporting fewer colors -than the original image or quantization has been requested, the original -image will be quantized to fewer colors. Use a copy of the original if -this is a problem.
- writeImages -	InputIterator -first_, InputIterator -last_, Blob *blob_, bool adjoin_ = true	Write images in container to in-memory BLOB -specified by Blob blob_. Set adjoin_ to false to -write a set of image frames via a wildcard imageSpec_ (e.g. -image%02d.miff). - Caution: if an -image format is selected which is capable of supporting fewer colors -than the original image or quantization has been requested, the original -image will be quantized to fewer colors. Use a copy of the original if -this is a problem.

In addition, we support these yet to be documented methods: combineImages(), evaluateImages(), mergeImageLayers(), optimizeImageLayers(), optimizePlusImageLayers(), and separateImages().

-
-

- -

Magick++ Unary Function Objects

- -Magick++ unary function objects inherit from the STL unary_function -template class . The STL unary_function template class is of the form -

unary_function<Arg, Result>

-and expects that derived classes implement a method of the form: -

Result operator()( Arg argument_);

-which is invoked by algorithms using the function object. In the case -of unary function objects defined by Magick++, the invoked function -looks like: -

void operator()( Image &image_);

-with a typical implementation looking similar to: -

void operator()( Image &image_ ) 

-    { 

-      image_.contrast(
-_sharpen ); 

-    }

-where contrast is an Image method and _sharpen is an -argument stored within the function object by its contructor. Since -constructors may be polymorphic, a given function object may have -several constructors and selects the appropriate Image method based on -the arguments supplied. -

In essence, unary function objects (as provided by Magick++) simply -provide the means to construct an object which caches arguments for -later use by an algorithm designed for use with unary function objects. -There is a unary function object corresponding each algorithm provided -by the Image class and there is a contructor -available compatable with each synonymous method in the Image class.

The unary function objects that Magick++ provides to support -manipulating images are shown in the following table:
- -

**Magick++ Unary Function Objects For Image Manipulation**
Function Object	Constructor Signatures(s)	Description
- adaptiveThresholdImage - -	size_t width, size_t -height, unsigned offset = 0 -	Apply adaptive thresholding to -the image. Adaptive thresholding is useful if the ideal threshold level -is not known in advance, or if the illumination gradient is not constant -across the image. Adaptive thresholding works by evaulating the mean -(average) of a pixel region (size specified by width and height) -and using the mean as the thresholding value. In order to remove -residual noise from the background, the threshold may be adjusted by -subtracting a constant offset (default zero) from the mean to -compute the threshold. -
- addNoiseImage -	NoiseType -noiseType_	Add noise to image with specified noise type.
affineTransformImage -	const DrawableAffine -&affine_ -	Transform image by -specified affine (or free transform) matrix. -
- annotateImage -	const std::string &text_, const Geometry &location_	Annotate with text using specified text, -bounding area, placement gravity, and rotation. If boundingArea_ -is invalid, then bounding area is entire image.
	std::string text_, const Geometry &boundingArea_, GravityType gravity_	Annotate using specified text, bounding area, -and placement gravity. If boundingArea_ is invalid, then -bounding area is entire image.
	const std::string &text_, const Geometry &boundingArea_, GravityType gravity_, double -degrees_,	Annotate with text using specified text, -bounding area, placement gravity, and rotation. If boundingArea_ -is invalid, then bounding area is entire image.
	const std::string &text_, GravityType gravity_	Annotate with text (bounding area is entire -image) and placement gravity.
- blurImage -	const double radius_ = 1, const double sigma_ -= 0.5	Blur image. The radius_ parameter specifies -the radius of the Gaussian, in pixels, not counting the center -pixel. The sigma_ parameter specifies the standard deviation of -the Laplacian, in pixels.
- borderImage -	const Geometry -&geometry_ = "6x6+0+0"	Border image (add border to image). The -color of the border is specified by the borderColor attribute.
- charcoalImage -	const double radius_ = 1, const double sigma_ -= 0.5	Charcoal effect image (looks like charcoal -sketch). The radius_ parameter specifies the radius of the Gaussian, in -pixels, not counting the center pixel. The sigma_ parameter -specifies the standard deviation of the Laplacian, in pixels.
- chopImage -	const Geometry -&geometry_	Chop image (remove vertical or horizontal -subregion of image)
- colorizeImage -	const size_t opacityRed_, const -size_t opacityGreen_, const size_t opacityBlue_, const Color -&penColor_	Colorize image with pen color, using -specified percent opacity for red, green, and blue quantums.
- colorizeImage -	const size_t opacity_, const Color &penColor_	Colorize image with pen color, using -specified percent opacity.
- commentImage -	const std::string &comment_	Comment image (add comment string to -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.
- compositeImage -	const Image -&compositeImage_, ssize_t xOffset_, ssize_t yOffset_, CompositeOperator -compose_ = InCompositeOp	Compose an image onto another at -specified offset and using specified algorithm
- compositeImage -	const Image -&compositeImage_, const Geometry &offset_, CompositeOperator -compose_ = InCompositeOp
- condenseImage -	void	Condense image (Re-run-length encode image in -memory).
- contrastImage -	size_t sharpen_	Contrast image (enhance intensity differences -in image)
- cropImage -	const Geometry -&geometry_	Crop image (subregion of original image)
- cycleColormap- - Image -	int amount_	Cycle image colormap
- despeckleImage -	void	Despeckle image (reduce speckle noise)
- drawImage -	const Drawable -&drawable_	Draw shape or text on image.
- drawImage -	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 -drawing performance and allows batching draw objects together in a list -for repeated use.
- edgeImage -	size_t radius_ = 0.0	Edge image (hilight edges in image). -The radius is the radius of the pixel neighborhood.. Specify a radius -of zero for automatic radius selection.
- embossImage -	const double radius_ = 1, const double sigma_ -= 0.5	Emboss image (hilight edges with 3D effect). -The radius_ parameter specifies the radius of the Gaussian, in pixels, -not counting the center pixel. The sigma_ parameter specifies the -standard deviation of the Laplacian, in pixels.
- enhanceImage -	void	Enhance image (minimize noise)
- equalizeImage -	void	Equalize image (histogram equalization)
- flipImage -	void	Flip image (reflect each scanline in the -vertical direction)
- floodFill- - ColorImage -	ssize_t x_, ssize_t y_, const 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_
	ssize_t x_, ssize_t y_, const 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_
- floodFill- - TextureImage -	ssize_t x_, ssize_t y_, const Image &texture_	Flood-fill texture 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 Image &texture_
	ssize_t x_, ssize_t y_, const Image -&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 Color -&borderColor_
- flopImage -	void	Flop image (reflect each scanline in the -horizontal direction)
- frameImage -	const Geometry -&geometry_ = "25x25+6+6"	Add decorative frame around image
- frameImage -	size_t width_, size_t height_, -ssize_t x_, ssize_t y_, ssize_t innerBevel_ = 0, ssize_t outerBevel_ = 0	Add decorative frame around image
- gammaImage -	double gamma_	Gamma correct image (uniform red, green, and -blue correction).
- gammaImage -	double gammaRed_, double gammaGreen_, double -gammaBlue_	Gamma correct red, green, and blue channels -of image.
- gaussianBlurImage -	double width_, double sigma_	Gaussian blur image. The number of neighbor -pixels to be included in the convolution mask is specified by -'width_'. For example, a width of one gives a (standard) 3x3 -convolution mask. The standard deviation of the gaussian bell curve is -specified by 'sigma_'.
- implodeImage -	double factor_	Implode image (special effect)
- inverseFourierTransformImage -	const Image -&phaseImage_, const bool magnitude_	implements the inverse discrete Fourier transform (DFT) of the image either as a magnitude / phase or real / imaginary image pair.
- labelImage -	const string &label_	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 special -format characters. If the first character of string is @, the image -label is read from a file titled by the remaining characters in the -string. When converting to Postscript, use this option to specify -a header string to print above the image.
levelImage -	const double black_point, -const double white_point, const double mid_point=1.0 -	Level image. Adjust the -levels of the image by scaling the colors falling between specified -white and black points to the full available quantum range. The -parameters provided represent the black, mid (gamma), and white -points. The black point specifies the darkest color in the image. -Colors darker than the black point are set to zero. Mid point (gamma) -specifies a gamma correction to apply to the image. White point -specifies the lightest color in the image. Colors brighter than -the white point are set to the maximum quantum value. The black and -white point have the valid range 0 to QuantumRange while mid (gamma) has a -useful range of 0 to ten.
levelChannelImage -	const Magick::ChannelType -channel, const double black_point, const double white_point, const -double mid_point=1.0 -	Level image channel. -Adjust the levels of the image channel by scaling the values falling -between specified white and black points to the full available quantum -range. The parameters provided represent the black, mid (gamma), and -white points. The black point specifies the darkest color in the image. -Colors darker than the black point are set to zero. Mid point (gamma) -specifies a gamma correction to apply to the image. White point -specifies the lightest color in the image. Colors brighter than the -white point are set to the maximum quantum value. The black and white -point have the valid range 0 to QuantumRange while mid (gamma) has a useful -range of 0 to ten.
- layerImage -	ChannelType -layer_	Extract layer from image. Use this option to -extract a particular layer from the image. MatteLayer, -for example, is useful for extracting the opacity values from an -image.
- magnifyImage -	void	Magnify image by integral size
- mapImage -	const Image -&mapImage_ , bool dither_ = false	Remap image colors with closest color from -reference image. Set dither_ to true in to apply Floyd/Steinberg -error diffusion to the image. By default, color reduction chooses an -optimal set of colors that best represent the original -image. Alternatively, you can choose a -particular set of colors from an image file -with this option.
- matteFloodfill- - Image -	const Color -&target_, unsigned int matte_, ssize_t x_, ssize_t y_, PaintMethod method_	Floodfill designated area with a matte value
medianFilterImage	const double radius_ = 0.0	Filter image by replacing each pixel -component with the median color in a circular neighborhood
- minifyImage -	void	Reduce image by integral size
- modulateImage -	double brightness_, double saturation_, -double hue_	Modulate percent hue, saturation, and -brightness of an image. Modulation of -saturation and brightness is as a ratio of the current value (100.0 for no -change). Modulation of hue is an absolute rotation of -180 degrees to -+180 degrees from the current position corresponding to an argument -range of 0 to 200.0 (100.0 for no change).
- negateImage -	bool grayscale_ = false	Negate colors in image. Replace every -pixel with its complementary color (white becomes black, yellow becomes -blue, etc.). Set grayscale to only negate grayscale values in -image.
- normalizeImage -	void	Normalize image (increase contrast by -normalizing the pixel values to span the full range of color values).
- oilPaintImage -	size_t radius_ = 3	Oilpaint image (image looks like oil painting)
- opacityImage -	size_t opacity_	Set or attenuate the opacity channel in the -image. If the image pixels are opaque then they are set to the specified -opacity value, otherwise they are blended with the supplied opacity -value. The value of opacity_ ranges from 0 (completely opaque) to QuantumRange. -The defines OpaqueOpacity and TransparentOpacity are -available to specify completely opaque or completely transparent, -respectively.
- opaqueImage -	const Color -&opaqueColor_, const Color &penColor_	Change color of pixels matching opaqueColor_ -to specified penColor_.
- quantizeImage -	bool measureError_ = false	Quantize image (reduce number of colors). Set -measureError_ to true in order to calculate error attributes.
- raiseImage -	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)
- reduceNoise- - Image -	void	Reduce noise in image using a -noise peak elimination filter.
- reduceNoise- - Image -	size_t order_
- rollImage -	int columns_, ssize_t rows_	Roll image (rolls image vertically and -horizontally) by specified number of columnms and rows)
- rotateImage -	double degrees_	Rotate image counter-clockwise by specified -number of degrees
- sampleImage -	const Geometry -&geometry_	Resize image by using pixel sampling algorithm
- scaleImage -	const Geometry -&geometry_	Resize image by using simple ratio algorithm
- segmentImage -	double clusterThreshold_ = 1.0, - double smoothingThreshold_ = 1.5	Segment (coalesce similar image components) -by analyzing the histograms of the color components and identifying -units that are homogeneous with the fuzzy c-means technique. Also uses quantizeColorSpace -and verbose image attributes. Specify clusterThreshold_ , -as the number of pixels each cluster must exceed -the cluster threshold to be considered valid. SmoothingThreshold_ -eliminates noise in the second derivative of the histogram. As the -value is increased, you can expect a smoother -second derivative. The default is 1.5.
- shadeImage -	double azimuth_ = 30, double elevation_ = 30, - bool colorShading_ = false	Shade image using distant light source. -Specify azimuth_ and elevation_ as the -position of the light source. By default, the shading -results as a grayscale image.. Set colorShading_ to true to -shade the red, green, and blue components of the image.
- sharpenImage -	const double radius_ = 1, const double sigma_ -= 0.5	Sharpen pixels in image. The radius_ -parameter specifies the radius of the Gaussian, in pixels, not counting -the center pixel. The sigma_ parameter specifies the standard -deviation of the Laplacian, in pixels.
- shaveImage -	const Geometry -&geometry_	Shave pixels from image edges.
- shearImage -	double xShearAngle_, double yShearAngle_	Shear image (create parallelogram by sliding -image by X or Y axis). Shearing slides one edge of an image along -the X or Y axis, creating a -parallelogram. An X direction shear slides an edge along the X -axis, while a Y direction shear slides an -edge along the Y axis. The amount of the shear is controlled by a -shear angle. For X direction shears, x degrees -is measured relative to the Y axis, and similarly, for Y direction -shears y degrees is measured relative to the X axis. Empty -triangles left over from shearing the image are filled -with the color defined as borderColor.
- solarizeImage -	double factor_	Solarize image (similar to effect seen when -exposing a photographic film to light during the development process)
- spreadImage -	size_t amount_ = 3	Spread pixels randomly within image by -specified amount
- steganoImage -	const Image -&watermark_	Add a digital watermark to the image (based -on second image)
- stereoImage -	const Image -&rightImage_	Create an image which appears in stereo when -viewed with red-blue glasses (Red image on left, blue on right)
- swirlImage -	double degrees_	Swirl image (image pixels are rotated by -degrees)
- textureImage -	const Image -&texture_	Layer a texture on image background
- thresholdImage -	double threshold_	Threshold image
- transformImage -	const Geometry -&imageGeometry_	Transform image based on image -and crop geometries. Crop geometry is optional.
- transformImage -	const Geometry -&imageGeometry_, const Geometry -&cropGeometry_
- transparentImage -	const Color -&color_	Add matte image to image, setting pixels -matching color to transparent.
- trimImage -	void	Trim edges that are the background color from -the image.
- waveImage -	double amplitude_ = 25.0, double wavelength_ -= 150.0	Alter an image along a sine wave.
- zoomImage -	const Geometry -&geometry_	Zoom image to specified size.

Function objects are available to set attributes on image frames -which are equivalent to methods in the Image object. These function -objects allow setting an option across a range of image frames using f-or_each().

The following code is an example of how the color 'red' may be set -to transparent in a GIF animation:

-list<image> images; 
-readImages( &images, "animation.gif" ); 
-for_each ( images.begin(), images.end(), transparentImage( "red" )  ); 
-writeImages( images.begin(), images.end(), "animation.gif" );
-

The available function objects for setting image attributes are
- -

Image Attributes
- Attribute -	- Type -	- Constructor Signature(s) -	- Description -
- adjoinImage -	bool	bool flag_	Join images into a single multi-image file.
- antiAliasImage -	bool	bool flag_	Control antialiasing of rendered Postscript -and Postscript or TrueType fonts. Enabled by default.
- animation- - DelayImage -	size_t (0 to 65535)	size_t delay_	Time in 1/100ths of a second (0 to 65535) -which must expire before displaying the next image in an animated -sequence. This option is useful for regulating the animation of a -sequence of GIF images within Netscape.
- animation- - IterationsImage -	size_t	size_t iterations_	Number of iterations to loop an animation -(e.g. Netscape loop extension) for.
- background- - ColorImage -	Color	const Color -&color_	Image background color
- background- - TextureImage -	std::string	const string &texture_	Image to use as background texture.
- borderColor- - Image -	Color	const Color -&color_	Image border color
- boxColorImage -	Color	const Color -&boxColor_	Base color that annotation text is rendered -on.
- chroma- - BluePrimaryImage -	double x & y	double x_, double y_	Chromaticity blue primary point (e.g. x=0.15, -y=0.06)
- chroma- - GreenPrimaryImage -	double x & y	double x_, double y_	Chromaticity green primary point (e.g. x=0.3, -y=0.6)
- chroma- - RedPrimaryImage -	double x & y	double x_, double y_	Chromaticity red primary point (e.g. x=0.64, -y=0.33)
- chroma- - WhitePointImage -	double x & y	double x_, double y_	Chromaticity white point (e.g. x=0.3127, -y=0.329)
- colorFuzzImage -	double	double fuzz_	Colors within this distance are considered -equal. A number of algorithms search for a target color. By -default the color must be exact. Use this option to match colors that -are close to the target color in RGB space.
- colorMapImage -	Color	size_t index_, const Color &color_	Color at color-pallet index.
colorSpaceImage	ColorspaceType	ColorspaceType -colorSpace_	The colorspace (e.g. CMYK) used to represent -the image pixel colors. Image pixels are always stored as RGB(A) except -for the case of CMY(K).
- composeImage -	CompositeOperator	CompositeOperator -compose_	Composition operator to be used when -composition is implicitly used (such as for image flattening).
- compressType- - Image -	CompressionType	CompressionType -compressType_	Image compresion type. The default is the -compression type of the specified image file.
- densityImage -	Geometry -(default 72x72)	const Geometry -&density_	Vertical and horizontal resolution in pixels -of the image. This option specifies an image density when decoding a -Postscript or Portable Document page. Often used with psPageSize.
- depthImage -	size_t (8 or 16)	size_t depth_	Image depth. Used to specify the bit depth -when reading or writing raw images or thwn the output format -supports multiple depths. Defaults to the quantum depth that -ImageMagick is compiled with.
- endianImage -	EndianType	EndianType -endian_	Specify (or obtain) endian option for formats -which support it.
- fileNameImage -	std::string	const std::string &fileName_	Image file name.
- fillColorImage -	Color	const Color &fillColor_	Color to use when filling drawn objects
- filterTypeImage -	FilterTypes	FilterTypes -filterType_	Filter to use when resizing image. The -reduction filter employed has a sigificant effect on the time required -to resize an image and the resulting quality. The default filter is Lanczos -which has been shown to produce good results when reducing images.
- fontImage -	std::string	const std::string &font_	Text rendering font. If the font is a fully -qualified X server font name, the font is obtained from an X -server. To use a TrueType font, precede the TrueType filename with an @. -Otherwise, specify a Postscript font name (e.g. -"helvetica").
- fontPointsize- - Image -	size_t	size_t pointSize_	Text rendering font point size
- gifDispose- - MethodImage -	size_t - { 0 = Disposal not specified, - 1 = Do not dispose of graphic, - 3 = Overwrite graphic with background color, - 4 = Overwrite graphic with previous graphic. }	size_t disposeMethod_	layer disposal method. This option is used to -control how successive frames are rendered (how the preceding frame is -disposed of) when creating a GIF animation.
- interlace- - TypeImage -	InterlaceType	InterlaceType -interlace_	The type of interlacing scheme (default NoInterlace -). This option is used to specify the type of interlacing -scheme for raw image formats such as RGB or YUV. NoInterlace -means do not interlace, LineInterlace uses scanline -interlacing, and PlaneInterlace uses plane interlacing. -PartitionInterlace is like PlaneInterlace except the -different planes are saved to individual files (e.g. -image.R, image.G, and image.B). Use LineInterlace or PlaneInterlace -to create an interlaced GIF or progressive JPEG image.
- isValidImage -	bool	bool isValid_	Set image validity. Valid images become empty -(inValid) if argument is false.
- labelImage -	std::string	const std::string &label_	Image label
- lineWidthImage -	double	double lineWidth_	Line width for drawing lines, circles, -ellipses, etc. See Drawable .
- magickImage -	std::string	const std::string &magick_	Get image format (e.g. "GIF")
- matteImage -	bool	bool matteFlag_	True if the image has transparency. If set -True, store matte channel if the image has one otherwise create -an opaque one.
- matteColorImage -	Color	const Color -&matteColor_	Image matte (frame) color
- monochrome- - Image -	bool	bool flag_	Transform the image to black and white
- pageImage -	Geometry	const Geometry &pageSize_	Preferred size and location of an image -canvas. - Use this option to specify the dimensions and -position of the Postscript page in dots per inch or a TEXT page in -pixels. This option is typically used in concert with density . - Page may also be used to position a GIF image -(such as for a scene in an animation) -
- penColorImage -	Color	const Color -&penColor_	Pen color to use when annotating on or -drawing on image.
- penTextureImage -	Image	const Image & penTexture_	Texture image to paint with (similar to -penColor).
- pixelColorImage -	Color	size_t x_, size_t y_, const Color &color_	Get/set pixel color at location x & y.
- psPageSizeImage -	Geometry	const Geometry &pageSize_	Postscript page size. Use this option -to specify the dimensions of the Postscript page in dots per inch -or a TEXT page in pixels. This option is typically used in concert with density.
- qualityImage -	size_t (0 to 100)	size_t quality_	JPEG/MIFF/PNG compression level (default 75).
- quantize- - ColorsImage -	size_t	size_t colors_	Preferred number of colors in the image. The -actual number of colors in the image may be less than your request, but -never more. Images with less unique colors than specified with this -option will have any duplicate or unused colors removed.
- quantize- - ColorSpaceImage -	ColorspaceType	ColorspaceType -colorSpace_	Colorspace to quantize colors in (default -RGB). Empirical evidence suggests that 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.
- quantize- - DitherImage -	bool	bool flag_	Apply Floyd/Steinberg error diffusion to the -image. The basic strategy of dithering is to trade intensity -resolution for spatial resolution by -averaging the intensities of several -neighboring pixels. Images which suffer from -severe contouring when reducing colors can be improved -with this option. The quantizeColors or monochrome option must be set -for this option to take effect.
- quantize- - TreeDepthImage -	size_t (0 to 8)	size_t treeDepth_	Depth of the quantization color -classification tree. Values of 0 or 1 allow selection of the optimal -tree depth for the color reduction algorithm. Values between 2 and 8 may -be used to manually adjust the tree depth.
- rendering- - IntentImage -	RenderingIntent	RenderingIntent -render_	The type of rendering intent
- resolution- - UnitsImage -	ResolutionType	ResolutionType -units_	Units of image resolution
- sceneImage -	size_t	size_t scene_	Image scene number
- sizeImage -	Geometry	const Geometry -&geometry_	Width and height of a raw image (an image -which does not support width and height information). Size may -also be used to affect the image size read from a multi-resolution -format (e.g. Photo CD, JBIG, or JPEG.
- stripImage -	void	strips an image of all profiles and comments.
- strokeColorImage -	Color	const Color -&strokeColor_	Color to use when drawing object outlines
- subImageImage -	size_t	size_t subImage_	Subimage of an image sequence
- subRangeImage -	size_t	size_t subRange_	Number of images relative to the base image
- tileNameImage -	std::string	const std::string &tileName_	Tile name
- typeImage -	ImageType	ImageType -type_	Image storage type.
- verboseImage -	bool	bool verboseFlag_	Print detailed information about the image
- viewImage -	std::string	const std::string &view_	FlashPix viewing parameters.
- x11DisplayImage -	std::string (e.g. "hostname:0.0")	const std::string &display_	X11 display to display to, obtain fonts from, -or to capture image from

-
-

- -

Query Image Format Support

- -

Magick++ provides the coderInfoList() -function to support obtaining information about the image formats -supported by ImageMagick. Support for image formats in ImageMagick -is provided by modules known as "coders". A user-provided container is -updated based on a boolean truth-table match. The truth-table supports -matching based on whether ImageMagick can read the format, write the -format, or supports multiple frames for the format. A wildcard specifier -is supported for any "don't care" field. The data obtained via -coderInfoList() may be useful for preparing GUI dialog boxes or for -deciding which output format to write based on support within the -ImageMagick build.

The definition of coderInfoList is:

-class CoderInfo 
-  { 
-  public:
-
-    enum MatchType { 
-      AnyMatch,  // match any coder 
-      TrueMatch, // match coder if true 
-      FalseMatch // match coder if false 
-    };
-
-    [ remaining CoderInfo methods ]
-
-   }
-
-  template <class Container > 
-  void coderInfoList( Container *container_, 
-                      CoderInfo::MatchType isReadable_   = CoderInfo::AnyMatch, 
-                      CoderInfo::MatchType isWritable_   = CoderInfo::AnyMatch, 
-                      CoderInfo::MatchType isMultiFrame_ = CoderInfo::AnyMatch 
-                      );
-

The following example shows how to retrieve a list of all of the -coders which support reading images and print the coder attributes (all -listed formats will be readable):

-  list<CoderInfo> coderList; 
-  coderInfoList( &coderList,           // Reference to output list 
-                 CoderInfo::TrueMatch, // Match readable formats 
-                 CoderInfo::AnyMatch,  // Don't care about writable formats 
-                 CoderInfo::AnyMatch); // Don't care about multi-frame support 
-  list<CoderInfo>::iterator entry = coderList.begin(); 
-  while( entry != coderList.end() ) 
-  { 
-    cout << entry->name() << ": (" << entry->description() << ") : "; 
-    cout << "Readable = "; 
-    if ( entry->isReadable() ) 
-      cout << "true"; 
-    else 
-      cout << "false"; 
-    cout << ", "; 
-    cout << "Writable = "; 
-    if ( entry->isWritable() ) 
-      cout << "true"; 
-    else 
-      cout << "false"; 
-    cout << ", "; 
-    cout << "Multiframe = "; 
-    if ( entry->isMultiframe() ) 
-      cout << "true"; 
-    else 
-      cout << "false"; 
-    cout << endl;
-    entry ++;
-   } 
-

- } -

Obtaining A Color Histogram

Magick++ provides the colorHistogram template function to -retrieve a color histogram from an image. A color histogram provides a -count of how many times each color occurs in the image. The histogram is -written into a user-provided container, which (for example) could be a <vector> or a <map>. When a -<map> is used, the Color -is used as the key so that quick lookups of usage counts for colors may -be performed. Writing into a <map> -may be slower than writing into a <vector> -since the <map> sorts the -entries (by color intensity) and checks for uniqueness. Each histogram -entry is contained in type std::pair<Magick::Color,unsigned -long> with the first -member of the pair being a Color, -and the second member of the pair being an 'unsigned long'. Use the <pair> "first" member to access the Color -and the "second" member to -access the number of times the color occurs in the image.

The template function declaration is as follows:
-

-template <class Container >
-void colorHistogram( Container *histogram_, const Image image)
-

The following examples illustrate using both a <map> and a -<vector> to retrieve the color histogram, and print out a -formatted summary.
-
-Using <map>:
-
-

-  Image image("image.miff");
-  map<Color,unsigned long> histogram;
-  colorHistogram( &histogram, image );
-  std::map<Color,unsigned long>::const_iterator p=histogram.begin();
-  while (p != histogram.end())
-    {
-      cout << setw(10) << (int)p->second << ": ("
-           << setw(quantum_width) << (int)p->first.redQuantum() << ","
-           << setw(quantum_width) << (int)p->first.greenQuantum() << ","
-           << setw(quantum_width) << (int)p->first.blueQuantum() << ")"
-           << endl;
-       p++;
-    }
-

-
-Using <vector>:
-
-

-  Image image("image.miff");
-  std::vector<std::pair<Color,unsigned long> > histogram;
-  colorHistogram( &histogram, image );
-  std::vector<std::pair<Color,unsigned long> >::const_iterator p=histogram.begin();
-  while (p != histogram.end())
-    {
-      cout << setw(10) << (int)p->second << ": ("
-           << setw(quantum_width) << (int)p->first.redQuantum() << ","
-           << setw(quantum_width) << (int)p->first.greenQuantum() << ","
-           << setw(quantum_width) << (int)p->first.blueQuantum() << ")"
-           << endl;
-      p++;
-    }
-

- - diff --git a/ImageMagick/Magick++/TypeMetric.html b/ImageMagick/Magick++/TypeMetric.html deleted file mode 100644 index 7a3e3c81c..000000000 --- a/ImageMagick/Magick++/TypeMetric.html +++ /dev/null @@ -1,91 +0,0 @@ - - - - - -Magick++ API: Type Metrics - - - -

Magick::TypeMetric

The TypeMetric class provides the means to pass data from the Image class's TypeMetric method to the user. It provides information regarding font metrics such as ascent, descent, text width, text height, and maximum horizontal advance. The units of these font metrics are in pixels, and that the metrics are dependent on the current Image font (default Ghostscript's "Helvetica"), pointsize (default 12 points), and x/y resolution (default 72 DPI) settings.

The pixel units may be converted to points (the standard resolution-independent measure used by the typesetting industry) via the following equation:

-size_points = (size_pixels * 72)/resolution
-

where resolution is in dots-per-inch (DPI). This means that at the default image resolution, there is one pixel per point.

Note that a font's pointsize is only a first-order approximation of the font height (ascender + descender) in points. The relationship between the specified pointsize and the rendered font height is determined by the font designer.

See FreeType Glyph Conventions for a detailed description of font metrics related issues.

The methods available in the TypeMetric class are shown in the following table:

TypeMetric Methods

- Method	- Returns	- Units	- Signature	- Description
- ascent	- double	- Pixels	- void	- Returns the distance in pixels from the text baseline to the highest/upper grid coordinate used to place an outline point. Always a positive value.
- descent	- double	- Pixels	- void	- Returns the the distance in pixels from the baseline to the lowest grid coordinate used to place an outline point. Always a negative value.
- textWidth	- double	- Pixels	- void	- Returns text width in pixels.
- textHeight	- double	- Pixels	- void	- Returns text height in pixels.
- maxHorizontalAdvance	- double	- Pixels	- void	- Returns the maximum horizontal advance (advance from the beginning of a character to the beginning of the next character) in pixels.

- - diff --git a/ImageMagick/MagickWand/index.html b/ImageMagick/MagickWand/index.html deleted file mode 100644 index 5c6ccb414..000000000 --- a/ImageMagick/MagickWand/index.html +++ /dev/null @@ -1,255 +0,0 @@ - - - - - - -MagickWand Examples in C - - - - - -

- - - - - - - - - - -
-
-

-
MagickWand Examples in C
- -
The programs on these pages show 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. The code is written for Windows and was - compiled using MSVC V7 but, with a little tweaking, it should - also run on Linux.
-
Some of the examples show a command line "program" and how to achieve the equivalent output using MagickWand. - By "equivalent" I mean that the program produces the - same image as the command line example - it won't necessarily be exactly how it is achieved by the convert program. - In some cases there is only one command line - example to replicate but in others there can be 3 or 4 commands which - build on each other to produce a final result. In most of these cases I - have created one C function which replicates all the commands but each - section of code will show how it relates to the original commands. -
-
- There is little or no error checking in the examples but - you should add your own where needed. For example, the MagickReadImage - function returns a true or false value depending upon whether the read succeeded and - you should check this using code similar to this:
-
-
if(MagickReadImage(mw,"logo_gel.png") == - MagickFalse) {
        // Handle - the error
}
-
You should note that there are a lot of - MagickWand functions which are declared as returning a boolean result - but which will - always return MagickTrue and are therefore not worth checking. - This is particularly true with the DrawingWand commands. - For example, even if DrawSetFont - doesn't find the font you specify, it will return MagickTrue because it will set - the font to your default system font.
- - - -
If you haven't used MagickWand - before, you should start with something easy such as this: -

    • logo_1.c     - A simple starter. Convert the builtin logo: image to JPG. -
- It is easy to see that to make this convert - one of your own input files to another format you just replace "logo:" - with your input filename and replace "logo.jpg" with whatever output filename you - wish.
-
The MagickReadImage function is very versatile. It will - accept a website URL which links to an image somewhere on the internet or - it can generate a plain coloured canvas using the "xc:" filename - convention. E.G. "xc:red" will create a red canvas and "xc:none" will - create a transparent canvas. If you use the "xc:" format you will usually - precede the read function with a call to MagickSetSize otherwise you will - get a 1x1 pixel image. It is worthwhile to read the "pseudo Image" and "Built-in Images" sections near the bottom of the - ImageMagick Formats page to see what other pseudo files are available.
-
- Just in case you are deciding whether to use MagickCore instead of MagickWand, first - look at the simple example I showed in the previous paragraph and then look at - the equivalent written for MagickCore: -

    • MagickCore.c     - The simple starter program written for MagickCore.
-
I think you'll - agree that even in this simple example, the MagickWand version is much easier to - read and write. -
- -
All of this code is provided AS IS with NO warranty or guarantee of any kind
-
Each image is shown on a gray background to show transparent images better
-
Here's an INDEX of the MagickWand functions used in each example
- - -
Resize an image to 50% using a Lanczos filter and save as high-quality JPG -
    • resize.c -
    • Image - - - -
Extend the canvas around an image. -
    • extent.c -
    • Image - -
Simple floodfill to change an image's white background to transparent. -
    • floodfill.c -
    • Image - -
Slightly more complex floodfill (similar to third example in Masking Simple Backgrounds) -
    • cyclops.c -
    • Image - -
Using a Clip Mask to Limit the Composed Area -
    • clipmask.c - -
Change *all* white pixels to be transparent - we also get the wizard's beard!. -
    • trans_paint.c -
    • Image - -
Draw shapes: circle, polygon, rounded rectangle, rotated and translated ellipse, line -
    • draw_shapes.c -
    • Image - -
Eight text effects in one function -
    • text_effects.c -
    • Shadow -
    • Pattern -
    • Arc -
    • Bevel -
    • Plain -
    • Barrel -
    • Polar -
    • Shepards - -
Fun with fontmetrics! -
    • fontmetrics.c -
    • Image - -
Create rounded rectangle mask similar to the ROUNDED BORDERS example. -
    • round_mask.c -
    • Image - -
Create a tileable image from an input image. -
    • make_tile.c -
    • Plasma -
    • Random - -
The - Better 3-D Logo Generation Example -
    • 3dlogo.c -
    • Shadow -
    • Background - -
The - "Gel" Effects Example -
    • gel.c -
    • Image - -
Add a reflection below an image - fade the reflection to transparent using CopyOpacity. -
    • reflect.c -
    • Image - -
Four examples of using MagickDistortImage to do affine transformations -
    • affine.c -
    • Image -
    • Image -
    • Image -
    • Image - -
Using PixelIterators to create a grayscale gradient -
    • grayscale.c -
    • Image - -
Using PixelIterators to read and create images and also do HSL/HSB colourspace conversion -
    • modulate.c -
    • Image -
    • Image - -
-
Convert a 2D image to pseudo-3D -
    • landscape_3d.c -
    • Image -
- -
Anthony's tilt-shift example -
    • tilt_shift.c -
    • Input Image -
    • Output Image -
- -
- -
Change the colour of one pixel in the logo: built-in image -
    • pixel_mod.c -
    • logo_pixel.gif -
- -
Adding a Static Background to a Cleared Frame Animation -
    • bunny.c -
    • Background Image -
    • Animation -
    • Output Image -
- -
-

- - -

If you have any comments, send them to:

or send me a private message on the ImageMagick Forum

- - - diff --git a/ImageMagick/index.html b/ImageMagick/index.html deleted file mode 100644 index 9a2a9970f..000000000 --- a/ImageMagick/index.html +++ /dev/null @@ -1,280 +0,0 @@ - - - - - - - - - - Convert, Edit, Or Compose Bitmap Images @ ImageMagick - - - - - - - - - - - - - - - - - - - - - - -

- -

- - -

Features and Capabilities â¢ News â¢ Community

- -

-Use ImageMagick^® to create, edit, compose, or convert bitmap images. It can read and write images in a variety of formats (over 200) including PNG, JPEG, JPEG-2000, GIF, TIFF, DPX, EXR, WebP, Postscript, PDF, and SVG. Use ImageMagick to resize, flip, mirror, rotate, distort, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and BÃ©zier curves.

- -

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

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

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

- -

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

- -

The current release is ImageMagick 7.0.7-18. 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.

- -

We continue to maintain the legacy release of ImageMagick, version 6, at https://legacy.imagemagick.org.

- -

Features and Capabilities

Here are just a few examples of what ImageMagick can do for you:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Animation	create a GIF animation sequence from a group of images.
Color management	accurate color management with color profiles or in lieu of-- built-in gamma compression or expansion as demanded by the colorspace.
Command-line processing	utilize ImageMagick from the command-line.
Complex text layout	bidirectional text support and shaping.
Composite	overlap one image over another.
Connected component labeling	uniquely label connected regions in an image.
Decorate	add a border or frame to an image.
Delineate image features	Canny edge detection, Hough lines.
Discrete Fourier transform	implements the forward and inverse DFT.
Distributed pixel cache	offload intermediate pixel storage to one or more remote servers.
Draw	add shapes or text to an image.
Encipher or decipher an image	convert ordinary images into unintelligible gibberish and back again.
Format conversion	convert an image from one format to another (e.g. PNG to JPEG).
Generalized pixel distortion	correct for, or induce image distortions including perspective.
Heterogeneous distributed processing	certain algorithms are OpenCL-enabled to take advantage of speed-ups offered by executing in concert across heterogeneous platforms consisting of CPUs, GPUs, and other processors.
High dynamic-range images	accurately represent the wide range of intensity levels found in real scenes ranging from the brightest direct sunlight to the deepest darkest shadows.
Image calculator	apply a mathematical expression to an image or image channels.
Image gradients	create a gradual blend of two colors whose shape is horizontal, vertical, circular, or elliptical.
Image identification	describe the format and attributes of an image.
ImageMagick on the iPhone	convert, edit, or compose images on your iOS device such as the iPhone or iPad.
Large image support	read, process, or write mega-, giga-, or tera-pixel image sizes.
Montage	juxtapose image thumbnails on an image canvas.
Morphology of shapes	extract features, describe shapes, and recognize patterns in images.
Motion picture support	read and write the common image formats used in digital film work.
Noise and color reduction	Kuwahara Filter, mean-shift.
Perceptual hash	map visually identical images to the same or similar hash-- useful in image retrieval, authentication, indexing, or copy detection as well as digital watermarking.
Special effects	blur, sharpen, threshold, or tint an image.
Text & comments	insert descriptive or artistic text in an image.
Threads of execution support	ImageMagick is thread safe and most internal algorithms execute in parallel to take advantage of speed-ups offered by multicore processor chips.
Transform	resize, rotate, deskew, crop, flip or trim an image.
Transparency	render portions of an image invisible.
Virtual pixel support	convenient access to pixels outside the image boundaries.

- -

Examples of ImageMagick Usage shows how to use ImageMagick from the command-line to accomplish any of these tasks and much more. Also, see Fred's ImageMagick Scripts: a plethora of command-line scripts that perform geometric transforms, blurs, sharpens, edging, noise removal, and color manipulations. With Magick.NET, use ImageMagick without having to install ImageMagick on your server or desktop.

- -

News

- -

Now that ImageMagick version 7 is released, we continue to maintain the legacy release of ImageMagick, version 6, at https://legacy.imagemagick.org. Learn how ImageMagick version 7 differs from previous versions with our porting guide.

- -

ImageMagick best practices strongly encourages you to configure a security policy that suits your local environment.

- -

As an analog to linear (RGB) and non-linear (sRGB) color colorspaces, as of ImageMagick 7.0.7-17, we introduce the LinearGray colorspace. Gray is non-linear grayscale and LinearGray is linear (e.g. -colorspace linear-gray).

- -

Want more performance from ImageMagick? Try these options:

- -

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.

- -

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.

- - - - - - - - \ No newline at end of file diff --git a/ImageMagick/script/index.html b/ImageMagick/script/index.html deleted file mode 100644 index 9a2a9970f..000000000 --- a/ImageMagick/script/index.html +++ /dev/null @@ -1,280 +0,0 @@ - - - - - - - - - - Convert, Edit, Or Compose Bitmap Images @ ImageMagick - - - - - - - - - - - - - - - - - - - - - - -

- -

- - -

Features and Capabilities â¢ News â¢ Community

- -

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

- -

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

- -

We continue to maintain the legacy release of ImageMagick, version 6, at https://legacy.imagemagick.org.

- -

Features and Capabilities

Here are just a few examples of what ImageMagick can do for you:

Animation	create a GIF animation sequence from a group of images.
Color management	accurate color management with color profiles or in lieu of-- built-in gamma compression or expansion as demanded by the colorspace.
Command-line processing	utilize ImageMagick from the command-line.
Complex text layout	bidirectional text support and shaping.
Composite	overlap one image over another.
Connected component labeling	uniquely label connected regions in an image.
Decorate	add a border or frame to an image.
Delineate image features	Canny edge detection, Hough lines.
Discrete Fourier transform	implements the forward and inverse DFT.
Distributed pixel cache	offload intermediate pixel storage to one or more remote servers.
Draw	add shapes or text to an image.
Encipher or decipher an image	convert ordinary images into unintelligible gibberish and back again.
Format conversion	convert an image from one format to another (e.g. PNG to JPEG).
Generalized pixel distortion	correct for, or induce image distortions including perspective.
Heterogeneous distributed processing	certain algorithms are OpenCL-enabled to take advantage of speed-ups offered by executing in concert across heterogeneous platforms consisting of CPUs, GPUs, and other processors.
High dynamic-range images	accurately represent the wide range of intensity levels found in real scenes ranging from the brightest direct sunlight to the deepest darkest shadows.
Image calculator	apply a mathematical expression to an image or image channels.
Image gradients	create a gradual blend of two colors whose shape is horizontal, vertical, circular, or elliptical.
Image identification	describe the format and attributes of an image.
ImageMagick on the iPhone	convert, edit, or compose images on your iOS device such as the iPhone or iPad.
Large image support	read, process, or write mega-, giga-, or tera-pixel image sizes.
Montage	juxtapose image thumbnails on an image canvas.
Morphology of shapes	extract features, describe shapes, and recognize patterns in images.
Motion picture support	read and write the common image formats used in digital film work.
Noise and color reduction	Kuwahara Filter, mean-shift.
Perceptual hash	map visually identical images to the same or similar hash-- useful in image retrieval, authentication, indexing, or copy detection as well as digital watermarking.
Special effects	blur, sharpen, threshold, or tint an image.
Text & comments	insert descriptive or artistic text in an image.
Threads of execution support	ImageMagick is thread safe and most internal algorithms execute in parallel to take advantage of speed-ups offered by multicore processor chips.
Transform	resize, rotate, deskew, crop, flip or trim an image.
Transparency	render portions of an image invisible.
Virtual pixel support	convenient access to pixels outside the image boundaries.

- -

News

- -

ImageMagick best practices strongly encourages you to configure a security policy that suits your local environment.

- -

Want more performance from ImageMagick? Try these options:

- -

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.

- -

Community

- - - - - - - - \ No newline at end of file diff --git a/MagickCore/draw.c b/MagickCore/draw.c index 1b1784e44..51d4b2670 100644 --- a/MagickCore/draw.c +++ b/MagickCore/draw.c @@ -1519,9 +1519,10 @@ static Image *DrawClippingMask(Image *image,const DrawInfo *draw_info, if (image->debug != MagickFalse) (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename); assert(draw_info != (const DrawInfo *) NULL); - clip_mask=CloneImage(image,image->columns,image->rows,MagickTrue,exception); - if (clip_mask == (Image *) NULL) - return((Image *) NULL); + clip_mask=AcquireImage((const ImageInfo *) NULL,exception); + status=SetImageExtent(clip_mask,image->columns,image->rows,exception); + if (status == MagickFalse) + return(DestroyImage(clip_mask)); (void) SetImageMask(clip_mask,WritePixelMask,(Image *) NULL,exception); (void) QueryColorCompliance("#0000",AllCompliance, &clip_mask->background_color,exception); @@ -1610,10 +1611,10 @@ static Image *DrawCompositeMask(Image *image,const DrawInfo *draw_info, if (image->debug != MagickFalse) (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename); assert(draw_info != (const DrawInfo *) NULL); - composite_mask=CloneImage(image,image->columns,image->rows,MagickTrue, - exception); - if (composite_mask == (Image *) NULL) - return((Image *) NULL); + composite_mask=AcquireImage((const ImageInfo *) NULL,exception); + status=SetImageExtent(composite_mask,image->columns,image->rows,exception); + if (status == MagickFalse) + return(DestroyImage(composite_mask)); (void) SetImageMask(composite_mask,CompositePixelMask,(Image *) NULL, exception); (void) QueryColorCompliance("#0000",AllCompliance,