1 /*
2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3 % %
4 % %
5 % %
6 % X X %
7 % X X %
8 % X %
9 % X X %
10 % X X %
11 % %
12 % %
13 % Read/Write Image from/to X11 Server. %
14 % %
15 % Software Design %
16 % Cristy %
17 % July 1992 %
18 % %
19 % %
20 % Copyright 1999-2021 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/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"
63
64 /*
65 Forward declarations.
66 */
67 #if defined(MAGICKCORE_X11_DELEGATE)
68 static MagickBooleanType
69 WriteXImage(const ImageInfo *,Image *,ExceptionInfo *);
70 #endif
71
72 #if defined(MAGICKCORE_X11_DELEGATE)
73 /*
74 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
75 % %
76 % %
77 % %
78 % R e a d X I m a g e %
79 % %
80 % %
81 % %
82 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
83 %
84 % ReadXImage() reads an image from an X window.
85 %
86 % The format of the ReadXImage method is:
87 %
88 % Image *ReadXImage(const ImageInfo *image_info,ExceptionInfo *exception)
89 %
90 % A description of each parameter follows:
91 %
92 % o image_info: the image info.
93 %
94 % o exception: return any errors or warnings in this structure.
95 %
96 */
ReadXImage(const ImageInfo * image_info,ExceptionInfo * exception)97 static Image *ReadXImage(const ImageInfo *image_info,ExceptionInfo *exception)
98 {
99 XImportInfo
100 ximage_info;
101
102 (void) exception;
103 XGetImportInfo(&ximage_info);
104 ximage_info.screen=IsStringTrue(GetImageOption(image_info,"x:screen"));
105 ximage_info.silent=IsStringTrue(GetImageOption(image_info,"x:silent"));
106 return(XImportImage(image_info,&ximage_info,exception));
107 }
108 #endif
109
110 /*
111 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
112 % %
113 % %
114 % %
115 % R e g i s t e r X I m a g e %
116 % %
117 % %
118 % %
119 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
120 %
121 % RegisterXImage() adds attributes for the X image format to
122 % the list of supported formats. The attributes include the image format
123 % tag, a method to read and/or write the format, whether the format
124 % supports the saving of more than one frame to the same file or blob,
125 % whether the format supports native in-memory I/O, and a brief
126 % description of the format.
127 %
128 % The format of the RegisterXImage method is:
129 %
130 % size_t RegisterXImage(void)
131 %
132 */
RegisterXImage(void)133 ModuleExport size_t RegisterXImage(void)
134 {
135 MagickInfo
136 *entry;
137
138 entry=AcquireMagickInfo("X","X","X Image");
139 #if defined(MAGICKCORE_X11_DELEGATE)
140 entry->decoder=(DecodeImageHandler *) ReadXImage;
141 entry->encoder=(EncodeImageHandler *) WriteXImage;
142 #endif
143 entry->format_type=ImplicitFormatType;
144 (void) RegisterMagickInfo(entry);
145 return(MagickImageCoderSignature);
146 }
147
148 /*
149 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
150 % %
151 % %
152 % %
153 % U n r e g i s t e r X I m a g e %
154 % %
155 % %
156 % %
157 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
158 %
159 % UnregisterXImage() removes format registrations made by the
160 % X module from the list of supported formats.
161 %
162 % The format of the UnregisterXImage method is:
163 %
164 % UnregisterXImage(void)
165 %
166 */
UnregisterXImage(void)167 ModuleExport void UnregisterXImage(void)
168 {
169 (void) UnregisterMagickInfo("X");
170 }
171
172 /*
173 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
174 % %
175 % %
176 % %
177 % W r i t e X I m a g e %
178 % %
179 % %
180 % %
181 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
182 %
183 % WriteXImage() writes an image to an X server.
184 %
185 % The format of the WriteXImage method is:
186 %
187 % MagickBooleanType WriteXImage(const ImageInfo *image_info,
188 % Image *image,ExceptionInfo *exception)
189 %
190 % A description of each parameter follows.
191 %
192 % o image_info: the image info.
193 %
194 % o image: The image.
195 %
196 % o exception: return any errors or warnings in this structure.
197 %
198 */
WriteXImage(const ImageInfo * image_info,Image * image,ExceptionInfo * exception)199 static MagickBooleanType WriteXImage(const ImageInfo *image_info,Image *image,
200 ExceptionInfo *exception)
201 {
202 return(DisplayImages(image_info,image,exception));
203 }
204