2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
13 % Read/Write Microsoft Windows Bitmap Image Format %
17 % Glenn Randers-Pehrson %
21 % Copyright 1999-2018 ImageMagick Studio LLC, a non-profit organization %
22 % dedicated to making software imaging solutions freely available. %
24 % You may not use this file except in compliance with the License. You may %
25 % obtain a copy of the License at %
27 % https://imagemagick.org/script/license.php %
29 % Unless required by applicable law or agreed to in writing, software %
30 % distributed under the License is distributed on an "AS IS" BASIS, %
31 % WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. %
32 % See the License for the specific language governing permissions and %
33 % limitations under the License. %
35 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
43 #include "MagickCore/studio.h"
44 #include "MagickCore/blob.h"
45 #include "MagickCore/blob-private.h"
46 #include "MagickCore/cache.h"
47 #include "MagickCore/colormap-private.h"
48 #include "MagickCore/color-private.h"
49 #include "MagickCore/colormap.h"
50 #include "MagickCore/colorspace.h"
51 #include "MagickCore/colorspace-private.h"
52 #include "MagickCore/exception.h"
53 #include "MagickCore/exception-private.h"
54 #include "MagickCore/image.h"
55 #include "MagickCore/image-private.h"
56 #include "MagickCore/list.h"
57 #include "MagickCore/log.h"
58 #include "MagickCore/magick.h"
59 #include "MagickCore/memory_.h"
60 #include "MagickCore/monitor.h"
61 #include "MagickCore/monitor-private.h"
62 #include "MagickCore/option.h"
63 #include "MagickCore/pixel-accessor.h"
64 #include "MagickCore/profile.h"
65 #include "MagickCore/quantum-private.h"
66 #include "MagickCore/static.h"
67 #include "MagickCore/string_.h"
68 #include "MagickCore/module.h"
69 #include "MagickCore/transform.h"
72 Macro definitions (from Windows wingdi.h).
78 #if !defined(MAGICKCORE_WINDOWS_SUPPORT) || defined(__MINGW32__)
86 #define BI_BITFIELDS 3
88 #undef LCS_CALIBRATED_RBG
89 #define LCS_CALIBRATED_RBG 0
92 #undef LCS_WINDOWS_COLOR_SPACE
93 #define LCS_WINDOWS_COLOR_SPACE 2
95 #define PROFILE_LINKED 3
96 #undef PROFILE_EMBEDDED
97 #define PROFILE_EMBEDDED 4
99 #undef LCS_GM_BUSINESS
100 #define LCS_GM_BUSINESS 1 /* Saturation */
101 #undef LCS_GM_GRAPHICS
102 #define LCS_GM_GRAPHICS 2 /* Relative */
104 #define LCS_GM_IMAGES 4 /* Perceptual */
105 #undef LCS_GM_ABS_COLORIMETRIC
106 #define LCS_GM_ABS_COLORIMETRIC 8 /* Absolute */
110 Enumerated declaractions.
122 Typedef declarations.
124 typedef struct _BMPInfo
163 Forward declarations.
165 static MagickBooleanType
166 WriteBMPImage(const ImageInfo *,Image *,ExceptionInfo *);
169 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
173 % D e c o d e I m a g e %
177 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
179 % DecodeImage unpacks the packed image pixels into runlength-encoded
182 % The format of the DecodeImage method is:
184 % MagickBooleanType DecodeImage(Image *image,const size_t compression,
185 % unsigned char *pixels,const size_t number_pixels)
187 % A description of each parameter follows:
189 % o image: the address of a structure of type Image.
191 % o compression: Zero means uncompressed. A value of 1 means the
192 % compressed pixels are runlength encoded for a 256-color bitmap.
193 % A value of 2 means a 16-color bitmap. A value of 3 means bitfields
196 % o pixels: The address of a byte (8 bits) array of pixel data created by
197 % the decoding process.
199 % o number_pixels: The number of pixels.
202 static MagickBooleanType DecodeImage(Image *image,const size_t compression,
203 unsigned char *pixels,const size_t number_pixels)
213 register unsigned char
220 assert(image != (Image *) NULL);
221 assert(image->signature == MagickCoreSignature);
222 if (image->debug != MagickFalse)
223 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
224 assert(pixels != (unsigned char *) NULL);
225 (void) memset(pixels,0,number_pixels*sizeof(*pixels));
229 q=pixels+number_pixels;
230 for (y=0; y < (ssize_t) image->rows; )
235 if ((p < pixels) || (p > q))
237 count=ReadBlobByte(image);
245 count=(int) MagickMin((ssize_t) count,(ssize_t) (q-p));
246 byte=ReadBlobByte(image);
249 if (compression == BI_RLE8)
251 for (i=0; i < (ssize_t) count; i++)
252 *p++=(unsigned char) byte;
256 for (i=0; i < (ssize_t) count; i++)
258 ((i & 0x01) != 0 ? (byte & 0x0f) : ((byte >> 4) & 0x0f));
267 count=ReadBlobByte(image);
281 p=pixels+y*image->columns;
289 x+=ReadBlobByte(image);
290 y+=ReadBlobByte(image);
291 p=pixels+y*image->columns+x;
299 count=(int) MagickMin((ssize_t) count,(ssize_t) (q-p));
300 if (compression == BI_RLE8)
301 for (i=0; i < (ssize_t) count; i++)
303 byte=ReadBlobByte(image);
306 *p++=(unsigned char) byte;
309 for (i=0; i < (ssize_t) count; i++)
313 byte=ReadBlobByte(image);
318 ((i & 0x01) != 0 ? (byte & 0x0f) : ((byte >> 4) & 0x0f));
324 if (compression == BI_RLE8)
326 if ((count & 0x01) != 0)
327 if (ReadBlobByte(image) == EOF)
331 if (((count & 0x03) == 1) || ((count & 0x03) == 2))
332 if (ReadBlobByte(image) == EOF)
338 status=SetImageProgress(image,LoadImageTag,(MagickOffsetType) y,
340 if (status == MagickFalse)
343 (void) ReadBlobByte(image); /* end of line */
344 (void) ReadBlobByte(image);
345 return(y < (ssize_t) image->rows ? MagickFalse : MagickTrue);
349 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
353 % E n c o d e I m a g e %
357 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
359 % EncodeImage compresses pixels using a runlength encoded format.
361 % The format of the EncodeImage method is:
363 % static MagickBooleanType EncodeImage(Image *image,
364 % const size_t bytes_per_line,const unsigned char *pixels,
365 % unsigned char *compressed_pixels)
367 % A description of each parameter follows:
369 % o image: The image.
371 % o bytes_per_line: the number of bytes in a scanline of compressed pixels
373 % o pixels: The address of a byte (8 bits) array of pixel data created by
374 % the compression process.
376 % o compressed_pixels: The address of a byte (8 bits) array of compressed
380 static size_t EncodeImage(Image *image,const size_t bytes_per_line,
381 const unsigned char *pixels,unsigned char *compressed_pixels)
386 register const unsigned char
393 register unsigned char
400 Runlength encode pixels.
402 assert(image != (Image *) NULL);
403 assert(image->signature == MagickCoreSignature);
404 if (image->debug != MagickFalse)
405 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
406 assert(pixels != (const unsigned char *) NULL);
407 assert(compressed_pixels != (unsigned char *) NULL);
411 for (y=0; y < (ssize_t) image->rows; y++)
413 for (x=0; x < (ssize_t) bytes_per_line; x+=i)
418 for (i=1; ((x+i) < (ssize_t) bytes_per_line); i++)
419 if ((i == 255) || (*(p+i) != *p))
421 *q++=(unsigned char) i;
428 *q++=(unsigned char) 0x00;
429 *q++=(unsigned char) 0x00;
430 status=SetImageProgress(image,SaveImageTag,(MagickOffsetType) y,
432 if (status == MagickFalse)
438 *q++=(unsigned char) 0x00;
439 *q++=(unsigned char) 0x01;
440 return((size_t) (q-compressed_pixels));
444 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
452 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
454 % IsBMP() returns MagickTrue if the image format type, identified by the
455 % magick string, is BMP.
457 % The format of the IsBMP method is:
459 % MagickBooleanType IsBMP(const unsigned char *magick,const size_t length)
461 % A description of each parameter follows:
463 % o magick: compare image format pattern against these bytes.
465 % o length: Specifies the length of the magick string.
468 static MagickBooleanType IsBMP(const unsigned char *magick,const size_t length)
472 if ((LocaleNCompare((char *) magick,"BA",2) == 0) ||
473 (LocaleNCompare((char *) magick,"BM",2) == 0) ||
474 (LocaleNCompare((char *) magick,"IC",2) == 0) ||
475 (LocaleNCompare((char *) magick,"PI",2) == 0) ||
476 (LocaleNCompare((char *) magick,"CI",2) == 0) ||
477 (LocaleNCompare((char *) magick,"CP",2) == 0))
483 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
487 % R e a d B M P I m a g e %
491 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
493 % ReadBMPImage() reads a Microsoft Windows bitmap image file, Version
494 % 2, 3 (for Windows or NT), or 4, and returns it. It allocates the memory
495 % necessary for the new Image structure and returns a pointer to the new
498 % The format of the ReadBMPImage method is:
500 % image=ReadBMPImage(image_info)
502 % A description of each parameter follows:
504 % o image_info: the image info.
506 % o exception: return any errors or warnings in this structure.
510 static Image *ReadBMPImage(const ImageInfo *image_info,ExceptionInfo *exception)
538 register unsigned char
563 assert(image_info != (const ImageInfo *) NULL);
564 assert(image_info->signature == MagickCoreSignature);
565 if (image_info->debug != MagickFalse)
566 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",
567 image_info->filename);
568 assert(exception != (ExceptionInfo *) NULL);
569 assert(exception->signature == MagickCoreSignature);
570 image=AcquireImage(image_info,exception);
571 status=OpenBlob(image_info,image,ReadBinaryBlobMode,exception);
572 if (status == MagickFalse)
574 image=DestroyImageList(image);
575 return((Image *) NULL);
578 Determine if this a BMP file.
580 (void) memset(&bmp_info,0,sizeof(bmp_info));
581 bmp_info.ba_offset=0;
584 count=ReadBlob(image,2,magick);
586 ThrowReaderException(CorruptImageError,"ImproperImageHeader");
596 Verify BMP identifier.
598 start_position=TellBlob(image)-2;
599 bmp_info.ba_offset=0;
600 while (LocaleNCompare((char *) magick,"BA",2) == 0)
602 bmp_info.file_size=ReadBlobLSBLong(image);
603 bmp_info.ba_offset=ReadBlobLSBLong(image);
604 bmp_info.offset_bits=ReadBlobLSBLong(image);
605 count=ReadBlob(image,2,magick);
609 if (image->debug != MagickFalse)
610 (void) LogMagickEvent(CoderEvent,GetMagickModule()," Magick: %c%c",
611 magick[0],magick[1]);
612 if ((count != 2) || ((LocaleNCompare((char *) magick,"BM",2) != 0) &&
613 (LocaleNCompare((char *) magick,"CI",2) != 0)))
614 ThrowReaderException(CorruptImageError,"ImproperImageHeader");
615 bmp_info.file_size=ReadBlobLSBLong(image);
616 (void) ReadBlobLSBLong(image);
617 bmp_info.offset_bits=ReadBlobLSBLong(image);
618 bmp_info.size=ReadBlobLSBLong(image);
619 if (image->debug != MagickFalse)
620 (void) LogMagickEvent(CoderEvent,GetMagickModule()," BMP size: %u",
622 if (bmp_info.size == 12)
627 (void) CopyMagickString(image->magick,"BMP2",MagickPathExtent);
628 bmp_info.width=(ssize_t) ((short) ReadBlobLSBShort(image));
629 bmp_info.height=(ssize_t) ((short) ReadBlobLSBShort(image));
630 bmp_info.planes=ReadBlobLSBShort(image);
631 bmp_info.bits_per_pixel=ReadBlobLSBShort(image);
634 bmp_info.number_colors=0;
635 bmp_info.compression=BI_RGB;
636 bmp_info.image_size=0;
637 bmp_info.alpha_mask=0;
638 if (image->debug != MagickFalse)
640 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
641 " Format: OS/2 Bitmap");
642 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
643 " Geometry: %.20gx%.20g",(double) bmp_info.width,(double)
650 Microsoft Windows BMP image file.
652 if (bmp_info.size < 40)
653 ThrowReaderException(CorruptImageError,"NonOS2HeaderSizeError");
654 bmp_info.width=(ssize_t) ReadBlobLSBSignedLong(image);
655 bmp_info.height=(ssize_t) ReadBlobLSBSignedLong(image);
656 bmp_info.planes=ReadBlobLSBShort(image);
657 bmp_info.bits_per_pixel=ReadBlobLSBShort(image);
658 bmp_info.compression=ReadBlobLSBLong(image);
659 bmp_info.image_size=ReadBlobLSBLong(image);
660 bmp_info.x_pixels=ReadBlobLSBLong(image);
661 bmp_info.y_pixels=ReadBlobLSBLong(image);
662 bmp_info.number_colors=ReadBlobLSBLong(image);
663 if (bmp_info.number_colors > GetBlobSize(image))
664 ThrowReaderException(CorruptImageError,"InsufficientImageDataInFile");
665 bmp_info.colors_important=ReadBlobLSBLong(image);
666 if (image->debug != MagickFalse)
668 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
669 " Format: MS Windows bitmap");
670 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
671 " Geometry: %.20gx%.20g",(double) bmp_info.width,(double)
673 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
674 " Bits per pixel: %.20g",(double) bmp_info.bits_per_pixel);
675 switch (bmp_info.compression)
679 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
680 " Compression: BI_RGB");
685 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
686 " Compression: BI_RLE4");
691 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
692 " Compression: BI_RLE8");
697 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
698 " Compression: BI_BITFIELDS");
703 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
704 " Compression: BI_PNG");
709 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
710 " Compression: BI_JPEG");
715 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
716 " Compression: UNKNOWN (%u)",bmp_info.compression);
719 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
720 " Number of colors: %u",bmp_info.number_colors);
722 bmp_info.red_mask=ReadBlobLSBLong(image);
723 bmp_info.green_mask=ReadBlobLSBLong(image);
724 bmp_info.blue_mask=ReadBlobLSBLong(image);
725 if (bmp_info.size > 40)
731 Read color management information.
733 bmp_info.alpha_mask=ReadBlobLSBLong(image);
734 bmp_info.colorspace=ReadBlobLSBSignedLong(image);
736 Decode 2^30 fixed point formatted CIE primaries.
738 # define BMP_DENOM ((double) 0x40000000)
739 bmp_info.red_primary.x=(double) ReadBlobLSBLong(image)/BMP_DENOM;
740 bmp_info.red_primary.y=(double) ReadBlobLSBLong(image)/BMP_DENOM;
741 bmp_info.red_primary.z=(double) ReadBlobLSBLong(image)/BMP_DENOM;
742 bmp_info.green_primary.x=(double) ReadBlobLSBLong(image)/BMP_DENOM;
743 bmp_info.green_primary.y=(double) ReadBlobLSBLong(image)/BMP_DENOM;
744 bmp_info.green_primary.z=(double) ReadBlobLSBLong(image)/BMP_DENOM;
745 bmp_info.blue_primary.x=(double) ReadBlobLSBLong(image)/BMP_DENOM;
746 bmp_info.blue_primary.y=(double) ReadBlobLSBLong(image)/BMP_DENOM;
747 bmp_info.blue_primary.z=(double) ReadBlobLSBLong(image)/BMP_DENOM;
749 gamma=bmp_info.red_primary.x+bmp_info.red_primary.y+
750 bmp_info.red_primary.z;
751 gamma=PerceptibleReciprocal(gamma);
752 bmp_info.red_primary.x*=gamma;
753 bmp_info.red_primary.y*=gamma;
754 image->chromaticity.red_primary.x=bmp_info.red_primary.x;
755 image->chromaticity.red_primary.y=bmp_info.red_primary.y;
757 gamma=bmp_info.green_primary.x+bmp_info.green_primary.y+
758 bmp_info.green_primary.z;
759 gamma=PerceptibleReciprocal(gamma);
760 bmp_info.green_primary.x*=gamma;
761 bmp_info.green_primary.y*=gamma;
762 image->chromaticity.green_primary.x=bmp_info.green_primary.x;
763 image->chromaticity.green_primary.y=bmp_info.green_primary.y;
765 gamma=bmp_info.blue_primary.x+bmp_info.blue_primary.y+
766 bmp_info.blue_primary.z;
767 gamma=PerceptibleReciprocal(gamma);
768 bmp_info.blue_primary.x*=gamma;
769 bmp_info.blue_primary.y*=gamma;
770 image->chromaticity.blue_primary.x=bmp_info.blue_primary.x;
771 image->chromaticity.blue_primary.y=bmp_info.blue_primary.y;
774 Decode 16^16 fixed point formatted gamma_scales.
776 bmp_info.gamma_scale.x=(double) ReadBlobLSBLong(image)/0x10000;
777 bmp_info.gamma_scale.y=(double) ReadBlobLSBLong(image)/0x10000;
778 bmp_info.gamma_scale.z=(double) ReadBlobLSBLong(image)/0x10000;
780 Compute a single gamma from the BMP 3-channel gamma.
782 image->gamma=(bmp_info.gamma_scale.x+bmp_info.gamma_scale.y+
783 bmp_info.gamma_scale.z)/3.0;
786 (void) CopyMagickString(image->magick,"BMP3",MagickPathExtent);
788 if (bmp_info.size > 108)
794 Read BMP Version 5 color management information.
796 intent=ReadBlobLSBLong(image);
797 switch ((int) intent)
799 case LCS_GM_BUSINESS:
801 image->rendering_intent=SaturationIntent;
804 case LCS_GM_GRAPHICS:
806 image->rendering_intent=RelativeIntent;
811 image->rendering_intent=PerceptualIntent;
814 case LCS_GM_ABS_COLORIMETRIC:
816 image->rendering_intent=AbsoluteIntent;
820 (void) ReadBlobLSBLong(image); /* Profile data */
821 (void) ReadBlobLSBLong(image); /* Profile size */
822 (void) ReadBlobLSBLong(image); /* Reserved byte */
825 if ((MagickSizeType) bmp_info.file_size > GetBlobSize(image))
826 (void) ThrowMagickException(exception,GetMagickModule(),CorruptImageError,
827 "LengthAndFilesizeDoNotMatch","`%s'",image->filename);
829 if ((MagickSizeType) bmp_info.file_size < GetBlobSize(image))
830 (void) ThrowMagickException(exception,GetMagickModule(),
831 CorruptImageWarning,"LengthAndFilesizeDoNotMatch","`%s'",
833 if (bmp_info.width <= 0)
834 ThrowReaderException(CorruptImageError,"NegativeOrZeroImageSize");
835 if (bmp_info.height == 0)
836 ThrowReaderException(CorruptImageError,"NegativeOrZeroImageSize");
837 if (bmp_info.planes != 1)
838 ThrowReaderException(CorruptImageError,"StaticPlanesValueNotEqualToOne");
839 if ((bmp_info.bits_per_pixel != 1) && (bmp_info.bits_per_pixel != 4) &&
840 (bmp_info.bits_per_pixel != 8) && (bmp_info.bits_per_pixel != 16) &&
841 (bmp_info.bits_per_pixel != 24) && (bmp_info.bits_per_pixel != 32))
842 ThrowReaderException(CorruptImageError,"UnrecognizedBitsPerPixel");
843 if (bmp_info.bits_per_pixel < 16 &&
844 bmp_info.number_colors > (1U << bmp_info.bits_per_pixel))
845 ThrowReaderException(CorruptImageError,"UnrecognizedNumberOfColors");
846 if ((bmp_info.compression == 1) && (bmp_info.bits_per_pixel != 8))
847 ThrowReaderException(CorruptImageError,"UnrecognizedBitsPerPixel");
848 if ((bmp_info.compression == 2) && (bmp_info.bits_per_pixel != 4))
849 ThrowReaderException(CorruptImageError,"UnrecognizedBitsPerPixel");
850 if ((bmp_info.compression == 3) && (bmp_info.bits_per_pixel < 16))
851 ThrowReaderException(CorruptImageError,"UnrecognizedBitsPerPixel");
852 switch (bmp_info.compression)
855 image->compression=NoCompression;
859 image->compression=RLECompression;
864 ThrowReaderException(CoderError,"JPEGCompressNotSupported");
866 ThrowReaderException(CoderError,"PNGCompressNotSupported");
868 ThrowReaderException(CorruptImageError,"UnrecognizedImageCompression");
870 image->columns=(size_t) MagickAbsoluteValue(bmp_info.width);
871 image->rows=(size_t) MagickAbsoluteValue(bmp_info.height);
872 image->depth=bmp_info.bits_per_pixel <= 8 ? bmp_info.bits_per_pixel : 8;
873 image->alpha_trait=((bmp_info.alpha_mask != 0) &&
874 (bmp_info.compression == BI_BITFIELDS)) ? BlendPixelTrait :
876 if (bmp_info.bits_per_pixel < 16)
881 image->storage_class=PseudoClass;
882 image->colors=bmp_info.number_colors;
884 if (image->colors == 0)
885 image->colors=one << bmp_info.bits_per_pixel;
887 image->resolution.x=(double) bmp_info.x_pixels/100.0;
888 image->resolution.y=(double) bmp_info.y_pixels/100.0;
889 image->units=PixelsPerCentimeterResolution;
890 if ((image_info->ping != MagickFalse) && (image_info->number_scenes != 0))
891 if (image->scene >= (image_info->scene+image_info->number_scenes-1))
893 status=SetImageExtent(image,image->columns,image->rows,exception);
894 if (status == MagickFalse)
895 return(DestroyImageList(image));
896 if (image->storage_class == PseudoClass)
905 Read BMP raster colormap.
907 if (image->debug != MagickFalse)
908 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
909 " Reading colormap of %.20g colors",(double) image->colors);
910 if (AcquireImageColormap(image,image->colors,exception) == MagickFalse)
911 ThrowReaderException(ResourceLimitError,"MemoryAllocationFailed");
912 bmp_colormap=(unsigned char *) AcquireQuantumMemory((size_t)
913 image->colors,4*sizeof(*bmp_colormap));
914 if (bmp_colormap == (unsigned char *) NULL)
915 ThrowReaderException(ResourceLimitError,"MemoryAllocationFailed");
916 if ((bmp_info.size == 12) || (bmp_info.size == 64))
920 offset=SeekBlob(image,start_position+14+bmp_info.size,SEEK_SET);
923 bmp_colormap=(unsigned char *) RelinquishMagickMemory(bmp_colormap);
924 ThrowReaderException(CorruptImageError,"ImproperImageHeader");
926 count=ReadBlob(image,packet_size*image->colors,bmp_colormap);
927 if (count != (ssize_t) (packet_size*image->colors))
929 bmp_colormap=(unsigned char *) RelinquishMagickMemory(bmp_colormap);
930 ThrowReaderException(CorruptImageError,
931 "InsufficientImageDataInFile");
934 for (i=0; i < (ssize_t) image->colors; i++)
936 image->colormap[i].blue=(MagickRealType) ScaleCharToQuantum(*p++);
937 image->colormap[i].green=(MagickRealType) ScaleCharToQuantum(*p++);
938 image->colormap[i].red=(MagickRealType) ScaleCharToQuantum(*p++);
939 if (packet_size == 4)
942 bmp_colormap=(unsigned char *) RelinquishMagickMemory(bmp_colormap);
947 if (bmp_info.offset_bits == offset_bits)
948 ThrowReaderException(CorruptImageError,"ImproperImageHeader");
949 offset_bits=bmp_info.offset_bits;
950 offset=SeekBlob(image,start_position+bmp_info.offset_bits,SEEK_SET);
952 ThrowReaderException(CorruptImageError,"ImproperImageHeader");
953 if (bmp_info.compression == BI_RLE4)
954 bmp_info.bits_per_pixel<<=1;
955 bytes_per_line=4*((image->columns*bmp_info.bits_per_pixel+31)/32);
956 length=(size_t) bytes_per_line*image->rows;
957 if (((MagickSizeType) length/8) > GetBlobSize(image))
958 ThrowReaderException(CorruptImageError,"InsufficientImageDataInFile");
959 if ((bmp_info.compression == BI_RGB) ||
960 (bmp_info.compression == BI_BITFIELDS))
962 pixel_info=AcquireVirtualMemory(image->rows,
963 MagickMax(bytes_per_line,image->columns+256UL)*sizeof(*pixels));
964 if (pixel_info == (MemoryInfo *) NULL)
965 ThrowReaderException(ResourceLimitError,"MemoryAllocationFailed");
966 pixels=(unsigned char *) GetVirtualMemoryBlob(pixel_info);
967 if (image->debug != MagickFalse)
968 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
969 " Reading pixels (%.20g bytes)",(double) length);
970 count=ReadBlob(image,length,pixels);
971 if (count != (ssize_t) length)
973 pixel_info=RelinquishVirtualMemory(pixel_info);
974 ThrowReaderException(CorruptImageError,
975 "InsufficientImageDataInFile");
981 Convert run-length encoded raster pixels.
983 pixel_info=AcquireVirtualMemory(image->rows,
984 MagickMax(bytes_per_line,image->columns+256UL)*sizeof(*pixels));
985 if (pixel_info == (MemoryInfo *) NULL)
986 ThrowReaderException(ResourceLimitError,"MemoryAllocationFailed");
987 pixels=(unsigned char *) GetVirtualMemoryBlob(pixel_info);
988 status=DecodeImage(image,bmp_info.compression,pixels,
989 image->columns*image->rows);
990 if (status == MagickFalse)
992 pixel_info=RelinquishVirtualMemory(pixel_info);
993 ThrowReaderException(CorruptImageError,
994 "UnableToRunlengthDecodeImage");
998 Convert BMP raster image to pixel packets.
1000 if (bmp_info.compression == BI_RGB)
1003 We should ignore the alpha value in BMP3 files but there have been
1004 reports about 32 bit files with alpha. We do a quick check to see if
1005 the alpha channel contains a value that is not zero (default value).
1006 If we find a non zero value we asume the program that wrote the file
1007 wants to use the alpha channel.
1009 if ((image->alpha_trait == UndefinedPixelTrait) && (bmp_info.size == 40) &&
1010 (bmp_info.bits_per_pixel == 32))
1012 bytes_per_line=4*(image->columns);
1013 for (y=(ssize_t) image->rows-1; y >= 0; y--)
1015 p=pixels+(image->rows-y-1)*bytes_per_line;
1016 for (x=0; x < (ssize_t) image->columns; x++)
1020 image->alpha_trait=BlendPixelTrait;
1028 bmp_info.alpha_mask=image->alpha_trait != UndefinedPixelTrait ?
1030 bmp_info.red_mask=0x00ff0000U;
1031 bmp_info.green_mask=0x0000ff00U;
1032 bmp_info.blue_mask=0x000000ffU;
1033 if (bmp_info.bits_per_pixel == 16)
1038 bmp_info.red_mask=0x00007c00U;
1039 bmp_info.green_mask=0x000003e0U;
1040 bmp_info.blue_mask=0x0000001fU;
1043 (void) memset(&shift,0,sizeof(shift));
1044 (void) memset(&quantum_bits,0,sizeof(quantum_bits));
1045 if ((bmp_info.bits_per_pixel == 16) || (bmp_info.bits_per_pixel == 32))
1047 register unsigned int
1051 Get shift and quantum bits info from bitfield masks.
1053 if (bmp_info.red_mask != 0)
1054 while (((bmp_info.red_mask << shift.red) & 0x80000000UL) == 0)
1057 if (shift.red >= 32U)
1060 if (bmp_info.green_mask != 0)
1061 while (((bmp_info.green_mask << shift.green) & 0x80000000UL) == 0)
1064 if (shift.green >= 32U)
1067 if (bmp_info.blue_mask != 0)
1068 while (((bmp_info.blue_mask << shift.blue) & 0x80000000UL) == 0)
1071 if (shift.blue >= 32U)
1074 if (bmp_info.alpha_mask != 0)
1075 while (((bmp_info.alpha_mask << shift.alpha) & 0x80000000UL) == 0)
1078 if (shift.alpha >= 32U)
1082 while (((bmp_info.red_mask << sample) & 0x80000000UL) != 0)
1088 quantum_bits.red=(MagickRealType) (sample-shift.red);
1090 while (((bmp_info.green_mask << sample) & 0x80000000UL) != 0)
1096 quantum_bits.green=(MagickRealType) (sample-shift.green);
1098 while (((bmp_info.blue_mask << sample) & 0x80000000UL) != 0)
1104 quantum_bits.blue=(MagickRealType) (sample-shift.blue);
1106 while (((bmp_info.alpha_mask << sample) & 0x80000000UL) != 0)
1112 quantum_bits.alpha=(MagickRealType) (sample-shift.alpha);
1114 switch (bmp_info.bits_per_pixel)
1119 Convert bitmap scanline.
1121 for (y=(ssize_t) image->rows-1; y >= 0; y--)
1123 p=pixels+(image->rows-y-1)*bytes_per_line;
1124 q=QueueAuthenticPixels(image,0,y,image->columns,1,exception);
1125 if (q == (Quantum *) NULL)
1127 for (x=0; x < ((ssize_t) image->columns-7); x+=8)
1129 for (bit=0; bit < 8; bit++)
1131 index=(Quantum) (((*p) & (0x80 >> bit)) != 0 ? 0x01 : 0x00);
1132 SetPixelIndex(image,index,q);
1133 q+=GetPixelChannels(image);
1137 if ((image->columns % 8) != 0)
1139 for (bit=0; bit < (image->columns % 8); bit++)
1141 index=(Quantum) (((*p) & (0x80 >> bit)) != 0 ? 0x01 : 0x00);
1142 SetPixelIndex(image,index,q);
1143 q+=GetPixelChannels(image);
1147 if (SyncAuthenticPixels(image,exception) == MagickFalse)
1149 if (image->previous == (Image *) NULL)
1151 status=SetImageProgress(image,LoadImageTag,(MagickOffsetType)
1152 (image->rows-y),image->rows);
1153 if (status == MagickFalse)
1157 (void) SyncImage(image,exception);
1163 Convert PseudoColor scanline.
1165 for (y=(ssize_t) image->rows-1; y >= 0; y--)
1167 p=pixels+(image->rows-y-1)*bytes_per_line;
1168 q=QueueAuthenticPixels(image,0,y,image->columns,1,exception);
1169 if (q == (Quantum *) NULL)
1171 for (x=0; x < ((ssize_t) image->columns-1); x+=2)
1173 ValidateColormapValue(image,(ssize_t) ((*p >> 4) & 0x0f),&index,
1175 SetPixelIndex(image,index,q);
1176 q+=GetPixelChannels(image);
1177 ValidateColormapValue(image,(ssize_t) (*p & 0x0f),&index,exception);
1178 SetPixelIndex(image,index,q);
1179 q+=GetPixelChannels(image);
1182 if ((image->columns % 2) != 0)
1184 ValidateColormapValue(image,(ssize_t) ((*p >> 4) & 0xf),&index,
1186 SetPixelIndex(image,index,q);
1187 q+=GetPixelChannels(image);
1191 if (x < (ssize_t) image->columns)
1193 if (SyncAuthenticPixels(image,exception) == MagickFalse)
1195 if (image->previous == (Image *) NULL)
1197 status=SetImageProgress(image,LoadImageTag,(MagickOffsetType)
1198 (image->rows-y),image->rows);
1199 if (status == MagickFalse)
1203 (void) SyncImage(image,exception);
1209 Convert PseudoColor scanline.
1211 if ((bmp_info.compression == BI_RLE8) ||
1212 (bmp_info.compression == BI_RLE4))
1213 bytes_per_line=image->columns;
1214 for (y=(ssize_t) image->rows-1; y >= 0; y--)
1216 p=pixels+(image->rows-y-1)*bytes_per_line;
1217 q=QueueAuthenticPixels(image,0,y,image->columns,1,exception);
1218 if (q == (Quantum *) NULL)
1220 for (x=(ssize_t) image->columns; x != 0; --x)
1222 ValidateColormapValue(image,(ssize_t) *p++,&index,exception);
1223 SetPixelIndex(image,index,q);
1224 q+=GetPixelChannels(image);
1226 if (SyncAuthenticPixels(image,exception) == MagickFalse)
1228 offset=(MagickOffsetType) (image->rows-y-1);
1229 if (image->previous == (Image *) NULL)
1231 status=SetImageProgress(image,LoadImageTag,(MagickOffsetType)
1232 (image->rows-y),image->rows);
1233 if (status == MagickFalse)
1237 (void) SyncImage(image,exception);
1247 Convert bitfield encoded 16-bit PseudoColor scanline.
1249 if ((bmp_info.compression != BI_RGB) &&
1250 (bmp_info.compression != BI_BITFIELDS))
1252 pixel_info=RelinquishVirtualMemory(pixel_info);
1253 ThrowReaderException(CorruptImageError,
1254 "UnrecognizedImageCompression");
1256 bytes_per_line=2*(image->columns+image->columns % 2);
1257 image->storage_class=DirectClass;
1258 for (y=(ssize_t) image->rows-1; y >= 0; y--)
1260 p=pixels+(image->rows-y-1)*bytes_per_line;
1261 q=QueueAuthenticPixels(image,0,y,image->columns,1,exception);
1262 if (q == (Quantum *) NULL)
1264 for (x=0; x < (ssize_t) image->columns; x++)
1266 pixel=(unsigned int) (*p++);
1268 red=((pixel & bmp_info.red_mask) << shift.red) >> 16;
1269 if (quantum_bits.red == 5)
1270 red|=((red & 0xe000) >> 5);
1271 if (quantum_bits.red <= 8)
1272 red|=((red & 0xff00) >> 8);
1273 green=((pixel & bmp_info.green_mask) << shift.green) >> 16;
1274 if (quantum_bits.green == 5)
1275 green|=((green & 0xe000) >> 5);
1276 if (quantum_bits.green == 6)
1277 green|=((green & 0xc000) >> 6);
1278 if (quantum_bits.green <= 8)
1279 green|=((green & 0xff00) >> 8);
1280 blue=((pixel & bmp_info.blue_mask) << shift.blue) >> 16;
1281 if (quantum_bits.blue == 5)
1282 blue|=((blue & 0xe000) >> 5);
1283 if (quantum_bits.blue <= 8)
1284 blue|=((blue & 0xff00) >> 8);
1285 SetPixelRed(image,ScaleShortToQuantum((unsigned short) red),q);
1286 SetPixelGreen(image,ScaleShortToQuantum((unsigned short) green),q);
1287 SetPixelBlue(image,ScaleShortToQuantum((unsigned short) blue),q);
1288 SetPixelAlpha(image,OpaqueAlpha,q);
1289 if (image->alpha_trait != UndefinedPixelTrait)
1291 alpha=((pixel & bmp_info.alpha_mask) << shift.alpha) >> 16;
1292 if (quantum_bits.alpha <= 8)
1293 alpha|=((alpha & 0xff00) >> 8);
1294 SetPixelAlpha(image,ScaleShortToQuantum(
1295 (unsigned short) alpha),q);
1297 q+=GetPixelChannels(image);
1299 if (SyncAuthenticPixels(image,exception) == MagickFalse)
1301 offset=(MagickOffsetType) (image->rows-y-1);
1302 if (image->previous == (Image *) NULL)
1304 status=SetImageProgress(image,LoadImageTag,(MagickOffsetType)
1305 (image->rows-y),image->rows);
1306 if (status == MagickFalse)
1315 Convert DirectColor scanline.
1317 bytes_per_line=4*((image->columns*24+31)/32);
1318 for (y=(ssize_t) image->rows-1; y >= 0; y--)
1320 p=pixels+(image->rows-y-1)*bytes_per_line;
1321 q=QueueAuthenticPixels(image,0,y,image->columns,1,exception);
1322 if (q == (Quantum *) NULL)
1324 for (x=0; x < (ssize_t) image->columns; x++)
1326 SetPixelBlue(image,ScaleCharToQuantum(*p++),q);
1327 SetPixelGreen(image,ScaleCharToQuantum(*p++),q);
1328 SetPixelRed(image,ScaleCharToQuantum(*p++),q);
1329 SetPixelAlpha(image,OpaqueAlpha,q);
1330 q+=GetPixelChannels(image);
1332 if (SyncAuthenticPixels(image,exception) == MagickFalse)
1334 offset=(MagickOffsetType) (image->rows-y-1);
1335 if (image->previous == (Image *) NULL)
1337 status=SetImageProgress(image,LoadImageTag,(MagickOffsetType)
1338 (image->rows-y),image->rows);
1339 if (status == MagickFalse)
1348 Convert bitfield encoded DirectColor scanline.
1350 if ((bmp_info.compression != BI_RGB) &&
1351 (bmp_info.compression != BI_BITFIELDS))
1353 pixel_info=RelinquishVirtualMemory(pixel_info);
1354 ThrowReaderException(CorruptImageError,
1355 "UnrecognizedImageCompression");
1357 bytes_per_line=4*(image->columns);
1358 for (y=(ssize_t) image->rows-1; y >= 0; y--)
1364 p=pixels+(image->rows-y-1)*bytes_per_line;
1365 q=QueueAuthenticPixels(image,0,y,image->columns,1,exception);
1366 if (q == (Quantum *) NULL)
1368 for (x=0; x < (ssize_t) image->columns; x++)
1370 pixel=(unsigned int) (*p++);
1371 pixel|=((unsigned int) *p++ << 8);
1372 pixel|=((unsigned int) *p++ << 16);
1373 pixel|=((unsigned int) *p++ << 24);
1374 red=((pixel & bmp_info.red_mask) << shift.red) >> 16;
1375 if (quantum_bits.red == 8)
1377 green=((pixel & bmp_info.green_mask) << shift.green) >> 16;
1378 if (quantum_bits.green == 8)
1379 green|=(green >> 8);
1380 blue=((pixel & bmp_info.blue_mask) << shift.blue) >> 16;
1381 if (quantum_bits.blue == 8)
1383 SetPixelRed(image,ScaleShortToQuantum((unsigned short) red),q);
1384 SetPixelGreen(image,ScaleShortToQuantum((unsigned short) green),q);
1385 SetPixelBlue(image,ScaleShortToQuantum((unsigned short) blue),q);
1386 SetPixelAlpha(image,OpaqueAlpha,q);
1387 if (image->alpha_trait != UndefinedPixelTrait)
1389 alpha=((pixel & bmp_info.alpha_mask) << shift.alpha) >> 16;
1390 if (quantum_bits.alpha == 8)
1391 alpha|=(alpha >> 8);
1392 SetPixelAlpha(image,ScaleShortToQuantum(
1393 (unsigned short) alpha),q);
1395 q+=GetPixelChannels(image);
1397 if (SyncAuthenticPixels(image,exception) == MagickFalse)
1399 offset=(MagickOffsetType) (image->rows-y-1);
1400 if (image->previous == (Image *) NULL)
1402 status=SetImageProgress(image,LoadImageTag,(MagickOffsetType)
1403 (image->rows-y),image->rows);
1404 if (status == MagickFalse)
1412 pixel_info=RelinquishVirtualMemory(pixel_info);
1413 ThrowReaderException(CorruptImageError,"ImproperImageHeader");
1416 pixel_info=RelinquishVirtualMemory(pixel_info);
1419 if (EOFBlob(image) != MagickFalse)
1421 ThrowFileException(exception,CorruptImageError,"UnexpectedEndOfFile",
1425 if (bmp_info.height < 0)
1431 Correct image orientation.
1433 flipped_image=FlipImage(image,exception);
1434 if (flipped_image != (Image *) NULL)
1436 DuplicateBlob(flipped_image,image);
1437 ReplaceImageInList(&image, flipped_image);
1438 image=flipped_image;
1442 Proceed to next image.
1444 if (image_info->number_scenes != 0)
1445 if (image->scene >= (image_info->scene+image_info->number_scenes-1))
1448 if (bmp_info.ba_offset != 0)
1450 offset=SeekBlob(image,(MagickOffsetType) bmp_info.ba_offset,SEEK_SET);
1452 ThrowReaderException(CorruptImageError,"ImproperImageHeader");
1454 count=ReadBlob(image,2,magick);
1455 if ((count == 2) && (IsBMP(magick,2) != MagickFalse))
1458 Acquire next image structure.
1460 AcquireNextImage(image_info,image,exception);
1461 if (GetNextImageInList(image) == (Image *) NULL)
1464 return((Image *) NULL);
1466 image=SyncNextImageInList(image);
1467 status=SetImageProgress(image,LoadImagesTag,TellBlob(image),
1468 GetBlobSize(image));
1469 if (status == MagickFalse)
1472 } while (IsBMP(magick,2) != MagickFalse);
1473 (void) CloseBlob(image);
1474 if (status == MagickFalse)
1475 return(DestroyImageList(image));
1476 return(GetFirstImageInList(image));
1480 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1484 % R e g i s t e r B M P I m a g e %
1488 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1490 % RegisterBMPImage() adds attributes for the BMP image format to
1491 % the list of supported formats. The attributes include the image format
1492 % tag, a method to read and/or write the format, whether the format
1493 % supports the saving of more than one frame to the same file or blob,
1494 % whether the format supports native in-memory I/O, and a brief
1495 % description of the format.
1497 % The format of the RegisterBMPImage method is:
1499 % size_t RegisterBMPImage(void)
1502 ModuleExport size_t RegisterBMPImage(void)
1507 entry=AcquireMagickInfo("BMP","BMP","Microsoft Windows bitmap image");
1508 entry->decoder=(DecodeImageHandler *) ReadBMPImage;
1509 entry->encoder=(EncodeImageHandler *) WriteBMPImage;
1510 entry->magick=(IsImageFormatHandler *) IsBMP;
1511 entry->flags^=CoderAdjoinFlag;
1512 entry->flags|=CoderDecoderSeekableStreamFlag;
1513 (void) RegisterMagickInfo(entry);
1514 entry=AcquireMagickInfo("BMP","BMP2","Microsoft Windows bitmap image (V2)");
1515 entry->decoder=(DecodeImageHandler *) ReadBMPImage;
1516 entry->encoder=(EncodeImageHandler *) WriteBMPImage;
1517 entry->magick=(IsImageFormatHandler *) IsBMP;
1518 entry->flags^=CoderAdjoinFlag;
1519 entry->flags|=CoderDecoderSeekableStreamFlag;
1520 (void) RegisterMagickInfo(entry);
1521 entry=AcquireMagickInfo("BMP","BMP3","Microsoft Windows bitmap image (V3)");
1522 entry->decoder=(DecodeImageHandler *) ReadBMPImage;
1523 entry->encoder=(EncodeImageHandler *) WriteBMPImage;
1524 entry->magick=(IsImageFormatHandler *) IsBMP;
1525 entry->flags^=CoderAdjoinFlag;
1526 entry->flags|=CoderDecoderSeekableStreamFlag;
1527 (void) RegisterMagickInfo(entry);
1528 return(MagickImageCoderSignature);
1532 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1536 % U n r e g i s t e r B M P I m a g e %
1540 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1542 % UnregisterBMPImage() removes format registrations made by the
1543 % BMP module from the list of supported formats.
1545 % The format of the UnregisterBMPImage method is:
1547 % UnregisterBMPImage(void)
1550 ModuleExport void UnregisterBMPImage(void)
1552 (void) UnregisterMagickInfo("BMP");
1553 (void) UnregisterMagickInfo("BMP2");
1554 (void) UnregisterMagickInfo("BMP3");
1558 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1562 % W r i t e B M P I m a g e %
1566 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1568 % WriteBMPImage() writes an image in Microsoft Windows bitmap encoded
1569 % image format, version 3 for Windows or (if the image has a matte channel)
1572 % The format of the WriteBMPImage method is:
1574 % MagickBooleanType WriteBMPImage(const ImageInfo *image_info,
1575 % Image *image,ExceptionInfo *exception)
1577 % A description of each parameter follows.
1579 % o image_info: the image info.
1581 % o image: The image.
1583 % o exception: return any errors or warnings in this structure.
1586 static MagickBooleanType WriteBMPImage(const ImageInfo *image_info,Image *image,
1587 ExceptionInfo *exception)
1611 register const Quantum
1618 register unsigned char
1634 Open output image file.
1636 assert(image_info != (const ImageInfo *) NULL);
1637 assert(image_info->signature == MagickCoreSignature);
1638 assert(image != (Image *) NULL);
1639 assert(image->signature == MagickCoreSignature);
1640 if (image->debug != MagickFalse)
1641 (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
1642 assert(exception != (ExceptionInfo *) NULL);
1643 assert(exception->signature == MagickCoreSignature);
1644 status=OpenBlob(image_info,image,WriteBinaryBlobMode,exception);
1645 if (status == MagickFalse)
1648 if (LocaleCompare(image_info->magick,"BMP2") == 0)
1651 if (LocaleCompare(image_info->magick,"BMP3") == 0)
1653 option=GetImageOption(image_info,"bmp:format");
1654 if (option != (char *) NULL)
1656 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
1657 " Format=%s",option);
1658 if (LocaleCompare(option,"bmp2") == 0)
1660 if (LocaleCompare(option,"bmp3") == 0)
1662 if (LocaleCompare(option,"bmp4") == 0)
1666 imageListLength=GetImageListLength(image);
1670 Initialize BMP raster file header.
1672 if (IssRGBCompatibleColorspace(image->colorspace) == MagickFalse)
1673 (void) TransformImageColorspace(image,sRGBColorspace,exception);
1674 (void) memset(&bmp_info,0,sizeof(bmp_info));
1675 bmp_info.file_size=14+12;
1677 bmp_info.file_size+=28;
1678 bmp_info.offset_bits=bmp_info.file_size;
1679 bmp_info.compression=BI_RGB;
1680 bmp_info.red_mask=0x00ff0000U;
1681 bmp_info.green_mask=0x0000ff00U;
1682 bmp_info.blue_mask=0x000000ffU;
1683 bmp_info.alpha_mask=0xff000000U;
1684 bmp_subtype=UndefinedSubtype;
1685 if ((image->storage_class == PseudoClass) && (image->colors > 256))
1686 (void) SetImageStorageClass(image,DirectClass,exception);
1687 if (image->storage_class != DirectClass)
1690 Colormapped BMP raster.
1692 bmp_info.bits_per_pixel=8;
1693 if (image->colors <= 2)
1694 bmp_info.bits_per_pixel=1;
1696 if (image->colors <= 16)
1697 bmp_info.bits_per_pixel=4;
1699 if (image->colors <= 256)
1700 bmp_info.bits_per_pixel=8;
1701 if (image_info->compression == RLECompression)
1702 bmp_info.bits_per_pixel=8;
1703 bmp_info.number_colors=1U << bmp_info.bits_per_pixel;
1704 if (image->alpha_trait != UndefinedPixelTrait)
1705 (void) SetImageStorageClass(image,DirectClass,exception);
1707 if ((size_t) bmp_info.number_colors < image->colors)
1708 (void) SetImageStorageClass(image,DirectClass,exception);
1711 bmp_info.file_size+=3*(1UL << bmp_info.bits_per_pixel);
1712 bmp_info.offset_bits+=3*(1UL << bmp_info.bits_per_pixel);
1715 bmp_info.file_size+=(1UL << bmp_info.bits_per_pixel);
1716 bmp_info.offset_bits+=(1UL << bmp_info.bits_per_pixel);
1720 if (image->storage_class == DirectClass)
1723 Full color BMP raster.
1725 bmp_info.number_colors=0;
1726 option=GetImageOption(image_info,"bmp:subtype");
1727 if (option != (const char *) NULL)
1729 if (image->alpha_trait != UndefinedPixelTrait)
1731 if (LocaleNCompare(option,"ARGB4444",8) == 0)
1733 bmp_subtype=ARGB4444;
1734 bmp_info.red_mask=0x00000f00U;
1735 bmp_info.green_mask=0x000000f0U;
1736 bmp_info.blue_mask=0x0000000fU;
1737 bmp_info.alpha_mask=0x0000f000U;
1739 else if (LocaleNCompare(option,"ARGB1555",8) == 0)
1741 bmp_subtype=ARGB1555;
1742 bmp_info.red_mask=0x00007c00U;
1743 bmp_info.green_mask=0x000003e0U;
1744 bmp_info.blue_mask=0x0000001fU;
1745 bmp_info.alpha_mask=0x00008000U;
1750 if (LocaleNCompare(option,"RGB555",6) == 0)
1753 bmp_info.red_mask=0x00007c00U;
1754 bmp_info.green_mask=0x000003e0U;
1755 bmp_info.blue_mask=0x0000001fU;
1756 bmp_info.alpha_mask=0U;
1758 else if (LocaleNCompare(option,"RGB565",6) == 0)
1761 bmp_info.red_mask=0x0000f800U;
1762 bmp_info.green_mask=0x000007e0U;
1763 bmp_info.blue_mask=0x0000001fU;
1764 bmp_info.alpha_mask=0U;
1768 if (bmp_subtype != UndefinedSubtype)
1770 bmp_info.bits_per_pixel=16;
1771 bmp_info.compression=BI_BITFIELDS;
1775 bmp_info.bits_per_pixel=(unsigned short) ((type > 3) &&
1776 (image->alpha_trait != UndefinedPixelTrait) ? 32 : 24);
1777 bmp_info.compression=(unsigned int) ((type > 3) &&
1778 (image->alpha_trait != UndefinedPixelTrait) ? BI_BITFIELDS : BI_RGB);
1779 if ((type == 3) && (image->alpha_trait != UndefinedPixelTrait))
1781 option=GetImageOption(image_info,"bmp3:alpha");
1782 if (IsStringTrue(option))
1783 bmp_info.bits_per_pixel=32;
1787 bytes_per_line=4*((image->columns*bmp_info.bits_per_pixel+31)/32);
1788 bmp_info.ba_offset=0;
1789 profile=GetImageProfile(image,"icc");
1790 have_color_info=(image->rendering_intent != UndefinedIntent) ||
1791 (profile != (StringInfo *) NULL) || (image->gamma != 0.0) ? MagickTrue :
1796 if ((type == 3) || ((image->alpha_trait == UndefinedPixelTrait) &&
1797 (have_color_info == MagickFalse)))
1809 if ((image->rendering_intent != UndefinedIntent) ||
1810 (profile != (StringInfo *) NULL))
1815 bmp_info.file_size+=extra_size;
1816 bmp_info.offset_bits+=extra_size;
1818 if (((ssize_t) image->columns != (ssize_t) ((signed int) image->columns)) ||
1819 ((ssize_t) image->rows != (ssize_t) ((signed int) image->rows)))
1820 ThrowWriterException(ImageError,"WidthOrHeightExceedsLimit");
1821 bmp_info.width=(ssize_t) image->columns;
1822 bmp_info.height=(ssize_t) image->rows;
1824 bmp_info.image_size=(unsigned int) (bytes_per_line*image->rows);
1825 bmp_info.file_size+=bmp_info.image_size;
1826 bmp_info.x_pixels=75*39;
1827 bmp_info.y_pixels=75*39;
1828 switch (image->units)
1830 case UndefinedResolution:
1831 case PixelsPerInchResolution:
1833 bmp_info.x_pixels=(unsigned int) (100.0*image->resolution.x/2.54);
1834 bmp_info.y_pixels=(unsigned int) (100.0*image->resolution.y/2.54);
1837 case PixelsPerCentimeterResolution:
1839 bmp_info.x_pixels=(unsigned int) (100.0*image->resolution.x);
1840 bmp_info.y_pixels=(unsigned int) (100.0*image->resolution.y);
1844 bmp_info.colors_important=bmp_info.number_colors;
1846 Convert MIFF to BMP raster pixels.
1848 pixel_info=AcquireVirtualMemory(image->rows,
1849 MagickMax(bytes_per_line,image->columns+256UL)*sizeof(*pixels));
1850 if (pixel_info == (MemoryInfo *) NULL)
1851 ThrowWriterException(ResourceLimitError,"MemoryAllocationFailed");
1852 pixels=(unsigned char *) GetVirtualMemoryBlob(pixel_info);
1853 (void) memset(pixels,0,(size_t) bmp_info.image_size);
1854 switch (bmp_info.bits_per_pixel)
1863 Convert PseudoClass image to a BMP monochrome image.
1865 for (y=0; y < (ssize_t) image->rows; y++)
1870 p=GetVirtualPixels(image,0,y,image->columns,1,exception);
1871 if (p == (const Quantum *) NULL)
1873 q=pixels+(image->rows-y-1)*bytes_per_line;
1876 for (x=0; x < (ssize_t) image->columns; x++)
1879 byte|=GetPixelIndex(image,p) != 0 ? 0x01 : 0x00;
1883 *q++=(unsigned char) byte;
1887 p+=GetPixelChannels(image);
1891 *q++=(unsigned char) (byte << (8-bit));
1894 offset=(ssize_t) (image->columns+7)/8;
1895 for (x=offset; x < (ssize_t) bytes_per_line; x++)
1897 if (image->previous == (Image *) NULL)
1899 status=SetImageProgress(image,SaveImageTag,(MagickOffsetType) y,
1901 if (status == MagickFalse)
1917 Convert PseudoClass image to a BMP monochrome image.
1919 for (y=0; y < (ssize_t) image->rows; y++)
1921 p=GetVirtualPixels(image,0,y,image->columns,1,exception);
1922 if (p == (const Quantum *) NULL)
1924 q=pixels+(image->rows-y-1)*bytes_per_line;
1927 for (x=0; x < (ssize_t) image->columns; x++)
1930 byte|=((unsigned int) GetPixelIndex(image,p) & 0x0f);
1934 *q++=(unsigned char) byte;
1938 p+=GetPixelChannels(image);
1942 *q++=(unsigned char) (byte << 4);
1945 offset=(ssize_t) (image->columns+1)/2;
1946 for (x=offset; x < (ssize_t) bytes_per_line; x++)
1948 if (image->previous == (Image *) NULL)
1950 status=SetImageProgress(image,SaveImageTag,(MagickOffsetType) y,
1952 if (status == MagickFalse)
1961 Convert PseudoClass packet to BMP pixel.
1963 for (y=0; y < (ssize_t) image->rows; y++)
1965 p=GetVirtualPixels(image,0,y,image->columns,1,exception);
1966 if (p == (const Quantum *) NULL)
1968 q=pixels+(image->rows-y-1)*bytes_per_line;
1969 for (x=0; x < (ssize_t) image->columns; x++)
1971 *q++=(unsigned char) GetPixelIndex(image,p);
1972 p+=GetPixelChannels(image);
1974 for ( ; x < (ssize_t) bytes_per_line; x++)
1976 if (image->previous == (Image *) NULL)
1978 status=SetImageProgress(image,SaveImageTag,(MagickOffsetType) y,
1980 if (status == MagickFalse)
1989 Convert DirectClass packet to BMP BGR888.
1991 for (y=0; y < (ssize_t) image->rows; y++)
1993 p=GetVirtualPixels(image,0,y,image->columns,1,exception);
1994 if (p == (const Quantum *) NULL)
1996 q=pixels+(image->rows-y-1)*bytes_per_line;
1997 for (x=0; x < (ssize_t) image->columns; x++)
2003 if (bmp_subtype == ARGB4444)
2005 pixel=(unsigned short) (ScaleQuantumToAny(
2006 GetPixelAlpha(image,p),15) << 12);
2007 pixel|=(unsigned short) (ScaleQuantumToAny(
2008 GetPixelRed(image,p),15) << 8);
2009 pixel|=(unsigned short) (ScaleQuantumToAny(
2010 GetPixelGreen(image,p),15) << 4);
2011 pixel|=(unsigned short) (ScaleQuantumToAny(
2012 GetPixelBlue(image,p),15));
2014 else if (bmp_subtype == RGB565)
2016 pixel=(unsigned short) (ScaleQuantumToAny(
2017 GetPixelRed(image,p),31) << 11);
2018 pixel|=(unsigned short) (ScaleQuantumToAny(
2019 GetPixelGreen(image,p),63) << 5);
2020 pixel|=(unsigned short) (ScaleQuantumToAny(
2021 GetPixelBlue(image,p),31));
2025 if (bmp_subtype == ARGB1555)
2026 pixel=(unsigned short) (ScaleQuantumToAny(
2027 GetPixelAlpha(image,p),1) << 15);
2028 pixel|=(unsigned short) (ScaleQuantumToAny(
2029 GetPixelRed(image,p),31) << 10);
2030 pixel|=(unsigned short) (ScaleQuantumToAny(
2031 GetPixelGreen(image,p),31) << 5);
2032 pixel|=(unsigned short) (ScaleQuantumToAny(
2033 GetPixelBlue(image,p),31));
2035 *((unsigned short *) q)=pixel;
2037 p+=GetPixelChannels(image);
2039 for (x=2L*(ssize_t) image->columns; x < (ssize_t) bytes_per_line; x++)
2041 if (image->previous == (Image *) NULL)
2043 status=SetImageProgress(image,SaveImageTag,(MagickOffsetType) y,
2045 if (status == MagickFalse)
2054 Convert DirectClass packet to BMP BGR888.
2056 for (y=0; y < (ssize_t) image->rows; y++)
2058 p=GetVirtualPixels(image,0,y,image->columns,1,exception);
2059 if (p == (const Quantum *) NULL)
2061 q=pixels+(image->rows-y-1)*bytes_per_line;
2062 for (x=0; x < (ssize_t) image->columns; x++)
2064 *q++=ScaleQuantumToChar(GetPixelBlue(image,p));
2065 *q++=ScaleQuantumToChar(GetPixelGreen(image,p));
2066 *q++=ScaleQuantumToChar(GetPixelRed(image,p));
2067 p+=GetPixelChannels(image);
2069 for (x=3L*(ssize_t) image->columns; x < (ssize_t) bytes_per_line; x++)
2071 if (image->previous == (Image *) NULL)
2073 status=SetImageProgress(image,SaveImageTag,(MagickOffsetType) y,
2075 if (status == MagickFalse)
2084 Convert DirectClass packet to ARGB8888 pixel.
2086 for (y=0; y < (ssize_t) image->rows; y++)
2088 p=GetVirtualPixels(image,0,y,image->columns,1,exception);
2089 if (p == (const Quantum *) NULL)
2091 q=pixels+(image->rows-y-1)*bytes_per_line;
2092 for (x=0; x < (ssize_t) image->columns; x++)
2094 *q++=ScaleQuantumToChar(GetPixelBlue(image,p));
2095 *q++=ScaleQuantumToChar(GetPixelGreen(image,p));
2096 *q++=ScaleQuantumToChar(GetPixelRed(image,p));
2097 *q++=ScaleQuantumToChar(GetPixelAlpha(image,p));
2098 p+=GetPixelChannels(image);
2100 if (image->previous == (Image *) NULL)
2102 status=SetImageProgress(image,SaveImageTag,(MagickOffsetType) y,
2104 if (status == MagickFalse)
2111 if ((type > 2) && (bmp_info.bits_per_pixel == 8))
2112 if (image_info->compression != NoCompression)
2118 Convert run-length encoded raster pixels.
2120 rle_info=AcquireVirtualMemory((size_t) (2*(bytes_per_line+2)+2),
2121 (image->rows+2)*sizeof(*pixels));
2122 if (rle_info == (MemoryInfo *) NULL)
2124 pixel_info=RelinquishVirtualMemory(pixel_info);
2125 ThrowWriterException(ResourceLimitError,"MemoryAllocationFailed");
2127 bmp_data=(unsigned char *) GetVirtualMemoryBlob(rle_info);
2128 bmp_info.file_size-=bmp_info.image_size;
2129 bmp_info.image_size=(unsigned int) EncodeImage(image,bytes_per_line,
2131 bmp_info.file_size+=bmp_info.image_size;
2132 pixel_info=RelinquishVirtualMemory(pixel_info);
2133 pixel_info=rle_info;
2135 bmp_info.compression=BI_RLE8;
2138 Write BMP for Windows, all versions, 14-byte header.
2140 if (image->debug != MagickFalse)
2142 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
2143 " Writing BMP version %.20g datastream",(double) type);
2144 if (image->storage_class == DirectClass)
2145 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
2146 " Storage class=DirectClass");
2148 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
2149 " Storage class=PseudoClass");
2150 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
2151 " Image depth=%.20g",(double) image->depth);
2152 if (image->alpha_trait != UndefinedPixelTrait)
2153 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
2156 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
2157 " Matte=MagickFalse");
2158 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
2159 " BMP bits_per_pixel=%.20g",(double) bmp_info.bits_per_pixel);
2160 switch ((int) bmp_info.compression)
2164 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
2165 " Compression=BI_RGB");
2170 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
2171 " Compression=BI_RLE8");
2176 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
2177 " Compression=BI_BITFIELDS");
2182 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
2183 " Compression=UNKNOWN (%u)",bmp_info.compression);
2187 if (bmp_info.number_colors == 0)
2188 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
2189 " Number_colors=unspecified");
2191 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
2192 " Number_colors=%u",bmp_info.number_colors);
2194 (void) WriteBlob(image,2,(unsigned char *) "BM");
2195 (void) WriteBlobLSBLong(image,bmp_info.file_size);
2196 (void) WriteBlobLSBLong(image,bmp_info.ba_offset); /* always 0 */
2197 (void) WriteBlobLSBLong(image,bmp_info.offset_bits);
2201 Write 12-byte version 2 bitmap header.
2203 (void) WriteBlobLSBLong(image,bmp_info.size);
2204 (void) WriteBlobLSBSignedShort(image,(signed short) bmp_info.width);
2205 (void) WriteBlobLSBSignedShort(image,(signed short) bmp_info.height);
2206 (void) WriteBlobLSBShort(image,bmp_info.planes);
2207 (void) WriteBlobLSBShort(image,bmp_info.bits_per_pixel);
2212 Write 40-byte version 3+ bitmap header.
2214 (void) WriteBlobLSBLong(image,bmp_info.size);
2215 (void) WriteBlobLSBSignedLong(image,(signed int) bmp_info.width);
2216 (void) WriteBlobLSBSignedLong(image,(signed int) bmp_info.height);
2217 (void) WriteBlobLSBShort(image,bmp_info.planes);
2218 (void) WriteBlobLSBShort(image,bmp_info.bits_per_pixel);
2219 (void) WriteBlobLSBLong(image,bmp_info.compression);
2220 (void) WriteBlobLSBLong(image,bmp_info.image_size);
2221 (void) WriteBlobLSBLong(image,bmp_info.x_pixels);
2222 (void) WriteBlobLSBLong(image,bmp_info.y_pixels);
2223 (void) WriteBlobLSBLong(image,bmp_info.number_colors);
2224 (void) WriteBlobLSBLong(image,bmp_info.colors_important);
2226 if ((type > 3) && ((image->alpha_trait != UndefinedPixelTrait) ||
2227 (have_color_info != MagickFalse)))
2230 Write the rest of the 108-byte BMP Version 4 header.
2232 (void) WriteBlobLSBLong(image,bmp_info.red_mask);
2233 (void) WriteBlobLSBLong(image,bmp_info.green_mask);
2234 (void) WriteBlobLSBLong(image,bmp_info.blue_mask);
2235 (void) WriteBlobLSBLong(image,bmp_info.alpha_mask);
2236 (void) WriteBlobLSBLong(image,0x73524742U); /* sRGB */
2237 (void) WriteBlobLSBLong(image,(unsigned int)
2238 (image->chromaticity.red_primary.x*0x40000000));
2239 (void) WriteBlobLSBLong(image,(unsigned int)
2240 (image->chromaticity.red_primary.y*0x40000000));
2241 (void) WriteBlobLSBLong(image,(unsigned int)
2242 ((1.000f-(image->chromaticity.red_primary.x+
2243 image->chromaticity.red_primary.y))*0x40000000));
2244 (void) WriteBlobLSBLong(image,(unsigned int)
2245 (image->chromaticity.green_primary.x*0x40000000));
2246 (void) WriteBlobLSBLong(image,(unsigned int)
2247 (image->chromaticity.green_primary.y*0x40000000));
2248 (void) WriteBlobLSBLong(image,(unsigned int)
2249 ((1.000f-(image->chromaticity.green_primary.x+
2250 image->chromaticity.green_primary.y))*0x40000000));
2251 (void) WriteBlobLSBLong(image,(unsigned int)
2252 (image->chromaticity.blue_primary.x*0x40000000));
2253 (void) WriteBlobLSBLong(image,(unsigned int)
2254 (image->chromaticity.blue_primary.y*0x40000000));
2255 (void) WriteBlobLSBLong(image,(unsigned int)
2256 ((1.000f-(image->chromaticity.blue_primary.x+
2257 image->chromaticity.blue_primary.y))*0x40000000));
2258 (void) WriteBlobLSBLong(image,(unsigned int)
2259 (bmp_info.gamma_scale.x*0x10000));
2260 (void) WriteBlobLSBLong(image,(unsigned int)
2261 (bmp_info.gamma_scale.y*0x10000));
2262 (void) WriteBlobLSBLong(image,(unsigned int)
2263 (bmp_info.gamma_scale.z*0x10000));
2264 if ((image->rendering_intent != UndefinedIntent) ||
2265 (profile != (StringInfo *) NULL))
2270 switch ((int) image->rendering_intent)
2272 case SaturationIntent:
2274 intent=LCS_GM_BUSINESS;
2277 case RelativeIntent:
2279 intent=LCS_GM_GRAPHICS;
2282 case PerceptualIntent:
2284 intent=LCS_GM_IMAGES;
2287 case AbsoluteIntent:
2289 intent=LCS_GM_ABS_COLORIMETRIC;
2298 (void) WriteBlobLSBLong(image,(unsigned int) intent);
2299 (void) WriteBlobLSBLong(image,0x00); /* dummy profile data */
2300 (void) WriteBlobLSBLong(image,0x00); /* dummy profile length */
2301 (void) WriteBlobLSBLong(image,0x00); /* reserved */
2304 if (image->storage_class == PseudoClass)
2310 Dump colormap to file.
2312 if (image->debug != MagickFalse)
2313 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
2314 " Colormap: %.20g entries",(double) image->colors);
2315 bmp_colormap=(unsigned char *) AcquireQuantumMemory((size_t) (1UL <<
2316 bmp_info.bits_per_pixel),4*sizeof(*bmp_colormap));
2317 if (bmp_colormap == (unsigned char *) NULL)
2318 ThrowWriterException(ResourceLimitError,"MemoryAllocationFailed");
2320 for (i=0; i < (ssize_t) MagickMin((ssize_t) image->colors,(ssize_t) bmp_info.number_colors); i++)
2322 *q++=ScaleQuantumToChar(ClampToQuantum(image->colormap[i].blue));
2323 *q++=ScaleQuantumToChar(ClampToQuantum(image->colormap[i].green));
2324 *q++=ScaleQuantumToChar(ClampToQuantum(image->colormap[i].red));
2326 *q++=(unsigned char) 0x0;
2328 for ( ; i < (ssize_t) (1UL << bmp_info.bits_per_pixel); i++)
2330 *q++=(unsigned char) 0x00;
2331 *q++=(unsigned char) 0x00;
2332 *q++=(unsigned char) 0x00;
2334 *q++=(unsigned char) 0x00;
2337 (void) WriteBlob(image,(size_t) (3*(1L << bmp_info.bits_per_pixel)),
2340 (void) WriteBlob(image,(size_t) (4*(1L << bmp_info.bits_per_pixel)),
2342 bmp_colormap=(unsigned char *) RelinquishMagickMemory(bmp_colormap);
2344 if (image->debug != MagickFalse)
2345 (void) LogMagickEvent(CoderEvent,GetMagickModule(),
2346 " Pixels: %u bytes",bmp_info.image_size);
2347 (void) WriteBlob(image,(size_t) bmp_info.image_size,pixels);
2348 pixel_info=RelinquishVirtualMemory(pixel_info);
2349 if (GetNextImageInList(image) == (Image *) NULL)
2351 image=SyncNextImageInList(image);
2352 status=SetImageProgress(image,SaveImagesTag,scene++,imageListLength);
2353 if (status == MagickFalse)
2355 } while (image_info->adjoin != MagickFalse);
2356 (void) CloseBlob(image);