FWGL.Graphics.D2

Simplified 2D graphics system.

Elements

data Element

A 2D object with a Texture, a depth and a transformation.

rect :: GLES => V2 -> Texture -> Element

A rectangle with a specified Texture and size.

image

Arguments

:: BackendIO

=> Float

Width.

-> Texture

-> Element

A rectangle with the aspect ratio adapted to its texture.

depth :: Float -> Element -> Element

Set the depth of an element.

sprite :: BackendIO => Texture -> Element

A rectangle with the size and aspect ratio adapted to the screen. You have to use the screenScale view matrix.

Geometry

data Geometry is

A set of attributes and indices.

Instances

Eq (Geometry is)

Hashable (Geometry is)

type Geometry2 = `[Position2, UV]`

A 2D geometry.

geom :: Texture -> Geometry Geometry2 -> Element

An element with a specified Geometry and Texture.

mkGeometry2

Arguments

:: GLES

=> [V2]

List of vertices.

-> [V2]

List of UV coordinates.

-> [Word16]

Triangles expressed as triples of indices to the two lists above.

-> Geometry Geometry2

Create a 2D Geometry. The first two lists should have the same length.

Textures

module FWGL.Graphics.Color

data Texture

A texture.

textureURL

Arguments

:: String

URL

-> Texture

Creates a Texture from an URL or a local file.

textureFile :: String -> Texture

The same as textureURL.

colorTex :: GLES => Color -> Texture

Generate a 1x1 texture.

mkTexture

Arguments

:: GLES

=> Int

Width.

-> Int

Height.

-> [Color]

List of pixels

-> Texture

Creates a Texture from a list of pixels.

Transformations

data V2

Two-dimensional vector.

Constructors

V2 !Float !Float

Instances

Eq V2

Show V2

Storable V2

Hashable V2

GLES => AttributeCPU V2 V2

GLES => AttributeCPU CV2 UV

GLES => AttributeCPU CV2 Position2

GLES => AttributeCPU CV2 UV

GLES => UniformCPU V2 V2

pos :: V2 -> Element -> Element

Translate an Element.

rot :: Float -> Element -> Element

Rotate an Element.

scale :: Float -> Element -> Element

Scale an Element.

scaleV :: V2 -> Element -> Element

Scale an Element in two dimensions.

transform :: M3 -> Element -> Element

Transform an Element.

Layers

data Layer

An object associated with a program.

Element layers

elements :: BackendIO => [Element] -> Layer

Create a standard Layer from a list of Elements.

view :: BackendIO => M3 -> [Element] -> Layer

Create a Layer from a view matrix and a list of Elements.

Object layers

layer :: BackendIO => Object DefaultUniforms2D Geometry2 -> Layer

Create a Layer from a 2D Object, using the default shader.

layerPrg :: (BackendIO, Subset og pg) => Program pg Geometry2 -> Object og Geometry2 -> Layer

Create a Layer from a 2D Object, using a custom shader.

program :: (Subset gs' gs, Subset gs'' gs, Subset os' os) => VertexShader gs' is os -> FragmentShader gs'' os' -> Program gs is

Create a Program from the shaders.

Sublayers

subLayer

Arguments

:: Int

Texture width.

-> Int

Texture height.

-> Layer

Layer to draw on a Texture.

-> (Texture -> [Layer])

Layer to draw on the screen.

-> Layer

Use a Layer as a Texture on another.

Custom 2D objects

data Object gs is

An object is a set of geometries associated with some uniforms.

object :: BackendIO => M3 -> [Element] -> Object DefaultUniforms2D Geometry2

Create a graphical Object from a list of Elements and a view matrix.

object1 :: BackendIO => Element -> Object `[Image, Depth, Transform2]` Geometry2

Create a graphical Object from a single Element. This lets you set your own globals individually. If the shader uses the view matrix View2 (e.g. the default 2D shader), you have to set it with viewObject.

(~~) :: (Equal gs gs', Equal is is') => Object gs is -> Object gs' is' -> Object (Union gs gs') (Union is is')

Join two objects.

Globals

global :: (Typeable g, UniformCPU c g) => g -> c -> Object gs is -> Object (g : gs) is

Sets a global (uniform) of an object.

globalTexture :: (BackendIO, Typeable g, UniformCPU ActiveTexture g) => g -> Texture -> Object gs is -> Object (g : gs) is

Sets a global (uniform) of an object using a Texture.

globalTexSize :: (BackendIO, Typeable g, UniformCPU c g) => g -> Texture -> ((Int, Int) -> c) -> Object gs is -> Object (g : gs) is

Sets a global (uniform) of an object using the dimensions of a Texture.

viewObject :: BackendIO => M3 -> Object gs Geometry2 -> Object (View2 : gs) Geometry2

Set the value of the view matrix of a 2D Object.

type DefaultUniforms2D = Uniforms

The uniforms used in the default 2D program.

data Image

An uniform that represents the texture used in the default 2D shader.

Instances

ShaderType Image

Typeable * Image

GLES => UniformCPU CSampler2D Image

data Depth

An uniform that represents the depth used in the default 2D shader.

Instances

ShaderType Depth

Typeable * Depth

GLES => UniformCPU CFloat Depth

data Transform2

An uniform that represents the transformation matrix used in the default 2D shader.

Instances

ShaderType Transform2

Typeable * Transform2

GLES => UniformCPU CM3 Transform2

data View2

An uniform that represents the view matrix used in the default 2D shader.

Instances

ShaderType View2

Typeable * View2

GLES => UniformCPU CM3 View2

3D matrices

data V3

Three-dimensional vector.

Constructors

V3 !Float !Float !Float

Instances

Eq V3

Show V3

Storable V3

Hashable V3

GLES => AttributeCPU V3 V3

GLES => AttributeCPU CV3 Normal3

GLES => AttributeCPU CV3 Position3

GLES => UniformCPU V3 V3

data M3

3x3 matrix.

Constructors

M3 !V3 !V3 !V3

Instances

Eq M3

Show M3

GLES => UniformCPU M3 M3

GLES => UniformCPU CM3 View2

GLES => UniformCPU CM3 Transform2

mat3 :: (Float, Float, Float, Float, Float, Float, Float, Float, Float) -> M3

Create a 3x3 matrix.

mul3 :: M3 -> M3 -> M3

3x3 matrix multiplication.

Transformation matrices

idMat3 :: M3

The identity 3x3 matrix.

transMat3 :: V2 -> M3

3x3 translation matrix.

rotMat3 :: Float -> M3

3x3 rotation matrix.

scaleMat3 :: V2 -> M3

3x3 scale matrix.