cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 1 | /* |
| 2 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 3 | % % |
| 4 | % % |
| 5 | % % |
| 6 | % CCCC AAA PPPP TTTTT IIIII OOO N N % |
| 7 | % C A A P P T I O O NN N % |
| 8 | % C AAAAA PPPP T I O O N N N % |
| 9 | % C A A P T I O O N NN % |
| 10 | % CCCC A A P T IIIII OOO N N % |
| 11 | % % |
| 12 | % % |
| 13 | % Read Text Caption. % |
| 14 | % % |
| 15 | % Software Design % |
| 16 | % John Cristy % |
| 17 | % February 2002 % |
| 18 | % % |
| 19 | % % |
cristy | 45ef08f | 2012-12-07 13:13:34 +0000 | [diff] [blame] | 20 | % Copyright 1999-2013 ImageMagick Studio LLC, a non-profit organization % |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 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 | % |
| 37 | */ |
| 38 | |
| 39 | /* |
| 40 | Include declarations. |
| 41 | */ |
cristy | 4c08aed | 2011-07-01 19:47:50 +0000 | [diff] [blame] | 42 | #include "MagickCore/studio.h" |
| 43 | #include "MagickCore/annotate.h" |
cristy | 76ce6e1 | 2013-04-05 14:33:38 +0000 | [diff] [blame] | 44 | #include "MagickCore/artifact.h" |
cristy | 4c08aed | 2011-07-01 19:47:50 +0000 | [diff] [blame] | 45 | #include "MagickCore/blob.h" |
| 46 | #include "MagickCore/blob-private.h" |
cristy | 8a3ce7f | 2011-10-30 02:28:03 +0000 | [diff] [blame] | 47 | #include "MagickCore/composite-private.h" |
cristy | 4c08aed | 2011-07-01 19:47:50 +0000 | [diff] [blame] | 48 | #include "MagickCore/draw.h" |
cristy | 8a3ce7f | 2011-10-30 02:28:03 +0000 | [diff] [blame] | 49 | #include "MagickCore/draw-private.h" |
cristy | 4c08aed | 2011-07-01 19:47:50 +0000 | [diff] [blame] | 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" |
cristy | 8a3ce7f | 2011-10-30 02:28:03 +0000 | [diff] [blame] | 57 | #include "MagickCore/module.h" |
cristy | 4c08aed | 2011-07-01 19:47:50 +0000 | [diff] [blame] | 58 | #include "MagickCore/option.h" |
| 59 | #include "MagickCore/property.h" |
| 60 | #include "MagickCore/quantum-private.h" |
| 61 | #include "MagickCore/static.h" |
| 62 | #include "MagickCore/string_.h" |
cristy | 8a3ce7f | 2011-10-30 02:28:03 +0000 | [diff] [blame] | 63 | #include "MagickCore/string-private.h" |
| 64 | #include "MagickCore/utility.h" |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 65 | |
| 66 | /* |
| 67 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 68 | % % |
| 69 | % % |
| 70 | % % |
| 71 | % R e a d C A P T I O N I m a g e % |
| 72 | % % |
| 73 | % % |
| 74 | % % |
| 75 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 76 | % |
| 77 | % ReadCAPTIONImage() reads a CAPTION image file and returns it. It |
| 78 | % allocates the memory necessary for the new Image structure and returns a |
| 79 | % pointer to the new image. |
| 80 | % |
| 81 | % The format of the ReadCAPTIONImage method is: |
| 82 | % |
| 83 | % Image *ReadCAPTIONImage(const ImageInfo *image_info, |
| 84 | % ExceptionInfo *exception) |
| 85 | % |
| 86 | % A description of each parameter follows: |
| 87 | % |
| 88 | % o image_info: the image info. |
| 89 | % |
| 90 | % o exception: return any errors or warnings in this structure. |
| 91 | % |
| 92 | */ |
| 93 | static Image *ReadCAPTIONImage(const ImageInfo *image_info, |
| 94 | ExceptionInfo *exception) |
| 95 | { |
| 96 | char |
| 97 | *caption, |
| 98 | geometry[MaxTextExtent], |
cristy | 54ec427 | 2013-03-14 14:24:14 +0000 | [diff] [blame] | 99 | *property, |
| 100 | *text; |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 101 | |
| 102 | const char |
cristy | ab272ac | 2012-03-04 22:08:07 +0000 | [diff] [blame] | 103 | *gravity, |
| 104 | *option; |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 105 | |
| 106 | DrawInfo |
| 107 | *draw_info; |
| 108 | |
| 109 | Image |
| 110 | *image; |
| 111 | |
| 112 | MagickBooleanType |
cristy | a530273 | 2013-05-30 22:26:58 +0000 | [diff] [blame^] | 113 | split, |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 114 | status; |
| 115 | |
cristy | bb50337 | 2010-05-27 20:51:26 +0000 | [diff] [blame] | 116 | register ssize_t |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 117 | i; |
| 118 | |
cristy | bb50337 | 2010-05-27 20:51:26 +0000 | [diff] [blame] | 119 | size_t |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 120 | height, |
| 121 | width; |
| 122 | |
cristy | 4e82e51 | 2011-04-24 01:33:42 +0000 | [diff] [blame] | 123 | TypeMetric |
| 124 | metrics; |
| 125 | |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 126 | /* |
| 127 | Initialize Image structure. |
| 128 | */ |
| 129 | assert(image_info != (const ImageInfo *) NULL); |
| 130 | assert(image_info->signature == MagickSignature); |
| 131 | if (image_info->debug != MagickFalse) |
| 132 | (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s", |
| 133 | image_info->filename); |
| 134 | assert(exception != (ExceptionInfo *) NULL); |
| 135 | assert(exception->signature == MagickSignature); |
cristy | 9950d57 | 2011-10-01 18:22:35 +0000 | [diff] [blame] | 136 | image=AcquireImage(image_info,exception); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 137 | (void) ResetImagePage(image,"0x0+0+0"); |
| 138 | /* |
| 139 | Format caption. |
| 140 | */ |
cristy | 092ec8d | 2013-04-26 13:46:22 +0000 | [diff] [blame] | 141 | option=GetImageOption(image_info,"filename"); |
cristy | ab272ac | 2012-03-04 22:08:07 +0000 | [diff] [blame] | 142 | if (option == (const char *) NULL) |
cristy | e67f43f | 2013-04-29 10:27:50 +0000 | [diff] [blame] | 143 | property=InterpretImageProperties((ImageInfo *) image_info,image, |
| 144 | image_info->filename,exception); |
cristy | ab272ac | 2012-03-04 22:08:07 +0000 | [diff] [blame] | 145 | else |
| 146 | if (LocaleNCompare(option,"caption:",8) == 0) |
cristy | e67f43f | 2013-04-29 10:27:50 +0000 | [diff] [blame] | 147 | property=InterpretImageProperties((ImageInfo *) image_info,image,option+8, |
| 148 | exception); |
cristy | ab272ac | 2012-03-04 22:08:07 +0000 | [diff] [blame] | 149 | else |
cristy | e67f43f | 2013-04-29 10:27:50 +0000 | [diff] [blame] | 150 | property=InterpretImageProperties((ImageInfo *) image_info,image,option, |
| 151 | exception); |
cristy | d15e659 | 2011-10-15 00:13:06 +0000 | [diff] [blame] | 152 | (void) SetImageProperty(image,"caption",property,exception); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 153 | property=DestroyString(property); |
cristy | d15e659 | 2011-10-15 00:13:06 +0000 | [diff] [blame] | 154 | caption=ConstantString(GetImageProperty(image,"caption",exception)); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 155 | draw_info=CloneDrawInfo(image_info,(DrawInfo *) NULL); |
cristy | 6fc3929 | 2011-10-23 14:26:30 +0000 | [diff] [blame] | 156 | (void) CloneString(&draw_info->text,caption); |
cristy | 092ec8d | 2013-04-26 13:46:22 +0000 | [diff] [blame] | 157 | gravity=GetImageOption(image_info,"gravity"); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 158 | if (gravity != (char *) NULL) |
cristy | 042ee78 | 2011-04-22 18:48:30 +0000 | [diff] [blame] | 159 | draw_info->gravity=(GravityType) ParseCommandOption(MagickGravityOptions, |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 160 | MagickFalse,gravity); |
cristy | a530273 | 2013-05-30 22:26:58 +0000 | [diff] [blame^] | 161 | split=MagickFalse; |
cristy | 8db9ca4 | 2013-03-14 13:35:37 +0000 | [diff] [blame] | 162 | if (image->columns == 0) |
| 163 | { |
cristy | e275ada | 2013-04-14 22:29:40 +0000 | [diff] [blame] | 164 | text=AcquireString(caption); |
cristy | a530273 | 2013-05-30 22:26:58 +0000 | [diff] [blame^] | 165 | i=FormatMagickCaption(image,draw_info,split,&metrics,&text, |
cristy | e275ada | 2013-04-14 22:29:40 +0000 | [diff] [blame] | 166 | exception); |
| 167 | (void) CloneString(&draw_info->text,text); |
| 168 | text=DestroyString(text); |
| 169 | (void) FormatLocaleString(geometry,MaxTextExtent,"%+g%+g", |
| 170 | -metrics.bounds.x1,metrics.ascent); |
| 171 | if (draw_info->gravity == UndefinedGravity) |
| 172 | (void) CloneString(&draw_info->geometry,geometry); |
cristy | b712c6e | 2013-04-14 21:43:41 +0000 | [diff] [blame] | 173 | status=GetMultilineTypeMetrics(image,draw_info,&metrics,exception); |
cristy | a492593 | 2013-04-14 21:14:20 +0000 | [diff] [blame] | 174 | width=(size_t) floor(metrics.width+draw_info->stroke_width+0.5); |
cristy | 8db9ca4 | 2013-03-14 13:35:37 +0000 | [diff] [blame] | 175 | image->columns=width; |
| 176 | } |
| 177 | if (image->rows == 0) |
| 178 | { |
cristy | a530273 | 2013-05-30 22:26:58 +0000 | [diff] [blame^] | 179 | split=MagickTrue; |
cristy | e275ada | 2013-04-14 22:29:40 +0000 | [diff] [blame] | 180 | text=AcquireString(caption); |
cristy | a530273 | 2013-05-30 22:26:58 +0000 | [diff] [blame^] | 181 | i=FormatMagickCaption(image,draw_info,split,&metrics,&text, |
cristy | e275ada | 2013-04-14 22:29:40 +0000 | [diff] [blame] | 182 | exception); |
| 183 | (void) CloneString(&draw_info->text,text); |
| 184 | text=DestroyString(text); |
| 185 | (void) FormatLocaleString(geometry,MaxTextExtent,"%+g%+g", |
| 186 | -metrics.bounds.x1,metrics.ascent); |
| 187 | if (draw_info->gravity == UndefinedGravity) |
| 188 | (void) CloneString(&draw_info->geometry,geometry); |
cristy | a492593 | 2013-04-14 21:14:20 +0000 | [diff] [blame] | 189 | status=GetMultilineTypeMetrics(image,draw_info,&metrics,exception); |
cristy | 54ec427 | 2013-03-14 14:24:14 +0000 | [diff] [blame] | 190 | image->rows=(size_t) ((i+1)*(metrics.ascent-metrics.descent+ |
| 191 | draw_info->interline_spacing+draw_info->stroke_width)+0.5); |
cristy | 8db9ca4 | 2013-03-14 13:35:37 +0000 | [diff] [blame] | 192 | } |
cristy | a492593 | 2013-04-14 21:14:20 +0000 | [diff] [blame] | 193 | if (fabs(image_info->pointsize) < MagickEpsilon) |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 194 | { |
cristy | bdf24b2 | 2012-05-24 12:20:45 +0000 | [diff] [blame] | 195 | double |
| 196 | high, |
| 197 | low; |
| 198 | |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 199 | /* |
cristy | bdf24b2 | 2012-05-24 12:20:45 +0000 | [diff] [blame] | 200 | Auto fit text into bounding box. |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 201 | */ |
cristy | 8592b05 | 2013-02-07 01:24:54 +0000 | [diff] [blame] | 202 | for ( ; ; draw_info->pointsize*=2.0) |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 203 | { |
| 204 | text=AcquireString(caption); |
cristy | a530273 | 2013-05-30 22:26:58 +0000 | [diff] [blame^] | 205 | i=FormatMagickCaption(image,draw_info,split,&metrics,&text, |
cristy | 5cbc016 | 2011-08-29 00:36:28 +0000 | [diff] [blame] | 206 | exception); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 207 | (void) CloneString(&draw_info->text,text); |
| 208 | text=DestroyString(text); |
cristy | b51dff5 | 2011-05-19 16:55:47 +0000 | [diff] [blame] | 209 | (void) FormatLocaleString(geometry,MaxTextExtent,"%+g%+g", |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 210 | -metrics.bounds.x1,metrics.ascent); |
| 211 | if (draw_info->gravity == UndefinedGravity) |
| 212 | (void) CloneString(&draw_info->geometry,geometry); |
cristy | 5cbc016 | 2011-08-29 00:36:28 +0000 | [diff] [blame] | 213 | status=GetMultilineTypeMetrics(image,draw_info,&metrics,exception); |
cristy | bb50337 | 2010-05-27 20:51:26 +0000 | [diff] [blame] | 214 | width=(size_t) floor(metrics.width+draw_info->stroke_width+0.5); |
cristy | 4e82e51 | 2011-04-24 01:33:42 +0000 | [diff] [blame] | 215 | height=(size_t) floor(metrics.height+draw_info->stroke_width+0.5); |
cristy | 071c2e2 | 2013-05-11 01:05:45 +0000 | [diff] [blame] | 216 | if ((image->columns != 0) && (image->rows != 0)) |
| 217 | { |
cristy | cae9c06 | 2013-05-13 11:46:22 +0000 | [diff] [blame] | 218 | if ((width >= image->columns) && (height >= image->rows)) |
cristy | 071c2e2 | 2013-05-11 01:05:45 +0000 | [diff] [blame] | 219 | break; |
| 220 | } |
| 221 | else |
cristy | cae9c06 | 2013-05-13 11:46:22 +0000 | [diff] [blame] | 222 | if (((image->columns != 0) && (width >= image->columns)) || |
| 223 | ((image->rows != 0) && (height >= image->rows))) |
cristy | 071c2e2 | 2013-05-11 01:05:45 +0000 | [diff] [blame] | 224 | break; |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 225 | } |
cristy | 0839c55 | 2013-04-14 21:45:02 +0000 | [diff] [blame] | 226 | high=draw_info->pointsize; |
cristy | e275ada | 2013-04-14 22:29:40 +0000 | [diff] [blame] | 227 | for (low=1.0; (high-low) > 1.0; ) |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 228 | { |
cristy | bdf24b2 | 2012-05-24 12:20:45 +0000 | [diff] [blame] | 229 | draw_info->pointsize=(low+high)/2.0; |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 230 | text=AcquireString(caption); |
cristy | a530273 | 2013-05-30 22:26:58 +0000 | [diff] [blame^] | 231 | i=FormatMagickCaption(image,draw_info,split,&metrics,&text, |
cristy | 5cbc016 | 2011-08-29 00:36:28 +0000 | [diff] [blame] | 232 | exception); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 233 | (void) CloneString(&draw_info->text,text); |
| 234 | text=DestroyString(text); |
cristy | b51dff5 | 2011-05-19 16:55:47 +0000 | [diff] [blame] | 235 | (void) FormatLocaleString(geometry,MaxTextExtent,"%+g%+g", |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 236 | -metrics.bounds.x1,metrics.ascent); |
| 237 | if (draw_info->gravity == UndefinedGravity) |
| 238 | (void) CloneString(&draw_info->geometry,geometry); |
cristy | 5cbc016 | 2011-08-29 00:36:28 +0000 | [diff] [blame] | 239 | status=GetMultilineTypeMetrics(image,draw_info,&metrics,exception); |
cristy | bb50337 | 2010-05-27 20:51:26 +0000 | [diff] [blame] | 240 | width=(size_t) floor(metrics.width+draw_info->stroke_width+0.5); |
cristy | 4e82e51 | 2011-04-24 01:33:42 +0000 | [diff] [blame] | 241 | height=(size_t) floor(metrics.height+draw_info->stroke_width+0.5); |
cristy | 071c2e2 | 2013-05-11 01:05:45 +0000 | [diff] [blame] | 242 | if ((image->columns != 0) && (image->rows != 0)) |
| 243 | { |
cristy | cae9c06 | 2013-05-13 11:46:22 +0000 | [diff] [blame] | 244 | if ((width < image->columns) && (height < image->rows)) |
cristy | 071c2e2 | 2013-05-11 01:05:45 +0000 | [diff] [blame] | 245 | low=draw_info->pointsize+1.0; |
| 246 | else |
| 247 | high=draw_info->pointsize-1.0; |
| 248 | } |
cristy | bdf24b2 | 2012-05-24 12:20:45 +0000 | [diff] [blame] | 249 | else |
cristy | 071c2e2 | 2013-05-11 01:05:45 +0000 | [diff] [blame] | 250 | if (((image->columns != 0) && (width < image->columns)) || |
| 251 | ((image->rows != 0) && (height < image->rows))) |
| 252 | low=draw_info->pointsize+1.0; |
| 253 | else |
| 254 | high=draw_info->pointsize-1.0; |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 255 | } |
cristy | 53f220f | 2013-05-11 19:13:01 +0000 | [diff] [blame] | 256 | draw_info->pointsize=(low+high)/2.0-1.0; |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 257 | } |
cristy | a492593 | 2013-04-14 21:14:20 +0000 | [diff] [blame] | 258 | (void) CloneString(&draw_info->text,caption); |
cristy | a530273 | 2013-05-30 22:26:58 +0000 | [diff] [blame^] | 259 | i=FormatMagickCaption(image,draw_info,split,&metrics,&caption, |
cristy | a492593 | 2013-04-14 21:14:20 +0000 | [diff] [blame] | 260 | exception); |
cristy | ea1a8aa | 2011-10-20 13:24:06 +0000 | [diff] [blame] | 261 | if (SetImageBackgroundColor(image,exception) == MagickFalse) |
cristy | 95524f9 | 2010-02-16 18:44:34 +0000 | [diff] [blame] | 262 | { |
cristy | 95524f9 | 2010-02-16 18:44:34 +0000 | [diff] [blame] | 263 | image=DestroyImageList(image); |
| 264 | return((Image *) NULL); |
| 265 | } |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 266 | /* |
| 267 | Draw caption. |
| 268 | */ |
| 269 | (void) CloneString(&draw_info->text,caption); |
cristy | 5cbc016 | 2011-08-29 00:36:28 +0000 | [diff] [blame] | 270 | status=GetMultilineTypeMetrics(image,draw_info,&metrics,exception); |
cristy | 024843f | 2011-06-03 17:52:52 +0000 | [diff] [blame] | 271 | if ((draw_info->gravity != UndefinedGravity) && |
| 272 | (draw_info->direction != RightToLeftDirection)) |
cristy | bb50337 | 2010-05-27 20:51:26 +0000 | [diff] [blame] | 273 | image->page.x=(ssize_t) (metrics.bounds.x1-draw_info->stroke_width/2.0); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 274 | else |
| 275 | { |
cristy | b51dff5 | 2011-05-19 16:55:47 +0000 | [diff] [blame] | 276 | (void) FormatLocaleString(geometry,MaxTextExtent,"%+g%+g", |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 277 | -metrics.bounds.x1+draw_info->stroke_width/2.0,metrics.ascent+ |
| 278 | draw_info->stroke_width/2.0); |
cristy | 024843f | 2011-06-03 17:52:52 +0000 | [diff] [blame] | 279 | if (draw_info->direction == RightToLeftDirection) |
| 280 | (void) FormatLocaleString(geometry,MaxTextExtent,"%+g%+g", |
| 281 | image->columns-(metrics.bounds.x2+draw_info->stroke_width/2.0), |
| 282 | metrics.ascent+draw_info->stroke_width/2.0); |
| 283 | draw_info->geometry=AcquireString(geometry); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 284 | } |
cristy | ab272ac | 2012-03-04 22:08:07 +0000 | [diff] [blame] | 285 | status=AnnotateImage(image,draw_info,exception); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 286 | draw_info=DestroyDrawInfo(draw_info); |
| 287 | caption=DestroyString(caption); |
cristy | ab272ac | 2012-03-04 22:08:07 +0000 | [diff] [blame] | 288 | if (status == MagickFalse) |
| 289 | { |
| 290 | image=DestroyImageList(image); |
| 291 | return((Image *) NULL); |
| 292 | } |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 293 | return(GetFirstImageInList(image)); |
| 294 | } |
| 295 | |
| 296 | /* |
| 297 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 298 | % % |
| 299 | % % |
| 300 | % % |
| 301 | % R e g i s t e r C A P T I O N I m a g e % |
| 302 | % % |
| 303 | % % |
| 304 | % % |
| 305 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 306 | % |
| 307 | % RegisterCAPTIONImage() adds attributes for the CAPTION image format to |
| 308 | % the list of supported formats. The attributes include the image format |
| 309 | % tag, a method to read and/or write the format, whether the format |
| 310 | % supports the saving of more than one frame to the same file or blob, |
| 311 | % whether the format supports native in-memory I/O, and a brief |
| 312 | % description of the format. |
| 313 | % |
| 314 | % The format of the RegisterCAPTIONImage method is: |
| 315 | % |
cristy | bb50337 | 2010-05-27 20:51:26 +0000 | [diff] [blame] | 316 | % size_t RegisterCAPTIONImage(void) |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 317 | % |
| 318 | */ |
cristy | bb50337 | 2010-05-27 20:51:26 +0000 | [diff] [blame] | 319 | ModuleExport size_t RegisterCAPTIONImage(void) |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 320 | { |
| 321 | MagickInfo |
| 322 | *entry; |
| 323 | |
| 324 | entry=SetMagickInfo("CAPTION"); |
| 325 | entry->decoder=(DecodeImageHandler *) ReadCAPTIONImage; |
cristy | 8a3ce7f | 2011-10-30 02:28:03 +0000 | [diff] [blame] | 326 | entry->description=ConstantString("Caption"); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 327 | entry->adjoin=MagickFalse; |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 328 | entry->module=ConstantString("CAPTION"); |
| 329 | (void) RegisterMagickInfo(entry); |
| 330 | return(MagickImageCoderSignature); |
| 331 | } |
| 332 | |
| 333 | /* |
| 334 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 335 | % % |
| 336 | % % |
| 337 | % % |
| 338 | % U n r e g i s t e r C A P T I O N I m a g e % |
| 339 | % % |
| 340 | % % |
| 341 | % % |
| 342 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 343 | % |
| 344 | % UnregisterCAPTIONImage() removes format registrations made by the |
| 345 | % CAPTION module from the list of supported formats. |
| 346 | % |
| 347 | % The format of the UnregisterCAPTIONImage method is: |
| 348 | % |
| 349 | % UnregisterCAPTIONImage(void) |
| 350 | % |
| 351 | */ |
| 352 | ModuleExport void UnregisterCAPTIONImage(void) |
| 353 | { |
| 354 | (void) UnregisterMagickInfo("CAPTION"); |
| 355 | } |