2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
13 % Read/Write the Magick Persistent Registry. %
20 % Copyright 1999-2010 ImageMagick Studio LLC, a non-profit organization %
21 % dedicated to making software imaging solutions freely available. %
23 % You may not use this file except in compliance with the License. You may %
24 % obtain a copy of the License at %
26 % http://www.imagemagick.org/script/license.php %
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. %
34 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
42 #include "magick/studio.h"
43 #include "magick/blob.h"
44 #include "magick/blob-private.h"
45 #include "magick/exception.h"
46 #include "magick/exception-private.h"
47 #include "magick/magick.h"
48 #include "magick/memory_.h"
49 #include "magick/registry.h"
50 #include "magick/quantum-private.h"
51 #include "magick/static.h"
52 #include "magick/string_.h"
53 #include "magick/module.h"
58 static MagickBooleanType
59 WriteMPRImage(const ImageInfo *,Image *);
62 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
66 % R e a d M P R I m a g e %
70 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
72 % ReadMPRImage() reads a Magick Persistent Registry image as a blob from
73 % memory. It allocates the memory necessary for the new Image structure and
74 % returns a pointer to the new image.
76 % The format of the ReadMPRImage method is:
78 % Image *ReadMPRImage(const ImageInfo *image_info,
79 % ExceptionInfo *exception)
81 % A description of each parameter follows:
83 % o image_info: the image info.
85 % o exception: return any errors or warnings in this structure.
88 static Image *ReadMPRImage(const ImageInfo *image_info,ExceptionInfo *exception)
93 assert(image_info != (const ImageInfo *) NULL);
94 assert(image_info->signature == MagickSignature);
95 if (image_info->debug != MagickFalse)
96 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",
97 image_info->filename);
98 assert(exception != (ExceptionInfo *) NULL);
99 assert(exception->signature == MagickSignature);
100 image=(Image *) GetImageRegistry(ImageRegistryType,image_info->filename,
102 if (image != (Image *) NULL)
103 (void) SyncImageSettings(image_info,image);
108 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
112 % R e g i s t e r M P R I m a g e %
116 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
118 % RegisterMPRImage() adds attributes for the MPR image format to
119 % the list of supported formats. The attributes include the image format
120 % tag, a method to read and/or write the format, whether the format
121 % supports the saving of more than one frame to the same file or blob,
122 % whether the format supports native in-memory I/O, and a brief
123 % description of the format.
125 % The format of the RegisterMPRImage method is:
127 % unsigned long RegisterMPRImage(void)
130 ModuleExport unsigned long RegisterMPRImage(void)
135 entry=SetMagickInfo("MPR");
136 entry->decoder=(DecodeImageHandler *) ReadMPRImage;
137 entry->encoder=(EncodeImageHandler *) WriteMPRImage;
138 entry->adjoin=MagickFalse;
139 entry->stealth=MagickTrue;
140 entry->description=ConstantString("Magick Persistent Registry");
141 entry->module=ConstantString("MPR");
142 (void) RegisterMagickInfo(entry);
143 entry=SetMagickInfo("MPRI");
144 entry->decoder=(DecodeImageHandler *) ReadMPRImage;
145 entry->encoder=(EncodeImageHandler *) WriteMPRImage;
146 entry->stealth=MagickTrue;
147 entry->adjoin=MagickFalse;
148 entry->stealth=MagickTrue;
149 entry->description=ConstantString("Magick Persistent Registry");
150 entry->module=ConstantString("MPRI");
151 (void) RegisterMagickInfo(entry);
152 return(MagickImageCoderSignature);
156 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
160 % U n r e g i s t e r M P R I m a g e %
164 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
166 % UnregisterMPRImage() removes format registrations made by the
167 % MPR module from the list of supported formats.
169 % The format of the UnregisterMPRImage method is:
171 % UnregisterMPRImage(void)
174 ModuleExport void UnregisterMPRImage(void)
176 (void) UnregisterMagickInfo("MPRI");
177 (void) UnregisterMagickInfo("MPR");
181 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
185 % W r i t e M P R I m a g e %
189 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
191 % WriteMPRImage() writes an image into the Magick Persistent Registry
192 % image as a blob from memory. It allocates the memory necessary for the
193 % new Image structure and returns a pointer to the new image.
195 % The format of the WriteMPRImage method is:
197 % MagickBooleanType WriteMPRImage(const ImageInfo *image_info,Image *image)
199 % A description of each parameter follows.
201 % o image_info: the image info.
203 % o image: The image.
206 static MagickBooleanType WriteMPRImage(const ImageInfo *image_info,Image *image)
211 assert(image_info != (const ImageInfo *) NULL);
212 assert(image_info->signature == MagickSignature);
213 assert(image != (Image *) NULL);
214 assert(image->signature == MagickSignature);
215 if (image->debug != MagickFalse)
216 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
217 status=SetImageRegistry(ImageRegistryType,image->filename,image,