| Safe Haskell | Safe-Inferred |
|---|---|
| Language | Haskell98 |
Codec.BMP
Description
Reading and writing uncompressed BMP files.
Supports uncompressed 24bit RGB and 32bit RGBA WindowsV3, WindowsV4 and WindowsV5 formats.
We don't support the plain OS/2 BitmapCoreHeader and BitmapCoreHeader2 image headers, but I haven't yet seen one of these in the wild.
To write a file do something like:
do let rgba = Data.ByteString.pack [some list of Word8s] let bmp = packRGBA32ToBMP width height rgba writeBMP fileName bmp
To read a file do something like:
do Right bmp <- readBMP fileName let rgba = unpackBMPToRGBA32 bmp let (width, height) = bmpDimensions bmp ...
Release Notes:
* bmp 1.2.5
Add support for writing uncompressed 32-bit files.
* bmp 1.2.4
Update to use binary 0.6.
* bmp 1.2.3
Add pure parseBMP / renderBMP API.
* bmp 1.2.2
Allow the physical image buffer to be larger than the image
size stated in the header, to accept output of foolish Win7 codec.Synopsis
- data BMP = BMP {}
- data FileHeader = FileHeader {}
- data BitmapInfo
- data BitmapInfoV3 = BitmapInfoV3 {}
- data BitmapInfoV4 = BitmapInfoV4 {}
- data BitmapInfoV5 = BitmapInfoV5 {}
- data Compression
- data CIEXYZ = CIEXYZ Word32 Word32 Word32
- data Error
- = ErrorBadMagic {
- errorMagic :: Word16
- | ErrorFileHeaderTruncated
- | ErrorImageHeaderTruncated
- | ErrorImageDataTruncated { }
- | ErrorReservedFieldNotZero
- | ErrorDodgyFileHeaderFieldOffset { }
- | ErrorUnhandledBitmapHeaderSize { }
- | ErrorUnhandledPlanesCount { }
- | ErrorUnhandledColorDepth { }
- | ErrorUnhandledCompressionMode { }
- | ErrorImagePhysicalSizeMismatch { }
- | ErrorInternalErrorPleaseReport
- = ErrorBadMagic {
- readBMP :: FilePath -> IO (Either Error BMP)
- hGetBMP :: Handle -> IO (Either Error BMP)
- parseBMP :: ByteString -> Either Error BMP
- writeBMP :: FilePath -> BMP -> IO ()
- hPutBMP :: Handle -> BMP -> IO ()
- renderBMP :: BMP -> ByteString
- packRGBA32ToBMP :: Int -> Int -> ByteString -> BMP
- packRGBA32ToBMP32 :: Int -> Int -> ByteString -> BMP
- packRGBA32ToBMP24 :: Int -> Int -> ByteString -> BMP
- unpackBMPToRGBA32 :: BMP -> ByteString
- bmpDimensions :: BMP -> (Int, Int)
Data Structures
A BMP image. For an uncompressed image, the image data contains triples of BGR component values. Each line may also have zero pad values on the end, to bring them up to a multiple of 4 bytes in length.
Constructors
| BMP | |
Fields | |
data FileHeader Source #
BMP file header.
Constructors
| FileHeader | |
Fields
| |
Instances
| Show FileHeader Source # | |
Defined in Codec.BMP.FileHeader | |
| Binary FileHeader Source # | |
Defined in Codec.BMP.FileHeader Methods put :: FileHeader -> Put Source # get :: Get FileHeader Source # putList :: [FileHeader] -> Put Source # | |
data BitmapInfo Source #
A wrapper for the various image header types.
Constructors
| InfoV3 BitmapInfoV3 | |
| InfoV4 BitmapInfoV4 | |
| InfoV5 BitmapInfoV5 |
Instances
| Show BitmapInfo Source # | |
Defined in Codec.BMP.BitmapInfo | |
| Binary BitmapInfo Source # | |
Defined in Codec.BMP.BitmapInfo Methods put :: BitmapInfo -> Put Source # get :: Get BitmapInfo Source # putList :: [BitmapInfo] -> Put Source # | |
data BitmapInfoV3 Source #
Device Independent Bitmap (DIB) header for Windows V3.
Constructors
| BitmapInfoV3 | |
Fields
| |
Instances
| Show BitmapInfoV3 Source # | |
Defined in Codec.BMP.BitmapInfoV3 | |
| Binary BitmapInfoV3 Source # | |
Defined in Codec.BMP.BitmapInfoV3 Methods put :: BitmapInfoV3 -> Put Source # get :: Get BitmapInfoV3 Source # putList :: [BitmapInfoV3] -> Put Source # | |
data BitmapInfoV4 Source #
Device Independent Bitmap (DIB) header for Windows V4 (95 and newer)
Constructors
| BitmapInfoV4 | |
Fields
| |
Instances
| Show BitmapInfoV4 Source # | |
Defined in Codec.BMP.BitmapInfoV4 | |
| Binary BitmapInfoV4 Source # | |
Defined in Codec.BMP.BitmapInfoV4 Methods put :: BitmapInfoV4 -> Put Source # get :: Get BitmapInfoV4 Source # putList :: [BitmapInfoV4] -> Put Source # | |
data BitmapInfoV5 Source #
Device Independent Bitmap (DIB) header for Windows V5 (98/2000 and newer)
Constructors
| BitmapInfoV5 | |
Fields
| |
Instances
| Show BitmapInfoV5 Source # | |
Defined in Codec.BMP.BitmapInfoV5 | |
| Binary BitmapInfoV5 Source # | |
Defined in Codec.BMP.BitmapInfoV5 Methods put :: BitmapInfoV5 -> Put Source # get :: Get BitmapInfoV5 Source # putList :: [BitmapInfoV5] -> Put Source # | |
data Compression Source #
The Compression mode says how the image data is encoded in the file.
Constructors
| CompressionRGB | |
| CompressionRLE8 | |
| CompressionRLE4 | |
| CompressionBitFields | |
| CompressionJPEG | |
| CompressionPNG | |
| CompressionUnknown Word32 |
Instances
| Show Compression Source # | |
Defined in Codec.BMP.Compression | |
| Binary Compression Source # | |
Defined in Codec.BMP.Compression Methods put :: Compression -> Put Source # get :: Get Compression Source # putList :: [Compression] -> Put Source # | |
| Eq Compression Source # | |
Defined in Codec.BMP.Compression Methods (==) :: Compression -> Compression -> Bool Source # (/=) :: Compression -> Compression -> Bool Source # | |
Contains the XYZ coordinates of a specific color in a specified color space.
Things that can go wrong when loading a BMP file.
Constructors
| ErrorBadMagic | Magic number was not at the start of the file, so this probably isn't a BMP file. |
Fields
| |
| ErrorFileHeaderTruncated | File is too short to contain a file header. |
| ErrorImageHeaderTruncated | File is too short to contain an image header. |
| ErrorImageDataTruncated | File is too short to contain the image data. |
Fields | |
| ErrorReservedFieldNotZero | Reserved fields should be zero. |
| ErrorDodgyFileHeaderFieldOffset | The offset to the image data from the file header doesn't point anywhere sensible. |
Fields | |
| ErrorUnhandledBitmapHeaderSize | We handle V3 V4 and V5 image headers, but the size of the header indicates it has some other format. |
Fields | |
| ErrorUnhandledPlanesCount | We only handle single color planes. |
Fields | |
| ErrorUnhandledColorDepth | We only handle 24 and 32 bit images. |
Fields | |
| ErrorUnhandledCompressionMode | We only handle uncompressed images. |
Fields | |
| ErrorImagePhysicalSizeMismatch | Mismatch between the image size stated in the header and that which is calculuated from the other fields. |
Fields | |
| ErrorInternalErrorPleaseReport | Something went wrong in the library. |
Instances
Reading
readBMP :: FilePath -> IO (Either Error BMP) Source #
Read a BMP from a file.
The file is checked for problems and unsupported features when read.
If there is anything wrong this gives an Error instead.
parseBMP :: ByteString -> Either Error BMP Source #
Parse a BMP image from a lazy ByteString
Writing
renderBMP :: BMP -> ByteString Source #
Render a BMP image to a lazy ByteString.
Pack and Unpack
Arguments
| :: Int | Width of image (must be positive). |
| -> Int | Height of image (must be positive). |
| -> ByteString | A string of RGBA component values.
Must have length ( |
| -> BMP |
Pack a string of RGBA component values into a 32-bit BMP image.
Alias for packRGBA32ToBMP32.
Arguments
| :: Int | Width of image (must be positive). |
| -> Int | Height of image (must be positive). |
| -> ByteString | A string of RGBA component values.
Must have length ( |
| -> BMP |
Arguments
| :: Int | Width of image (must be positive). |
| -> Int | Height of image (must be positive). |
| -> ByteString | A string of RGBA component values.
Must have length ( |
| -> BMP |
unpackBMPToRGBA32 :: BMP -> ByteString Source #
Unpack a BMP image to a string of RGBA component values.
