2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
13 % Read/Write Image from/to X11 Server. %
20 % Copyright 1999-2012 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 "MagickCore/studio.h"
43 #include "MagickCore/blob.h"
44 #include "MagickCore/blob-private.h"
45 #include "MagickCore/client.h"
46 #include "MagickCore/display.h"
47 #include "MagickCore/exception.h"
48 #include "MagickCore/exception-private.h"
49 #include "MagickCore/image.h"
50 #include "MagickCore/image-private.h"
51 #include "MagickCore/list.h"
52 #include "MagickCore/magick.h"
53 #include "MagickCore/memory_.h"
54 #include "MagickCore/option.h"
55 #include "MagickCore/quantum-private.h"
56 #include "MagickCore/static.h"
57 #include "MagickCore/string_.h"
58 #include "MagickCore/module.h"
59 #include "MagickCore/token.h"
60 #include "MagickCore/utility.h"
61 #include "MagickCore/xwindow.h"
62 #include "MagickCore/xwindow-private.h"
67 #if defined(MAGICKCORE_X11_DELEGATE)
68 static MagickBooleanType
69 WriteXImage(const ImageInfo *,Image *,ExceptionInfo *);
72 #if defined(MAGICKCORE_X11_DELEGATE)
74 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
78 % R e a d X I m a g e %
82 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
84 % ReadXImage() reads an image from an X window.
86 % The format of the ReadXImage method is:
88 % Image *ReadXImage(const ImageInfo *image_info,ExceptionInfo *exception)
90 % A description of each parameter follows:
92 % o image_info: the image info.
94 % o exception: return any errors or warnings in this structure.
97 static Image *ReadXImage(const ImageInfo *image_info,ExceptionInfo *exception)
106 XGetImportInfo(&ximage_info);
107 option=GetImageOption(image_info,"x:screen");
108 if (option != (const char *) NULL)
109 ximage_info.screen=IsMagickTrue(option);
110 option=GetImageOption(image_info,"x:silent");
111 if (option != (const char *) NULL)
112 ximage_info.silent=IsMagickTrue(option);
113 return(XImportImage(image_info,&ximage_info,exception));
118 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
122 % R e g i s t e r X I m a g e %
126 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
128 % RegisterXImage() adds attributes for the X image format to
129 % the list of supported formats. The attributes include the image format
130 % tag, a method to read and/or write the format, whether the format
131 % supports the saving of more than one frame to the same file or blob,
132 % whether the format supports native in-memory I/O, and a brief
133 % description of the format.
135 % The format of the RegisterXImage method is:
137 % size_t RegisterXImage(void)
140 ModuleExport size_t RegisterXImage(void)
145 entry=SetMagickInfo("X");
146 #if defined(MAGICKCORE_X11_DELEGATE)
147 entry->decoder=(DecodeImageHandler *) ReadXImage;
148 entry->encoder=(EncodeImageHandler *) WriteXImage;
150 entry->format_type=ImplicitFormatType;
151 entry->description=ConstantString("X Image");
152 entry->module=ConstantString("X");
153 (void) RegisterMagickInfo(entry);
154 return(MagickImageCoderSignature);
158 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
162 % U n r e g i s t e r X I m a g e %
166 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
168 % UnregisterXImage() removes format registrations made by the
169 % X module from the list of supported formats.
171 % The format of the UnregisterXImage method is:
173 % UnregisterXImage(void)
176 ModuleExport void UnregisterXImage(void)
178 (void) UnregisterMagickInfo("X");
182 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
186 % W r i t e X I m a g e %
190 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
192 % WriteXImage() writes an image to an X server.
194 % The format of the WriteXImage method is:
196 % MagickBooleanType WriteXImage(const ImageInfo *image_info,
197 % Image *image,ExceptionInfo *exception)
199 % A description of each parameter follows.
201 % o image_info: the image info.
203 % o image: The image.
205 % o exception: return any errors or warnings in this structure.
208 static MagickBooleanType WriteXImage(const ImageInfo *image_info,Image *image,
209 ExceptionInfo *exception)
211 return(DisplayImages(image_info,image,exception));