| /* |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % % |
| % % |
| % % |
| % CCCC AAA PPPP TTTTT IIIII OOO N N % |
| % C A A P P T I O O NN N % |
| % C AAAAA PPPP T I O O N N N % |
| % C A A P T I O O N NN % |
| % CCCC A A P T IIIII OOO N N % |
| % % |
| % % |
| % Read Text Caption. % |
| % % |
| % Software Design % |
| % Cristy % |
| % February 2002 % |
| % % |
| % % |
| % Copyright 1999-2015 ImageMagick Studio LLC, a non-profit organization % |
| % dedicated to making software imaging solutions freely available. % |
| % % |
| % You may not use this file except in compliance with the License. You may % |
| % obtain a copy of the License at % |
| % % |
| % http://www.imagemagick.org/script/license.php % |
| % % |
| % Unless required by applicable law or agreed to in writing, software % |
| % distributed under the License is distributed on an "AS IS" BASIS, % |
| % WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. % |
| % See the License for the specific language governing permissions and % |
| % limitations under the License. % |
| % % |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % |
| % |
| */ |
| |
| /* |
| Include declarations. |
| */ |
| #include "MagickCore/studio.h" |
| #include "MagickCore/annotate.h" |
| #include "MagickCore/artifact.h" |
| #include "MagickCore/blob.h" |
| #include "MagickCore/blob-private.h" |
| #include "MagickCore/composite-private.h" |
| #include "MagickCore/draw.h" |
| #include "MagickCore/draw-private.h" |
| #include "MagickCore/exception.h" |
| #include "MagickCore/exception-private.h" |
| #include "MagickCore/image.h" |
| #include "MagickCore/image-private.h" |
| #include "MagickCore/list.h" |
| #include "MagickCore/magick.h" |
| #include "MagickCore/memory_.h" |
| #include "MagickCore/module.h" |
| #include "MagickCore/option.h" |
| #include "MagickCore/property.h" |
| #include "MagickCore/quantum-private.h" |
| #include "MagickCore/static.h" |
| #include "MagickCore/string_.h" |
| #include "MagickCore/string-private.h" |
| #include "MagickCore/utility.h" |
| |
| /* |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % % |
| % % |
| % % |
| % R e a d C A P T I O N I m a g e % |
| % % |
| % % |
| % % |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % |
| % ReadCAPTIONImage() reads a CAPTION image file and returns it. It |
| % allocates the memory necessary for the new Image structure and returns a |
| % pointer to the new image. |
| % |
| % The format of the ReadCAPTIONImage method is: |
| % |
| % Image *ReadCAPTIONImage(const ImageInfo *image_info, |
| % ExceptionInfo *exception) |
| % |
| % A description of each parameter follows: |
| % |
| % o image_info: the image info. |
| % |
| % o exception: return any errors or warnings in this structure. |
| % |
| */ |
| static Image *ReadCAPTIONImage(const ImageInfo *image_info, |
| ExceptionInfo *exception) |
| { |
| char |
| *caption, |
| geometry[MaxTextExtent], |
| *property, |
| *text; |
| |
| const char |
| *gravity, |
| *option; |
| |
| DrawInfo |
| *draw_info; |
| |
| Image |
| *image; |
| |
| MagickBooleanType |
| split, |
| status; |
| |
| register ssize_t |
| i; |
| |
| size_t |
| height, |
| width; |
| |
| TypeMetric |
| metrics; |
| |
| /* |
| Initialize Image structure. |
| */ |
| assert(image_info != (const ImageInfo *) NULL); |
| assert(image_info->signature == MagickSignature); |
| if (image_info->debug != MagickFalse) |
| (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s", |
| image_info->filename); |
| assert(exception != (ExceptionInfo *) NULL); |
| assert(exception->signature == MagickSignature); |
| image=AcquireImage(image_info,exception); |
| (void) ResetImagePage(image,"0x0+0+0"); |
| /* |
| Format caption. |
| */ |
| option=GetImageOption(image_info,"filename"); |
| if (option == (const char *) NULL) |
| property=InterpretImageProperties((ImageInfo *) image_info,image, |
| image_info->filename,exception); |
| else |
| if (LocaleNCompare(option,"caption:",8) == 0) |
| property=InterpretImageProperties((ImageInfo *) image_info,image,option+8, |
| exception); |
| else |
| property=InterpretImageProperties((ImageInfo *) image_info,image,option, |
| exception); |
| (void) SetImageProperty(image,"caption",property,exception); |
| property=DestroyString(property); |
| caption=ConstantString(GetImageProperty(image,"caption",exception)); |
| draw_info=CloneDrawInfo(image_info,(DrawInfo *) NULL); |
| (void) CloneString(&draw_info->text,caption); |
| gravity=GetImageOption(image_info,"gravity"); |
| if (gravity != (char *) NULL) |
| draw_info->gravity=(GravityType) ParseCommandOption(MagickGravityOptions, |
| MagickFalse,gravity); |
| split=MagickFalse; |
| if (image->columns == 0) |
| { |
| text=AcquireString(caption); |
| i=FormatMagickCaption(image,draw_info,split,&metrics,&text, |
| exception); |
| (void) CloneString(&draw_info->text,text); |
| text=DestroyString(text); |
| (void) FormatLocaleString(geometry,MaxTextExtent,"%+g%+g", |
| -metrics.bounds.x1,metrics.ascent); |
| if (draw_info->gravity == UndefinedGravity) |
| (void) CloneString(&draw_info->geometry,geometry); |
| status=GetMultilineTypeMetrics(image,draw_info,&metrics,exception); |
| width=(size_t) floor(metrics.width+draw_info->stroke_width+0.5); |
| image->columns=width; |
| } |
| if (image->rows == 0) |
| { |
| split=MagickTrue; |
| text=AcquireString(caption); |
| i=FormatMagickCaption(image,draw_info,split,&metrics,&text, |
| exception); |
| (void) CloneString(&draw_info->text,text); |
| text=DestroyString(text); |
| (void) FormatLocaleString(geometry,MaxTextExtent,"%+g%+g", |
| -metrics.bounds.x1,metrics.ascent); |
| if (draw_info->gravity == UndefinedGravity) |
| (void) CloneString(&draw_info->geometry,geometry); |
| status=GetMultilineTypeMetrics(image,draw_info,&metrics,exception); |
| image->rows=(size_t) ((i+1)*(metrics.ascent-metrics.descent+ |
| draw_info->interline_spacing+draw_info->stroke_width)+0.5); |
| } |
| if (fabs(image_info->pointsize) < MagickEpsilon) |
| { |
| double |
| high, |
| low; |
| |
| /* |
| Auto fit text into bounding box. |
| */ |
| for ( ; ; draw_info->pointsize*=2.0) |
| { |
| text=AcquireString(caption); |
| i=FormatMagickCaption(image,draw_info,split,&metrics,&text, |
| exception); |
| (void) CloneString(&draw_info->text,text); |
| text=DestroyString(text); |
| (void) FormatLocaleString(geometry,MaxTextExtent,"%+g%+g", |
| -metrics.bounds.x1,metrics.ascent); |
| if (draw_info->gravity == UndefinedGravity) |
| (void) CloneString(&draw_info->geometry,geometry); |
| status=GetMultilineTypeMetrics(image,draw_info,&metrics,exception); |
| width=(size_t) floor(metrics.width+draw_info->stroke_width+0.5); |
| height=(size_t) floor(metrics.height+draw_info->stroke_width+0.5); |
| if ((image->columns != 0) && (image->rows != 0)) |
| { |
| if ((width >= image->columns) && (height >= image->rows)) |
| break; |
| } |
| else |
| if (((image->columns != 0) && (width >= image->columns)) || |
| ((image->rows != 0) && (height >= image->rows))) |
| break; |
| } |
| high=draw_info->pointsize; |
| for (low=1.0; (high-low) > 0.5; ) |
| { |
| draw_info->pointsize=(low+high)/2.0; |
| text=AcquireString(caption); |
| i=FormatMagickCaption(image,draw_info,split,&metrics,&text, |
| exception); |
| (void) CloneString(&draw_info->text,text); |
| text=DestroyString(text); |
| (void) FormatLocaleString(geometry,MaxTextExtent,"%+g%+g", |
| -metrics.bounds.x1,metrics.ascent); |
| if (draw_info->gravity == UndefinedGravity) |
| (void) CloneString(&draw_info->geometry,geometry); |
| status=GetMultilineTypeMetrics(image,draw_info,&metrics,exception); |
| width=(size_t) floor(metrics.width+draw_info->stroke_width+0.5); |
| height=(size_t) floor(metrics.height+draw_info->stroke_width+0.5); |
| if ((image->columns != 0) && (image->rows != 0)) |
| { |
| if ((width < image->columns) && (height < image->rows)) |
| low=draw_info->pointsize+0.5; |
| else |
| high=draw_info->pointsize-0.5; |
| } |
| else |
| if (((image->columns != 0) && (width < image->columns)) || |
| ((image->rows != 0) && (height < image->rows))) |
| low=draw_info->pointsize+0.5; |
| else |
| high=draw_info->pointsize-0.5; |
| } |
| draw_info->pointsize=(low+high)/2.0-0.5; |
| } |
| (void) CloneString(&draw_info->text,caption); |
| i=FormatMagickCaption(image,draw_info,split,&metrics,&caption,exception); |
| if (SetImageBackgroundColor(image,exception) == MagickFalse) |
| { |
| image=DestroyImageList(image); |
| return((Image *) NULL); |
| } |
| /* |
| Draw caption. |
| */ |
| (void) CloneString(&draw_info->text,caption); |
| status=GetMultilineTypeMetrics(image,draw_info,&metrics,exception); |
| if ((draw_info->gravity != UndefinedGravity) && |
| (draw_info->direction != RightToLeftDirection)) |
| image->page.x=(ssize_t) (metrics.bounds.x1-draw_info->stroke_width/2.0); |
| else |
| { |
| (void) FormatLocaleString(geometry,MaxTextExtent,"%+g%+g", |
| -metrics.bounds.x1+draw_info->stroke_width/2.0,metrics.ascent+ |
| draw_info->stroke_width/2.0); |
| if (draw_info->direction == RightToLeftDirection) |
| (void) FormatLocaleString(geometry,MaxTextExtent,"%+g%+g", |
| image->columns-(metrics.bounds.x2+draw_info->stroke_width/2.0), |
| metrics.ascent+draw_info->stroke_width/2.0); |
| draw_info->geometry=AcquireString(geometry); |
| } |
| status=AnnotateImage(image,draw_info,exception); |
| draw_info=DestroyDrawInfo(draw_info); |
| caption=DestroyString(caption); |
| if (status == MagickFalse) |
| { |
| image=DestroyImageList(image); |
| return((Image *) NULL); |
| } |
| return(GetFirstImageInList(image)); |
| } |
| |
| /* |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % % |
| % % |
| % % |
| % R e g i s t e r C A P T I O N I m a g e % |
| % % |
| % % |
| % % |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % |
| % RegisterCAPTIONImage() adds attributes for the CAPTION image format to |
| % the list of supported formats. The attributes include the image format |
| % tag, a method to read and/or write the format, whether the format |
| % supports the saving of more than one frame to the same file or blob, |
| % whether the format supports native in-memory I/O, and a brief |
| % description of the format. |
| % |
| % The format of the RegisterCAPTIONImage method is: |
| % |
| % size_t RegisterCAPTIONImage(void) |
| % |
| */ |
| ModuleExport size_t RegisterCAPTIONImage(void) |
| { |
| MagickInfo |
| *entry; |
| |
| entry=SetMagickInfo("CAPTION"); |
| entry->decoder=(DecodeImageHandler *) ReadCAPTIONImage; |
| entry->description=ConstantString("Caption"); |
| entry->adjoin=MagickFalse; |
| entry->module=ConstantString("CAPTION"); |
| (void) RegisterMagickInfo(entry); |
| return(MagickImageCoderSignature); |
| } |
| |
| /* |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % % |
| % % |
| % % |
| % U n r e g i s t e r C A P T I O N I m a g e % |
| % % |
| % % |
| % % |
| %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| % |
| % UnregisterCAPTIONImage() removes format registrations made by the |
| % CAPTION module from the list of supported formats. |
| % |
| % The format of the UnregisterCAPTIONImage method is: |
| % |
| % UnregisterCAPTIONImage(void) |
| % |
| */ |
| ModuleExport void UnregisterCAPTIONImage(void) |
| { |
| (void) UnregisterMagickInfo("CAPTION"); |
| } |