<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=ibm437">
<TITLE>Magick::Drawable Class</TITLE>
<META NAME="GENERATOR" CONTENT="StarOffice 6.0 (Solaris Sparc)">
<META NAME="AUTHOR" CONTENT="Bob Friesenhahn">
<META NAME="CREATED" CONTENT="20020805;15043598">
<META NAME="CHANGEDBY" CONTENT="Bob Friesenhahn">
<META NAME="CHANGED" CONTENT="20021124;11445600">
<META NAME="DESCRIPTION" CONTENT="Documentation for Magick::Drawable class">
<STYLE>
<!--
TD P { color: #000000 }
TD P.western { font-size: 11pt }
H1 { color: #000000 }
P { color: #000000 }
H2 { color: #000000 }
H3 { color: #000000 }
TH P { color: #000000 }
TH P.western { font-size: 11pt }
A:link { color: #0000ee }
A:visited { color: #551a8b }
-->
</STYLE>
</HEAD>
<BODY LANG="en-US" TEXT="#000000" LINK="#0000ee" VLINK="#551a8b" BGCOLOR="#ffffff">
<H1 ALIGN=CENTER>Magick::Drawable</H1>
<P>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 <A HREF="Image.html#draw">draw</A>() method, or may be
drawn "all-at-once" by passing a list of Drawable objects
to the Image <A HREF="Image.html#draw">draw</A>() method. The
one-by-one approach is convenient for simple drawings, while the
list-based approach is appropriate for drawings which require more
sophistication.
</P>
<P>The following is an example using the Drawable subclasses with a
one-by-one approach to draw the following figure:
</P>
<P><FONT COLOR="#000000"><FONT COLOR="#000000"><IMG SRC="Drawable_example_1.png" NAME="Graphic1" ALIGN=BOTTOM WIDTH=300 HEIGHT=200 BORDER=3></FONT></FONT>
</P>
<P><TT><FONT COLOR="#000066">#include <string></FONT></TT>
<BR><TT><FONT COLOR="#000066">#include <iostream></FONT></TT>
<BR><TT><FONT COLOR="#000066">#include <Magick++.h></FONT></TT>
</P>
<P><TT><FONT COLOR="#000066">using namespace std;</FONT></TT> <BR><TT><FONT COLOR="#000066">using
namespace Magick;</FONT></TT>
</P>
<P><TT><FONT COLOR="#000066">int main(int /*argc*/,char **/*argv*/)</FONT></TT>
<BR><TT><FONT COLOR="#000066">{</FONT></TT> <BR><TT><FONT COLOR="#000066">
try {</FONT></TT> <BR><TT><FONT COLOR="#000066"> //
Create base image (white image of 300 by 200 pixels)</FONT></TT> <BR><TT><FONT COLOR="#000066">
Image image( Geometry(300,200), Color("white") );</FONT></TT>
</P>
<P><TT><FONT COLOR="#000066"> // Set draw options</FONT></TT>
<BR><TT><FONT COLOR="#000066">
image.strokeColor("red"); // Outline color</FONT></TT> <BR><TT><FONT COLOR="#000066">
image.fillColor("green"); // Fill color</FONT></TT> <BR><TT><FONT COLOR="#000066">
image.strokeWidth(5);</FONT></TT>
</P>
<P><TT><FONT COLOR="#000066"> // Draw a circle</FONT></TT>
<BR><TT><FONT COLOR="#000066"> image.draw(
DrawableCircle(100,100, 50,100) );</FONT></TT>
</P>
<P><TT><FONT COLOR="#000066"> // Draw a rectangle</FONT></TT>
<BR><TT><FONT COLOR="#000066"> image.draw(
DrawableRectangle(200,200, 270,170) );</FONT></TT>
</P>
<P><TT><FONT COLOR="#000066"> // Display the result</FONT></TT>
<BR><TT><FONT COLOR="#000066"> image.display( );</FONT></TT>
<BR><TT><FONT COLOR="#000066"> }</FONT></TT> <BR><TT><FONT COLOR="#000066">
catch( exception &error_ )</FONT></TT> <BR><TT><FONT COLOR="#000066">
{</FONT></TT> <BR><TT><FONT COLOR="#000066">
cout << "Caught exception: " << error_.what()
<< endl;</FONT></TT> <BR><TT><FONT COLOR="#000066">
return 1;</FONT></TT> <BR><TT><FONT COLOR="#000066">
}</FONT></TT>
</P>
<P><TT><FONT COLOR="#000066"> return 0;</FONT></TT> <BR><TT><FONT COLOR="#000066">}</FONT></TT>
</P>
<P><FONT COLOR="#000000">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 </FONT>list-based
approach
</P>
<P><TT><FONT COLOR="#000066">#include <string></FONT></TT>
<BR><TT><FONT COLOR="#000066">#include <iostream></FONT></TT>
<BR><TT><FONT COLOR="#000066">#include <list></FONT></TT>
<BR><TT><FONT COLOR="#000066">#include <Magick++.h></FONT></TT>
</P>
<P><TT><FONT COLOR="#000066">using namespace std;</FONT></TT> <BR><TT><FONT COLOR="#000066">using
namespace Magick;</FONT></TT>
</P>
<P><TT><FONT COLOR="#000066">int main(int /*argc*/,char **/*argv*/)</FONT></TT>
<BR><TT><FONT COLOR="#000066">{</FONT></TT> <BR><TT><FONT COLOR="#000066">
try {</FONT></TT> <BR><TT><FONT COLOR="#000066"> //
Create base image (white image of 300 by 200 pixels)</FONT></TT> <BR><TT><FONT COLOR="#000066">
Image image( Geometry(300,200), Color("white") );</FONT></TT>
</P>
<P><TT><FONT COLOR="#000066"> // Construct drawing
list</FONT></TT> <BR><TT><FONT COLOR="#000066">
std::list<Magick::Drawable> drawList;</FONT></TT>
</P>
<P><TT><FONT COLOR="#000066"> // Add some drawing
options to drawing list</FONT></TT> <BR><TT><FONT COLOR="#000066">
drawList.push_back(DrawableStrokeColor("red")); // Outline
color</FONT></TT> <BR><TT><FONT COLOR="#000066">
drawList.push_back(DrawableStrokeWidth(5)); // Stroke width</FONT></TT>
<BR><TT><FONT COLOR="#000066">
drawList.push_back(DrawableFillColor("green")); // Fill
color</FONT></TT>
</P>
<P><TT><FONT COLOR="#000066"> // Add a Circle to
drawing list</FONT></TT> <BR><TT><FONT COLOR="#000066">
drawList.push_back(DrawableCircle(100,100, 50,100));</FONT></TT>
</P>
<P><TT><FONT COLOR="#000066"> // Add a Rectangle to
drawing list</FONT></TT> <BR><TT><FONT COLOR="#000066">
drawList.push_back(DrawableRectangle(200,100, 270,170));</FONT></TT>
</P>
<P><TT><FONT COLOR="#000066"> // Draw everything
using completed drawing list</FONT></TT> <BR><TT><FONT COLOR="#000066">
image.draw(drawList);</FONT></TT>
</P>
<P><TT><FONT COLOR="#000066"> // Display the result</FONT></TT>
<BR><TT><FONT COLOR="#000066"> image.display( );</FONT></TT>
<BR><TT><FONT COLOR="#000066"> }</FONT></TT> <BR><TT><FONT COLOR="#000066">
catch( exception &error_ )</FONT></TT> <BR><TT><FONT COLOR="#000066">
{</FONT></TT> <BR><TT><FONT COLOR="#000066">
cout << "Caught exception: " << error_.what()
<< endl;</FONT></TT> <BR><TT><FONT COLOR="#000066">
return 1;</FONT></TT> <BR><TT><FONT COLOR="#000066">
}</FONT></TT>
</P>
<P><TT><FONT COLOR="#000066"> return 0;</FONT></TT> <BR><TT><FONT COLOR="#000066">}</FONT></TT>
</P>
<P STYLE="margin-bottom: 0in"><FONT COLOR="#000000">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:</FONT>
</P>
<P ALIGN=CENTER STYLE="margin-bottom: 0in"><B>Coordinate Structure
Methods</B></P>
<TABLE WIDTH=100% BORDER=1 CELLPADDING=2 CELLSPACING=2>
<TR>
<TH>
<P CLASS="western">Method/Member</P>
</TH>
<TH>
<P CLASS="western">Signature</P>
</TH>
<TH>
<P CLASS="western">Description</P>
</TH>
</TR>
<TR>
<TD ROWSPAN=2>
<P CLASS="western" ALIGN=CENTER>Coordinate</P>
</TD>
<TD>
<P CLASS="western">void</P>
</TD>
<TD>
<P CLASS="western">Default Constructor</P>
</TD>
</TR>
<TR>
<TD>
<P CLASS="western">double x_, double y_</P>
</TD>
<TD>
<P CLASS="western">Constructor, setting <I>first</I> & <I>second</I></P>
</TD>
</TR>
<TR>
<TD>
<P CLASS="western" ALIGN=CENTER>x</P>
</TD>
<TD>
<P CLASS="western">double x_</P>
</TD>
<TD>
<P CLASS="western">x coordinate member</P>
</TD>
</TR>
<TR>
<TD>
<P CLASS="western" ALIGN=CENTER>y</P>
</TD>
<TD>
<P CLASS="western">double y_</P>
</TD>
<TD>
<P CLASS="western">y coordinate member</P>
</TD>
</TR>
</TABLE>
<P STYLE="margin-bottom: 0in"><FONT COLOR="#000000">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.</FONT>
</P>
<P ALIGN=CENTER STYLE="margin-bottom: 0in"><B>Drawable Classes</B></P>
<TABLE WIDTH=100% BORDER=1 CELLPADDING=2 CELLSPACING=3>
<COL WIDTH=68*>
<COL WIDTH=55*>
<COL WIDTH=133*>
<TR>
<TH WIDTH=27%>
<P CLASS="western">Sub-Class</P>
</TH>
<TH WIDTH=21%>
<P CLASS="western">Constructor Signature</P>
</TH>
<TH WIDTH=52%>
<P CLASS="western">Description</P>
</TH>
</TR>
<TR>
<TD ROWSPAN=2 WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableAffine</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">double sx_, double sy_, double rx_, double ry_,
double tx_, double ty_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">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.</P>
</TD>
</TR>
<TR>
<TD WIDTH=21%>
<P CLASS="western">void</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">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.</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableAngle</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">double angle_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">Set drawing angle</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableArc</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">double startX_, double startY_, double endX_,
double endY_, double startDegrees, double endDegrees_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">Draw an arc using the <I>stroke</I> color and
based on the circle starting at coordinates <I>startX_</I>,<I>startY_,</I>
and ending with coordinates <I>endX_,</I>endY_, and bounded by the
rotational arc <I>startDegrees_,endDegrees_</I></P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableBezier</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">const std::list<Magick::Coordinate>
&coordinates_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">Draw a bezier curve using the <I>stroke</I>
color and based on the coordinates specified by the <I>coordinates_
</I>list.</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableClipPath</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">const std::string &id_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">Select a drawing clip path matching <EM>id_.</EM></P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableCircle</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">double originX_, double originY_, double
perimX_, double perimY_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">Draw a circle using the <I>stroke</I> color and
thickness using specified origin and perimeter coordinates. If a
<I>fill</I> color is specified, then the object is filled.</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableColor</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western"><FONT SIZE=2>double x_, double y_, <A HREF="Enumerations.html#PaintMethod">PaintMethod</A>
paintMethod_</FONT></P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">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.</P>
</TD>
</TR>
<TR>
<TD ROWSPAN=6 WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableCompositeImage</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">double x_, double y_, const std::string
&filename_</P>
</TD>
<TD ROWSPAN=2 WIDTH=52%>
<P CLASS="western">Composite current image with contents of
specified image, at specified coordinates. If the <I>matte</I>
attribute is set to <I>true</I>, 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.</P>
</TD>
</TR>
<TR>
<TD WIDTH=21%>
<P CLASS="western">double x_, double y_, const Image &image_</P>
</TD>
</TR>
<TR>
<TD WIDTH=21%>
<P CLASS="western">double x_, double y_, double width_, double
height_, const std::string &filename_</P>
</TD>
<TD ROWSPAN=2 WIDTH=52%>
<P CLASS="western">Composite current image with contents of
specified image, rendered with specified width and height, at
specified coordinates. If the <I>matte</I> attribute is set to
<I>true</I>, 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 <I>width</I> or <I>height</I> is
zero, then the image is composited at its natural size, without
enlargement or reduction.</P>
</TD>
</TR>
<TR>
<TD WIDTH=21%>
<P CLASS="western">double x_, double y_, double width_, double
height_, const Image &image_</P>
</TD>
</TR>
<TR>
<TD WIDTH=21%>
<P CLASS="western"><FONT SIZE=2>double x_, double y_, double
width_, double height_, const std::string &filename_,
<A HREF="Enumerations.html#CompositeOperator">CompositeOperator</A>
composition_</FONT></P>
</TD>
<TD ROWSPAN=2 WIDTH=52%>
<P CLASS="western">Composite current image with contents of
specified image, rendered with specified width and height, using
specified composition algorithm, at specified coordinates. If the
<I>matte</I> attribute is set to <I>true</I>, 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
<I>width</I> or <I>height</I> is zero, then the image is
composited at its natural size, without enlargement or reduction.</P>
</TD>
</TR>
<TR>
<TD WIDTH=21%>
<P CLASS="western"><FONT SIZE=2>double x_, double y_, double
width_, double height_, const Image &image_, <A HREF="Enumerations.html#CompositeOperator">CompositeOperator</A>
composition_</FONT></P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableDashArray</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">const double* dasharray_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">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.</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableDashOffset</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">double offset_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western"><FONT SIZE=2 STYLE="font-size: 11pt">Specify
the distance into the dash pattern to start the dash. See
documentation on SVG's </FONT><A HREF="http://www.w3.org/TR/SVG/painting.html#StrokeDashoffsetProperty"><FONT SIZE=2 STYLE="font-size: 11pt">stroke-dashoffset</FONT></A><FONT SIZE=2 STYLE="font-size: 11pt">
property for usage details.</FONT></P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableEllipse</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">double originX_, double originY_, double
radiusX_, double radiusY_, double arcStart_, double arcEnd_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">Draw an ellipse using the <I>stroke</I> color
and thickness, specified origin, x & y radius, as well as
specified start and end of arc in degrees. If a <I>fill</I> color
is specified, then the object is filled.</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableFillColor</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western"><FONT SIZE=2>const <A HREF="Color.html">Color</A>
&color_</FONT></P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">Specify drawing object fill color.</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableFillRule</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western"><FONT SIZE=2><A HREF="Enumerations.html#FillRule">FillRule</A>
fillRule_</FONT></P>
</TD>
<TD WIDTH=52%>
<P CLASS="western"><FONT SIZE=2 STYLE="font-size: 11pt">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
</FONT><A HREF="http://www.w3.org/TR/SVG/painting.html#FillRuleProperty"><FONT SIZE=2 STYLE="font-size: 11pt">fill-rule</FONT></A><FONT SIZE=2 STYLE="font-size: 11pt">
property for usage details.</FONT></P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableFillOpacity</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">double opacity_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">Specify opacity to use when drawing using fill
color.</P>
</TD>
</TR>
<TR>
<TD ROWSPAN=2 WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableFont</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">const std::string &font_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">Specify font name to use when drawing text.</P>
</TD>
</TR>
<TR>
<TD WIDTH=21%>
<P CLASS="western"><FONT SIZE=2>const std::string &family_,</FONT>
<BR><FONT SIZE=2><A HREF="Enumerations.html#StyleType">StyleType</A>
style_,</FONT> <BR><FONT SIZE=2>unsigned long weight_,</FONT>
<BR><FONT SIZE=2><A HREF="Enumerations.html#StretchType">StretchType</A>
stretch_</FONT></P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">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.</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableGravity</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western"><FONT SIZE=2><A HREF="Enumerations.html#GravityType">GravityType</A>
gravity_</FONT></P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">Specify text positioning gravity.</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableLine</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">double startX_, double startY_, double endX_,
double endY_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">Draw a line using <I>stroke</I> color and
thickness using starting and ending coordinates</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableMatte</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western"><FONT SIZE=2>double x_, double y_, <A HREF="Enumerations.html#PaintMethod">PaintMethod</A>
paintMethod_</FONT></P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">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.</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableMiterLimit</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">unsigned int miterLimit_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">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.</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawablePath</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">const std::list<Magick::VPath> &path_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">Draw on image using vector path.</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawablePoint</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">double x_, double y_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">Draw a point using <I>stroke</I> color and
thickness at coordinate</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawablePointSize</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">double pointSize_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">Set font point size.</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawablePolygon</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">const std::list<Magick::Coordinate>
&coordinates_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">Draw an arbitrary polygon using <I>stroke</I>
color and thickness consisting of three or more coordinates
contained in an STL list. If a <I>fill</I> color is specified,
then the object is filled.</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawablePolyline</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">const std::list<Magick::Coordinate>
&coordinates_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">Draw an arbitrary polyline using <I>stroke</I>
color and thickness consisting of three or more coordinates
contained in an STL list. If a <I>fill</I> color is specified,
then the object is filled.</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawablePopClipPath</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">void</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">Pop (terminate) clip path definition started by
DrawablePushClipPath.</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawablePopGraphicContext</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">void</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western"><FONT SIZE=2 STYLE="font-size: 11pt">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 </FONT><A HREF="#DrawablePushGraphicContext"><I><FONT SIZE=2 STYLE="font-size: 11pt">DrawablePushGraphicContext</FONT></I></A><FONT SIZE=2 STYLE="font-size: 11pt">
operation.</FONT></P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawablePushClipPath</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">const std::string &id_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">Push (create) clip path definition with id_.
Clip patch definition consists of subsequent drawing commands,
terminated by DrawablePopClipPath.</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawablePushGraphicContext</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">void</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western"><FONT SIZE=2 STYLE="font-size: 11pt">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
</FONT><A HREF="#DrawablePopGraphicContext"><I><FONT SIZE=2 STYLE="font-size: 11pt">DrawablePopGraphicContext</FONT></I></A><FONT SIZE=2 STYLE="font-size: 11pt">
is used to pop the current graphic context, the options in effect
during the last <I>DrawablePushGraphicContext</I> operation are
restored.</FONT></P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawablePushPattern</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">std::string &id_, long x_, long y_, long
width_, long height_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western"><FONT SIZE=2 STYLE="font-size: 11pt">Start a
pattern definition with arbitrary pattern name specified by <I>id_</I>,
pattern offset specified by <I>x_</I> and <I>y_</I>, and pattern
size specified by <I>width_</I> and <I>height_</I>. The pattern is
defined within the coordinate system defined by the specified
offset and size. Arbitrary drawing objects (including
</FONT><A HREF="#DrawableCompositeImage"><FONT SIZE=2 STYLE="font-size: 11pt">DrawableCompositeImage</FONT></A><FONT SIZE=2 STYLE="font-size: 11pt">)
may be specified between </FONT><A HREF="#DrawablePushPattern"><FONT SIZE=2 STYLE="font-size: 11pt">DrawablePushPattern</FONT></A><FONT SIZE=2 STYLE="font-size: 11pt">
and </FONT><A HREF="#DrawablePopPattern"><FONT SIZE=2 STYLE="font-size: 11pt">DrawablePopPattern</FONT></A><FONT SIZE=2 STYLE="font-size: 11pt">
in order to draw the pattern. Normally the pair
</FONT><A HREF="#DrawablePushGraphicContext"><FONT SIZE=2 STYLE="font-size: 11pt">DrawablePushGraphicContext</FONT></A><FONT SIZE=2 STYLE="font-size: 11pt">
& </FONT><A HREF="#DrawablePopGraphicContext"><FONT SIZE=2 STYLE="font-size: 11pt">DrawablePopGraphicContext</FONT></A><FONT SIZE=2 STYLE="font-size: 11pt">
are used to enclose a pattern definition. Pattern definitions are
terminated by a </FONT><A HREF="#DrawablePopPattern"><FONT SIZE=2 STYLE="font-size: 11pt">DrawablePopPattern</FONT></A><FONT SIZE=2 STYLE="font-size: 11pt">
object.</FONT></P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawablePopPattern</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">void</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western"><FONT SIZE=2 STYLE="font-size: 11pt">Terminate
a pattern definition started via </FONT><A HREF="#DrawablePushPattern"><FONT SIZE=2 STYLE="font-size: 11pt">DrawablePushPattern</FONT></A><FONT SIZE=2 STYLE="font-size: 11pt">.</FONT></P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableRectangle</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">double upperLeftX_, double upperLeftY_, double
lowerRightX_, double lowerRightY</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">Draw a rectangle using <I>stroke</I> color and
thickness from upper-left coordinates to lower-right coordinates.
If a <I>fill</I> color is specified, then the object is filled.</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableRotation</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">double angle_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">Set rotation to use when drawing (coordinate
transformation).</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableRoundRectangle</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">double centerX_, double centerY_, double
width_, double hight_, double cornerWidth_, double cornerHeight_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">Draw a rounded rectangle using <I>stroke</I>
color and thickness, with specified center coordinate, specified
width and height, and specified corner width and height. If
a <I>fill</I> color is specified, then the object is filled.</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableScaling</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">double x_, double y_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">Apply scaling in x and y direction while
drawing objects (coordinate transformation).</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableSkewX</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">double angle_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">Apply Skew in X direction (coordinate
transformation)</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableSkewY</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">double angle_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">Apply Skew in Y direction</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableStrokeAntialias</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">bool flag_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">Antialias while drawing lines or object
outlines.</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableStrokeColor</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western"><FONT SIZE=2>const <A HREF="Color.html">Color</A>
&color_</FONT></P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">Set color to use when drawing lines or object
outlines.</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableStrokeLineCap</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western"><FONT SIZE=2><A HREF="Enumerations.html#LineCap">LineCap</A>
linecap_</FONT></P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">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.</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableStrokeLineJoin</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western"><FONT SIZE=2><A HREF="Enumerations.html#LineJoin">LineJoin</A>
linejoin_</FONT></P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">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.</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableStrokeOpacity</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">double opacity_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">Opacity to use when drawing lines or object
outlines.</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableStrokeWidth</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">double width_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">Set width to use when drawing lines or object
outlines.</P>
</TD>
</TR>
<TR>
<TD ROWSPAN=2 WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableText</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">double x_, double y_, std::string text_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western"><FONT SIZE=2 STYLE="font-size: 11pt">Annotate
image with text using <I>stroke</I> color, font, font pointsize,
and <I>box</I> color (text background color), at specified
coordinates. If text contains </FONT><A HREF="FormatCharacters.html"><FONT SIZE=2 STYLE="font-size: 11pt">special
format characters</FONT></A><FONT SIZE=2 STYLE="font-size: 11pt">
the image filename, type, width, height, or other image attributes
may be incorporated in the text (see label()).</FONT></P>
</TD>
</TR>
<TR>
<TD WIDTH=21%>
<P CLASS="western">const double x_, const double y_, const
std::string &text_, const std::string &encoding_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western"><FONT SIZE=2 STYLE="font-size: 11pt">Annotate
image with text represented with text encoding, using current
<I>stroke</I> color, font, font pointsize, and <I>box</I> color
(text background color), at specified coordinates. If text
contains </FONT><A HREF="FormatCharacters.html"><FONT SIZE=2 STYLE="font-size: 11pt">special
format characters</FONT></A><FONT SIZE=2 STYLE="font-size: 11pt">
the image filename, type, width, height, or other image attributes
may be incorporated in the text (see label()).</FONT></P>
<P CLASS="western"><FONT SIZE=2 STYLE="font-size: 11pt">The text
encoding specifies the code set to use for text annotations. The
only character encoding which may be specified at this time is
"<FONT FACE="Courier, monospace">UTF-8</FONT>" for
representing </FONT><A HREF="http://www.unicode.org/"><FONT SIZE=2 STYLE="font-size: 11pt">Unicode</FONT></A><FONT SIZE=2 STYLE="font-size: 11pt">
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.</FONT></P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableTextAntialias</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">bool flag_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">Antialias while drawing text (default true).
The main reason to disable text antialiasing is to avoid adding
new colors to the image.</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER><A NAME="DrawableTextDecoration"></A>
DrawableTextDecoration</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western"><FONT SIZE=2><A HREF="Enumerations.html#DecorationType">DecorationType</A>
decoration_</FONT></P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">Specify decoration (e.g. UnderlineDecoration)
to apply to text.</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableTextUnderColor</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">const Color &color_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">Draw a box under rendered text using the
specified color.</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableTranslation</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">double x_, double y_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">Apply coordinate translation (set new
coordinate origin).</P>
</TD>
</TR>
<TR>
<TD WIDTH=27%>
<P CLASS="western" ALIGN=CENTER>DrawableViewbox</P>
</TD>
<TD WIDTH=21%>
<P CLASS="western">unsigned long x1_, unsigned long y1_, unsigned
long x2_, unsigned long y2_</P>
</TD>
<TD WIDTH=52%>
<P CLASS="western">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.</P>
</TD>
</TR>
</TABLE>
<H2 ALIGN=CENTER>Vector Path Classes</H2>
<P>The vector paths supported by Magick++ are based on those
supported by the <A HREF="http://www.w3.org/TR/SVG/paths.html">SVG
XML specification</A>. Vector paths are not directly drawable, they
must first be supplied as a constructor argument to the <A HREF="#DrawablePath">DrawablePath</A>
class in order to create a drawable object. The <A HREF="#DrawablePath">DrawablePath</A>
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 <I>DrawablePath</I>
which sets the current drawing coordinate. Alternatively coordinate
transforms may be used to <A HREF="#DrawableTranslation">translate
the origin</A> in order to position the object, <A HREF="#DrawableRotation">rotate</A>
it, <A HREF="#DrawableSkewX">skew</A> it, or <A HREF="#DrawableScaling">scale</A>
it.
</P>
<H3>The "moveto" commands</H3>
<P STYLE="margin-bottom: 0in">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:
</P>
<P ALIGN=CENTER STYLE="margin-bottom: 0in"><B>Moveto Classes</B></P>
<TABLE WIDTH=100% BORDER=1 CELLPADDING=2 CELLSPACING=3>
<COL WIDTH=37*>
<COL WIDTH=43*>
<COL WIDTH=177*>
<TR>
<TH WIDTH=14%>
<P CLASS="western">Sub-Class</P>
</TH>
<TH WIDTH=17%>
<P CLASS="western">Constructor Signature</P>
</TH>
<TH WIDTH=69%>
<P CLASS="western">Description</P>
</TH>
</TR>
<TR>
<TD ROWSPAN=2 WIDTH=14%>
<P CLASS="western" ALIGN=CENTER><A NAME="PathMovetoAbs"></A>PathMovetoAbs</P>
</TD>
<TD WIDTH=17%>
<P CLASS="western">const Magick::Coordinate &coordinate_</P>
</TD>
<TD ROWSPAN=4 WIDTH=69%>
<P CLASS="western">Start a new sub-path at the given coordinate.
<I>PathMovetoAbs</I> indicates that absolute coordinates will
follow; <I>PathMovetoRel</I> 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.</P>
</TD>
</TR>
<TR>
<TD WIDTH=17%>
<P CLASS="western">const std::list<Magick::Coordinate>
&coordinates_</P>
</TD>
</TR>
<TR>
<TD ROWSPAN=2 WIDTH=14%>
<P CLASS="western" ALIGN=CENTER><A NAME="PathMovetoRel"></A>PathMovetoRel</P>
</TD>
<TD WIDTH=17%>
<P CLASS="western">const Magick::Coordinate &coordinate_</P>
</TD>
</TR>
<TR>
<TD WIDTH=17%>
<P CLASS="western">const std::list<Magick::Coordinate>
&coordinates_</P>
</TD>
</TR>
</TABLE>
<H3>The "closepath" command</H3>
<P STYLE="margin-bottom: 0in">The "closepath" command
causes an automatic straight line to be drawn from the current point
to the initial point of the current subpath:
</P>
<P ALIGN=CENTER STYLE="margin-bottom: 0in"><B>Closepath Classes</B></P>
<TABLE WIDTH=100% BORDER=1 CELLPADDING=2 CELLSPACING=3>
<COL WIDTH=37*>
<COL WIDTH=41*>
<COL WIDTH=178*>
<TR>
<TH WIDTH=14%>
<P CLASS="western">Sub-Class</P>
</TH>
<TH WIDTH=16%>
<P CLASS="western">Constructor Signature</P>
</TH>
<TH WIDTH=69%>
<P CLASS="western">Description</P>
</TH>
</TR>
<TR>
<TD WIDTH=14%>
<P CLASS="western" ALIGN=CENTER><A NAME="PathClosePath"></A>PathClosePath</P>
</TD>
<TD WIDTH=16%>
<P CLASS="western">void</P>
</TD>
<TD WIDTH=69%>
<P CLASS="western">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).</P>
</TD>
</TR>
</TABLE>
<H3>The "lineto" commands</H3>
<P STYLE="margin-bottom: 0in">The various "lineto" commands
draw straight lines from the current point to a new point:
</P>
<P ALIGN=CENTER STYLE="margin-bottom: 0in"><B>Lineto Classes</B></P>
<TABLE WIDTH=100% BORDER=1 CELLPADDING=2 CELLSPACING=3>
<COL WIDTH=56*>
<COL WIDTH=39*>
<COL WIDTH=161*>
<TR>
<TH WIDTH=22%>
<P CLASS="western">Sub-Class</P>
</TH>
<TH WIDTH=15%>
<P CLASS="western">Constructor Signature</P>
</TH>
<TH WIDTH=63%>
<P CLASS="western">Description</P>
</TH>
</TR>
<TR>
<TD ROWSPAN=2 WIDTH=22%>
<P CLASS="western" ALIGN=CENTER><A NAME="PathLinetoAbs"></A>PathLinetoAbs</P>
</TD>
<TD WIDTH=15%>
<P CLASS="western">const Magick::Coordinate& coordinate_</P>
</TD>
<TD ROWSPAN=4 WIDTH=63%>
<P CLASS="western">Draw a line from the current point to the given
coordinate which becomes the new current point.
<I>PathLinetoAbs</I> indicates that absolute coordinates are used;
<I>PathLinetoRel</I> 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.</P>
</TD>
</TR>
<TR>
<TD WIDTH=15%>
<P CLASS="western">const std::list<Magick::Coordinate>
&coordinates_</P>
</TD>
</TR>
<TR>
<TD ROWSPAN=2 WIDTH=22%>
<P CLASS="western" ALIGN=CENTER><A NAME="PathLinetoRel"></A>PathLinetoRel</P>
</TD>
<TD WIDTH=15%>
<P CLASS="western">const Magick::Coordinate& coordinate_</P>
</TD>
</TR>
<TR>
<TD WIDTH=15%>
<P CLASS="western">const std::list<Magick::Coordinate>
&coordinates_</P>
</TD>
</TR>
<TR>
<TD WIDTH=22%>
<P CLASS="western" ALIGN=CENTER><A NAME="PathLinetoHorizontalAbs"></A>
PathLinetoHorizontalAbs</P>
</TD>
<TD WIDTH=15%>
<P CLASS="western">double x_</P>
</TD>
<TD ROWSPAN=2 WIDTH=63%>
<P CLASS="western">Draws a horizontal line from the current point
(cpx, cpy) to (x, cpy). <I>PathLinetoHorizontalAbs</I> indicates
that absolute coordinates are supplied; <I>PathLinetoHorizontalRel</I>
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.</P>
</TD>
</TR>
<TR>
<TD WIDTH=22%>
<P CLASS="western" ALIGN=CENTER><A NAME="PathLinetoHorizontalRel"></A>
PathLinetoHorizontalRel</P>
</TD>
<TD WIDTH=15%>
<P CLASS="western">double x_</P>
</TD>
</TR>
<TR>
<TD WIDTH=22%>
<P CLASS="western" ALIGN=CENTER><A NAME="PathLinetoVerticalAbs"></A>
PathLinetoVerticalAbs</P>
</TD>
<TD WIDTH=15%>
<P CLASS="western">double y_</P>
</TD>
<TD ROWSPAN=2 WIDTH=63%>
<P CLASS="western">Draws a vertical line from the current point
(cpx, cpy) to (cpx, y). <I>PathLinetoVerticalAbs</I> indicates
that absolute coordinates are supplied; <I>PathLinetoVerticalRel</I>
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.</P>
</TD>
</TR>
<TR>
<TD WIDTH=22%>
<P CLASS="western" ALIGN=CENTER><A NAME="PathLinetoVerticalRel"></A>
PathLinetoVerticalRel</P>
</TD>
<TD WIDTH=15%>
<P CLASS="western">double y_</P>
</TD>
</TR>
</TABLE>
<H3>The curve commands</H3>
<P>These three groups of commands draw curves:
</P>
<UL>
<LI><P STYLE="margin-bottom: 0in"><A HREF="#cubic Bezier">Cubic
Bézier commands.</A> A cubic Bézier segment is defined
by a start point, an end point, and two control points.
</P>
<LI><P STYLE="margin-bottom: 0in"><A HREF="#quadratic Bezier">Quadratic
Bézier commands.</A> A quadratic Bézier segment is
defined by a start point, an end point, and one control point.
</P>
<LI><P><A HREF="#elliptical arc">Elliptical arc commands.</A> An
elliptical arc segment draws a segment of an ellipse.
</P>
</UL>
<H3><A NAME="cubic Bezier"></A>The cubic Bézier curve
commands</H3>
<P>The cubic Bézier commands depend on the <I>PathCurvetoArgs</I>
argument class, which has the constructor signature
</P>
<P><TT> PathCurvetoArgs( double x1_, double y1_,</TT>
<BR><TT>
double x2_, double y2_,</TT> <BR><TT>
double x_, double y_ );</TT>
</P>
<P STYLE="margin-bottom: 0in">The commands are as follows:
</P>
<P ALIGN=CENTER STYLE="margin-bottom: 0in"><B>Cubic Bézier
Curve Classes</B></P>
<TABLE WIDTH=100% BORDER=1 CELLPADDING=2 CELLSPACING=3>
<COL WIDTH=54*>
<COL WIDTH=58*>
<COL WIDTH=144*>
<TR>
<TH WIDTH=21%>
<P CLASS="western">Sub-Class</P>
</TH>
<TH WIDTH=23%>
<P CLASS="western">Constructor Signature</P>
</TH>
<TH WIDTH=56%>
<P CLASS="western">Description</P>
</TH>
</TR>
<TR>
<TD ROWSPAN=2 WIDTH=21%>
<P CLASS="western" ALIGN=CENTER><A NAME="PathCurvetoAbs"></A>PathCurvetoAbs</P>
</TD>
<TD WIDTH=23%>
<P CLASS="western">const Magick::PathCurvetoArgs &args_</P>
</TD>
<TD ROWSPAN=4 WIDTH=56%>
<P CLASS="western">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. <I>PathCurvetoAbs</I> indicates that
absolutecoordinates will follow; <I>PathCurvetoRel</I> 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.</P>
</TD>
</TR>
<TR>
<TD WIDTH=23%>
<P CLASS="western">const std::list<Magick::PathCurvetoArgs>
&args_</P>
</TD>
</TR>
<TR>
<TD ROWSPAN=2 WIDTH=21%>
<P CLASS="western" ALIGN=CENTER><A NAME="PathCurvetoRel"></A>PathCurvetoRel</P>
</TD>
<TD WIDTH=23%>
<P CLASS="western">const Magick::PathCurvetoArgs &args_</P>
</TD>
</TR>
<TR>
<TD WIDTH=23%>
<P CLASS="western">const std::list<Magick::PathCurvetoArgs>
&args_</P>
</TD>
</TR>
<TR>
<TD ROWSPAN=2 WIDTH=21%>
<P CLASS="western" ALIGN=CENTER><A NAME="PathSmoothCurvetoAbs"></A>
PathSmoothCurvetoAbs</P>
</TD>
<TD WIDTH=23%>
<P CLASS="western">const Magick::Coordinate &coordinates_</P>
</TD>
<TD ROWSPAN=4 WIDTH=56%>
<P CLASS="western">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 <I>PathCurvetoAbs</I>,
<I>PathCurvetoRel</I>, <I>PathSmoothCurvetoAbs</I> or
<I>PathSmoothCurvetoRel</I>, 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).
<I>PathSmoothCurvetoAbs</I> indicates that absolute coordinates
will follow; <I>PathSmoothCurvetoRel</I> 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.</P>
</TD>
</TR>
<TR>
<TD WIDTH=23%>
<P CLASS="western">const std::list<Magick::Coordinate>
&coordinates_</P>
</TD>
</TR>
<TR>
<TD ROWSPAN=2 WIDTH=21%>
<P CLASS="western" ALIGN=CENTER><A NAME="PathSmoothCurvetoRel"></A>
PathSmoothCurvetoRel</P>
</TD>
<TD WIDTH=23%>
<P CLASS="western">const Magick::Coordinate &coordinates_</P>
</TD>
</TR>
<TR>
<TD WIDTH=23%>
<P CLASS="western">const std::list<Magick::Coordinate>
&coordinates_</P>
</TD>
</TR>
</TABLE>
<H3><A NAME="quadratic Bezier"></A>The quadratic Bézier curve
commands</H3>
<P>The quadratic Bézier commands depend on the
<I>PathQuadraticCurvetoArgs</I> argument class, which has the
constructor signature:
</P>
<P><TT> PathQuadraticCurvetoArgs( double x1_, double y1_,</TT>
<BR><TT>
double x_, double y_ );</TT>
</P>
<P STYLE="margin-bottom: 0in">The quadratic Bézier commands
are as follows:
</P>
<P ALIGN=CENTER STYLE="margin-bottom: 0in"><B>Quadratic Bézier
Curve Classes</B></P>
<TABLE WIDTH=100% BORDER=1 CELLPADDING=2 CELLSPACING=2>
<TR>
<TH>
<P CLASS="western">Sub-Class</P>
</TH>
<TH>
<P CLASS="western">Constructor Signature</P>
</TH>
<TH>
<P CLASS="western">Description</P>
</TH>
</TR>
<TR>
<TD ROWSPAN=2>
<P CLASS="western" ALIGN=CENTER><A NAME="PathQuadraticCurvetoAbs"></A>
PathQuadraticCurvetoAbs</P>
</TD>
<TD>
<P CLASS="western">const Magick::PathQuadraticCurvetoArgs &args_</P>
</TD>
<TD ROWSPAN=4>
<P CLASS="western">Draws a quadratic Bézier curve from the
current point to (x,y) using (x1,y1) as the control point.
<I>PathQuadraticCurvetoAbs</I> indicates that absolute coordinates
will follow; <I>PathQuadraticCurvetoRel</I> 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.</P>
</TD>
</TR>
<TR>
<TD>
<P CLASS="western">const
std::list<Magick::PathQuadraticCurvetoArgs> &args_</P>
</TD>
</TR>
<TR>
<TD ROWSPAN=2>
<P CLASS="western" ALIGN=CENTER><A NAME="PathQuadraticCurvetoRel"></A>
PathQuadraticCurvetoRel</P>
</TD>
<TD>
<P CLASS="western">const Magick::PathQuadraticCurvetoArgs &args_</P>
</TD>
</TR>
<TR>
<TD>
<P CLASS="western">const
std::list<Magick::PathQuadraticCurvetoArgs> &args_</P>
</TD>
</TR>
<TR>
<TD ROWSPAN=2>
<P CLASS="western" ALIGN=CENTER><A NAME="PathSmoothQuadraticCurvetoAbs"></A>
PathSmoothQuadraticCurvetoAbs</P>
</TD>
<TD>
<P CLASS="western">const Magick::Coordinate &coordinate_</P>
</TD>
<TD ROWSPAN=4>
<P CLASS="western">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 <BR>command
relative to the current point. (If there is no previous command or
if the previous command was not a <I>PathQuadraticCurvetoAbs</I>,
<I>PathQuadraticCurvetoRel</I>, <I>PathSmoothQuadraticCurvetoAbs</I>
or <I>PathSmoothQuadraticCurvetoRel</I>, assume the control point
is coincident with the current point.)
<I>PathSmoothQuadraticCurvetoAbs</I> indicates that absolute
coordinates will follow; <I>PathSmoothQuadraticCurvetoRel</I>
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.</P>
</TD>
</TR>
<TR>
<TD>
<P CLASS="western">const std::list<Magick::Coordinate>
&coordinates_</P>
</TD>
</TR>
<TR>
<TD ROWSPAN=2>
<P CLASS="western" ALIGN=CENTER><A NAME="PathSmoothQuadraticCurvetoRel"></A>
PathSmoothQuadraticCurvetoRel</P>
</TD>
<TD>
<P CLASS="western">const Magick::Coordinate &coordinate_</P>
</TD>
</TR>
<TR>
<TD>
<P CLASS="western">const std::list<Magick::Coordinate>
&coordinates_</P>
</TD>
</TR>
</TABLE>
<H3><A NAME="elliptical arc"></A>The elliptical arc curve commands</H3>
<P>The elliptical arc curve commands depend on the <I>PathArcArgs</I>
argument class, which has the constructor signature:
</P>
<P><TT> PathArcArgs( double radiusX_, double radiusY_,</TT>
<BR><TT>
double xAxisRotation_, bool largeArcFlag_,</TT> <BR><TT>
bool sweepFlag_, double x_, double y_ );</TT>
</P>
<P STYLE="margin-bottom: 0in">The elliptical arc commands are as
follows:
</P>
<P ALIGN=CENTER STYLE="margin-bottom: 0in"><B>Elliptical Arc Curve
Classes</B></P>
<TABLE WIDTH=100% BORDER=1 CELLPADDING=2 CELLSPACING=3>
<COL WIDTH=35*>
<COL WIDTH=46*>
<COL WIDTH=175*>
<TR>
<TH WIDTH=14%>
<P CLASS="western">Sub-Class</P>
</TH>
<TH WIDTH=18%>
<P CLASS="western">Constructor Signature</P>
</TH>
<TH WIDTH=68%>
<P CLASS="western">Description</P>
</TH>
</TR>
<TR>
<TD ROWSPAN=2 WIDTH=14%>
<P CLASS="western" ALIGN=CENTER><A NAME="PathArcAbs"></A>PathArcAbs</P>
</TD>
<TD WIDTH=18%>
<P CLASS="western">const Magick::PathArcArgs &coordinates_</P>
</TD>
<TD ROWSPAN=4 WIDTH=68%>
<P CLASS="western">Draws an elliptical arc from the current point
to (x, y). The size and orientation of the ellipse are defined by
two radii (<I>radiusX</I>, <I>radiusY</I>) and an <I>xAxisRotation</I>,
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 automatically to satisfy the constraints imposed by
the other parameters. <I>largeArcFlag</I> and <I>sweepFlag</I>
contribute to the automatic calculations and help determine how
the arc is drawn. If <I>largeArcFlag</I> is true then draw the
larger of the available arcs. If <I>sweepFlag</I> is true, then
draw the arc matching a clock-wise rotation.</P>
</TD>
</TR>
<TR>
<TD WIDTH=18%>
<P CLASS="western">const std::list<Magick::PathArcArgs>
&coordinates_</P>
</TD>
</TR>
<TR>
<TD ROWSPAN=2 WIDTH=14%>
<P CLASS="western" ALIGN=CENTER><A NAME="PathArcRel"></A>PathArcRel</P>
</TD>
<TD WIDTH=18%>
<P CLASS="western">const Magick::PathArcArgs &coordinates_</P>
</TD>
</TR>
<TR>
<TD WIDTH=18%>
<P CLASS="western">const std::list<Magick::PathArcArgs>
&coordinates_</P>
</TD>
</TR>
</TABLE>
<P><BR><BR>
</P>
</BODY>
</HTML>
