1 /*
2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3 % %
4 % %
5 % %
6 % PPPP IIIII X X %
7 % P P I X X %
8 % PPPP I X %
9 % P I X X %
10 % P IIIII X X %
11 % %
12 % %
13 % Read Alias/Wavefront RLE Image Format %
14 % %
15 % Software Design %
16 % Cristy %
17 % July 1992 %
18 % %
19 % %
20 % Copyright 1999-2019 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/cache.h"
46 #include "MagickCore/colormap.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/monitor.h"
55 #include "MagickCore/monitor-private.h"
56 #include "MagickCore/pixel-accessor.h"
57 #include "MagickCore/quantum-private.h"
58 #include "MagickCore/static.h"
59 #include "MagickCore/string_.h"
60 #include "MagickCore/module.h"
61
62 /*
63 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
64 % %
65 % %
66 % %
67 % R e a d P I X I m a g e %
68 % %
69 % %
70 % %
71 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
72 %
73 % ReadPIXImage() reads a Alias/Wavefront RLE image file and returns it.
74 % It allocates the memory necessary for the new Image structure and returns a
75 % pointer to the new image.
76 %
77 % The format of the ReadPIXImage method is:
78 %
79 % Image *ReadPIXImage(const ImageInfo *image_info,ExceptionInfo *exception)
80 %
81 % A description of each parameter follows:
82 %
83 % o image_info: the image info.
84 %
85 % o exception: return any errors or warnings in this structure.
86 %
87 %
88 */
ReadPIXImage(const ImageInfo * image_info,ExceptionInfo * exception)89 static Image *ReadPIXImage(const ImageInfo *image_info,ExceptionInfo *exception)
90 {
91 Image
92 *image;
93
94 MagickBooleanType
95 status;
96
97 Quantum
98 blue,
99 green,
100 index,
101 red;
102
103 register ssize_t
104 x;
105
106 register Quantum
107 *q;
108
109 size_t
110 bits_per_pixel,
111 height,
112 length,
113 width;
114
115 ssize_t
116 y;
117
118 /*
119 Open image file.
120 */
121 assert(image_info != (const ImageInfo *) NULL);
122 assert(image_info->signature == MagickCoreSignature);
123 if (image_info->debug != MagickFalse)
124 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",
125 image_info->filename);
126 assert(exception != (ExceptionInfo *) NULL);
127 assert(exception->signature == MagickCoreSignature);
128 image=AcquireImage(image_info,exception);
129 status=OpenBlob(image_info,image,ReadBinaryBlobMode,exception);
130 if (status == MagickFalse)
131 {
132 image=DestroyImageList(image);
133 return((Image *) NULL);
134 }
135 /*
136 Read PIX image.
137 */
138 width=ReadBlobMSBShort(image);
139 height=ReadBlobMSBShort(image);
140 (void) ReadBlobMSBShort(image); /* x-offset */
141 (void) ReadBlobMSBShort(image); /* y-offset */
142 bits_per_pixel=ReadBlobMSBShort(image);
143 if ((width == 0UL) || (height == 0UL) || ((bits_per_pixel != 8) &&
144 (bits_per_pixel != 24)))
145 ThrowReaderException(CorruptImageError,"ImproperImageHeader");
146 do
147 {
148 /*
149 Initialize image structure.
150 */
151 image->columns=width;
152 image->rows=height;
153 if (bits_per_pixel == 8)
154 if (AcquireImageColormap(image,256,exception) == MagickFalse)
155 ThrowReaderException(ResourceLimitError,"MemoryAllocationFailed");
156 if ((image_info->ping != MagickFalse) && (image_info->number_scenes != 0))
157 if (image->scene >= (image_info->scene+image_info->number_scenes-1))
158 break;
159 status=SetImageExtent(image,image->columns,image->rows,exception);
160 if (status == MagickFalse)
161 return(DestroyImageList(image));
162 status=ResetImagePixels(image,exception);
163 if (status == MagickFalse)
164 return(DestroyImageList(image));
165 /*
166 Convert PIX raster image to pixel packets.
167 */
168 red=(Quantum) 0;
169 green=(Quantum) 0;
170 blue=(Quantum) 0;
171 index=0;
172 length=0;
173 for (y=0; y < (ssize_t) image->rows; y++)
174 {
175 q=QueueAuthenticPixels(image,0,y,image->columns,1,exception);
176 if (q == (Quantum *) NULL)
177 break;
178 for (x=0; x < (ssize_t) image->columns; x++)
179 {
180 if (length == 0)
181 {
182 int
183 c;
184
185 c=ReadBlobByte(image);
186 if ((c == 0) || (c == EOF))
187 break;
188 length=(size_t) c;
189 if (bits_per_pixel == 8)
190 index=ScaleCharToQuantum((unsigned char) ReadBlobByte(image));
191 else
192 {
193 blue=ScaleCharToQuantum((unsigned char) ReadBlobByte(image));
194 green=ScaleCharToQuantum((unsigned char) ReadBlobByte(image));
195 red=ScaleCharToQuantum((unsigned char) ReadBlobByte(image));
196 }
197 }
198 if (image->storage_class == PseudoClass)
199 SetPixelIndex(image,index,q);
200 SetPixelBlue(image,blue,q);
201 SetPixelGreen(image,green,q);
202 SetPixelRed(image,red,q);
203 length--;
204 q+=GetPixelChannels(image);
205 }
206 if (x < (ssize_t) image->columns)
207 break;
208 if (SyncAuthenticPixels(image,exception) == MagickFalse)
209 break;
210 if (image->previous == (Image *) NULL)
211 {
212 status=SetImageProgress(image,LoadImageTag,(MagickOffsetType) y,
213 image->rows);
214 if (status == MagickFalse)
215 break;
216 }
217 }
218 if (image->storage_class == PseudoClass)
219 (void) SyncImage(image,exception);
220 if (EOFBlob(image) != MagickFalse)
221 {
222 ThrowFileException(exception,CorruptImageError,"UnexpectedEndOfFile",
223 image->filename);
224 break;
225 }
226 /*
227 Proceed to next image.
228 */
229 if (image_info->number_scenes != 0)
230 if (image->scene >= (image_info->scene+image_info->number_scenes-1))
231 break;
232 width=ReadBlobMSBLong(image);
233 height=ReadBlobMSBLong(image);
234 (void) ReadBlobMSBShort(image);
235 (void) ReadBlobMSBShort(image);
236 bits_per_pixel=ReadBlobMSBShort(image);
237 status=(width != 0UL) && (height == 0UL) && ((bits_per_pixel == 8) ||
238 (bits_per_pixel == 24)) ? MagickTrue : MagickFalse;
239 if (status != MagickFalse)
240 {
241 /*
242 Allocate next image structure.
243 */
244 AcquireNextImage(image_info,image,exception);
245 if (GetNextImageInList(image) == (Image *) NULL)
246 {
247 status=MagickFalse;
248 break;
249 }
250 image=SyncNextImageInList(image);
251 status=SetImageProgress(image,LoadImagesTag,TellBlob(image),
252 GetBlobSize(image));
253 if (status == MagickFalse)
254 break;
255 }
256 } while (status != MagickFalse);
257 (void) CloseBlob(image);
258 if (status == MagickFalse)
259 return(DestroyImageList(image));
260 return(GetFirstImageInList(image));
261 }
262
263 /*
264 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
265 % %
266 % %
267 % %
268 % R e g i s t e r P I X I m a g e %
269 % %
270 % %
271 % %
272 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
273 %
274 % RegisterPIXImage() adds attributes for the PIX image format to
275 % the list of supported formats. The attributes include the image format
276 % tag, a method to read and/or write the format, whether the format
277 % supports the saving of more than one frame to the same file or blob,
278 % whether the format supports native in-memory I/O, and a brief
279 % description of the format.
280 %
281 % The format of the RegisterPIXImage method is:
282 %
283 % size_t RegisterPIXImage(void)
284 %
285 */
RegisterPIXImage(void)286 ModuleExport size_t RegisterPIXImage(void)
287 {
288 MagickInfo
289 *entry;
290
291 entry=AcquireMagickInfo("PIX","PIX","Alias/Wavefront RLE image format");
292 entry->decoder=(DecodeImageHandler *) ReadPIXImage;
293 (void) RegisterMagickInfo(entry);
294 return(MagickImageCoderSignature);
295 }
296
297 /*
298 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
299 % %
300 % %
301 % %
302 % U n r e g i s t e r P I X I m a g e %
303 % %
304 % %
305 % %
306 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
307 %
308 % UnregisterPIXImage() removes format registrations made by the
309 % PIX module from the list of supported formats.
310 %
311 % The format of the UnregisterPIXImage method is:
312 %
313 % UnregisterPIXImage(void)
314 %
315 */
UnregisterPIXImage(void)316 ModuleExport void UnregisterPIXImage(void)
317 {
318 (void) UnregisterMagickInfo("PIX");
319 }
320