blob: c61af075d050c8c69df08e5302ecbe2bbd0a9183 [file] [log] [blame]
cristy3ed852e2009-09-05 21:47:34 +00001/*
2%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3% %
4% %
5% %
6% FFFFF IIIII TTTTT SSSSS %
7% F I T SS %
8% FFF I T SSS %
9% F I T SS %
10% F IIIII T SSSSS %
11% %
12% %
13% Read/Write Flexible Image Transport System Images. %
14% %
15% Software Design %
cristyde984cd2013-12-01 14:49:27 +000016% Cristy %
cristy3ed852e2009-09-05 21:47:34 +000017% July 1992 %
18% %
19% %
cristyb56bb242014-11-25 17:12:48 +000020% Copyright 1999-2015 ImageMagick Studio LLC, a non-profit organization %
cristy3ed852e2009-09-05 21:47:34 +000021% 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% http://www.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*/
cristy4c08aed2011-07-01 19:47:50 +000042#include "MagickCore/studio.h"
43#include "MagickCore/attribute.h"
44#include "MagickCore/blob.h"
45#include "MagickCore/blob-private.h"
46#include "MagickCore/cache.h"
47#include "MagickCore/color-private.h"
48#include "MagickCore/colorspace.h"
cristy510d06a2011-07-06 23:43:54 +000049#include "MagickCore/colorspace-private.h"
cristy4c08aed2011-07-01 19:47:50 +000050#include "MagickCore/constitute.h"
51#include "MagickCore/exception.h"
52#include "MagickCore/exception-private.h"
53#include "MagickCore/image.h"
54#include "MagickCore/image-private.h"
55#include "MagickCore/list.h"
56#include "MagickCore/magick.h"
57#include "MagickCore/memory_.h"
58#include "MagickCore/module.h"
59#include "MagickCore/monitor.h"
60#include "MagickCore/monitor-private.h"
61#include "MagickCore/pixel-accessor.h"
62#include "MagickCore/property.h"
63#include "MagickCore/quantum-private.h"
64#include "MagickCore/static.h"
65#include "MagickCore/statistic.h"
66#include "MagickCore/string_.h"
67#include "MagickCore/string-private.h"
68#include "MagickCore/module.h"
cristy3ed852e2009-09-05 21:47:34 +000069
70/*
71 Forward declarations.
72*/
73#define FITSBlocksize 2880UL
74
75/*
76 Forward declarations.
77*/
78static MagickBooleanType
cristy1e178e72011-08-28 19:44:34 +000079 WriteFITSImage(const ImageInfo *,Image *,ExceptionInfo *);
cristy3ed852e2009-09-05 21:47:34 +000080
81/*
82%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
83% %
84% %
85% %
86% I s F I T S %
87% %
88% %
89% %
90%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
91%
92% IsFITS() returns MagickTrue if the image format type, identified by the
93% magick string, is FITS.
94%
95% The format of the IsFITS method is:
96%
97% MagickBooleanType IsFITS(const unsigned char *magick,const size_t length)
98%
99% A description of each parameter follows:
100%
101% o magick: compare image format pattern against these bytes.
102%
103% o length: Specifies the length of the magick string.
104%
105*/
106static MagickBooleanType IsFITS(const unsigned char *magick,const size_t length)
107{
108 if (length < 6)
109 return(MagickFalse);
110 if (LocaleNCompare((const char *) magick,"IT0",3) == 0)
111 return(MagickTrue);
112 if (LocaleNCompare((const char *) magick,"SIMPLE",6) == 0)
113 return(MagickTrue);
114 return(MagickFalse);
115}
116
117/*
118%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
119% %
120% %
121% %
122% R e a d F I T S I m a g e %
123% %
124% %
125% %
126%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
127%
128% ReadFITSImage() reads a FITS image file and returns it. It allocates the
129% memory necessary for the new Image structure and returns a pointer to the
130% new image.
131%
132% The format of the ReadFITSImage method is:
133%
134% Image *ReadFITSImage(const ImageInfo *image_info,
135% ExceptionInfo *exception)
136%
137% A description of each parameter follows:
138%
139% o image_info: the image info.
140%
141% o exception: return any errors or warnings in this structure.
142%
143*/
144
145static inline double GetFITSPixel(Image *image,int bits_per_pixel)
146{
147 switch (image->depth >> 3)
148 {
149 case 1:
150 return((double) ReadBlobByte(image));
151 case 2:
152 return((double) ((short) ReadBlobShort(image)));
153 case 4:
154 {
155 if (bits_per_pixel > 0)
cristy6cff05d2010-09-02 11:22:46 +0000156 return((double) ((int) ReadBlobLong(image)));
cristy3ed852e2009-09-05 21:47:34 +0000157 return((double) ReadBlobFloat(image));
158 }
159 case 8:
160 {
161 if (bits_per_pixel > 0)
162 return((double) ((MagickOffsetType) ReadBlobLongLong(image)));
163 }
164 default:
165 break;
166 }
167 return(ReadBlobDouble(image));
168}
169
cristy4d0ca342014-05-01 00:42:09 +0000170static MagickOffsetType GetFITSPixelExtrema(Image *image,
171 const int bits_per_pixel,double *minima,double *maxima)
cristy3ed852e2009-09-05 21:47:34 +0000172{
173 double
174 pixel;
175
176 MagickOffsetType
177 offset;
178
179 MagickSizeType
180 number_pixels;
181
182 register MagickOffsetType
183 i;
184
185 offset=TellBlob(image);
cristy4d0ca342014-05-01 00:42:09 +0000186 if (offset == -1)
187 return(-1);
cristy3ed852e2009-09-05 21:47:34 +0000188 number_pixels=(MagickSizeType) image->columns*image->rows;
189 *minima=GetFITSPixel(image,bits_per_pixel);
190 *maxima=(*minima);
191 for (i=1; i < (MagickOffsetType) number_pixels; i++)
192 {
193 pixel=GetFITSPixel(image,bits_per_pixel);
194 if (pixel < *minima)
195 *minima=pixel;
196 if (pixel > *maxima)
197 *maxima=pixel;
198 }
cristy4d0ca342014-05-01 00:42:09 +0000199 return(SeekBlob(image,offset,SEEK_SET));
cristy3ed852e2009-09-05 21:47:34 +0000200}
201
cristybb503372010-05-27 20:51:26 +0000202static inline double GetFITSPixelRange(const size_t depth)
cristy3ed852e2009-09-05 21:47:34 +0000203{
204 return((double) ((MagickOffsetType) GetQuantumRange(depth)));
205}
206
207static void SetFITSUnsignedPixels(const size_t length,
cristyf84dc8e2013-02-02 16:46:26 +0000208 const size_t bits_per_pixel,const EndianType endian,unsigned char *pixels)
cristy3ed852e2009-09-05 21:47:34 +0000209{
cristybb503372010-05-27 20:51:26 +0000210 register ssize_t
cristy3ed852e2009-09-05 21:47:34 +0000211 i;
212
cristyf84dc8e2013-02-02 16:46:26 +0000213 if (endian != MSBEndian)
214 pixels+=(bits_per_pixel >> 3)-1;
cristybb503372010-05-27 20:51:26 +0000215 for (i=0; i < (ssize_t) length; i++)
cristy3ed852e2009-09-05 21:47:34 +0000216 {
217 *pixels^=0x80;
218 pixels+=bits_per_pixel >> 3;
219 }
220}
221
222static Image *ReadFITSImage(const ImageInfo *image_info,
223 ExceptionInfo *exception)
224{
225 typedef struct _FITSInfo
226 {
227 MagickBooleanType
228 extend,
229 simple;
230
231 int
232 bits_per_pixel,
233 columns,
234 rows,
235 number_axes,
236 number_planes;
237
238 double
239 min_data,
240 max_data,
241 zero,
242 scale;
243
244 EndianType
245 endian;
246 } FITSInfo;
247
248 char
249 *comment,
250 keyword[9],
251 property[MaxTextExtent],
252 value[73];
253
254 double
255 pixel,
256 scale;
257
258 FITSInfo
259 fits_info;
260
261 Image
262 *image;
263
264 int
265 c;
266
cristy3ed852e2009-09-05 21:47:34 +0000267 MagickBooleanType
268 status;
269
270 MagickSizeType
271 number_pixels;
272
cristybb503372010-05-27 20:51:26 +0000273 register ssize_t
cristy3ed852e2009-09-05 21:47:34 +0000274 i,
275 x;
276
cristy4c08aed2011-07-01 19:47:50 +0000277 register Quantum
cristy3ed852e2009-09-05 21:47:34 +0000278 *q;
279
280 ssize_t
cristy202de442011-04-24 18:19:07 +0000281 count,
282 scene,
283 y;
cristy3ed852e2009-09-05 21:47:34 +0000284
285 /*
286 Open image file.
287 */
288 assert(image_info != (const ImageInfo *) NULL);
289 assert(image_info->signature == MagickSignature);
290 if (image_info->debug != MagickFalse)
291 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",
292 image_info->filename);
293 assert(exception != (ExceptionInfo *) NULL);
294 assert(exception->signature == MagickSignature);
cristy9950d572011-10-01 18:22:35 +0000295 image=AcquireImage(image_info,exception);
cristy3ed852e2009-09-05 21:47:34 +0000296 status=OpenBlob(image_info,image,ReadBinaryBlobMode,exception);
297 if (status == MagickFalse)
298 {
299 image=DestroyImageList(image);
300 return((Image *) NULL);
301 }
302 /*
303 Initialize image header.
304 */
305 (void) ResetMagickMemory(&fits_info,0,sizeof(fits_info));
306 fits_info.extend=MagickFalse;
307 fits_info.simple=MagickFalse;
308 fits_info.bits_per_pixel=8;
309 fits_info.columns=1;
310 fits_info.rows=1;
311 fits_info.rows=1;
312 fits_info.number_planes=1;
313 fits_info.min_data=0.0;
314 fits_info.max_data=0.0;
315 fits_info.zero=0.0;
316 fits_info.scale=1.0;
317 fits_info.endian=MSBEndian;
318 /*
319 Decode image header.
320 */
321 for (comment=(char *) NULL; EOFBlob(image) == MagickFalse; )
322 {
323 for ( ; EOFBlob(image) == MagickFalse; )
324 {
325 register char
326 *p;
327
328 count=ReadBlob(image,8,(unsigned char *) keyword);
329 if (count != 8)
330 break;
331 for (i=0; i < 8; i++)
332 {
333 if (isspace((int) ((unsigned char) keyword[i])) != 0)
334 break;
cristy466802f2010-02-24 14:18:37 +0000335 keyword[i]=tolower((int) ((unsigned char) keyword[i]));
cristy3ed852e2009-09-05 21:47:34 +0000336 }
337 keyword[i]='\0';
338 count=ReadBlob(image,72,(unsigned char *) value);
cristye3216eb2014-04-18 17:10:21 +0000339 value[72]='\0';
cristy3ed852e2009-09-05 21:47:34 +0000340 if (count != 72)
341 break;
cristy3ed852e2009-09-05 21:47:34 +0000342 p=value;
343 if (*p == '=')
344 {
345 p+=2;
346 while (isspace((int) ((unsigned char) *p)) != 0)
347 p++;
348 }
349 if (LocaleCompare(keyword,"end") == 0)
350 break;
351 if (LocaleCompare(keyword,"extend") == 0)
352 fits_info.extend=(*p == 'T') || (*p == 't') ? MagickTrue : MagickFalse;
353 if (LocaleCompare(keyword,"simple") == 0)
354 fits_info.simple=(*p == 'T') || (*p == 't') ? MagickTrue : MagickFalse;
355 if (LocaleCompare(keyword,"bitpix") == 0)
cristyf2f27272009-12-17 14:48:46 +0000356 fits_info.bits_per_pixel=StringToLong(p);
cristy3ed852e2009-09-05 21:47:34 +0000357 if (LocaleCompare(keyword,"naxis") == 0)
cristyf2f27272009-12-17 14:48:46 +0000358 fits_info.number_axes=StringToLong(p);
cristy3ed852e2009-09-05 21:47:34 +0000359 if (LocaleCompare(keyword,"naxis1") == 0)
cristyf2f27272009-12-17 14:48:46 +0000360 fits_info.columns=StringToLong(p);
cristy3ed852e2009-09-05 21:47:34 +0000361 if (LocaleCompare(keyword,"naxis2") == 0)
cristyf2f27272009-12-17 14:48:46 +0000362 fits_info.rows=StringToLong(p);
cristy3ed852e2009-09-05 21:47:34 +0000363 if (LocaleCompare(keyword,"naxis3") == 0)
cristyf2f27272009-12-17 14:48:46 +0000364 fits_info.number_planes=StringToLong(p);
cristy3ed852e2009-09-05 21:47:34 +0000365 if (LocaleCompare(keyword,"datamax") == 0)
cristydbdd0e32011-11-04 23:29:40 +0000366 fits_info.max_data=StringToDouble(p,(char **) NULL);
cristy3ed852e2009-09-05 21:47:34 +0000367 if (LocaleCompare(keyword,"datamin") == 0)
cristydbdd0e32011-11-04 23:29:40 +0000368 fits_info.min_data=StringToDouble(p,(char **) NULL);
cristy3ed852e2009-09-05 21:47:34 +0000369 if (LocaleCompare(keyword,"bzero") == 0)
cristydbdd0e32011-11-04 23:29:40 +0000370 fits_info.zero=StringToDouble(p,(char **) NULL);
cristy3ed852e2009-09-05 21:47:34 +0000371 if (LocaleCompare(keyword,"bscale") == 0)
cristydbdd0e32011-11-04 23:29:40 +0000372 fits_info.scale=StringToDouble(p,(char **) NULL);
cristy3ed852e2009-09-05 21:47:34 +0000373 if (LocaleCompare(keyword,"comment") == 0)
374 {
375 if (comment == (char *) NULL)
376 comment=ConstantString(p);
377 else
378 (void) ConcatenateString(&comment,p);
379 }
380 if (LocaleCompare(keyword,"xendian") == 0)
381 {
382 if (LocaleNCompare(p,"big",3) == 0)
383 fits_info.endian=MSBEndian;
384 else
385 fits_info.endian=LSBEndian;
386 }
cristyb51dff52011-05-19 16:55:47 +0000387 (void) FormatLocaleString(property,MaxTextExtent,"fits:%s",keyword);
cristyd15e6592011-10-15 00:13:06 +0000388 (void) SetImageProperty(image,property,p,exception);
cristy3ed852e2009-09-05 21:47:34 +0000389 }
390 c=0;
391 while (((TellBlob(image) % FITSBlocksize) != 0) && (c != EOF))
392 c=ReadBlobByte(image);
393 if (fits_info.extend == MagickFalse)
394 break;
cristy11dc2b82015-01-25 00:11:48 +0000395 if ((fits_info.bits_per_pixel != 8) && (fits_info.bits_per_pixel != 16) &&
396 (fits_info.bits_per_pixel != 32) && (fits_info.bits_per_pixel != 64) &&
397 (fits_info.bits_per_pixel != -32) && (fits_info.bits_per_pixel != -64))
398 ThrowReaderException(CorruptImageError,"ImproperImageHeader");
cristy3ed852e2009-09-05 21:47:34 +0000399 number_pixels=(MagickSizeType) fits_info.columns*fits_info.rows;
400 if ((fits_info.simple != MagickFalse) && (fits_info.number_axes >= 1) &&
401 (fits_info.number_axes <= 4) && (number_pixels != 0))
402 break;
403 }
404 /*
405 Verify that required image information is defined.
406 */
407 if (comment != (char *) NULL)
408 {
cristyd15e6592011-10-15 00:13:06 +0000409 (void) SetImageProperty(image,"comment",comment,exception);
cristy3ed852e2009-09-05 21:47:34 +0000410 comment=DestroyString(comment);
411 }
412 if (EOFBlob(image) != MagickFalse)
413 ThrowFileException(exception,CorruptImageError,"UnexpectedEndOfFile",
414 image->filename);
415 number_pixels=(MagickSizeType) fits_info.columns*fits_info.rows;
416 if ((fits_info.simple == MagickFalse) || (fits_info.number_axes < 1) ||
417 (fits_info.number_axes > 4) || (number_pixels == 0))
418 ThrowReaderException(CorruptImageError,"ImageTypeNotSupported");
cristybb503372010-05-27 20:51:26 +0000419 for (scene=0; scene < (ssize_t) fits_info.number_planes; scene++)
cristy3ed852e2009-09-05 21:47:34 +0000420 {
cristybb503372010-05-27 20:51:26 +0000421 image->columns=(size_t) fits_info.columns;
422 image->rows=(size_t) fits_info.rows;
423 image->depth=(size_t) (fits_info.bits_per_pixel < 0 ? -1 : 1)*
cristy3ed852e2009-09-05 21:47:34 +0000424 fits_info.bits_per_pixel;
425 image->endian=fits_info.endian;
cristybb503372010-05-27 20:51:26 +0000426 image->scene=(size_t) scene;
cristy3ed852e2009-09-05 21:47:34 +0000427 if ((image_info->ping != MagickFalse) && (image_info->number_scenes != 0))
428 if (image->scene >= (image_info->scene+image_info->number_scenes-1))
429 break;
cristyacabb842014-12-14 23:36:33 +0000430 status=SetImageExtent(image,image->columns,image->rows,exception);
431 if (status == MagickFalse)
432 return(DestroyImageList(image));
cristy3ed852e2009-09-05 21:47:34 +0000433 /*
434 Initialize image structure.
435 */
cristyd8b39812013-02-02 02:12:57 +0000436 (void) SetImageColorspace(image,GRAYColorspace,exception);
437 if ((fits_info.min_data == 0.0) && (fits_info.max_data == 0.0))
cristy3ed852e2009-09-05 21:47:34 +0000438 {
cristy3f6782c2013-02-06 01:33:50 +0000439 if (fits_info.zero == 0.0)
cristy4d0ca342014-05-01 00:42:09 +0000440 (void) GetFITSPixelExtrema(image,fits_info.bits_per_pixel,
cristyd8b39812013-02-02 02:12:57 +0000441 &fits_info.min_data,&fits_info.max_data);
442 else
cristybb503372010-05-27 20:51:26 +0000443 fits_info.max_data=GetFITSPixelRange((size_t)
cristy3ed852e2009-09-05 21:47:34 +0000444 fits_info.bits_per_pixel);
445 }
446 else
cristyd8b39812013-02-02 02:12:57 +0000447 fits_info.max_data=GetFITSPixelRange((size_t) fits_info.bits_per_pixel);
cristy3ed852e2009-09-05 21:47:34 +0000448 /*
449 Convert FITS pixels to pixel packets.
450 */
cristyd8b39812013-02-02 02:12:57 +0000451 scale=QuantumRange/(fits_info.max_data-fits_info.min_data);
cristybb503372010-05-27 20:51:26 +0000452 for (y=(ssize_t) image->rows-1; y >= 0; y--)
cristy3ed852e2009-09-05 21:47:34 +0000453 {
454 q=QueueAuthenticPixels(image,0,y,image->columns,1,exception);
cristyacd2ed22011-08-30 01:44:23 +0000455 if (q == (Quantum *) NULL)
cristy3ed852e2009-09-05 21:47:34 +0000456 break;
cristybb503372010-05-27 20:51:26 +0000457 for (x=0; x < (ssize_t) image->columns; x++)
cristy3ed852e2009-09-05 21:47:34 +0000458 {
459 pixel=GetFITSPixel(image,fits_info.bits_per_pixel);
cristy163d6782013-01-26 13:54:54 +0000460 if ((image->depth == 16) || (image->depth == 32) ||
cristy9dcadc52013-01-26 13:53:22 +0000461 (image->depth == 64))
cristyf84dc8e2013-02-02 16:46:26 +0000462 SetFITSUnsignedPixels(1,image->depth,image->endian,
463 (unsigned char *) &pixel);
cristy12142882012-06-17 00:52:29 +0000464 SetPixelGray(image,ClampToQuantum(scale*(fits_info.scale*(pixel-
465 fits_info.min_data)+fits_info.zero)),q);
cristyed231572011-07-14 02:18:59 +0000466 q+=GetPixelChannels(image);
cristy3ed852e2009-09-05 21:47:34 +0000467 }
468 if (SyncAuthenticPixels(image,exception) == MagickFalse)
469 break;
470 if (image->previous == (Image *) NULL)
471 {
cristycee97112010-05-28 00:44:52 +0000472 status=SetImageProgress(image,LoadImageTag,(MagickOffsetType) y,
cristy4c08aed2011-07-01 19:47:50 +0000473 image->rows);
cristy3ed852e2009-09-05 21:47:34 +0000474 if (status == MagickFalse)
475 break;
476 }
477 }
478 if (EOFBlob(image) != MagickFalse)
479 {
480 ThrowFileException(exception,CorruptImageError,"UnexpectedEndOfFile",
481 image->filename);
482 break;
483 }
484 /*
485 Proceed to next image.
486 */
487 if (image_info->number_scenes != 0)
488 if (image->scene >= (image_info->scene+image_info->number_scenes-1))
489 break;
cristybb503372010-05-27 20:51:26 +0000490 if (scene < (ssize_t) (fits_info.number_planes-1))
cristy3ed852e2009-09-05 21:47:34 +0000491 {
492 /*
493 Allocate next image structure.
494 */
cristy9950d572011-10-01 18:22:35 +0000495 AcquireNextImage(image_info,image,exception);
cristy3ed852e2009-09-05 21:47:34 +0000496 if (GetNextImageInList(image) == (Image *) NULL)
497 {
498 image=DestroyImageList(image);
499 return((Image *) NULL);
500 }
501 image=SyncNextImageInList(image);
502 status=SetImageProgress(image,LoadImagesTag,TellBlob(image),
503 GetBlobSize(image));
504 if (status == MagickFalse)
505 break;
506 }
507 }
508 (void) CloseBlob(image);
509 return(GetFirstImageInList(image));
510}
511
512/*
513%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
514% %
515% %
516% %
517% R e g i s t e r F I T S I m a g e %
518% %
519% %
520% %
521%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
522%
523% RegisterFITSImage() adds attributes for the FITS image format to
524% the list of supported formats. The attributes include the image format
525% tag, a method to read and/or write the format, whether the format
526% supports the saving of more than one frame to the same file or blob,
527% whether the format supports native in-memory I/O, and a brief
528% description of the format.
529%
530% The format of the RegisterFITSImage method is:
531%
cristybb503372010-05-27 20:51:26 +0000532% size_t RegisterFITSImage(void)
cristy3ed852e2009-09-05 21:47:34 +0000533%
534*/
cristybb503372010-05-27 20:51:26 +0000535ModuleExport size_t RegisterFITSImage(void)
cristy3ed852e2009-09-05 21:47:34 +0000536{
537 MagickInfo
538 *entry;
539
540 entry=SetMagickInfo("FITS");
541 entry->decoder=(DecodeImageHandler *) ReadFITSImage;
542 entry->encoder=(EncodeImageHandler *) WriteFITSImage;
543 entry->magick=(IsImageFormatHandler *) IsFITS;
544 entry->adjoin=MagickFalse;
545 entry->seekable_stream=MagickTrue;
546 entry->description=ConstantString("Flexible Image Transport System");
547 entry->module=ConstantString("FITS");
548 (void) RegisterMagickInfo(entry);
549 entry=SetMagickInfo("FTS");
550 entry->decoder=(DecodeImageHandler *) ReadFITSImage;
551 entry->encoder=(EncodeImageHandler *) WriteFITSImage;
552 entry->magick=(IsImageFormatHandler *) IsFITS;
553 entry->adjoin=MagickFalse;
554 entry->seekable_stream=MagickTrue;
555 entry->description=ConstantString("Flexible Image Transport System");
556 entry->module=ConstantString("FTS");
557 (void) RegisterMagickInfo(entry);
558 return(MagickImageCoderSignature);
559}
560
561/*
562%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
563% %
564% %
565% %
566% U n r e g i s t e r F I T S I m a g e %
567% %
568% %
569% %
570%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
571%
572% UnregisterFITSImage() removes format registrations made by the
573% FITS module from the list of supported formats.
574%
575% The format of the UnregisterFITSImage method is:
576%
577% UnregisterFITSImage(void)
578%
579*/
580ModuleExport void UnregisterFITSImage(void)
581{
582 (void) UnregisterMagickInfo("FITS");
583 (void) UnregisterMagickInfo("FTS");
584}
585
586/*
587%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
588% %
589% %
590% %
591% W r i t e F I T S I m a g e %
592% %
593% %
594% %
595%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
596%
597% WriteFITSImage() writes a Flexible Image Transport System image to a
598% file as gray scale intensities [0..255].
599%
600% The format of the WriteFITSImage method is:
601%
602% MagickBooleanType WriteFITSImage(const ImageInfo *image_info,
cristy1e178e72011-08-28 19:44:34 +0000603% Image *image,ExceptionInfo *exception)
cristy3ed852e2009-09-05 21:47:34 +0000604%
605% A description of each parameter follows.
606%
607% o image_info: the image info.
608%
609% o image: The image.
610%
cristy1e178e72011-08-28 19:44:34 +0000611% o exception: return any errors or warnings in this structure.
612%
cristy3ed852e2009-09-05 21:47:34 +0000613*/
614static MagickBooleanType WriteFITSImage(const ImageInfo *image_info,
cristy1e178e72011-08-28 19:44:34 +0000615 Image *image,ExceptionInfo *exception)
cristy3ed852e2009-09-05 21:47:34 +0000616{
617 char
618 header[FITSBlocksize],
619 *fits_info;
620
cristy3ed852e2009-09-05 21:47:34 +0000621 MagickBooleanType
622 status;
623
624 QuantumInfo
625 *quantum_info;
626
cristy4c08aed2011-07-01 19:47:50 +0000627 register const Quantum
cristy3ed852e2009-09-05 21:47:34 +0000628 *p;
629
630 size_t
631 length;
632
633 ssize_t
634 count,
cristy2692d592010-11-01 18:07:27 +0000635 offset,
636 y;
cristy3ed852e2009-09-05 21:47:34 +0000637
638 unsigned char
639 *pixels;
640
641 /*
642 Open output image file.
643 */
644 assert(image_info != (const ImageInfo *) NULL);
645 assert(image_info->signature == MagickSignature);
646 assert(image != (Image *) NULL);
647 assert(image->signature == MagickSignature);
648 if (image->debug != MagickFalse)
649 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
cristy3a37efd2011-08-28 20:31:03 +0000650 assert(exception != (ExceptionInfo *) NULL);
651 assert(exception->signature == MagickSignature);
cristy1e178e72011-08-28 19:44:34 +0000652 status=OpenBlob(image_info,image,WriteBinaryBlobMode,exception);
cristy3ed852e2009-09-05 21:47:34 +0000653 if (status == MagickFalse)
654 return(status);
cristyaf8d3912014-02-21 14:50:33 +0000655 (void) TransformImageColorspace(image,sRGBColorspace,exception);
cristy3ed852e2009-09-05 21:47:34 +0000656 /*
657 Allocate image memory.
658 */
659 fits_info=(char *) AcquireQuantumMemory(FITSBlocksize,sizeof(*fits_info));
660 if (fits_info == (char *) NULL)
661 ThrowWriterException(ResourceLimitError,"MemoryAllocationFailed");
662 (void) ResetMagickMemory(fits_info,' ',FITSBlocksize*sizeof(*fits_info));
663 /*
664 Initialize image header.
665 */
666 image->depth=GetImageQuantumDepth(image,MagickFalse);
cristy6ea44a92013-02-03 23:40:10 +0000667 image->endian=MSBEndian;
cristy5f766ef2014-12-14 21:12:47 +0000668 quantum_info=AcquireQuantumInfo(image_info,image);
cristy3ed852e2009-09-05 21:47:34 +0000669 if (quantum_info == (QuantumInfo *) NULL)
670 ThrowWriterException(ResourceLimitError,"MemoryAllocationFailed");
671 offset=0;
cristyb51dff52011-05-19 16:55:47 +0000672 (void) FormatLocaleString(header,FITSBlocksize,
cristy3ed852e2009-09-05 21:47:34 +0000673 "SIMPLE = T");
674 (void) strncpy(fits_info+offset,header,strlen(header));
675 offset+=80;
cristyb51dff52011-05-19 16:55:47 +0000676 (void) FormatLocaleString(header,FITSBlocksize,"BITPIX = %10ld",
cristy67e3eab2014-06-17 00:25:27 +0000677 (long) ((quantum_info->format == FloatingPointQuantumFormat ? -1 : 1)*
678 image->depth));
cristy3ed852e2009-09-05 21:47:34 +0000679 (void) strncpy(fits_info+offset,header,strlen(header));
680 offset+=80;
cristyb51dff52011-05-19 16:55:47 +0000681 (void) FormatLocaleString(header,FITSBlocksize,"NAXIS = %10lu",
cristy1e178e72011-08-28 19:44:34 +0000682 IsImageGray(image,exception) != MagickFalse ? 2UL : 3UL);
cristy3ed852e2009-09-05 21:47:34 +0000683 (void) strncpy(fits_info+offset,header,strlen(header));
684 offset+=80;
cristyb51dff52011-05-19 16:55:47 +0000685 (void) FormatLocaleString(header,FITSBlocksize,"NAXIS1 = %10lu",
cristyf2faecf2010-05-28 19:19:36 +0000686 (unsigned long) image->columns);
cristy3ed852e2009-09-05 21:47:34 +0000687 (void) strncpy(fits_info+offset,header,strlen(header));
688 offset+=80;
cristyb51dff52011-05-19 16:55:47 +0000689 (void) FormatLocaleString(header,FITSBlocksize,"NAXIS2 = %10lu",
cristyf2faecf2010-05-28 19:19:36 +0000690 (unsigned long) image->rows);
cristy3ed852e2009-09-05 21:47:34 +0000691 (void) strncpy(fits_info+offset,header,strlen(header));
692 offset+=80;
cristy1e178e72011-08-28 19:44:34 +0000693 if (IsImageGray(image,exception) == MagickFalse)
cristyfcbcae82011-04-22 12:53:27 +0000694 {
cristyb51dff52011-05-19 16:55:47 +0000695 (void) FormatLocaleString(header,FITSBlocksize,
cristyfcbcae82011-04-22 12:53:27 +0000696 "NAXIS3 = %10lu",3UL);
697 (void) strncpy(fits_info+offset,header,strlen(header));
698 offset+=80;
699 }
cristyb51dff52011-05-19 16:55:47 +0000700 (void) FormatLocaleString(header,FITSBlocksize,"BSCALE = %E",1.0);
cristy3ed852e2009-09-05 21:47:34 +0000701 (void) strncpy(fits_info+offset,header,strlen(header));
702 offset+=80;
cristyb51dff52011-05-19 16:55:47 +0000703 (void) FormatLocaleString(header,FITSBlocksize,"BZERO = %E",
cristy3ec9e8d2013-01-30 16:29:51 +0000704 image->depth > 8 ? GetFITSPixelRange(image->depth)/2.0 : 0.0);
cristy3ed852e2009-09-05 21:47:34 +0000705 (void) strncpy(fits_info+offset,header,strlen(header));
706 offset+=80;
cristyb51dff52011-05-19 16:55:47 +0000707 (void) FormatLocaleString(header,FITSBlocksize,"DATAMAX = %E",
cristy3ed852e2009-09-05 21:47:34 +0000708 1.0*((MagickOffsetType) GetQuantumRange(image->depth)));
709 (void) strncpy(fits_info+offset,header,strlen(header));
710 offset+=80;
cristyb51dff52011-05-19 16:55:47 +0000711 (void) FormatLocaleString(header,FITSBlocksize,"DATAMIN = %E",0.0);
cristy3ed852e2009-09-05 21:47:34 +0000712 (void) strncpy(fits_info+offset,header,strlen(header));
713 offset+=80;
714 if (image->endian == LSBEndian)
715 {
cristyb51dff52011-05-19 16:55:47 +0000716 (void) FormatLocaleString(header,FITSBlocksize,"XENDIAN = 'SMALL'");
cristy3ed852e2009-09-05 21:47:34 +0000717 (void) strncpy(fits_info+offset,header,strlen(header));
718 offset+=80;
719 }
cristyb51dff52011-05-19 16:55:47 +0000720 (void) FormatLocaleString(header,FITSBlocksize,"HISTORY %.72s",
cristybb503372010-05-27 20:51:26 +0000721 GetMagickVersion((size_t *) NULL));
cristy3ed852e2009-09-05 21:47:34 +0000722 (void) strncpy(fits_info+offset,header,strlen(header));
723 offset+=80;
724 (void) strncpy(header,"END",FITSBlocksize);
725 (void) strncpy(fits_info+offset,header,strlen(header));
726 offset+=80;
727 (void) WriteBlob(image,FITSBlocksize,(unsigned char *) fits_info);
728 /*
729 Convert image to fits scale PseudoColor class.
730 */
731 pixels=GetQuantumPixels(quantum_info);
cristy1e178e72011-08-28 19:44:34 +0000732 if (IsImageGray(image,exception) != MagickFalse)
cristyfcbcae82011-04-22 12:53:27 +0000733 {
734 length=GetQuantumExtent(image,quantum_info,GrayQuantum);
735 for (y=(ssize_t) image->rows-1; y >= 0; y--)
736 {
cristy1e178e72011-08-28 19:44:34 +0000737 p=GetVirtualPixels(image,0,y,image->columns,1,exception);
cristy4c08aed2011-07-01 19:47:50 +0000738 if (p == (const Quantum *) NULL)
cristyfcbcae82011-04-22 12:53:27 +0000739 break;
cristy4c08aed2011-07-01 19:47:50 +0000740 length=ExportQuantumPixels(image,(CacheView *) NULL,quantum_info,
cristy1e178e72011-08-28 19:44:34 +0000741 GrayQuantum,pixels,exception);
cristyfcbcae82011-04-22 12:53:27 +0000742 if (image->depth == 16)
cristyf84dc8e2013-02-02 16:46:26 +0000743 SetFITSUnsignedPixels(image->columns,image->depth,image->endian,
744 pixels);
cristyfcbcae82011-04-22 12:53:27 +0000745 if (((image->depth == 32) || (image->depth == 64)) &&
746 (quantum_info->format != FloatingPointQuantumFormat))
cristyf84dc8e2013-02-02 16:46:26 +0000747 SetFITSUnsignedPixels(image->columns,image->depth,image->endian,
748 pixels);
cristyfcbcae82011-04-22 12:53:27 +0000749 count=WriteBlob(image,length,pixels);
750 if (count != (ssize_t) length)
751 break;
752 status=SetImageProgress(image,SaveImageTag,(MagickOffsetType) y,
753 image->rows);
754 if (status == MagickFalse)
755 break;
756 }
757 }
758 else
759 {
760 length=GetQuantumExtent(image,quantum_info,RedQuantum);
761 for (y=(ssize_t) image->rows-1; y >= 0; y--)
762 {
cristy1e178e72011-08-28 19:44:34 +0000763 p=GetVirtualPixels(image,0,y,image->columns,1,exception);
cristy4c08aed2011-07-01 19:47:50 +0000764 if (p == (const Quantum *) NULL)
cristyfcbcae82011-04-22 12:53:27 +0000765 break;
cristy4c08aed2011-07-01 19:47:50 +0000766 length=ExportQuantumPixels(image,(CacheView *) NULL,quantum_info,
cristy1e178e72011-08-28 19:44:34 +0000767 RedQuantum,pixels,exception);
cristyfcbcae82011-04-22 12:53:27 +0000768 if (image->depth == 16)
cristyf84dc8e2013-02-02 16:46:26 +0000769 SetFITSUnsignedPixels(image->columns,image->depth,image->endian,
770 pixels);
cristyfcbcae82011-04-22 12:53:27 +0000771 if (((image->depth == 32) || (image->depth == 64)) &&
772 (quantum_info->format != FloatingPointQuantumFormat))
cristyf84dc8e2013-02-02 16:46:26 +0000773 SetFITSUnsignedPixels(image->columns,image->depth,image->endian,
774 pixels);
cristyfcbcae82011-04-22 12:53:27 +0000775 count=WriteBlob(image,length,pixels);
776 if (count != (ssize_t) length)
777 break;
778 status=SetImageProgress(image,SaveImageTag,(MagickOffsetType) y,
779 image->rows);
780 if (status == MagickFalse)
781 break;
782 }
783 length=GetQuantumExtent(image,quantum_info,GreenQuantum);
784 for (y=(ssize_t) image->rows-1; y >= 0; y--)
785 {
cristy1e178e72011-08-28 19:44:34 +0000786 p=GetVirtualPixels(image,0,y,image->columns,1,exception);
cristy4c08aed2011-07-01 19:47:50 +0000787 if (p == (const Quantum *) NULL)
cristyfcbcae82011-04-22 12:53:27 +0000788 break;
cristy4c08aed2011-07-01 19:47:50 +0000789 length=ExportQuantumPixels(image,(CacheView *) NULL,quantum_info,
cristy1e178e72011-08-28 19:44:34 +0000790 GreenQuantum,pixels,exception);
cristyfcbcae82011-04-22 12:53:27 +0000791 if (image->depth == 16)
cristyf84dc8e2013-02-02 16:46:26 +0000792 SetFITSUnsignedPixels(image->columns,image->depth,image->endian,
793 pixels);
cristyfcbcae82011-04-22 12:53:27 +0000794 if (((image->depth == 32) || (image->depth == 64)) &&
795 (quantum_info->format != FloatingPointQuantumFormat))
cristyf84dc8e2013-02-02 16:46:26 +0000796 SetFITSUnsignedPixels(image->columns,image->depth,image->endian,
797 pixels);
cristyfcbcae82011-04-22 12:53:27 +0000798 count=WriteBlob(image,length,pixels);
799 if (count != (ssize_t) length)
800 break;
801 status=SetImageProgress(image,SaveImageTag,(MagickOffsetType) y,
802 image->rows);
803 if (status == MagickFalse)
804 break;
805 }
806 length=GetQuantumExtent(image,quantum_info,BlueQuantum);
807 for (y=(ssize_t) image->rows-1; y >= 0; y--)
808 {
cristy1e178e72011-08-28 19:44:34 +0000809 p=GetVirtualPixels(image,0,y,image->columns,1,exception);
cristy4c08aed2011-07-01 19:47:50 +0000810 if (p == (const Quantum *) NULL)
cristyfcbcae82011-04-22 12:53:27 +0000811 break;
cristy4c08aed2011-07-01 19:47:50 +0000812 length=ExportQuantumPixels(image,(CacheView *) NULL,quantum_info,
cristy1e178e72011-08-28 19:44:34 +0000813 BlueQuantum,pixels,exception);
cristyfcbcae82011-04-22 12:53:27 +0000814 if (image->depth == 16)
cristyf84dc8e2013-02-02 16:46:26 +0000815 SetFITSUnsignedPixels(image->columns,image->depth,image->endian,
816 pixels);
cristyfcbcae82011-04-22 12:53:27 +0000817 if (((image->depth == 32) || (image->depth == 64)) &&
818 (quantum_info->format != FloatingPointQuantumFormat))
cristyf84dc8e2013-02-02 16:46:26 +0000819 SetFITSUnsignedPixels(image->columns,image->depth,image->endian,
820 pixels);
cristyfcbcae82011-04-22 12:53:27 +0000821 count=WriteBlob(image,length,pixels);
822 if (count != (ssize_t) length)
823 break;
824 status=SetImageProgress(image,SaveImageTag,(MagickOffsetType) y,
825 image->rows);
826 if (status == MagickFalse)
827 break;
828 }
829 }
cristy3ed852e2009-09-05 21:47:34 +0000830 quantum_info=DestroyQuantumInfo(quantum_info);
831 length=(size_t) (FITSBlocksize-TellBlob(image) % FITSBlocksize);
832 if (length != 0)
833 {
834 (void) ResetMagickMemory(fits_info,0,length*sizeof(*fits_info));
835 (void) WriteBlob(image,length,(unsigned char *) fits_info);
836 }
837 fits_info=DestroyString(fits_info);
838 (void) CloseBlob(image);
839 return(MagickTrue);
840}