Synopsis

DrawingWand *CloneDrawingWand( const DrawingWand *drawing_wand );

Description

CloneDrawingWand() returns a new drawing wand which is a full (deep) copy of an existing drawing wand.

The format of the CloneDrawingWand method is:

DrawingWand *CloneDrawingWand( const DrawingWand *drawing_wand );

A description of each parameter follows:

drawing_wand:

The drawing wand to copy

Synopsis

void DestroyDrawingWand( DrawingWand *drawing_wand );

Description

DestroyDrawingWand() frees all resources associated with the drawing wand. Once the drawing wand has been freed, it should not be used any further unless it re-allocated.

The format of the DestroyDrawingWand method is:

void DestroyDrawingWand( DrawingWand *drawing_wand );

A description of each parameter follows:

drawing_wand:

The drawing wand to destroy.

Synopsis

void DrawAnnotation( DrawingWand *drawing_wand, const double x, const double y,
                     const unsigned char *text );

Description

DrawAnnotation() draws text on the image.

The format of the DrawAnnotation method is:

void DrawAnnotation( DrawingWand *drawing_wand, const double x, const double y,
                     const unsigned char *text );

drawing_wand:

The drawing wand.

x:

x ordinate to left of text

y:

y ordinate to text baseline

text:

text to draw

Synopsis

void DrawAffine( DrawingWand *drawing_wand, const AffineMatrix *affine );

Description

DrawAffine() adjusts the current affine transformation matrix with the specified affine transformation matrix. Note that the current affine transform is adjusted rather than replaced.

The format of the DrawAffine method is:

void DrawAffine( DrawingWand *drawing_wand, const AffineMatrix *affine );

A description of each parameter follows:

drawing_wand:

Drawing drawing_wand

affine:

Affine matrix parameters

Synopsis

DrawingWand DrawAllocateWand( const DrawInfo *draw_info, Image *image );

Description

DrawAllocateWand() allocates an initial drawing wand which is an opaque handle required by the remaining drawing methods.

The format of the DrawAllocateWand method is:

DrawingWand DrawAllocateWand( const DrawInfo *draw_info, Image *image );

A description of each parameter follows:

draw_info:

Initial drawing defaults. Set to NULL to use ImageMagick defaults.

image:

The image to draw on.

Synopsis

void DrawArc( DrawingWand *drawing_wand, const double sx, const double sy, const double ex,
              const double ey, const double sd, const double ed );

Description

DrawArc() draws an arc falling within a specified bounding rectangle on the image.

The format of the DrawArc method is:

void DrawArc( DrawingWand *drawing_wand, const double sx, const double sy, const double ex,
              const double ey, const double sd, const double ed );

drawing_wand:

The drawing wand.

sx:

starting x ordinate of bounding rectangle

sy:

starting y ordinate of bounding rectangle

ex:

ending x ordinate of bounding rectangle

ey:

ending y ordinate of bounding rectangle

sd:

starting degrees of rotation

ed:

ending degrees of rotation

Synopsis

void DrawBezier( DrawingWand *drawing_wand, const unsigned long number_coordinates,
                 const PointInfo *coordinates );

Description

DrawBezier() draws a bezier curve through a set of points on the image.

The format of the DrawBezier method is:

void DrawBezier( DrawingWand *drawing_wand, const unsigned long number_coordinates,
                 const PointInfo *coordinates );

drawing_wand:

The drawing wand.

number_coordinates:

number of coordinates

coordinates:

coordinates

Synopsis

void DrawCircle( DrawingWand *drawing_wand, const double ox, const double oy, const double px,
                 const double py );

Description

DrawCircle() draws a circle on the image.

The format of the DrawCircle method is:

void DrawCircle( DrawingWand *drawing_wand, const double ox, const double oy, const double px,
                 const double py );

drawing_wand:

The drawing wand.

ox:

origin x ordinate

oy:

origin y ordinate

px:

perimeter x ordinate

py:

perimeter y ordinate

Synopsis

MagickPassFail DrawClearException( DrawingWand *drawing_wand );

Description

DrawClearException() clears any existing exception from the drawing wand.

The format of the DrawGetException method is:

MagickPassFail DrawClearException( DrawingWand *drawing_wand );

A description of each parameter follows:

drawing_wand:

The drawing wand.

Synopsis

char *DrawGetClipPath( const DrawingWand *drawing_wand );

Description

DrawGetClipPath() obtains the current clipping path ID. The value returned must be deallocated by the user when it is no longer needed.

The format of the DrawGetClipPath method is:

char *DrawGetClipPath( const DrawingWand *drawing_wand );

A description of each parameter follows:

drawing_wand:

The drawing wand.

Synopsis

void DrawSetClipPath( DrawingWand *drawing_wand, const char *clip_path );

Description

DrawSetClipPath() associates a named clipping path with the image. Only the areas drawn on by the clipping path will be modified as long as it remains in effect.

The format of the DrawSetClipPath method is:

void DrawSetClipPath( DrawingWand *drawing_wand, const char *clip_path );

A description of each parameter follows:

drawing_wand:

The drawing wand.

clip_path:

name of clipping path to associate with image

Synopsis

FillRule DrawGetClipRule( const DrawingWand *drawing_wand );

Description

DrawGetClipRule() returns the current polygon fill rule to be used by the clipping path.

The format of the DrawGetClipRule method is:

FillRule DrawGetClipRule( const DrawingWand *drawing_wand );

A description of each parameter follows:

drawing_wand:

The drawing wand.

Synopsis

void DrawSetClipRule( DrawingWand *drawing_wand, const FillRule fill_rule );

Description

DrawSetClipRule() set the polygon fill rule to be used by the clipping path.

The format of the DrawSetClipRule method is:

void DrawSetClipRule( DrawingWand *drawing_wand, const FillRule fill_rule );

A description of each parameter follows:

drawing_wand:

The drawing wand.

fill_rule:

fill rule (EvenOddRule or NonZeroRule)

Synopsis

ClipPathUnits DrawGetClipUnits( const DrawingWand *drawing_wand );

Description

DrawGetClipUnits() returns the interpretation of clip path units.

The format of the DrawGetClipUnits method is:

ClipPathUnits DrawGetClipUnits( const DrawingWand *drawing_wand );

A description of each parameter follows:

drawing_wand:

The drawing wand.

Synopsis

char *DrawGetException( const DrawingWand *drawing_wand, ExceptionType *severity );

Description

DrawGetException() obtains error information associated with the last exception (if any). If an exception did occur, an allocated text string is returned which contains a detailed description of the exception. This string must be deallocated by the user once it is no longer needed.

The format of the DrawGetException method is:

char *DrawGetException( const DrawingWand *drawing_wand, ExceptionType *severity );

drawing_wand:

The drawing wand.

severity:

Enumeration corresponding to last thrown exception.

Synopsis

void DrawSetClipUnits( DrawingWand *drawing_wand, const ClipPathUnits clip_units );

Description

DrawSetClipUnits() sets the interpretation of clip path units.

The format of the DrawSetClipUnits method is:

void DrawSetClipUnits( DrawingWand *drawing_wand, const ClipPathUnits clip_units );

drawing_wand:

The drawing wand.

clip_units:

units to use (UserSpace, UserSpaceOnUse, or ObjectBoundingBox)

Synopsis

void DrawColor( DrawingWand *drawing_wand, const double x, const double y,
                const PaintMethod paintMethod );

Description

DrawColor() draws color on image using the current fill color, starting at specified position, and using specified paint method. The available paint methods are:

PointMethod: Recolors the target pixel ReplaceMethod: Recolor any pixel that matches the target pixel. FloodfillMethod: Recolors target pixels and matching neighbors. FillToBorderMethod: Recolor target pixels and neighbors not matching ResetMethod: Recolor all pixels.

The format of the DrawColor method is:

void DrawColor( DrawingWand *drawing_wand, const double x, const double y,
                const PaintMethod paintMethod );

drawing_wand:

The drawing wand.

x:

x ordinate

y:

y ordinate

paintMethod:

paint method

Synopsis

void DrawComment( DrawingWand *drawing_wand, const char *comment );

Description

DrawComment() adds a comment to a vector output stream.

The format of the DrawComment method is:

void DrawComment( DrawingWand *drawing_wand, const char *comment );

A description of each parameter follows:

drawing_wand:

The drawing wand.

comment:

comment text

Synopsis

void DrawEllipse( DrawingWand *drawing_wand, const double ox, const double oy, const double rx,
                  const double ry, const double start, const double end );

Description

DrawEllipse() draws an ellipse on the image.

The format of the DrawEllipse method is:

void DrawEllipse( DrawingWand *drawing_wand, const double ox, const double oy, const double rx,
                  const double ry, const double start, const double end );

drawing_wand:

The drawing wand.

ox:

origin x ordinate

oy:

origin y ordinate

rx:

radius in x

ry:

radius in y

start:

starting rotation in degrees

end:

ending rotation in degrees

Synopsis

void DrawGetFillColor( const DrawingWand *drawing_wand, PixelWand *fill_color );

Description

DrawGetFillColor() returns the fill color used for drawing filled objects.

The format of the DrawGetFillColor method is:

void DrawGetFillColor( const DrawingWand *drawing_wand, PixelWand *fill_color );

drawing_wand:

The drawing wand.

fill_color:

Return the fill color.

Synopsis

void DrawSetFillColor( DrawingWand *drawing_wand, const PixelWand *fill_wand );

Description

DrawSetFillColor() sets the fill color to be used for drawing filled objects.

The format of the DrawSetFillColor method is:

void DrawSetFillColor( DrawingWand *drawing_wand, const PixelWand *fill_wand );

drawing_wand:

The drawing wand.

fill_wand:

fill wand.

Synopsis

void DrawSetFillPatternURL( DrawingWand *drawing_wand, const char *fill_url );

Description

DrawSetFillPatternURL() sets the URL to use as a fill pattern for filling objects. Only local URLs ("#identifier") are supported at this time. These local URLs are normally created by defining a named fill pattern with DrawPushPattern/DrawPopPattern.

The format of the DrawSetFillPatternURL method is:

void DrawSetFillPatternURL( DrawingWand *drawing_wand, const char *fill_url );

drawing_wand:

The drawing wand.

fill_url:

URL to use to obtain fill pattern.

Synopsis

double DrawGetFillOpacity( const DrawingWand *drawing_wand );

Description

DrawGetFillOpacity() returns the opacity used when drawing using the fill color or fill texture. Fully opaque is 1.0.

The format of the DrawGetFillOpacity method is:

double DrawGetFillOpacity( const DrawingWand *drawing_wand );

A description of each parameter follows:

drawing_wand:

The drawing wand.

Synopsis

void DrawSetFillOpacity( DrawingWand *drawing_wand, const double fill_opacity );

Description

DrawSetFillOpacity() sets the opacity to use when drawing using the fill color or fill texture. Fully opaque is 1.0.

The format of the DrawSetFillOpacity method is:

void DrawSetFillOpacity( DrawingWand *drawing_wand, const double fill_opacity );

drawing_wand:

The drawing wand.

fill_opacity:

fill opacity

Synopsis

FillRule DrawGetFillRule( const DrawingWand *drawing_wand );

Description

DrawGetFillRule() returns the fill rule used while drawing polygons.

The format of the DrawGetFillRule method is:

FillRule DrawGetFillRule( const DrawingWand *drawing_wand );

A description of each parameter follows:

drawing_wand:

The drawing wand.

Synopsis

void DrawSetFillRule( DrawingWand *drawing_wand, const FillRule fill_rule );

Description

DrawSetFillRule() sets the fill rule to use while drawing polygons.

The format of the DrawSetFillRule method is:

void DrawSetFillRule( DrawingWand *drawing_wand, const FillRule fill_rule );

A description of each parameter follows:

drawing_wand:

The drawing wand.

fill_rule:

fill rule (EvenOddRule or NonZeroRule)

Synopsis

char *DrawGetFont( const DrawingWand *drawing_wand );

Description

DrawGetFont() returns a null-terminaged string specifying the font used when annotating with text. The value returned must be freed by the user when no longer needed.

The format of the DrawGetFont method is:

char *DrawGetFont( const DrawingWand *drawing_wand );

A description of each parameter follows:

drawing_wand:

The drawing wand.

Synopsis

void DrawSetFont( DrawingWand *drawing_wand, const char *font_name );

Description

DrawSetFont() sets the fully-sepecified font to use when annotating with text.

The format of the DrawSetFont method is:

void DrawSetFont( DrawingWand *drawing_wand, const char *font_name );

A description of each parameter follows:

drawing_wand:

The drawing wand.

font_name:

font name

Synopsis

char *DrawGetFontFamily( const DrawingWand *drawing_wand );

Description

DrawGetFontFamily() returns the font family to use when annotating with text. The value returned must be freed by the user when it is no longer needed.

The format of the DrawGetFontFamily method is:

char *DrawGetFontFamily( const DrawingWand *drawing_wand );

A description of each parameter follows:

drawing_wand:

The drawing wand.

Synopsis

void DrawSetFontFamily( DrawingWand *drawing_wand, const char *font_family );

Description

DrawSetFontFamily() sets the font family to use when annotating with text.

The format of the DrawSetFontFamily method is:

void DrawSetFontFamily( DrawingWand *drawing_wand, const char *font_family );

A description of each parameter follows:

drawing_wand:

The drawing wand.

font_family:

font family

Synopsis

double DrawGetFontSize( const DrawingWand *drawing_wand );

Description

DrawGetFontSize() returns the font pointsize used when annotating with text.

The format of the DrawGetFontSize method is:

double DrawGetFontSize( const DrawingWand *drawing_wand );

A description of each parameter follows:

drawing_wand:

The drawing wand.

Synopsis

void DrawSetFontSize( DrawingWand *drawing_wand, const double pointsize );

Description

DrawSetFontSize() sets the font pointsize to use when annotating with text.

The format of the DrawSetFontSize method is:

void DrawSetFontSize( DrawingWand *drawing_wand, const double pointsize );

A description of each parameter follows:

drawing_wand:

The drawing wand.

pointsize:

text pointsize

Synopsis

StretchType DrawGetFontStretch( const DrawingWand *drawing_wand );

Description

DrawGetFontStretch() returns the font stretch used when annotating with text.

The format of the DrawGetFontStretch method is:

StretchType DrawGetFontStretch( const DrawingWand *drawing_wand );

A description of each parameter follows:

drawing_wand:

The drawing wand.

Synopsis

void DrawSetFontStretch( DrawingWand *drawing_wand, const StretchType font_stretch );

Description

DrawSetFontStretch() sets the font stretch to use when annotating with text. The AnyStretch enumeration acts as a wild-card "don't care" option.

The format of the DrawSetFontStretch method is:

void DrawSetFontStretch( DrawingWand *drawing_wand, const StretchType font_stretch );

drawing_wand:

The drawing wand.

font_stretch:

font stretch (NormalStretch, UltraCondensedStretch, CondensedStretch, SemiCondensedStretch, SemiExpandedStretch, ExpandedStretch, ExtraExpandedStretch, UltraExpandedStretch, AnyStretch)

Synopsis

StyleType DrawGetFontStyle( const DrawingWand *drawing_wand );

Description

DrawGetFontStyle() returns the font style used when annotating with text.

The format of the DrawGetFontStyle method is:

StyleType DrawGetFontStyle( const DrawingWand *drawing_wand );

A description of each parameter follows:

drawing_wand:

The drawing wand.

Synopsis

void DrawSetFontStyle( DrawingWand *drawing_wand, const StyleType style );

Description

DrawSetFontStyle() sets the font style to use when annotating with text. The AnyStyle enumeration acts as a wild-card "don't care" option.

The format of the DrawSetFontStyle method is:

void DrawSetFontStyle( DrawingWand *drawing_wand, const StyleType style );

A description of each parameter follows:

drawing_wand:

The drawing wand.

style:

font style (NormalStyle, ItalicStyle, ObliqueStyle, AnyStyle)

Synopsis

unsigned long DrawGetFontWeight( const DrawingWand *drawing_wand );

Description

DrawGetFontWeight() returns the font weight used when annotating with text.

The format of the DrawGetFontWeight method is:

unsigned long DrawGetFontWeight( const DrawingWand *drawing_wand );

A description of each parameter follows:

drawing_wand:

The drawing wand.

Synopsis

void DrawSetFontWeight( DrawingWand *drawing_wand, const unsigned long font_weight );

Description

DrawSetFontWeight() sets the font weight to use when annotating with text.

The format of the DrawSetFontWeight method is:

void DrawSetFontWeight( DrawingWand *drawing_wand, const unsigned long font_weight );

drawing_wand:

The drawing wand.

font_weight:

font weight (valid range 100-900)

Synopsis

GravityType DrawGetGravity( const DrawingWand *drawing_wand );

Description

DrawGetGravity() returns the text placement gravity used when annotating with text.

The format of the DrawGetGravity method is:

GravityType DrawGetGravity( const DrawingWand *drawing_wand );

A description of each parameter follows:

drawing_wand:

The drawing wand.

Synopsis

void DrawSetGravity( DrawingWand *drawing_wand, const GravityType gravity );

Description

DrawSetGravity() sets the text placement gravity to use when annotating with text.

The format of the DrawSetGravity method is:

void DrawSetGravity( DrawingWand *drawing_wand, const GravityType gravity );

A description of each parameter follows:

drawing_wand:

The drawing wand.

gravity:

positioning gravity (NorthWestGravity, NorthGravity, NorthEastGravity, WestGravity, CenterGravity, EastGravity, SouthWestGravity, SouthGravity, SouthEastGravity)

Synopsis

void DrawComposite( DrawingWand *drawing_wand, const CompositeOperator composite_operator,
                    const double x, const double y, const double width, const double height,
                    const Image *image );

Description

DrawComposite() composites an image onto the current image, using the specified composition operator, specified position, and at the specified size.

The format of the DrawComposite method is:

void DrawComposite( DrawingWand *drawing_wand, const CompositeOperator composite_operator,
                    const double x, const double y, const double width, const double height,
                    const Image *image );

drawing_wand:

The drawing wand.

composite_operator:

composition operator

x:

x ordinate of top left corner

y:

y ordinate of top left corner

width:

Width to resize image to prior to compositing. Specify zero to use existing width.

height:

Height to resize image to prior to compositing. Specify zero to use existing height.

image:

Image to composite

Synopsis

void DrawLine( DrawingWand *drawing_wand, const double sx, const double sy, const double ex,
               const double ey );

Description

DrawLine() draws a line on the image using the current stroke color, stroke opacity, and stroke width.

The format of the DrawLine method is:

void DrawLine( DrawingWand *drawing_wand, const double sx, const double sy, const double ex,
               const double ey );

drawing_wand:

The drawing wand.

sx:

starting x ordinate

sy:

starting y ordinate

ex:

ending x ordinate

ey:

ending y ordinate

Synopsis

void DrawMatte( DrawingWand *drawing_wand, const double x, const double y,
                const PaintMethod paint_method );

Description

DrawMatte() paints on the image's opacity channel in order to set effected pixels to transparent. to influence the opacity of pixels. The available paint methods are:

PointMethod: Select the target pixel ReplaceMethod: Select any pixel that matches the target pixel. FloodfillMethod: Select the target pixel and matching neighbors. FillToBorderMethod: Select the target pixel and neighbors not matching border color. ResetMethod: Select all pixels.

The format of the DrawMatte method is:

void DrawMatte( DrawingWand *drawing_wand, const double x, const double y,
                const PaintMethod paint_method );

drawing_wand:

The drawing wand.

x:

x ordinate

y:

y ordinate

o paint_method:

Synopsis

void DrawPathClose( DrawingWand *drawing_wand );

Description

DrawPathClose() adds a path element to the current path which closes the current subpath by drawing a straight line from the current point to the current subpath's most recent starting point (usually, the most recent moveto point).

The format of the DrawPathClose method is:

void DrawPathClose( DrawingWand *drawing_wand );

A description of each parameter follows:

drawing_wand:

The drawing wand.

Synopsis

void DrawPathCurveToAbsolute( DrawingWand *drawing_wand, const double x1, const double y1,
                              const double x2, const double y2, const double x,
                              const double y );

Description

DrawPathCurveToAbsolute() draws a cubic Bezier 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 using absolute coordinates. At the end of the command, the new current point becomes the final (x,y) coordinate pair used in the polybezier.

The format of the DrawPathCurveToAbsolute method is:

void DrawPathCurveToAbsolute( DrawingWand *drawing_wand, const double x1, const double y1,
                              const double x2, const double y2, const double x,
                              const double y );

drawing_wand:

The drawing wand.

x1:

x ordinate of control point for curve beginning

y1:

y ordinate of control point for curve beginning

x2:

x ordinate of control point for curve ending

y2:

y ordinate of control point for curve ending

x:

x ordinate of the end of the curve

y:

y ordinate of the end of the curve

Synopsis

void DrawPathCurveToRelative( DrawingWand *drawing_wand, const double x1, const double y1,
                              const double x2, const double y2, const double x,
                              const double y );

Description

DrawPathCurveToRelative() draws a cubic Bezier 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 using relative coordinates. At the end of the command, the new current point becomes the final (x,y) coordinate pair used in the polybezier.

The format of the DrawPathCurveToRelative method is:

void DrawPathCurveToRelative( DrawingWand *drawing_wand, const double x1, const double y1,
                              const double x2, const double y2, const double x,
                              const double y );

drawing_wand:

The drawing wand.

x1:

x ordinate of control point for curve beginning

y1:

y ordinate of control point for curve beginning

x2:

x ordinate of control point for curve ending

y2:

y ordinate of control point for curve ending

x:

x ordinate of the end of the curve

y:

y ordinate of the end of the curve

Synopsis

void DrawPathCurveToQuadraticBezierAbsolute( DrawingWand *drawing_wand, const double x1,
                                             const double y1, onst double x, const double y );

Description

DrawPathCurveToQuadraticBezierAbsolute() draws a quadratic Bezier curve from the current point to (x,y) using (x1,y1) as the control point using absolute coordinates. At the end of the command, the new current point becomes the final (x,y) coordinate pair used in the polybezier.

The format of the DrawPathCurveToQuadraticBezierAbsolute method is:

void DrawPathCurveToQuadraticBezierAbsolute( DrawingWand *drawing_wand, const double x1,
                                             const double y1, onst double x, const double y );

drawing_wand:

The drawing wand.

x1:

x ordinate of the control point

y1:

y ordinate of the control point

x:

x ordinate of final point

y:

y ordinate of final point

Synopsis

void DrawPathCurveToQuadraticBezierRelative( DrawingWand *drawing_wand, const double x1,
                                             const double y1, const double x,
                                             const double y );

Description

DrawPathCurveToQuadraticBezierRelative() draws a quadratic Bezier curve from the current point to (x,y) using (x1,y1) as the control point using relative coordinates. At the end of the command, the new current point becomes the final (x,y) coordinate pair used in the polybezier.

The format of the DrawPathCurveToQuadraticBezierRelative method is:

void DrawPathCurveToQuadraticBezierRelative( DrawingWand *drawing_wand, const double x1,
                                             const double y1, const double x,
                                             const double y );

drawing_wand:

The drawing wand.

x1:

x ordinate of the control point

y1:

y ordinate of the control point

x:

x ordinate of final point

y:

y ordinate of final point

Synopsis

void DrawPathCurveToQuadraticBezierSmoothAbsolute( DrawingWand *drawing_wand, const double x,
                                                   const double y );

Description

DrawPathCurveToQuadraticBezierSmoothAbsolute() draws a quadratic Bezier curve (using absolute coordinates) 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 DrawPathCurveToQuadraticBezierAbsolute, DrawPathCurveToQuadraticBezierRelative, DrawPathCurveToQuadraticBezierSmoothAbsolute or DrawPathCurveToQuadraticBezierSmoothRelative, assume the control point is coincident with the current point.). At the end of the command, the new current point becomes the final (x,y) coordinate pair used in the polybezier.

The format of the DrawPathCurveToQuadraticBezierSmoothAbsolute method is:

void DrawPathCurveToQuadraticBezierSmoothAbsolute( DrawingWand *drawing_wand, const double x,
                                                   const double y );

drawing_wand:

The drawing wand.

x:

x ordinate of final point

y:

y ordinate of final point

Synopsis

void DrawPathCurveToQuadraticBezierSmoothRelative( DrawingWand *drawing_wand, const double x,
                                                   const double y );

Description

DrawPathCurveToQuadraticBezierSmoothRelative() draws a quadratic Bezier curve (using relative coordinates) 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 DrawPathCurveToQuadraticBezierAbsolute, DrawPathCurveToQuadraticBezierRelative, DrawPathCurveToQuadraticBezierSmoothAbsolute or DrawPathCurveToQuadraticBezierSmoothRelative, assume the control point is coincident with the current point.). At the end of the command, the new current point becomes the final (x,y) coordinate pair used in the polybezier.

The format of the DrawPathCurveToQuadraticBezierSmoothRelative method is:

void DrawPathCurveToQuadraticBezierSmoothRelative( DrawingWand *drawing_wand, const double x,
                                                   const double y );

drawing_wand:

The drawing wand.

x:

x ordinate of final point

y:

y ordinate of final point

Synopsis

void DrawPathCurveToSmoothAbsolute( DrawingWand *drawing_wand, const double x2const double y2,
                                    const double x, const double y );

Description

DrawPathCurveToSmoothAbsolute() draws a cubic Bezier curve from the current point to (x,y) using absolute coordinates. 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 DrawPathCurveToAbsolute, DrawPathCurveToRelative, DrawPathCurveToSmoothAbsolute or DrawPathCurveToSmoothRelative, 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). At the end of the command, the new current point becomes the final (x,y) coordinate pair used in the polybezier.

The format of the DrawPathCurveToSmoothAbsolute method is:

void DrawPathCurveToSmoothAbsolute( DrawingWand *drawing_wand, const double x2const double y2,
                                    const double x, const double y );

drawing_wand:

The drawing wand.

x2:

x ordinate of second control point

y2:

y ordinate of second control point

x:

x ordinate of termination point

y:

y ordinate of termination point

Synopsis

void DrawPathCurveToSmoothRelative( DrawingWand *drawing_wand, const double x2,
                                    const double y2, const double x, const double y );

Description

DrawPathCurveToSmoothRelative() draws a cubic Bezier curve from the current point to (x,y) using relative coordinates. 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 DrawPathCurveToAbsolute, DrawPathCurveToRelative, DrawPathCurveToSmoothAbsolute or DrawPathCurveToSmoothRelative, 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). At the end of the command, the new current point becomes the final (x,y) coordinate pair used in the polybezier.

The format of the DrawPathCurveToSmoothRelative method is:

void DrawPathCurveToSmoothRelative( DrawingWand *drawing_wand, const double x2,
                                    const double y2, const double x, const double y );

drawing_wand:

The drawing wand.

x2:

x ordinate of second control point

y2:

y ordinate of second control point

x:

x ordinate of termination point

y:

y ordinate of termination point

Synopsis

void DrawPathEllipticArcAbsolute( DrawingWand *drawing_wand, const double rx, const double ry,
                                  const double x_axis_rotation,
                                  unsigned int large_arc_flag, unsigned int sweep_flag,
                                  const double x, const double y );

Description

DrawPathEllipticArcAbsolute() draws an elliptical arc from the current point to (x, y) using absolute coordinates. The size and orientation of the ellipse are defined by two radii (rx, ry) 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 automatically 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.

The format of the DrawPathEllipticArcAbsolute method is:

void DrawPathEllipticArcAbsolute( DrawingWand *drawing_wand, const double rx, const double ry,
                                  const double x_axis_rotation,
                                  unsigned int large_arc_flag, unsigned int sweep_flag,
                                  const double x, const double y );

drawing_wand:

The drawing wand.

rx:

x radius

ry:

y radius

x_axis_rotation:

indicates how the ellipse as a whole is rotated relative to the current coordinate system

large_arc_flag:

If non-zero (true) then draw the larger of the available arcs

sweep_flag:

If non-zero (true) then draw the arc matching a clock-wise rotation

Synopsis

void DrawPathEllipticArcRelative( DrawingWand *drawing_wand, const double rx, const double ry,
                                  const double x_axis_rotation,
                                  unsigned int large_arc_flag, unsigned int sweep_flag,
                                  const double x, const double y );

Description

DrawPathEllipticArcRelative() draws an elliptical arc from the current point to (x, y) using relative coordinates. The size and orientation of the ellipse are defined by two radii (rx, ry) 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 automatically 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.

The format of the DrawPathEllipticArcRelative method is:

void DrawPathEllipticArcRelative( DrawingWand *drawing_wand, const double rx, const double ry,
                                  const double x_axis_rotation,
                                  unsigned int large_arc_flag, unsigned int sweep_flag,
                                  const double x, const double y );

drawing_wand:

The drawing wand.

rx:

x radius

ry:

y radius

x_axis_rotation:

indicates how the ellipse as a whole is rotated relative to the current coordinate system

large_arc_flag:

If non-zero (true) then draw the larger of the available arcs

sweep_flag:

If non-zero (true) then draw the arc matching a clock-wise rotation

Synopsis

void DrawPathFinish( DrawingWand *drawing_wand );

Description

DrawPathFinish() terminates the current path.

The format of the DrawPathFinish method is:

void DrawPathFinish( DrawingWand *drawing_wand );

A description of each parameter follows:

drawing_wand:

The drawing wand.

Synopsis

void DrawPathLineToAbsolute( DrawingWand *drawing_wand, const double x, const double y );

Description

DrawPathLineToAbsolute() draws a line path from the current point to the given coordinate using absolute coordinates. The coordinate then becomes the new current point.

The format of the DrawPathLineToAbsolute method is:

void DrawPathLineToAbsolute( DrawingWand *drawing_wand, const double x, const double y );

A description of each parameter follows:

drawing_wand:

The drawing wand.

x:

target x ordinate

y:

target y ordinate

Synopsis

void DrawPathLineToRelative( DrawingWand *drawing_wand, const double x, const double y );

Description

DrawPathLineToRelative() draws a line path from the current point to the given coordinate using relative coordinates. The coordinate then becomes the new current point.

The format of the DrawPathLineToRelative method is:

void DrawPathLineToRelative( DrawingWand *drawing_wand, const double x, const double y );

drawing_wand:

The drawing wand.

x:

target x ordinate

y:

target y ordinate

Synopsis

void DrawPathLineToHorizontalAbsolute( DrawingWand *drawing_wand, const PathMode mode,
                                       const double x );

Description

DrawPathLineToHorizontalAbsolute() draws a horizontal line path from the current point to the target point using absolute coordinates. The target point then becomes the new current point.

The format of the DrawPathLineToHorizontalAbsolute method is:

void DrawPathLineToHorizontalAbsolute( DrawingWand *drawing_wand, const PathMode mode,
                                       const double x );

drawing_wand:

The drawing wand.

x:

target x ordinate

Synopsis

void DrawPathLineToHorizontalRelative( DrawingWand *drawing_wand, const double x );

Description

DrawPathLineToHorizontalRelative() draws a horizontal line path from the current point to the target point using relative coordinates. The target point then becomes the new current point.

The format of the DrawPathLineToHorizontalRelative method is:

void DrawPathLineToHorizontalRelative( DrawingWand *drawing_wand, const double x );

drawing_wand:

The drawing wand.

x:

target x ordinate

Synopsis

void DrawPathLineToVerticalAbsolute( DrawingWand *drawing_wand, const double y );

Description

DrawPathLineToVerticalAbsolute() draws a vertical line path from the current point to the target point using absolute coordinates. The target point then becomes the new current point.

The format of the DrawPathLineToVerticalAbsolute method is:

void DrawPathLineToVerticalAbsolute( DrawingWand *drawing_wand, const double y );

drawing_wand:

The drawing wand.

y:

target y ordinate

Synopsis

void DrawPathLineToVerticalRelative( DrawingWand *drawing_wand, const double y );

Description

DrawPathLineToVerticalRelative() draws a vertical line path from the current point to the target point using relative coordinates. The target point then becomes the new current point.

The format of the DrawPathLineToVerticalRelative method is:

void DrawPathLineToVerticalRelative( DrawingWand *drawing_wand, const double y );

drawing_wand:

The drawing wand.

y:

target y ordinate

Synopsis

void DrawPathMoveToAbsolute( DrawingWand *drawing_wand, const double x, const double y );

Description

DrawPathMoveToAbsolute() starts a new sub-path at the given coordinate using absolute coordinates. The current point then becomes the specified coordinate.

The format of the DrawPathMoveToAbsolute method is:

void DrawPathMoveToAbsolute( DrawingWand *drawing_wand, const double x, const double y );

drawing_wand:

The drawing wand.

x:

target x ordinate

y:

target y ordinate

Synopsis

void DrawPathMoveToRelative( DrawingWand *drawing_wand, const double x, const double y );

Description

DrawPathMoveToRelative() starts a new sub-path at the given coordinate using relative coordinates. The current point then becomes the specified coordinate.

The format of the DrawPathMoveToRelative method is:

void DrawPathMoveToRelative( DrawingWand *drawing_wand, const double x, const double y );

drawing_wand:

The drawing wand.

x:

target x ordinate

y:

target y ordinate

Synopsis

void DrawPathStart( DrawingWand *drawing_wand );

Description

DrawPathStart() declares the start of a path drawing list which is terminated by a matching DrawPathFinish() command. All other DrawPath commands must be enclosed between a DrawPathStart() and a DrawPathFinish() command. This is because path drawing commands are subordinate commands and they do not function by themselves.

The format of the DrawPathStart method is:

void DrawPathStart( DrawingWand *drawing_wand );

A description of each parameter follows:

drawing_wand:

The drawing wand.

Synopsis

DrawInfo *DrawPeekGraphicContext( const DrawingWand *drawing_wand );

Description

DrawPeekGraphicContext() returns the current graphic drawing_wand.

The format of the DrawPeekGraphicContext method is:

DrawInfo *DrawPeekGraphicContext( const DrawingWand *drawing_wand );

A description of each parameter follows:

drawing_wand:

The drawing wand.

Synopsis

void DrawPoint( DrawingWand *drawing_wand, const double x, const double y );

Description

DrawPoint() draws a point using the current stroke color and stroke thickness at the specified coordinates.

The format of the DrawPoint method is:

void DrawPoint( DrawingWand *drawing_wand, const double x, const double y );

A description of each parameter follows:

drawing_wand:

The drawing wand.

x:

target x coordinate

y:

target y coordinate

Synopsis

void DrawPolygon( DrawingWand *drawing_wand, const unsigned long number_coordinates,
                  const PointInfo *coordinates );

Description

DrawPolygon() draws a polygon using the current stroke, stroke width, and fill color or texture, using the specified array of coordinates.

The format of the DrawPolygon method is:

void DrawPolygon( DrawingWand *drawing_wand, const unsigned long number_coordinates,
                  const PointInfo *coordinates );

drawing_wand:

The drawing wand.

number_coordinates:

number of coordinates

coordinates:

coordinate array

Synopsis

void DrawPolyline( DrawingWand *drawing_wand, const unsigned long number_coordinates,
                   const PointInfo *coordinates );

Description

DrawPolyline() draws a polyline using the current stroke, stroke width, and fill color or texture, using the specified array of