blob: 3922ab83f6acfed9a2c44153cba624b20ef9f2fb [file] [log] [blame]
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% DDDD RRRR AAA W W IIIII N N GGGG %
% D D R R A A W W I NN N G %
% D D RRRR AAAAA W W I N N N G GG %
% D D R R A A W W W I N NN G G %
% DDDD R R A A W W IIIII N N GGG %
% %
% W W AAA N N DDDD %
% W W A A NN N D D %
% W W W AAAAA N N N D D %
% WW WW A A N NN D D %
% W W A A N N DDDD %
% %
% %
% MagickWand Image Vector Drawing Methods %
% %
% Software Design %
% Bob Friesenhahn %
% March 2002 %
% %
% %
% Copyright 1999-2020 ImageMagick Studio LLC, a non-profit organization %
% dedicated to making software imaging solutions freely available. %
% %
% You may not use this file except in compliance with the License. You may %
% obtain a copy of the License at %
% %
% https://imagemagick.org/script/license.php %
% %
% Unless required by applicable law or agreed to in writing, software %
% distributed under the License is distributed on an "AS IS" BASIS, %
% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. %
% See the License for the specific language governing permissions and %
% limitations under the License. %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
%
%
*/
/*
Include declarations.
*/
#include "MagickWand/studio.h"
#include "MagickWand/MagickWand.h"
#include "MagickWand/magick-wand-private.h"
#include "MagickWand/wand.h"
#include "MagickCore/string-private.h"
/*
Define declarations.
*/
#define DRAW_BINARY_IMPLEMENTATION 0
#define CurrentContext (wand->graphic_context[wand->index])
#define DrawingWandId "DrawingWand"
#define ThrowDrawException(severity,tag,reason) (void) ThrowMagickException( \
wand->exception,GetMagickModule(),severity,tag,"`%s'",reason);
/*
Typedef declarations.
*/
typedef enum
{
PathDefaultOperation,
PathCloseOperation, /* Z|z (none) */
PathCurveToOperation, /* C|c (x1 y1 x2 y2 x y)+ */
PathCurveToQuadraticBezierOperation, /* Q|q (x1 y1 x y)+ */
PathCurveToQuadraticBezierSmoothOperation, /* T|t (x y)+ */
PathCurveToSmoothOperation, /* S|s (x2 y2 x y)+ */
PathEllipticArcOperation, /* A|a (rx ry x-axis-rotation large-arc-flag sweep-flag x y)+ */
PathLineToHorizontalOperation, /* H|h x+ */
PathLineToOperation, /* L|l (x y)+ */
PathLineToVerticalOperation, /* V|v y+ */
PathMoveToOperation /* M|m (x y)+ */
} PathOperation;
typedef enum
{
DefaultPathMode,
AbsolutePathMode,
RelativePathMode
} PathMode;
struct _DrawingWand
{
size_t
id;
char
name[MagickPathExtent];
/* Support structures */
Image
*image;
ExceptionInfo
*exception;
/* MVG output string and housekeeping */
char
*mvg; /* MVG data */
size_t
mvg_alloc, /* total allocated memory */
mvg_length; /* total MVG length */
size_t
mvg_width; /* current line width */
/* Pattern support */
char
*pattern_id;
RectangleInfo
pattern_bounds;
size_t
pattern_offset;
/* Graphic wand */
size_t
index; /* array index */
DrawInfo
**graphic_context;
MagickBooleanType
filter_off; /* true if not filtering attributes */
/* Pretty-printing depth */
size_t
indent_depth; /* number of left-hand pad characters */
/* Path operation support */
PathOperation
path_operation;
PathMode
path_mode;
MagickBooleanType
destroy,
debug;
size_t
signature;
};
/*
Forward declarations.
*/
static int
MVGPrintf(DrawingWand *,const char *,...) wand_attribute((format
(printf,2,3))),
MVGAutoWrapPrintf(DrawingWand *,const char *,...) wand_attribute((format
(printf,2,3)));
static void
MVGAppendColor(DrawingWand *,const PixelInfo *);
/*
"Printf" for MVG commands
*/
static int MVGPrintf(DrawingWand *wand,const char *format,...)
{
size_t
extent;
assert(wand != (DrawingWand *) NULL);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",format);
assert(wand->signature == MagickWandSignature);
extent=20UL*MagickPathExtent;
if (wand->mvg == (char *) NULL)
{
wand->mvg=(char *) AcquireQuantumMemory(extent,sizeof(*wand->mvg));
if (wand->mvg == (char *) NULL)
{
ThrowDrawException(ResourceLimitError,"MemoryAllocationFailed",
wand->name);
return(-1);
}
wand->mvg_alloc=extent;
wand->mvg_length=0;
}
if (wand->mvg_alloc < (wand->mvg_length+10*MagickPathExtent))
{
extent+=wand->mvg_alloc;
wand->mvg=(char *) ResizeQuantumMemory(wand->mvg,extent,
sizeof(*wand->mvg));
if (wand->mvg == (char *) NULL)
{
ThrowDrawException(ResourceLimitError,"MemoryAllocationFailed",
wand->name);
return(-1);
}
wand->mvg_alloc=extent;
}
{
int
count;
ssize_t
offset;
va_list
argp;
while (wand->mvg_width < wand->indent_depth)
{
wand->mvg[wand->mvg_length]=' ';
wand->mvg_length++;
wand->mvg_width++;
}
wand->mvg[wand->mvg_length]='\0';
count=(-1);
offset=(ssize_t) wand->mvg_alloc-wand->mvg_length-1;
if (offset > 0)
{
va_start(argp,format);
#if defined(MAGICKCORE_HAVE_VSNPRINTF)
count=vsnprintf(wand->mvg+wand->mvg_length,(size_t) offset,format,argp);
#else
count=vsprintf(wand->mvg+wand->mvg_length,format,argp);
#endif
va_end(argp);
}
if ((count < 0) || (count > (int) offset))
ThrowDrawException(DrawError,"UnableToPrint",format)
else
{
wand->mvg_length+=count;
wand->mvg_width+=count;
}
wand->mvg[wand->mvg_length]='\0';
if ((wand->mvg_length > 1) && (wand->mvg[wand->mvg_length-1] == '\n'))
wand->mvg_width=0;
assert((wand->mvg_length+1) < wand->mvg_alloc);
return(count);
}
}
static int MVGAutoWrapPrintf(DrawingWand *wand,const char *format,...)
{
char
buffer[MagickPathExtent];
int
count;
va_list
argp;
va_start(argp,format);
#if defined(MAGICKCORE_HAVE_VSNPRINTF)
count=vsnprintf(buffer,sizeof(buffer)-1,format,argp);
#else
count=vsprintf(buffer,format,argp);
#endif
va_end(argp);
buffer[sizeof(buffer)-1]='\0';
if (count < 0)
ThrowDrawException(DrawError,"UnableToPrint",format)
else
{
if (((wand->mvg_width + count) > 78) && (buffer[count-1] != '\n'))
(void) MVGPrintf(wand, "\n");
(void) MVGPrintf(wand,"%s",buffer);
}
return(count);
}
static void MVGAppendColor(DrawingWand *wand,const PixelInfo *packet)
{
if ((packet->red == 0) && (packet->green == 0) && (packet->blue == 0) &&
(packet->alpha == (Quantum) TransparentAlpha))
(void) MVGPrintf(wand,"none");
else
{
char
tuple[MagickPathExtent];
PixelInfo
pixel;
GetPixelInfo(wand->image,&pixel);
pixel.colorspace=sRGBColorspace;
pixel.alpha_trait=packet->alpha != OpaqueAlpha ? BlendPixelTrait :
UndefinedPixelTrait;
pixel.red=(double) packet->red;
pixel.green=(double) packet->green;
pixel.blue=(double) packet->blue;
pixel.alpha=(double) packet->alpha;
GetColorTuple(&pixel,MagickTrue,tuple);
(void) MVGPrintf(wand,"%s",tuple);
}
}
static void MVGAppendPointsCommand(DrawingWand *wand,const char *command,
const size_t number_coordinates,const PointInfo *coordinates)
{
const PointInfo
*coordinate;
size_t
i;
(void) MVGPrintf(wand,"%s",command);
for (i=number_coordinates, coordinate=coordinates; i != 0; i--)
{
(void) MVGAutoWrapPrintf(wand," %.20g %.20g",coordinate->x,coordinate->y);
coordinate++;
}
(void) MVGPrintf(wand, "\n");
}
static void AdjustAffine(DrawingWand *wand,const AffineMatrix *affine)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if ((affine->sx != 1.0) || (affine->rx != 0.0) || (affine->ry != 0.0) ||
(affine->sy != 1.0) || (affine->tx != 0.0) || (affine->ty != 0.0))
{
AffineMatrix
current;
current=CurrentContext->affine;
CurrentContext->affine.sx=affine->sx*current.sx+affine->ry*current.rx;
CurrentContext->affine.rx=affine->rx*current.sx+affine->sy*current.rx;
CurrentContext->affine.ry=affine->sx*current.ry+affine->ry*current.sy;
CurrentContext->affine.sy=affine->rx*current.ry+affine->sy*current.sy;
CurrentContext->affine.tx=affine->sx*current.tx+affine->ry*current.ty+
affine->tx;
CurrentContext->affine.ty=affine->rx*current.tx+affine->sy*current.ty+
affine->ty;
}
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
+ A c q u i r e D r a w i n g W a n d %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% AcquireDrawingWand() allocates an initial drawing wand which is an opaque
% handle required by the remaining drawing methods.
%
% The format of the AcquireDrawingWand method is:
%
% DrawingWand AcquireDrawingWand(const DrawInfo *draw_info,Image *image)
%
% A description of each parameter follows:
%
% o draw_info: Initial drawing defaults. Set to NULL to use defaults.
%
% o image: the image to draw on.
%
*/
WandExport DrawingWand *AcquireDrawingWand(const DrawInfo *draw_info,
Image *image)
{
DrawingWand
*wand;
wand=NewDrawingWand();
if (draw_info != (const DrawInfo *) NULL)
{
CurrentContext=DestroyDrawInfo(CurrentContext);
CurrentContext=CloneDrawInfo((ImageInfo *) NULL,draw_info);
}
if (image != (Image *) NULL)
{
wand->image=DestroyImage(wand->image);
wand->destroy=MagickFalse;
}
wand->image=image;
return(wand);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% C l e a r D r a w i n g W a n d %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% ClearDrawingWand() clears resources associated with the drawing wand.
%
% The format of the ClearDrawingWand method is:
%
% void ClearDrawingWand(DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand to clear.
%
*/
WandExport void ClearDrawingWand(DrawingWand *wand)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
for ( ; wand->index > 0; wand->index--)
CurrentContext=DestroyDrawInfo(CurrentContext);
CurrentContext=DestroyDrawInfo(CurrentContext);
wand->graphic_context=(DrawInfo **) RelinquishMagickMemory(
wand->graphic_context);
if (wand->pattern_id != (char *) NULL)
wand->pattern_id=DestroyString(wand->pattern_id);
wand->mvg=DestroyString(wand->mvg);
if ((wand->destroy != MagickFalse) && (wand->image != (Image *) NULL))
wand->image=DestroyImage(wand->image);
else
wand->image=(Image *) NULL;
wand->mvg=(char *) NULL;
wand->mvg_alloc=0;
wand->mvg_length=0;
wand->mvg_width=0;
wand->pattern_id=(char *) NULL;
wand->pattern_offset=0;
wand->pattern_bounds.x=0;
wand->pattern_bounds.y=0;
wand->pattern_bounds.width=0;
wand->pattern_bounds.height=0;
wand->index=0;
wand->graphic_context=(DrawInfo **) AcquireMagickMemory(
sizeof(*wand->graphic_context));
if (wand->graphic_context == (DrawInfo **) NULL)
{
ThrowDrawException(ResourceLimitError,"MemoryAllocationFailed",
wand->name);
return;
}
CurrentContext=CloneDrawInfo((ImageInfo *) NULL,(DrawInfo *) NULL);
wand->filter_off=MagickTrue;
wand->indent_depth=0;
wand->path_operation=PathDefaultOperation;
wand->path_mode=DefaultPathMode;
wand->image=AcquireImage((const ImageInfo *) NULL,wand->exception);
ClearMagickException(wand->exception);
wand->destroy=MagickTrue;
wand->debug=IsEventLogging();
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% C l o n e D r a w i n g W a n d %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% CloneDrawingWand() makes an exact copy of the specified wand.
%
% The format of the CloneDrawingWand method is:
%
% DrawingWand *CloneDrawingWand(const DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the magick wand.
%
*/
WandExport DrawingWand *CloneDrawingWand(const DrawingWand *wand)
{
DrawingWand
*clone_wand;
register ssize_t
i;
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
clone_wand=(DrawingWand *) AcquireMagickMemory(sizeof(*clone_wand));
if (clone_wand == (DrawingWand *) NULL)
ThrowWandFatalException(ResourceLimitFatalError,
"MemoryAllocationFailed",GetExceptionMessage(errno));
(void) memset(clone_wand,0,sizeof(*clone_wand));
clone_wand->id=AcquireWandId();
(void) FormatLocaleString(clone_wand->name,MagickPathExtent,
"DrawingWand-%.20g",(double) clone_wand->id);
clone_wand->exception=AcquireExceptionInfo();
InheritException(clone_wand->exception,wand->exception);
clone_wand->mvg=AcquireString(wand->mvg);
clone_wand->mvg_length=strlen(clone_wand->mvg);
clone_wand->mvg_alloc=wand->mvg_length+1;
clone_wand->mvg_width=wand->mvg_width;
clone_wand->pattern_id=AcquireString(wand->pattern_id);
clone_wand->pattern_offset=wand->pattern_offset;
clone_wand->pattern_bounds=wand->pattern_bounds;
clone_wand->index=wand->index;
clone_wand->graphic_context=(DrawInfo **) AcquireQuantumMemory((size_t)
wand->index+1UL,sizeof(*wand->graphic_context));
if (clone_wand->graphic_context == (DrawInfo **) NULL)
ThrowWandFatalException(ResourceLimitFatalError,"MemoryAllocationFailed",
GetExceptionMessage(errno));
for (i=0; i <= (ssize_t) wand->index; i++)
clone_wand->graphic_context[i]=CloneDrawInfo((ImageInfo *) NULL,
wand->graphic_context[i]);
clone_wand->filter_off=wand->filter_off;
clone_wand->indent_depth=wand->indent_depth;
clone_wand->path_operation=wand->path_operation;
clone_wand->path_mode=wand->path_mode;
clone_wand->image=wand->image;
if (wand->image != (Image *) NULL)
clone_wand->image=CloneImage(wand->image,0,0,MagickTrue,
clone_wand->exception);
clone_wand->destroy=MagickTrue;
clone_wand->debug=IsEventLogging();
if (clone_wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",clone_wand->name);
clone_wand->signature=MagickWandSignature;
return(clone_wand);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D e s t r o y D r a w i n g W a n d %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DestroyDrawingWand() frees all resources associated with the drawing wand.
% Once the drawing wand has been freed, it should not be used and further
% unless it re-allocated.
%
% The format of the DestroyDrawingWand method is:
%
% DrawingWand *DestroyDrawingWand(DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand to destroy.
%
*/
WandExport DrawingWand *DestroyDrawingWand(DrawingWand *wand)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
for ( ; wand->index > 0; wand->index--)
CurrentContext=DestroyDrawInfo(CurrentContext);
CurrentContext=DestroyDrawInfo(CurrentContext);
wand->graphic_context=(DrawInfo **) RelinquishMagickMemory(
wand->graphic_context);
if (wand->pattern_id != (char *) NULL)
wand->pattern_id=DestroyString(wand->pattern_id);
wand->mvg=DestroyString(wand->mvg);
if ((wand->destroy != MagickFalse) && (wand->image != (Image *) NULL))
wand->image=DestroyImage(wand->image);
wand->image=(Image *) NULL;
wand->exception=DestroyExceptionInfo(wand->exception);
wand->signature=(~MagickWandSignature);
RelinquishWandId(wand->id);
wand=(DrawingWand *) RelinquishMagickMemory(wand);
return(wand);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w A f f i n e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% 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 *wand,const AffineMatrix *affine)
%
% A description of each parameter follows:
%
% o wand: Drawing wand
%
% o affine: Affine matrix parameters
%
*/
WandExport void DrawAffine(DrawingWand *wand,const AffineMatrix *affine)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
assert(affine != (const AffineMatrix *) NULL);
AdjustAffine(wand,affine);
(void) MVGPrintf(wand,"affine %.20g %.20g %.20g %.20g %.20g %.20g\n",
affine->sx,affine->rx,affine->ry,affine->sy,affine->tx,affine->ty);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w A l p h a %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawAlpha() paints on the image's alpha channel in order to set effected
% pixels to transparent. 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 DrawAlpha method is:
%
% void DrawAlpha(DrawingWand *wand,const double x,const double y,
% const PaintMethod paint_method)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o x: x ordinate
%
% o y: y ordinate
%
% o paint_method: paint method.
%
*/
WandExport void DrawAlpha(DrawingWand *wand,const double x,const double y,
const PaintMethod paint_method)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
(void) MVGPrintf(wand,"alpha %.20g %.20g '%s'\n",x,y,CommandOptionToMnemonic(
MagickMethodOptions,(ssize_t) paint_method));
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w A n n o t a t i o n %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawAnnotation() draws text on the image.
%
% The format of the DrawAnnotation method is:
%
% void DrawAnnotation(DrawingWand *wand,const double x,
% const double y,const unsigned char *text)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o x: x ordinate to left of text
%
% o y: y ordinate to text baseline
%
% o text: text to draw
%
*/
WandExport void DrawAnnotation(DrawingWand *wand,const double x,const double y,
const unsigned char *text)
{
char
*escaped_text;
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
assert(text != (const unsigned char *) NULL);
escaped_text=EscapeString((const char *) text,'\'');
if (escaped_text != (char *) NULL)
{
(void) MVGPrintf(wand,"text %.20g %.20g '%s'\n",x,y,escaped_text);
escaped_text=DestroyString(escaped_text);
}
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w A r c %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawArc() draws an arc falling within a specified bounding rectangle on the
% image.
%
% The format of the DrawArc method is:
%
% void DrawArc(DrawingWand *wand,const double sx,const double sy,
% const double ex,const double ey,const double sd,const double ed)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o sx: starting x ordinate of bounding rectangle
%
% o sy: starting y ordinate of bounding rectangle
%
% o ex: ending x ordinate of bounding rectangle
%
% o ey: ending y ordinate of bounding rectangle
%
% o sd: starting degrees of rotation
%
% o ed: ending degrees of rotation
%
*/
WandExport void DrawArc(DrawingWand *wand,const double sx,const double sy,
const double ex,const double ey,const double sd,const double ed)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
(void) MVGPrintf(wand,"arc %.20g %.20g %.20g %.20g %.20g %.20g\n",sx,sy,ex,
ey,sd,ed);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w B e z i e r %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawBezier() draws a bezier curve through a set of points on the image.
%
% The format of the DrawBezier method is:
%
% void DrawBezier(DrawingWand *wand,
% const size_t number_coordinates,const PointInfo *coordinates)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o number_coordinates: number of coordinates
%
% o coordinates: coordinates
%
*/
WandExport void DrawBezier(DrawingWand *wand,
const size_t number_coordinates,const PointInfo *coordinates)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
assert(coordinates != (const PointInfo *) NULL);
MVGAppendPointsCommand(wand,"bezier",number_coordinates,coordinates);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w C i r c l e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawCircle() draws a circle on the image.
%
% The format of the DrawCircle method is:
%
% void DrawCircle(DrawingWand *wand,const double ox,
% const double oy,const double px, const double py)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o ox: origin x ordinate
%
% o oy: origin y ordinate
%
% o px: perimeter x ordinate
%
% o py: perimeter y ordinate
%
*/
WandExport void DrawCircle(DrawingWand *wand,const double ox,const double oy,
const double px,const double py)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
(void) MVGPrintf(wand,"circle %.20g %.20g %.20g %.20g\n",ox,oy,px,py);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w C l e a r E x c e p t i o n %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawClearException() clear any exceptions associated with the wand.
%
% The format of the DrawClearException method is:
%
% MagickBooleanType DrawClearException(DrawWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport MagickBooleanType DrawClearException(DrawingWand *wand)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
ClearMagickException(wand->exception);
return(MagickTrue);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w C l o n e E x c e p t i o n I n f o %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawCloneExceptionInfo() clones the ExceptionInfo structure within the wand.
%
% The format of the DrawCloneExceptionInfo method is:
%
% ExceptionInfo *DrawCloneExceptionInfo(DrawWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport ExceptionInfo *DrawCloneExceptionInfo(const DrawingWand *wand)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->exception == (ExceptionInfo*) NULL)
return (ExceptionInfo*) NULL;
return CloneExceptionInfo(wand->exception);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w C o l o r %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% 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.
% ResetMethod: Recolor all pixels.
%
% The format of the DrawColor method is:
%
% void DrawColor(DrawingWand *wand,const double x,const double y,
% const PaintMethod paint_method)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o x: x ordinate.
%
% o y: y ordinate.
%
% o paint_method: paint method.
%
*/
WandExport void DrawColor(DrawingWand *wand, const double x, const double y,
const PaintMethod paint_method)
{
assert(wand != (DrawingWand *)NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent, GetMagickModule(), "%s", wand->name);
(void) MVGPrintf(wand, "color %.20g %.20g '%s'\n",x,y,CommandOptionToMnemonic(
MagickMethodOptions,(ssize_t) paint_method));
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w C o m p o s i t e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% 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:
%
% MagickBooleanType DrawComposite(DrawingWand *wand,
% const CompositeOperator compose,const double x,
% const double y,const double width,const double height,
% MagickWand *magick_wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o compose: composition operator
%
% o x: x ordinate of top left corner
%
% o y: y ordinate of top left corner
%
% o width: Width to resize image to prior to compositing. Specify zero to
% use existing width.
%
% o height: Height to resize image to prior to compositing. Specify zero
% to use existing height.
%
% o magick_wand: Image to composite is obtained from this wand.
%
*/
WandExport MagickBooleanType DrawComposite(DrawingWand *wand,
const CompositeOperator compose,const double x,const double y,
const double width,const double height,MagickWand *magick_wand)
{
char
*base64,
*media_type;
const char
*mode;
ImageInfo
*image_info;
Image
*clone_image,
*image;
register char
*p;
register ssize_t
i;
size_t
blob_length,
encoded_length;
unsigned char
*blob;
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
assert(magick_wand != (MagickWand *) NULL);
image=GetImageFromMagickWand(magick_wand);
if (image == (Image *) NULL)
return(MagickFalse);
clone_image=CloneImage(image,0,0,MagickTrue,wand->exception);
if (clone_image == (Image *) NULL)
return(MagickFalse);
image_info=AcquireImageInfo();
(void) CopyMagickString(image_info->magick,"MIFF",MagickPathExtent);
blob_length=2048;
blob=(unsigned char *) ImageToBlob(image_info,clone_image,&blob_length,
wand->exception);
image_info=DestroyImageInfo(image_info);
clone_image=DestroyImageList(clone_image);
if (blob == (void *) NULL)
return(MagickFalse);
encoded_length=0;
base64=Base64Encode(blob,blob_length,&encoded_length);
blob=(unsigned char *) RelinquishMagickMemory(blob);
if (base64 == (char *) NULL)
{
char
buffer[MagickPathExtent];
(void) FormatLocaleString(buffer,MagickPathExtent,"%.20g bytes",(double)
(4L*blob_length/3L+4L));
ThrowDrawException(ResourceLimitWarning,"MemoryAllocationFailed",
wand->name);
return(MagickFalse);
}
mode=CommandOptionToMnemonic(MagickComposeOptions,(ssize_t) compose);
media_type=MagickToMime(image->magick);
(void) MVGPrintf(wand,"image %s %.20g %.20g %.20g %.20g 'data:%s;base64,\n",
mode,x,y,width,height,media_type);
p=base64;
for (i=(ssize_t) encoded_length; i > 0; i-=76)
{
(void) MVGPrintf(wand,"%.76s",p);
p+=76;
if (i > 76)
(void) MVGPrintf(wand,"\n");
}
(void) MVGPrintf(wand,"'\n");
media_type=DestroyString(media_type);
base64=DestroyString(base64);
return(MagickTrue);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w C o m m e n t %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawComment() adds a comment to a vector output stream.
%
% The format of the DrawComment method is:
%
% void DrawComment(DrawingWand *wand,const char *comment)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o comment: comment text
%
*/
WandExport void DrawComment(DrawingWand *wand,const char *comment)
{
(void) MVGPrintf(wand,"#%s\n",comment);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w E l l i p s e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawEllipse() draws an ellipse on the image.
%
% The format of the DrawEllipse method is:
%
% void DrawEllipse(DrawingWand *wand,const double ox,const double oy,
% const double rx,const double ry,const double start,const double end)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o ox: origin x ordinate
%
% o oy: origin y ordinate
%
% o rx: radius in x
%
% o ry: radius in y
%
% o start: starting rotation in degrees
%
% o end: ending rotation in degrees
%
*/
WandExport void DrawEllipse(DrawingWand *wand,const double ox,const double oy,
const double rx,const double ry,const double start,const double end)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
(void) MVGPrintf(wand,"ellipse %.20g %.20g %.20g %.20g %.20g %.20g\n",ox,oy,
rx,ry,start,end);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t B o r d e r C o l o r %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetBorderColor() returns the border color used for drawing bordered
% objects.
%
% The format of the DrawGetBorderColor method is:
%
% void DrawGetBorderColor(const DrawingWand *wand,
% PixelWand *border_color)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o border_color: Return the border color.
%
*/
WandExport void DrawGetBorderColor(const DrawingWand *wand,
PixelWand *border_color)
{
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
assert(border_color != (PixelWand *) NULL);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
PixelSetPixelColor(border_color,&CurrentContext->border_color);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t C l i p P a t h %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% 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 *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport char *DrawGetClipPath(const DrawingWand *wand)
{
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if (CurrentContext->clip_mask != (char *) NULL)
return((char *) AcquireString(CurrentContext->clip_mask));
return((char *) NULL);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t C l i p R u l e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% 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 *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport FillRule DrawGetClipRule(const DrawingWand *wand)
{
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
return(CurrentContext->fill_rule);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t C l i p U n i t s %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetClipUnits() returns the interpretation of clip path units.
%
% The format of the DrawGetClipUnits method is:
%
% ClipPathUnits DrawGetClipUnits(const DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport ClipPathUnits DrawGetClipUnits(const DrawingWand *wand)
{
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
return(CurrentContext->clip_units);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t D e n s i t y %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetDensity() obtains the vertical and horizontal resolution. The value
% returned must be deallocated by the user when it is no longer needed.
%
% The format of the DrawGetDensity method is:
%
% char *DrawGetDensity(const DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport char *DrawGetDensity(const DrawingWand *wand)
{
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if (CurrentContext->density != (char *) NULL)
return((char *) AcquireString(CurrentContext->density));
return((char *) NULL);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t E x c e p t i o n %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetException() returns the severity, reason, and description of any
% error that occurs when using other methods in this API.
%
% The format of the DrawGetException method is:
%
% char *DrawGetException(const DrawWand *wand,
% ExceptionType *severity)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o severity: the severity of the error is returned here.
%
*/
WandExport char *DrawGetException(const DrawingWand *wand,
ExceptionType *severity)
{
char
*description;
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
assert(severity != (ExceptionType *) NULL);
*severity=wand->exception->severity;
description=(char *) AcquireQuantumMemory(2UL*MagickPathExtent,
sizeof(*description));
if (description == (char *) NULL)
ThrowWandFatalException(ResourceLimitFatalError,"MemoryAllocationFailed",
wand->name);
*description='\0';
if (wand->exception->reason != (char *) NULL)
(void) CopyMagickString(description,GetLocaleExceptionMessage(
wand->exception->severity,wand->exception->reason),
MagickPathExtent);
if (wand->exception->description != (char *) NULL)
{
(void) ConcatenateMagickString(description," (",MagickPathExtent);
(void) ConcatenateMagickString(description,GetLocaleExceptionMessage(
wand->exception->severity,wand->exception->description),
MagickPathExtent);
(void) ConcatenateMagickString(description,")",MagickPathExtent);
}
return(description);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% P i x e l G e t E x c e p t i o n T y p e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetExceptionType() the exception type associated with the wand. If
% no exception has occurred, UndefinedExceptionType is returned.
%
% The format of the DrawGetExceptionType method is:
%
% ExceptionType DrawGetExceptionType(const DrawWand *wand)
%
% A description of each parameter follows:
%
% o wand: the magick wand.
%
*/
WandExport ExceptionType DrawGetExceptionType(const DrawingWand *wand)
{
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
return(wand->exception->severity);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t F i l l C o l o r %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetFillColor() returns the fill color used for drawing filled objects.
%
% The format of the DrawGetFillColor method is:
%
% void DrawGetFillColor(const DrawingWand *wand,
% PixelWand *fill_color)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o fill_color: Return the fill color.
%
*/
WandExport void DrawGetFillColor(const DrawingWand *wand,PixelWand *fill_color)
{
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
assert(fill_color != (PixelWand *) NULL);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
PixelSetPixelColor(fill_color,&CurrentContext->fill);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t F i l l O p a c i t y %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetFillOpacity() returns the alpha 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 *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport double DrawGetFillOpacity(const DrawingWand *wand)
{
double
alpha;
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
alpha=(double) QuantumScale*CurrentContext->fill.alpha;
return(alpha);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t F i l l R u l e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetFillRule() returns the fill rule used while drawing polygons.
%
% The format of the DrawGetFillRule method is:
%
% FillRule DrawGetFillRule(const DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport FillRule DrawGetFillRule(const DrawingWand *wand)
{
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
return(CurrentContext->fill_rule);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t F o n t %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% 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 *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport char *DrawGetFont(const DrawingWand *wand)
{
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if (CurrentContext->font != (char *) NULL)
return(AcquireString(CurrentContext->font));
return((char *) NULL);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t F o n t F a m i l y %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% 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 *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport char *DrawGetFontFamily(const DrawingWand *wand)
{
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if (CurrentContext->family != NULL)
return(AcquireString(CurrentContext->family));
return((char *) NULL);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t F o n t R e s o l u t i o n %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetFontResolution() gets the image X and Y resolution.
%
% The format of the DrawGetFontResolution method is:
%
% MagickBooleanType DrawGetFontResolution(const DrawingWand *wand,
% double *x,double *y)
%
% A description of each parameter follows:
%
% o wand: the magick wand.
%
% o x: the x-resolution.
%
% o y: the y-resolution.
%
*/
WandExport MagickBooleanType DrawGetFontResolution(const DrawingWand *wand,
double *x,double *y)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
*x=72.0;
*y=72.0;
if (CurrentContext->density != (char *) NULL)
{
GeometryInfo
geometry_info;
MagickStatusType
flags;
flags=ParseGeometry(CurrentContext->density,&geometry_info);
*x=geometry_info.rho;
*y=geometry_info.sigma;
if ((flags & SigmaValue) == MagickFalse)
*y=(*x);
}
return(MagickTrue);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t F o n t S i z e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetFontSize() returns the font pointsize used when annotating with text.
%
% The format of the DrawGetFontSize method is:
%
% double DrawGetFontSize(const DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport double DrawGetFontSize(const DrawingWand *wand)
{
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
return(CurrentContext->pointsize);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t F o n t S t r e t c h %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetFontStretch() returns the font stretch used when annotating with text.
%
% The format of the DrawGetFontStretch method is:
%
% StretchType DrawGetFontStretch(const DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport StretchType DrawGetFontStretch(const DrawingWand *wand)
{
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
return(CurrentContext->stretch);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t F o n t S t y l e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetFontStyle() returns the font style used when annotating with text.
%
% The format of the DrawGetFontStyle method is:
%
% StyleType DrawGetFontStyle(const DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport StyleType DrawGetFontStyle(const DrawingWand *wand)
{
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
return(CurrentContext->style);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t F o n t W e i g h t %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetFontWeight() returns the font weight used when annotating with text.
%
% The format of the DrawGetFontWeight method is:
%
% size_t DrawGetFontWeight(const DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport size_t DrawGetFontWeight(const DrawingWand *wand)
{
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
return(CurrentContext->weight);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t G r a v i t y %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetGravity() returns the text placement gravity used when annotating
% with text.
%
% The format of the DrawGetGravity method is:
%
% GravityType DrawGetGravity(const DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport GravityType DrawGetGravity(const DrawingWand *wand)
{
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
return(CurrentContext->gravity);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t O p a c i t y %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetOpacity() returns the alpha used when drawing with the fill
% or stroke color or texture. Fully opaque is 1.0.
%
% The format of the DrawGetOpacity method is:
%
% double DrawGetOpacity(const DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport double DrawGetOpacity(const DrawingWand *wand)
{
double
alpha;
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
alpha=(double) QuantumScale*CurrentContext->alpha;
return(alpha);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t S t r o k e A n t i a l i a s %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetStrokeAntialias() returns the current stroke antialias setting.
% Stroked outlines are antialiased by default. When antialiasing is disabled
% stroked pixels are thresholded to determine if the stroke color or
% underlying canvas color should be used.
%
% The format of the DrawGetStrokeAntialias method is:
%
% MagickBooleanType DrawGetStrokeAntialias(const DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport MagickBooleanType DrawGetStrokeAntialias(const DrawingWand *wand)
{
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
return(CurrentContext->stroke_antialias);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t S t r o k e C o l o r %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetStrokeColor() returns the color used for stroking object outlines.
%
% The format of the DrawGetStrokeColor method is:
%
% void DrawGetStrokeColor(const DrawingWand *wand,
% PixelWand *stroke_color)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o stroke_color: Return the stroke color.
%
*/
WandExport void DrawGetStrokeColor(const DrawingWand *wand,
PixelWand *stroke_color)
{
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
assert(stroke_color != (PixelWand *) NULL);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
PixelSetPixelColor(stroke_color,&CurrentContext->stroke);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t S t r o k e D a s h A r r a y %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetStrokeDashArray() returns an array representing the pattern of
% dashes and gaps used to stroke paths (see DrawSetStrokeDashArray). The
% array must be freed once it is no longer required by the user.
%
% The format of the DrawGetStrokeDashArray method is:
%
% double *DrawGetStrokeDashArray(const DrawingWand *wand,
% size_t *number_elements)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o number_elements: address to place number of elements in dash array
%
*/
WandExport double *DrawGetStrokeDashArray(const DrawingWand *wand,
size_t *number_elements)
{
double
*dasharray;
register const double
*p;
register double
*q;
register ssize_t
i;
size_t
n;
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
assert(number_elements != (size_t *) NULL);
n=0;
p=CurrentContext->dash_pattern;
if (p != (const double *) NULL)
while (fabs(*p++) >= MagickEpsilon)
n++;
*number_elements=n;
dasharray=(double *) NULL;
if (n != 0)
{
dasharray=(double *) AcquireQuantumMemory((size_t) n+1UL,
sizeof(*dasharray));
if (dasharray != (double *) NULL)
{
p=CurrentContext->dash_pattern;
q=dasharray;
for (i=0; i < (ssize_t) n; i++)
*q++=(*p++);
*q=0.0;
}
}
return(dasharray);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t S t r o k e D a s h O f f s e t %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetStrokeDashOffset() returns the offset into the dash pattern to
% start the dash.
%
% The format of the DrawGetStrokeDashOffset method is:
%
% double DrawGetStrokeDashOffset(const DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport double DrawGetStrokeDashOffset(const DrawingWand *wand)
{
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
return(CurrentContext->dash_offset);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t S t r o k e L i n e C a p %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetStrokeLineCap() returns the shape to be used at the end of
% open subpaths when they are stroked. Values of LineCap are
% UndefinedCap, ButtCap, RoundCap, and SquareCap.
%
% The format of the DrawGetStrokeLineCap method is:
%
% LineCap DrawGetStrokeLineCap(const DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport LineCap DrawGetStrokeLineCap(const DrawingWand *wand)
{
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
return(CurrentContext->linecap);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t S t r o k e L i n e J o i n %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetStrokeLineJoin() returns 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.
%
% The format of the DrawGetStrokeLineJoin method is:
%
% LineJoin DrawGetStrokeLineJoin(const DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport LineJoin DrawGetStrokeLineJoin(const DrawingWand *wand)
{
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
return(CurrentContext->linejoin);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t S t r o k e M i t e r L i m i t %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetStrokeMiterLimit() returns the 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 format of the DrawGetStrokeMiterLimit method is:
%
% size_t DrawGetStrokeMiterLimit(const DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport size_t DrawGetStrokeMiterLimit(const DrawingWand *wand)
{
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
return CurrentContext->miterlimit;
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t S t r o k e O p a c i t y %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetStrokeOpacity() returns the alpha of stroked object outlines.
%
% The format of the DrawGetStrokeOpacity method is:
%
% double DrawGetStrokeOpacity(const DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport double DrawGetStrokeOpacity(const DrawingWand *wand)
{
double
alpha;
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
alpha=(double) QuantumScale*CurrentContext->stroke.alpha;
return(alpha);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t S t r o k e W i d t h %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetStrokeWidth() returns the width of the stroke used to draw object
% outlines.
%
% The format of the DrawGetStrokeWidth method is:
%
% double DrawGetStrokeWidth(const DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport double DrawGetStrokeWidth(const DrawingWand *wand)
{
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
return(CurrentContext->stroke_width);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t T e x t A l i g n m e n t %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetTextAlignment() returns the alignment applied when annotating with
% text.
%
% The format of the DrawGetTextAlignment method is:
%
% AlignType DrawGetTextAlignment(const DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport AlignType DrawGetTextAlignment(const DrawingWand *wand)
{
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
return(CurrentContext->align);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t T e x t A n t i a l i a s %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetTextAntialias() returns the current text antialias setting, which
% determines whether text is antialiased. Text is antialiased by default.
%
% The format of the DrawGetTextAntialias method is:
%
% MagickBooleanType DrawGetTextAntialias(const DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport MagickBooleanType DrawGetTextAntialias(const DrawingWand *wand)
{
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
return(CurrentContext->text_antialias);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t T e x t D e c o r a t i o n %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetTextDecoration() returns the decoration applied when annotating with
% text.
%
% The format of the DrawGetTextDecoration method is:
%
% DecorationType DrawGetTextDecoration(const DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport DecorationType DrawGetTextDecoration(const DrawingWand *wand)
{
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
return(CurrentContext->decorate);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t T e x t D i r e c t i o n %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetTextDirection() returns the direction that will be used when
% annotating with text.
%
% The format of the DrawGetTextDirection method is:
%
% DirectionType DrawGetTextDirection(const DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport DirectionType DrawGetTextDirection(const DrawingWand *wand)
{
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
return(CurrentContext->direction);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t T e x t E n c o d i n g %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetTextEncoding() returns a null-terminated string which specifies the
% code set used for text annotations. The string must be freed by the user
% once it is no longer required.
%
% The format of the DrawGetTextEncoding method is:
%
% char *DrawGetTextEncoding(const DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport char *DrawGetTextEncoding(const DrawingWand *wand)
{
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if (CurrentContext->encoding != (char *) NULL)
return((char *) AcquireString(CurrentContext->encoding));
return((char *) NULL);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t T e x t K e r n i n g %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetTextKerning() gets the spacing between characters in text.
%
% The format of the DrawSetFontKerning method is:
%
% double DrawGetTextKerning(DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport double DrawGetTextKerning(DrawingWand *wand)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
return(CurrentContext->kerning);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t T e x t I n t e r l i n e S p a c i n g %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetTextInterlineSpacing() gets the spacing between lines in text.
%
% The format of the DrawGetTextInterlineSpacing method is:
%
% double DrawGetTextInterlineSpacing(DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport double DrawGetTextInterlineSpacing(DrawingWand *wand)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
return(CurrentContext->interline_spacing);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t T e x t I n t e r w o r d S p a c i n g %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetTextInterwordSpacing() gets the spacing between words in text.
%
% The format of the DrawSetFontKerning method is:
%
% double DrawGetTextInterwordSpacing(DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport double DrawGetTextInterwordSpacing(DrawingWand *wand)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
return(CurrentContext->interword_spacing);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t T y p e M e t r i c s %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetTypeMetrics() returns the following information for the specified
% font and text:
%
% character width
% character height
% ascender
% descender
% text width
% text height
% maximum horizontal advance
% bounds: x1
% bounds: y1
% bounds: x2
% bounds: y2
% origin: x
% origin: y
% underline position
% underline thickness
%
% The format of the DrawGetTypeMetrics method is:
%
% MagickBooleanType DrawGetTypeMetrics(const DrawingWand *wand,
% const char *text,MagickBooleanType ignore_newlines,
$ TypeMetric *metrics)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o text: text to draw.
%
% o metrics: Return the font metrics in this structure.
%
% o ignore_newlines: indicates whether newlines should be ignored.
%
% o metrics: Return the font metrics in this structure.
%
*/
WandExport MagickBooleanType DrawGetTypeMetrics(const DrawingWand *wand,
const char *text,MagickBooleanType ignore_newlines,TypeMetric *metrics)
{
DrawInfo
*draw_info;
MagickBooleanType
status;
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
draw_info=PeekDrawingWand(wand);
if (draw_info == (DrawInfo *) NULL)
return(MagickFalse);
(void) CloneString(&draw_info->text,text);
if (ignore_newlines != MagickFalse)
status=GetTypeMetrics(wand->image,draw_info,metrics,wand->exception);
else
status=GetMultilineTypeMetrics(wand->image,draw_info,metrics,
wand->exception);
draw_info=DestroyDrawInfo(draw_info);
return(status);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t V e c t o r G r a p h i c s %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetVectorGraphics() returns a null-terminated string which specifies the
% vector graphics generated by any graphics calls made since the wand was
% instantiated. The string must be freed by the user once it is no longer
% required.
%
% The format of the DrawGetVectorGraphics method is:
%
% char *DrawGetVectorGraphics(DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport char *DrawGetVectorGraphics(DrawingWand *wand)
{
char
value[MagickPathExtent],
*xml;
PixelInfo
pixel;
register ssize_t
i;
XMLTreeInfo
*child,
*xml_info;
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
xml_info=NewXMLTreeTag("drawing-wand");
if (xml_info == (XMLTreeInfo *) NULL)
return((char *) NULL);
(void) SetXMLTreeContent(xml_info," ");
GetPixelInfo(wand->image,&pixel);
child=AddChildToXMLTree(xml_info,"clip-path",0);
if (child != (XMLTreeInfo *) NULL)
(void) SetXMLTreeContent(child,CurrentContext->clip_mask);
child=AddChildToXMLTree(xml_info,"clip-units",0);
if (child != (XMLTreeInfo *) NULL)
{
(void) CopyMagickString(value,CommandOptionToMnemonic(
MagickClipPathOptions,(ssize_t) CurrentContext->clip_units),
MagickPathExtent);
(void) SetXMLTreeContent(child,value);
}
child=AddChildToXMLTree(xml_info,"decorate",0);
if (child != (XMLTreeInfo *) NULL)
{
(void) CopyMagickString(value,CommandOptionToMnemonic(
MagickDecorateOptions,(ssize_t) CurrentContext->decorate),
MagickPathExtent);
(void) SetXMLTreeContent(child,value);
}
child=AddChildToXMLTree(xml_info,"encoding",0);
if (child != (XMLTreeInfo *) NULL)
(void) SetXMLTreeContent(child,CurrentContext->encoding);
child=AddChildToXMLTree(xml_info,"fill",0);
if (child != (XMLTreeInfo *) NULL)
{
if (CurrentContext->fill.alpha != OpaqueAlpha)
pixel.alpha_trait=CurrentContext->fill.alpha != OpaqueAlpha ?
BlendPixelTrait : UndefinedPixelTrait;
pixel=CurrentContext->fill;
GetColorTuple(&pixel,MagickTrue,value);
(void) SetXMLTreeContent(child,value);
}
child=AddChildToXMLTree(xml_info,"fill-opacity",0);
if (child != (XMLTreeInfo *) NULL)
{
(void) FormatLocaleString(value,MagickPathExtent,"%.20g",
(double) (QuantumScale*CurrentContext->fill.alpha));
(void) SetXMLTreeContent(child,value);
}
child=AddChildToXMLTree(xml_info,"fill-rule",0);
if (child != (XMLTreeInfo *) NULL)
{
(void) CopyMagickString(value,CommandOptionToMnemonic(
MagickFillRuleOptions,(ssize_t) CurrentContext->fill_rule),
MagickPathExtent);
(void) SetXMLTreeContent(child,value);
}
child=AddChildToXMLTree(xml_info,"font",0);
if (child != (XMLTreeInfo *) NULL)
(void) SetXMLTreeContent(child,CurrentContext->font);
child=AddChildToXMLTree(xml_info,"font-family",0);
if (child != (XMLTreeInfo *) NULL)
(void) SetXMLTreeContent(child,CurrentContext->family);
child=AddChildToXMLTree(xml_info,"font-size",0);
if (child != (XMLTreeInfo *) NULL)
{
(void) FormatLocaleString(value,MagickPathExtent,"%.20g",
CurrentContext->pointsize);
(void) SetXMLTreeContent(child,value);
}
child=AddChildToXMLTree(xml_info,"font-stretch",0);
if (child != (XMLTreeInfo *) NULL)
{
(void) CopyMagickString(value,CommandOptionToMnemonic(
MagickStretchOptions,(ssize_t) CurrentContext->stretch),
MagickPathExtent);
(void) SetXMLTreeContent(child,value);
}
child=AddChildToXMLTree(xml_info,"font-style",0);
if (child != (XMLTreeInfo *) NULL)
{
(void) CopyMagickString(value,CommandOptionToMnemonic(
MagickStyleOptions,(ssize_t) CurrentContext->style),MagickPathExtent);
(void) SetXMLTreeContent(child,value);
}
child=AddChildToXMLTree(xml_info,"font-weight",0);
if (child != (XMLTreeInfo *) NULL)
{
(void) FormatLocaleString(value,MagickPathExtent,"%.20g",(double)
CurrentContext->weight);
(void) SetXMLTreeContent(child,value);
}
child=AddChildToXMLTree(xml_info,"gravity",0);
if (child != (XMLTreeInfo *) NULL)
{
(void) CopyMagickString(value,CommandOptionToMnemonic(
MagickGravityOptions,(ssize_t) CurrentContext->gravity),
MagickPathExtent);
(void) SetXMLTreeContent(child,value);
}
child=AddChildToXMLTree(xml_info,"stroke",0);
if (child != (XMLTreeInfo *) NULL)
{
if (CurrentContext->stroke.alpha != OpaqueAlpha)
pixel.alpha_trait=CurrentContext->stroke.alpha != OpaqueAlpha ?
BlendPixelTrait : UndefinedPixelTrait;
pixel=CurrentContext->stroke;
GetColorTuple(&pixel,MagickTrue,value);
(void) SetXMLTreeContent(child,value);
}
child=AddChildToXMLTree(xml_info,"stroke-antialias",0);
if (child != (XMLTreeInfo *) NULL)
{
(void) FormatLocaleString(value,MagickPathExtent,"%d",
CurrentContext->stroke_antialias != MagickFalse ? 1 : 0);
(void) SetXMLTreeContent(child,value);
}
child=AddChildToXMLTree(xml_info,"stroke-dasharray",0);
if ((child != (XMLTreeInfo *) NULL) &&
(CurrentContext->dash_pattern != (double *) NULL))
{
char
*dash_pattern;
dash_pattern=AcquireString((char *) NULL);
for (i=0; fabs(CurrentContext->dash_pattern[i]) >= MagickEpsilon; i++)
{
if (i != 0)
(void) ConcatenateString(&dash_pattern,",");
(void) FormatLocaleString(value,MagickPathExtent,"%.20g",
CurrentContext->dash_pattern[i]);
(void) ConcatenateString(&dash_pattern,value);
}
(void) SetXMLTreeContent(child,dash_pattern);
dash_pattern=DestroyString(dash_pattern);
}
child=AddChildToXMLTree(xml_info,"stroke-dashoffset",0);
if (child != (XMLTreeInfo *) NULL)
{
(void) FormatLocaleString(value,MagickPathExtent,"%.20g",
CurrentContext->dash_offset);
(void) SetXMLTreeContent(child,value);
}
child=AddChildToXMLTree(xml_info,"stroke-linecap",0);
if (child != (XMLTreeInfo *) NULL)
{
(void) CopyMagickString(value,CommandOptionToMnemonic(
MagickLineCapOptions,(ssize_t) CurrentContext->linecap),
MagickPathExtent);
(void) SetXMLTreeContent(child,value);
}
child=AddChildToXMLTree(xml_info,"stroke-linejoin",0);
if (child != (XMLTreeInfo *) NULL)
{
(void) CopyMagickString(value,CommandOptionToMnemonic(
MagickLineJoinOptions,(ssize_t) CurrentContext->linejoin),
MagickPathExtent);
(void) SetXMLTreeContent(child,value);
}
child=AddChildToXMLTree(xml_info,"stroke-miterlimit",0);
if (child != (XMLTreeInfo *) NULL)
{
(void) FormatLocaleString(value,MagickPathExtent,"%.20g",(double)
CurrentContext->miterlimit);
(void) SetXMLTreeContent(child,value);
}
child=AddChildToXMLTree(xml_info,"stroke-opacity",0);
if (child != (XMLTreeInfo *) NULL)
{
(void) FormatLocaleString(value,MagickPathExtent,"%.20g",
(double) (QuantumScale*CurrentContext->stroke.alpha));
(void) SetXMLTreeContent(child,value);
}
child=AddChildToXMLTree(xml_info,"stroke-width",0);
if (child != (XMLTreeInfo *) NULL)
{
(void) FormatLocaleString(value,MagickPathExtent,"%.20g",
CurrentContext->stroke_width);
(void) SetXMLTreeContent(child,value);
}
child=AddChildToXMLTree(xml_info,"text-align",0);
if (child != (XMLTreeInfo *) NULL)
{
(void) CopyMagickString(value,CommandOptionToMnemonic(MagickAlignOptions,
(ssize_t) CurrentContext->align),MagickPathExtent);
(void) SetXMLTreeContent(child,value);
}
child=AddChildToXMLTree(xml_info,"text-antialias",0);
if (child != (XMLTreeInfo *) NULL)
{
(void) FormatLocaleString(value,MagickPathExtent,"%d",
CurrentContext->text_antialias != MagickFalse ? 1 : 0);
(void) SetXMLTreeContent(child,value);
}
child=AddChildToXMLTree(xml_info,"text-undercolor",0);
if (child != (XMLTreeInfo *) NULL)
{
if (CurrentContext->undercolor.alpha != OpaqueAlpha)
pixel.alpha_trait=CurrentContext->undercolor.alpha != OpaqueAlpha ?
BlendPixelTrait : UndefinedPixelTrait;
pixel=CurrentContext->undercolor;
GetColorTuple(&pixel,MagickTrue,value);
(void) SetXMLTreeContent(child,value);
}
child=AddChildToXMLTree(xml_info,"vector-graphics",0);
if (child != (XMLTreeInfo *) NULL)
(void) SetXMLTreeContent(child,wand->mvg);
xml=XMLTreeInfoToXML(xml_info);
xml_info=DestroyXMLTree(xml_info);
return(xml);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w G e t T e x t U n d e r C o l o r %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawGetTextUnderColor() returns the color of a background rectangle
% to place under text annotations.
%
% The format of the DrawGetTextUnderColor method is:
%
% void DrawGetTextUnderColor(const DrawingWand *wand,
% PixelWand *under_color)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o under_color: Return the under color.
%
*/
WandExport void DrawGetTextUnderColor(const DrawingWand *wand,
PixelWand *under_color)
{
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
assert(under_color != (PixelWand *) NULL);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
PixelSetPixelColor(under_color,&CurrentContext->undercolor);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w L i n e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawLine() draws a line on the image using the current stroke color,
% stroke alpha, and stroke width.
%
% The format of the DrawLine method is:
%
% void DrawLine(DrawingWand *wand,const double sx,const double sy,
% const double ex,const double ey)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o sx: starting x ordinate
%
% o sy: starting y ordinate
%
% o ex: ending x ordinate
%
% o ey: ending y ordinate
%
*/
WandExport void DrawLine(DrawingWand *wand,const double sx,const double sy,
const double ex,const double ey)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
(void) MVGPrintf(wand,"line %.20g %.20g %.20g %.20g\n",sx,sy,ex,ey);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w P a t h C l o s e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% 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 *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport void DrawPathClose(DrawingWand *wand)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
(void) MVGAutoWrapPrintf(wand,"%s",wand->path_mode == AbsolutePathMode ?
"Z" : "z");
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w P a t h C u r v e T o A b s o l u t e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% 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 *wand,const double x1,
% const double y1,const double x2,const double y2,const double x,
% const double y)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o x1: x ordinate of control point for curve beginning
%
% o y1: y ordinate of control point for curve beginning
%
% o x2: x ordinate of control point for curve ending
%
% o y2: y ordinate of control point for curve ending
%
% o x: x ordinate of the end of the curve
%
% o y: y ordinate of the end of the curve
%
*/
static void DrawPathCurveTo(DrawingWand *wand,const PathMode mode,
const double x1,const double y1,const double x2,const double y2,
const double x,const double y)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if ((wand->path_operation != PathCurveToOperation) ||
(wand->path_mode != mode))
{
wand->path_operation=PathCurveToOperation;
wand->path_mode=mode;
(void) MVGAutoWrapPrintf(wand, "%c%.20g %.20g %.20g %.20g %.20g %.20g",
mode == AbsolutePathMode ? 'C' : 'c',x1,y1,x2,y2,x,y);
}
else
(void) MVGAutoWrapPrintf(wand," %.20g %.20g %.20g %.20g %.20g %.20g",x1,y1,
x2,y2,x,y);
}
WandExport void DrawPathCurveToAbsolute(DrawingWand *wand,const double x1,
const double y1,const double x2,const double y2,const double x,const double y)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
DrawPathCurveTo(wand,AbsolutePathMode,x1,y1,x2,y2,x,y);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w P a t h C u r v e T o R e l a t i v e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% 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 *wand,const double x1,
% const double y1,const double x2,const double y2,const double x,
% const double y)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o x1: x ordinate of control point for curve beginning
%
% o y1: y ordinate of control point for curve beginning
%
% o x2: x ordinate of control point for curve ending
%
% o y2: y ordinate of control point for curve ending
%
% o x: x ordinate of the end of the curve
%
% o y: y ordinate of the end of the curve
%
*/
WandExport void DrawPathCurveToRelative(DrawingWand *wand,const double x1,
const double y1,const double x2,const double y2,const double x,const double y)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
DrawPathCurveTo(wand,RelativePathMode,x1,y1,x2,y2,x,y);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w P a t h C u r v e T o Q u a d r a t i c B e z i e r A b s o l u t e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% 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 *wand,
% const double x1,const double y1,onst double x,const double y)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o x1: x ordinate of the control point
%
% o y1: y ordinate of the control point
%
% o x: x ordinate of final point
%
% o y: y ordinate of final point
%
*/
static void DrawPathCurveToQuadraticBezier(DrawingWand *wand,
const PathMode mode,const double x1,double y1,const double x,const double y)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if ((wand->path_operation != PathCurveToQuadraticBezierOperation) ||
(wand->path_mode != mode))
{
wand->path_operation=PathCurveToQuadraticBezierOperation;
wand->path_mode=mode;
(void) MVGAutoWrapPrintf(wand, "%c%.20g %.20g %.20g %.20g",
mode == AbsolutePathMode ? 'Q' : 'q',x1,y1,x,y);
}
else
(void) MVGAutoWrapPrintf(wand," %.20g %.20g %.20g %.20g",x1,y1,x,y);
}
WandExport void DrawPathCurveToQuadraticBezierAbsolute(DrawingWand *wand,
const double x1,const double y1,const double x,const double y)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
DrawPathCurveToQuadraticBezier(wand,AbsolutePathMode,x1,y1,x,y);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w P a t h C u r v e T o Q u a d r a t i c B e z i e r R e l a t i v e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% 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 *wand,
% const double x1,const double y1,const double x,const double y)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o x1: x ordinate of the control point
%
% o y1: y ordinate of the control point
%
% o x: x ordinate of final point
%
% o y: y ordinate of final point
%
*/
WandExport void DrawPathCurveToQuadraticBezierRelative(DrawingWand *wand,
const double x1,const double y1,const double x,const double y)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
DrawPathCurveToQuadraticBezier(wand,RelativePathMode,x1,y1,x,y);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w P a t h C u r v e T o Q u a d r a t i c B e z i e r S m o o t h %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% 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 *wand,const double x,const double y)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o x: x ordinate of final point
%
% o y: y ordinate of final point
%
*/
static void DrawPathCurveToQuadraticBezierSmooth(DrawingWand *wand,
const PathMode mode,const double x,const double y)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if ((wand->path_operation != PathCurveToQuadraticBezierSmoothOperation) ||
(wand->path_mode != mode))
{
wand->path_operation=PathCurveToQuadraticBezierSmoothOperation;
wand->path_mode=mode;
(void) MVGAutoWrapPrintf(wand,"%c%.20g %.20g",mode == AbsolutePathMode ?
'T' : 't',x,y);
}
else
(void) MVGAutoWrapPrintf(wand," %.20g %.20g",x,y);
}
WandExport void DrawPathCurveToQuadraticBezierSmoothAbsolute(DrawingWand *wand,
const double x,const double y)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
DrawPathCurveToQuadraticBezierSmooth(wand,AbsolutePathMode,x,y);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w P a t h C u r v e T o Q u a d r a t i c B e z i e r S m o o t h %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% 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 *wand,
% const double x,const double y)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o x: x ordinate of final point
%
% o y: y ordinate of final point
%
*/
WandExport void DrawPathCurveToQuadraticBezierSmoothRelative(DrawingWand *wand,
const double x,const double y)
{
DrawPathCurveToQuadraticBezierSmooth(wand,RelativePathMode,x,y);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w P a t h C u r v e T o S m o o t h A b s o l u t e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% 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 *wand,
% const double x2,const double y2,const double x,const double y)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o x2: x ordinate of second control point
%
% o y2: y ordinate of second control point
%
% o x: x ordinate of termination point
%
% o y: y ordinate of termination point
%
*/
static void DrawPathCurveToSmooth(DrawingWand *wand,const PathMode mode,
const double x2,const double y2,const double x,const double y)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if ((wand->path_operation != PathCurveToSmoothOperation) ||
(wand->path_mode != mode))
{
wand->path_operation=PathCurveToSmoothOperation;
wand->path_mode=mode;
(void) MVGAutoWrapPrintf(wand,"%c%.20g %.20g %.20g %.20g",
mode == AbsolutePathMode ? 'S' : 's',x2,y2,x,y);
}
else
(void) MVGAutoWrapPrintf(wand," %.20g %.20g %.20g %.20g",x2,y2,x,y);
}
WandExport void DrawPathCurveToSmoothAbsolute(DrawingWand *wand,const double x2,
const double y2,const double x,const double y)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
DrawPathCurveToSmooth(wand,AbsolutePathMode,x2,y2,x,y);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w P a t h C u r v e T o S m o o t h R e l a t i v e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% 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 *wand,
% const double x2,const double y2,const double x,const double y)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o x2: x ordinate of second control point
%
% o y2: y ordinate of second control point
%
% o x: x ordinate of termination point
%
% o y: y ordinate of termination point
%
*/
WandExport void DrawPathCurveToSmoothRelative(DrawingWand *wand,const double x2,
const double y2,const double x,const double y)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
DrawPathCurveToSmooth(wand,RelativePathMode,x2,y2,x,y);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w P a t h E l l i p t i c A r c A b s o l u t e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% 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
% 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.
%
% The format of the DrawPathEllipticArcAbsolute method is:
%
% void DrawPathEllipticArcAbsolute(DrawingWand *wand,
% const double rx,const double ry,const double x_axis_rotation,
% const MagickBooleanType large_arc_flag,
% const MagickBooleanType sweep_flag,const double x,const double y)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o rx: x radius
%
% o ry: y radius
%
% o x_axis_rotation: indicates how the ellipse as a whole is rotated
% relative to the current coordinate system
%
% o large_arc_flag: If non-zero (true) then draw the larger of the
% available arcs
%
% o sweep_flag: If non-zero (true) then draw the arc matching a
% clock-wise rotation
%
%
*/
static void DrawPathEllipticArc(DrawingWand *wand, const PathMode mode,
const double rx,const double ry,const double x_axis_rotation,
const MagickBooleanType large_arc_flag,const MagickBooleanType sweep_flag,
const double x,const double y)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if ((wand->path_operation != PathEllipticArcOperation) ||
(wand->path_mode != mode))
{
wand->path_operation=PathEllipticArcOperation;
wand->path_mode=mode;
(void) MVGAutoWrapPrintf(wand, "%c%.20g %.20g %.20g %u %u %.20g %.20g",
mode == AbsolutePathMode ? 'A' : 'a',rx,ry,x_axis_rotation,
large_arc_flag,sweep_flag,x,y);
}
else
(void) MVGAutoWrapPrintf(wand," %.20g %.20g %.20g %u %u %.20g %.20g",rx,ry,
x_axis_rotation,large_arc_flag,sweep_flag,x,y);
}
WandExport void DrawPathEllipticArcAbsolute(DrawingWand *wand,const double rx,
const double ry,const double x_axis_rotation,
const MagickBooleanType large_arc_flag,const MagickBooleanType sweep_flag,
const double x,const double y)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
DrawPathEllipticArc(wand,AbsolutePathMode,rx,ry,x_axis_rotation,
large_arc_flag,sweep_flag,x,y);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w P a t h E l l i p t i c A r c R e l a t i v e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% 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
% 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.
%
% The format of the DrawPathEllipticArcRelative method is:
%
% void DrawPathEllipticArcRelative(DrawingWand *wand,
% const double rx,const double ry,const double x_axis_rotation,
% const MagickBooleanType large_arc_flag,
% const MagickBooleanType sweep_flag,const double x,const double y)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o rx: x radius
%
% o ry: y radius
%
% o x_axis_rotation: indicates how the ellipse as a whole is rotated
% relative to the current coordinate system
%
% o large_arc_flag: If non-zero (true) then draw the larger of the
% available arcs
%
% o sweep_flag: If non-zero (true) then draw the arc matching a
% clock-wise rotation
%
*/
WandExport void DrawPathEllipticArcRelative(DrawingWand *wand,const double rx,
const double ry,const double x_axis_rotation,
const MagickBooleanType large_arc_flag,const MagickBooleanType sweep_flag,
const double x,const double y)
{
DrawPathEllipticArc(wand,RelativePathMode,rx,ry,x_axis_rotation,
large_arc_flag,sweep_flag,x,y);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w P a t h F i n i s h %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawPathFinish() terminates the current path.
%
% The format of the DrawPathFinish method is:
%
% void DrawPathFinish(DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport void DrawPathFinish(DrawingWand *wand)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
(void) MVGPrintf(wand,"'\n");
wand->path_operation=PathDefaultOperation;
wand->path_mode=DefaultPathMode;
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w P a t h L i n e T o A b s o l u t e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% 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 *wand,const double x,
% const double y)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o x: target x ordinate
%
% o y: target y ordinate
%
*/
static void DrawPathLineTo(DrawingWand *wand,const PathMode mode,
const double x,const double y)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if ((wand->path_operation != PathLineToOperation) ||
(wand->path_mode != mode))
{
wand->path_operation=PathLineToOperation;
wand->path_mode=mode;
(void) MVGAutoWrapPrintf(wand,"%c%.20g %.20g",mode == AbsolutePathMode ?
'L' : 'l',x,y);
}
else
(void) MVGAutoWrapPrintf(wand," %.20g %.20g",x,y);
}
WandExport void DrawPathLineToAbsolute(DrawingWand *wand,const double x,
const double y)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
DrawPathLineTo(wand,AbsolutePathMode,x,y);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w P a t h L i n e T o R e l a t i v e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% 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 *wand,const double x,
% const double y)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o x: target x ordinate
%
% o y: target y ordinate
%
*/
WandExport void DrawPathLineToRelative(DrawingWand *wand,const double x,
const double y)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
DrawPathLineTo(wand,RelativePathMode,x,y);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w P a t h L i n e T o H o r i z o n t a l A b s o l u t e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% 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 *wand,const double x)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o x: target x ordinate
%
*/
static void DrawPathLineToHorizontal(DrawingWand *wand,const PathMode mode,
const double x)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if ((wand->path_operation != PathLineToHorizontalOperation) ||
(wand->path_mode != mode))
{
wand->path_operation=PathLineToHorizontalOperation;
wand->path_mode=mode;
(void) MVGAutoWrapPrintf(wand,"%c%.20g",mode == AbsolutePathMode ?
'H' : 'h',x);
}
else
(void) MVGAutoWrapPrintf(wand," %.20g",x);
}
WandExport void DrawPathLineToHorizontalAbsolute(DrawingWand *wand,
const double x)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
DrawPathLineToHorizontal(wand,AbsolutePathMode,x);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w P a t h L i n e T o H o r i z o n t a l R e l a t i v e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% 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 *wand,
% const double x)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o x: target x ordinate
%
*/
WandExport void DrawPathLineToHorizontalRelative(DrawingWand *wand,
const double x)
{
DrawPathLineToHorizontal(wand,RelativePathMode,x);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w P a t h L i n e T o V e r t i c a l A b s o l u t e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% 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 *wand,
% const double y)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o y: target y ordinate
%
*/
static void DrawPathLineToVertical(DrawingWand *wand,const PathMode mode,
const double y)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if ((wand->path_operation != PathLineToVerticalOperation) ||
(wand->path_mode != mode))
{
wand->path_operation=PathLineToVerticalOperation;
wand->path_mode=mode;
(void) MVGAutoWrapPrintf(wand,"%c%.20g",mode == AbsolutePathMode ?
'V' : 'v',y);
}
else
(void) MVGAutoWrapPrintf(wand," %.20g",y);
}
WandExport void DrawPathLineToVerticalAbsolute(DrawingWand *wand,const double y)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
DrawPathLineToVertical(wand,AbsolutePathMode,y);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w P a t h L i n e T o V e r t i c a l R e l a t i v e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% 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 *wand,
% const double y)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o y: target y ordinate
%
*/
WandExport void DrawPathLineToVerticalRelative(DrawingWand *wand,const double y)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
DrawPathLineToVertical(wand,RelativePathMode,y);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w P a t h M o v e T o A b s o l u t e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% 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 *wand,const double x,
% const double y)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o x: target x ordinate
%
% o y: target y ordinate
%
*/
static void DrawPathMoveTo(DrawingWand *wand,const PathMode mode,const double x,
const double y)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if ((wand->path_operation != PathMoveToOperation) ||
(wand->path_mode != mode))
{
wand->path_operation=PathMoveToOperation;
wand->path_mode=mode;
(void) MVGAutoWrapPrintf(wand,"%c%.20g %.20g",mode == AbsolutePathMode ?
'M' : 'm',x,y);
}
else
(void) MVGAutoWrapPrintf(wand," %.20g %.20g",x,y);
}
WandExport void DrawPathMoveToAbsolute(DrawingWand *wand,const double x,
const double y)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
DrawPathMoveTo(wand,AbsolutePathMode,x,y);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w P a t h M o v e T o R e l a t i v e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% 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 *wand,const double x,
% const double y)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o x: target x ordinate
%
% o y: target y ordinate
%
*/
WandExport void DrawPathMoveToRelative(DrawingWand *wand,const double x,
const double y)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
DrawPathMoveTo(wand,RelativePathMode,x,y);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w P a t h S t a r t %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% 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 *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport void DrawPathStart(DrawingWand *wand)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
(void) MVGPrintf(wand,"path '");
wand->path_operation=PathDefaultOperation;
wand->path_mode=DefaultPathMode;
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w P o i n t %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawPoint() draws a point using the current fill color.
%
% The format of the DrawPoint method is:
%
% void DrawPoint(DrawingWand *wand,const double x,const double y)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o x: target x coordinate
%
% o y: target y coordinate
%
*/
WandExport void DrawPoint(DrawingWand *wand,const double x,const double y)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
(void) MVGPrintf(wand,"point %.20g %.20g\n",x,y);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w P o l y g o n %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% 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 *wand,
% const size_t number_coordinates,const PointInfo *coordinates)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o number_coordinates: number of coordinates
%
% o coordinates: coordinate array
%
*/
WandExport void DrawPolygon(DrawingWand *wand,
const size_t number_coordinates,const PointInfo *coordinates)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
MVGAppendPointsCommand(wand,"polygon",number_coordinates,coordinates);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w P o l y l i n e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawPolyline() draws a polyline using the current stroke, stroke width, and
% fill color or texture, using the specified array of coordinates.
%
% The format of the DrawPolyline method is:
%
% void DrawPolyline(DrawingWand *wand,
% const size_t number_coordinates,const PointInfo *coordinates)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o number_coordinates: number of coordinates
%
% o coordinates: coordinate array
%
*/
WandExport void DrawPolyline(DrawingWand *wand,
const size_t number_coordinates,const PointInfo *coordinates)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
MVGAppendPointsCommand(wand,"polyline",number_coordinates,coordinates);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w P o p C l i p P a t h %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawPopClipPath() terminates a clip path definition.
%
% The format of the DrawPopClipPath method is:
%
% void DrawPopClipPath(DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport void DrawPopClipPath(DrawingWand *wand)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if (wand->indent_depth > 0)
wand->indent_depth--;
(void) MVGPrintf(wand,"pop clip-path\n");
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w P o p D e f s %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawPopDefs() terminates a definition list.
%
% The format of the DrawPopDefs method is:
%
% void DrawPopDefs(DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport void DrawPopDefs(DrawingWand *wand)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if (wand->indent_depth > 0)
wand->indent_depth--;
(void) MVGPrintf(wand,"pop defs\n");
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w P o p P a t t e r n %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawPopPattern() terminates a pattern definition.
%
% The format of the DrawPopPattern method is:
%
% MagickBooleanType DrawPopPattern(DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport MagickBooleanType DrawPopPattern(DrawingWand *wand)
{
char
geometry[MagickPathExtent],
key[MagickPathExtent];
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if (wand->image == (Image *) NULL)
ThrowDrawException(WandError,"ContainsNoImages",wand->name);
if (wand->pattern_id == (const char *) NULL)
{
ThrowDrawException(DrawWarning,"NotCurrentlyPushingPatternDefinition",
wand->name);
return(MagickFalse);
}
(void) FormatLocaleString(key,MagickPathExtent,"%s",wand->pattern_id);
(void) SetImageArtifact(wand->image,key,wand->mvg+wand->pattern_offset);
(void) FormatLocaleString(geometry,MagickPathExtent,"%.20gx%.20g%+.20g%+.20g",
(double) wand->pattern_bounds.width,(double) wand->pattern_bounds.height,
(double) wand->pattern_bounds.x,(double) wand->pattern_bounds.y);
(void) SetImageArtifact(wand->image,key,geometry);
wand->pattern_id=DestroyString(wand->pattern_id);
wand->pattern_offset=0;
wand->pattern_bounds.x=0;
wand->pattern_bounds.y=0;
wand->pattern_bounds.width=0;
wand->pattern_bounds.height=0;
wand->filter_off=MagickTrue;
if (wand->indent_depth > 0)
wand->indent_depth--;
(void) MVGPrintf(wand,"pop pattern\n");
return(MagickTrue);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w P u s h C l i p P a t h %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawPushClipPath() starts a clip path definition which is comprized of any
% number of drawing commands and terminated by a DrawPopClipPath() command.
%
% The format of the DrawPushClipPath method is:
%
% void DrawPushClipPath(DrawingWand *wand,const char *clip_mask_id)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o clip_mask_id: string identifier to associate with the clip path for
% later use.
%
*/
WandExport void DrawPushClipPath(DrawingWand *wand,const char *clip_mask_id)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
assert(clip_mask_id != (const char *) NULL);
(void) MVGPrintf(wand,"push clip-path \"%s\"\n",clip_mask_id);
wand->indent_depth++;
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w P u s h D e f s %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawPushDefs() indicates that commands up to a terminating DrawPopDefs()
% command create named elements (e.g. clip-paths, textures, etc.) which
% may safely be processed earlier for the sake of efficiency.
%
% The format of the DrawPushDefs method is:
%
% void DrawPushDefs(DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport void DrawPushDefs(DrawingWand *wand)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
(void) MVGPrintf(wand,"push defs\n");
wand->indent_depth++;
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w P u s h P a t t e r n %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawPushPattern() indicates that subsequent commands up to a
% DrawPopPattern() command comprise the definition of a named pattern.
% The pattern space is assigned top left corner coordinates, a width
% and height, and becomes its own drawing space. Anything which can
% be drawn may be used in a pattern definition.
% Named patterns may be used as stroke or brush definitions.
%
% The format of the DrawPushPattern method is:
%
% MagickBooleanType DrawPushPattern(DrawingWand *wand,
% const char *pattern_id,const double x,const double y,
% const double width,const double height)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o pattern_id: pattern identification for later reference
%
% o x: x ordinate of top left corner
%
% o y: y ordinate of top left corner
%
% o width: width of pattern space
%
% o height: height of pattern space
%
*/
WandExport MagickBooleanType DrawPushPattern(DrawingWand *wand,
const char *pattern_id,const double x,const double y,const double width,
const double height)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
assert(pattern_id != (const char *) NULL);
if (wand->pattern_id != NULL)
{
ThrowDrawException(DrawError,"AlreadyPushingPatternDefinition",
wand->pattern_id);
return(MagickFalse);
}
wand->filter_off=MagickTrue;
(void) MVGPrintf(wand,"push pattern %s %.20g %.20g %.20g %.20g\n",pattern_id,
x,y,width,height);
wand->indent_depth++;
wand->pattern_id=AcquireString(pattern_id);
wand->pattern_bounds.x=(ssize_t) ceil(x-0.5);
wand->pattern_bounds.y=(ssize_t) ceil(y-0.5);
wand->pattern_bounds.width=(size_t) floor(width+0.5);
wand->pattern_bounds.height=(size_t) floor(height+0.5);
wand->pattern_offset=wand->mvg_length;
return(MagickTrue);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w R e c t a n g l e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawRectangle() draws a rectangle given two coordinates and using the
% current stroke, stroke width, and fill settings.
%
% The format of the DrawRectangle method is:
%
% void DrawRectangle(DrawingWand *wand,const double x1,
% const double y1,const double x2,const double y2)
%
% A description of each parameter follows:
%
% o x1: x ordinate of first coordinate
%
% o y1: y ordinate of first coordinate
%
% o x2: x ordinate of second coordinate
%
% o y2: y ordinate of second coordinate
%
*/
WandExport void DrawRectangle(DrawingWand *wand,const double x1,const double y1,
const double x2,const double y2)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if ((fabs(x2-x1) < MagickEpsilon) && (fabs(y2-y1) < MagickEpsilon))
(void) MVGPrintf(wand,"point %.20g %.20g\n",x1,y1);
else
(void) MVGPrintf(wand,"rectangle %.20g %.20g %.20g %.20g\n",x1,y1,x2,y2);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
+ D r a w R e n d e r %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawRender() renders all preceding drawing commands onto the image.
%
% The format of the DrawRender method is:
%
% MagickBooleanType DrawRender(DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport MagickBooleanType DrawRender(DrawingWand *wand)
{
MagickBooleanType
status;
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
CurrentContext->primitive=wand->mvg;
if (wand->debug != MagickFalse)
(void) LogMagickEvent(DrawEvent,GetMagickModule(),"MVG:\n'%s'\n",wand->mvg);
if (wand->image == (Image *) NULL)
ThrowDrawException(WandError,"ContainsNoImages",wand->name);
status=DrawImage(wand->image,CurrentContext,wand->exception);
CurrentContext->primitive=(char *) NULL;
return(status);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w R e s e t V e c t o r G r a p h i c s %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawResetVectorGraphics() resets the vector graphics associated with the
% specified wand.
%
% The format of the DrawResetVectorGraphics method is:
%
% void DrawResetVectorGraphics(DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport void DrawResetVectorGraphics(DrawingWand *wand)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if (wand->mvg != (char *) NULL)
wand->mvg=DestroyString(wand->mvg);
wand->mvg_alloc=0;
wand->mvg_length=0;
wand->mvg_width=0;
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w R o t a t e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawRotate() applies the specified rotation to the current coordinate space.
%
% The format of the DrawRotate method is:
%
% void DrawRotate(DrawingWand *wand,const double degrees)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o degrees: degrees of rotation
%
*/
WandExport void DrawRotate(DrawingWand *wand,const double degrees)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
(void) MVGPrintf(wand,"rotate %.20g\n",degrees);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w R o u n d R e c t a n g l e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawRoundRectangle() draws a rounted rectangle given two coordinates,
% x & y corner radiuses and using the current stroke, stroke width,
% and fill settings.
%
% The format of the DrawRoundRectangle method is:
%
% void DrawRoundRectangle(DrawingWand *wand,double x1,double y1,
% double x2,double y2,double rx,double ry)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o x1: x ordinate of first coordinate
%
% o y1: y ordinate of first coordinate
%
% o x2: x ordinate of second coordinate
%
% o y2: y ordinate of second coordinate
%
% o rx: radius of corner in horizontal direction
%
% o ry: radius of corner in vertical direction
%
*/
WandExport void DrawRoundRectangle(DrawingWand *wand,double x1,double y1,
double x2,double y2,double rx,double ry)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
(void) MVGPrintf(wand,"roundrectangle %.20g %.20g %.20g %.20g %.20g %.20g\n",
x1,y1,x2,y2,rx,ry);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S c a l e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawScale() adjusts the scaling factor to apply in the horizontal and
% vertical directions to the current coordinate space.
%
% The format of the DrawScale method is:
%
% void DrawScale(DrawingWand *wand,const double x,const double y)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o x: horizontal scale factor
%
% o y: vertical scale factor
%
*/
WandExport void DrawScale(DrawingWand *wand,const double x,const double y)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
(void) MVGPrintf(wand,"scale %.20g %.20g\n",x,y);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t B o r d e r C o l o r %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetBorderColor() sets the border color to be used for drawing bordered
% objects.
%
% The format of the DrawSetBorderColor method is:
%
% void DrawSetBorderColor(DrawingWand *wand,const PixelWand *border_wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o border_wand: border wand.
%
*/
WandExport void DrawSetBorderColor(DrawingWand *wand,
const PixelWand *border_wand)
{
PixelInfo
*current_border,
border_color,
new_border;
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
assert(border_wand != (const PixelWand *) NULL);
PixelGetQuantumPacket(border_wand,&border_color);
new_border=border_color;
current_border=(&CurrentContext->border_color);
if ((wand->filter_off != MagickFalse) ||
(IsPixelInfoEquivalent(current_border,&new_border) == MagickFalse))
{
CurrentContext->border_color=new_border;
(void) MVGPrintf(wand,"border-color '");
MVGAppendColor(wand,&border_color);
(void) MVGPrintf(wand,"'\n");
}
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t C l i p P a t h %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetClipPath() associates a named clipping path with the image. Only
% the areas drawn on by the clipping path will be modified as ssize_t as it
% remains in effect.
%
% The format of the DrawSetClipPath method is:
%
% MagickBooleanType DrawSetClipPath(DrawingWand *wand,
% const char *clip_mask)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o clip_mask: name of clipping path to associate with image
%
*/
WandExport MagickBooleanType DrawSetClipPath(DrawingWand *wand,
const char *clip_mask)
{
assert(wand != (DrawingWand *) NULL);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",clip_mask);
assert(wand->signature == MagickWandSignature);
assert(clip_mask != (const char *) NULL);
if ((CurrentContext->clip_mask == (const char *) NULL) ||
(wand->filter_off != MagickFalse) ||
(LocaleCompare(CurrentContext->clip_mask,clip_mask) != 0))
{
(void) CloneString(&CurrentContext->clip_mask,clip_mask);
#if DRAW_BINARY_IMPLEMENTATION
if (wand->image == (Image *) NULL)
ThrowDrawException(WandError,"ContainsNoImages",wand->name);
(void) DrawClipPath(wand->image,CurrentContext,CurrentContext->clip_mask,
wand->exception);
#endif
(void) MVGPrintf(wand,"clip-path url(#%s)\n",clip_mask);
}
return(MagickTrue);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t C l i p R u l e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetClipRule() set the polygon fill rule to be used by the clipping path.
%
% The format of the DrawSetClipRule method is:
%
% void DrawSetClipRule(DrawingWand *wand,const FillRule fill_rule)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o fill_rule: fill rule (EvenOddRule or NonZeroRule)
%
*/
WandExport void DrawSetClipRule(DrawingWand *wand,const FillRule fill_rule)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if ((wand->filter_off != MagickFalse) ||
(CurrentContext->fill_rule != fill_rule))
{
CurrentContext->fill_rule=fill_rule;
(void) MVGPrintf(wand, "clip-rule '%s'\n",CommandOptionToMnemonic(
MagickFillRuleOptions,(ssize_t) fill_rule));
}
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t C l i p U n i t s %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetClipUnits() sets the interpretation of clip path units.
%
% The format of the DrawSetClipUnits method is:
%
% void DrawSetClipUnits(DrawingWand *wand,
% const ClipPathUnits clip_units)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o clip_units: units to use (UserSpace, UserSpaceOnUse, or
% ObjectBoundingBox)
%
*/
WandExport void DrawSetClipUnits(DrawingWand *wand,
const ClipPathUnits clip_units)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if ((wand->filter_off != MagickFalse) ||
(CurrentContext->clip_units != clip_units))
{
CurrentContext->clip_units=clip_units;
if (clip_units == ObjectBoundingBox)
{
AffineMatrix
affine;
GetAffineMatrix(&affine);
affine.sx=CurrentContext->bounds.x2;
affine.sy=CurrentContext->bounds.y2;
affine.tx=CurrentContext->bounds.x1;
affine.ty=CurrentContext->bounds.y1;
AdjustAffine(wand,&affine);
}
(void) MVGPrintf(wand, "clip-units '%s'\n",CommandOptionToMnemonic(
MagickClipPathOptions,(ssize_t) clip_units));
}
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t D e n s i t y %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetDensity() sets the vertical and horizontal resolution.
%
% The format of the DrawSetDensity method is:
%
% MagickBooleanType DrawSetDensity(DrawingWand *wand,
% const char *density)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o density: the vertical and horizontal resolution.
%
*/
WandExport MagickBooleanType DrawSetDensity(DrawingWand *wand,
const char *density)
{
assert(wand != (DrawingWand *) NULL);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",density);
assert(wand->signature == MagickWandSignature);
assert(density != (const char *) NULL);
if ((CurrentContext->density == (const char *) NULL) ||
(wand->filter_off != MagickFalse) ||
(LocaleCompare(CurrentContext->density,density) != 0))
{
(void) CloneString(&CurrentContext->density,density);
(void) MVGPrintf(wand,"density '%s'\n",density);
}
return(MagickTrue);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t F i l l C o l o r %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetFillColor() sets the fill color to be used for drawing filled objects.
%
% The format of the DrawSetFillColor method is:
%
% void DrawSetFillColor(DrawingWand *wand,const PixelWand *fill_wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o fill_wand: fill wand.
%
*/
WandExport void DrawSetFillColor(DrawingWand *wand,const PixelWand *fill_wand)
{
PixelInfo
*current_fill,
fill_color,
new_fill;
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
assert(fill_wand != (const PixelWand *) NULL);
PixelGetQuantumPacket(fill_wand,&fill_color);
new_fill=fill_color;
current_fill=(&CurrentContext->fill);
if ((wand->filter_off != MagickFalse) ||
(IsPixelInfoEquivalent(current_fill,&new_fill) == MagickFalse))
{
CurrentContext->fill=new_fill;
(void) MVGPrintf(wand,"fill '");
MVGAppendColor(wand,&fill_color);
(void) MVGPrintf(wand,"'\n");
}
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t F i l l O p a c i t y %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetFillOpacity() sets the alpha 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 *wand,const double fill_alpha)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o fill_opacity: fill opacity
%
*/
WandExport void DrawSetFillOpacity(DrawingWand *wand,const double fill_opacity)
{
double
alpha;
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
alpha=(double) ClampToQuantum(QuantumRange*fill_opacity);
if ((wand->filter_off != MagickFalse) ||
(CurrentContext->fill.alpha != alpha))
{
CurrentContext->fill.alpha=alpha;
(void) MVGPrintf(wand,"fill-opacity %.20g\n",fill_opacity);
}
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t F o n t R e s o l u t i o n %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetFontResolution() sets the image resolution.
%
% The format of the DrawSetFontResolution method is:
%
% MagickBooleanType DrawSetFontResolution(DrawingWand *wand,
% const double x_resolution,const double y_resolution)
%
% A description of each parameter follows:
%
% o wand: the magick wand.
%
% o x_resolution: the image x resolution.
%
% o y_resolution: the image y resolution.
%
*/
WandExport MagickBooleanType DrawSetFontResolution(DrawingWand *wand,
const double x_resolution,const double y_resolution)
{
char
density[MagickPathExtent];
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
(void) FormatLocaleString(density,MagickPathExtent,"%.20gx%.20g",x_resolution,
y_resolution);
(void) CloneString(&CurrentContext->density,density);
return(MagickTrue);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t O p a c i t y %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetOpacity() sets the alpha to use when drawing using the fill or
% stroke color or texture. Fully opaque is 1.0.
%
% The format of the DrawSetOpacity method is:
%
% void DrawSetOpacity(DrawingWand *wand,const double alpha)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o opacity: fill and stroke opacity. The value 1.0 is opaque.
%
*/
WandExport void DrawSetOpacity(DrawingWand *wand,const double opacity)
{
Quantum
quantum_alpha;
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
quantum_alpha=ClampToQuantum(QuantumRange*opacity);
if ((wand->filter_off != MagickFalse) ||
(CurrentContext->alpha != quantum_alpha))
{
CurrentContext->alpha=quantum_alpha;
(void) MVGPrintf(wand,"opacity %.20g\n",opacity);
}
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t F i l l P a t t e r n U R L %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% 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:
%
% MagickBooleanType DrawSetFillPatternURL(DrawingWand *wand,
% const char *fill_url)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o fill_url: URL to use to obtain fill pattern.
%
*/
WandExport MagickBooleanType DrawSetFillPatternURL(DrawingWand *wand,
const char *fill_url)
{
char
pattern[MagickPathExtent],
pattern_spec[MagickPathExtent];
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",fill_url);
if (wand->image == (Image *) NULL)
ThrowDrawException(WandError,"ContainsNoImages",wand->name);
assert(fill_url != (const char *) NULL);
if (*fill_url != '#')
{
ThrowDrawException(DrawError,"NotARelativeURL",fill_url);
return(MagickFalse);
}
(void) FormatLocaleString(pattern,MagickPathExtent,"%s",fill_url+1);
if (GetImageArtifact(wand->image,pattern) == (const char *) NULL)
{
ThrowDrawException(DrawError,"URLNotFound",fill_url)
return(MagickFalse);
}
(void) FormatLocaleString(pattern_spec,MagickPathExtent,"url(%s)",fill_url);
#if DRAW_BINARY_IMPLEMENTATION
DrawPatternPath(wand->image,CurrentContext,pattern_spec,
&CurrentContext->fill_pattern,wand->exception);
#endif
if (CurrentContext->fill.alpha != (Quantum) TransparentAlpha)
CurrentContext->fill.alpha=(double) CurrentContext->alpha;
(void) MVGPrintf(wand,"fill %s\n",pattern_spec);
return(MagickTrue);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t F i l l R u l e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetFillRule() sets the fill rule to use while drawing polygons.
%
% The format of the DrawSetFillRule method is:
%
% void DrawSetFillRule(DrawingWand *wand,const FillRule fill_rule)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o fill_rule: fill rule (EvenOddRule or NonZeroRule)
%
*/
WandExport void DrawSetFillRule(DrawingWand *wand,const FillRule fill_rule)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if ((wand->filter_off != MagickFalse) ||
(CurrentContext->fill_rule != fill_rule))
{
CurrentContext->fill_rule=fill_rule;
(void) MVGPrintf(wand, "fill-rule '%s'\n",CommandOptionToMnemonic(
MagickFillRuleOptions,(ssize_t) fill_rule));
}
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t F o n t %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetFont() sets the fully-sepecified font to use when annotating with
% text.
%
% The format of the DrawSetFont method is:
%
% MagickBooleanType DrawSetFont(DrawingWand *wand,const char *font_name)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o font_name: font name
%
*/
WandExport MagickBooleanType DrawSetFont(DrawingWand *wand,
const char *font_name)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
assert(font_name != (const char *) NULL);
if ((wand->filter_off != MagickFalse) ||
(CurrentContext->font == (char *) NULL) ||
(LocaleCompare(CurrentContext->font,font_name) != 0))
{
(void) CloneString(&CurrentContext->font,font_name);
(void) MVGPrintf(wand,"font '%s'\n",font_name);
}
return(MagickTrue);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t F o n t F a m i l y %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetFontFamily() sets the font family to use when annotating with text.
%
% The format of the DrawSetFontFamily method is:
%
% MagickBooleanType DrawSetFontFamily(DrawingWand *wand,
% const char *font_family)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o font_family: font family
%
*/
WandExport MagickBooleanType DrawSetFontFamily(DrawingWand *wand,
const char *font_family)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
assert(font_family != (const char *) NULL);
if ((wand->filter_off != MagickFalse) ||
(CurrentContext->family == (const char *) NULL) ||
(LocaleCompare(CurrentContext->family,font_family) != 0))
{
(void) CloneString(&CurrentContext->family,font_family);
(void) MVGPrintf(wand,"font-family '%s'\n",font_family);
}
return(MagickTrue);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t F o n t S i z e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetFontSize() sets the font pointsize to use when annotating with text.
%
% The format of the DrawSetFontSize method is:
%
% void DrawSetFontSize(DrawingWand *wand,const double pointsize)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o pointsize: text pointsize
%
*/
WandExport void DrawSetFontSize(DrawingWand *wand,const double pointsize)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if ((wand->filter_off != MagickFalse) ||
(fabs(CurrentContext->pointsize-pointsize) >= MagickEpsilon))
{
CurrentContext->pointsize=pointsize;
(void) MVGPrintf(wand,"font-size %.20g\n",pointsize);
}
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t F o n t S t r e t c h %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% 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 *wand,
% const StretchType font_stretch)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o font_stretch: font stretch (NormalStretch, UltraCondensedStretch,
% CondensedStretch, SemiCondensedStretch,
% SemiExpandedStretch, ExpandedStretch,
% ExtraExpandedStretch, UltraExpandedStretch, AnyStretch)
%
*/
WandExport void DrawSetFontStretch(DrawingWand *wand,
const StretchType font_stretch)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if ((wand->filter_off != MagickFalse) ||
(CurrentContext->stretch != font_stretch))
{
CurrentContext->stretch=font_stretch;
(void) MVGPrintf(wand, "font-stretch '%s'\n",CommandOptionToMnemonic(
MagickStretchOptions,(ssize_t) font_stretch));
}
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t F o n t S t y l e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% 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 *wand,const StyleType style)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o style: font style (NormalStyle, ItalicStyle, ObliqueStyle, AnyStyle)
%
*/
WandExport void DrawSetFontStyle(DrawingWand *wand,const StyleType style)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if ((wand->filter_off != MagickFalse) ||
(CurrentContext->style != style))
{
CurrentContext->style=style;
(void) MVGPrintf(wand, "font-style '%s'\n",CommandOptionToMnemonic(
MagickStyleOptions,(ssize_t) style));
}
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t F o n t W e i g h t %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetFontWeight() sets the font weight to use when annotating with text.
%
% The format of the DrawSetFontWeight method is:
%
% void DrawSetFontWeight(DrawingWand *wand,
% const size_t font_weight)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o font_weight: font weight (valid range 100-900)
%
*/
WandExport void DrawSetFontWeight(DrawingWand *wand,
const size_t font_weight)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if ((wand->filter_off != MagickFalse) ||
(CurrentContext->weight != font_weight))
{
CurrentContext->weight=font_weight;
(void) MVGPrintf(wand,"font-weight %.20g\n",(double) font_weight);
}
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t G r a v i t y %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetGravity() sets the text placement gravity to use when annotating
% with text.
%
% The format of the DrawSetGravity method is:
%
% void DrawSetGravity(DrawingWand *wand,const GravityType gravity)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o gravity: positioning gravity (NorthWestGravity, NorthGravity,
% NorthEastGravity, WestGravity, CenterGravity,
% EastGravity, SouthWestGravity, SouthGravity,
% SouthEastGravity)
%
*/
WandExport void DrawSetGravity(DrawingWand *wand,const GravityType gravity)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if ((wand->filter_off != MagickFalse) ||
(CurrentContext->gravity != gravity) || (gravity != ForgetGravity))
{
CurrentContext->gravity=gravity;
(void) MVGPrintf(wand,"gravity '%s'\n",CommandOptionToMnemonic(
MagickGravityOptions,(ssize_t) gravity));
}
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t S t r o k e C o l o r %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetStrokeColor() sets the color used for stroking object outlines.
%
% The format of the DrawSetStrokeColor method is:
%
% void DrawSetStrokeColor(DrawingWand *wand,
% const PixelWand *stroke_wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o stroke_wand: stroke wand.
%
*/
WandExport void DrawSetStrokeColor(DrawingWand *wand,
const PixelWand *stroke_wand)
{
PixelInfo
*current_stroke,
new_stroke,
stroke_color;
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
assert(stroke_wand != (const PixelWand *) NULL);
PixelGetQuantumPacket(stroke_wand,&stroke_color);
new_stroke=stroke_color;
current_stroke=(&CurrentContext->stroke);
if ((wand->filter_off != MagickFalse) ||
(IsPixelInfoEquivalent(current_stroke,&new_stroke) == MagickFalse))
{
CurrentContext->stroke=new_stroke;
(void) MVGPrintf(wand,"stroke '");
MVGAppendColor(wand,&stroke_color);
(void) MVGPrintf(wand,"'\n");
}
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t S t r o k e P a t t e r n U R L %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetStrokePatternURL() sets the pattern used for stroking object outlines.
%
% The format of the DrawSetStrokePatternURL method is:
%
% MagickBooleanType DrawSetStrokePatternURL(DrawingWand *wand,
% const char *stroke_url)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o stroke_url: URL specifying pattern ID (e.g. "#pattern_id")
%
*/
WandExport MagickBooleanType DrawSetStrokePatternURL(DrawingWand *wand,
const char *stroke_url)
{
char
pattern[MagickPathExtent],
pattern_spec[MagickPathExtent];
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if (wand->image == (Image *) NULL)
ThrowDrawException(WandError,"ContainsNoImages",wand->name);
assert(stroke_url != NULL);
if (stroke_url[0] != '#')
ThrowDrawException(DrawError,"NotARelativeURL",stroke_url);
(void) FormatLocaleString(pattern,MagickPathExtent,"%s",stroke_url+1);
if (GetImageArtifact(wand->image,pattern) == (const char *) NULL)
{
ThrowDrawException(DrawError,"URLNotFound",stroke_url)
return(MagickFalse);
}
(void) FormatLocaleString(pattern_spec,MagickPathExtent,"url(%s)",stroke_url);
#if DRAW_BINARY_IMPLEMENTATION
DrawPatternPath(wand->image,CurrentContext,pattern_spec,
&CurrentContext->stroke_pattern,wand->exception);
#endif
if (CurrentContext->stroke.alpha != (Quantum) TransparentAlpha)
CurrentContext->stroke.alpha=(double) CurrentContext->alpha;
(void) MVGPrintf(wand,"stroke %s\n",pattern_spec);
return(MagickTrue);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t S t r o k e A n t i a l i a s %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetStrokeAntialias() controls whether stroked outlines are antialiased.
% Stroked outlines are antialiased by default. When antialiasing is disabled
% stroked pixels are thresholded to determine if the stroke color or
% underlying canvas color should be used.
%
% The format of the DrawSetStrokeAntialias method is:
%
% void DrawSetStrokeAntialias(DrawingWand *wand,
% const MagickBooleanType stroke_antialias)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o stroke_antialias: set to false (zero) to disable antialiasing
%
*/
WandExport void DrawSetStrokeAntialias(DrawingWand *wand,
const MagickBooleanType stroke_antialias)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if ((wand->filter_off != MagickFalse) ||
(CurrentContext->stroke_antialias != stroke_antialias))
{
CurrentContext->stroke_antialias=stroke_antialias;
(void) MVGPrintf(wand,"stroke-antialias %i\n",stroke_antialias != 0 ?
1 : 0);
}
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t S t r o k e D a s h A r r a y %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetStrokeDashArray() specifies the pattern of dashes and gaps used to
% stroke paths. The stroke dash array represents an 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. To remove an existing dash array, pass a zero
% number_elements argument and null dasharray. A typical stroke dash array
% might contain the members 5 3 2.
%
% The format of the DrawSetStrokeDashArray method is:
%
% MagickBooleanType DrawSetStrokeDashArray(DrawingWand *wand,
% const size_t number_elements,const double *dasharray)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o number_elements: number of elements in dash array
%
% o dasharray: dash array values
%
*/
WandExport MagickBooleanType DrawSetStrokeDashArray(DrawingWand *wand,
const size_t number_elements,const double *dasharray)
{
MagickBooleanType
update;
register const double
*p;
register double
*q;
register ssize_t
i;
size_t
n_new,
n_old;
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
n_new=number_elements;
if (dasharray == (const double *) NULL)
n_new=0;
n_old=0;
update=MagickFalse;
q=CurrentContext->dash_pattern;
if (q != (const double *) NULL)
while (fabs(*q++) < MagickEpsilon)
n_old++;
if ((n_old == 0) && (n_new == 0))
update=MagickFalse;
else
if (n_old != n_new)
update=MagickTrue;
else
if ((CurrentContext->dash_pattern != (double *) NULL) &&
(dasharray != (double *) NULL))
{
p=dasharray;
q=CurrentContext->dash_pattern;
for (i=0; i < (ssize_t) n_new; i++)
{
if (fabs((*p)-(*q)) >= MagickEpsilon)
{
update=MagickTrue;
break;
}
p++;
q++;
}
}
if ((wand->filter_off != MagickFalse) || (update != MagickFalse))
{
if (CurrentContext->dash_pattern != (double *) NULL)
CurrentContext->dash_pattern=(double *)
RelinquishMagickMemory(CurrentContext->dash_pattern);
if (n_new != 0)
{
CurrentContext->dash_pattern=(double *) AcquireQuantumMemory((size_t)
n_new+1UL,sizeof(*CurrentContext->dash_pattern));
if (CurrentContext->dash_pattern == (double *) NULL)
{
ThrowDrawException(ResourceLimitError,"MemoryAllocationFailed",
wand->name);
return(MagickFalse);
}
for (i=0; i < (ssize_t) n_new; i++)
{
CurrentContext->dash_pattern[i]=0.0;
if (dasharray != (double *) NULL)
CurrentContext->dash_pattern[i]=dasharray[i];
}
CurrentContext->dash_pattern[n_new]=0.0;
}
(void) MVGPrintf(wand,"stroke-dasharray ");
if (n_new == 0)
(void) MVGPrintf(wand,"none\n");
else
if (dasharray != (double *) NULL)
{
for (i=0; i < (ssize_t) n_new; i++)
{
if (i != 0)
(void) MVGPrintf(wand,",");
(void) MVGPrintf(wand,"%.20g",dasharray[i]);
}
(void) MVGPrintf(wand,"\n");
}
}
return(MagickTrue);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t S t r o k e D a s h O f f s e t %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetStrokeDashOffset() specifies the offset into the dash pattern to
% start the dash.
%
% The format of the DrawSetStrokeDashOffset method is:
%
% void DrawSetStrokeDashOffset(DrawingWand *wand,
% const double dash_offset)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o dash_offset: dash offset
%
*/
WandExport void DrawSetStrokeDashOffset(DrawingWand *wand,
const double dash_offset)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if ((wand->filter_off != MagickFalse) ||
(fabs(CurrentContext->dash_offset-dash_offset) >= MagickEpsilon))
{
CurrentContext->dash_offset=dash_offset;
(void) MVGPrintf(wand,"stroke-dashoffset %.20g\n",dash_offset);
}
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t S t r o k e L i n e C a p %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetStrokeLineCap() specifies the shape to be used at the end of
% open subpaths when they are stroked. Values of LineCap are
% UndefinedCap, ButtCap, RoundCap, and SquareCap.
%
% The format of the DrawSetStrokeLineCap method is:
%
% void DrawSetStrokeLineCap(DrawingWand *wand,
% const LineCap linecap)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o linecap: linecap style
%
*/
WandExport void DrawSetStrokeLineCap(DrawingWand *wand,const LineCap linecap)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if ((wand->filter_off != MagickFalse) || (CurrentContext->linecap != linecap))
{
CurrentContext->linecap=linecap;
(void) MVGPrintf(wand,"stroke-linecap '%s'\n",CommandOptionToMnemonic(
MagickLineCapOptions,(ssize_t) linecap));
}
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t S t r o k e L i n e J o i n %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetStrokeLineJoin() specifies 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.
%
% The format of the DrawSetStrokeLineJoin method is:
%
% void DrawSetStrokeLineJoin(DrawingWand *wand,
% const LineJoin linejoin)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o linejoin: line join style
%
*/
WandExport void DrawSetStrokeLineJoin(DrawingWand *wand,const LineJoin linejoin)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if ((wand->filter_off != MagickFalse) ||
(CurrentContext->linejoin != linejoin))
{
CurrentContext->linejoin=linejoin;
(void) MVGPrintf(wand, "stroke-linejoin '%s'\n",CommandOptionToMnemonic(
MagickLineJoinOptions,(ssize_t) linejoin));
}
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t S t r o k e M i t e r L i m i t %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetStrokeMiterLimit() specifies the 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 format of the DrawSetStrokeMiterLimit method is:
%
% void DrawSetStrokeMiterLimit(DrawingWand *wand,
% const size_t miterlimit)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o miterlimit: miter limit
%
*/
WandExport void DrawSetStrokeMiterLimit(DrawingWand *wand,
const size_t miterlimit)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if (CurrentContext->miterlimit != miterlimit)
{
CurrentContext->miterlimit=miterlimit;
(void) MVGPrintf(wand,"stroke-miterlimit %.20g\n",(double) miterlimit);
}
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t S t r o k e O p a c i t y %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetStrokeOpacity() specifies the alpha of stroked object outlines.
%
% The format of the DrawSetStrokeOpacity method is:
%
% void DrawSetStrokeOpacity(DrawingWand *wand,
% const double stroke_alpha)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o opacity: stroke opacity. The value 1.0 is opaque.
%
*/
WandExport void DrawSetStrokeOpacity(DrawingWand *wand,
const double opacity)
{
double
alpha;
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
alpha=(double) ClampToQuantum(QuantumRange*opacity);
if ((wand->filter_off != MagickFalse) ||
(CurrentContext->stroke.alpha != alpha))
{
CurrentContext->stroke.alpha=alpha;
(void) MVGPrintf(wand,"stroke-opacity %.20g\n",opacity);
}
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t S t r o k e W i d t h %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetStrokeWidth() sets the width of the stroke used to draw object
% outlines.
%
% The format of the DrawSetStrokeWidth method is:
%
% void DrawSetStrokeWidth(DrawingWand *wand,
% const double stroke_width)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o stroke_width: stroke width
%
*/
WandExport void DrawSetStrokeWidth(DrawingWand *wand,const double stroke_width)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if ((wand->filter_off != MagickFalse) ||
(fabs(CurrentContext->stroke_width-stroke_width) >= MagickEpsilon))
{
CurrentContext->stroke_width=stroke_width;
(void) MVGPrintf(wand,"stroke-width %.20g\n",stroke_width);
}
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t T e x t A l i g n m e n t %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetTextAlignment() specifies a text alignment to be applied when
% annotating with text.
%
% The format of the DrawSetTextAlignment method is:
%
% void DrawSetTextAlignment(DrawingWand *wand,const AlignType alignment)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o alignment: text alignment. One of UndefinedAlign, LeftAlign,
% CenterAlign, or RightAlign.
%
*/
WandExport void DrawSetTextAlignment(DrawingWand *wand,
const AlignType alignment)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if ((wand->filter_off != MagickFalse) ||
(CurrentContext->align != alignment))
{
CurrentContext->align=alignment;
(void) MVGPrintf(wand,"text-align '%s'\n",CommandOptionToMnemonic(
MagickAlignOptions,(ssize_t) alignment));
}
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t T e x t A n t i a l i a s %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetTextAntialias() controls whether text is antialiased. Text is
% antialiased by default.
%
% The format of the DrawSetTextAntialias method is:
%
% void DrawSetTextAntialias(DrawingWand *wand,
% const MagickBooleanType text_antialias)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o text_antialias: antialias boolean. Set to false (0) to disable
% antialiasing.
%
*/
WandExport void DrawSetTextAntialias(DrawingWand *wand,
const MagickBooleanType text_antialias)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if ((wand->filter_off != MagickFalse) ||
(CurrentContext->text_antialias != text_antialias))
{
CurrentContext->text_antialias=text_antialias;
(void) MVGPrintf(wand,"text-antialias %i\n",text_antialias != 0 ? 1 : 0);
}
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t T e x t D e c o r a t i o n %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetTextDecoration() specifies a decoration to be applied when
% annotating with text.
%
% The format of the DrawSetTextDecoration method is:
%
% void DrawSetTextDecoration(DrawingWand *wand,
% const DecorationType decoration)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o decoration: text decoration. One of NoDecoration, UnderlineDecoration,
% OverlineDecoration, or LineThroughDecoration
%
*/
WandExport void DrawSetTextDecoration(DrawingWand *wand,
const DecorationType decoration)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if ((wand->filter_off != MagickFalse) ||
(CurrentContext->decorate != decoration))
{
CurrentContext->decorate=decoration;
(void) MVGPrintf(wand,"decorate '%s'\n",CommandOptionToMnemonic(
MagickDecorateOptions,(ssize_t) decoration));
}
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t T e x t D i r e c t i o n %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetTextDirection() specifies the direction to be used when
% annotating with text.
%
% The format of the DrawSetTextDirection method is:
%
% void DrawSetTextDirection(DrawingWand *wand,
% const DirectionType direction)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o direction: text direction. One of RightToLeftDirection,
% LeftToRightDirection
%
*/
WandExport void DrawSetTextDirection(DrawingWand *wand,
const DirectionType direction)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if ((wand->filter_off != MagickFalse) ||
(CurrentContext->direction != direction))
{
CurrentContext->direction=direction;
(void) MVGPrintf(wand,"direction '%s'\n",CommandOptionToMnemonic(
MagickDirectionOptions,(ssize_t) direction));
}
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t T e x t E n c o d i n g %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetTextEncoding() 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.
%
% The format of the DrawSetTextEncoding method is:
%
% void DrawSetTextEncoding(DrawingWand *wand,const char *encoding)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o encoding: character string specifying text encoding
%
*/
WandExport void DrawSetTextEncoding(DrawingWand *wand,const char *encoding)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
assert(encoding != (char *) NULL);
if ((wand->filter_off != MagickFalse) ||
(CurrentContext->encoding == (char *) NULL) ||
(LocaleCompare(CurrentContext->encoding,encoding) != 0))
{
(void) CloneString(&CurrentContext->encoding,encoding);
(void) MVGPrintf(wand,"encoding '%s'\n",encoding);
}
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t T e x t K e r n i n g %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetTextKerning() sets the spacing between characters in text.
%
% The format of the DrawSetTextKerning method is:
%
% void DrawSetTextKerning(DrawingWand *wand,const double kerning)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o kerning: text kerning
%
*/
WandExport void DrawSetTextKerning(DrawingWand *wand,const double kerning)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if ((wand->filter_off != MagickFalse) &&
(fabs((CurrentContext->kerning-kerning)) >= MagickEpsilon))
{
CurrentContext->kerning=kerning;
(void) MVGPrintf(wand,"kerning %lf\n",kerning);
}
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t T e x t I n t e r l i n e S p a c i n g %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetTextInterlineSpacing() sets the spacing between line in text.
%
% The format of the DrawSetInterlineSpacing method is:
%
% void DrawSetTextInterlineSpacing(DrawingWand *wand,
% const double interline_spacing)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o interline_spacing: text line spacing
%
*/
WandExport void DrawSetTextInterlineSpacing(DrawingWand *wand,
const double interline_spacing)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if ((wand->filter_off != MagickFalse) ||
(fabs((CurrentContext->interline_spacing-
interline_spacing)) >= MagickEpsilon))
{
CurrentContext->interline_spacing=interline_spacing;
(void) MVGPrintf(wand,"interline-spacing %lf\n",interline_spacing);
}
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t T e x t I n t e r w o r d S p a c i n g %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetTextInterwordSpacing() sets the spacing between words in text.
%
% The format of the DrawSetInterwordSpacing method is:
%
% void DrawSetTextInterwordSpacing(DrawingWand *wand,
% const double interword_spacing)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o interword_spacing: text word spacing
%
*/
WandExport void DrawSetTextInterwordSpacing(DrawingWand *wand,
const double interword_spacing)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if ((wand->filter_off != MagickFalse) ||
(fabs((CurrentContext->interword_spacing-
interword_spacing)) >= MagickEpsilon))
{
CurrentContext->interword_spacing=interword_spacing;
(void) MVGPrintf(wand,"interword-spacing %lf\n",interword_spacing);
}
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t T e x t U n d e r C o l o r %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetTextUnderColor() specifies the color of a background rectangle
% to place under text annotations.
%
% The format of the DrawSetTextUnderColor method is:
%
% void DrawSetTextUnderColor(DrawingWand *wand,
% const PixelWand *under_wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o under_wand: text under wand.
%
*/
WandExport void DrawSetTextUnderColor(DrawingWand *wand,
const PixelWand *under_wand)
{
PixelInfo
under_color;
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
assert(under_wand != (const PixelWand *) NULL);
PixelGetQuantumPacket(under_wand,&under_color);
if ((wand->filter_off != MagickFalse) ||
(IsPixelInfoEquivalent(&CurrentContext->undercolor,&under_color) == MagickFalse))
{
CurrentContext->undercolor=under_color;
(void) MVGPrintf(wand,"text-undercolor '");
MVGAppendColor(wand,&under_color);
(void) MVGPrintf(wand,"'\n");
}
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t V e c t o r G r a p h i c s %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetVectorGraphics() sets the vector graphics associated with the
% specified wand. Use this method with DrawGetVectorGraphics() as a method
% to persist the vector graphics state.
%
% The format of the DrawSetVectorGraphics method is:
%
% MagickBooleanType DrawSetVectorGraphics(DrawingWand *wand,
% const char *xml)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o xml: the drawing wand XML.
%
*/
static inline MagickBooleanType IsPoint(const char *point)
{
char
*p;
long
value;
value=strtol(point,&p,10);
(void) value;
return(p != point ? MagickTrue : MagickFalse);
}
WandExport MagickBooleanType DrawSetVectorGraphics(DrawingWand *wand,
const char *xml)
{
const char
*value;
XMLTreeInfo
*child,
*xml_info;
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
CurrentContext=DestroyDrawInfo(CurrentContext);
CurrentContext=CloneDrawInfo((ImageInfo *) NULL,(DrawInfo *) NULL);
if (xml == (const char *) NULL)
return(MagickFalse);
xml_info=NewXMLTree(xml,wand->exception);
if (xml_info == (XMLTreeInfo *) NULL)
return(MagickFalse);
child=GetXMLTreeChild(xml_info,"clip-path");
if (child != (XMLTreeInfo *) NULL)
(void) CloneString(&CurrentContext->clip_mask,GetXMLTreeContent(child));
child=GetXMLTreeChild(xml_info,"clip-units");
if (child != (XMLTreeInfo *) NULL)
{
value=GetXMLTreeContent(child);
if (value != (const char *) NULL)
CurrentContext->clip_units=(ClipPathUnits) ParseCommandOption(
MagickClipPathOptions,MagickFalse,value);
}
child=GetXMLTreeChild(xml_info,"decorate");
if (child != (XMLTreeInfo *) NULL)
{
value=GetXMLTreeContent(child);
if (value != (const char *) NULL)
CurrentContext->decorate=(DecorationType) ParseCommandOption(
MagickDecorateOptions,MagickFalse,value);
}
child=GetXMLTreeChild(xml_info,"encoding");
if (child != (XMLTreeInfo *) NULL)
(void) CloneString(&CurrentContext->encoding,GetXMLTreeContent(child));
child=GetXMLTreeChild(xml_info,"fill");
if (child != (XMLTreeInfo *) NULL)
{
value=GetXMLTreeContent(child);
if (value != (const char *) NULL)
(void) QueryColorCompliance(value,AllCompliance,&CurrentContext->fill,
wand->exception);
}
child=GetXMLTreeChild(xml_info,"fill-opacity");
if (child != (XMLTreeInfo *) NULL)
{
value=GetXMLTreeContent(child);
if (value != (const char *) NULL)
CurrentContext->fill.alpha=(double) ClampToQuantum(QuantumRange*
(1.0-StringToDouble(value,(char **) NULL)));
}
child=GetXMLTreeChild(xml_info,"fill-rule");
if (child != (XMLTreeInfo *) NULL)
{
value=GetXMLTreeContent(child);
if (value != (const char *) NULL)
CurrentContext->fill_rule=(FillRule) ParseCommandOption(
MagickFillRuleOptions,MagickFalse,value);
}
child=GetXMLTreeChild(xml_info,"font");
if (child != (XMLTreeInfo *) NULL)
(void) CloneString(&CurrentContext->font,GetXMLTreeContent(child));
child=GetXMLTreeChild(xml_info,"font-family");
if (child != (XMLTreeInfo *) NULL)
(void) CloneString(&CurrentContext->family,GetXMLTreeContent(child));
child=GetXMLTreeChild(xml_info,"font-size");
if (child != (XMLTreeInfo *) NULL)
{
value=GetXMLTreeContent(child);
if (value != (const char *) NULL)
CurrentContext->pointsize=StringToDouble(value,(char **) NULL);
}
child=GetXMLTreeChild(xml_info,"font-stretch");
if (child != (XMLTreeInfo *) NULL)
{
value=GetXMLTreeContent(child);
if (value != (const char *) NULL)
CurrentContext->stretch=(StretchType) ParseCommandOption(
MagickStretchOptions,MagickFalse,value);
}
child=GetXMLTreeChild(xml_info,"font-style");
if (child != (XMLTreeInfo *) NULL)
{
value=GetXMLTreeContent(child);
if (value != (const char *) NULL)
CurrentContext->style=(StyleType) ParseCommandOption(MagickStyleOptions,
MagickFalse,value);
}
child=GetXMLTreeChild(xml_info,"font-weight");
if (child != (XMLTreeInfo *) NULL)
{
value=GetXMLTreeContent(child);
if (value != (const char *) NULL)
{
ssize_t
weight;
weight=ParseCommandOption(MagickWeightOptions,MagickFalse,value);
if (weight == -1)
weight=(ssize_t) StringToUnsignedLong(value);
CurrentContext->weight=(size_t) weight;
}
}
child=GetXMLTreeChild(xml_info,"gravity");
if (child != (XMLTreeInfo *) NULL)
{
value=GetXMLTreeContent(child);
if (value != (const char *) NULL)
CurrentContext->gravity=(GravityType) ParseCommandOption(
MagickGravityOptions,MagickFalse,value);
}
child=GetXMLTreeChild(xml_info,"stroke");
if (child != (XMLTreeInfo *) NULL)
{
value=GetXMLTreeContent(child);
if (value != (const char *) NULL)
(void) QueryColorCompliance(value,AllCompliance,&CurrentContext->stroke,
wand->exception);
}
child=GetXMLTreeChild(xml_info,"stroke-antialias");
if (child != (XMLTreeInfo *) NULL)
{
value=GetXMLTreeContent(child);
if (value != (const char *) NULL)
CurrentContext->stroke_antialias=StringToLong(value) != 0 ? MagickTrue :
MagickFalse;
}
child=GetXMLTreeChild(xml_info,"stroke-dasharray");
if (child != (XMLTreeInfo *) NULL)
{
char
token[MagickPathExtent];
const char
*q;
register ssize_t
x;
ssize_t
j;
value=GetXMLTreeContent(child);
if (value != (const char *) NULL)
{
if (CurrentContext->dash_pattern != (double *) NULL)
CurrentContext->dash_pattern=(double *) RelinquishMagickMemory(
CurrentContext->dash_pattern);
q=(char *) value;
if (IsPoint(q) != MagickFalse)
{
const char
*p;
p=q;
(void) GetNextToken(p,&p,MagickPathExtent,token);
if (*token == ',')
(void) GetNextToken(p,&p,MagickPathExtent,token);
for (x=0; IsPoint(token) != MagickFalse; x++)
{
(void) GetNextToken(p,&p,MagickPathExtent,token);
if (*token == ',')
(void) GetNextToken(p,&p,MagickPathExtent,token);
}
CurrentContext->dash_pattern=(double *) AcquireQuantumMemory(
(size_t) (2UL*x)+1UL,sizeof(*CurrentContext->dash_pattern));
if (CurrentContext->dash_pattern == (double *) NULL)
ThrowWandFatalException(ResourceLimitFatalError,
"MemoryAllocationFailed",wand->name);
for (j=0; j < x; j++)
{
(void) GetNextToken(q,&q,MagickPathExtent,token);
if (*token == ',')
(void) GetNextToken(q,&q,MagickPathExtent,token);
CurrentContext->dash_pattern[j]=StringToDouble(token,
(char **) NULL);
}
if ((x & 0x01) != 0)
for ( ; j < (2*x); j++)
CurrentContext->dash_pattern[j]=
CurrentContext->dash_pattern[j-x];
CurrentContext->dash_pattern[j]=0.0;
}
}
}
child=GetXMLTreeChild(xml_info,"stroke-dashoffset");
if (child != (XMLTreeInfo *) NULL)
{
value=GetXMLTreeContent(child);
if (value != (const char *) NULL)
CurrentContext->dash_offset=StringToDouble(value,(char **) NULL);
}
child=GetXMLTreeChild(xml_info,"stroke-linecap");
if (child != (XMLTreeInfo *) NULL)
{
value=GetXMLTreeContent(child);
if (value != (const char *) NULL)
CurrentContext->linecap=(LineCap) ParseCommandOption(
MagickLineCapOptions,MagickFalse,value);
}
child=GetXMLTreeChild(xml_info,"stroke-linejoin");
if (child != (XMLTreeInfo *) NULL)
{
value=GetXMLTreeContent(child);
if (value != (const char *) NULL)
CurrentContext->linejoin=(LineJoin) ParseCommandOption(
MagickLineJoinOptions,MagickFalse,value);
}
child=GetXMLTreeChild(xml_info,"stroke-miterlimit");
if (child != (XMLTreeInfo *) NULL)
{
value=GetXMLTreeContent(child);
if (value != (const char *) NULL)
CurrentContext->miterlimit=StringToUnsignedLong(value);
}
child=GetXMLTreeChild(xml_info,"stroke-opacity");
if (child != (XMLTreeInfo *) NULL)
{
value=GetXMLTreeContent(child);
if (value != (const char *) NULL)
CurrentContext->stroke.alpha=(double) ClampToQuantum(QuantumRange*
(1.0-StringToDouble(value,(char **) NULL)));
}
child=GetXMLTreeChild(xml_info,"stroke-width");
if (child != (XMLTreeInfo *) NULL)
{
value=GetXMLTreeContent(child);
if (value != (const char *) NULL)
{
ssize_t
weight;
weight=ParseCommandOption(MagickWeightOptions,MagickFalse,value);
if (weight == -1)
weight=(ssize_t) StringToUnsignedLong(value);
CurrentContext->stroke_width=(double) weight;
}
}
child=GetXMLTreeChild(xml_info,"text-align");
if (child != (XMLTreeInfo *) NULL)
{
value=GetXMLTreeContent(child);
if (value != (const char *) NULL)
CurrentContext->align=(AlignType) ParseCommandOption(MagickAlignOptions,
MagickFalse,value);
}
child=GetXMLTreeChild(xml_info,"text-antialias");
if (child != (XMLTreeInfo *) NULL)
{
value=GetXMLTreeContent(child);
if (value != (const char *) NULL)
CurrentContext->text_antialias=StringToLong(value) != 0 ? MagickTrue :
MagickFalse;
}
child=GetXMLTreeChild(xml_info,"text-undercolor");
if (child != (XMLTreeInfo *) NULL)
{
value=GetXMLTreeContent(child);
if (value != (const char *) NULL)
(void) QueryColorCompliance(value,AllCompliance,
&CurrentContext->undercolor,wand->exception);
}
child=GetXMLTreeChild(xml_info,"vector-graphics");
if (child != (XMLTreeInfo *) NULL)
{
(void) CloneString(&wand->mvg,GetXMLTreeContent(child));
wand->mvg_length=strlen(wand->mvg);
wand->mvg_alloc=wand->mvg_length+1;
}
xml_info=DestroyXMLTree(xml_info);
return(MagickTrue);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S k e w X %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSkewX() skews the current coordinate system in the horizontal
% direction.
%
% The format of the DrawSkewX method is:
%
% void DrawSkewX(DrawingWand *wand,const double degrees)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o degrees: number of degrees to skew the coordinates
%
*/
WandExport void DrawSkewX(DrawingWand *wand,const double degrees)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
(void) MVGPrintf(wand,"skewX %.20g\n",degrees);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S k e w Y %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSkewY() skews the current coordinate system in the vertical
% direction.
%
% The format of the DrawSkewY method is:
%
% void DrawSkewY(DrawingWand *wand,const double degrees)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o degrees: number of degrees to skew the coordinates
%
*/
WandExport void DrawSkewY(DrawingWand *wand,const double degrees)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
(void) MVGPrintf(wand,"skewY %.20g\n",degrees);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w T r a n s l a t e %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawTranslate() applies a translation to the current coordinate
% system which moves the coordinate system origin to the specified
% coordinate.
%
% The format of the DrawTranslate method is:
%
% void DrawTranslate(DrawingWand *wand,const double x,
% const double y)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o x: new x ordinate for coordinate system origin
%
% o y: new y ordinate for coordinate system origin
%
*/
WandExport void DrawTranslate(DrawingWand *wand,const double x,const double y)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
(void) MVGPrintf(wand,"translate %.20g %.20g\n",x,y);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% D r a w S e t V i e w b o x %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DrawSetViewbox() sets the overall canvas size to be recorded with the
% drawing vector data. Usually this will be specified using the same
% size as the canvas image. When the vector data is saved to SVG or MVG
% formats, the viewbox is use to specify the size of the canvas image that
% a viewer will render the vector data on.
%
% The format of the DrawSetViewbox method is:
%
% void DrawSetViewbox(DrawingWand *wand,const double x1,const double y1,
% const double x2,const double y2)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
% o x1: left x ordinate
%
% o y1: top y ordinate
%
% o x2: right x ordinate
%
% o y2: bottom y ordinate
%
*/
WandExport void DrawSetViewbox(DrawingWand *wand,const double x1,
const double y1,const double x2,const double y2)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
(void) MVGPrintf(wand,"viewbox %.20g %.20g %.20g %.20g\n",x1,y1,x2,y2);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% I s D r a w i n g W a n d %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% IsDrawingWand() returns MagickTrue if the wand is verified as a drawing wand.
%
% The format of the IsDrawingWand method is:
%
% MagickBooleanType IsDrawingWand(const DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport MagickBooleanType IsDrawingWand(const DrawingWand *wand)
{
if (wand == (const DrawingWand *) NULL)
return(MagickFalse);
if (wand->signature != MagickWandSignature)
return(MagickFalse);
if (LocaleNCompare(wand->name,DrawingWandId,strlen(DrawingWandId)) != 0)
return(MagickFalse);
return(MagickTrue);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% N e w D r a w i n g W a n d %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% NewDrawingWand() returns a drawing wand required for all other methods in
% the API.
%
% The format of the NewDrawingWand method is:
%
% DrawingWand *NewDrawingWand(void)
%
*/
WandExport DrawingWand *NewDrawingWand(void)
{
const char
*quantum;
DrawingWand
*wand;
size_t
depth;
quantum=GetMagickQuantumDepth(&depth);
if (depth != MAGICKCORE_QUANTUM_DEPTH)
ThrowWandFatalException(WandError,"QuantumDepthMismatch",quantum);
wand=(DrawingWand *) AcquireMagickMemory(sizeof(*wand));
if (wand == (DrawingWand *) NULL)
ThrowWandFatalException(ResourceLimitFatalError,"MemoryAllocationFailed",
GetExceptionMessage(errno));
(void) memset(wand,0,sizeof(*wand));
wand->id=AcquireWandId();
(void) FormatLocaleString(wand->name,MagickPathExtent,"%s-%.20g",
DrawingWandId,(double) wand->id);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
wand->mvg=(char *) NULL;
wand->mvg_alloc=0;
wand->mvg_length=0;
wand->mvg_width=0;
wand->pattern_id=(char *) NULL;
wand->pattern_offset=0;
wand->pattern_bounds.x=0;
wand->pattern_bounds.y=0;
wand->pattern_bounds.width=0;
wand->pattern_bounds.height=0;
wand->index=0;
wand->graphic_context=(DrawInfo **) AcquireMagickMemory(sizeof(
*wand->graphic_context));
if (wand->graphic_context == (DrawInfo **) NULL)
ThrowWandFatalException(ResourceLimitFatalError,"MemoryAllocationFailed",
GetExceptionMessage(errno));
wand->filter_off=MagickTrue;
wand->indent_depth=0;
wand->path_operation=PathDefaultOperation;
wand->path_mode=DefaultPathMode;
wand->exception=AcquireExceptionInfo();
wand->image=AcquireImage((const ImageInfo *) NULL,wand->exception);
wand->destroy=MagickTrue;
wand->debug=IsEventLogging();
wand->signature=MagickWandSignature;
CurrentContext=CloneDrawInfo((ImageInfo *) NULL,(DrawInfo *) NULL);
return(wand);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% P e e k D r a w i n g W a n d %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% PeekDrawingWand() returns the current drawing wand.
%
% The format of the PeekDrawingWand method is:
%
% DrawInfo *PeekDrawingWand(const DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport DrawInfo *PeekDrawingWand(const DrawingWand *wand)
{
DrawInfo
*draw_info;
assert(wand != (const DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
draw_info=CloneDrawInfo((ImageInfo *) NULL,CurrentContext);
(void) CloneString(&draw_info->primitive,wand->mvg);
return(draw_info);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% P o p D r a w i n g W a n d %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% PopDrawingWand() destroys the current drawing wand and returns to the
% previously pushed drawing wand. Multiple drawing wands may exist. It is an
% error to attempt to pop more drawing wands than have been pushed, and it is
% proper form to pop all drawing wands which have been pushed.
%
% The format of the PopDrawingWand method is:
%
% MagickBooleanType PopDrawingWand(DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport MagickBooleanType PopDrawingWand(DrawingWand *wand)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
if (wand->index == 0)
{
ThrowDrawException(DrawError,"UnbalancedGraphicContextPushPop",wand->name)
return(MagickFalse);
}
/*
Destroy clip path if not same in preceding wand.
*/
#if DRAW_BINARY_IMPLEMENTATION
if (wand->image == (Image *) NULL)
ThrowDrawException(WandError,"ContainsNoImages",wand->name);
if (CurrentContext->clip_mask != (char *) NULL)
if (LocaleCompare(CurrentContext->clip_mask,
wand->graphic_context[wand->index-1]->clip_mask) != 0)
(void) SetImageMask(wand->image,WritePixelMask,(Image *) NULL,
wand->exception);
#endif
CurrentContext=DestroyDrawInfo(CurrentContext);
wand->index--;
if (wand->indent_depth > 0)
wand->indent_depth--;
(void) MVGPrintf(wand,"pop graphic-context\n");
return(MagickTrue);
}
/*
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% %
% %
% %
% P u s h D r a w i n g W a n d %
% %
% %
% %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% PushDrawingWand() clones the current drawing wand to create a new drawing
% wand. The original drawing wand(s) may be returned to by invoking
% PopDrawingWand(). The drawing wands are stored on a drawing wand stack.
% For every Pop there must have already been an equivalent Push.
%
% The format of the PushDrawingWand method is:
%
% MagickBooleanType PushDrawingWand(DrawingWand *wand)
%
% A description of each parameter follows:
%
% o wand: the drawing wand.
%
*/
WandExport MagickBooleanType PushDrawingWand(DrawingWand *wand)
{
assert(wand != (DrawingWand *) NULL);
assert(wand->signature == MagickWandSignature);
if (wand->debug != MagickFalse)
(void) LogMagickEvent(WandEvent,GetMagickModule(),"%s",wand->name);
wand->index++;
wand->graphic_context=(DrawInfo **) ResizeQuantumMemory(wand->graphic_context,
(size_t) wand->index+1UL,sizeof(*wand->graphic_context));
if (wand->graphic_context == (DrawInfo **) NULL)
{
wand->index--;
ThrowDrawException(ResourceLimitError,"MemoryAllocationFailed",
wand->name);
return(MagickFalse);
}
CurrentContext=CloneDrawInfo((ImageInfo *) NULL,
wand->graphic_context[wand->index-1]);
(void) MVGPrintf(wand,"push graphic-context\n");
wand->indent_depth++;
return(MagickTrue);
}