Diagrams.TwoD.Util

Utility functions for diagrams in two-dimensional Cartesian space.

General two-dimensional utilities

unitX :: R2

The unit vector in the positive X direction.

unitY :: R2

The unit vector in the positive Y direction.

unit_X :: R2

The unit vector in the negative X direction.

unit_Y :: R2

The unit vector in the negative Y direction.

direction :: R2 -> CircleFrac

Compute the direction of a vector, measured counterclockwise from the positive x-axis as a fraction of a full turn. The zero vector is arbitrarily assigned the direction 0.

Size and extent of diagrams in R2

Computing sizes

width :: (Boundable a, V a ~ R2) => a -> Double

Compute the width of a diagram.

height :: (Boundable a, V a ~ R2) => a -> Double

Compute the height of a diagram.

size2D :: (Boundable a, V a ~ R2) => a -> (Double, Double)

Compute the width and height of a diagram.

extentX :: (Boundable a, V a ~ R2) => a -> (Double, Double)

Compute the absolute x-coordinate range of a diagram in R2, in the form (lo,hi).

extentY :: (Boundable a, V a ~ R2) => a -> (Double, Double)

Compute the absolute y-coordinate range of a diagram in R2, in the form (lo,hi).

center2D :: (Boundable a, V a ~ R2) => a -> P2

Compute the point at the center (in the x- and y-directions) of a diagram.

Specifying sizes

data SizeSpec2D

A specification of a (requested) rectangular size.

Constructors

Width Double

Specify an explicit width. The height should be determined automatically (so as to preserve aspect ratio).

Height Double

Specify an explicit height. The width should be determined automatically (so as to preserve aspect ratio)

Dims Double Double

An explicit specification of both dimensions.

Absolute

Absolute size: use whatever size an object already has; do not rescale.