netpbm-1.0.1: Loading PBM, PGM, PPM image files

Safe HaskellNone

Graphics.Netpbm

Description

Parsing the netpbm image formates (PBM, PGM and PPM, both ASCII and binary) from ByteStrings.

All netpbm image formats are implemented (P1 - P6).

To parse one of these formats, use parsePPM.

See also: http://www.imagemagick.org/Usage/formats/#netpbm

Synopsis

Documentation

data PPMType Source

The netpbm image type of an image.

Constructors

P1

ASCII bitmap

P2

ASCII greymap

P3

ASCII pixmap (color)

P4

binary bitmap

P5

binary greymap

P6

binary pixmap (color)

data PPM Source

A PPM file with type, dimensions, and image data.

Constructors

PPM 

Instances

data PpmPixelRGB8 Source

A pixel containing three 8-bit color components, RGB.

Constructors

PpmPixelRGB8 !Word8 !Word8 !Word8 

newtype PbmPixel Source

A pixel containing black or white.

Constructors

PbmPixel Bool 

data PgmPixel8 Source

A pixel containing an 8-bit greyscale value.

Constructors

PgmPixel8 !Word8 

data PgmPixel16 Source

A pixel containing a 16-bit greyscale value.

Constructors

PgmPixel16 !Word16 

data PPMHeader Source

Meta information about the image: The exact PPM format and dimensions.

Constructors

PPMHeader 

Fields

ppmType :: !PPMType
 
ppmWidth :: !Int
 
ppmHeight :: !Int
 

data PpmPixelData Source

Image data, either 8 or 16 bits. TODO rename to PNM

Constructors

PpmPixelDataRGB8 (Vector PpmPixelRGB8)

For 8-bit PPMs.

PpmPixelDataRGB16 (Vector PpmPixelRGB16)

For 16-bit PPMs.

PbmPixelData (Vector PbmPixel)

For 1-bit PBMs.

PgmPixelData8 (Vector PgmPixel8)

For 8-bit PGMs.

PgmPixelData16 (Vector PgmPixel16)

For 16-bit PGMs.

pixelVectorToList :: Storable a => Vector a -> [a]Source

Converts a vector of pixels to a list for convenience.

pixelDataToIntList :: PpmPixelData -> [Int]Source

Converts pixel data to a list of positive Ints.

How big they can become depends on the bit depth of the pixel data.

parsePPM :: ByteString -> PpmParseResultSource

Parses a PPM file from the given ByteString. On failure, Left error contains the error message. On success, Right (images, Maybe rest) contains the parsed images and potentially an unparsable rest input.

type PpmParseResult = Either String ([PPM], Maybe ByteString)Source

The result of a PPM parse.

See parsePPM.