2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
6 % PPPP RRRR EEEEE V V IIIII EEEEE W W %
7 % P P R R E V V I E W W %
8 % PPPP RRRR EEE V V I EEE W W %
9 % P R R E V V I E W W W %
10 % P R R EEEEE V IIIII EEEEE W W %
13 % Write A Preview Image. %
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/property.h"
44 #include "magick/blob.h"
45 #include "magick/blob-private.h"
46 #include "magick/client.h"
47 #include "magick/constitute.h"
48 #include "magick/effect.h"
49 #include "magick/exception.h"
50 #include "magick/exception-private.h"
51 #include "magick/image.h"
52 #include "magick/image-private.h"
53 #include "magick/list.h"
54 #include "magick/magick.h"
55 #include "magick/memory_.h"
56 #include "magick/monitor.h"
57 #include "magick/monitor-private.h"
58 #include "magick/resize.h"
59 #include "magick/resource_.h"
60 #include "magick/quantum-private.h"
61 #include "magick/static.h"
62 #include "magick/string_.h"
63 #include "magick/module.h"
64 #include "magick/transform.h"
65 #include "magick/utility.h"
70 static MagickBooleanType
71 WritePreviewImage(const ImageInfo *,Image *);
74 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
78 % R e g i s t e r P R E V I E W I m a g e %
82 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
84 % RegisterPREVIEWImage() adds attributes for the Preview image format to
85 % the list of supported formats. The attributes include the image format
86 % tag, a method to read and/or write the format, whether the format
87 % supports the saving of more than one frame to the same file or blob,
88 % whether the format supports native in-memory I/O, and a brief
89 % description of the format.
91 % The format of the RegisterPREVIEWImage method is:
93 % size_t RegisterPREVIEWImage(void)
96 ModuleExport size_t RegisterPREVIEWImage(void)
101 entry=SetMagickInfo("PREVIEW");
102 entry->encoder=(EncodeImageHandler *) WritePreviewImage;
103 entry->adjoin=MagickFalse;
104 entry->format_type=ImplicitFormatType;
105 entry->description=ConstantString(
106 "Show a preview an image enhancement, effect, or f/x");
107 entry->module=ConstantString("PREVIEW");
108 (void) RegisterMagickInfo(entry);
109 return(MagickImageCoderSignature);
113 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
117 % U n r e g i s t e r P R E V I E W I m a g e %
121 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
123 % UnregisterPREVIEWImage() removes format registrations made by the
124 % PREVIEW module from the list of supported formats.
126 % The format of the UnregisterPREVIEWImage method is:
128 % UnregisterPREVIEWImage(void)
131 ModuleExport void UnregisterPREVIEWImage(void)
133 (void) UnregisterMagickInfo("PREVIEW");
137 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
141 % W r i t e P R E V I E W I m a g e %
145 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
147 % WritePreviewImage creates several tiles each with a varying
148 % stength of an image enhancement function (e.g. gamma). The image is written
149 % in the MIFF format.
151 % The format of the WritePreviewImage method is:
153 % MagickBooleanType WritePreviewImage(const ImageInfo *image_info,
156 % A description of each parameter follows.
158 % o image_info: the image info.
160 % o image: The image.
163 static MagickBooleanType WritePreviewImage(const ImageInfo *image_info,
176 Open output image file.
178 assert(image_info != (const ImageInfo *) NULL);
179 assert(image_info->signature == MagickSignature);
180 assert(image != (Image *) NULL);
181 assert(image->signature == MagickSignature);
182 if (image->debug != MagickFalse)
183 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
184 preview_image=PreviewImage(image,image_info->preview_type,&image->exception);
185 if (preview_image == (Image *) NULL)
187 (void) CopyMagickString(preview_image->filename,image_info->filename,
189 write_info=CloneImageInfo(image_info);
190 (void) SetImageInfo(write_info,1,&image->exception);
191 if (LocaleCompare(write_info->magick,"PREVIEW") == 0)
192 (void) FormatMagickString(preview_image->filename,MaxTextExtent,
193 "miff:%s",image_info->filename);
194 status=WriteImage(write_info,preview_image);
195 preview_image=DestroyImage(preview_image);
196 write_info=DestroyImageInfo(write_info);