gloss-algorithms-1.11.1.1: Data structures and algorithms for working with 2D graphics.

Safe HaskellNone
LanguageHaskell98

Graphics.Gloss.Data.Extent

Description

Represents an integral rectangular area of the 2D plane. Using Ints (instead of Floats) for the bounds means we can safely compare extents for equality.

Synopsis

Documentation

data Extent #

A rectangular area of the 2D plane. We keep the type abstract to ensure that invalid extents cannot be constructed.

Instances

Eq Extent # 

Methods

(==) :: Extent -> Extent -> Bool #

(/=) :: Extent -> Extent -> Bool #

Show Extent # 

type Coord = (Int, Int) #

An integral coordinate.

makeExtent #

Arguments

:: Int

y max (north)

-> Int

y min (south)

-> Int

x max (east)

-> Int

x min (west)

-> Extent 

Construct an extent. The north value must be > south, and east > west, else error.

takeExtent :: Extent -> (Int, Int, Int, Int) #

Take the NSEW components of an extent.

squareExtent :: Int -> Extent #

A square extent of a given size.

sizeOfExtent :: Extent -> (Int, Int) #

Get the width and height of an extent.

isUnitExtent :: Extent -> Bool #

Check if an extent is a square with a width and height of 1.

coordInExtent :: Extent -> Coord -> Bool #

Check whether a coordinate lies inside an extent.

pointInExtent :: Extent -> Point -> Bool #

Check whether a point lies inside an extent.

centerCoordOfExtent :: Extent -> (Int, Int) #

Get the coordinate that lies at the center of an extent.

cutQuadOfExtent :: Quad -> Extent -> Extent #

Cut one quadrant out of an extent.

quadOfCoord :: Extent -> Coord -> Maybe Quad #

Get the quadrant that this coordinate lies in, if any.

pathToCoord :: Extent -> Coord -> Maybe [Quad] #

Constuct a path to a particular coordinate in an extent.

intersectSegExtent :: Point -> Point -> Extent -> Maybe Point #

If a line segment (P1-P2) intersects the outer edge of an extent then return the intersection point, that is closest to P1, if any. If P1 is inside the extent then Nothing.

                  P2
                 /
           ----/-
           | /  |
           +    |
          /------
        / 
       P1
  

touchesSegExtent :: Point -> Point -> Extent -> Bool #

Check whether a line segment's endpoints are inside an extent, or if it intersects with the boundary.