2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
6 % AAA N N N N OOO TTTTT AAA TTTTT EEEEE %
7 % A A NN N NN N O O T A A T E %
8 % AAAAA N N N N N N O O T AAAAA T EEE %
9 % A A N NN N NN O O T A A T E %
10 % A A N N N N OOO T A A T EEEEE %
13 % MagickCore Image Annotation Methods %
20 % Copyright 1999-2011 ImageMagick Studio LLC, a non-profit organization %
21 % dedicated to making software imaging solutions freely available. %
23 % You may not use this file except in compliance with the License. You may %
24 % obtain a copy of the License at %
26 % http://www.imagemagick.org/script/license.php %
28 % Unless required by applicable law or agreed to in writing, software %
29 % distributed under the License is distributed on an "AS IS" BASIS, %
30 % WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. %
31 % See the License for the specific language governing permissions and %
32 % limitations under the License. %
34 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
36 % Digital Applications (www.digapp.com) contributed the stroked text algorithm.
37 % It was written by Leonard Rosenthol.
45 #include "MagickCore/studio.h"
46 #include "MagickCore/annotate.h"
47 #include "MagickCore/annotate-private.h"
48 #include "MagickCore/attribute.h"
49 #include "MagickCore/cache-view.h"
50 #include "MagickCore/client.h"
51 #include "MagickCore/color.h"
52 #include "MagickCore/color-private.h"
53 #include "MagickCore/composite.h"
54 #include "MagickCore/composite-private.h"
55 #include "MagickCore/constitute.h"
56 #include "MagickCore/draw.h"
57 #include "MagickCore/draw-private.h"
58 #include "MagickCore/exception.h"
59 #include "MagickCore/exception-private.h"
60 #include "MagickCore/gem.h"
61 #include "MagickCore/geometry.h"
62 #include "MagickCore/image-private.h"
63 #include "MagickCore/log.h"
64 #include "MagickCore/quantum.h"
65 #include "MagickCore/quantum-private.h"
66 #include "MagickCore/pixel-accessor.h"
67 #include "MagickCore/property.h"
68 #include "MagickCore/resource_.h"
69 #include "MagickCore/semaphore.h"
70 #include "MagickCore/statistic.h"
71 #include "MagickCore/string_.h"
72 #include "MagickCore/token-private.h"
73 #include "MagickCore/transform.h"
74 #include "MagickCore/type.h"
75 #include "MagickCore/utility.h"
76 #include "MagickCore/utility-private.h"
77 #include "MagickCore/xwindow.h"
78 #include "MagickCore/xwindow-private.h"
79 #if defined(MAGICKCORE_FREETYPE_DELEGATE)
80 #if defined(__MINGW32__)
83 #if defined(MAGICKCORE_HAVE_FT2BUILD_H)
84 # include <ft2build.h>
86 #if defined(FT_FREETYPE_H)
87 # include FT_FREETYPE_H
89 # include <freetype/freetype.h>
91 #if defined(FT_GLYPH_H)
94 # include <freetype/ftglyph.h>
96 #if defined(FT_OUTLINE_H)
97 # include FT_OUTLINE_H
99 # include <freetype/ftoutln.h>
101 #if defined(FT_BBOX_H)
104 # include <freetype/ftbbox.h>
105 #endif /* defined(FT_BBOX_H) */
112 *annotate_semaphore = (SemaphoreInfo *) NULL;
115 Forward declarations.
117 static MagickBooleanType
118 RenderType(Image *,const DrawInfo *,const PointInfo *,TypeMetric *,
120 RenderPostscript(Image *,const DrawInfo *,const PointInfo *,TypeMetric *,
122 RenderFreetype(Image *,const DrawInfo *,const char *,const PointInfo *,
123 TypeMetric *,ExceptionInfo *),
124 RenderX11(Image *,const DrawInfo *,const PointInfo *,TypeMetric *,
128 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
132 + A n n o t a t e C o m p o n e n t G e n e s i s %
136 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
138 % AnnotateComponentGenesis() instantiates the annotate component.
140 % The format of the AnnotateComponentGenesis method is:
142 % MagickBooleanType AnnotateComponentGenesis(void)
145 MagickPrivate MagickBooleanType AnnotateComponentGenesis(void)
147 AcquireSemaphoreInfo(&annotate_semaphore);
152 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
156 + A n n o t a t e C o m p o n e n t T e r m i n u s %
160 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
162 % AnnotateComponentTerminus() destroys the annotate component.
164 % The format of the AnnotateComponentTerminus method is:
166 % AnnotateComponentTerminus(void)
169 MagickPrivate void AnnotateComponentTerminus(void)
171 if (annotate_semaphore == (SemaphoreInfo *) NULL)
172 AcquireSemaphoreInfo(&annotate_semaphore);
173 DestroySemaphoreInfo(&annotate_semaphore);
177 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
181 % A n n o t a t e I m a g e %
185 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
187 % AnnotateImage() annotates an image with text. Optionally you can include
188 % any of the following bits of information about the image by embedding
189 % the appropriate special characters:
191 % %b file size in bytes.
193 % %d directory in which the image resides.
194 % %e extension of the image file.
195 % %f original filename of the image.
196 % %h height of image.
197 % %i filename of the image.
198 % %k number of unique colors.
200 % %m image file format.
201 % %n number of images in a image sequence.
202 % %o output image filename.
203 % %p page number of the image.
204 % %q image depth (8 or 16).
205 % %q image depth (8 or 16).
206 % %s image scene number.
207 % %t image filename without any extension.
208 % %u a unique temporary filename.
210 % %x x resolution of the image.
211 % %y y resolution of the image.
213 % The format of the AnnotateImage method is:
215 % MagickBooleanType AnnotateImage(Image *image,DrawInfo *draw_info,
216 % ExceptionInfo *exception)
218 % A description of each parameter follows:
220 % o image: the image.
222 % o draw_info: the draw info.
224 % o exception: return any errors or warnings in this structure.
227 MagickExport MagickBooleanType AnnotateImage(Image *image,
228 const DrawInfo *draw_info,ExceptionInfo *exception)
231 primitive[MaxTextExtent],
263 assert(image != (Image *) NULL);
264 assert(image->signature == MagickSignature);
265 if (image->debug != MagickFalse)
266 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
267 assert(draw_info != (DrawInfo *) NULL);
268 assert(draw_info->signature == MagickSignature);
269 if (draw_info->text == (char *) NULL)
271 if (*draw_info->text == '\0')
273 textlist=StringToList(draw_info->text);
274 if (textlist == (char **) NULL)
276 length=strlen(textlist[0]);
277 for (i=1; textlist[i] != (char *) NULL; i++)
278 if (strlen(textlist[i]) > length)
279 length=strlen(textlist[i]);
280 number_lines=(size_t) i;
281 annotate=CloneDrawInfo((ImageInfo *) NULL,draw_info);
282 annotate_info=CloneDrawInfo((ImageInfo *) NULL,draw_info);
283 SetGeometry(image,&geometry);
284 SetGeometryInfo(&geometry_info);
285 if (annotate_info->geometry != (char *) NULL)
287 (void) ParsePageGeometry(image,annotate_info->geometry,&geometry,
289 (void) ParseGeometry(annotate_info->geometry,&geometry_info);
291 if (SetImageStorageClass(image,DirectClass,exception) == MagickFalse)
294 for (i=0; textlist[i] != (char *) NULL; i++)
297 Position text relative to image.
299 annotate_info->affine.tx=geometry_info.xi-image->page.x;
300 annotate_info->affine.ty=geometry_info.psi-image->page.y;
301 (void) CloneString(&annotate->text,textlist[i]);
302 (void) GetTypeMetrics(image,annotate,&metrics,exception);
303 height=(ssize_t) (metrics.ascent-metrics.descent+
304 draw_info->interline_spacing+0.5);
305 switch (annotate->gravity)
307 case UndefinedGravity:
310 offset.x=annotate_info->affine.tx+i*annotate_info->affine.ry*height;
311 offset.y=annotate_info->affine.ty+i*annotate_info->affine.sy*height;
314 case NorthWestGravity:
316 offset.x=(geometry.width == 0 ? -1.0 : 1.0)*annotate_info->affine.tx+i*
317 annotate_info->affine.ry*height+annotate_info->affine.ry*
318 (metrics.ascent+metrics.descent);
319 offset.y=(geometry.height == 0 ? -1.0 : 1.0)*annotate_info->affine.ty+i*
320 annotate_info->affine.sy*height+annotate_info->affine.sy*
326 offset.x=(geometry.width == 0 ? -1.0 : 1.0)*annotate_info->affine.tx+
327 geometry.width/2.0+i*annotate_info->affine.ry*height-
328 annotate_info->affine.sx*(metrics.width+metrics.bounds.x1)/2.0+
329 annotate_info->affine.ry*(metrics.ascent+metrics.descent);
330 offset.y=(geometry.height == 0 ? -1.0 : 1.0)*annotate_info->affine.ty+i*
331 annotate_info->affine.sy*height+annotate_info->affine.sy*
332 metrics.ascent-annotate_info->affine.rx*(metrics.width-
333 metrics.bounds.x1)/2.0;
336 case NorthEastGravity:
338 offset.x=(geometry.width == 0 ? 1.0 : -1.0)*annotate_info->affine.tx+
339 geometry.width+i*annotate_info->affine.ry*height-
340 annotate_info->affine.sx*(metrics.width+metrics.bounds.x1)+
341 annotate_info->affine.ry*(metrics.ascent+metrics.descent)-1.0;
342 offset.y=(geometry.height == 0 ? -1.0 : 1.0)*annotate_info->affine.ty+i*
343 annotate_info->affine.sy*height+annotate_info->affine.sy*
344 metrics.ascent-annotate_info->affine.rx*(metrics.width-
350 offset.x=(geometry.width == 0 ? -1.0 : 1.0)*annotate_info->affine.tx+i*
351 annotate_info->affine.ry*height+annotate_info->affine.ry*
352 (metrics.ascent+metrics.descent-(number_lines-1.0)*height)/2.0;
353 offset.y=(geometry.height == 0 ? -1.0 : 1.0)*annotate_info->affine.ty+
354 geometry.height/2.0+i*annotate_info->affine.sy*height+
355 annotate_info->affine.sy*(metrics.ascent+metrics.descent-
356 (number_lines-1.0)*height)/2.0;
362 offset.x=(geometry.width == 0 ? -1.0 : 1.0)*annotate_info->affine.tx+
363 geometry.width/2.0+i*annotate_info->affine.ry*height-
364 annotate_info->affine.sx*(metrics.width+metrics.bounds.x1)/2.0+
365 annotate_info->affine.ry*(metrics.ascent+metrics.descent-
366 (number_lines-1)*height)/2.0;
367 offset.y=(geometry.height == 0 ? -1.0 : 1.0)*annotate_info->affine.ty+
368 geometry.height/2.0+i*annotate_info->affine.sy*height-
369 annotate_info->affine.rx*(metrics.width+metrics.bounds.x1)/2.0+
370 annotate_info->affine.sy*(metrics.ascent+metrics.descent-
371 (number_lines-1.0)*height)/2.0;
376 offset.x=(geometry.width == 0 ? 1.0 : -1.0)*annotate_info->affine.tx+
377 geometry.width+i*annotate_info->affine.ry*height-
378 annotate_info->affine.sx*(metrics.width+metrics.bounds.x1)+
379 annotate_info->affine.ry*(metrics.ascent+metrics.descent-
380 (number_lines-1.0)*height)/2.0-1.0;
381 offset.y=(geometry.height == 0 ? -1.0 : 1.0)*annotate_info->affine.ty+
382 geometry.height/2.0+i*annotate_info->affine.sy*height-
383 annotate_info->affine.rx*(metrics.width+metrics.bounds.x1)+
384 annotate_info->affine.sy*(metrics.ascent+metrics.descent-
385 (number_lines-1.0)*height)/2.0;
388 case SouthWestGravity:
390 offset.x=(geometry.width == 0 ? -1.0 : 1.0)*annotate_info->affine.tx+i*
391 annotate_info->affine.ry*height-annotate_info->affine.ry*
392 (number_lines-1.0)*height;
393 offset.y=(geometry.height == 0 ? 1.0 : -1.0)*annotate_info->affine.ty+
394 geometry.height+i*annotate_info->affine.sy*height-
395 annotate_info->affine.sy*(number_lines-1.0)*height+metrics.descent;
400 offset.x=(geometry.width == 0 ? -1.0 : 1.0)*annotate_info->affine.tx+
401 geometry.width/2.0+i*annotate_info->affine.ry*height-
402 annotate_info->affine.sx*(metrics.width+metrics.bounds.x1)/2.0-
403 annotate_info->affine.ry*(number_lines-1.0)*height/2.0;
404 offset.y=(geometry.height == 0 ? 1.0 : -1.0)*annotate_info->affine.ty+
405 geometry.height+i*annotate_info->affine.sy*height-
406 annotate_info->affine.rx*(metrics.width+metrics.bounds.x1)/2.0-
407 annotate_info->affine.sy*(number_lines-1.0)*height+metrics.descent;
410 case SouthEastGravity:
412 offset.x=(geometry.width == 0 ? 1.0 : -1.0)*annotate_info->affine.tx+
413 geometry.width+i*annotate_info->affine.ry*height-
414 annotate_info->affine.sx*(metrics.width+metrics.bounds.x1)-
415 annotate_info->affine.ry*(number_lines-1.0)*height-1.0;
416 offset.y=(geometry.height == 0 ? 1.0 : -1.0)*annotate_info->affine.ty+
417 geometry.height+i*annotate_info->affine.sy*height-
418 annotate_info->affine.rx*(metrics.width+metrics.bounds.x1)-
419 annotate_info->affine.sy*(number_lines-1.0)*height+metrics.descent;
423 switch (annotate->align)
427 offset.x=annotate_info->affine.tx+i*annotate_info->affine.ry*height;
428 offset.y=annotate_info->affine.ty+i*annotate_info->affine.sy*height;
433 offset.x=annotate_info->affine.tx+i*annotate_info->affine.ry*height-
434 annotate_info->affine.sx*(metrics.width+metrics.bounds.x1)/2.0;
435 offset.y=annotate_info->affine.ty+i*annotate_info->affine.sy*height-
436 annotate_info->affine.rx*(metrics.width+metrics.bounds.x1)/2.0;
441 offset.x=annotate_info->affine.tx+i*annotate_info->affine.ry*height-
442 annotate_info->affine.sx*(metrics.width+metrics.bounds.x1);
443 offset.y=annotate_info->affine.ty+i*annotate_info->affine.sy*height-
444 annotate_info->affine.rx*(metrics.width+metrics.bounds.x1);
450 if (draw_info->undercolor.alpha != TransparentAlpha)
458 undercolor_info=CloneDrawInfo((ImageInfo *) NULL,(DrawInfo *) NULL);
459 undercolor_info->fill=draw_info->undercolor;
460 undercolor_info->affine=draw_info->affine;
461 undercolor_info->affine.tx=offset.x-draw_info->affine.ry*metrics.ascent;
462 undercolor_info->affine.ty=offset.y-draw_info->affine.sy*metrics.ascent;
463 (void) FormatLocaleString(primitive,MaxTextExtent,
464 "rectangle 0,0 %g,%.20g",metrics.origin.x,(double) height);
465 (void) CloneString(&undercolor_info->primitive,primitive);
466 (void) DrawImage(image,undercolor_info,exception);
467 (void) DestroyDrawInfo(undercolor_info);
469 annotate_info->affine.tx=offset.x;
470 annotate_info->affine.ty=offset.y;
471 (void) FormatLocaleString(primitive,MaxTextExtent,"stroke-width %g "
472 "line 0,0 %g,0",metrics.underline_thickness,metrics.width);
473 if (annotate->decorate == OverlineDecoration)
475 annotate_info->affine.ty-=(draw_info->affine.sy*(metrics.ascent+
476 metrics.descent-metrics.underline_position));
477 (void) CloneString(&annotate_info->primitive,primitive);
478 (void) DrawImage(image,annotate_info,exception);
481 if (annotate->decorate == UnderlineDecoration)
483 annotate_info->affine.ty-=(draw_info->affine.sy*
484 metrics.underline_position);
485 (void) CloneString(&annotate_info->primitive,primitive);
486 (void) DrawImage(image,annotate_info,exception);
489 Annotate image with text.
491 status=RenderType(image,annotate,&offset,&metrics,exception);
492 if (status == MagickFalse)
494 if (annotate->decorate == LineThroughDecoration)
496 annotate_info->affine.ty-=(draw_info->affine.sy*(height+
497 metrics.underline_position+metrics.descent)/2.0);
498 (void) CloneString(&annotate_info->primitive,primitive);
499 (void) DrawImage(image,annotate_info,exception);
503 Relinquish resources.
505 annotate_info=DestroyDrawInfo(annotate_info);
506 annotate=DestroyDrawInfo(annotate);
507 for (i=0; textlist[i] != (char *) NULL; i++)
508 textlist[i]=DestroyString(textlist[i]);
509 textlist=(char **) RelinquishMagickMemory(textlist);
514 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
518 % F o r m a t M a g i c k C a p t i o n %
522 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
524 % FormatMagickCaption() formats a caption so that it fits within the image
525 % width. It returns the number of lines in the formatted caption.
527 % The format of the FormatMagickCaption method is:
529 % ssize_t FormatMagickCaption(Image *image,DrawInfo *draw_info,
530 % const MagickBooleanType split,TypeMetric *metrics,char **caption,
531 % ExceptionInfo *exception)
533 % A description of each parameter follows.
535 % o image: The image.
537 % o draw_info: the draw info.
539 % o split: when no convenient line breaks-- insert newline.
541 % o metrics: Return the font metrics in this structure.
543 % o caption: the caption.
545 % o exception: return any errors or warnings in this structure.
548 MagickExport ssize_t FormatMagickCaption(Image *image,DrawInfo *draw_info,
549 const MagickBooleanType split,TypeMetric *metrics,char **caption,
550 ExceptionInfo *exception)
572 text=AcquireString(draw_info->text);
575 for (p=(*caption); GetUTFCode(p) != 0; p+=GetUTFOctets(p))
577 if (IsUTFSpace(GetUTFCode(p)) != MagickFalse)
579 if (GetUTFCode(p) == '\n')
581 for (i=0; i < (ssize_t) GetUTFOctets(p); i++)
584 status=GetTypeMetrics(image,draw_info,metrics,exception);
585 if (status == MagickFalse)
587 width=(size_t) floor(metrics->width+0.5);
588 if ((width <= image->columns) || (strcmp(text,draw_info->text) == 0))
590 (void) strcpy(text,draw_info->text);
591 if ((s != (char *) NULL) && (GetUTFOctets(s) == 1))
597 if ((s != (char *) NULL) || (split != MagickFalse))
603 No convenient line breaks-- insert newline.
605 target=AcquireString(*caption);
607 CopyMagickString(target,*caption,n+1);
608 ConcatenateMagickString(target,"\n",strlen(*caption)+1);
609 ConcatenateMagickString(target,p,strlen(*caption)+2);
610 (void) DestroyString(*caption);
617 text=DestroyString(text);
619 for (p=(*caption); GetUTFCode(p) != 0; p+=GetUTFOctets(p))
620 if (GetUTFCode(p) == '\n')
626 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
630 % G e t M u l t i l i n e T y p e M e t r i c s %
634 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
636 % GetMultilineTypeMetrics() returns the following information for the
637 % specified font and text:
645 % maximum horizontal advance
653 % underline thickness
655 % This method is like GetTypeMetrics() but it returns the maximum text width
656 % and height for multiple lines of text.
658 % The format of the GetMultilineTypeMetrics method is:
660 % MagickBooleanType GetMultilineTypeMetrics(Image *image,
661 % const DrawInfo *draw_info,TypeMetric *metrics,ExceptionInfo *exception)
663 % A description of each parameter follows:
665 % o image: the image.
667 % o draw_info: the draw info.
669 % o metrics: Return the font metrics in this structure.
671 % o exception: return any errors or warnings in this structure.
674 MagickExport MagickBooleanType GetMultilineTypeMetrics(Image *image,
675 const DrawInfo *draw_info,TypeMetric *metrics,ExceptionInfo *exception)
692 assert(image != (Image *) NULL);
693 assert(image->signature == MagickSignature);
694 if (image->debug != MagickFalse)
695 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
696 assert(draw_info != (DrawInfo *) NULL);
697 assert(draw_info->text != (char *) NULL);
698 assert(draw_info->signature == MagickSignature);
699 if (*draw_info->text == '\0')
701 annotate_info=CloneDrawInfo((ImageInfo *) NULL,draw_info);
702 annotate_info->text=DestroyString(annotate_info->text);
704 Convert newlines to multiple lines of text.
706 textlist=StringToList(draw_info->text);
707 if (textlist == (char **) NULL)
709 annotate_info->render=MagickFalse;
710 annotate_info->direction=UndefinedDirection;
711 (void) ResetMagickMemory(metrics,0,sizeof(*metrics));
712 (void) ResetMagickMemory(&extent,0,sizeof(extent));
714 Find the widest of the text lines.
716 annotate_info->text=textlist[0];
717 status=GetTypeMetrics(image,annotate_info,&extent,exception);
719 for (i=1; textlist[i] != (char *) NULL; i++)
721 annotate_info->text=textlist[i];
722 status=GetTypeMetrics(image,annotate_info,&extent,exception);
723 if (extent.width > metrics->width)
726 metrics->height=(double) (i*(size_t) (metrics->ascent-metrics->descent+0.5)+
727 (i-1)*draw_info->interline_spacing);
729 Relinquish resources.
731 annotate_info->text=(char *) NULL;
732 annotate_info=DestroyDrawInfo(annotate_info);
733 for (i=0; textlist[i] != (char *) NULL; i++)
734 textlist[i]=DestroyString(textlist[i]);
735 textlist=(char **) RelinquishMagickMemory(textlist);
740 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
744 % G e t T y p e M e t r i c s %
748 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
750 % GetTypeMetrics() returns the following information for the specified font
759 % maximum horizontal advance
767 % underline thickness
769 % The format of the GetTypeMetrics method is:
771 % MagickBooleanType GetTypeMetrics(Image *image,const DrawInfo *draw_info,
772 % TypeMetric *metrics,ExceptionInfo *exception)
774 % A description of each parameter follows:
776 % o image: the image.
778 % o draw_info: the draw info.
780 % o metrics: Return the font metrics in this structure.
782 % o exception: return any errors or warnings in this structure.
785 MagickExport MagickBooleanType GetTypeMetrics(Image *image,
786 const DrawInfo *draw_info,TypeMetric *metrics,ExceptionInfo *exception)
797 assert(image != (Image *) NULL);
798 assert(image->signature == MagickSignature);
799 if (image->debug != MagickFalse)
800 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
801 assert(draw_info != (DrawInfo *) NULL);
802 assert(draw_info->text != (char *) NULL);
803 assert(draw_info->signature == MagickSignature);
804 annotate_info=CloneDrawInfo((ImageInfo *) NULL,draw_info);
805 annotate_info->render=MagickFalse;
806 annotate_info->direction=UndefinedDirection;
807 (void) ResetMagickMemory(metrics,0,sizeof(*metrics));
810 status=RenderType(image,annotate_info,&offset,metrics,exception);
811 if (image->debug != MagickFalse)
812 (void) LogMagickEvent(AnnotateEvent,GetMagickModule(),"Metrics: text: %s; "
813 "width: %g; height: %g; ascent: %g; descent: %g; max advance: %g; "
814 "bounds: %g,%g %g,%g; origin: %g,%g; pixels per em: %g,%g; "
815 "underline position: %g; underline thickness: %g",annotate_info->text,
816 metrics->width,metrics->height,metrics->ascent,metrics->descent,
817 metrics->max_advance,metrics->bounds.x1,metrics->bounds.y1,
818 metrics->bounds.x2,metrics->bounds.y2,metrics->origin.x,metrics->origin.y,
819 metrics->pixels_per_em.x,metrics->pixels_per_em.y,
820 metrics->underline_position,metrics->underline_thickness);
821 annotate_info=DestroyDrawInfo(annotate_info);
826 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
830 + R e n d e r T y p e %
834 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
836 % RenderType() renders text on the image. It also returns the bounding box of
837 % the text relative to the image.
839 % The format of the RenderType method is:
841 % MagickBooleanType RenderType(Image *image,DrawInfo *draw_info,
842 % const PointInfo *offset,TypeMetric *metrics,ExceptionInfo *exception)
844 % A description of each parameter follows:
846 % o image: the image.
848 % o draw_info: the draw info.
850 % o offset: (x,y) location of text relative to image.
852 % o metrics: bounding box of text.
854 % o exception: return any errors or warnings in this structure.
857 static MagickBooleanType RenderType(Image *image,const DrawInfo *draw_info,
858 const PointInfo *offset,TypeMetric *metrics,ExceptionInfo *exception)
869 type_info=(const TypeInfo *) NULL;
870 if (draw_info->font != (char *) NULL)
872 if (*draw_info->font == '@')
874 status=RenderFreetype(image,draw_info,draw_info->encoding,offset,
878 if (*draw_info->font == '-')
879 return(RenderX11(image,draw_info,offset,metrics,exception));
880 if (IsPathAccessible(draw_info->font) != MagickFalse)
882 status=RenderFreetype(image,draw_info,draw_info->encoding,offset,
886 type_info=GetTypeInfo(draw_info->font,exception);
887 if (type_info == (const TypeInfo *) NULL)
888 (void) ThrowMagickException(exception,GetMagickModule(),TypeWarning,
889 "UnableToReadFont","`%s'",draw_info->font);
891 if ((type_info == (const TypeInfo *) NULL) &&
892 (draw_info->family != (const char *) NULL))
894 type_info=GetTypeInfoByFamily(draw_info->family,draw_info->style,
895 draw_info->stretch,draw_info->weight,exception);
896 if (type_info == (const TypeInfo *) NULL)
897 (void) ThrowMagickException(exception,GetMagickModule(),TypeWarning,
898 "UnableToReadFont","`%s'",draw_info->family);
900 if (type_info == (const TypeInfo *) NULL)
901 type_info=GetTypeInfoByFamily("Arial",draw_info->style,
902 draw_info->stretch,draw_info->weight,exception);
903 if (type_info == (const TypeInfo *) NULL)
904 type_info=GetTypeInfoByFamily("Helvetica",draw_info->style,
905 draw_info->stretch,draw_info->weight,exception);
906 if (type_info == (const TypeInfo *) NULL)
907 type_info=GetTypeInfoByFamily("Century Schoolbook",draw_info->style,
908 draw_info->stretch,draw_info->weight,exception);
909 if (type_info == (const TypeInfo *) NULL)
910 type_info=GetTypeInfoByFamily("Sans",draw_info->style,
911 draw_info->stretch,draw_info->weight,exception);
912 if (type_info == (const TypeInfo *) NULL)
913 type_info=GetTypeInfoByFamily((const char *) NULL,draw_info->style,
914 draw_info->stretch,draw_info->weight,exception);
915 if (type_info == (const TypeInfo *) NULL)
916 type_info=GetTypeInfo("*",exception);
917 if (type_info == (const TypeInfo *) NULL)
919 status=RenderFreetype(image,draw_info,draw_info->encoding,offset,metrics,
923 annotate_info=CloneDrawInfo((ImageInfo *) NULL,draw_info);
924 annotate_info->face=type_info->face;
925 if (type_info->metrics != (char *) NULL)
926 (void) CloneString(&annotate_info->metrics,type_info->metrics);
927 if (type_info->glyphs != (char *) NULL)
928 (void) CloneString(&annotate_info->font,type_info->glyphs);
929 status=RenderFreetype(image,annotate_info,type_info->encoding,offset,metrics,
931 annotate_info=DestroyDrawInfo(annotate_info);
936 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
940 + R e n d e r F r e e t y p e %
944 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
946 % RenderFreetype() renders text on the image with a Truetype font. It also
947 % returns the bounding box of the text relative to the image.
949 % The format of the RenderFreetype method is:
951 % MagickBooleanType RenderFreetype(Image *image,DrawInfo *draw_info,
952 % const char *encoding,const PointInfo *offset,TypeMetric *metrics,
953 % ExceptionInfo *exception)
955 % A description of each parameter follows:
957 % o image: the image.
959 % o draw_info: the draw info.
961 % o encoding: the font encoding.
963 % o offset: (x,y) location of text relative to image.
965 % o metrics: bounding box of text.
967 % o exception: return any errors or warnings in this structure.
971 #if defined(MAGICKCORE_FREETYPE_DELEGATE)
973 static int TraceCubicBezier(FT_Vector *p,FT_Vector *q,FT_Vector *to,
982 affine=draw_info->affine;
983 (void) FormatLocaleString(path,MaxTextExtent,
984 "C%g,%g %g,%g %g,%g",affine.tx+p->x/64.0,affine.ty-
985 p->y/64.0,affine.tx+q->x/64.0,affine.ty-q->y/64.0,affine.tx+to->x/64.0,
986 affine.ty-to->y/64.0);
987 (void) ConcatenateString(&draw_info->primitive,path);
991 static int TraceLineTo(FT_Vector *to,DrawInfo *draw_info)
999 affine=draw_info->affine;
1000 (void) FormatLocaleString(path,MaxTextExtent,"L%g,%g",affine.tx+
1001 to->x/64.0,affine.ty-to->y/64.0);
1002 (void) ConcatenateString(&draw_info->primitive,path);
1006 static int TraceMoveTo(FT_Vector *to,DrawInfo *draw_info)
1012 path[MaxTextExtent];
1014 affine=draw_info->affine;
1015 (void) FormatLocaleString(path,MaxTextExtent,"M%g,%g",affine.tx+
1016 to->x/64.0,affine.ty-to->y/64.0);
1017 (void) ConcatenateString(&draw_info->primitive,path);
1021 static int TraceQuadraticBezier(FT_Vector *control,FT_Vector *to,
1022 DrawInfo *draw_info)
1028 path[MaxTextExtent];
1030 affine=draw_info->affine;
1031 (void) FormatLocaleString(path,MaxTextExtent,"Q%g,%g %g,%g",
1032 affine.tx+control->x/64.0,affine.ty-control->y/64.0,affine.tx+to->x/64.0,
1033 affine.ty-to->y/64.0);
1034 (void) ConcatenateString(&draw_info->primitive,path);
1038 static MagickBooleanType RenderFreetype(Image *image,const DrawInfo *draw_info,
1039 const char *encoding,const PointInfo *offset,TypeMetric *metrics,
1040 ExceptionInfo *exception)
1042 #if !defined(FT_OPEN_PATHNAME)
1043 #define FT_OPEN_PATHNAME ft_open_pathname
1046 typedef struct _GlyphInfo
1112 static FT_Outline_Funcs
1115 (FT_Outline_MoveTo_Func) TraceMoveTo,
1116 (FT_Outline_LineTo_Func) TraceLineTo,
1117 (FT_Outline_ConicTo_Func) TraceQuadraticBezier,
1118 (FT_Outline_CubicTo_Func) TraceCubicBezier,
1126 Initialize Truetype library.
1128 status=FT_Init_FreeType(&library);
1130 ThrowBinaryException(TypeError,"UnableToInitializeFreetypeLibrary",
1132 args.flags=FT_OPEN_PATHNAME;
1133 if (draw_info->font == (char *) NULL)
1134 args.pathname=ConstantString("helvetica");
1136 if (*draw_info->font != '@')
1137 args.pathname=ConstantString(draw_info->font);
1139 args.pathname=ConstantString(draw_info->font+1);
1140 face=(FT_Face) NULL;
1141 status=FT_Open_Face(library,&args,(long) draw_info->face,&face);
1142 args.pathname=DestroyString(args.pathname);
1145 (void) FT_Done_FreeType(library);
1146 (void) ThrowMagickException(exception,GetMagickModule(),TypeError,
1147 "UnableToReadFont","`%s'",draw_info->font);
1148 return(RenderPostscript(image,draw_info,offset,metrics,exception));
1150 if ((draw_info->metrics != (char *) NULL) &&
1151 (IsPathAccessible(draw_info->metrics) != MagickFalse))
1152 (void) FT_Attach_File(face,draw_info->metrics);
1153 encoding_type=ft_encoding_unicode;
1154 status=FT_Select_Charmap(face,encoding_type);
1155 if ((status != 0) && (face->num_charmaps != 0))
1156 status=FT_Set_Charmap(face,face->charmaps[0]);
1157 if (encoding != (const char *) NULL)
1159 if (LocaleCompare(encoding,"AdobeCustom") == 0)
1160 encoding_type=ft_encoding_adobe_custom;
1161 if (LocaleCompare(encoding,"AdobeExpert") == 0)
1162 encoding_type=ft_encoding_adobe_expert;
1163 if (LocaleCompare(encoding,"AdobeStandard") == 0)
1164 encoding_type=ft_encoding_adobe_standard;
1165 if (LocaleCompare(encoding,"AppleRoman") == 0)
1166 encoding_type=ft_encoding_apple_roman;
1167 if (LocaleCompare(encoding,"BIG5") == 0)
1168 encoding_type=ft_encoding_big5;
1169 if (LocaleCompare(encoding,"GB2312") == 0)
1170 encoding_type=ft_encoding_gb2312;
1171 if (LocaleCompare(encoding,"Johab") == 0)
1172 encoding_type=ft_encoding_johab;
1173 #if defined(ft_encoding_latin_1)
1174 if (LocaleCompare(encoding,"Latin-1") == 0)
1175 encoding_type=ft_encoding_latin_1;
1177 if (LocaleCompare(encoding,"Latin-2") == 0)
1178 encoding_type=ft_encoding_latin_2;
1179 if (LocaleCompare(encoding,"None") == 0)
1180 encoding_type=ft_encoding_none;
1181 if (LocaleCompare(encoding,"SJIScode") == 0)
1182 encoding_type=ft_encoding_sjis;
1183 if (LocaleCompare(encoding,"Symbol") == 0)
1184 encoding_type=ft_encoding_symbol;
1185 if (LocaleCompare(encoding,"Unicode") == 0)
1186 encoding_type=ft_encoding_unicode;
1187 if (LocaleCompare(encoding,"Wansung") == 0)
1188 encoding_type=ft_encoding_wansung;
1189 status=FT_Select_Charmap(face,encoding_type);
1191 ThrowBinaryException(TypeError,"UnrecognizedFontEncoding",encoding);
1196 resolution.x=DefaultResolution;
1197 resolution.y=DefaultResolution;
1198 if (draw_info->density != (char *) NULL)
1206 flags=ParseGeometry(draw_info->density,&geometry_info);
1207 resolution.x=geometry_info.rho;
1208 resolution.y=geometry_info.sigma;
1209 if ((flags & SigmaValue) == 0)
1210 resolution.y=resolution.x;
1212 status=FT_Set_Char_Size(face,(FT_F26Dot6) (64.0*draw_info->pointsize),
1213 (FT_F26Dot6) (64.0*draw_info->pointsize),(FT_UInt) resolution.x,
1214 (FT_UInt) resolution.y);
1215 metrics->pixels_per_em.x=face->size->metrics.x_ppem;
1216 metrics->pixels_per_em.y=face->size->metrics.y_ppem;
1217 metrics->ascent=(double) face->size->metrics.ascender/64.0;
1218 metrics->descent=(double) face->size->metrics.descender/64.0;
1220 metrics->origin.x=0;
1221 metrics->origin.y=0;
1222 metrics->height=(double) face->size->metrics.height/64.0;
1223 metrics->max_advance=0.0;
1224 if (face->size->metrics.max_advance > MagickEpsilon)
1225 metrics->max_advance=(double) face->size->metrics.max_advance/64.0;
1226 metrics->bounds.x1=0.0;
1227 metrics->bounds.y1=metrics->descent;
1228 metrics->bounds.x2=metrics->ascent+metrics->descent;
1229 metrics->bounds.y2=metrics->ascent+metrics->descent;
1230 metrics->underline_position=face->underline_position/64.0;
1231 metrics->underline_thickness=face->underline_thickness/64.0;
1232 if ((draw_info->text == (char *) NULL) || (*draw_info->text == '\0'))
1234 (void) FT_Done_Face(face);
1235 (void) FT_Done_FreeType(library);
1239 Compute bounding box.
1241 if (image->debug != MagickFalse)
1242 (void) LogMagickEvent(AnnotateEvent,GetMagickModule(),"Font %s; "
1243 "font-encoding %s; text-encoding %s; pointsize %g",
1244 draw_info->font != (char *) NULL ? draw_info->font : "none",
1245 encoding != (char *) NULL ? encoding : "none",
1246 draw_info->encoding != (char *) NULL ? draw_info->encoding : "none",
1247 draw_info->pointsize);
1248 flags=FT_LOAD_NO_BITMAP;
1249 value=GetImageProperty(image,"type:hinting",exception);
1250 if ((value != (const char *) NULL) && (LocaleCompare(value,"off") == 0))
1251 flags|=FT_LOAD_NO_HINTING;
1255 last_glyph.image=NULL;
1262 if (draw_info->render != MagickFalse)
1264 affine.xx=(FT_Fixed) (65536L*draw_info->affine.sx+0.5);
1265 affine.yx=(FT_Fixed) (-65536L*draw_info->affine.rx+0.5);
1266 affine.xy=(FT_Fixed) (-65536L*draw_info->affine.ry+0.5);
1267 affine.yy=(FT_Fixed) (65536L*draw_info->affine.sy+0.5);
1269 annotate_info=CloneDrawInfo((ImageInfo *) NULL,draw_info);
1270 (void) CloneString(&annotate_info->primitive,"path '");
1271 if (draw_info->render != MagickFalse)
1273 if (image->storage_class != DirectClass)
1274 (void) SetImageStorageClass(image,DirectClass,exception);
1275 if (image->matte == MagickFalse)
1276 (void) SetImageAlphaChannel(image,OpaqueAlphaChannel,exception);
1279 if (draw_info->direction == RightToLeftDirection)
1283 for (p=draw_info->text; GetUTFCode(p) != 0; p+=GetUTFOctets(p))
1284 if (GetUTFCode(p) < 0)
1286 utf8=(unsigned char *) NULL;
1287 if (GetUTFCode(p) == 0)
1291 utf8=ConvertLatin1ToUTF8((unsigned char *) draw_info->text);
1292 if (utf8 != (unsigned char *) NULL)
1295 for (code=0; GetUTFCode(p) != 0; p+=GetUTFOctets(p))
1298 Render UTF-8 sequence.
1300 glyph.id=FT_Get_Char_Index(face,GetUTFCode(p));
1302 glyph.id=FT_Get_Char_Index(face,'?');
1303 if ((glyph.id != 0) && (last_glyph.id != 0))
1305 if (fabs(draw_info->kerning) >= MagickEpsilon)
1306 origin.x+=(FT_Pos) (64.0*direction*draw_info->kerning);
1308 if (FT_HAS_KERNING(face))
1313 status=FT_Get_Kerning(face,last_glyph.id,glyph.id,
1314 ft_kerning_default,&kerning);
1316 origin.x+=(FT_Pos) (direction*kerning.x);
1319 glyph.origin=origin;
1320 status=FT_Load_Glyph(face,glyph.id,flags);
1323 status=FT_Get_Glyph(face->glyph,&glyph.image);
1326 status=FT_Outline_Get_BBox(&((FT_OutlineGlyph) glyph.image)->outline,
1330 if ((p == draw_info->text) || (bounds.xMin < metrics->bounds.x1))
1331 metrics->bounds.x1=(double) bounds.xMin;
1332 if ((p == draw_info->text) || (bounds.yMin < metrics->bounds.y1))
1333 metrics->bounds.y1=(double) bounds.yMin;
1334 if ((p == draw_info->text) || (bounds.xMax > metrics->bounds.x2))
1335 metrics->bounds.x2=(double) bounds.xMax;
1336 if ((p == draw_info->text) || (bounds.yMax > metrics->bounds.y2))
1337 metrics->bounds.y2=(double) bounds.yMax;
1338 if (draw_info->render != MagickFalse)
1339 if ((draw_info->stroke.alpha != TransparentAlpha) ||
1340 (draw_info->stroke_pattern != (Image *) NULL))
1345 annotate_info->affine.tx=glyph.origin.x/64.0;
1346 annotate_info->affine.ty=glyph.origin.y/64.0;
1347 (void) FT_Outline_Decompose(&((FT_OutlineGlyph) glyph.image)->
1348 outline,&OutlineMethods,annotate_info);
1350 FT_Vector_Transform(&glyph.origin,&affine);
1351 (void) FT_Glyph_Transform(glyph.image,&affine,&glyph.origin);
1352 status=FT_Glyph_To_Bitmap(&glyph.image,ft_render_mode_normal,
1353 (FT_Vector *) NULL,MagickTrue);
1356 bitmap=(FT_BitmapGlyph) glyph.image;
1357 point.x=offset->x+bitmap->left;
1358 if (bitmap->bitmap.pixel_mode == ft_pixel_mode_mono)
1359 point.x=offset->x+(origin.x >> 6);
1360 point.y=offset->y-bitmap->top;
1361 if (draw_info->render != MagickFalse)
1369 register unsigned char
1373 Rasterize the glyph.
1376 image_view=AcquireCacheView(image);
1377 p=bitmap->bitmap.buffer;
1378 for (y=0; y < (ssize_t) bitmap->bitmap.rows; y++)
1401 if (status == MagickFalse)
1403 x_offset=(ssize_t) ceil(point.x-0.5);
1404 y_offset=(ssize_t) ceil(point.y+y-0.5);
1405 if ((y_offset < 0) || (y_offset >= (ssize_t) image->rows))
1408 if ((x_offset < 0) || (x_offset >= (ssize_t) image->columns))
1412 q=GetCacheViewAuthenticPixels(image_view,x_offset,y_offset,
1413 bitmap->bitmap.width,1,exception);
1414 active=q != (Quantum *) NULL ? MagickTrue : MagickFalse;
1416 n=y*bitmap->bitmap.pitch-1;
1417 for (x=0; x < (ssize_t) bitmap->bitmap.width; x++)
1421 if ((x_offset < 0) || (x_offset >= (ssize_t) image->columns))
1423 q+=GetPixelChannels(image);
1426 if (bitmap->bitmap.pixel_mode != ft_pixel_mode_mono)
1427 fill_opacity=(MagickRealType) (p[n])/(bitmap->bitmap.num_grays-1);
1429 fill_opacity=((p[(x >> 3)+y*bitmap->bitmap.pitch] &
1430 (1 << (~x & 0x07)))) == 0 ? 0.0 : 1.0;
1431 if (draw_info->text_antialias == MagickFalse)
1432 fill_opacity=fill_opacity >= 0.5 ? 1.0 : 0.0;
1433 if (active == MagickFalse)
1434 q=GetCacheViewAuthenticPixels(image_view,x_offset,y_offset,1,1,
1436 if (q == (Quantum *) NULL)
1438 q+=GetPixelChannels(image);
1441 GetPixelInfo(image,&fill_color);
1442 (void) GetFillColor(draw_info,x_offset,y_offset,&fill_color,
1444 fill_opacity=fill_opacity*fill_color.alpha;
1445 CompositePixelOver(image,&fill_color,fill_opacity,q,
1446 GetPixelAlpha(image,q),q);
1447 if (active == MagickFalse)
1449 sync=SyncCacheViewAuthenticPixels(image_view,exception);
1450 if (sync == MagickFalse)
1453 q+=GetPixelChannels(image);
1455 sync=SyncCacheViewAuthenticPixels(image_view,exception);
1456 if (sync == MagickFalse)
1459 image_view=DestroyCacheView(image_view);
1461 if ((bitmap->left+bitmap->bitmap.width) > metrics->width)
1462 metrics->width=bitmap->left+bitmap->bitmap.width;
1463 if ((fabs(draw_info->interword_spacing) >= MagickEpsilon) &&
1464 (IsUTFSpace(GetUTFCode(p)) != MagickFalse) &&
1465 (IsUTFSpace(code) == MagickFalse))
1466 origin.x+=(FT_Pos) (64.0*direction*draw_info->interword_spacing);
1468 origin.x+=(FT_Pos) (direction*face->glyph->advance.x);
1469 metrics->origin.x=(double) origin.x;
1470 metrics->origin.y=(double) origin.y;
1471 if (last_glyph.id != 0)
1472 FT_Done_Glyph(last_glyph.image);
1476 if (utf8 != (unsigned char *) NULL)
1477 utf8=(unsigned char *) RelinquishMagickMemory(utf8);
1478 if (last_glyph.id != 0)
1479 FT_Done_Glyph(last_glyph.image);
1480 if ((draw_info->stroke.alpha != TransparentAlpha) ||
1481 (draw_info->stroke_pattern != (Image *) NULL))
1483 if (draw_info->render != MagickFalse)
1488 annotate_info->linejoin=RoundJoin;
1489 annotate_info->affine.tx=offset->x;
1490 annotate_info->affine.ty=offset->y;
1491 (void) ConcatenateString(&annotate_info->primitive,"'");
1492 (void) DrawImage(image,annotate_info,exception);
1496 Determine font metrics.
1498 glyph.id=FT_Get_Char_Index(face,'_');
1499 glyph.origin=origin;
1500 status=FT_Load_Glyph(face,glyph.id,flags);
1503 status=FT_Get_Glyph(face->glyph,&glyph.image);
1506 status=FT_Outline_Get_BBox(&((FT_OutlineGlyph) glyph.image)->
1510 FT_Vector_Transform(&glyph.origin,&affine);
1511 (void) FT_Glyph_Transform(glyph.image,&affine,&glyph.origin);
1512 status=FT_Glyph_To_Bitmap(&glyph.image,ft_render_mode_normal,
1513 (FT_Vector *) NULL,MagickTrue);
1514 bitmap=(FT_BitmapGlyph) glyph.image;
1515 if (bitmap->left > metrics->width)
1516 metrics->width=bitmap->left;
1519 FT_Done_Glyph(glyph.image);
1521 metrics->width-=metrics->bounds.x1/64.0;
1522 metrics->bounds.x1/=64.0;
1523 metrics->bounds.y1/=64.0;
1524 metrics->bounds.x2/=64.0;
1525 metrics->bounds.y2/=64.0;
1526 metrics->origin.x/=64.0;
1527 metrics->origin.y/=64.0;
1529 Relinquish resources.
1531 annotate_info=DestroyDrawInfo(annotate_info);
1532 (void) FT_Done_Face(face);
1533 (void) FT_Done_FreeType(library);
1537 static MagickBooleanType RenderFreetype(Image *image,const DrawInfo *draw_info,
1538 const char *magick_unused(encoding),const PointInfo *offset,
1539 TypeMetric *metrics,ExceptionInfo *exception)
1541 (void) ThrowMagickException(exception,GetMagickModule(),
1542 MissingDelegateWarning,"DelegateLibrarySupportNotBuiltIn","`%s' (Freetype)",
1543 draw_info->font != (char *) NULL ? draw_info->font : "none");
1544 return(RenderPostscript(image,draw_info,offset,metrics));
1549 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1553 + R e n d e r P o s t s c r i p t %
1557 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1559 % RenderPostscript() renders text on the image with a Postscript font. It
1560 % also returns the bounding box of the text relative to the image.
1562 % The format of the RenderPostscript method is:
1564 % MagickBooleanType RenderPostscript(Image *image,DrawInfo *draw_info,
1565 % const PointInfo *offset,TypeMetric *metrics,ExceptionInfo *exception)
1567 % A description of each parameter follows:
1569 % o image: the image.
1571 % o draw_info: the draw info.
1573 % o offset: (x,y) location of text relative to image.
1575 % o metrics: bounding box of text.
1577 % o exception: return any errors or warnings in this structure.
1581 static inline size_t MagickMin(const size_t x,const size_t y)
1588 static char *EscapeParenthesis(const char *text)
1603 buffer=AcquireString(text);
1605 for (i=0; i < (ssize_t) MagickMin(strlen(text),MaxTextExtent-escapes-1); i++)
1607 if ((text[i] == '(') || (text[i] == ')'))
1618 static MagickBooleanType RenderPostscript(Image *image,
1619 const DrawInfo *draw_info,const PointInfo *offset,TypeMetric *metrics,
1620 ExceptionInfo *exception)
1623 filename[MaxTextExtent],
1624 geometry[MaxTextExtent],
1654 Render label with a Postscript font.
1656 if (image->debug != MagickFalse)
1657 (void) LogMagickEvent(AnnotateEvent,GetMagickModule(),
1658 "Font %s; pointsize %g",draw_info->font != (char *) NULL ?
1659 draw_info->font : "none",draw_info->pointsize);
1661 unique_file=AcquireUniqueFileResource(filename);
1662 if (unique_file != -1)
1663 file=fdopen(unique_file,"wb");
1664 if ((unique_file == -1) || (file == (FILE *) NULL))
1666 ThrowFileException(exception,FileOpenError,"UnableToOpenFile",filename);
1667 return(MagickFalse);
1669 (void) FormatLocaleFile(file,"%%!PS-Adobe-3.0\n");
1670 (void) FormatLocaleFile(file,"/ReencodeType\n");
1671 (void) FormatLocaleFile(file,"{\n");
1672 (void) FormatLocaleFile(file," findfont dup length\n");
1673 (void) FormatLocaleFile(file,
1674 " dict begin { 1 index /FID ne {def} {pop pop} ifelse } forall\n");
1675 (void) FormatLocaleFile(file,
1676 " /Encoding ISOLatin1Encoding def currentdict end definefont pop\n");
1677 (void) FormatLocaleFile(file,"} bind def\n");
1679 Sample to compute bounding box.
1681 identity=(fabs(draw_info->affine.sx-draw_info->affine.sy) < MagickEpsilon) &&
1682 (fabs(draw_info->affine.rx) < MagickEpsilon) &&
1683 (fabs(draw_info->affine.ry) < MagickEpsilon) ? MagickTrue : MagickFalse;
1686 for (i=0; i <= (ssize_t) (strlen(draw_info->text)+2); i++)
1688 point.x=fabs(draw_info->affine.sx*i*draw_info->pointsize+
1689 draw_info->affine.ry*2.0*draw_info->pointsize);
1690 point.y=fabs(draw_info->affine.rx*i*draw_info->pointsize+
1691 draw_info->affine.sy*2.0*draw_info->pointsize);
1692 if (point.x > extent.x)
1694 if (point.y > extent.y)
1697 (void) FormatLocaleFile(file,"%g %g moveto\n",identity != MagickFalse ? 0.0 :
1698 extent.x/2.0,extent.y/2.0);
1699 (void) FormatLocaleFile(file,"%g %g scale\n",draw_info->pointsize,
1700 draw_info->pointsize);
1701 if ((draw_info->font == (char *) NULL) || (*draw_info->font == '\0') ||
1702 (strchr(draw_info->font,'/') != (char *) NULL))
1703 (void) FormatLocaleFile(file,
1704 "/Times-Roman-ISO dup /Times-Roman ReencodeType findfont setfont\n");
1706 (void) FormatLocaleFile(file,
1707 "/%s-ISO dup /%s ReencodeType findfont setfont\n",draw_info->font,
1709 (void) FormatLocaleFile(file,"[%g %g %g %g 0 0] concat\n",
1710 draw_info->affine.sx,-draw_info->affine.rx,-draw_info->affine.ry,
1711 draw_info->affine.sy);
1712 text=EscapeParenthesis(draw_info->text);
1713 if (identity == MagickFalse)
1714 (void) FormatLocaleFile(file,"(%s) stringwidth pop -0.5 mul -0.5 rmoveto\n",
1716 (void) FormatLocaleFile(file,"(%s) show\n",text);
1717 text=DestroyString(text);
1718 (void) FormatLocaleFile(file,"showpage\n");
1719 (void) fclose(file);
1720 (void) FormatLocaleString(geometry,MaxTextExtent,"%.20gx%.20g+0+0!",
1721 floor(extent.x+0.5),floor(extent.y+0.5));
1722 annotate_info=AcquireImageInfo();
1723 (void) FormatLocaleString(annotate_info->filename,MaxTextExtent,"ps:%s",
1725 (void) CloneString(&annotate_info->page,geometry);
1726 if (draw_info->density != (char *) NULL)
1727 (void) CloneString(&annotate_info->density,draw_info->density);
1728 annotate_info->antialias=draw_info->text_antialias;
1729 annotate_image=ReadImage(annotate_info,exception);
1730 CatchException(exception);
1731 annotate_info=DestroyImageInfo(annotate_info);
1732 (void) RelinquishUniqueFileResource(filename);
1733 if (annotate_image == (Image *) NULL)
1734 return(MagickFalse);
1735 resolution.x=DefaultResolution;
1736 resolution.y=DefaultResolution;
1737 if (draw_info->density != (char *) NULL)
1745 flags=ParseGeometry(draw_info->density,&geometry_info);
1746 resolution.x=geometry_info.rho;
1747 resolution.y=geometry_info.sigma;
1748 if ((flags & SigmaValue) == 0)
1749 resolution.y=resolution.x;
1751 if (identity == MagickFalse)
1752 (void) TransformImage(&annotate_image,"0x0",(char *) NULL,exception);
1758 crop_info=GetImageBoundingBox(annotate_image,exception);
1759 crop_info.height=(size_t) ((resolution.y/DefaultResolution)*
1760 ExpandAffine(&draw_info->affine)*draw_info->pointsize+0.5);
1761 crop_info.y=(ssize_t) ceil((resolution.y/DefaultResolution)*extent.y/8.0-
1763 (void) FormatLocaleString(geometry,MaxTextExtent,
1764 "%.20gx%.20g%+.20g%+.20g",(double) crop_info.width,(double)
1765 crop_info.height,(double) crop_info.x,(double) crop_info.y);
1766 (void) TransformImage(&annotate_image,geometry,(char *) NULL,exception);
1768 metrics->pixels_per_em.x=(resolution.y/DefaultResolution)*
1769 ExpandAffine(&draw_info->affine)*draw_info->pointsize;
1770 metrics->pixels_per_em.y=metrics->pixels_per_em.x;
1771 metrics->ascent=metrics->pixels_per_em.x;
1772 metrics->descent=metrics->pixels_per_em.y/-5.0;
1773 metrics->width=(double) annotate_image->columns/
1774 ExpandAffine(&draw_info->affine);
1775 metrics->height=1.152*metrics->pixels_per_em.x;
1776 metrics->max_advance=metrics->pixels_per_em.x;
1777 metrics->bounds.x1=0.0;
1778 metrics->bounds.y1=metrics->descent;
1779 metrics->bounds.x2=metrics->ascent+metrics->descent;
1780 metrics->bounds.y2=metrics->ascent+metrics->descent;
1781 metrics->underline_position=(-2.0);
1782 metrics->underline_thickness=1.0;
1783 if (draw_info->render == MagickFalse)
1785 annotate_image=DestroyImage(annotate_image);
1788 if (draw_info->fill.alpha != TransparentAlpha)
1802 if (image->matte == MagickFalse)
1803 (void) SetImageAlphaChannel(image,OpaqueAlphaChannel,exception);
1804 if (annotate_image->matte == MagickFalse)
1805 (void) SetImageAlphaChannel(annotate_image,OpaqueAlphaChannel,
1807 fill_color=draw_info->fill;
1808 annotate_view=AcquireCacheView(annotate_image);
1809 for (y=0; y < (ssize_t) annotate_image->rows; y++)
1817 q=GetCacheViewAuthenticPixels(annotate_view,0,y,annotate_image->columns,
1819 if (q == (Quantum *) NULL)
1821 for (x=0; x < (ssize_t) annotate_image->columns; x++)
1823 (void) GetFillColor(draw_info,x,y,&fill_color,exception);
1824 SetPixelAlpha(annotate_image,ClampToQuantum((((MagickRealType)
1825 GetPixelIntensity(annotate_image,q)*fill_color.alpha)/
1827 SetPixelRed(annotate_image,fill_color.red,q);
1828 SetPixelGreen(annotate_image,fill_color.green,q);
1829 SetPixelBlue(annotate_image,fill_color.blue,q);
1830 q+=GetPixelChannels(annotate_image);
1832 sync=SyncCacheViewAuthenticPixels(annotate_view,exception);
1833 if (sync == MagickFalse)
1836 annotate_view=DestroyCacheView(annotate_view);
1837 (void) CompositeImage(image,OverCompositeOp,annotate_image,
1838 (ssize_t) ceil(offset->x-0.5),(ssize_t) ceil(offset->y-(metrics->ascent+
1839 metrics->descent)-0.5),exception);
1841 annotate_image=DestroyImage(annotate_image);
1846 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1850 + R e n d e r X 1 1 %
1854 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1856 % RenderX11() renders text on the image with an X11 font. It also returns the
1857 % bounding box of the text relative to the image.
1859 % The format of the RenderX11 method is:
1861 % MagickBooleanType RenderX11(Image *image,DrawInfo *draw_info,
1862 % const PointInfo *offset,TypeMetric *metrics,ExceptionInfo *exception)
1864 % A description of each parameter follows:
1866 % o image: the image.
1868 % o draw_info: the draw info.
1870 % o offset: (x,y) location of text relative to image.
1872 % o metrics: bounding box of text.
1874 % o exception: return any errors or warnings in this structure.
1877 #if defined(MAGICKCORE_X11_DELEGATE)
1878 static MagickBooleanType RenderX11(Image *image,const DrawInfo *draw_info,
1879 const PointInfo *offset,TypeMetric *metrics,ExceptionInfo *exception)
1888 *display = (Display *) NULL;
1890 static XAnnotateInfo
1899 static XResourceInfo
1905 static XStandardColormap
1915 if (annotate_semaphore == (SemaphoreInfo *) NULL)
1916 AcquireSemaphoreInfo(&annotate_semaphore);
1917 LockSemaphoreInfo(annotate_semaphore);
1918 if (display == (Display *) NULL)
1927 Open X server connection.
1929 display=XOpenDisplay(draw_info->server_name);
1930 if (display == (Display *) NULL)
1932 ThrowXWindowException(XServerError,"UnableToOpenXServer",
1933 draw_info->server_name);
1934 return(MagickFalse);
1937 Get user defaults from X resource database.
1939 (void) XSetErrorHandler(XError);
1940 image_info=AcquireImageInfo();
1941 client_name=GetClientName();
1942 resource_database=XGetResourceDatabase(display,client_name);
1943 XGetResourceInfo(image_info,resource_database,client_name,&resource_info);
1944 resource_info.close_server=MagickFalse;
1945 resource_info.colormap=PrivateColormap;
1946 resource_info.font=AcquireString(draw_info->font);
1947 resource_info.background_color=AcquireString("#ffffffffffff");
1948 resource_info.foreground_color=AcquireString("#000000000000");
1949 map_info=XAllocStandardColormap();
1950 if (map_info == (XStandardColormap *) NULL)
1952 ThrowXWindowException(ResourceLimitError,"MemoryAllocationFailed",
1954 return(MagickFalse);
1957 Initialize visual info.
1959 visual_info=XBestVisualInfo(display,map_info,&resource_info);
1960 if (visual_info == (XVisualInfo *) NULL)
1962 ThrowXWindowException(XServerError,"UnableToGetVisual",
1964 return(MagickFalse);
1966 map_info->colormap=(Colormap) NULL;
1967 pixel.pixels=(unsigned long *) NULL;
1969 Initialize Standard Colormap info.
1971 XGetMapInfo(visual_info,XDefaultColormap(display,visual_info->screen),
1973 XGetPixelInfo(display,visual_info,map_info,&resource_info,(Image *) NULL,
1975 pixel.annotate_context=XDefaultGC(display,visual_info->screen);
1977 Initialize font info.
1979 font_info=XBestFont(display,&resource_info,MagickFalse);
1980 if (font_info == (XFontStruct *) NULL)
1982 ThrowXWindowException(XServerError,"UnableToLoadFont",
1984 return(MagickFalse);
1986 if ((map_info == (XStandardColormap *) NULL) ||
1987 (visual_info == (XVisualInfo *) NULL) ||
1988 (font_info == (XFontStruct *) NULL))
1990 XFreeResources(display,visual_info,map_info,&pixel,font_info,
1991 &resource_info,(XWindowInfo *) NULL);
1992 ThrowXWindowException(XServerError,"UnableToLoadFont",
1994 return(MagickFalse);
1996 cache_info=(*draw_info);
1998 UnlockSemaphoreInfo(annotate_semaphore);
2000 Initialize annotate info.
2002 XGetAnnotateInfo(&annotate_info);
2003 annotate_info.stencil=ForegroundStencil;
2004 if (cache_info.font != draw_info->font)
2007 Type name has changed.
2009 (void) XFreeFont(display,font_info);
2010 (void) CloneString(&resource_info.font,draw_info->font);
2011 font_info=XBestFont(display,&resource_info,MagickFalse);
2012 if (font_info == (XFontStruct *) NULL)
2014 ThrowXWindowException(XServerError,"UnableToLoadFont",
2016 return(MagickFalse);
2019 if (image->debug != MagickFalse)
2020 (void) LogMagickEvent(AnnotateEvent,GetMagickModule(),
2021 "Font %s; pointsize %g",draw_info->font != (char *) NULL ?
2022 draw_info->font : "none",draw_info->pointsize);
2023 cache_info=(*draw_info);
2024 annotate_info.font_info=font_info;
2025 annotate_info.text=(char *) draw_info->text;
2026 annotate_info.width=(unsigned int) XTextWidth(font_info,draw_info->text,
2027 (int) strlen(draw_info->text));
2028 annotate_info.height=(unsigned int) font_info->ascent+font_info->descent;
2029 metrics->pixels_per_em.x=(double) font_info->max_bounds.width;
2030 metrics->pixels_per_em.y=(double) font_info->ascent+font_info->descent;
2031 metrics->ascent=(double) font_info->ascent+4;
2032 metrics->descent=(double) (-font_info->descent);
2033 metrics->width=annotate_info.width/ExpandAffine(&draw_info->affine);
2034 metrics->height=font_info->ascent+font_info->descent;
2035 metrics->max_advance=(double) font_info->max_bounds.width;
2036 metrics->bounds.x1=0.0;
2037 metrics->bounds.y1=metrics->descent;
2038 metrics->bounds.x2=metrics->ascent+metrics->descent;
2039 metrics->bounds.y2=metrics->ascent+metrics->descent;
2040 metrics->underline_position=(-2.0);
2041 metrics->underline_thickness=1.0;
2042 if (draw_info->render == MagickFalse)
2044 if (draw_info->fill.alpha == TransparentAlpha)
2049 width=annotate_info.width;
2050 height=annotate_info.height;
2051 if ((fabs(draw_info->affine.rx) >= MagickEpsilon) ||
2052 (fabs(draw_info->affine.ry) >= MagickEpsilon))
2054 if ((fabs(draw_info->affine.sx-draw_info->affine.sy) < MagickEpsilon) &&
2055 (fabs(draw_info->affine.rx+draw_info->affine.ry) < MagickEpsilon))
2056 annotate_info.degrees=(double) (180.0/MagickPI)*
2057 atan2(draw_info->affine.rx,draw_info->affine.sx);
2059 (void) FormatLocaleString(annotate_info.geometry,MaxTextExtent,
2060 "%.20gx%.20g%+.20g%+.20g",(double) width,(double) height,
2061 ceil(offset->x-0.5),ceil(offset->y-metrics->ascent-metrics->descent+
2062 draw_info->interline_spacing-0.5));
2063 pixel.pen_color.red=ScaleQuantumToShort(draw_info->fill.red);
2064 pixel.pen_color.green=ScaleQuantumToShort(draw_info->fill.green);
2065 pixel.pen_color.blue=ScaleQuantumToShort(draw_info->fill.blue);
2066 status=XAnnotateImage(display,&pixel,&annotate_info,image,exception);
2069 ThrowXWindowException(ResourceLimitError,"MemoryAllocationFailed",
2071 return(MagickFalse);
2076 static MagickBooleanType RenderX11(Image *image,const DrawInfo *draw_info,
2077 const PointInfo *offset,TypeMetric *metrics,ExceptionInfo *exception)
2082 (void) ThrowMagickException(exception,GetMagickModule(),
2083 MissingDelegateError,"DelegateLibrarySupportNotBuiltIn","`%s' (X11)",
2085 return(MagickFalse);