Modulesdl2-gfx-0.3.0.0Haskell2010

SDL.Primitive

Bindings to SDL2_gfx's primitives drawing functionality. These functions should allow you to render various simple shapes such as lines, ellipses or polygons.

All of the monadic functions within this module are capable of throwing an SDLException if they encounter an error.

Contents

Pixels
Lines
Triangles
Rectangles
Curves
Polygons

Synopsis

type Pos
type Color
value pixel
value line
type Length
value horizontalLine
value verticalLine
value smoothLine
type Width
value thickLine
value triangle
value smoothTriangle
value fillTriangle
value rectangle
type Radius
value roundRectangle
value fillRectangle
value fillRoundRectangle
type Start
type End
value arc
value circle
value smoothCircle
value fillCircle
value ellipse
value smoothEllipse
value fillEllipse
value pie
value fillPie
type Steps
value bezier
value polygon
value smoothPolygon
value fillPolygon

Packagesdl2-gfx-0.3.0.0
Exports34
LanguageHaskell2010
LicenceMIT
SourcePrimitive.hs

Pixels

typetype Pos = V2 CInt

Source#

A position as a two-dimensional vector.

typetype Color = V4 Word8

Source#

A color as an RGBA byte-vector.

valuepixel :: MonadIO m => Renderer -> Pos -> Color -> m ()

Source#

Renders a single pixel at a given position.

Lines

valueline :: MonadIO m => Renderer -> Pos -> Pos -> Color -> m ()

Source#

Renders a line between two points.

typetype Length = CInt

Source#

A length in pixels.

valuehorizontalLine :: MonadIO m => Renderer -> Pos -> Length -> Color -> m ()

Source#

Renders a horizontal line of a certain Length, its left and starting point corresponding to a given Pos.

valueverticalLine :: MonadIO m => Renderer -> Pos -> Length -> Color -> m ()

Source#

Renders a vertical line of a certain Length, its top and starting point corresponding to a given Pos.

valuesmoothLine :: MonadIO m => Renderer -> Pos -> Pos -> Color -> m ()

Source#

Renders an anti-aliased line between two points.

typetype Width = CInt

Source#

A width in pixels.

valuethickLine :: MonadIO m => Renderer -> Pos -> Pos -> Width -> Color -> m ()

Source#

Same as line, but the rendered line is of a given Width.

Triangles

valuetriangle :: MonadIO m => Renderer -> Pos -> Pos -> Pos -> Color -> m ()

Source#

Render a transparent triangle, its edges being of a given Color.

valuesmoothTriangle

:: MonadIO m
=> Renderer
-> Pos
-> Pos
-> Pos
-> Color
-> m ()

Source#

Same as triangle, but the edges are anti-aliased.

valuefillTriangle :: MonadIO m => Renderer -> Pos -> Pos -> Pos -> Color -> m ()

Source#

Same as triangle, but the triangle is filled with the given Color instead.

Rectangles

valuerectangle :: MonadIO m => Renderer -> Pos -> Pos -> Color -> m ()

Source#

Renders a transparent rectangle spanning two points, bordered by a line of a given Color.

typetype Radius = CInt

Source#

A radius in pixels.

valueroundRectangle

:: MonadIO m
=> Renderer
-> Pos
-> Pos
-> Radius
-> Color
-> m ()

Source#

Same as rectangle, but the rectangle's corners are rounded.

Control the roundness using the Radius argument, defining the radius of the corner arcs.

valuefillRectangle :: MonadIO m => Renderer -> Pos -> Pos -> Color -> m ()

Source#

Same as rectangle, but the rectangle is filled by the given Color.

valuefillRoundRectangle

:: MonadIO m
=> Renderer
-> Pos
-> Pos
-> Radius
-> Color
-> m ()

Source#

Same as roundRectangle, but the rectangle is filled by the given Color.

Curves

typetype Start = CInt

Source#

A starting position in degrees.

typetype End = CInt

Source#

An ending position in degrees.

valuearc

:: MonadIO m
=> Renderer
-> Pos
-> Radius
-> Start
-> End
-> Color
-> m ()

Source#

Render an arc, its Pos being its center.

The Start and End arguments define the starting and ending points of the arc in degrees, zero degrees being south and increasing counterclockwise.

valuecircle :: MonadIO m => Renderer -> Pos -> Radius -> Color -> m ()

Source#

Renders a transparent circle, bordered by a line of a given Color.

valuesmoothCircle :: MonadIO m => Renderer -> Pos -> Radius -> Color -> m ()

Source#

Same as circle, but the border is anti-aliased.

valuefillCircle :: MonadIO m => Renderer -> Pos -> Radius -> Color -> m ()

Source#

Same as circle, but fills it with the given Color instead.

valueellipse :: MonadIO m => Renderer -> Pos -> Radius -> Radius -> Color -> m ()

Source#

Renders a transparent ellipse, bordered by a line of a given Color.

The Radius arguments are the horizontal and vertical radius of the ellipse respectively, in pixels.

valuesmoothEllipse

:: MonadIO m
=> Renderer
-> Pos
-> Radius
-> Radius
-> Color
-> m ()

Source#

Same as ellipse, but makes the border anti-aliased.

valuefillEllipse

:: MonadIO m
=> Renderer
-> Pos
-> Radius
-> Radius
-> Color
-> m ()

Source#

Same as ellipse, but fills it with the given Color instead.

valuepie

:: MonadIO m
=> Renderer
-> Pos
-> Radius
-> Start
-> End
-> Color
-> m ()

Source#

Render a pie outline, its Pos being its center.

The Start and End arguments define the starting and ending points of the pie in degrees, zero degrees being east and increasing counterclockwise.

valuefillPie

:: MonadIO m
=> Renderer
-> Pos
-> Radius
-> Start
-> End
-> Color
-> m ()

Source#

Same as pie, but fills it with the given Color instead.

typetype Steps = CInt

Source#

How many interpolation steps when rendering a bezier curve?

The higher this is, the smoother the curve and more resource-intensive the render.

valuebezier

:: MonadIO m
=> Renderer
-> Vector Int16
-> Vector Int16
-> Steps
-> Color
-> m ()

Source#

Renders a bezier curve of a given Color.

The input vectors contain the bezier curve's point locations on the x and y-axis, respectively. The input vectors need to be the same length, and those lengths must be at least 3, otherwise bezier might raise an SDLException. The same applies for the number of interpolation Steps: it must be at least 2.

Polygons

valuepolygon

:: MonadIO m
=> Renderer
-> Vector Int16
-> Vector Int16
-> Color
-> m ()

Source#

Render a transparent polygon, its edges of a given Color.

The input vectors contain the points' locations on the x and y-axis, respectively. The input vectors need to be the of the same length, and the lengths must be at least 3, otherwise polygon might raise an SDLException.

valuesmoothPolygon

:: MonadIO m
=> Renderer
-> Vector Int16
-> Vector Int16
-> Color
-> m ()

Source#

Same as polygon, but the edges are drawn anti-aliased.

valuefillPolygon

:: MonadIO m
=> Renderer
-> Vector Int16
-> Vector Int16
-> Color
-> m ()

Source#

Same as polygon, but the polygon is filled with the given Color.