2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
13 % Read/Write Windows DIB Image Format %
20 % Copyright 1999-2013 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/attribute.h"
44 #include "MagickCore/blob.h"
45 #include "MagickCore/blob-private.h"
46 #include "MagickCore/cache.h"
47 #include "MagickCore/color.h"
48 #include "MagickCore/color-private.h"
49 #include "MagickCore/colormap.h"
50 #include "MagickCore/colormap-private.h"
51 #include "MagickCore/colorspace.h"
52 #include "MagickCore/colorspace-private.h"
53 #include "MagickCore/draw.h"
54 #include "MagickCore/exception.h"
55 #include "MagickCore/exception-private.h"
56 #include "MagickCore/geometry.h"
57 #include "MagickCore/image.h"
58 #include "MagickCore/image-private.h"
59 #include "MagickCore/list.h"
60 #include "MagickCore/log.h"
61 #include "MagickCore/magick.h"
62 #include "MagickCore/memory_.h"
63 #include "MagickCore/monitor.h"
64 #include "MagickCore/monitor-private.h"
65 #include "MagickCore/pixel-accessor.h"
66 #include "MagickCore/quantum-private.h"
67 #include "MagickCore/static.h"
68 #include "MagickCore/string_.h"
69 #include "MagickCore/module.h"
70 #include "MagickCore/transform.h"
75 typedef struct _DIBInfo
111 Forward declarations.
113 static MagickBooleanType
114 WriteDIBImage(const ImageInfo *,Image *,ExceptionInfo *);
117 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
121 % D e c o d e I m a g e %
125 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
127 % DecodeImage unpacks the packed image pixels into runlength-encoded
130 % The format of the DecodeImage method is:
132 % MagickBooleanType DecodeImage(Image *image,
133 % const MagickBooleanType compression,unsigned char *pixels)
135 % A description of each parameter follows:
137 % o image: the address of a structure of type Image.
139 % o compression: A value of 1 means the compressed pixels are runlength
140 % encoded for a 256-color bitmap. A value of 2 means a 16-color bitmap.
142 % o pixels: The address of a byte (8 bits) array of pixel data created by
143 % the decoding process.
147 static inline size_t MagickMin(const size_t x,const size_t y)
154 static MagickBooleanType DecodeImage(Image *image,
155 const MagickBooleanType compression,unsigned char *pixels)
157 #if !defined(MAGICKCORE_WINDOWS_SUPPORT) || defined(__MINGW32__) || defined(__MINGW64__)
161 #define BI_BITFIELDS 3
174 register unsigned char
181 assert(image != (Image *) NULL);
182 assert(image->signature == MagickSignature);
183 if (image->debug != MagickFalse)
184 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
185 assert(pixels != (unsigned char *) NULL);
186 (void) ResetMagickMemory(pixels,0,(size_t) image->columns*image->rows*
191 q=pixels+(size_t) image->columns*image->rows;
192 for (y=0; y < (ssize_t) image->rows; )
194 if ((p < pixels) || (p >= q))
196 count=ReadBlobByte(image);
201 count=(int) MagickMin((size_t) count,(size_t) (q-p));
205 byte=(unsigned char) ReadBlobByte(image);
206 if (compression == BI_RLE8)
208 for (i=0; i < count; i++)
209 *p++=(unsigned char) byte;
213 for (i=0; i < count; i++)
215 ((i & 0x01) != 0 ? (byte & 0x0f) : ((byte >> 4) & 0x0f));
224 count=ReadBlobByte(image);
236 p=pixels+y*image->columns;
244 x+=ReadBlobByte(image);
245 y+=ReadBlobByte(image);
246 p=pixels+y*image->columns+x;
254 count=(int) MagickMin((size_t) count,(size_t) (q-p));
255 if (compression == BI_RLE8)
256 for (i=0; i < count; i++)
257 *p++=(unsigned char) ReadBlobByte(image);
259 for (i=0; i < count; i++)
262 byte=(unsigned char) ReadBlobByte(image);
264 ((i & 0x01) != 0 ? (byte & 0x0f) : ((byte >> 4) & 0x0f));
270 if (compression == BI_RLE8)
272 if ((count & 0x01) != 0)
273 (void) ReadBlobByte(image);
276 if (((count & 0x03) == 1) || ((count & 0x03) == 2))
277 (void) ReadBlobByte(image);
282 if (SetImageProgress(image,LoadImageTag,y,image->rows) == MagickFalse)
285 (void) ReadBlobByte(image); /* end of line */
286 (void) ReadBlobByte(image);
291 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
295 % E n c o d e I m a g e %
299 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
301 % EncodeImage compresses pixels using a runlength encoded format.
303 % The format of the EncodeImage method is:
305 % static MagickBooleanType EncodeImage(Image *image,
306 % const size_t bytes_per_line,const unsigned char *pixels,
307 % unsigned char *compressed_pixels)
309 % A description of each parameter follows:
311 % o image: The image.
313 % o bytes_per_line: the number of bytes in a scanline of compressed pixels
315 % o pixels: The address of a byte (8 bits) array of pixel data created by
316 % the compression process.
318 % o compressed_pixels: The address of a byte (8 bits) array of compressed
322 static size_t EncodeImage(Image *image,const size_t bytes_per_line,
323 const unsigned char *pixels,unsigned char *compressed_pixels)
328 register const unsigned char
335 register unsigned char
339 Runlength encode pixels.
341 assert(image != (Image *) NULL);
342 assert(image->signature == MagickSignature);
343 if (image->debug != MagickFalse)
344 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
345 assert(pixels != (const unsigned char *) NULL);
346 assert(compressed_pixels != (unsigned char *) NULL);
350 for (y=0; y < (ssize_t) image->rows; y++)
352 for (x=0; x < (ssize_t) bytes_per_line; x+=i)
357 for (i=1; ((x+i) < (ssize_t) bytes_per_line); i++)
358 if ((*(p+i) != *p) || (i == 255))
360 *q++=(unsigned char) i;
369 if (SetImageProgress(image,LoadImageTag,y,image->rows) == MagickFalse)
377 return((size_t) (q-compressed_pixels));
381 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
389 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
391 % IsDIB() returns MagickTrue if the image format type, identified by the
392 % magick string, is DIB.
394 % The format of the IsDIB method is:
396 % MagickBooleanType IsDIB(const unsigned char *magick,const size_t length)
398 % A description of each parameter follows:
400 % o magick: compare image format pattern against these bytes.
402 % o length: Specifies the length of the magick string.
405 static MagickBooleanType IsDIB(const unsigned char *magick,const size_t length)
409 if (memcmp(magick,"\050\000",2) == 0)
415 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
419 % R e a d D I B I m a g e %
423 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
425 % ReadDIBImage() reads a Microsoft Windows bitmap image file and
426 % returns it. It allocates the memory necessary for the new Image structure
427 % and returns a pointer to the new image.
429 % The format of the ReadDIBImage method is:
431 % image=ReadDIBImage(image_info)
433 % A description of each parameter follows:
435 % o image_info: the image info.
437 % o exception: return any errors or warnings in this structure.
441 static inline ssize_t MagickAbsoluteValue(const ssize_t x)
448 static inline size_t MagickMax(const size_t x,const size_t y)
455 static Image *ReadDIBImage(const ImageInfo *image_info,ExceptionInfo *exception)
478 register unsigned char
497 assert(image_info != (const ImageInfo *) NULL);
498 assert(image_info->signature == MagickSignature);
499 if (image_info->debug != MagickFalse)
500 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",
501 image_info->filename);
502 assert(exception != (ExceptionInfo *) NULL);
503 assert(exception->signature == MagickSignature);
504 image=AcquireImage(image_info,exception);
505 status=OpenBlob(image_info,image,ReadBinaryBlobMode,exception);
506 if (status == MagickFalse)
508 image=DestroyImageList(image);
509 return((Image *) NULL);
512 Determine if this a DIB file.
514 (void) ResetMagickMemory(&dib_info,0,sizeof(dib_info));
515 dib_info.size=ReadBlobLSBLong(image);
516 if (dib_info.size!=40)
517 ThrowReaderException(CorruptImageError,"ImproperImageHeader");
519 Microsoft Windows 3.X DIB image file.
521 dib_info.width=(short) ReadBlobLSBLong(image);
522 dib_info.height=(short) ReadBlobLSBLong(image);
523 dib_info.planes=ReadBlobLSBShort(image);
524 dib_info.bits_per_pixel=ReadBlobLSBShort(image);
525 dib_info.compression=ReadBlobLSBLong(image);
526 dib_info.image_size=ReadBlobLSBLong(image);
527 dib_info.x_pixels=ReadBlobLSBLong(image);
528 dib_info.y_pixels=ReadBlobLSBLong(image);
529 dib_info.number_colors=ReadBlobLSBLong(image);
530 dib_info.colors_important=ReadBlobLSBLong(image);
531 if ((dib_info.compression == BI_BITFIELDS) &&
532 ((dib_info.bits_per_pixel == 16) || (dib_info.bits_per_pixel == 32)))
534 dib_info.red_mask=ReadBlobLSBLong(image);
535 dib_info.green_mask=ReadBlobLSBLong(image);
536 dib_info.blue_mask=ReadBlobLSBLong(image);
538 image->alpha_trait=dib_info.bits_per_pixel == 32 ? BlendPixelTrait :
540 image->columns=(size_t) MagickAbsoluteValue(dib_info.width);
541 image->rows=(size_t) MagickAbsoluteValue(dib_info.height);
543 if ((dib_info.number_colors != 0) || (dib_info.bits_per_pixel < 16))
548 image->storage_class=PseudoClass;
549 image->colors=dib_info.number_colors;
551 if (image->colors == 0)
552 image->colors=one << dib_info.bits_per_pixel;
554 if (image_info->size)
562 flags=ParseAbsoluteGeometry(image_info->size,&geometry);
563 if (flags & WidthValue)
564 if ((geometry.width != 0) && (geometry.width < image->columns))
565 image->columns=geometry.width;
566 if (flags & HeightValue)
567 if ((geometry.height != 0) && (geometry.height < image->rows))
568 image->rows=geometry.height;
570 if (image->storage_class == PseudoClass)
580 Read DIB raster colormap.
582 if (AcquireImageColormap(image,image->colors,exception) == MagickFalse)
583 ThrowReaderException(ResourceLimitError,"MemoryAllocationFailed");
584 length=(size_t) image->colors;
585 dib_colormap=(unsigned char *) AcquireQuantumMemory(length,
586 4*sizeof(*dib_colormap));
587 if (dib_colormap == (unsigned char *) NULL)
588 ThrowReaderException(ResourceLimitError,"MemoryAllocationFailed");
590 count=ReadBlob(image,packet_size*image->colors,dib_colormap);
591 if (count != (ssize_t) (packet_size*image->colors))
592 ThrowReaderException(CorruptImageError,"InsufficientImageDataInFile");
594 for (i=0; i < (ssize_t) image->colors; i++)
596 image->colormap[i].blue=ScaleCharToQuantum(*p++);
597 image->colormap[i].green=ScaleCharToQuantum(*p++);
598 image->colormap[i].red=ScaleCharToQuantum(*p++);
599 if (packet_size == 4)
602 dib_colormap=(unsigned char *) RelinquishMagickMemory(dib_colormap);
607 if (dib_info.compression == BI_RLE4)
608 dib_info.bits_per_pixel<<=1;
609 bytes_per_line=4*((image->columns*dib_info.bits_per_pixel+31)/32);
610 length=bytes_per_line*image->rows;
611 pixels=(unsigned char *) AcquireQuantumMemory((size_t) image->rows,
612 MagickMax(bytes_per_line,image->columns+256UL)*sizeof(*pixels));
613 if (pixels == (unsigned char *) NULL)
614 ThrowReaderException(ResourceLimitError,"MemoryAllocationFailed");
615 if ((dib_info.compression == BI_RGB) ||
616 (dib_info.compression == BI_BITFIELDS))
618 count=ReadBlob(image,length,pixels);
619 if (count != (ssize_t) (length))
620 ThrowReaderException(CorruptImageError,"InsufficientImageDataInFile");
625 Convert run-length encoded raster pixels.
627 status=DecodeImage(image,dib_info.compression ? MagickTrue : MagickFalse,
629 if (status == MagickFalse)
630 ThrowReaderException(CorruptImageError,"UnableToRunlengthDecodeImage");
633 Initialize image structure.
635 image->units=PixelsPerCentimeterResolution;
636 image->resolution.x=(double) dib_info.x_pixels/100.0;
637 image->resolution.y=(double) dib_info.y_pixels/100.0;
639 Convert DIB raster image to pixel packets.
641 switch (dib_info.bits_per_pixel)
646 Convert bitmap scanline.
648 for (y=(ssize_t) image->rows-1; y >= 0; y--)
650 p=pixels+(image->rows-y-1)*bytes_per_line;
651 q=QueueAuthenticPixels(image,0,y,image->columns,1,exception);
652 if (q == (Quantum *) NULL)
654 for (x=0; x < ((ssize_t) image->columns-7); x+=8)
656 for (bit=0; bit < 8; bit++)
658 index=(Quantum) ((*p) & (0x80 >> bit) ? 0x01 : 0x00);
659 SetPixelIndex(image,index,q);
660 q+=GetPixelChannels(image);
664 if ((image->columns % 8) != 0)
666 for (bit=0; bit < (ssize_t) (image->columns % 8); bit++)
668 index=(Quantum) ((*p) & (0x80 >> bit) ? 0x01 : 0x00);
669 SetPixelIndex(image,index,q);
670 q+=GetPixelChannels(image);
674 if (SyncAuthenticPixels(image,exception) == MagickFalse)
676 if (image->previous == (Image *) NULL)
678 status=SetImageProgress(image,LoadImageTag,image->rows-y-1,
680 if (status == MagickFalse)
684 (void) SyncImage(image,exception);
690 Convert PseudoColor scanline.
692 for (y=(ssize_t) image->rows-1; y >= 0; y--)
694 p=pixels+(image->rows-y-1)*bytes_per_line;
695 q=QueueAuthenticPixels(image,0,y,image->columns,1,exception);
696 if (q == (Quantum *) NULL)
698 for (x=0; x < ((ssize_t) image->columns-1); x+=2)
700 index=ConstrainColormapIndex(image,(*p >> 4) & 0xf,exception);
701 SetPixelIndex(image,index,q);
702 q+=GetPixelChannels(image);
703 index=ConstrainColormapIndex(image,*p & 0xf,exception);
704 SetPixelIndex(image,index,q);
706 q+=GetPixelChannels(image);
708 if ((image->columns % 2) != 0)
710 index=ConstrainColormapIndex(image,(*p >> 4) & 0xf,exception);
711 SetPixelIndex(image,index,q);
712 q+=GetPixelChannels(image);
715 if (SyncAuthenticPixels(image,exception) == MagickFalse)
717 if (image->previous == (Image *) NULL)
719 status=SetImageProgress(image,LoadImageTag,image->rows-y-1,
721 if (status == MagickFalse)
725 (void) SyncImage(image,exception);
731 Convert PseudoColor scanline.
733 if ((dib_info.compression == BI_RLE8) ||
734 (dib_info.compression == BI_RLE4))
735 bytes_per_line=image->columns;
736 for (y=(ssize_t) image->rows-1; y >= 0; y--)
738 p=pixels+(image->rows-y-1)*bytes_per_line;
739 q=QueueAuthenticPixels(image,0,y,image->columns,1,exception);
740 if (q == (Quantum *) NULL)
742 for (x=0; x < (ssize_t) image->columns; x++)
744 index=ConstrainColormapIndex(image,*p,exception);
745 SetPixelIndex(image,index,q);
747 q+=GetPixelChannels(image);
749 if (SyncAuthenticPixels(image,exception) == MagickFalse)
751 if (image->previous == (Image *) NULL)
753 status=SetImageProgress(image,LoadImageTag,image->rows-y-1,
755 if (status == MagickFalse)
759 (void) SyncImage(image,exception);
768 Convert PseudoColor scanline.
770 image->storage_class=DirectClass;
771 if (dib_info.compression == BI_RLE8)
772 bytes_per_line=2*image->columns;
773 for (y=(ssize_t) image->rows-1; y >= 0; y--)
775 p=pixels+(image->rows-y-1)*bytes_per_line;
776 q=QueueAuthenticPixels(image,0,y,image->columns,1,exception);
777 if (q == (Quantum *) NULL)
779 for (x=0; x < (ssize_t) image->columns; x++)
783 if (dib_info.red_mask == 0)
785 SetPixelRed(image,ScaleCharToQuantum(ScaleColor5to8(
786 (unsigned char) ((word >> 10) & 0x1f))),q);
787 SetPixelGreen(image,ScaleCharToQuantum(ScaleColor5to8(
788 (unsigned char) ((word >> 5) & 0x1f))),q);
789 SetPixelBlue(image,ScaleCharToQuantum(ScaleColor5to8(
790 (unsigned char) (word & 0x1f))),q);
794 SetPixelRed(image,ScaleCharToQuantum(ScaleColor5to8(
795 (unsigned char) ((word >> 11) & 0x1f))),q);
796 SetPixelGreen(image,ScaleCharToQuantum(ScaleColor6to8(
797 (unsigned char) ((word >> 5) & 0x3f))),q);
798 SetPixelBlue(image,ScaleCharToQuantum(ScaleColor5to8(
799 (unsigned char) (word & 0x1f))),q);
801 q+=GetPixelChannels(image);
803 if (SyncAuthenticPixels(image,exception) == MagickFalse)
805 if (image->previous == (Image *) NULL)
807 status=SetImageProgress(image,LoadImageTag,image->rows-y-1,
809 if (status == MagickFalse)
819 Convert DirectColor scanline.
821 for (y=(ssize_t) image->rows-1; y >= 0; y--)
823 p=pixels+(image->rows-y-1)*bytes_per_line;
824 q=QueueAuthenticPixels(image,0,y,image->columns,1,exception);
825 if (q == (Quantum *) NULL)
827 for (x=0; x < (ssize_t) image->columns; x++)
829 SetPixelBlue(image,ScaleCharToQuantum(*p++),q);
830 SetPixelGreen(image,ScaleCharToQuantum(*p++),q);
831 SetPixelRed(image,ScaleCharToQuantum(*p++),q);
832 if (image->alpha_trait == BlendPixelTrait)
833 SetPixelAlpha(image,ScaleCharToQuantum(*p++),q);
834 q+=GetPixelChannels(image);
836 if (SyncAuthenticPixels(image,exception) == MagickFalse)
838 if (image->previous == (Image *) NULL)
840 status=SetImageProgress(image,LoadImageTag,image->rows-y-1,
842 if (status == MagickFalse)
849 ThrowReaderException(CorruptImageError,"ImproperImageHeader");
851 pixels=(unsigned char *) RelinquishMagickMemory(pixels);
852 if (EOFBlob(image) != MagickFalse)
853 ThrowFileException(exception,CorruptImageError,"UnexpectedEndOfFile",
855 if (dib_info.height < 0)
861 Correct image orientation.
863 flipped_image=FlipImage(image,exception);
864 if (flipped_image != (Image *) NULL)
866 DuplicateBlob(flipped_image,image);
867 image=DestroyImage(image);
871 (void) CloseBlob(image);
872 return(GetFirstImageInList(image));
876 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
880 % R e g i s t e r D I B I m a g e %
884 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
886 % RegisterDIBImage() adds attributes for the DIB image format to
887 % the list of supported formats. The attributes include the image format
888 % tag, a method to read and/or write the format, whether the format
889 % supports the saving of more than one frame to the same file or blob,
890 % whether the format supports native in-memory I/O, and a brief
891 % description of the format.
893 % The format of the RegisterDIBImage method is:
895 % size_t RegisterDIBImage(void)
898 ModuleExport size_t RegisterDIBImage(void)
903 entry=SetMagickInfo("DIB");
904 entry->decoder=(DecodeImageHandler *) ReadDIBImage;
905 entry->encoder=(EncodeImageHandler *) WriteDIBImage;
906 entry->magick=(IsImageFormatHandler *) IsDIB;
907 entry->adjoin=MagickFalse;
908 entry->stealth=MagickTrue;
909 entry->description=ConstantString(
910 "Microsoft Windows 3.X Packed Device-Independent Bitmap");
911 entry->module=ConstantString("DIB");
912 (void) RegisterMagickInfo(entry);
913 return(MagickImageCoderSignature);
917 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
921 % U n r e g i s t e r D I B I m a g e %
925 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
927 % UnregisterDIBImage() removes format registrations made by the
928 % DIB module from the list of supported formats.
930 % The format of the UnregisterDIBImage method is:
932 % UnregisterDIBImage(void)
935 ModuleExport void UnregisterDIBImage(void)
937 (void) UnregisterMagickInfo("DIB");
941 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
945 % W r i t e D I B I m a g e %
949 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
951 % WriteDIBImage() writes an image in Microsoft Windows bitmap encoded
954 % The format of the WriteDIBImage method is:
956 % MagickBooleanType WriteDIBImage(const ImageInfo *image_info,
957 % Image *image,ExceptionInfo *exception)
959 % A description of each parameter follows.
961 % o image_info: the image info.
963 % o image: The image.
965 % o exception: return any errors or warnings in this structure.
968 static MagickBooleanType WriteDIBImage(const ImageInfo *image_info,Image *image,
969 ExceptionInfo *exception)
977 register const Quantum
984 register unsigned char
998 Open output image file.
1000 assert(image_info != (const ImageInfo *) NULL);
1001 assert(image_info->signature == MagickSignature);
1002 assert(image != (Image *) NULL);
1003 assert(image->signature == MagickSignature);
1004 if (image->debug != MagickFalse)
1005 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
1006 assert(exception != (ExceptionInfo *) NULL);
1007 assert(exception->signature == MagickSignature);
1008 status=OpenBlob(image_info,image,WriteBinaryBlobMode,exception);
1009 if (status == MagickFalse)
1012 Initialize DIB raster file header.
1014 if (IssRGBCompatibleColorspace(image->colorspace) == MagickFalse)
1015 (void) TransformImageColorspace(image,sRGBColorspace,exception);
1016 if (image->storage_class == DirectClass)
1019 Full color DIB raster.
1021 dib_info.number_colors=0;
1022 dib_info.bits_per_pixel=(unsigned short) (image->alpha_trait ? 32 : 24);
1027 Colormapped DIB raster.
1029 dib_info.bits_per_pixel=8;
1030 if (image_info->depth > 8)
1031 dib_info.bits_per_pixel=16;
1032 if (IsImageMonochrome(image,exception) != MagickFalse)
1033 dib_info.bits_per_pixel=1;
1034 dib_info.number_colors=(dib_info.bits_per_pixel == 16) ? 0 :
1035 (1UL << dib_info.bits_per_pixel);
1037 bytes_per_line=4*((image->columns*dib_info.bits_per_pixel+31)/32);
1039 dib_info.width=(ssize_t) image->columns;
1040 dib_info.height=(ssize_t) image->rows;
1042 dib_info.compression=(size_t) (dib_info.bits_per_pixel == 16 ?
1043 BI_BITFIELDS : BI_RGB);
1044 dib_info.image_size=bytes_per_line*image->rows;
1045 dib_info.x_pixels=75*39;
1046 dib_info.y_pixels=75*39;
1047 switch (image->units)
1049 case UndefinedResolution:
1050 case PixelsPerInchResolution:
1052 dib_info.x_pixels=(size_t) (100.0*image->resolution.x/2.54);
1053 dib_info.y_pixels=(size_t) (100.0*image->resolution.y/2.54);
1056 case PixelsPerCentimeterResolution:
1058 dib_info.x_pixels=(size_t) (100.0*image->resolution.x);
1059 dib_info.y_pixels=(size_t) (100.0*image->resolution.y);
1063 dib_info.colors_important=dib_info.number_colors;
1065 Convert MIFF to DIB raster pixels.
1067 pixels=(unsigned char *) AcquireQuantumMemory(dib_info.image_size,
1069 if (pixels == (unsigned char *) NULL)
1070 ThrowWriterException(ResourceLimitError,"MemoryAllocationFailed");
1071 (void) ResetMagickMemory(pixels,0,dib_info.image_size);
1072 switch (dib_info.bits_per_pixel)
1076 register unsigned char
1081 Convert PseudoClass image to a DIB monochrome image.
1083 for (y=0; y < (ssize_t) image->rows; y++)
1085 p=GetVirtualPixels(image,0,y,image->columns,1,exception);
1086 if (p == (const Quantum *) NULL)
1088 q=pixels+(image->rows-y-1)*bytes_per_line;
1091 for (x=0; x < (ssize_t) image->columns; x++)
1094 byte|=GetPixelIndex(image,p) != 0 ? 0x01 : 0x00;
1102 p+=GetPixelChannels(image);
1106 *q++=(unsigned char) (byte << (8-bit));
1109 for (x=(ssize_t) (image->columns+7)/8; x < (ssize_t) bytes_per_line; x++)
1111 status=SetImageProgress(image,SaveImageTag,(MagickOffsetType) y,
1113 if (status == MagickFalse)
1121 Convert PseudoClass packet to DIB pixel.
1123 for (y=0; y < (ssize_t) image->rows; y++)
1125 p=GetVirtualPixels(image,0,y,image->columns,1,exception);
1126 if (p == (const Quantum *) NULL)
1128 q=pixels+(image->rows-y-1)*bytes_per_line;
1129 for (x=0; x < (ssize_t) image->columns; x++)
1131 *q++=(unsigned char) GetPixelIndex(image,p);
1132 p+=GetPixelChannels(image);
1134 for ( ; x < (ssize_t) bytes_per_line; x++)
1136 status=SetImageProgress(image,SaveImageTag,(MagickOffsetType) y,
1138 if (status == MagickFalse)
1148 Convert PseudoClass packet to DIB pixel.
1150 for (y=0; y < (ssize_t) image->rows; y++)
1152 p=GetVirtualPixels(image,0,y,image->columns,1,exception);
1153 if (p == (const Quantum *) NULL)
1155 q=pixels+(image->rows-y-1)*bytes_per_line;
1156 for (x=0; x < (ssize_t) image->columns; x++)
1158 word=(unsigned short) ((ScaleColor8to5((unsigned char)
1159 ScaleQuantumToChar(GetPixelRed(image,p))) << 11) | (ScaleColor8to6(
1160 (unsigned char) ScaleQuantumToChar(GetPixelGreen(image,p))) << 5) |
1161 (ScaleColor8to5((unsigned char) ScaleQuantumToChar((unsigned char)
1162 GetPixelBlue(image,p)) << 0)));
1163 *q++=(unsigned char)(word & 0xff);
1164 *q++=(unsigned char)(word >> 8);
1165 p+=GetPixelChannels(image);
1167 for (x=(ssize_t) (2*image->columns); x < (ssize_t) bytes_per_line; x++)
1169 status=SetImageProgress(image,SaveImageTag,(MagickOffsetType) y,
1171 if (status == MagickFalse)
1180 Convert DirectClass packet to DIB RGB pixel.
1182 for (y=0; y < (ssize_t) image->rows; y++)
1184 p=GetVirtualPixels(image,0,y,image->columns,1,exception);
1185 if (p == (const Quantum *) NULL)
1187 q=pixels+(image->rows-y-1)*bytes_per_line;
1188 for (x=0; x < (ssize_t) image->columns; x++)
1190 *q++=ScaleQuantumToChar(GetPixelBlue(image,p));
1191 *q++=ScaleQuantumToChar(GetPixelGreen(image,p));
1192 *q++=ScaleQuantumToChar(GetPixelRed(image,p));
1193 if (image->alpha_trait == BlendPixelTrait)
1194 *q++=ScaleQuantumToChar(GetPixelAlpha(image,p));
1195 p+=GetPixelChannels(image);
1197 if (dib_info.bits_per_pixel == 24)
1198 for (x=(ssize_t) (3*image->columns); x < (ssize_t) bytes_per_line; x++)
1200 status=SetImageProgress(image,SaveImageTag,(MagickOffsetType) y,
1202 if (status == MagickFalse)
1208 if (dib_info.bits_per_pixel == 8)
1209 if (image_info->compression != NoCompression)
1215 Convert run-length encoded raster pixels.
1217 length=2UL*(bytes_per_line+2UL)+2UL;
1218 dib_data=(unsigned char *) AcquireQuantumMemory(length,
1219 (image->rows+2UL)*sizeof(*dib_data));
1220 if (pixels == (unsigned char *) NULL)
1222 pixels=(unsigned char *) RelinquishMagickMemory(pixels);
1223 ThrowWriterException(ResourceLimitError,"MemoryAllocationFailed");
1225 dib_info.image_size=(size_t) EncodeImage(image,bytes_per_line,
1227 pixels=(unsigned char *) RelinquishMagickMemory(pixels);
1229 dib_info.compression = BI_RLE8;
1234 (void) WriteBlobLSBLong(image,(unsigned int) dib_info.size);
1235 (void) WriteBlobLSBLong(image,dib_info.width);
1236 (void) WriteBlobLSBLong(image,(unsigned short) dib_info.height);
1237 (void) WriteBlobLSBShort(image,(unsigned short) dib_info.planes);
1238 (void) WriteBlobLSBShort(image,dib_info.bits_per_pixel);
1239 (void) WriteBlobLSBLong(image,(unsigned int) dib_info.compression);
1240 (void) WriteBlobLSBLong(image,(unsigned int) dib_info.image_size);
1241 (void) WriteBlobLSBLong(image,(unsigned int) dib_info.x_pixels);
1242 (void) WriteBlobLSBLong(image,(unsigned int) dib_info.y_pixels);
1243 (void) WriteBlobLSBLong(image,(unsigned int) dib_info.number_colors);
1244 (void) WriteBlobLSBLong(image,(unsigned int) dib_info.colors_important);
1245 if (image->storage_class == PseudoClass)
1247 if (dib_info.bits_per_pixel <= 8)
1253 Dump colormap to file.
1255 dib_colormap=(unsigned char *) AcquireQuantumMemory((size_t)
1256 (1UL << dib_info.bits_per_pixel),4*sizeof(dib_colormap));
1257 if (dib_colormap == (unsigned char *) NULL)
1258 ThrowWriterException(ResourceLimitError,"MemoryAllocationFailed");
1260 for (i=0; i < (ssize_t) MagickMin(image->colors,dib_info.number_colors); i++)
1262 *q++=ScaleQuantumToChar(image->colormap[i].blue);
1263 *q++=ScaleQuantumToChar(image->colormap[i].green);
1264 *q++=ScaleQuantumToChar(image->colormap[i].red);
1267 for ( ; i < (ssize_t) (1L << dib_info.bits_per_pixel); i++)
1274 (void) WriteBlob(image,(size_t) (4*(1 << dib_info.bits_per_pixel)),
1276 dib_colormap=(unsigned char *) RelinquishMagickMemory(dib_colormap);
1279 if ((dib_info.bits_per_pixel == 16) &&
1280 (dib_info.compression == BI_BITFIELDS))
1282 (void) WriteBlobLSBLong(image,0xf800);
1283 (void) WriteBlobLSBLong(image,0x07e0);
1284 (void) WriteBlobLSBLong(image,0x001f);
1287 (void) WriteBlob(image,dib_info.image_size,pixels);
1288 pixels=(unsigned char *) RelinquishMagickMemory(pixels);
1289 (void) CloseBlob(image);