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

Instances

Eq (Geometry is)

Hashable (Geometry is)

type Geometry2 = `[Position2, UV]`

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 (JavaScript only).

textureFile :: String -> Texture

Creates a Texture from a file (Desktop only).

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.

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.