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*/
68static 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*/
94ModuleExport 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*/
126ModuleExport 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*/
158static 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