/* %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % % % % % % 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-2019 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); #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); #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; GetNextToken(p,&p,MagickPathExtent,token); if (*token == ',') GetNextToken(p,&p,MagickPathExtent,token); for (x=0; IsPoint(token) != MagickFalse; x++) { GetNextToken(p,&p,MagickPathExtent,token); if (*token == ',') 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++) { GetNextToken(q,&q,MagickPathExtent,token); if (*token == ',') 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); }