1 /*
2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3 % %
4 % %
5 % %
6 % IIIII N N FFFFF OOO %
7 % I NN N F O O %
8 % I N N N FFF O O %
9 % I N NN F O O %
10 % IIIII N N F OOO %
11 % %
12 % %
13 % Write Info About the Image. %
14 % %
15 % Software Design %
16 % Cristy %
17 % July 1992 %
18 % %
19 % %
20 % Copyright 1999-2016 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 %
37 */
38
39 /*
40 Include declarations.
41 */
42 #include "MagickCore/studio.h"
43 #include "MagickCore/artifact.h"
44 #include "MagickCore/blob.h"
45 #include "MagickCore/blob-private.h"
46 #include "MagickCore/colorspace.h"
47 #include "MagickCore/exception.h"
48 #include "MagickCore/exception-private.h"
49 #include "MagickCore/identify.h"
50 #include "MagickCore/image.h"
51 #include "MagickCore/image-private.h"
52 #include "MagickCore/list.h"
53 #include "MagickCore/magick.h"
54 #include "MagickCore/memory_.h"
55 #include "MagickCore/monitor.h"
56 #include "MagickCore/monitor-private.h"
57 #include "MagickCore/option.h"
58 #include "MagickCore/property.h"
59 #include "MagickCore/quantum-private.h"
60 #include "MagickCore/static.h"
61 #include "MagickCore/string_.h"
62 #include "MagickCore/module.h"
63 #include "MagickCore/utility.h"
64
65 /*
66 Forward declarations.
67 */
68 static MagickBooleanType
69 WriteINFOImage(const ImageInfo *,Image *,ExceptionInfo *);
70
71 /*
72 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
73 % %
74 % %
75 % %
76 % R e g i s t e r I N F O I m a g e %
77 % %
78 % %
79 % %
80 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
81 %
82 % RegisterINFOImage() adds attributes for the INFO image format to
83 % the list of supported formats. The attributes include the image format
84 % tag, a method to read and/or write the format, whether the format
85 % supports the saving of more than one frame to the same file or blob,
86 % whether the format supports native in-memory I/O, and a brief
87 % description of the format.
88 %
89 % The format of the RegisterINFOImage method is:
90 %
91 % size_t RegisterINFOImage(void)
92 %
93 */
RegisterINFOImage(void)94 ModuleExport size_t RegisterINFOImage(void)
95 {
96 MagickInfo
97 *entry;
98
99 entry=AcquireMagickInfo("INFO","INFO",
100 "The image format and characteristics");
101 entry->encoder=(EncodeImageHandler *) WriteINFOImage;
102 entry->flags^=CoderBlobSupportFlag;
103 (void) RegisterMagickInfo(entry);
104 return(MagickImageCoderSignature);
105 }
106
107 /*
108 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
109 % %
110 % %
111 % %
112 % U n r e g i s t e r I N F O I m a g e %
113 % %
114 % %
115 % %
116 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
117 %
118 % UnregisterINFOImage() removes format registrations made by the
119 % INFO module from the list of supported formats.
120 %
121 % The format of the UnregisterINFOImage method is:
122 %
123 % UnregisterINFOImage(void)
124 %
125 */
UnregisterINFOImage(void)126 ModuleExport void UnregisterINFOImage(void)
127 {
128 (void) UnregisterMagickInfo("INFO");
129 }
130
131 /*
132 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
133 % %
134 % %
135 % %
136 % W r i t e I N F O I m a g e %
137 % %
138 % %
139 % %
140 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
141 %
142 % WriteINFOImage writes the pixel values as text numbers.
143 %
144 % The format of the WriteINFOImage method is:
145 %
146 % MagickBooleanType WriteINFOImage(const ImageInfo *image_info,
147 % Image *image,ExceptionInfo *exception)
148 %
149 % A description of each parameter follows.
150 %
151 % o image_info: the image info.
152 %
153 % o image: The image.
154 %
155 % o exception: return any errors or warnings in this structure.
156 %
157 */
WriteINFOImage(const ImageInfo * image_info,Image * image,ExceptionInfo * exception)158 static MagickBooleanType WriteINFOImage(const ImageInfo *image_info,
159 Image *image,ExceptionInfo *exception)
160 {
161 const char
162 *format;
163
164 MagickBooleanType
165 status;
166
167 MagickOffsetType
168 scene;
169
170 /*
171 Open output image file.
172 */
173 assert(image_info != (const ImageInfo *) NULL);
174 assert(image_info->signature == MagickCoreSignature);
175 assert(image != (Image *) NULL);
176 assert(image->signature == MagickCoreSignature);
177 if (image->debug != MagickFalse)
178 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
179 status=OpenBlob(image_info,image,WriteBlobMode,exception);
180 if (status == MagickFalse)
181 return(status);
182 scene=0;
183 do
184 {
185 format=GetImageOption(image_info,"format");
186 if (format == (char *) NULL)
187 {
188 (void) CopyMagickString(image->filename,image->magick_filename,
189 MagickPathExtent);
190 image->magick_columns=image->columns;
191 image->magick_rows=image->rows;
192 (void) IdentifyImage(image,GetBlobFileHandle(image),
193 image_info->verbose,exception);
194 }
195 else
196 {
197 char
198 *text;
199
200 text=InterpretImageProperties((ImageInfo *) image_info,image,format,
201 exception);
202 if (text != (char *) NULL)
203 {
204 (void) WriteBlobString(image,text);
205 text=DestroyString(text);
206 }
207 }
208 if (GetNextImageInList(image) == (Image *) NULL)
209 break;
210 image=SyncNextImageInList(image);
211 status=SetImageProgress(image,SaveImagesTag,scene++,
212 GetImageListLength(image));
213 if (status == MagickFalse)
214 break;
215 } while (image_info->adjoin != MagickFalse);
216 (void) CloseBlob(image);
217 return(MagickTrue);
218 }
219