Diagrams.TwoD.Image

Importing external images into diagrams. Usage: To create a diagram from an embedded image with width 1 and height set according to the aspect ratio: 'image img # scaleUToX 1` where img is a 'DImage Embedded'

Documentation

data DImage where

An image primitive, the two ints are width followed by height. Will typically be created by loadImageEmb or loadImageExt which, will handle setting the width and heigh to the actual width and height of the image.

Constructors

DImage :: ImageData t -> Int -> Int -> T2 -> DImage t

Instances

Typeable1 DImage

Transformable (DImage a)

HasOrigin (DImage a)

Renderable (DImage a) NullBackend

data ImageData where

ImageData is either a JuicyPixels DynamicImage tagged as Embedded or a reference tagged as External.

Constructors

ImageRaster :: DynamicImage -> ImageData Embedded

ImageRef :: FilePath -> ImageData External

data Embedded

Instances

Typeable Embedded

data External

Instances

Typeable External

image :: (Typeable a, Renderable (DImage a) b) => DImage a -> Diagram b R2

Make a DImage into a Diagram.

loadImageEmb :: FilePath -> IO (Either String (DImage Embedded))

Use JuicyPixels to read an image in any format and wrap it in a DImage. The width and height of the image are set to their actual values.

loadImageExt :: FilePath -> IO (Either String (DImage External))

Check that a file exists, and use JuicyPixels to figure out the right size, but save a reference to the image instead of the raster data

uncheckedImageRef :: FilePath -> Int -> Int -> DImage External

Make an unchecked image reference; have to specify a width and height. Unless the aspect ratio of the external image is the w :: h, then the image will be distorted.

raster :: (Int -> Int -> AlphaColour Double) -> Int -> Int -> DImage Embedded

Create an image from scratch by specifying the pixel data

rasterDia :: Renderable (DImage Embedded) b => (Int -> Int -> AlphaColour Double) -> Int -> Int -> Diagram b R2

Crate a diagram from raw raster data.