Graphics.GLUtil.Textures

Utilities for loading texture data.

Documentation

data TexColor

Pixel format of image data.

Constructors

TexMono

TexRG

TexRGB

TexBGR

TexRGBA

data TexInfo a

A basic texture information record.

Constructors

TexInfo

Fields

• texWidth :: GLsizei
• texHeight :: GLsizei
• texColor :: TexColor
• texData :: a

texInfo :: Int -> Int -> TexColor -> a -> TexInfo a

Helper for constructing a TexInfo using Haskell Ints for image dimensions.

class HasGLType (Elem a) => IsPixelData a where

Class for containers of texture data.

Minimal complete definition

withPixels

Associated Types

type Elem a

Methods

withPixels :: a -> (Ptr (Elem a) -> IO c) -> IO c

Instances

IsPixelData ByteString

Associated Types

type Elem ByteString :: *

Methods

withPixels :: ByteString -> (Ptr (Elem ByteString) -> IO c) -> IO c

IsPixelData ShortString

Associated Types

type Elem ShortString :: *

Methods

withPixels :: ShortString -> (Ptr (Elem ShortString) -> IO c) -> IO c

HasGLType b => IsPixelData [b]

Associated Types

type Elem [b] :: *

Methods

withPixels :: [b] -> (Ptr (Elem [b]) -> IO c) -> IO c

HasGLType b => IsPixelData (Ptr b)

Associated Types

type Elem (Ptr b) :: *

Methods

withPixels :: Ptr b -> (Ptr (Elem (Ptr b)) -> IO c) -> IO c

HasGLType b => IsPixelData (ForeignPtr b)

Associated Types

type Elem (ForeignPtr b) :: *

Methods

withPixels :: ForeignPtr b -> (Ptr (Elem (ForeignPtr b)) -> IO c) -> IO c

HasGLType b => IsPixelData (Vector b)

Associated Types

type Elem (Vector b) :: *

Methods

withPixels :: Vector b -> (Ptr (Elem (Vector b)) -> IO c) -> IO c

HasGLType b => IsPixelData (StorableArray i b)

Associated Types

type Elem (StorableArray i b) :: *

Methods

withPixels :: StorableArray i b -> (Ptr (Elem (StorableArray i b)) -> IO c) -> IO c

newtype ShortString

Wrapper whose IsPixelData instance treats the pointer underlying a ByteString as an array of Word16s.

Constructors

ShortString ByteString

Instances

IsPixelData ShortString

Associated Types

type Elem ShortString :: *

Methods

withPixels :: ShortString -> (Ptr (Elem ShortString) -> IO c) -> IO c

type Elem ShortString

type Elem ShortString = Word16

freshTexture :: forall a proxy. HasGLType a => Int -> Int -> TexColor -> proxy a -> IO TextureObject

Create a new 2D texture with uninitialized contents.

freshTextureWord8 :: Int -> Int -> TexColor -> IO TextureObject

Create a new 2D texture with uninitialized Word8 contents.

freshTextureFloat :: Int -> Int -> TexColor -> IO TextureObject

Create a new 2D texture with uninitialized GLfloat contents.

loadTexture :: IsPixelData a => TexInfo a -> IO TextureObject

Create a new 2D texture with data from a TexInfo.

reloadTexture :: forall a. IsPixelData a => TextureObject -> TexInfo a -> IO ()

Replace a 2D texture's pixel data with data from a TexInfo.

texture2DWrap :: StateVar (Repetition, Clamping)

Set texture coordinate wrapping options for both the S and T dimensions of a 2D texture.

texture3DWrap :: StateVar (Repetition, Clamping)

Set texture coordinate wrapping options for the S, T, and R dimensions of a 3D texture.

withTextures :: BindableTextureTarget t => t -> [TextureObject] -> IO a -> IO a

Bind each of the given textures to successive texture units at the given TextureTarget starting with texture unit 0.

withTextures2D :: [TextureObject] -> IO a -> IO a

Bind each of the given 2D textures to successive texture units starting with texture unit 0.

withTexturesAt :: BindableTextureTarget t => t -> [(TextureObject, GLuint)] -> IO a -> IO a

Bind each of the given textures to the texture unit they are paired with. The given action is run with these bindings, then the texture bindings are reset. If you don't care which texture units are used, consider using withTextures or withTextures2D.