2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
6 % PPPP AAA N N GGGG OOO %
8 % PPPP AAAAA N N N G GGG O O %
9 % P M A A N NN G G O O %
10 % P A A N N GGGG OOO %
13 % Read Pango Markup Language Format %
20 % Copyright 1999-2015 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 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
42 #include "MagickCore/studio.h"
43 #include "MagickCore/annotate.h"
44 #include "MagickCore/artifact.h"
45 #include "MagickCore/blob.h"
46 #include "MagickCore/blob-private.h"
47 #include "MagickCore/composite-private.h"
48 #include "MagickCore/draw.h"
49 #include "MagickCore/draw-private.h"
50 #include "MagickCore/exception.h"
51 #include "MagickCore/exception-private.h"
52 #include "MagickCore/image.h"
53 #include "MagickCore/image-private.h"
54 #include "MagickCore/list.h"
55 #include "MagickCore/magick.h"
56 #include "MagickCore/memory_.h"
57 #include "MagickCore/module.h"
58 #include "MagickCore/monitor.h"
59 #include "MagickCore/monitor-private.h"
60 #include "MagickCore/option.h"
61 #include "MagickCore/pixel-accessor.h"
62 #include "MagickCore/property.h"
63 #include "MagickCore/quantum-private.h"
64 #include "MagickCore/static.h"
65 #include "MagickCore/string_.h"
66 #include "MagickCore/string-private.h"
67 #include "MagickCore/token.h"
68 #include "MagickCore/utility.h"
69 #if defined(MAGICKCORE_PANGOCAIRO_DELEGATE)
70 #include <pango/pango.h>
71 #include <pango/pangocairo.h>
72 #include <pango/pango-features.h>
75 #if defined(MAGICKCORE_PANGOCAIRO_DELEGATE)
77 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
81 % R e a d P A N G O I m a g e %
85 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
87 % ReadPANGOImage() reads an image in the Pango Markup Language Format.
89 % The format of the ReadPANGOImage method is:
91 % Image *ReadPANGOImage(const ImageInfo *image_info,
92 % ExceptionInfo *exception)
94 % A description of each parameter follows:
96 % o image_info: the image info.
98 % o exception: return any errors or warnings in this structure.
101 static Image *ReadPANGOImage(const ImageInfo *image_info,
102 ExceptionInfo *exception)
156 register unsigned char
169 Initialize Image structure.
171 assert(image_info != (const ImageInfo *) NULL);
172 assert(image_info->signature == MagickSignature);
173 if (image_info->debug != MagickFalse)
174 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",
175 image_info->filename);
176 assert(exception != (ExceptionInfo *) NULL);
177 assert(exception->signature == MagickSignature);
178 image=AcquireImage(image_info,exception);
179 (void) ResetImagePage(image,"0x0+0+0");
183 option=GetImageOption(image_info,"filename");
184 if (option == (const char *) NULL)
185 property=InterpretImageProperties((ImageInfo *) image_info,image,
186 image_info->filename,exception);
188 if (LocaleNCompare(option,"pango:",6) == 0)
189 property=InterpretImageProperties((ImageInfo *) image_info,image,option+6,
192 property=InterpretImageProperties((ImageInfo *) image_info,image,option,
194 (void) SetImageProperty(image,"caption",property,exception);
195 property=DestroyString(property);
196 caption=ConstantString(GetImageProperty(image,"caption",exception));
200 fontmap=pango_cairo_font_map_new();
201 pango_cairo_font_map_set_resolution(PANGO_CAIRO_FONT_MAP(fontmap),
202 image->resolution.x == 0.0 ? 90.0 : image->resolution.x);
203 font_options=cairo_font_options_create();
204 option=GetImageOption(image_info,"pango:hinting");
205 if (option != (const char *) NULL)
207 if (LocaleCompare(option,"none") != 0)
208 cairo_font_options_set_hint_style(font_options,CAIRO_HINT_STYLE_NONE);
209 if (LocaleCompare(option,"full") != 0)
210 cairo_font_options_set_hint_style(font_options,CAIRO_HINT_STYLE_FULL);
212 context=pango_font_map_create_context(fontmap);
213 pango_cairo_context_set_font_options(context,font_options);
214 cairo_font_options_destroy(font_options);
215 option=GetImageOption(image_info,"pango:language");
216 if (option != (const char *) NULL)
217 pango_context_set_language(context,pango_language_from_string(option));
218 draw_info=CloneDrawInfo(image_info,(DrawInfo *) NULL);
219 pango_context_set_base_dir(context,draw_info->direction ==
220 RightToLeftDirection ? PANGO_DIRECTION_RTL : PANGO_DIRECTION_LTR);
221 switch (draw_info->gravity)
225 gravity=PANGO_GRAVITY_NORTH;
228 case NorthWestGravity:
230 case SouthWestGravity:
232 gravity=PANGO_GRAVITY_WEST;
235 case NorthEastGravity:
237 case SouthEastGravity:
239 gravity=PANGO_GRAVITY_EAST;
244 gravity=PANGO_GRAVITY_SOUTH;
249 gravity=PANGO_GRAVITY_AUTO;
253 pango_context_set_base_gravity(context,gravity);
254 option=GetImageOption(image_info,"pango:gravity-hint");
255 if (option != (const char *) NULL)
257 if (LocaleCompare(option,"line") == 0)
258 pango_context_set_gravity_hint(context,PANGO_GRAVITY_HINT_LINE);
259 if (LocaleCompare(option,"natural") == 0)
260 pango_context_set_gravity_hint(context,PANGO_GRAVITY_HINT_NATURAL);
261 if (LocaleCompare(option,"strong") == 0)
262 pango_context_set_gravity_hint(context,PANGO_GRAVITY_HINT_STRONG);
267 layout=pango_layout_new(context);
268 option=GetImageOption(image_info,"pango:auto-dir");
269 if (option != (const char *) NULL)
270 pango_layout_set_auto_dir(layout,1);
271 option=GetImageOption(image_info,"pango:ellipsize");
272 if (option != (const char *) NULL)
274 if (LocaleCompare(option,"end") == 0)
275 pango_layout_set_ellipsize(layout,PANGO_ELLIPSIZE_END);
276 if (LocaleCompare(option,"middle") == 0)
277 pango_layout_set_ellipsize(layout,PANGO_ELLIPSIZE_MIDDLE);
278 if (LocaleCompare(option,"none") == 0)
279 pango_layout_set_ellipsize(layout,PANGO_ELLIPSIZE_NONE);
280 if (LocaleCompare(option,"start") == 0)
281 pango_layout_set_ellipsize(layout,PANGO_ELLIPSIZE_START);
283 option=GetImageOption(image_info,"pango:justify");
284 if (IfMagickTrue(IsStringTrue(option)))
285 pango_layout_set_justify(layout,1);
286 option=GetImageOption(image_info,"pango:single-paragraph");
287 if (IfMagickTrue(IsStringTrue(option)))
288 pango_layout_set_single_paragraph_mode(layout,1);
289 option=GetImageOption(image_info,"pango:wrap");
290 if (option != (const char *) NULL)
292 if (LocaleCompare(option,"char") == 0)
293 pango_layout_set_wrap(layout,PANGO_WRAP_CHAR);
294 if (LocaleCompare(option,"word") == 0)
295 pango_layout_set_wrap(layout,PANGO_WRAP_WORD);
296 if (LocaleCompare(option,"word-char") == 0)
297 pango_layout_set_wrap(layout,PANGO_WRAP_WORD_CHAR);
299 option=GetImageOption(image_info,"pango:indent");
300 if (option != (const char *) NULL)
301 pango_layout_set_indent(layout,(int) ((StringToLong(option)*
302 (image->resolution.x == 0.0 ? 90.0 : image->resolution.x)*PANGO_SCALE+36)/
304 switch (draw_info->align)
306 case CenterAlign: align=PANGO_ALIGN_CENTER; break;
307 case RightAlign: align=PANGO_ALIGN_RIGHT; break;
308 case LeftAlign: align=PANGO_ALIGN_LEFT; break;
311 if (draw_info->gravity == CenterGravity)
313 align=PANGO_ALIGN_CENTER;
316 align=PANGO_ALIGN_LEFT;
320 if ((align != PANGO_ALIGN_CENTER) &&
321 (draw_info->direction == RightToLeftDirection))
322 align=(PangoAlignment) (PANGO_ALIGN_LEFT+PANGO_ALIGN_RIGHT-align);
323 pango_layout_set_alignment(layout,align);
324 if (draw_info->font != (char *) NULL)
332 description=pango_font_description_from_string(draw_info->font);
333 pango_font_description_set_size(description,(int) (PANGO_SCALE*
334 draw_info->pointsize+0.5));
335 pango_layout_set_font_description(layout,description);
336 pango_font_description_free(description);
338 option=GetImageOption(image_info,"pango:markup");
339 if ((option != (const char *) NULL) && (IsStringTrue(option) == MagickFalse))
340 pango_layout_set_text(layout,caption,-1);
346 error=(GError *) NULL;
347 if (pango_parse_markup(caption,-1,0,NULL,NULL,NULL,&error) == 0)
348 (void) ThrowMagickException(exception,GetMagickModule(),CoderError,
349 error->message,"`%s'",image_info->filename);
350 pango_layout_set_markup(layout,caption,-1);
352 pango_layout_context_changed(layout);
355 if (image_info->page != (char *) NULL)
356 (void) ParseAbsoluteGeometry(image_info->page,&page);
357 if (image->columns == 0)
359 pango_layout_get_extents(layout,NULL,&extent);
360 image->columns=(extent.x+extent.width+PANGO_SCALE/2)/PANGO_SCALE+2*page.x;
364 image->columns-=2*page.x;
365 pango_layout_set_width(layout,(int) ((PANGO_SCALE*image->columns*
366 (image->resolution.x == 0.0 ? 90.0 : image->resolution.x)+45.0)/90.0+
369 if (image->rows == 0)
371 pango_layout_get_extents(layout,NULL,&extent);
372 image->rows=(extent.y+extent.height+PANGO_SCALE/2)/PANGO_SCALE+2*page.y;
376 image->rows-=2*page.y;
377 pango_layout_set_height(layout,(int) ((PANGO_SCALE*image->rows*
378 (image->resolution.y == 0.0 ? 90.0 : image->resolution.y)+45.0)/90.0+
381 status=SetImageExtent(image,image->columns,image->rows,exception);
382 if (status == MagickFalse)
383 return(DestroyImageList(image));
387 stride=(size_t) cairo_format_stride_for_width(CAIRO_FORMAT_ARGB32,
388 (int) image->columns);
389 pixel_info=AcquireVirtualMemory(image->rows,stride*sizeof(*pixels));
390 if (pixel_info == (MemoryInfo *) NULL)
392 draw_info=DestroyDrawInfo(draw_info);
393 caption=DestroyString(caption);
394 ThrowReaderException(ResourceLimitError,"MemoryAllocationFailed");
396 pixels=(unsigned char *) GetVirtualMemoryBlob(pixel_info);
397 surface=cairo_image_surface_create_for_data(pixels,CAIRO_FORMAT_ARGB32,
398 (int) image->columns,(int) image->rows,(int) stride);
399 cairo_image=cairo_create(surface);
400 cairo_set_operator(cairo_image,CAIRO_OPERATOR_CLEAR);
401 cairo_paint(cairo_image);
402 cairo_set_operator(cairo_image,CAIRO_OPERATOR_OVER);
403 cairo_translate(cairo_image,page.x,page.y);
404 pango_cairo_show_layout(cairo_image,layout);
405 cairo_destroy(cairo_image);
406 cairo_surface_destroy(surface);
407 g_object_unref(layout);
408 g_object_unref(fontmap);
410 Convert surface to image.
412 (void) SetImageBackgroundColor(image,exception);
414 GetPixelInfo(image,&fill_color);
415 for (y=0; y < (ssize_t) image->rows; y++)
423 q=GetAuthenticPixels(image,0,y,image->columns,1,exception);
424 if (q == (Quantum *) NULL)
426 for (x=0; x < (ssize_t) image->columns; x++)
431 fill_color.blue=(double) ScaleCharToQuantum(*p++);
432 fill_color.green=(double) ScaleCharToQuantum(*p++);
433 fill_color.red=(double) ScaleCharToQuantum(*p++);
434 fill_color.alpha=(double) ScaleCharToQuantum(*p++);
438 gamma=1.0-QuantumScale*fill_color.alpha;
439 gamma=PerceptibleReciprocal(gamma);
440 fill_color.blue*=gamma;
441 fill_color.green*=gamma;
442 fill_color.red*=gamma;
443 CompositePixelOver(image,&fill_color,fill_color.alpha,q,(double)
444 GetPixelAlpha(image,q),q);
445 q+=GetPixelChannels(image);
447 if (SyncAuthenticPixels(image,exception) == MagickFalse)
449 if (image->previous == (Image *) NULL)
451 status=SetImageProgress(image,LoadImageTag,(MagickOffsetType) y,
453 if (status == MagickFalse)
458 Relinquish resources.
460 pixel_info=RelinquishVirtualMemory(pixel_info);
461 draw_info=DestroyDrawInfo(draw_info);
462 caption=DestroyString(caption);
463 return(GetFirstImageInList(image));
468 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
472 % R e g i s t e r P A N G O I m a g e %
476 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
478 % RegisterPANGOImage() adds attributes for the Pango Markup Language format to
479 % the list of supported formats. The attributes include the image format
480 % tag, a method to read and/or write the format, whether the format
481 % supports the saving of more than one frame to the same file or blob,
482 % whether the format supports native in-memory I/O, and a brief
483 % description of the format.
485 % The format of the RegisterPANGOImage method is:
487 % size_t RegisterPANGOImage(void)
490 ModuleExport size_t RegisterPANGOImage(void)
493 version[MaxTextExtent];
499 #if defined(PANGO_VERSION_STRING)
500 (void) FormatLocaleString(version,MaxTextExtent,"Pangocairo %s",
501 PANGO_VERSION_STRING);
503 entry=SetMagickInfo("PANGO");
504 #if defined(MAGICKCORE_PANGOCAIRO_DELEGATE)
505 entry->decoder=(DecodeImageHandler *) ReadPANGOImage;
507 entry->description=ConstantString("Pango Markup Language");
508 if (*version != '\0')
509 entry->version=ConstantString(version);
510 entry->flags^=Adjoin;
511 entry->module=ConstantString("PANGO");
512 (void) RegisterMagickInfo(entry);
513 return(MagickImageCoderSignature);
517 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
521 % U n r e g i s t e r P A N G O I m a g e %
525 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
527 % UnregisterPANGOImage() removes format registrations made by the Pango module
528 % from the list of supported formats.
530 % The format of the UnregisterPANGOImage method is:
532 % UnregisterPANGOImage(void)
535 ModuleExport void UnregisterPANGOImage(void)
537 (void) UnregisterMagickInfo("PANGO");