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-2019 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 % https://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","The image format and characteristics");
100 entry->encoder=(EncodeImageHandler *) WriteINFOImage;
101 entry->flags^=CoderBlobSupportFlag;
102 (void) RegisterMagickInfo(entry);
103 return(MagickImageCoderSignature);
104 }
105
106 /*
107 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
108 % %
109 % %
110 % %
111 % U n r e g i s t e r I N F O I m a g e %
112 % %
113 % %
114 % %
115 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
116 %
117 % UnregisterINFOImage() removes format registrations made by the
118 % INFO module from the list of supported formats.
119 %
120 % The format of the UnregisterINFOImage method is:
121 %
122 % UnregisterINFOImage(void)
123 %
124 */
UnregisterINFOImage(void)125 ModuleExport void UnregisterINFOImage(void)
126 {
127 (void) UnregisterMagickInfo("INFO");
128 }
129
130 /*
131 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
132 % %
133 % %
134 % %
135 % W r i t e I N F O I m a g e %
136 % %
137 % %
138 % %
139 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
140 %
141 % WriteINFOImage writes the pixel values as text numbers.
142 %
143 % The format of the WriteINFOImage method is:
144 %
145 % MagickBooleanType WriteINFOImage(const ImageInfo *image_info,
146 % Image *image,ExceptionInfo *exception)
147 %
148 % A description of each parameter follows.
149 %
150 % o image_info: the image info.
151 %
152 % o image: The image.
153 %
154 % o exception: return any errors or warnings in this structure.
155 %
156 */
WriteINFOImage(const ImageInfo * image_info,Image * image,ExceptionInfo * exception)157 static MagickBooleanType WriteINFOImage(const ImageInfo *image_info,
158 Image *image,ExceptionInfo *exception)
159 {
160 const char
161 *format;
162
163 MagickBooleanType
164 status;
165
166 MagickOffsetType
167 scene;
168
169 size_t
170 imageListLength;
171
172 /*
173 Open output image file.
174 */
175 assert(image_info != (const ImageInfo *) NULL);
176 assert(image_info->signature == MagickCoreSignature);
177 assert(image != (Image *) NULL);
178 assert(image->signature == MagickCoreSignature);
179 if (image->debug != MagickFalse)
180 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
181 status=OpenBlob(image_info,image,WriteBlobMode,exception);
182 if (status == MagickFalse)
183 return(status);
184 scene=0;
185 imageListLength=GetImageListLength(image);
186 do
187 {
188 format=GetImageOption(image_info,"format");
189 if (format == (char *) NULL)
190 {
191 (void) CopyMagickString(image->filename,image->magick_filename,
192 MagickPathExtent);
193 image->magick_columns=image->columns;
194 image->magick_rows=image->rows;
195 (void) IdentifyImage(image,GetBlobFileHandle(image),
196 image_info->verbose,exception);
197 }
198 else
199 {
200 char
201 *text;
202
203 text=InterpretImageProperties((ImageInfo *) image_info,image,format,
204 exception);
205 if (text != (char *) NULL)
206 {
207 (void) WriteBlobString(image,text);
208 text=DestroyString(text);
209 }
210 }
211 if (GetNextImageInList(image) == (Image *) NULL)
212 break;
213 image=SyncNextImageInList(image);
214 status=SetImageProgress(image,SaveImagesTag,scene++,imageListLength);
215 if (status == MagickFalse)
216 break;
217 } while (image_info->adjoin != MagickFalse);
218 (void) CloseBlob(image);
219 return(MagickTrue);
220 }
221