Graphics.Luminance.Texture

Texture information and creation

class Texture t

Class of all textures.

Minimal complete definition

fromBaseTexture, toBaseTexture, textureTypeEnum, textureSize, textureStorage, transferTexelsSub, fillTextureSub

Associated Types

type TextureSize t :: *

Size of a texture. This is an associated type – type family – because the dimensionality of a texture relies on its type.

type TextureOffset t :: *

In order to index regions of texels in texture, we need another associated type – for the same dimensionality reason as for TextureSize.

Instances

Pixel f => Texture (Cubemap f)

Associated Types

type TextureSize (Cubemap f) :: *

type TextureOffset (Cubemap f) :: *

Methods

fromBaseTexture :: BaseTexture -> TextureSize (Cubemap f) -> Cubemap f

toBaseTexture :: Cubemap f -> BaseTexture

textureTypeEnum :: proxy (Cubemap f) -> GLenum

textureSize :: Cubemap f -> TextureSize (Cubemap f)

textureStorage :: proxy (Cubemap f) -> GLuint -> GLint -> TextureSize (Cubemap f) -> IO ()

transferTexelsSub :: Storable a => proxy (Cubemap f) -> GLuint -> TextureOffset (Cubemap f) -> TextureSize (Cubemap f) -> Vector a -> IO ()

fillTextureSub :: Storable a => proxy (Cubemap f) -> GLuint -> TextureOffset (Cubemap f) -> TextureSize (Cubemap f) -> Vector a -> IO ()

Pixel f => Texture (Texture1D f)

Associated Types

type TextureSize (Texture1D f) :: *

type TextureOffset (Texture1D f) :: *

Methods

fromBaseTexture :: BaseTexture -> TextureSize (Texture1D f) -> Texture1D f

toBaseTexture :: Texture1D f -> BaseTexture

textureTypeEnum :: proxy (Texture1D f) -> GLenum

textureSize :: Texture1D f -> TextureSize (Texture1D f)

textureStorage :: proxy (Texture1D f) -> GLuint -> GLint -> TextureSize (Texture1D f) -> IO ()

transferTexelsSub :: Storable a => proxy (Texture1D f) -> GLuint -> TextureOffset (Texture1D f) -> TextureSize (Texture1D f) -> Vector a -> IO ()

fillTextureSub :: Storable a => proxy (Texture1D f) -> GLuint -> TextureOffset (Texture1D f) -> TextureSize (Texture1D f) -> Vector a -> IO ()

Pixel f => Texture (Texture2D f)

Associated Types

type TextureSize (Texture2D f) :: *

type TextureOffset (Texture2D f) :: *

Methods

fromBaseTexture :: BaseTexture -> TextureSize (Texture2D f) -> Texture2D f

toBaseTexture :: Texture2D f -> BaseTexture

textureTypeEnum :: proxy (Texture2D f) -> GLenum

textureSize :: Texture2D f -> TextureSize (Texture2D f)

textureStorage :: proxy (Texture2D f) -> GLuint -> GLint -> TextureSize (Texture2D f) -> IO ()

transferTexelsSub :: Storable a => proxy (Texture2D f) -> GLuint -> TextureOffset (Texture2D f) -> TextureSize (Texture2D f) -> Vector a -> IO ()

fillTextureSub :: Storable a => proxy (Texture2D f) -> GLuint -> TextureOffset (Texture2D f) -> TextureSize (Texture2D f) -> Vector a -> IO ()

Pixel f => Texture (Texture3D f)

Associated Types

type TextureSize (Texture3D f) :: *

type TextureOffset (Texture3D f) :: *

Methods

fromBaseTexture :: BaseTexture -> TextureSize (Texture3D f) -> Texture3D f

toBaseTexture :: Texture3D f -> BaseTexture

textureTypeEnum :: proxy (Texture3D f) -> GLenum

textureSize :: Texture3D f -> TextureSize (Texture3D f)

textureStorage :: proxy (Texture3D f) -> GLuint -> GLint -> TextureSize (Texture3D f) -> IO ()

transferTexelsSub :: Storable a => proxy (Texture3D f) -> GLuint -> TextureOffset (Texture3D f) -> TextureSize (Texture3D f) -> Vector a -> IO ()

fillTextureSub :: Storable a => proxy (Texture3D f) -> GLuint -> TextureOffset (Texture3D f) -> TextureSize (Texture3D f) -> Vector a -> IO ()

(KnownNat n, Pixel f) => Texture (CubemapArray n f)

Associated Types

type TextureSize (CubemapArray n f) :: *

type TextureOffset (CubemapArray n f) :: *

Methods

fromBaseTexture :: BaseTexture -> TextureSize (CubemapArray n f) -> CubemapArray n f

toBaseTexture :: CubemapArray n f -> BaseTexture

textureTypeEnum :: proxy (CubemapArray n f) -> GLenum

textureSize :: CubemapArray n f -> TextureSize (CubemapArray n f)

textureStorage :: proxy (CubemapArray n f) -> GLuint -> GLint -> TextureSize (CubemapArray n f) -> IO ()

transferTexelsSub :: Storable a => proxy (CubemapArray n f) -> GLuint -> TextureOffset (CubemapArray n f) -> TextureSize (CubemapArray n f) -> Vector a -> IO ()

fillTextureSub :: Storable a => proxy (CubemapArray n f) -> GLuint -> TextureOffset (CubemapArray n f) -> TextureSize (CubemapArray n f) -> Vector a -> IO ()

(KnownNat n, Pixel f) => Texture (Texture1DArray n f)

Associated Types

type TextureSize (Texture1DArray n f) :: *

type TextureOffset (Texture1DArray n f) :: *

Methods

fromBaseTexture :: BaseTexture -> TextureSize (Texture1DArray n f) -> Texture1DArray n f

toBaseTexture :: Texture1DArray n f -> BaseTexture

textureTypeEnum :: proxy (Texture1DArray n f) -> GLenum

textureSize :: Texture1DArray n f -> TextureSize (Texture1DArray n f)

textureStorage :: proxy (Texture1DArray n f) -> GLuint -> GLint -> TextureSize (Texture1DArray n f) -> IO ()

transferTexelsSub :: Storable a => proxy (Texture1DArray n f) -> GLuint -> TextureOffset (Texture1DArray n f) -> TextureSize (Texture1DArray n f) -> Vector a -> IO ()

fillTextureSub :: Storable a => proxy (Texture1DArray n f) -> GLuint -> TextureOffset (Texture1DArray n f) -> TextureSize (Texture1DArray n f) -> Vector a -> IO ()

(KnownNat n, Pixel f) => Texture (Texture2DArray n f)

Associated Types

type TextureSize (Texture2DArray n f) :: *

type TextureOffset (Texture2DArray n f) :: *

Methods

fromBaseTexture :: BaseTexture -> TextureSize (Texture2DArray n f) -> Texture2DArray n f

toBaseTexture :: Texture2DArray n f -> BaseTexture

textureTypeEnum :: proxy (Texture2DArray n f) -> GLenum

textureSize :: Texture2DArray n f -> TextureSize (Texture2DArray n f)

textureStorage :: proxy (Texture2DArray n f) -> GLuint -> GLint -> TextureSize (Texture2DArray n f) -> IO ()

transferTexelsSub :: Storable a => proxy (Texture2DArray n f) -> GLuint -> TextureOffset (Texture2DArray n f) -> TextureSize (Texture2DArray n f) -> Vector a -> IO ()

fillTextureSub :: Storable a => proxy (Texture2DArray n f) -> GLuint -> TextureOffset (Texture2DArray n f) -> TextureSize (Texture2DArray n f) -> Vector a -> IO ()

createTexture :: forall m t. (MonadIO m, MonadResource m, Texture t) => TextureSize t -> Natural -> Sampling -> m t

'createTexture w h levels sampling' a new 'w'*'h' texture with levels levels. The format is set through the type.

Sampling

data Sampling

A sampling configuration type.

Constructors

Sampling

Fields

• samplingWrapS :: Wrap
• samplingWrapT :: Wrap
• samplingWrapR :: Wrap
• samplingMinFilter :: Filter
• samplingMagFilter :: Filter
• samplingCompareFunction :: Maybe CompareFunc

Instances

Eq Sampling

Methods

(==) :: Sampling -> Sampling -> Bool

(/=) :: Sampling -> Sampling -> Bool

Show Sampling

Methods

showsPrec :: Int -> Sampling -> ShowS

show :: Sampling -> String

showList :: [Sampling] -> ShowS

defaultSampling :: Sampling

Default Sampling for convenience.

  defaultSampling = Sampling {
      samplingWrapS           = ClampToEdge
    , samplingWrapT           = ClampToEdge
    , samplingWrapR           = ClampToEdge
    , samplingMinFilter       = Linear
    , samplingMagFilter       = Linear
    , samplingCompareFunction = Nothing
    }

Texture sampler customization

data Filter

Sampling filter. Nearest will sample the nearest texel at the sampling coordinates whilst Linear will perform linear interpolation with the texels nearby.

Constructors

Nearest

Linear

Instances

Eq Filter

Methods

(==) :: Filter -> Filter -> Bool

(/=) :: Filter -> Filter -> Bool

Show Filter

Methods

showsPrec :: Int -> Filter -> ShowS

show :: Filter -> String

showList :: [Filter] -> ShowS

data Wrap

Wrap texture parameter. Such an object is used to tell how to sampling is performed when going out of the texture coordinates.

ClampToEdge will clamp the texture coordinates between in '[0,1]'. If you pass '1.1' or '31.456', in both cases you’ll end up with '1'. Same thing for negative values clamped to '0'.

Repeat will clamp the texture in '[0,1]' after applying a fract on the value, yielding a a repeated '[0,1]' pattern.

Constructors

ClampToEdge

Repeat

ClampToBorder

MirroredRepeat

Instances

Eq Wrap

Methods

(==) :: Wrap -> Wrap -> Bool

(/=) :: Wrap -> Wrap -> Bool

Show Wrap

Methods

showsPrec :: Int -> Wrap -> ShowS

show :: Wrap -> String

showList :: [Wrap] -> ShowS

data CompareFunc

For textures that might require depth comparison, that type defines all the possible cases for comparison.

Constructors

Never

Less

Equal

LessOrEqual

Greater

GreaterOrEqual

NotEqual

Always

Instances

Eq CompareFunc

Methods

(==) :: CompareFunc -> CompareFunc -> Bool

(/=) :: CompareFunc -> CompareFunc -> Bool

Show CompareFunc

Methods

showsPrec :: Int -> CompareFunc -> ShowS

show :: CompareFunc -> String

showList :: [CompareFunc] -> ShowS

Texture operations

uploadSub :: forall a m t. (MonadIO m, Storable a, Texture t) => t -> TextureOffset t -> TextureSize t -> Bool -> Vector a -> m ()

uploadSub tex offset size autolvl texels uploads data to a subpart of the texture’s storage. The offset is given with origin at upper-left corner, and size is the size of the area to upload to. autolvl is a Bool that can be used to automatically generate mipmaps.

fillSub :: forall a m t. (MonadIO m, Storable a, Texture t) => t -> TextureOffset t -> TextureSize t -> Bool -> Vector a -> m ()

Fill a subpart of the texture’s storage with a given value.

Available textures

1D textures

data Texture1D f

A 1D texture.

Instances

Eq (Texture1D f)

Methods

(==) :: Texture1D f -> Texture1D f -> Bool

(/=) :: Texture1D f -> Texture1D f -> Bool

Show (Texture1D f)

Methods

showsPrec :: Int -> Texture1D f -> ShowS

show :: Texture1D f -> String

showList :: [Texture1D f] -> ShowS

Pixel f => Texture (Texture1D f)

Associated Types

type TextureSize (Texture1D f) :: *

type TextureOffset (Texture1D f) :: *

Methods

fromBaseTexture :: BaseTexture -> TextureSize (Texture1D f) -> Texture1D f

toBaseTexture :: Texture1D f -> BaseTexture

textureTypeEnum :: proxy (Texture1D f) -> GLenum

textureSize :: Texture1D f -> TextureSize (Texture1D f)

textureStorage :: proxy (Texture1D f) -> GLuint -> GLint -> TextureSize (Texture1D f) -> IO ()

transferTexelsSub :: Storable a => proxy (Texture1D f) -> GLuint -> TextureOffset (Texture1D f) -> TextureSize (Texture1D f) -> Vector a -> IO ()

fillTextureSub :: Storable a => proxy (Texture1D f) -> GLuint -> TextureOffset (Texture1D f) -> TextureSize (Texture1D f) -> Vector a -> IO ()

Pixel f => Uniform (Texture1D f)

Methods

toU :: Monad m => GLuint -> GLint -> UniformInterface m (U (Texture1D f))

type TextureSize (Texture1D f)

type TextureSize (Texture1D f) = Natural

type TextureOffset (Texture1D f)

type TextureOffset (Texture1D f) = Natural

texture1DW :: Texture1D f -> Natural

Array texture

data Texture1DArray n f

A 1D texture array.

Instances

Eq (Texture1DArray n f)

Methods

(==) :: Texture1DArray n f -> Texture1DArray n f -> Bool

(/=) :: Texture1DArray n f -> Texture1DArray n f -> Bool

Show (Texture1DArray n f)

Methods

showsPrec :: Int -> Texture1DArray n f -> ShowS

show :: Texture1DArray n f -> String

showList :: [Texture1DArray n f] -> ShowS

(KnownNat n, Pixel f) => Texture (Texture1DArray n f)

Associated Types

type TextureSize (Texture1DArray n f) :: *

type TextureOffset (Texture1DArray n f) :: *

Methods

fromBaseTexture :: BaseTexture -> TextureSize (Texture1DArray n f) -> Texture1DArray n f

toBaseTexture :: Texture1DArray n f -> BaseTexture

textureTypeEnum :: proxy (Texture1DArray n f) -> GLenum

textureSize :: Texture1DArray n f -> TextureSize (Texture1DArray n f)

textureStorage :: proxy (Texture1DArray n f) -> GLuint -> GLint -> TextureSize (Texture1DArray n f) -> IO ()

transferTexelsSub :: Storable a => proxy (Texture1DArray n f) -> GLuint -> TextureOffset (Texture1DArray n f) -> TextureSize (Texture1DArray n f) -> Vector a -> IO ()

fillTextureSub :: Storable a => proxy (Texture1DArray n f) -> GLuint -> TextureOffset (Texture1DArray n f) -> TextureSize (Texture1DArray n f) -> Vector a -> IO ()

type TextureSize (Texture1DArray n f)

type TextureSize (Texture1DArray n f) = Natural

type TextureOffset (Texture1DArray n f)

type TextureOffset (Texture1DArray n f) = (Natural, Natural)

texture1DArrayW :: Texture1DArray n f -> Natural

2D textures

data Texture2D f

A 2D texture.

Instances

Eq (Texture2D f)

Methods

(==) :: Texture2D f -> Texture2D f -> Bool

(/=) :: Texture2D f -> Texture2D f -> Bool

Show (Texture2D f)

Methods

showsPrec :: Int -> Texture2D f -> ShowS

show :: Texture2D f -> String

showList :: [Texture2D f] -> ShowS

Pixel f => Texture (Texture2D f)

Associated Types

type TextureSize (Texture2D f) :: *

type TextureOffset (Texture2D f) :: *

Methods

fromBaseTexture :: BaseTexture -> TextureSize (Texture2D f) -> Texture2D f

toBaseTexture :: Texture2D f -> BaseTexture

textureTypeEnum :: proxy (Texture2D f) -> GLenum

textureSize :: Texture2D f -> TextureSize (Texture2D f)

textureStorage :: proxy (Texture2D f) -> GLuint -> GLint -> TextureSize (Texture2D f) -> IO ()

transferTexelsSub :: Storable a => proxy (Texture2D f) -> GLuint -> TextureOffset (Texture2D f) -> TextureSize (Texture2D f) -> Vector a -> IO ()

fillTextureSub :: Storable a => proxy (Texture2D f) -> GLuint -> TextureOffset (Texture2D f) -> TextureSize (Texture2D f) -> Vector a -> IO ()

Pixel f => Uniform (Texture2D f)

Methods

toU :: Monad m => GLuint -> GLint -> UniformInterface m (U (Texture2D f))

type TextureSize (Texture2D f)

type TextureSize (Texture2D f) = (Natural, Natural)

type TextureOffset (Texture2D f)

type TextureOffset (Texture2D f) = (Natural, Natural)

texture2DW :: Texture2D f -> Natural

texture2DH :: Texture2D f -> Natural

Array texture

data Texture2DArray n f

A 2D texture array.

Instances

Eq (Texture2DArray n f)

Methods

(==) :: Texture2DArray n f -> Texture2DArray n f -> Bool

(/=) :: Texture2DArray n f -> Texture2DArray n f -> Bool

Show (Texture2DArray n f)

Methods

showsPrec :: Int -> Texture2DArray n f -> ShowS

show :: Texture2DArray n f -> String

showList :: [Texture2DArray n f] -> ShowS

(KnownNat n, Pixel f) => Texture (Texture2DArray n f)

Associated Types

type TextureSize (Texture2DArray n f) :: *

type TextureOffset (Texture2DArray n f) :: *

Methods

fromBaseTexture :: BaseTexture -> TextureSize (Texture2DArray n f) -> Texture2DArray n f

toBaseTexture :: Texture2DArray n f -> BaseTexture

textureTypeEnum :: proxy (Texture2DArray n f) -> GLenum

textureSize :: Texture2DArray n f -> TextureSize (Texture2DArray n f)

textureStorage :: proxy (Texture2DArray n f) -> GLuint -> GLint -> TextureSize (Texture2DArray n f) -> IO ()

transferTexelsSub :: Storable a => proxy (Texture2DArray n f) -> GLuint -> TextureOffset (Texture2DArray n f) -> TextureSize (Texture2DArray n f) -> Vector a -> IO ()

fillTextureSub :: Storable a => proxy (Texture2DArray n f) -> GLuint -> TextureOffset (Texture2DArray n f) -> TextureSize (Texture2DArray n f) -> Vector a -> IO ()

type TextureSize (Texture2DArray n f)

type TextureSize (Texture2DArray n f) = (Natural, Natural)

type TextureOffset (Texture2DArray n f)

type TextureOffset (Texture2DArray n f) = (Natural, Natural, Natural)

texture2DArrayW :: Texture2DArray n f -> Natural

3D textures

data Texture3D f

A 3D texture.

Instances

Eq (Texture3D f)

Methods

(==) :: Texture3D f -> Texture3D f -> Bool

(/=) :: Texture3D f -> Texture3D f -> Bool

Show (Texture3D f)

Methods

showsPrec :: Int -> Texture3D f -> ShowS

show :: Texture3D f -> String

showList :: [Texture3D f] -> ShowS

Pixel f => Texture (Texture3D f)

Associated Types

type TextureSize (Texture3D f) :: *

type TextureOffset (Texture3D f) :: *

Methods

fromBaseTexture :: BaseTexture -> TextureSize (Texture3D f) -> Texture3D f

toBaseTexture :: Texture3D f -> BaseTexture

textureTypeEnum :: proxy (Texture3D f) -> GLenum

textureSize :: Texture3D f -> TextureSize (Texture3D f)

textureStorage :: proxy (Texture3D f) -> GLuint -> GLint -> TextureSize (Texture3D f) -> IO ()

transferTexelsSub :: Storable a => proxy (Texture3D f) -> GLuint -> TextureOffset (Texture3D f) -> TextureSize (Texture3D f) -> Vector a -> IO ()

fillTextureSub :: Storable a => proxy (Texture3D f) -> GLuint -> TextureOffset (Texture3D f) -> TextureSize (Texture3D f) -> Vector a -> IO ()

Pixel f => Uniform (Texture3D f)

Methods

toU :: Monad m => GLuint -> GLint -> UniformInterface m (U (Texture3D f))

type TextureSize (Texture3D f)

type TextureSize (Texture3D f) = (Natural, Natural, Natural)

type TextureOffset (Texture3D f)

type TextureOffset (Texture3D f) = (Natural, Natural, Natural)

texture3DW :: Texture3D f -> Natural

texture3DH :: Texture3D f -> Natural

texture3DD :: Texture3D f -> Natural

Cubemaps

data Cubemap f

A cubemap.

Instances

Eq (Cubemap f)

Methods

(==) :: Cubemap f -> Cubemap f -> Bool

(/=) :: Cubemap f -> Cubemap f -> Bool

Show (Cubemap f)

Methods

showsPrec :: Int -> Cubemap f -> ShowS

show :: Cubemap f -> String

showList :: [Cubemap f] -> ShowS

Pixel f => Texture (Cubemap f)

Associated Types

type TextureSize (Cubemap f) :: *

type TextureOffset (Cubemap f) :: *

Methods

fromBaseTexture :: BaseTexture -> TextureSize (Cubemap f) -> Cubemap f

toBaseTexture :: Cubemap f -> BaseTexture

textureTypeEnum :: proxy (Cubemap f) -> GLenum

textureSize :: Cubemap f -> TextureSize (Cubemap f)

textureStorage :: proxy (Cubemap f) -> GLuint -> GLint -> TextureSize (Cubemap f) -> IO ()

transferTexelsSub :: Storable a => proxy (Cubemap f) -> GLuint -> TextureOffset (Cubemap f) -> TextureSize (Cubemap f) -> Vector a -> IO ()

fillTextureSub :: Storable a => proxy (Cubemap f) -> GLuint -> TextureOffset (Cubemap f) -> TextureSize (Cubemap f) -> Vector a -> IO ()

Pixel f => Uniform (Cubemap f)

Methods

toU :: Monad m => GLuint -> GLint -> UniformInterface m (U (Cubemap f))

type TextureSize (Cubemap f)

type TextureSize (Cubemap f) = Natural

type TextureOffset (Cubemap f)

type TextureOffset (Cubemap f) = (Natural, Natural, CubeFace)

data CubeFace

Face of a Cubemap.

Constructors

PositiveX

NegativeX

PositiveY

NegativeY

PositiveZ

NegativeZ

Instances

Eq CubeFace

Methods

(==) :: CubeFace -> CubeFace -> Bool

(/=) :: CubeFace -> CubeFace -> Bool

Show CubeFace

Methods

showsPrec :: Int -> CubeFace -> ShowS

show :: CubeFace -> String

showList :: [CubeFace] -> ShowS

cubemapSize :: Cubemap f -> Natural

Array textures

data CubemapArray n f

A cubemap array.

Instances

Eq (CubemapArray n f)

Methods

(==) :: CubemapArray n f -> CubemapArray n f -> Bool

(/=) :: CubemapArray n f -> CubemapArray n f -> Bool

Show (CubemapArray n f)

Methods

showsPrec :: Int -> CubemapArray n f -> ShowS

show :: CubemapArray n f -> String

showList :: [CubemapArray n f] -> ShowS

(KnownNat n, Pixel f) => Texture (CubemapArray n f)

Associated Types

type TextureSize (CubemapArray n f) :: *

type TextureOffset (CubemapArray n f) :: *

Methods

fromBaseTexture :: BaseTexture -> TextureSize (CubemapArray n f) -> CubemapArray n f

toBaseTexture :: CubemapArray n f -> BaseTexture

textureTypeEnum :: proxy (CubemapArray n f) -> GLenum

textureSize :: CubemapArray n f -> TextureSize (CubemapArray n f)

textureStorage :: proxy (CubemapArray n f) -> GLuint -> GLint -> TextureSize (CubemapArray n f) -> IO ()

transferTexelsSub :: Storable a => proxy (CubemapArray n f) -> GLuint -> TextureOffset (CubemapArray n f) -> TextureSize (CubemapArray n f) -> Vector a -> IO ()

fillTextureSub :: Storable a => proxy (CubemapArray n f) -> GLuint -> TextureOffset (CubemapArray n f) -> TextureSize (CubemapArray n f) -> Vector a -> IO ()

type TextureSize (CubemapArray n f)

type TextureSize (CubemapArray n f) = Natural

type TextureOffset (CubemapArray n f)

type TextureOffset (CubemapArray n f) = (Natural, Natural, Natural, CubeFace)

cubemapArraySize :: CubemapArray n f -> Natural

Pixel formats

module Graphics.Luminance.Pixel