2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
5 % M M AAA TTTTT L AAA BBBB %
6 % MM MM A A T L A A B B %
7 % M M M AAAAA T L AAAAA BBBB %
8 % M M A A T L A A B B %
9 % M M A A T LLLLL A A BBBB %
12 % Read MATLAB Image Format %
19 % Permission is hereby granted, free of charge, to any person obtaining a %
20 % copy of this software and associated documentation files ("ImageMagick"), %
21 % to deal in ImageMagick without restriction, including without limitation %
22 % the rights to use, copy, modify, merge, publish, distribute, sublicense, %
23 % and/or sell copies of ImageMagick, and to permit persons to whom the %
24 % ImageMagick is furnished to do so, subject to the following conditions: %
26 % The above copyright notice and this permission notice shall be included in %
27 % all copies or substantial portions of ImageMagick. %
29 % The software is provided "as is", without warranty of any kind, express or %
30 % implied, including but not limited to the warranties of merchantability, %
31 % fitness for a particular purpose and noninfringement. In no event shall %
32 % ImageMagick Studio be liable for any claim, damages or other liability, %
33 % whether in an action of contract, tort or otherwise, arising from, out of %
34 % or in connection with ImageMagick or the use or other dealings in %
37 % Except as contained in this notice, the name of the ImageMagick Studio %
38 % shall not be used in advertising or otherwise to promote the sale, use or %
39 % other dealings in ImageMagick without prior written authorization from the %
40 % ImageMagick Studio. %
42 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
50 #include "MagickCore/studio.h"
51 #include "MagickCore/attribute.h"
52 #include "MagickCore/blob.h"
53 #include "MagickCore/blob-private.h"
54 #include "MagickCore/cache.h"
55 #include "MagickCore/color-private.h"
56 #include "MagickCore/colormap.h"
57 #include "MagickCore/colorspace-private.h"
58 #include "MagickCore/distort.h"
59 #include "MagickCore/exception.h"
60 #include "MagickCore/exception-private.h"
61 #include "MagickCore/image.h"
62 #include "MagickCore/image-private.h"
63 #include "MagickCore/list.h"
64 #include "MagickCore/magick.h"
65 #include "MagickCore/memory_.h"
66 #include "MagickCore/monitor.h"
67 #include "MagickCore/monitor-private.h"
68 #include "MagickCore/pixel-accessor.h"
69 #include "MagickCore/quantum.h"
70 #include "MagickCore/quantum-private.h"
71 #include "MagickCore/option.h"
72 #include "MagickCore/pixel.h"
73 #include "MagickCore/resource_.h"
74 #include "MagickCore/static.h"
75 #include "MagickCore/string_.h"
76 #include "MagickCore/module.h"
77 #include "MagickCore/transform.h"
78 #include "MagickCore/utility-private.h"
79 #if defined(MAGICKCORE_ZLIB_DELEGATE)
86 static MagickBooleanType
87 WriteMATImage(const ImageInfo *,Image *,ExceptionInfo *);
90 /* Auto coloring method, sorry this creates some artefact inside data
91 MinReal+j*MaxComplex = red MaxReal+j*MaxComplex = black
92 MinReal+j*0 = white MaxReal+j*0 = black
93 MinReal+j*MinComplex = blue MaxReal+j*MinComplex = black
99 unsigned short Version;
100 char EndianIndicator[2];
101 unsigned long DataType;
102 unsigned long ObjectSize;
103 unsigned long unknown1;
104 unsigned long unknown2;
106 unsigned short unknown5;
107 unsigned char StructureFlag;
108 unsigned char StructureClass;
109 unsigned long unknown3;
110 unsigned long unknown4;
111 unsigned long DimFlag;
115 unsigned short Flag1;
116 unsigned short NameFlag;
120 static const char *MonthsTab[12]={"Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"};
121 static const char *DayOfWTab[7]={"Sun","Mon","Tue","Wed","Thu","Fri","Sat"};
122 static const char *OsDesc=
123 #if defined(MAGICKCORE_WINDOWS_SUPPORT)
135 miINT8 = 1, /* 8 bit signed */
136 miUINT8, /* 8 bit unsigned */
137 miINT16, /* 16 bit signed */
138 miUINT16, /* 16 bit unsigned */
139 miINT32, /* 32 bit signed */
140 miUINT32, /* 32 bit unsigned */
141 miSINGLE, /* IEEE 754 single precision float */
143 miDOUBLE, /* IEEE 754 double precision float */
146 miINT64, /* 64 bit signed */
147 miUINT64, /* 64 bit unsigned */
148 miMATRIX, /* MATLAB array */
149 miCOMPRESSED, /* Compressed Data */
150 miUTF8, /* Unicode UTF-8 Encoded Character Data */
151 miUTF16, /* Unicode UTF-16 Encoded Character Data */
152 miUTF32 /* Unicode UTF-32 Encoded Character Data */
157 mxCELL_CLASS=1, /* cell array */
158 mxSTRUCT_CLASS, /* structure */
159 mxOBJECT_CLASS, /* object */
160 mxCHAR_CLASS, /* character array */
161 mxSPARSE_CLASS, /* sparse array */
162 mxDOUBLE_CLASS, /* double precision array */
163 mxSINGLE_CLASS, /* single precision floating point */
164 mxINT8_CLASS, /* 8 bit signed integer */
165 mxUINT8_CLASS, /* 8 bit unsigned integer */
166 mxINT16_CLASS, /* 16 bit signed integer */
167 mxUINT16_CLASS, /* 16 bit unsigned integer */
168 mxINT32_CLASS, /* 32 bit signed integer */
169 mxUINT32_CLASS, /* 32 bit unsigned integer */
170 mxINT64_CLASS, /* 64 bit signed integer */
171 mxUINT64_CLASS, /* 64 bit unsigned integer */
172 mxFUNCTION_CLASS /* Function handle */
175 #define FLAG_COMPLEX 0x8
176 #define FLAG_GLOBAL 0x4
177 #define FLAG_LOGICAL 0x2
179 static const QuantumType z2qtype[4] = {GrayQuantum, BlueQuantum, GreenQuantum, RedQuantum};
182 static void InsertComplexDoubleRow(Image *image,double *p,int y,double MinVal,
183 double MaxVal,ExceptionInfo *exception)
195 q=QueueAuthenticPixels(image,0,y,image->columns,1,exception);
196 if (q == (Quantum *) NULL)
198 for (x = 0; x < (ssize_t) image->columns; x++)
202 f = (*p / MaxVal) * (QuantumRange-GetPixelRed(image,q));
203 if (f + GetPixelRed(image,q) > QuantumRange)
204 SetPixelRed(image,QuantumRange,q);
206 SetPixelRed(image,GetPixelRed(image,q)+(int) f,q);
207 if ((int) f / 2.0 > GetPixelGreen(image,q))
209 SetPixelGreen(image,0,q);
210 SetPixelBlue(image,0,q);
214 SetPixelBlue(image,GetPixelBlue(image,q)-(int) (f/2.0),q);
215 SetPixelGreen(image,GetPixelBlue(image,q),q);
220 f = (*p / MaxVal) * (QuantumRange-GetPixelBlue(image,q));
221 if (f+GetPixelBlue(image,q) > QuantumRange)
222 SetPixelBlue(image,QuantumRange,q);
224 SetPixelBlue(image,GetPixelBlue(image,q)+(int) f,q);
225 if ((int) f / 2.0 > GetPixelGreen(image,q))
227 SetPixelRed(image,0,q);
228 SetPixelGreen(image,0,q);
232 SetPixelRed(image,GetPixelRed(image,q)-(int) (f/2.0),q);
233 SetPixelGreen(image,GetPixelRed(image,q),q);
237 q+=GetPixelChannels(image);
239 if (!SyncAuthenticPixels(image,exception))
245 static void InsertComplexFloatRow(Image *image,float *p,int y,double MinVal,
246 double MaxVal,ExceptionInfo *exception)
257 q = QueueAuthenticPixels(image, 0, y, image->columns, 1,exception);
258 if (q == (Quantum *) NULL)
260 for (x = 0; x < (ssize_t) image->columns; x++)
264 f = (*p / MaxVal) * (QuantumRange-GetPixelRed(image,q));
265 if (f+GetPixelRed(image,q) > QuantumRange)
266 SetPixelRed(image,QuantumRange,q);
268 SetPixelRed(image,GetPixelRed(image,q)+(int) f,q);
269 if ((int) f / 2.0 > GetPixelGreen(image,q))
271 SetPixelGreen(image,0,q);
272 SetPixelBlue(image,0,q);
276 SetPixelBlue(image,GetPixelBlue(image,q)-(int) (f/2.0),q);
277 SetPixelGreen(image,GetPixelBlue(image,q),q);
282 f = (*p / MaxVal) * (QuantumRange - GetPixelBlue(image,q));
283 if (f + GetPixelBlue(image,q) > QuantumRange)
284 SetPixelBlue(image,QuantumRange,q);
286 SetPixelBlue(image,GetPixelBlue(image,q)+
288 if ((int) f / 2.0 > GetPixelGreen(image,q))
290 SetPixelGreen(image,0,q);
291 SetPixelRed(image,0,q);
295 SetPixelRed(image,GetPixelRed(image,q)-(int) (f/2.0),q);
296 SetPixelGreen(image,GetPixelRed(image,q),q);
302 if (!SyncAuthenticPixels(image,exception))
308 /************** READERS ******************/
310 /* This function reads one block of floats*/
311 static void ReadBlobFloatsLSB(Image * image, size_t len, float *data)
315 *data++ = ReadBlobFloat(image);
316 len -= sizeof(float);
319 (void) SeekBlob(image, len, SEEK_CUR);
322 static void ReadBlobFloatsMSB(Image * image, size_t len, float *data)
326 *data++ = ReadBlobFloat(image);
327 len -= sizeof(float);
330 (void) SeekBlob(image, len, SEEK_CUR);
333 /* This function reads one block of doubles*/
334 static void ReadBlobDoublesLSB(Image * image, size_t len, double *data)
338 *data++ = ReadBlobDouble(image);
339 len -= sizeof(double);
342 (void) SeekBlob(image, len, SEEK_CUR);
345 static void ReadBlobDoublesMSB(Image * image, size_t len, double *data)
349 *data++ = ReadBlobDouble(image);
350 len -= sizeof(double);
353 (void) SeekBlob(image, len, SEEK_CUR);
356 /* Calculate minimum and maximum from a given block of data */
357 static void CalcMinMax(Image *image, int endian_indicator, int SizeX, int SizeY, size_t CellType, unsigned ldblk, void *BImgBuff, double *Min, double *Max)
359 MagickOffsetType filepos;
361 void (*ReadBlobDoublesXXX)(Image * image, size_t len, double *data);
362 void (*ReadBlobFloatsXXX)(Image * image, size_t len, float *data);
366 if (endian_indicator == LSBEndian)
368 ReadBlobDoublesXXX = ReadBlobDoublesLSB;
369 ReadBlobFloatsXXX = ReadBlobFloatsLSB;
373 ReadBlobDoublesXXX = ReadBlobDoublesMSB;
374 ReadBlobFloatsXXX = ReadBlobFloatsMSB;
377 filepos = TellBlob(image); /* Please note that file seeking occurs only in the case of doubles */
378 for (i = 0; i < SizeY; i++)
380 if (CellType==miDOUBLE)
382 ReadBlobDoublesXXX(image, ldblk, (double *)BImgBuff);
383 dblrow = (double *)BImgBuff;
386 *Min = *Max = *dblrow;
388 for (x = 0; x < SizeX; x++)
397 if (CellType==miSINGLE)
399 ReadBlobFloatsXXX(image, ldblk, (float *)BImgBuff);
400 fltrow = (float *)BImgBuff;
403 *Min = *Max = *fltrow;
405 for (x = 0; x < (ssize_t) SizeX; x++)
415 (void) SeekBlob(image, filepos, SEEK_SET);
419 static void FixSignedValues(const Image *image,Quantum *q, int y)
423 /* Please note that negative values will overflow
424 Q=8; QuantumRange=255: <0;127> + 127+1 = <128; 255>
425 <-1;-128> + 127+1 = <0; 127> */
426 SetPixelRed(image,GetPixelRed(image,q)+QuantumRange/2+1,q);
427 SetPixelGreen(image,GetPixelGreen(image,q)+QuantumRange/2+1,q);
428 SetPixelBlue(image,GetPixelBlue(image,q)+QuantumRange/2+1,q);
434 /** Fix whole row of logical/binary data. It means pack it. */
435 static void FixLogical(unsigned char *Buff,int ldblk)
437 unsigned char mask=128;
438 unsigned char *BuffL = Buff;
439 unsigned char val = 0;
458 #if defined(MAGICKCORE_ZLIB_DELEGATE)
459 static voidpf AcquireZIPMemory(voidpf context,unsigned int items,
463 return((voidpf) AcquireQuantumMemory(items,size));
466 static void RelinquishZIPMemory(voidpf context,voidpf memory)
469 memory=RelinquishMagickMemory(memory);
473 #if defined(MAGICKCORE_ZLIB_DELEGATE)
474 /** This procedure decompreses an image block for a new MATLAB format. */
475 static Image *DecompressBlock(Image *orig, MagickOffsetType Size, ImageInfo *clone_info, ExceptionInfo *exception)
479 void *CacheBlock, *DecompressBlock;
489 if(clone_info==NULL) return NULL;
490 if(clone_info->file) /* Close file opened from previous transaction. */
492 fclose(clone_info->file);
493 clone_info->file = NULL;
494 (void) remove_utf8(clone_info->filename);
497 CacheBlock = AcquireQuantumMemory((size_t)((Size<16384)?Size:16384),sizeof(unsigned char *));
498 if(CacheBlock==NULL) return NULL;
499 DecompressBlock = AcquireQuantumMemory((size_t)(4096),sizeof(unsigned char *));
500 if(DecompressBlock==NULL)
502 RelinquishMagickMemory(CacheBlock);
507 file = AcquireUniqueFileResource(clone_info->filename);
509 mat_file = fdopen(file,"w");
512 RelinquishMagickMemory(CacheBlock);
513 RelinquishMagickMemory(DecompressBlock);
514 (void) LogMagickEvent(CoderEvent,GetMagickModule(),"Cannot create file stream for decompressed image");
518 zip_info.zalloc=AcquireZIPMemory;
519 zip_info.zfree=RelinquishZIPMemory;
520 zip_info.opaque = (voidpf) NULL;
521 zip_status = inflateInit(&zip_info);
522 if (zip_status != Z_OK)
524 RelinquishMagickMemory(CacheBlock);
525 RelinquishMagickMemory(DecompressBlock);
526 (void) ThrowMagickException(exception,GetMagickModule(),CorruptImageError,
527 "UnableToUncompressImage","`%s'",clone_info->filename);
528 (void) fclose(mat_file);
529 RelinquishUniqueFileResource(clone_info->filename);
532 /* zip_info.next_out = 8*4;*/
534 zip_info.avail_in = 0;
535 zip_info.total_out = 0;
536 while(Size>0 && !EOFBlob(orig))
538 magick_size = ReadBlob(orig, (Size<16384)?Size:16384, (unsigned char *) CacheBlock);
539 zip_info.next_in = (Bytef *) CacheBlock;
540 zip_info.avail_in = (uInt) magick_size;
542 while(zip_info.avail_in>0)
544 zip_info.avail_out = 4096;
545 zip_info.next_out = (Bytef *) DecompressBlock;
546 zip_status = inflate(&zip_info,Z_NO_FLUSH);
547 if ((zip_status != Z_OK) && (zip_status != Z_STREAM_END))
549 extent=fwrite(DecompressBlock, 4096-zip_info.avail_out, 1, mat_file);
552 if(zip_status == Z_STREAM_END) goto DblBreak;
554 if ((zip_status != Z_OK) && (zip_status != Z_STREAM_END))
561 inflateEnd(&zip_info);
562 (void)fclose(mat_file);
563 RelinquishMagickMemory(CacheBlock);
564 RelinquishMagickMemory(DecompressBlock);
566 if((clone_info->file=fopen(clone_info->filename,"rb"))==NULL) goto UnlinkFile;
567 if( (image2 = AcquireImage(clone_info,exception))==NULL ) goto EraseFile;
568 status = OpenBlob(clone_info,image2,ReadBinaryBlobMode,exception);
569 if (status == MagickFalse)
571 DeleteImageFromList(&image2);
573 fclose(clone_info->file);
574 clone_info->file = NULL;
576 RelinquishUniqueFileResource(clone_info->filename);
584 static Image *ReadMATImageV4(const ImageInfo *image_info,Image *image,
585 ExceptionInfo *exception)
588 unsigned char Type[4];
592 unsigned int nameLen;
630 quantum_info=(QuantumInfo *) NULL;
631 (void) SeekBlob(image,0,SEEK_SET);
632 while (EOFBlob(image) != MagickFalse)
637 ldblk=ReadBlobLSBLong(image);
638 if ((ldblk > 9999) || (ldblk < 0))
640 HDR.Type[3]=ldblk % 10; ldblk /= 10; /* T digit */
641 HDR.Type[2]=ldblk % 10; ldblk /= 10; /* P digit */
642 HDR.Type[1]=ldblk % 10; ldblk /= 10; /* O digit */
643 HDR.Type[0]=ldblk; /* M digit */
644 if (HDR.Type[3] != 0)
645 break; /* Data format */
646 if (HDR.Type[2] != 0)
647 break; /* Always 0 */
648 if (HDR.Type[0] == 0)
650 HDR.nRows=ReadBlobLSBLong(image);
651 HDR.nCols=ReadBlobLSBLong(image);
652 HDR.imagf=ReadBlobLSBLong(image);
653 HDR.nameLen=ReadBlobLSBLong(image);
658 HDR.nRows=ReadBlobMSBLong(image);
659 HDR.nCols=ReadBlobMSBLong(image);
660 HDR.imagf=ReadBlobMSBLong(image);
661 HDR.nameLen=ReadBlobMSBLong(image);
664 if ((HDR.imagf != 0) && (HDR.imagf != 1))
666 if (HDR.nameLen > 0xFFFF)
667 return((Image *) NULL);
668 for (i=0; i < (ssize_t) HDR.nameLen; i++)
676 byte=ReadBlobByte(image);
679 ThrowFileException(exception,CorruptImageError,"UnexpectedEndOfFile",
684 image->columns=(size_t) HDR.nRows;
685 image->rows=(size_t) HDR.nCols;
686 SetImageColorspace(image,GRAYColorspace,exception);
687 if (image_info->ping != MagickFalse)
689 Swap(image->columns,image->rows);
692 status=SetImageExtent(image,image->columns,image->rows,exception);
693 if (status == MagickFalse)
694 return((Image *) NULL);
695 quantum_info=AcquireQuantumInfo(image_info,image);
696 if (quantum_info == (QuantumInfo *) NULL)
697 return((Image *) NULL);
701 format_type=FloatingPointQuantumFormat;
705 format_type=FloatingPointQuantumFormat;
709 format_type=UnsignedQuantumFormat;
713 format_type=SignedQuantumFormat;
717 format_type=UnsignedQuantumFormat;
721 format_type=UnsignedQuantumFormat;
726 if (HDR.Type[0] != 0)
727 SetQuantumEndian(image,quantum_info,MSBEndian);
728 status=SetQuantumFormat(image,quantum_info,format_type);
729 status=SetQuantumDepth(image,quantum_info,depth);
730 status=SetQuantumEndian(image,quantum_info,endian);
731 SetQuantumScale(quantum_info,1.0);
732 pixels=(unsigned char *) GetQuantumPixels(quantum_info);
733 for (y=0; y < (ssize_t) image->rows; y++)
741 count=ReadBlob(image,depth/8*image->columns,(char *) pixels);
744 q=QueueAuthenticPixels(image,0,image->rows-y-1,image->columns,1,
746 if (q == (Quantum *) NULL)
748 (void) ImportQuantumPixels(image,(CacheView *) NULL,quantum_info,
749 GrayQuantum,pixels,exception);
750 if ((HDR.Type[1] == 2) || (HDR.Type[1] == 3))
751 FixSignedValues(image,q,(int) image->columns);
752 if (SyncAuthenticPixels(image,exception) == MagickFalse)
754 if (image->previous == (Image *) NULL)
756 status=SetImageProgress(image,LoadImageTag,(MagickOffsetType) y,
758 if (status == MagickFalse)
763 for (y=0; y < (ssize_t) image->rows; y++)
768 count=ReadBlob(image,depth/8*image->columns,(char *) pixels);
771 if (HDR.Type[1] == 0)
772 InsertComplexDoubleRow(image,(double *) pixels,y,0,0,exception);
774 InsertComplexFloatRow(image,(float *) pixels,y,0,0,exception);
776 if (quantum_info != (QuantumInfo *) NULL)
777 quantum_info=DestroyQuantumInfo(quantum_info);
778 rotate_image=RotateImage(image,90.0,exception);
779 if (rotate_image != (Image *) NULL)
781 image=DestroyImage(image);
784 if (EOFBlob(image) != MagickFalse)
786 ThrowFileException(exception,CorruptImageError,"UnexpectedEndOfFile",
791 Proceed to next image.
793 if (image_info->number_scenes != 0)
794 if (image->scene >= (image_info->scene+image_info->number_scenes-1))
797 Allocate next image structure.
799 AcquireNextImage(image_info,image,exception);
800 if (GetNextImageInList(image) == (Image *) NULL)
802 image=DestroyImageList(image);
803 return((Image *) NULL);
805 image=SyncNextImageInList(image);
806 status=SetImageProgress(image,LoadImagesTag,TellBlob(image),
808 if (status == MagickFalse)
811 (void) CloseBlob(image);
812 return(GetFirstImageInList(image));
816 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
820 % R e a d M A T L A B i m a g e %
824 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
826 % ReadMATImage() reads an MAT X image file and returns it. It
827 % allocates the memory necessary for the new Image structure and returns a
828 % pointer to the new image.
830 % The format of the ReadMATImage method is:
832 % Image *ReadMATImage(const ImageInfo *image_info,ExceptionInfo *exception)
834 % A description of each parameter follows:
836 % o image: Method ReadMATImage returns a pointer to the image after
837 % reading. A null image is returned if there is a memory shortage or if
838 % the image cannot be read.
840 % o image_info: Specifies a pointer to a ImageInfo structure.
842 % o exception: return any errors or warnings in this structure.
845 static Image *ReadMATImage(const ImageInfo *image_info,ExceptionInfo *exception)
847 Image *image, *image2=NULL,
852 MATHeader MATLAB_HDR;
855 QuantumInfo *quantum_info;
856 ImageInfo *clone_info;
859 unsigned char *BImgBuff = NULL;
860 double MinVal, MaxVal;
865 MagickOffsetType filepos=0x80;
869 unsigned int (*ReadBlobXXXLong)(Image *image);
870 unsigned short (*ReadBlobXXXShort)(Image *image);
871 void (*ReadBlobDoublesXXX)(Image * image, size_t len, double *data);
872 void (*ReadBlobFloatsXXX)(Image * image, size_t len, float *data);
875 assert(image_info != (const ImageInfo *) NULL);
876 assert(image_info->signature == MagickCoreSignature);
877 assert(exception != (ExceptionInfo *) NULL);
878 assert(exception->signature == MagickCoreSignature);
879 logging = LogMagickEvent(CoderEvent,GetMagickModule(),"enter");
884 image = AcquireImage(image_info,exception);
886 status = OpenBlob(image_info, image, ReadBinaryBlobMode, exception);
887 if (status == MagickFalse)
889 image=DestroyImageList(image);
890 return((Image *) NULL);
895 quantum_info=(QuantumInfo *) NULL;
896 clone_info=CloneImageInfo(image_info);
897 if (ReadBlob(image,124,(unsigned char *) &MATLAB_HDR.identific) != 124)
898 ThrowReaderException(CorruptImageError,"ImproperImageHeader");
899 if (strncmp(MATLAB_HDR.identific,"MATLAB",6) != 0)
901 image2=ReadMATImageV4(image_info,image,exception);
907 MATLAB_HDR.Version = ReadBlobLSBShort(image);
908 if(ReadBlob(image,2,(unsigned char *) &MATLAB_HDR.EndianIndicator) != 2)
909 ThrowReaderException(CorruptImageError,"ImproperImageHeader");
912 (void) LogMagickEvent(CoderEvent,GetMagickModule()," Endian %c%c",
913 MATLAB_HDR.EndianIndicator[0],MATLAB_HDR.EndianIndicator[1]);
914 if (!strncmp(MATLAB_HDR.EndianIndicator, "IM", 2))
916 ReadBlobXXXLong = ReadBlobLSBLong;
917 ReadBlobXXXShort = ReadBlobLSBShort;
918 ReadBlobDoublesXXX = ReadBlobDoublesLSB;
919 ReadBlobFloatsXXX = ReadBlobFloatsLSB;
920 image->endian = LSBEndian;
922 else if (!strncmp(MATLAB_HDR.EndianIndicator, "MI", 2))
924 ReadBlobXXXLong = ReadBlobMSBLong;
925 ReadBlobXXXShort = ReadBlobMSBShort;
926 ReadBlobDoublesXXX = ReadBlobDoublesMSB;
927 ReadBlobFloatsXXX = ReadBlobFloatsMSB;
928 image->endian = MSBEndian;
931 goto MATLAB_KO; /* unsupported endian */
933 if (strncmp(MATLAB_HDR.identific, "MATLAB", 6))
934 MATLAB_KO: ThrowReaderException(CorruptImageError,"ImproperImageHeader");
936 filepos = TellBlob(image);
937 while(!EOFBlob(image)) /* object parser loop */
940 (void) SeekBlob(image,filepos,SEEK_SET);
941 /* printf("pos=%X\n",TellBlob(image)); */
943 MATLAB_HDR.DataType = ReadBlobXXXLong(image);
944 if(EOFBlob(image)) break;
945 MATLAB_HDR.ObjectSize = ReadBlobXXXLong(image);
946 if(EOFBlob(image)) break;
947 filepos += MATLAB_HDR.ObjectSize + 4 + 4;
950 #if defined(MAGICKCORE_ZLIB_DELEGATE)
951 if(MATLAB_HDR.DataType == miCOMPRESSED)
953 image2 = DecompressBlock(image,MATLAB_HDR.ObjectSize,clone_info,exception);
954 if(image2==NULL) continue;
955 MATLAB_HDR.DataType = ReadBlobXXXLong(image2); /* replace compressed object type. */
959 if(MATLAB_HDR.DataType!=miMATRIX) continue; /* skip another objects. */
961 MATLAB_HDR.unknown1 = ReadBlobXXXLong(image2);
962 MATLAB_HDR.unknown2 = ReadBlobXXXLong(image2);
964 MATLAB_HDR.unknown5 = ReadBlobXXXLong(image2);
965 MATLAB_HDR.StructureClass = MATLAB_HDR.unknown5 & 0xFF;
966 MATLAB_HDR.StructureFlag = (MATLAB_HDR.unknown5>>8) & 0xFF;
968 MATLAB_HDR.unknown3 = ReadBlobXXXLong(image2);
970 MATLAB_HDR.unknown4 = ReadBlobXXXLong(image2); /* ??? don't understand why ?? */
971 MATLAB_HDR.unknown4 = ReadBlobXXXLong(image2);
972 MATLAB_HDR.DimFlag = ReadBlobXXXLong(image2);
973 MATLAB_HDR.SizeX = ReadBlobXXXLong(image2);
974 MATLAB_HDR.SizeY = ReadBlobXXXLong(image2);
977 switch(MATLAB_HDR.DimFlag)
979 case 8: z2=z=1; break; /* 2D matrix*/
980 case 12: z2=z = ReadBlobXXXLong(image2); /* 3D matrix RGB*/
981 (void) ReadBlobXXXLong(image2);
982 if(z!=3) ThrowReaderException(CoderError, "MultidimensionalMatricesAreNotSupported");
984 case 16: z2=z = ReadBlobXXXLong(image2); /* 4D matrix animation */
986 ThrowReaderException(CoderError, "MultidimensionalMatricesAreNotSupported");
987 Frames = ReadBlobXXXLong(image2);
989 ThrowReaderException(CorruptImageError,"ImproperImageHeader");
991 default: ThrowReaderException(CoderError, "MultidimensionalMatricesAreNotSupported");
994 MATLAB_HDR.Flag1 = ReadBlobXXXShort(image2);
995 MATLAB_HDR.NameFlag = ReadBlobXXXShort(image2);
997 if (logging) (void)LogMagickEvent(CoderEvent,GetMagickModule(),
998 "MATLAB_HDR.StructureClass %d",MATLAB_HDR.StructureClass);
999 if (MATLAB_HDR.StructureClass != mxCHAR_CLASS &&
1000 MATLAB_HDR.StructureClass != mxSINGLE_CLASS && /* float + complex float */
1001 MATLAB_HDR.StructureClass != mxDOUBLE_CLASS && /* double + complex double */
1002 MATLAB_HDR.StructureClass != mxINT8_CLASS &&
1003 MATLAB_HDR.StructureClass != mxUINT8_CLASS && /* uint8 + uint8 3D */
1004 MATLAB_HDR.StructureClass != mxINT16_CLASS &&
1005 MATLAB_HDR.StructureClass != mxUINT16_CLASS && /* uint16 + uint16 3D */
1006 MATLAB_HDR.StructureClass != mxINT32_CLASS &&
1007 MATLAB_HDR.StructureClass != mxUINT32_CLASS && /* uint32 + uint32 3D */
1008 MATLAB_HDR.StructureClass != mxINT64_CLASS &&
1009 MATLAB_HDR.StructureClass != mxUINT64_CLASS) /* uint64 + uint64 3D */
1010 ThrowReaderException(CoderError,"UnsupportedCellTypeInTheMatrix");
1012 switch (MATLAB_HDR.NameFlag)
1015 size = ReadBlobXXXLong(image2); /* Object name string size */
1016 size = 4 * (ssize_t) ((size + 3 + 1) / 4);
1017 (void) SeekBlob(image2, size, SEEK_CUR);
1023 (void) ReadBlob(image2, 4, (unsigned char *) &size); /* Object name string */
1029 CellType = ReadBlobXXXLong(image2); /* Additional object type */
1031 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
1032 "MATLAB_HDR.CellType: %.20g",(double) CellType);
1034 (void) ReadBlob(image2, 4, (unsigned char *) &size); /* data size */
1042 if(MATLAB_HDR.StructureFlag & FLAG_LOGICAL)
1045 image->depth = 8; /* Byte type cell */
1046 ldblk = (ssize_t) MATLAB_HDR.SizeX;
1051 image->depth = 16; /* Word type cell */
1052 ldblk = (ssize_t) (2 * MATLAB_HDR.SizeX);
1057 image->depth = 32; /* Dword type cell */
1058 ldblk = (ssize_t) (4 * MATLAB_HDR.SizeX);
1063 image->depth = 64; /* Qword type cell */
1064 ldblk = (ssize_t) (8 * MATLAB_HDR.SizeX);
1068 image->depth = 32; /* double type cell */
1069 (void) SetImageOption(clone_info,"quantum:format","floating-point");
1070 if (MATLAB_HDR.StructureFlag & FLAG_COMPLEX)
1071 { /* complex float type cell */
1073 ldblk = (ssize_t) (4 * MATLAB_HDR.SizeX);
1077 image->depth = 64; /* double type cell */
1078 (void) SetImageOption(clone_info,"quantum:format","floating-point");
1079 DisableMSCWarning(4127)
1080 if (sizeof(double) != 8)
1082 ThrowReaderException(CoderError, "IncompatibleSizeOfDouble");
1083 if (MATLAB_HDR.StructureFlag & FLAG_COMPLEX)
1084 { /* complex double type cell */
1086 ldblk = (ssize_t) (8 * MATLAB_HDR.SizeX);
1089 ThrowReaderException(CoderError, "UnsupportedCellTypeInTheMatrix");
1092 image->columns = MATLAB_HDR.SizeX;
1093 image->rows = MATLAB_HDR.SizeY;
1094 quantum_info=AcquireQuantumInfo(clone_info,image);
1095 if (quantum_info == (QuantumInfo *) NULL)
1096 ThrowReaderException(ResourceLimitError,"MemoryAllocationFailed");
1098 image->colors = one << image->depth;
1099 if (image->columns == 0 || image->rows == 0)
1101 /* Image is gray when no complex flag is set and 2D Matrix */
1102 if ((MATLAB_HDR.DimFlag == 8) &&
1103 ((MATLAB_HDR.StructureFlag & FLAG_COMPLEX) == 0))
1105 image->type=GrayscaleType;
1106 SetImageColorspace(image,GRAYColorspace,exception);
1111 If ping is true, then only set image size and colors without
1112 reading any image data.
1114 if (image_info->ping)
1116 size_t temp = image->columns;
1117 image->columns = image->rows;
1119 goto done_reading; /* !!!!!! BAD !!!! */
1121 status=SetImageExtent(image,image->columns,image->rows,exception);
1122 if (status == MagickFalse)
1123 return(DestroyImageList(image));
1125 /* ----- Load raster data ----- */
1126 BImgBuff = (unsigned char *) AcquireQuantumMemory((size_t) (ldblk),sizeof(double)); /* Ldblk was set in the check phase */
1127 if (BImgBuff == NULL)
1128 ThrowReaderException(ResourceLimitError,"MemoryAllocationFailed");
1129 (void) ResetMagickMemory(BImgBuff,0,ldblk*sizeof(double));
1133 if (CellType==miDOUBLE || CellType==miSINGLE) /* Find Min and Max Values for floats */
1135 CalcMinMax(image2, image_info->endian, MATLAB_HDR.SizeX, MATLAB_HDR.SizeY, CellType, ldblk, BImgBuff, &quantum_info->minimum, &quantum_info->maximum);
1138 /* Main loop for reading all scanlines */
1139 if(z==1) z=0; /* read grey scanlines */
1140 /* else read color scanlines */
1143 for (i = 0; i < (ssize_t) MATLAB_HDR.SizeY; i++)
1145 q=GetAuthenticPixels(image,0,MATLAB_HDR.SizeY-i-1,image->columns,1,exception);
1146 if (q == (Quantum *) NULL)
1148 if (logging) (void)LogMagickEvent(CoderEvent,GetMagickModule(),
1149 " MAT set image pixels returns unexpected NULL on a row %u.", (unsigned)(MATLAB_HDR.SizeY-i-1));
1150 goto done_reading; /* Skip image rotation, when cannot set image pixels */
1152 if(ReadBlob(image2,ldblk,(unsigned char *)BImgBuff) != (ssize_t) ldblk)
1154 if (logging) (void)LogMagickEvent(CoderEvent,GetMagickModule(),
1155 " MAT cannot read scanrow %u from a file.", (unsigned)(MATLAB_HDR.SizeY-i-1));
1158 if((CellType==miINT8 || CellType==miUINT8) && (MATLAB_HDR.StructureFlag & FLAG_LOGICAL))
1160 FixLogical((unsigned char *)BImgBuff,ldblk);
1161 if(ImportQuantumPixels(image,(CacheView *) NULL,quantum_info,z2qtype[z],BImgBuff,exception) <= 0)
1163 ImportQuantumPixelsFailed:
1164 if (logging) (void)LogMagickEvent(CoderEvent,GetMagickModule(),
1165 " MAT failed to ImportQuantumPixels for a row %u", (unsigned)(MATLAB_HDR.SizeY-i-1));
1171 if(ImportQuantumPixels(image,(CacheView *) NULL,quantum_info,z2qtype[z],BImgBuff,exception) <= 0)
1172 goto ImportQuantumPixelsFailed;
1175 if (z<=1 && /* fix only during a last pass z==0 || z==1 */
1176 (CellType==miINT8 || CellType==miINT16 || CellType==miINT32 || CellType==miINT64))
1177 FixSignedValues(image,q,MATLAB_HDR.SizeX);
1180 if (!SyncAuthenticPixels(image,exception))
1182 if (logging) (void)LogMagickEvent(CoderEvent,GetMagickModule(),
1183 " MAT failed to sync image pixels for a row %u", (unsigned)(MATLAB_HDR.SizeY-i-1));
1191 /* Read complex part of numbers here */
1192 if (MATLAB_HDR.StructureFlag & FLAG_COMPLEX)
1193 { /* Find Min and Max Values for complex parts of floats */
1194 CellType = ReadBlobXXXLong(image2); /* Additional object type */
1195 i = ReadBlobXXXLong(image2); /* size of a complex part - toss away*/
1197 if (CellType==miDOUBLE || CellType==miSINGLE)
1199 CalcMinMax(image2, image_info->endian, MATLAB_HDR.SizeX, MATLAB_HDR.SizeY, CellType, ldblk, BImgBuff, &MinVal, &MaxVal);
1202 if (CellType==miDOUBLE)
1203 for (i = 0; i < (ssize_t) MATLAB_HDR.SizeY; i++)
1205 ReadBlobDoublesXXX(image2, ldblk, (double *)BImgBuff);
1206 InsertComplexDoubleRow(image, (double *)BImgBuff, i, MinVal, MaxVal,
1210 if (CellType==miSINGLE)
1211 for (i = 0; i < (ssize_t) MATLAB_HDR.SizeY; i++)
1213 ReadBlobFloatsXXX(image2, ldblk, (float *)BImgBuff);
1214 InsertComplexFloatRow(image,(float *)BImgBuff,i,MinVal,MaxVal,
1219 /* Image is gray when no complex flag is set and 2D Matrix AGAIN!!! */
1220 if ((MATLAB_HDR.DimFlag == 8) &&
1221 ((MATLAB_HDR.StructureFlag & FLAG_COMPLEX) == 0))
1222 image->type=GrayscaleType;
1223 if (image->depth == 1)
1224 image->type=BilevelType;
1227 image2 = NULL; /* Remove shadow copy to an image before rotation. */
1230 rotated_image = RotateImage(image, 90.0, exception);
1231 if (rotated_image != (Image *) NULL)
1233 /* Remove page offsets added by RotateImage */
1234 rotated_image->page.x=0;
1235 rotated_image->page.y=0;
1237 blob = rotated_image->blob;
1238 rotated_image->blob = image->blob;
1239 rotated_image->colors = image->colors;
1241 AppendImageToList(&image,rotated_image);
1242 DeleteImageFromList(&image);
1250 DeleteImageFromList(&image2);
1253 if(clone_info->file)
1255 fclose(clone_info->file);
1256 clone_info->file = NULL;
1257 (void) remove_utf8(clone_info->filename);
1262 /* Allocate next image structure. */
1263 AcquireNextImage(image_info,image,exception);
1264 if (image->next == (Image *) NULL) break;
1265 image=SyncNextImageInList(image);
1266 image->columns=image->rows=0;
1269 /* row scan buffer is no longer needed */
1270 RelinquishMagickMemory(BImgBuff);
1276 if(image2==NULL) image2 = image;
1279 if ((image2!=NULL) && (image2!=image)) /* Does shadow temporary decompressed image exist? */
1281 /* CloseBlob(image2); */
1282 DeleteImageFromList(&image2);
1285 if(clone_info->file)
1287 fclose(clone_info->file);
1288 clone_info->file = NULL;
1289 (void) remove_utf8(clone_info->filename);
1295 RelinquishMagickMemory(BImgBuff);
1296 if (quantum_info != (QuantumInfo *) NULL)
1297 quantum_info=DestroyQuantumInfo(quantum_info);
1299 clone_info=DestroyImageInfo(clone_info);
1308 Rewind list, removing any empty images while rewinding.
1312 while (p != (Image *) NULL)
1315 if ((p->rows == 0) || (p->columns == 0)) {
1317 DeleteImageFromList(&tmp);
1327 for (p=image; p != (Image *) NULL; p=p->next)
1331 if(clone_info != NULL) /* cleanup garbage file from compression */
1333 if(clone_info->file)
1335 fclose(clone_info->file);
1336 clone_info->file = NULL;
1337 (void) remove_utf8(clone_info->filename);
1339 DestroyImageInfo(clone_info);
1342 if (logging) (void)LogMagickEvent(CoderEvent,GetMagickModule(),"return");
1344 ThrowReaderException(CorruptImageError,"ImproperImageHeader");
1349 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1353 % R e g i s t e r M A T I m a g e %
1357 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1359 % Method RegisterMATImage adds attributes for the MAT image format to
1360 % the list of supported formats. The attributes include the image format
1361 % tag, a method to read and/or write the format, whether the format
1362 % supports the saving of more than one frame to the same file or blob,
1363 % whether the format supports native in-memory I/O, and a brief
1364 % description of the format.
1366 % The format of the RegisterMATImage method is:
1368 % size_t RegisterMATImage(void)
1371 ModuleExport size_t RegisterMATImage(void)
1376 entry=AcquireMagickInfo("MAT","MAT","MATLAB level 5 image format");
1377 entry->decoder=(DecodeImageHandler *) ReadMATImage;
1378 entry->encoder=(EncodeImageHandler *) WriteMATImage;
1379 entry->flags^=CoderBlobSupportFlag;
1380 entry->flags|=CoderDecoderSeekableStreamFlag;
1381 (void) RegisterMagickInfo(entry);
1382 return(MagickImageCoderSignature);
1386 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1390 % U n r e g i s t e r M A T I m a g e %
1394 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1396 % Method UnregisterMATImage removes format registrations made by the
1397 % MAT module from the list of supported formats.
1399 % The format of the UnregisterMATImage method is:
1401 % UnregisterMATImage(void)
1404 ModuleExport void UnregisterMATImage(void)
1406 (void) UnregisterMagickInfo("MAT");
1410 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1414 % W r i t e M A T L A B I m a g e %
1418 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1420 % Function WriteMATImage writes an Matlab matrix to a file.
1422 % The format of the WriteMATImage method is:
1424 % MagickBooleanType WriteMATImage(const ImageInfo *image_info,
1425 % Image *image,ExceptionInfo *exception)
1427 % A description of each parameter follows.
1429 % o image_info: Specifies a pointer to a ImageInfo structure.
1431 % o image: A pointer to an Image structure.
1433 % o exception: return any errors or warnings in this structure.
1436 static MagickBooleanType WriteMATImage(const ImageInfo *image_info,Image *image,
1437 ExceptionInfo *exception)
1441 register const Quantum *p;
1443 unsigned int status;
1447 char MATLAB_HDR[0x80];
1448 time_t current_time;
1449 struct tm local_time;
1450 unsigned char *pixels;
1460 Open output image file.
1462 assert(image_info != (const ImageInfo *) NULL);
1463 assert(image_info->signature == MagickCoreSignature);
1464 assert(image != (Image *) NULL);
1465 assert(image->signature == MagickCoreSignature);
1466 logging=LogMagickEvent(CoderEvent,GetMagickModule(),"enter MAT");
1468 assert(exception != (ExceptionInfo *) NULL);
1469 assert(exception->signature == MagickCoreSignature);
1470 status=OpenBlob(image_info,image,WriteBinaryBlobMode,exception);
1471 if (status == MagickFalse)
1472 return(MagickFalse);
1475 current_time=time((time_t *) NULL);
1476 #if defined(MAGICKCORE_HAVE_LOCALTIME_R)
1477 (void) localtime_r(¤t_time,&local_time);
1479 (void) memcpy(&local_time,localtime(¤t_time),sizeof(local_time));
1481 (void) memset(MATLAB_HDR,' ',MagickMin(sizeof(MATLAB_HDR),124));
1482 FormatLocaleString(MATLAB_HDR,sizeof(MATLAB_HDR),
1483 "MATLAB 5.0 MAT-file, Platform: %s, Created on: %s %s %2d %2d:%2d:%2d %d",
1484 OsDesc,DayOfWTab[local_time.tm_wday],MonthsTab[local_time.tm_mon],
1485 local_time.tm_mday,local_time.tm_hour,local_time.tm_min,
1486 local_time.tm_sec,local_time.tm_year+1900);
1489 MATLAB_HDR[0x7E]='I';
1490 MATLAB_HDR[0x7F]='M';
1491 (void) WriteBlob(image,sizeof(MATLAB_HDR),(unsigned char *) MATLAB_HDR);
1495 (void) TransformImageColorspace(image,sRGBColorspace,exception);
1496 is_gray = SetImageGray(image,exception);
1497 z = is_gray ? 0 : 3;
1502 DataSize = image->rows /*Y*/ * image->columns /*X*/;
1503 if(!is_gray) DataSize *= 3 /*Z*/;
1504 padding=((unsigned char)(DataSize-1) & 0x7) ^ 0x7;
1506 (void) WriteBlobLSBLong(image, miMATRIX);
1507 (void) WriteBlobLSBLong(image, (unsigned int) DataSize+padding+(is_gray ? 48 : 56));
1508 (void) WriteBlobLSBLong(image, 0x6); /* 0x88 */
1509 (void) WriteBlobLSBLong(image, 0x8); /* 0x8C */
1510 (void) WriteBlobLSBLong(image, 0x6); /* 0x90 */
1511 (void) WriteBlobLSBLong(image, 0);
1512 (void) WriteBlobLSBLong(image, 0x5); /* 0x98 */
1513 (void) WriteBlobLSBLong(image, is_gray ? 0x8 : 0xC); /* 0x9C - DimFlag */
1514 (void) WriteBlobLSBLong(image, (unsigned int) image->rows); /* x: 0xA0 */
1515 (void) WriteBlobLSBLong(image, (unsigned int) image->columns); /* y: 0xA4 */
1518 (void) WriteBlobLSBLong(image, 3); /* z: 0xA8 */
1519 (void) WriteBlobLSBLong(image, 0);
1521 (void) WriteBlobLSBShort(image, 1); /* 0xB0 */
1522 (void) WriteBlobLSBShort(image, 1); /* 0xB2 */
1523 (void) WriteBlobLSBLong(image, 'M'); /* 0xB4 */
1524 (void) WriteBlobLSBLong(image, 0x2); /* 0xB8 */
1525 (void) WriteBlobLSBLong(image, (unsigned int) DataSize); /* 0xBC */
1530 quantum_info=AcquireQuantumInfo(image_info,image);
1531 if (quantum_info == (QuantumInfo *) NULL)
1532 ThrowWriterException(ResourceLimitError,"MemoryAllocationFailed");
1533 pixels=(unsigned char *) GetQuantumPixels(quantum_info);
1536 for (y=0; y < (ssize_t)image->columns; y++)
1538 p=GetVirtualPixels(image,y,0,1,image->rows,exception);
1539 if (p == (const Quantum *) NULL)
1541 (void) ExportQuantumPixels(image,(CacheView *) NULL,quantum_info,
1542 z2qtype[z],pixels,exception);
1543 (void) WriteBlob(image,image->rows,pixels);
1545 if (SyncAuthenticPixels(image,exception) == MagickFalse)
1548 while(padding-->0) (void) WriteBlobByte(image,0);
1549 quantum_info=DestroyQuantumInfo(quantum_info);
1550 if (GetNextImageInList(image) == (Image *) NULL)
1552 image=SyncNextImageInList(image);
1553 status=SetImageProgress(image,SaveImagesTag,scene++,
1554 GetImageListLength(image));
1555 if (status == MagickFalse)
1557 } while (image_info->adjoin != MagickFalse);
1558 (void) CloseBlob(image);