granicus.if.org Git - imagemagick/blob - MagickCore/annotate.c

   1 /*
   2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
   3 %                                                                             %
   4 %                                                                             %
   5 %                                                                             %
   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             %
  11 %                                                                             %
  12 %                                                                             %
  13 %                   MagickCore Image Annotation Methods                       %
  14 %                                                                             %
  15 %                              Software Design                                %
  16 %                                John Cristy                                  %
  17 %                                 July 1992                                   %
  18 %                                                                             %
  19 %                                                                             %
  20 %  Copyright 1999-2011 ImageMagick Studio LLC, a non-profit organization      %
  21 %  dedicated to making software imaging solutions freely available.           %
  22 %                                                                             %
  23 %  You may not use this file except in compliance with the License.  You may  %
  24 %  obtain a copy of the License at                                            %
  25 %                                                                             %
  26 %    http://www.imagemagick.org/script/license.php                            %
  27 %                                                                             %
  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.                                             %
  33 %                                                                             %
  34 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  35 %
  36 % Digital Applications (www.digapp.com) contributed the stroked text algorithm.
  37 % It was written by Leonard Rosenthol.
  38 %
  39 %
  40 */
  41 \f
  42 /*
  43   Include declarations.
  44 */
  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__)
  81 #  undef interface
  82 #endif
  83 #if defined(MAGICKCORE_HAVE_FT2BUILD_H)
  84 #  include <ft2build.h>
  85 #endif
  86 #if defined(FT_FREETYPE_H)
  87 #  include FT_FREETYPE_H
  88 #else
  89 #  include <freetype/freetype.h>
  90 #endif
  91 #if defined(FT_GLYPH_H)
  92 #  include FT_GLYPH_H
  93 #else
  94 #  include <freetype/ftglyph.h>
  95 #endif
  96 #if defined(FT_OUTLINE_H)
  97 #  include FT_OUTLINE_H
  98 #else
  99 #  include <freetype/ftoutln.h>
 100 #endif
 101 #if defined(FT_BBOX_H)
 102 #  include FT_BBOX_H
 103 #else
 104 #  include <freetype/ftbbox.h>
 105 #endif /* defined(FT_BBOX_H) */
 106 #endif
 107 \f
 108 /*
 109   Annotate semaphores.
 110 */
 111 static SemaphoreInfo
 112   *annotate_semaphore = (SemaphoreInfo *) NULL;
 113 \f
 114 /*
 115   Forward declarations.
 116 */
 117 static MagickBooleanType
 118   RenderType(Image *,const DrawInfo *,const PointInfo *,TypeMetric *,
 119     ExceptionInfo *),
 120   RenderPostscript(Image *,const DrawInfo *,const PointInfo *,TypeMetric *,
 121     ExceptionInfo *),
 122   RenderFreetype(Image *,const DrawInfo *,const char *,const PointInfo *,
 123     TypeMetric *,ExceptionInfo *),
 124   RenderX11(Image *,const DrawInfo *,const PointInfo *,TypeMetric *,
 125     ExceptionInfo *);
 126 \f
 127 /*
 128 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 129 %                                                                             %
 130 %                                                                             %
 131 %                                                                             %
 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                           %
 133 %                                                                             %
 134 %                                                                             %
 135 %                                                                             %
 136 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 137 %
 138 %  AnnotateComponentGenesis() instantiates the annotate component.
 139 %
 140 %  The format of the AnnotateComponentGenesis method is:
 141 %
 142 %      MagickBooleanType AnnotateComponentGenesis(void)
 143 %
 144 */
 145 MagickPrivate MagickBooleanType AnnotateComponentGenesis(void)
 146 {
 147   AcquireSemaphoreInfo(&annotate_semaphore);
 148   return(MagickTrue);
 149 }
 150 \f
 151 /*
 152 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 153 %                                                                             %
 154 %                                                                             %
 155 %                                                                             %
 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                         %
 157 %                                                                             %
 158 %                                                                             %
 159 %                                                                             %
 160 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 161 %
 162 %  AnnotateComponentTerminus() destroys the annotate component.
 163 %
 164 %  The format of the AnnotateComponentTerminus method is:
 165 %
 166 %      AnnotateComponentTerminus(void)
 167 %
 168 */
 169 MagickPrivate void AnnotateComponentTerminus(void)
 170 {
 171   if (annotate_semaphore == (SemaphoreInfo *) NULL)
 172     AcquireSemaphoreInfo(&annotate_semaphore);
 173   DestroySemaphoreInfo(&annotate_semaphore);
 174 }
 175 \f
 176 /*
 177 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 178 %                                                                             %
 179 %                                                                             %
 180 %                                                                             %
 181 %   A n n o t a t e I m a g e                                                 %
 182 %                                                                             %
 183 %                                                                             %
 184 %                                                                             %
 185 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 186 %
 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:
 190 %
 191 %    %b   file size in bytes.
 192 %    %c   comment.
 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.
 199 %    %l   image label.
 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.
 209 %    %w   image width.
 210 %    %x   x resolution of the image.
 211 %    %y   y resolution of the image.
 212 %
 213 %  The format of the AnnotateImage method is:
 214 %
 215 %      MagickBooleanType AnnotateImage(Image *image,DrawInfo *draw_info,
 216 %        ExceptionInfo *exception)
 217 %
 218 %  A description of each parameter follows:
 219 %
 220 %    o image: the image.
 221 %
 222 %    o draw_info: the draw info.
 223 %
 224 %    o exception: return any errors or warnings in this structure.
 225 %
 226 */
 227 MagickExport MagickBooleanType AnnotateImage(Image *image,
 228   const DrawInfo *draw_info,ExceptionInfo *exception)
 229 {
 230   char
 231     primitive[MaxTextExtent],
 232     **textlist;
 233
 234   DrawInfo
 235     *annotate,
 236     *annotate_info;
 237
 238   GeometryInfo
 239     geometry_info;
 240
 241   MagickBooleanType
 242     status;
 243
 244   PointInfo
 245     offset;
 246
 247   RectangleInfo
 248     geometry;
 249
 250   register ssize_t
 251     i;
 252
 253   size_t
 254     length;
 255
 256   TypeMetric
 257     metrics;
 258
 259   size_t
 260     height,
 261     number_lines;
 262
 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)
 270     return(MagickFalse);
 271   if (*draw_info->text == '\0')
 272     return(MagickTrue);
 273   textlist=StringToList(draw_info->text);
 274   if (textlist == (char **) NULL)
 275     return(MagickFalse);
 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)
 286     {
 287       (void) ParsePageGeometry(image,annotate_info->geometry,&geometry,
 288         exception);
 289       (void) ParseGeometry(annotate_info->geometry,&geometry_info);
 290     }
 291   if (SetImageStorageClass(image,DirectClass,exception) == MagickFalse)
 292     return(MagickFalse);
 293   status=MagickTrue;
 294   for (i=0; textlist[i] != (char *) NULL; i++)
 295   {
 296     /*
 297       Position text relative to image.
 298     */
 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)
 306     {
 307       case UndefinedGravity:
 308       default:
 309       {
 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;
 312         break;
 313       }
 314       case NorthWestGravity:
 315       {
 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*
 321           metrics.ascent;
 322         break;
 323       }
 324       case NorthGravity:
 325       {
 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;
 334         break;
 335       }
 336       case NorthEastGravity:
 337       {
 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-
 345           metrics.bounds.x1);
 346         break;
 347       }
 348       case WestGravity:
 349       {
 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;
 357         break;
 358       }
 359       case StaticGravity:
 360       case CenterGravity:
 361       {
 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;
 372         break;
 373       }
 374       case EastGravity:
 375       {
 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;
 386         break;
 387       }
 388       case SouthWestGravity:
 389       {
 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;
 396         break;
 397       }
 398       case SouthGravity:
 399       {
 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;
 408         break;
 409       }
 410       case SouthEastGravity:
 411       {
 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;
 420         break;
 421       }
 422     }
 423     switch (annotate->align)
 424     {
 425       case LeftAlign:
 426       {
 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;
 429         break;
 430       }
 431       case CenterAlign:
 432       {
 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;
 437         break;
 438       }
 439       case RightAlign:
 440       {
 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);
 445         break;
 446       }
 447       default:
 448         break;
 449     }
 450     if (draw_info->undercolor.alpha != TransparentAlpha)
 451       {
 452         DrawInfo
 453           *undercolor_info;
 454
 455         /*
 456           Text box.
 457         */
 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);
 468       }
 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)
 474       {
 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);
 479       }
 480     else
 481       if (annotate->decorate == UnderlineDecoration)
 482         {
 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);
 487         }
 488     /*
 489       Annotate image with text.
 490     */
 491     status=RenderType(image,annotate,&offset,&metrics,exception);
 492     if (status == MagickFalse)
 493       break;
 494     if (annotate->decorate == LineThroughDecoration)
 495       {
 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);
 500       }
 501   }
 502   /*
 503     Relinquish resources.
 504   */
 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);
 510   return(status);
 511 }
 512 \f
 513 /*
 514 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 515 %                                                                             %
 516 %                                                                             %
 517 %                                                                             %
 518 %  F o r m a t M a g i c k C a p t i o n                                      %
 519 %                                                                             %
 520 %                                                                             %
 521 %                                                                             %
 522 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 523 %
 524 %  FormatMagickCaption() formats a caption so that it fits within the image
 525 %  width.  It returns the number of lines in the formatted caption.
 526 %
 527 %  The format of the FormatMagickCaption method is:
 528 %
 529 %      ssize_t FormatMagickCaption(Image *image,DrawInfo *draw_info,
 530 %        const MagickBooleanType split,TypeMetric *metrics,char **caption,
 531 %        ExceptionInfo *exception)
 532 %
 533 %  A description of each parameter follows.
 534 %
 535 %    o image:  The image.
 536 %
 537 %    o draw_info: the draw info.
 538 %
 539 %    o split: when no convenient line breaks-- insert newline.
 540 %
 541 %    o metrics: Return the font metrics in this structure.
 542 %
 543 %    o caption: the caption.
 544 %
 545 %    o exception: return any errors or warnings in this structure.
 546 %
 547 */
 548 MagickExport ssize_t FormatMagickCaption(Image *image,DrawInfo *draw_info,
 549   const MagickBooleanType split,TypeMetric *metrics,char **caption,
 550   ExceptionInfo *exception)
 551 {
 552   char
 553     *text;
 554
 555   MagickBooleanType
 556     status;
 557
 558   register char
 559     *p,
 560     *q,
 561     *s;
 562
 563   register ssize_t
 564     i;
 565
 566   size_t
 567     width;
 568
 569   ssize_t
 570     n;
 571
 572   text=AcquireString(draw_info->text);
 573   q=draw_info->text;
 574   s=(char *) NULL;
 575   for (p=(*caption); GetUTFCode(p) != 0; p+=GetUTFOctets(p))
 576   {
 577     if (IsUTFSpace(GetUTFCode(p)) != MagickFalse)
 578       s=p;
 579     if (GetUTFCode(p) == '\n')
 580       q=draw_info->text;
 581     for (i=0; i < (ssize_t) GetUTFOctets(p); i++)
 582       *q++=(*(p+i));
 583     *q='\0';
 584     status=GetTypeMetrics(image,draw_info,metrics,exception);
 585     if (status == MagickFalse)
 586       break;
 587     width=(size_t) floor(metrics->width+0.5);
 588     if ((width <= image->columns) || (strcmp(text,draw_info->text) == 0))
 589       continue;
 590     (void) strcpy(text,draw_info->text);
 591     if ((s != (char *) NULL) && (GetUTFOctets(s) == 1))
 592       {
 593         *s='\n';
 594         p=s;
 595       }
 596     else
 597       if ((s != (char *) NULL) || (split != MagickFalse))
 598         {
 599           char
 600             *target;
 601
 602           /*
 603             No convenient line breaks-- insert newline.
 604           */
 605           target=AcquireString(*caption);
 606           n=p-(*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);
 611           *caption=target;
 612           p=(*caption)+n;
 613         }
 614     q=draw_info->text;
 615     s=(char *) NULL;
 616   }
 617   text=DestroyString(text);
 618   n=0;
 619   for (p=(*caption); GetUTFCode(p) != 0; p+=GetUTFOctets(p))
 620     if (GetUTFCode(p) == '\n')
 621       n++;
 622   return(n);
 623 }
 624 \f
 625 /*
 626 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 627 %                                                                             %
 628 %                                                                             %
 629 %                                                                             %
 630 %   G e t M u l t i l i n e T y p e M e t r i c s                             %
 631 %                                                                             %
 632 %                                                                             %
 633 %                                                                             %
 634 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 635 %
 636 %  GetMultilineTypeMetrics() returns the following information for the
 637 %  specified font and text:
 638 %
 639 %    character width
 640 %    character height
 641 %    ascender
 642 %    descender
 643 %    text width
 644 %    text height
 645 %    maximum horizontal advance
 646 %    bounds: x1
 647 %    bounds: y1
 648 %    bounds: x2
 649 %    bounds: y2
 650 %    origin: x
 651 %    origin: y
 652 %    underline position
 653 %    underline thickness
 654 %
 655 %  This method is like GetTypeMetrics() but it returns the maximum text width
 656 %  and height for multiple lines of text.
 657 %
 658 %  The format of the GetMultilineTypeMetrics method is:
 659 %
 660 %      MagickBooleanType GetMultilineTypeMetrics(Image *image,
 661 %        const DrawInfo *draw_info,TypeMetric *metrics,ExceptionInfo *exception)
 662 %
 663 %  A description of each parameter follows:
 664 %
 665 %    o image: the image.
 666 %
 667 %    o draw_info: the draw info.
 668 %
 669 %    o metrics: Return the font metrics in this structure.
 670 %
 671 %    o exception: return any errors or warnings in this structure.
 672 %
 673 */
 674 MagickExport MagickBooleanType GetMultilineTypeMetrics(Image *image,
 675   const DrawInfo *draw_info,TypeMetric *metrics,ExceptionInfo *exception)
 676 {
 677   char
 678     **textlist;
 679
 680   DrawInfo
 681     *annotate_info;
 682
 683   MagickBooleanType
 684     status;
 685
 686   register ssize_t
 687     i;
 688
 689   TypeMetric
 690     extent;
 691
 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')
 700     return(MagickFalse);
 701   annotate_info=CloneDrawInfo((ImageInfo *) NULL,draw_info);
 702   annotate_info->text=DestroyString(annotate_info->text);
 703   /*
 704     Convert newlines to multiple lines of text.
 705   */
 706   textlist=StringToList(draw_info->text);
 707   if (textlist == (char **) NULL)
 708     return(MagickFalse);
 709   annotate_info->render=MagickFalse;
 710   annotate_info->direction=UndefinedDirection;
 711   (void) ResetMagickMemory(metrics,0,sizeof(*metrics));
 712   (void) ResetMagickMemory(&extent,0,sizeof(extent));
 713   /*
 714     Find the widest of the text lines.
 715   */
 716   annotate_info->text=textlist[0];
 717   status=GetTypeMetrics(image,annotate_info,&extent,exception);
 718   *metrics=extent;
 719   for (i=1; textlist[i] != (char *) NULL; i++)
 720   {
 721     annotate_info->text=textlist[i];
 722     status=GetTypeMetrics(image,annotate_info,&extent,exception);
 723     if (extent.width > metrics->width)
 724       *metrics=extent;
 725   }
 726   metrics->height=(double) (i*(size_t) (metrics->ascent-metrics->descent+0.5)+
 727     (i-1)*draw_info->interline_spacing);
 728   /*
 729     Relinquish resources.
 730   */
 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);
 736   return(status);
 737 }
 738 \f
 739 /*
 740 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 741 %                                                                             %
 742 %                                                                             %
 743 %                                                                             %
 744 %   G e t T y p e M e t r i c s                                               %
 745 %                                                                             %
 746 %                                                                             %
 747 %                                                                             %
 748 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 749 %
 750 %  GetTypeMetrics() returns the following information for the specified font
 751 %  and text:
 752 %
 753 %    character width
 754 %    character height
 755 %    ascender
 756 %    descender
 757 %    text width
 758 %    text height
 759 %    maximum horizontal advance
 760 %    bounds: x1
 761 %    bounds: y1
 762 %    bounds: x2
 763 %    bounds: y2
 764 %    origin: x
 765 %    origin: y
 766 %    underline position
 767 %    underline thickness
 768 %
 769 %  The format of the GetTypeMetrics method is:
 770 %
 771 %      MagickBooleanType GetTypeMetrics(Image *image,const DrawInfo *draw_info,
 772 %        TypeMetric *metrics,ExceptionInfo *exception)
 773 %
 774 %  A description of each parameter follows:
 775 %
 776 %    o image: the image.
 777 %
 778 %    o draw_info: the draw info.
 779 %
 780 %    o metrics: Return the font metrics in this structure.
 781 %
 782 %    o exception: return any errors or warnings in this structure.
 783 %
 784 */
 785 MagickExport MagickBooleanType GetTypeMetrics(Image *image,
 786   const DrawInfo *draw_info,TypeMetric *metrics,ExceptionInfo *exception)
 787 {
 788   DrawInfo
 789     *annotate_info;
 790
 791   MagickBooleanType
 792     status;
 793
 794   PointInfo
 795     offset;
 796
 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));
 808   offset.x=0.0;
 809   offset.y=0.0;
 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);
 822   return(status);
 823 }
 824 \f
 825 /*
 826 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 827 %                                                                             %
 828 %                                                                             %
 829 %                                                                             %
 830 +   R e n d e r T y p e                                                       %
 831 %                                                                             %
 832 %                                                                             %
 833 %                                                                             %
 834 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 835 %
 836 %  RenderType() renders text on the image.  It also returns the bounding box of
 837 %  the text relative to the image.
 838 %
 839 %  The format of the RenderType method is:
 840 %
 841 %      MagickBooleanType RenderType(Image *image,DrawInfo *draw_info,
 842 %        const PointInfo *offset,TypeMetric *metrics,ExceptionInfo *exception)
 843 %
 844 %  A description of each parameter follows:
 845 %
 846 %    o image: the image.
 847 %
 848 %    o draw_info: the draw info.
 849 %
 850 %    o offset: (x,y) location of text relative to image.
 851 %
 852 %    o metrics: bounding box of text.
 853 %
 854 %    o exception: return any errors or warnings in this structure.
 855 %
 856 */
 857 static MagickBooleanType RenderType(Image *image,const DrawInfo *draw_info,
 858   const PointInfo *offset,TypeMetric *metrics,ExceptionInfo *exception)
 859 {
 860   const TypeInfo
 861     *type_info;
 862
 863   DrawInfo
 864     *annotate_info;
 865
 866   MagickBooleanType
 867     status;
 868
 869   type_info=(const TypeInfo *) NULL;
 870   if (draw_info->font != (char *) NULL)
 871     {
 872       if (*draw_info->font == '@')
 873         {
 874           status=RenderFreetype(image,draw_info,draw_info->encoding,offset,
 875             metrics,exception);
 876           return(status);
 877         }
 878       if (*draw_info->font == '-')
 879         return(RenderX11(image,draw_info,offset,metrics,exception));
 880       if (IsPathAccessible(draw_info->font) != MagickFalse)
 881         {
 882           status=RenderFreetype(image,draw_info,draw_info->encoding,offset,
 883             metrics,exception);
 884           return(status);
 885         }
 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);
 890     }
 891   if ((type_info == (const TypeInfo *) NULL) &&
 892       (draw_info->family != (const char *) NULL))
 893     {
 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);
 899     }
 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)
 918     {
 919       status=RenderFreetype(image,draw_info,draw_info->encoding,offset,metrics,
 920         exception);
 921       return(status);
 922     }
 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,
 930     exception);
 931   annotate_info=DestroyDrawInfo(annotate_info);
 932   return(status);
 933 }
 934 \f
 935 /*
 936 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 937 %                                                                             %
 938 %                                                                             %
 939 %                                                                             %
 940 +   R e n d e r F r e e t y p e                                               %
 941 %                                                                             %
 942 %                                                                             %
 943 %                                                                             %
 944 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 945 %
 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.
 948 %
 949 %  The format of the RenderFreetype method is:
 950 %
 951 %      MagickBooleanType RenderFreetype(Image *image,DrawInfo *draw_info,
 952 %        const char *encoding,const PointInfo *offset,TypeMetric *metrics,
 953 %        ExceptionInfo *exception)
 954 %
 955 %  A description of each parameter follows:
 956 %
 957 %    o image: the image.
 958 %
 959 %    o draw_info: the draw info.
 960 %
 961 %    o encoding: the font encoding.
 962 %
 963 %    o offset: (x,y) location of text relative to image.
 964 %
 965 %    o metrics: bounding box of text.
 966 %
 967 %    o exception: return any errors or warnings in this structure.
 968 %
 969 */
 970
 971 #if defined(MAGICKCORE_FREETYPE_DELEGATE)
 972
 973 static int TraceCubicBezier(FT_Vector *p,FT_Vector *q,FT_Vector *to,
 974   DrawInfo *draw_info)
 975 {
 976   AffineMatrix
 977     affine;
 978
 979   char
 980     path[MaxTextExtent];
 981
 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);
 988   return(0);
 989 }
 990
 991 static int TraceLineTo(FT_Vector *to,DrawInfo *draw_info)
 992 {
 993   AffineMatrix
 994     affine;
 995
 996   char
 997     path[MaxTextExtent];
 998
 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);
1003   return(0);
1004 }
1005
1006 static int TraceMoveTo(FT_Vector *to,DrawInfo *draw_info)
1007 {
1008   AffineMatrix
1009     affine;
1010
1011   char
1012     path[MaxTextExtent];
1013
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);
1018   return(0);
1019 }
1020
1021 static int TraceQuadraticBezier(FT_Vector *control,FT_Vector *to,
1022   DrawInfo *draw_info)
1023 {
1024   AffineMatrix
1025     affine;
1026
1027   char
1028     path[MaxTextExtent];
1029
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);
1035   return(0);
1036 }
1037
1038 static MagickBooleanType RenderFreetype(Image *image,const DrawInfo *draw_info,
1039   const char *encoding,const PointInfo *offset,TypeMetric *metrics,
1040   ExceptionInfo *exception)
1041 {
1042 #if !defined(FT_OPEN_PATHNAME)
1043 #define FT_OPEN_PATHNAME  ft_open_pathname
1044 #endif
1045
1046   typedef struct _GlyphInfo
1047   {
1048     FT_UInt
1049       id;
1050
1051     FT_Vector
1052       origin;
1053
1054     FT_Glyph
1055       image;
1056   } GlyphInfo;
1057
1058   const char
1059     *value;
1060
1061   double
1062     direction;
1063
1064   DrawInfo
1065     *annotate_info;
1066
1067   FT_BBox
1068     bounds;
1069
1070   FT_BitmapGlyph
1071     bitmap;
1072
1073   FT_Encoding
1074     encoding_type;
1075
1076   FT_Error
1077     status;
1078
1079   FT_Face
1080     face;
1081
1082   FT_Int32
1083     flags;
1084
1085   FT_Library
1086     library;
1087
1088   FT_Matrix
1089     affine;
1090
1091   FT_Open_Args
1092     args;
1093
1094   FT_Vector
1095     origin;
1096
1097   GlyphInfo
1098     glyph,
1099     last_glyph;
1100
1101   PointInfo
1102     point,
1103     resolution;
1104
1105   register char
1106     *p;
1107
1108   ssize_t
1109     code,
1110     y;
1111
1112   static FT_Outline_Funcs
1113     OutlineMethods =
1114     {
1115       (FT_Outline_MoveTo_Func) TraceMoveTo,
1116       (FT_Outline_LineTo_Func) TraceLineTo,
1117       (FT_Outline_ConicTo_Func) TraceQuadraticBezier,
1118       (FT_Outline_CubicTo_Func) TraceCubicBezier,
1119       0, 0
1120     };
1121
1122   unsigned char
1123     *utf8;
1124
1125   /*
1126     Initialize Truetype library.
1127   */
1128   status=FT_Init_FreeType(&library);
1129   if (status != 0)
1130     ThrowBinaryException(TypeError,"UnableToInitializeFreetypeLibrary",
1131       image->filename);
1132   args.flags=FT_OPEN_PATHNAME;
1133   if (draw_info->font == (char *) NULL)
1134     args.pathname=ConstantString("helvetica");
1135   else
1136     if (*draw_info->font != '@')
1137       args.pathname=ConstantString(draw_info->font);
1138     else
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);
1143   if (status != 0)
1144     {
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));
1149     }
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)
1158     {
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;
1176 #endif
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);
1190       if (status != 0)
1191         ThrowBinaryException(TypeError,"UnrecognizedFontEncoding",encoding);
1192     }
1193   /*
1194     Set text size.
1195   */
1196   resolution.x=DefaultResolution;
1197   resolution.y=DefaultResolution;
1198   if (draw_info->density != (char *) NULL)
1199     {
1200       GeometryInfo
1201         geometry_info;
1202
1203       MagickStatusType
1204         flags;
1205
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;
1211     }
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;
1219   metrics->width=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'))
1233     {
1234       (void) FT_Done_Face(face);
1235       (void) FT_Done_FreeType(library);
1236       return(MagickTrue);
1237     }
1238   /*
1239     Compute bounding box.
1240   */
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");
1250   if ((value != (const char *) NULL) && (LocaleCompare(value,"off") == 0))
1251     flags|=FT_LOAD_NO_HINTING;
1252   glyph.id=0;
1253   glyph.image=NULL;
1254   last_glyph.id=0;
1255   last_glyph.image=NULL;
1256   origin.x=0;
1257   origin.y=0;
1258   affine.xx=65536L;
1259   affine.yx=0L;
1260   affine.xy=0L;
1261   affine.yy=65536L;
1262   if (draw_info->render != MagickFalse)
1263     {
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);
1268     }
1269   annotate_info=CloneDrawInfo((ImageInfo *) NULL,draw_info);
1270   (void) CloneString(&annotate_info->primitive,"path '");
1271   if (draw_info->render != MagickFalse)
1272     {
1273       if (image->storage_class != DirectClass)
1274         (void) SetImageStorageClass(image,DirectClass,exception);
1275       if (image->matte == MagickFalse)
1276         (void) SetImageAlphaChannel(image,OpaqueAlphaChannel,exception);
1277     }
1278   direction=1.0;
1279   if (draw_info->direction == RightToLeftDirection)
1280     direction=(-1.0);
1281   point.x=0.0;
1282   point.y=0.0;
1283   for (p=draw_info->text; GetUTFCode(p) != 0; p+=GetUTFOctets(p))
1284     if (GetUTFCode(p) < 0)
1285       break;
1286   utf8=(unsigned char *) NULL;
1287   if (GetUTFCode(p) == 0)
1288     p=draw_info->text;
1289   else
1290     {
1291       utf8=ConvertLatin1ToUTF8((unsigned char *) draw_info->text);
1292       if (utf8 != (unsigned char *) NULL)
1293         p=(char *) utf8;
1294     }
1295   for (code=0; GetUTFCode(p) != 0; p+=GetUTFOctets(p))
1296   {
1297     /*
1298       Render UTF-8 sequence.
1299     */
1300     glyph.id=FT_Get_Char_Index(face,GetUTFCode(p));
1301     if (glyph.id == 0)
1302       glyph.id=FT_Get_Char_Index(face,'?');
1303     if ((glyph.id != 0) && (last_glyph.id != 0))
1304       {
1305         if (fabs(draw_info->kerning) >= MagickEpsilon)
1306           origin.x+=(FT_Pos) (64.0*direction*draw_info->kerning);
1307         else
1308           if (FT_HAS_KERNING(face))
1309             {
1310               FT_Vector
1311                 kerning;
1312
1313               status=FT_Get_Kerning(face,last_glyph.id,glyph.id,
1314                 ft_kerning_default,&kerning);
1315               if (status == 0)
1316                 origin.x+=(FT_Pos) (direction*kerning.x);
1317             }
1318         }
1319     glyph.origin=origin;
1320     status=FT_Load_Glyph(face,glyph.id,flags);
1321     if (status != 0)
1322       continue;
1323     status=FT_Get_Glyph(face->glyph,&glyph.image);
1324     if (status != 0)
1325       continue;
1326     status=FT_Outline_Get_BBox(&((FT_OutlineGlyph) glyph.image)->outline,
1327       &bounds);
1328     if (status != 0)
1329       continue;
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))
1341         {
1342           /*
1343             Trace the glyph.
1344           */
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);
1349         }
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);
1354     if (status != 0)
1355       continue;
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)
1362       {
1363         CacheView
1364           *image_view;
1365
1366         MagickBooleanType
1367           status;
1368
1369         register unsigned char
1370           *p;
1371
1372         /*
1373           Rasterize the glyph.
1374         */
1375         status=MagickTrue;
1376         image_view=AcquireCacheView(image);
1377         p=bitmap->bitmap.buffer;
1378         for (y=0; y < (ssize_t) bitmap->bitmap.rows; y++)
1379         {
1380           MagickBooleanType
1381             active,
1382             sync;
1383
1384           MagickRealType
1385             fill_opacity;
1386
1387           PixelPacket
1388             fill_color;
1389
1390           register Quantum
1391             *restrict q;
1392
1393           register ssize_t
1394             x;
1395
1396           ssize_t
1397             n,
1398             x_offset,
1399             y_offset;
1400
1401           if (status == MagickFalse)
1402             continue;
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))
1406             continue;
1407           q=(Quantum *) NULL;
1408           if ((x_offset < 0) || (x_offset >= (ssize_t) image->columns))
1409             active=MagickFalse;
1410           else
1411             {
1412               q=GetCacheViewAuthenticPixels(image_view,x_offset,y_offset,
1413                 bitmap->bitmap.width,1,exception);
1414               active=q != (Quantum *) NULL ? MagickTrue : MagickFalse;
1415             }
1416           n=y*bitmap->bitmap.pitch-1;
1417           for (x=0; x < (ssize_t) bitmap->bitmap.width; x++)
1418           {
1419             n++;
1420             x_offset++;
1421             if ((x_offset < 0) || (x_offset >= (ssize_t) image->columns))
1422               {
1423                 q+=GetPixelChannels(image);
1424                 continue;
1425               }
1426             if (bitmap->bitmap.pixel_mode != ft_pixel_mode_mono)
1427               fill_opacity=(MagickRealType) (p[n])/(bitmap->bitmap.num_grays-1);
1428             else
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,
1435                 exception);
1436             if (q == (Quantum *) NULL)
1437               {
1438                 q+=GetPixelChannels(image);
1439                 continue;
1440               }
1441             (void) GetFillColor(draw_info,x_offset,y_offset,&fill_color,
1442               exception);
1443             fill_opacity=fill_opacity*fill_color.alpha;
1444             CompositePixelOver(image,&fill_color,fill_opacity,q,
1445               GetPixelAlpha(image,q),q);
1446             if (active == MagickFalse)
1447               {
1448                 sync=SyncCacheViewAuthenticPixels(image_view,exception);
1449                 if (sync == MagickFalse)
1450                   status=MagickFalse;
1451               }
1452             q+=GetPixelChannels(image);
1453           }
1454           sync=SyncCacheViewAuthenticPixels(image_view,exception);
1455           if (sync == MagickFalse)
1456             status=MagickFalse;
1457         }
1458         image_view=DestroyCacheView(image_view);
1459       }
1460     if ((bitmap->left+bitmap->bitmap.width) > metrics->width)
1461       metrics->width=bitmap->left+bitmap->bitmap.width;
1462     if ((fabs(draw_info->interword_spacing) >= MagickEpsilon) &&
1463         (IsUTFSpace(GetUTFCode(p)) != MagickFalse) &&
1464         (IsUTFSpace(code) == MagickFalse))
1465       origin.x+=(FT_Pos) (64.0*direction*draw_info->interword_spacing);
1466     else
1467       origin.x+=(FT_Pos) (direction*face->glyph->advance.x);
1468     metrics->origin.x=(double) origin.x;
1469     metrics->origin.y=(double) origin.y;
1470     if (last_glyph.id != 0)
1471       FT_Done_Glyph(last_glyph.image);
1472     last_glyph=glyph;
1473     code=GetUTFCode(p);
1474   }
1475   if (utf8 != (unsigned char *) NULL)
1476     utf8=(unsigned char *) RelinquishMagickMemory(utf8);
1477   if (last_glyph.id != 0)
1478     FT_Done_Glyph(last_glyph.image);
1479   if ((draw_info->stroke.alpha != TransparentAlpha) ||
1480       (draw_info->stroke_pattern != (Image *) NULL))
1481     {
1482       if (draw_info->render != MagickFalse)
1483         {
1484           /*
1485             Draw text stroke.
1486           */
1487           annotate_info->linejoin=RoundJoin;
1488           annotate_info->affine.tx=offset->x;
1489           annotate_info->affine.ty=offset->y;
1490           (void) ConcatenateString(&annotate_info->primitive,"'");
1491           (void) DrawImage(image,annotate_info,exception);
1492         }
1493       }
1494   /*
1495     Determine font metrics.
1496   */
1497   glyph.id=FT_Get_Char_Index(face,'_');
1498   glyph.origin=origin;
1499   status=FT_Load_Glyph(face,glyph.id,flags);
1500   if (status == 0)
1501     {
1502       status=FT_Get_Glyph(face->glyph,&glyph.image);
1503       if (status == 0)
1504         {
1505           status=FT_Outline_Get_BBox(&((FT_OutlineGlyph) glyph.image)->
1506             outline,&bounds);
1507           if (status == 0)
1508             {
1509               FT_Vector_Transform(&glyph.origin,&affine);
1510               (void) FT_Glyph_Transform(glyph.image,&affine,&glyph.origin);
1511               status=FT_Glyph_To_Bitmap(&glyph.image,ft_render_mode_normal,
1512                 (FT_Vector *) NULL,MagickTrue);
1513               bitmap=(FT_BitmapGlyph) glyph.image;
1514               if (bitmap->left > metrics->width)
1515                 metrics->width=bitmap->left;
1516             }
1517         }
1518       FT_Done_Glyph(glyph.image);
1519     }
1520   metrics->width-=metrics->bounds.x1/64.0;
1521   metrics->bounds.x1/=64.0;
1522   metrics->bounds.y1/=64.0;
1523   metrics->bounds.x2/=64.0;
1524   metrics->bounds.y2/=64.0;
1525   metrics->origin.x/=64.0;
1526   metrics->origin.y/=64.0;
1527   /*
1528     Relinquish resources.
1529   */
1530   annotate_info=DestroyDrawInfo(annotate_info);
1531   (void) FT_Done_Face(face);
1532   (void) FT_Done_FreeType(library);
1533   return(MagickTrue);
1534 }
1535 #else
1536 static MagickBooleanType RenderFreetype(Image *image,const DrawInfo *draw_info,
1537   const char *magick_unused(encoding),const PointInfo *offset,
1538   TypeMetric *metrics,ExceptionInfo *exception)
1539 {
1540   (void) ThrowMagickException(exception,GetMagickModule(),
1541     MissingDelegateWarning,"DelegateLibrarySupportNotBuiltIn","`%s' (Freetype)",
1542     draw_info->font != (char *) NULL ? draw_info->font : "none");
1543   return(RenderPostscript(image,draw_info,offset,metrics));
1544 }
1545 #endif
1546 \f
1547 /*
1548 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1549 %                                                                             %
1550 %                                                                             %
1551 %                                                                             %
1552 +   R e n d e r P o s t s c r i p t                                           %
1553 %                                                                             %
1554 %                                                                             %
1555 %                                                                             %
1556 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1557 %
1558 %  RenderPostscript() renders text on the image with a Postscript font.  It
1559 %  also returns the bounding box of the text relative to the image.
1560 %
1561 %  The format of the RenderPostscript method is:
1562 %
1563 %      MagickBooleanType RenderPostscript(Image *image,DrawInfo *draw_info,
1564 %        const PointInfo *offset,TypeMetric *metrics,ExceptionInfo *exception)
1565 %
1566 %  A description of each parameter follows:
1567 %
1568 %    o image: the image.
1569 %
1570 %    o draw_info: the draw info.
1571 %
1572 %    o offset: (x,y) location of text relative to image.
1573 %
1574 %    o metrics: bounding box of text.
1575 %
1576 %    o exception: return any errors or warnings in this structure.
1577 %
1578 */
1579
1580 static inline size_t MagickMin(const size_t x,const size_t y)
1581 {
1582   if (x < y)
1583     return(x);
1584   return(y);
1585 }
1586
1587 static char *EscapeParenthesis(const char *text)
1588 {
1589   char
1590     *buffer;
1591
1592   register char
1593     *p;
1594
1595   register ssize_t
1596     i;
1597
1598   size_t
1599     escapes;
1600
1601   escapes=0;
1602   buffer=AcquireString(text);
1603   p=buffer;
1604   for (i=0; i < (ssize_t) MagickMin(strlen(text),MaxTextExtent-escapes-1); i++)
1605   {
1606     if ((text[i] == '(') || (text[i] == ')'))
1607       {
1608         *p++='\\';
1609         escapes++;
1610       }
1611     *p++=text[i];
1612   }
1613   *p='\0';
1614   return(buffer);
1615 }
1616
1617 static MagickBooleanType RenderPostscript(Image *image,
1618   const DrawInfo *draw_info,const PointInfo *offset,TypeMetric *metrics,
1619   ExceptionInfo *exception)
1620 {
1621   char
1622     filename[MaxTextExtent],
1623     geometry[MaxTextExtent],
1624     *text;
1625
1626   FILE
1627     *file;
1628
1629   Image
1630     *annotate_image;
1631
1632   ImageInfo
1633     *annotate_info;
1634
1635   int
1636     unique_file;
1637
1638   MagickBooleanType
1639     identity;
1640
1641   PointInfo
1642     extent,
1643     point,
1644     resolution;
1645
1646   register ssize_t
1647     i;
1648
1649   ssize_t
1650     y;
1651
1652   /*
1653     Render label with a Postscript font.
1654   */
1655   if (image->debug != MagickFalse)
1656     (void) LogMagickEvent(AnnotateEvent,GetMagickModule(),
1657       "Font %s; pointsize %g",draw_info->font != (char *) NULL ?
1658       draw_info->font : "none",draw_info->pointsize);
1659   file=(FILE *) NULL;
1660   unique_file=AcquireUniqueFileResource(filename);
1661   if (unique_file != -1)
1662     file=fdopen(unique_file,"wb");
1663   if ((unique_file == -1) || (file == (FILE *) NULL))
1664     {
1665       ThrowFileException(exception,FileOpenError,"UnableToOpenFile",filename);
1666       return(MagickFalse);
1667     }
1668   (void) FormatLocaleFile(file,"%%!PS-Adobe-3.0\n");
1669   (void) FormatLocaleFile(file,"/ReencodeType\n");
1670   (void) FormatLocaleFile(file,"{\n");
1671   (void) FormatLocaleFile(file,"  findfont dup length\n");
1672   (void) FormatLocaleFile(file,
1673     "  dict begin { 1 index /FID ne {def} {pop pop} ifelse } forall\n");
1674   (void) FormatLocaleFile(file,
1675     "  /Encoding ISOLatin1Encoding def currentdict end definefont pop\n");
1676   (void) FormatLocaleFile(file,"} bind def\n");
1677   /*
1678     Sample to compute bounding box.
1679   */
1680   identity=(fabs(draw_info->affine.sx-draw_info->affine.sy) < MagickEpsilon) &&
1681     (fabs(draw_info->affine.rx) < MagickEpsilon) &&
1682     (fabs(draw_info->affine.ry) < MagickEpsilon) ? MagickTrue : MagickFalse;
1683   extent.x=0.0;
1684   extent.y=0.0;
1685   for (i=0; i <= (ssize_t) (strlen(draw_info->text)+2); i++)
1686   {
1687     point.x=fabs(draw_info->affine.sx*i*draw_info->pointsize+
1688       draw_info->affine.ry*2.0*draw_info->pointsize);
1689     point.y=fabs(draw_info->affine.rx*i*draw_info->pointsize+
1690       draw_info->affine.sy*2.0*draw_info->pointsize);
1691     if (point.x > extent.x)
1692       extent.x=point.x;
1693     if (point.y > extent.y)
1694       extent.y=point.y;
1695   }
1696   (void) FormatLocaleFile(file,"%g %g moveto\n",identity  != MagickFalse ? 0.0 :
1697     extent.x/2.0,extent.y/2.0);
1698   (void) FormatLocaleFile(file,"%g %g scale\n",draw_info->pointsize,
1699     draw_info->pointsize);
1700   if ((draw_info->font == (char *) NULL) || (*draw_info->font == '\0') ||
1701       (strchr(draw_info->font,'/') != (char *) NULL))
1702     (void) FormatLocaleFile(file,
1703       "/Times-Roman-ISO dup /Times-Roman ReencodeType findfont setfont\n");
1704   else
1705     (void) FormatLocaleFile(file,
1706       "/%s-ISO dup /%s ReencodeType findfont setfont\n",draw_info->font,
1707       draw_info->font);
1708   (void) FormatLocaleFile(file,"[%g %g %g %g 0 0] concat\n",
1709     draw_info->affine.sx,-draw_info->affine.rx,-draw_info->affine.ry,
1710     draw_info->affine.sy);
1711   text=EscapeParenthesis(draw_info->text);
1712   if (identity == MagickFalse)
1713     (void) FormatLocaleFile(file,"(%s) stringwidth pop -0.5 mul -0.5 rmoveto\n",
1714       text);
1715   (void) FormatLocaleFile(file,"(%s) show\n",text);
1716   text=DestroyString(text);
1717   (void) FormatLocaleFile(file,"showpage\n");
1718   (void) fclose(file);
1719   (void) FormatLocaleString(geometry,MaxTextExtent,"%.20gx%.20g+0+0!",
1720     floor(extent.x+0.5),floor(extent.y+0.5));
1721   annotate_info=AcquireImageInfo();
1722   (void) FormatLocaleString(annotate_info->filename,MaxTextExtent,"ps:%s",
1723     filename);
1724   (void) CloneString(&annotate_info->page,geometry);
1725   if (draw_info->density != (char *) NULL)
1726     (void) CloneString(&annotate_info->density,draw_info->density);
1727   annotate_info->antialias=draw_info->text_antialias;
1728   annotate_image=ReadImage(annotate_info,exception);
1729   CatchException(exception);
1730   annotate_info=DestroyImageInfo(annotate_info);
1731   (void) RelinquishUniqueFileResource(filename);
1732   if (annotate_image == (Image *) NULL)
1733     return(MagickFalse);
1734   resolution.x=DefaultResolution;
1735   resolution.y=DefaultResolution;
1736   if (draw_info->density != (char *) NULL)
1737     {
1738       GeometryInfo
1739         geometry_info;
1740
1741       MagickStatusType
1742         flags;
1743
1744       flags=ParseGeometry(draw_info->density,&geometry_info);
1745       resolution.x=geometry_info.rho;
1746       resolution.y=geometry_info.sigma;
1747       if ((flags & SigmaValue) == 0)
1748         resolution.y=resolution.x;
1749     }
1750   if (identity == MagickFalse)
1751     (void) TransformImage(&annotate_image,"0x0",(char *) NULL);
1752   else
1753     {
1754       RectangleInfo
1755         crop_info;
1756
1757       crop_info=GetImageBoundingBox(annotate_image,exception);
1758       crop_info.height=(size_t) ((resolution.y/DefaultResolution)*
1759         ExpandAffine(&draw_info->affine)*draw_info->pointsize+0.5);
1760       crop_info.y=(ssize_t) ceil((resolution.y/DefaultResolution)*extent.y/8.0-
1761         0.5);
1762       (void) FormatLocaleString(geometry,MaxTextExtent,
1763         "%.20gx%.20g%+.20g%+.20g",(double) crop_info.width,(double)
1764         crop_info.height,(double) crop_info.x,(double) crop_info.y);
1765       (void) TransformImage(&annotate_image,geometry,(char *) NULL);
1766     }
1767   metrics->pixels_per_em.x=(resolution.y/DefaultResolution)*
1768     ExpandAffine(&draw_info->affine)*draw_info->pointsize;
1769   metrics->pixels_per_em.y=metrics->pixels_per_em.x;
1770   metrics->ascent=metrics->pixels_per_em.x;
1771   metrics->descent=metrics->pixels_per_em.y/-5.0;
1772   metrics->width=(double) annotate_image->columns/
1773     ExpandAffine(&draw_info->affine);
1774   metrics->height=1.152*metrics->pixels_per_em.x;
1775   metrics->max_advance=metrics->pixels_per_em.x;
1776   metrics->bounds.x1=0.0;
1777   metrics->bounds.y1=metrics->descent;
1778   metrics->bounds.x2=metrics->ascent+metrics->descent;
1779   metrics->bounds.y2=metrics->ascent+metrics->descent;
1780   metrics->underline_position=(-2.0);
1781   metrics->underline_thickness=1.0;
1782   if (draw_info->render == MagickFalse)
1783     {
1784       annotate_image=DestroyImage(annotate_image);
1785       return(MagickTrue);
1786     }
1787   if (draw_info->fill.alpha != TransparentAlpha)
1788     {
1789       CacheView
1790         *annotate_view;
1791
1792       MagickBooleanType
1793         sync;
1794
1795       PixelPacket
1796         fill_color;
1797
1798       /*
1799         Render fill color.
1800       */
1801       if (image->matte == MagickFalse)
1802         (void) SetImageAlphaChannel(image,OpaqueAlphaChannel,exception);
1803       if (annotate_image->matte == MagickFalse)
1804         (void) SetImageAlphaChannel(annotate_image,OpaqueAlphaChannel,
1805           exception);
1806       fill_color=draw_info->fill;
1807       annotate_view=AcquireCacheView(annotate_image);
1808       for (y=0; y < (ssize_t) annotate_image->rows; y++)
1809       {
1810         register ssize_t
1811           x;
1812
1813         register Quantum
1814           *restrict q;
1815
1816         q=GetCacheViewAuthenticPixels(annotate_view,0,y,annotate_image->columns,
1817           1,exception);
1818         if (q == (Quantum *) NULL)
1819           break;
1820         for (x=0; x < (ssize_t) annotate_image->columns; x++)
1821         {
1822           (void) GetFillColor(draw_info,x,y,&fill_color,exception);
1823           SetPixelAlpha(annotate_image,ClampToQuantum((((MagickRealType)
1824             GetPixelIntensity(annotate_image,q)*fill_color.alpha)/
1825             QuantumRange)),q);
1826           SetPixelRed(annotate_image,fill_color.red,q);
1827           SetPixelGreen(annotate_image,fill_color.green,q);
1828           SetPixelBlue(annotate_image,fill_color.blue,q);
1829           q+=GetPixelChannels(annotate_image);
1830         }
1831         sync=SyncCacheViewAuthenticPixels(annotate_view,exception);
1832         if (sync == MagickFalse)
1833           break;
1834       }
1835       annotate_view=DestroyCacheView(annotate_view);
1836       (void) CompositeImage(image,OverCompositeOp,annotate_image,
1837         (ssize_t) ceil(offset->x-0.5),(ssize_t) ceil(offset->y-(metrics->ascent+
1838         metrics->descent)-0.5));
1839     }
1840   annotate_image=DestroyImage(annotate_image);
1841   return(MagickTrue);
1842 }
1843 \f
1844 /*
1845 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1846 %                                                                             %
1847 %                                                                             %
1848 %                                                                             %
1849 +   R e n d e r X 1 1                                                         %
1850 %                                                                             %
1851 %                                                                             %
1852 %                                                                             %
1853 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1854 %
1855 %  RenderX11() renders text on the image with an X11 font.  It also returns the
1856 %  bounding box of the text relative to the image.
1857 %
1858 %  The format of the RenderX11 method is:
1859 %
1860 %      MagickBooleanType RenderX11(Image *image,DrawInfo *draw_info,
1861 %        const PointInfo *offset,TypeMetric *metrics,ExceptionInfo *exception)
1862 %
1863 %  A description of each parameter follows:
1864 %
1865 %    o image: the image.
1866 %
1867 %    o draw_info: the draw info.
1868 %
1869 %    o offset: (x,y) location of text relative to image.
1870 %
1871 %    o metrics: bounding box of text.
1872 %
1873 %    o exception: return any errors or warnings in this structure.
1874 %
1875 */
1876 #if defined(MAGICKCORE_X11_DELEGATE)
1877 static MagickBooleanType RenderX11(Image *image,const DrawInfo *draw_info,
1878   const PointInfo *offset,TypeMetric *metrics,ExceptionInfo *exception)
1879 {
1880   MagickBooleanType
1881     status;
1882
1883   static DrawInfo
1884     cache_info;
1885
1886   static Display
1887     *display = (Display *) NULL;
1888
1889   static XAnnotateInfo
1890     annotate_info;
1891
1892   static XFontStruct
1893     *font_info;
1894
1895   static XPixelInfo
1896     pixel;
1897
1898   static XResourceInfo
1899     resource_info;
1900
1901   static XrmDatabase
1902     resource_database;
1903
1904   static XStandardColormap
1905     *map_info;
1906
1907   static XVisualInfo
1908     *visual_info;
1909
1910   size_t
1911     height,
1912     width;
1913
1914   if (annotate_semaphore == (SemaphoreInfo *) NULL)
1915     AcquireSemaphoreInfo(&annotate_semaphore);
1916   LockSemaphoreInfo(annotate_semaphore);
1917   if (display == (Display *) NULL)
1918     {
1919       const char
1920         *client_name;
1921
1922       ImageInfo
1923         *image_info;
1924
1925       /*
1926         Open X server connection.
1927       */
1928       display=XOpenDisplay(draw_info->server_name);
1929       if (display == (Display *) NULL)
1930         {
1931           ThrowXWindowException(XServerError,"UnableToOpenXServer",
1932             draw_info->server_name);
1933           return(MagickFalse);
1934         }
1935       /*
1936         Get user defaults from X resource database.
1937       */
1938       (void) XSetErrorHandler(XError);
1939       image_info=AcquireImageInfo();
1940       client_name=GetClientName();
1941       resource_database=XGetResourceDatabase(display,client_name);
1942       XGetResourceInfo(image_info,resource_database,client_name,&resource_info);
1943       resource_info.close_server=MagickFalse;
1944       resource_info.colormap=PrivateColormap;
1945       resource_info.font=AcquireString(draw_info->font);
1946       resource_info.background_color=AcquireString("#ffffffffffff");
1947       resource_info.foreground_color=AcquireString("#000000000000");
1948       map_info=XAllocStandardColormap();
1949       if (map_info == (XStandardColormap *) NULL)
1950         {
1951           ThrowXWindowException(ResourceLimitError,"MemoryAllocationFailed",
1952             image->filename);
1953           return(MagickFalse);
1954         }
1955       /*
1956         Initialize visual info.
1957       */
1958       visual_info=XBestVisualInfo(display,map_info,&resource_info);
1959       if (visual_info == (XVisualInfo *) NULL)
1960         {
1961           ThrowXWindowException(XServerError,"UnableToGetVisual",
1962             image->filename);
1963           return(MagickFalse);
1964         }
1965       map_info->colormap=(Colormap) NULL;
1966       pixel.pixels=(unsigned long *) NULL;
1967       /*
1968         Initialize Standard Colormap info.
1969       */
1970       XGetMapInfo(visual_info,XDefaultColormap(display,visual_info->screen),
1971         map_info);
1972       XGetPixelInfo(display,visual_info,map_info,&resource_info,(Image *) NULL,
1973         &pixel);
1974       pixel.annotate_context=XDefaultGC(display,visual_info->screen);
1975       /*
1976         Initialize font info.
1977       */
1978       font_info=XBestFont(display,&resource_info,MagickFalse);
1979       if (font_info == (XFontStruct *) NULL)
1980         {
1981           ThrowXWindowException(XServerError,"UnableToLoadFont",
1982             draw_info->font);
1983           return(MagickFalse);
1984         }
1985       if ((map_info == (XStandardColormap *) NULL) ||
1986           (visual_info == (XVisualInfo *) NULL) ||
1987           (font_info == (XFontStruct *) NULL))
1988         {
1989           XFreeResources(display,visual_info,map_info,&pixel,font_info,
1990             &resource_info,(XWindowInfo *) NULL);
1991           ThrowXWindowException(XServerError,"UnableToLoadFont",
1992             image->filename);
1993           return(MagickFalse);
1994         }
1995       cache_info=(*draw_info);
1996     }
1997   UnlockSemaphoreInfo(annotate_semaphore);
1998   /*
1999     Initialize annotate info.
2000   */
2001   XGetAnnotateInfo(&annotate_info);
2002   annotate_info.stencil=ForegroundStencil;
2003   if (cache_info.font != draw_info->font)
2004     {
2005       /*
2006         Type name has changed.
2007       */
2008       (void) XFreeFont(display,font_info);
2009       (void) CloneString(&resource_info.font,draw_info->font);
2010       font_info=XBestFont(display,&resource_info,MagickFalse);
2011       if (font_info == (XFontStruct *) NULL)
2012         {
2013           ThrowXWindowException(XServerError,"UnableToLoadFont",
2014             draw_info->font);
2015           return(MagickFalse);
2016         }
2017     }
2018   if (image->debug != MagickFalse)
2019     (void) LogMagickEvent(AnnotateEvent,GetMagickModule(),
2020       "Font %s; pointsize %g",draw_info->font != (char *) NULL ?
2021       draw_info->font : "none",draw_info->pointsize);
2022   cache_info=(*draw_info);
2023   annotate_info.font_info=font_info;
2024   annotate_info.text=(char *) draw_info->text;
2025   annotate_info.width=(unsigned int) XTextWidth(font_info,draw_info->text,
2026     (int) strlen(draw_info->text));
2027   annotate_info.height=(unsigned int) font_info->ascent+font_info->descent;
2028   metrics->pixels_per_em.x=(double) font_info->max_bounds.width;
2029   metrics->pixels_per_em.y=(double) font_info->ascent+font_info->descent;
2030   metrics->ascent=(double) font_info->ascent+4;
2031   metrics->descent=(double) (-font_info->descent);
2032   metrics->width=annotate_info.width/ExpandAffine(&draw_info->affine);
2033   metrics->height=font_info->ascent+font_info->descent;
2034   metrics->max_advance=(double) font_info->max_bounds.width;
2035   metrics->bounds.x1=0.0;
2036   metrics->bounds.y1=metrics->descent;
2037   metrics->bounds.x2=metrics->ascent+metrics->descent;
2038   metrics->bounds.y2=metrics->ascent+metrics->descent;
2039   metrics->underline_position=(-2.0);
2040   metrics->underline_thickness=1.0;
2041   if (draw_info->render == MagickFalse)
2042     return(MagickTrue);
2043   if (draw_info->fill.alpha == TransparentAlpha)
2044     return(MagickTrue);
2045   /*
2046     Render fill color.
2047   */
2048   width=annotate_info.width;
2049   height=annotate_info.height;
2050   if ((fabs(draw_info->affine.rx) >= MagickEpsilon) ||
2051       (fabs(draw_info->affine.ry) >= MagickEpsilon))
2052     {
2053       if ((fabs(draw_info->affine.sx-draw_info->affine.sy) < MagickEpsilon) &&
2054           (fabs(draw_info->affine.rx+draw_info->affine.ry) < MagickEpsilon))
2055         annotate_info.degrees=(double) (180.0/MagickPI)*
2056           atan2(draw_info->affine.rx,draw_info->affine.sx);
2057     }
2058   (void) FormatLocaleString(annotate_info.geometry,MaxTextExtent,
2059     "%.20gx%.20g%+.20g%+.20g",(double) width,(double) height,
2060     ceil(offset->x-0.5),ceil(offset->y-metrics->ascent-metrics->descent+
2061     draw_info->interline_spacing-0.5));
2062   pixel.pen_color.red=ScaleQuantumToShort(draw_info->fill.red);
2063   pixel.pen_color.green=ScaleQuantumToShort(draw_info->fill.green);
2064   pixel.pen_color.blue=ScaleQuantumToShort(draw_info->fill.blue);
2065   status=XAnnotateImage(display,&pixel,&annotate_info,image);
2066   if (status == 0)
2067     {
2068       ThrowXWindowException(ResourceLimitError,"MemoryAllocationFailed",
2069         image->filename);
2070       return(MagickFalse);
2071     }
2072   return(MagickTrue);
2073 }
2074 #else
2075 static MagickBooleanType RenderX11(Image *image,const DrawInfo *draw_info,
2076   const PointInfo *offset,TypeMetric *metrics,ExceptionInfo *exception)
2077 {
2078   (void) draw_info;
2079   (void) offset;
2080   (void) metrics;
2081   (void) ThrowMagickException(exception,GetMagickModule(),
2082     MissingDelegateError,"DelegateLibrarySupportNotBuiltIn","`%s' (X11)",
2083     image->filename);
2084   return(MagickFalse);
2085 }
2086 #endif