Data.Bitmap.Pure
Contents
- module Data.Bitmap.Base
- emptyBitmap :: forall t. PixelComponent t => Size -> NChn -> Maybe Alignment -> Bitmap t
- createSingleChannelBitmap :: forall t. PixelComponent t => Size -> Maybe Alignment -> (Int -> Int -> t) -> Bitmap t
- componentMap :: PixelComponent s => (s -> s) -> Bitmap s -> Bitmap s
- componentMap' :: (PixelComponent s, PixelComponent t) => (s -> t) -> Bitmap s -> Maybe Alignment -> Bitmap t
- copySubImage :: PixelComponent t => Bitmap t -> Offset -> Size -> Bitmap t
- copySubImage' :: PixelComponent t => Bitmap t -> Offset -> Size -> Size -> Offset -> Bitmap t
- combineChannels :: forall t. PixelComponent t => [Bitmap t] -> Maybe Alignment -> Bitmap t
- extractChannels :: PixelComponent t => Bitmap t -> Maybe Alignment -> [Bitmap t]
- extractSingleChannel :: PixelComponent t => Bitmap t -> Maybe Alignment -> Int -> Bitmap t
- bilinearResample :: PixelComponent t => Bitmap t -> Size -> Maybe Alignment -> Bitmap t
- bilinearResampleChannel :: PixelComponent t => Bitmap t -> Int -> Size -> Maybe Alignment -> Bitmap t
- blendBitmaps :: PixelComponent t => Float -> Float -> Bitmap t -> Bitmap t -> Maybe Alignment -> Bitmap t
- blendChannels :: PixelComponent t => Float -> Float -> Bitmap t -> Int -> Bitmap t -> Int -> Maybe Alignment -> Bitmap t
- powerlawGammaCorrection :: PixelComponent t => Float -> Bitmap t -> Maybe Alignment -> Bitmap t
- powerlawGammaCorrectionChannel :: PixelComponent t => Float -> Bitmap t -> Int -> Maybe Alignment -> Bitmap t
- bitmapToByteString :: PixelComponent t => Bitmap t -> ByteString
Documentation
module Data.Bitmap.Base
Creating bitmaps
Arguments
| :: forall t . PixelComponent t | |
| => Size | (width,height) |
| -> NChn | number of channels (components/pixel) |
| -> Maybe Alignment | the row alignment of the new image |
| -> Bitmap t |
A bitmap filled with zero values. Note: we cannot guarantee the alignment of the memory block (but typically it is aligned at least to machine word boundary), but what we can guarantee is that the rows are properly padded.
createSingleChannelBitmapSource
Arguments
| :: forall t . PixelComponent t | |
| => Size | (width,height) |
| -> Maybe Alignment | the row alignment of the new image |
| -> (Int -> Int -> t) | the function used to create the bitmap |
| -> Bitmap t |
Creates a single channel bitmap from a function. This is probably a bit slow.
Mapping over bitmaps
componentMap :: PixelComponent s => (s -> s) -> Bitmap s -> Bitmap sSource
Warning: this is probably slow.
componentMap' :: (PixelComponent s, PixelComponent t) => (s -> t) -> Bitmap s -> Maybe Alignment -> Bitmap tSource
Warning: this is probably slow.
Cropping and extending
Arguments
| :: PixelComponent t | |
| => Bitmap t | source image |
| -> Offset | source rectangle offset |
| -> Size | source rectangle size |
| -> Bitmap t |
Copies a subrectangle of the source image into a new image.
Arguments
| :: PixelComponent t | |
| => Bitmap t | source image |
| -> Offset | source rectangle offset |
| -> Size | source rectangle size |
| -> Size | target image size |
| -> Offset | target rectangle offset |
| -> Bitmap t |
Copy into a new "black" bitmap; common generalization of crop and extend.
Manipulating channels
combineChannels :: forall t. PixelComponent t => [Bitmap t] -> Maybe Alignment -> Bitmap tSource
extractChannels :: PixelComponent t => Bitmap t -> Maybe Alignment -> [Bitmap t]Source
Bilinear resampling
Blending
Arguments
| :: PixelComponent t | |
| => Float | weight 1 |
| -> Float | weight 2 |
| -> Bitmap t | source image 1 |
| -> Bitmap t | source image 2 |
| -> Maybe Alignment | target alignment |
| -> Bitmap t |
Blends two bitmaps with the given weights; that is, the result is the specified linear combination. If the values are outside the allowed range (this can happen with the Word8, Word16, Word32 types and weights whose sum is bigger than 1, or with a negative weight), then they are clipped. The clipping does not happen with the Float component type.
Gamma correction
Arguments
| :: PixelComponent t | |
| => Float | gamma |
| -> Bitmap t | source image |
| -> Maybe Alignment | target image row alignment |
| -> Bitmap t |
This is equivalent to componentMap (c -> c^gamma), except that
(^) is defined only for integral exponents; but should be faster anyway.
Conversion to ByteString
bitmapToByteString :: PixelComponent t => Bitmap t -> ByteStringSource
Note that the data is shared; and also that the resulting ByteString is encoded using the host machine's endianness.