Maintainer | diagrams-discuss@googlegroups.com |
---|

Transformations specific to two dimensions, with a few generic transformations (uniform scaling, translation) also re-exported for convenience.

- rotation :: Angle a => a -> T2
- rotate :: (Transformable t, V t ~ R2, Angle a) => a -> t -> t
- rotateBy :: (Transformable t, V t ~ R2) => CircleFrac -> t -> t
- rotationAbout :: Angle a => P2 -> a -> T2
- rotateAbout :: (Transformable t, V t ~ R2, Angle a) => P2 -> a -> t -> t
- scalingX :: Double -> T2
- scaleX :: (Transformable t, V t ~ R2) => Double -> t -> t
- scalingY :: Double -> T2
- scaleY :: (Transformable t, V t ~ R2) => Double -> t -> t
- scaling :: (HasLinearMap v, Fractional (Scalar v)) => Scalar v -> Transformation v
- scale :: (Transformable t, Fractional (Scalar (V t))) => Scalar (V t) -> t -> t
- scaleToX :: (Boundable t, Transformable t, V t ~ R2) => Double -> t -> t
- scaleToY :: (Boundable t, Transformable t, V t ~ R2) => Double -> t -> t
- translationX :: Double -> T2
- translateX :: (Transformable t, V t ~ R2) => Double -> t -> t
- translationY :: Double -> T2
- translateY :: (Transformable t, V t ~ R2) => Double -> t -> t
- translation :: HasLinearMap v => v -> Transformation v
- translate :: (Transformable t, HasLinearMap (V t)) => V t -> t -> t
- reflectionX :: T2
- reflectX :: (Transformable t, V t ~ R2) => t -> t
- reflectionY :: T2
- reflectY :: (Transformable t, V t ~ R2) => t -> t
- reflectionAbout :: P2 -> R2 -> T2
- reflectAbout :: (Transformable t, V t ~ R2) => P2 -> R2 -> t -> t

# Rotation

rotation :: Angle a => a -> T2Source

Create a transformation which performs a rotation by the given
angle. See also `rotate`

.

rotate :: (Transformable t, V t ~ R2, Angle a) => a -> t -> tSource

Rotate by the given angle. Positive angles correspond to
counterclockwise rotation, negative to clockwise. The angle can
be expressed using any type which is an instance of `Angle`

. For
example, `rotate (1`

, and
*4 :: 'CircleFrac')@, @rotate (pi*2 :: `Rad`

)`rotate (90 :: `

all represent the same transformation, namely,
a counterclockwise rotation by a right angle.
`Deg`

)

Note that writing `rotate (1/4)`

, with no type annotation, will
yield an error since GHC cannot figure out which sort of angle
you want to use. In this common situation you can use
`rotateBy`

, which is specialized to take a `CircleFrac`

argument.

rotateBy :: (Transformable t, V t ~ R2) => CircleFrac -> t -> tSource

A synonym for `rotate`

, specialized to only work with
`CircleFrac`

arguments; it can be more convenient to write
`rotateBy (1`

.
*4)@ than @'rotate' (1*4 :: `CircleFrac`

)

rotationAbout :: Angle a => P2 -> a -> T2Source

`rotationAbout p`

is a rotation about the point `p`

(instead of
around the local origin).

rotateAbout :: (Transformable t, V t ~ R2, Angle a) => P2 -> a -> t -> tSource

`rotateAbout p`

is like `rotate`

, except it rotates around the
point `p`

instead of around the local origin.

# Scaling

scalingX :: Double -> T2Source

Construct a transformation which scales by the given factor in the x (horizontal) direction.

scaleX :: (Transformable t, V t ~ R2) => Double -> t -> tSource

Scale a diagram by the given factor in the x (horizontal)
direction. To scale uniformly, use
`Graphics.Rendering.Diagrams.Transform.scale`

.

scalingY :: Double -> T2Source

Construct a transformation which scales by the given factor in the y (vertical) direction.

scaleY :: (Transformable t, V t ~ R2) => Double -> t -> tSource

Scale a diagram by the given factor in the y (vertical)
direction. To scale uniformly, use
`Graphics.Rendering.Diagrams.Transform.scale`

.

scaling :: (HasLinearMap v, Fractional (Scalar v)) => Scalar v -> Transformation v

Create a uniform scaling transformation.

scale :: (Transformable t, Fractional (Scalar (V t))) => Scalar (V t) -> t -> t

Scale uniformly in every dimension by the given scalar.

scaleToX :: (Boundable t, Transformable t, V t ~ R2) => Double -> t -> tSource

`scaleToX w`

scales a diagram in the x (horizontal) direction by
whatever factor required to make its width `w`

. `scaleToX`

should not be applied to diagrams with a width of 0, such as
`vrule`

.

scaleToY :: (Boundable t, Transformable t, V t ~ R2) => Double -> t -> tSource

`scaleToY h`

scales a diagram in the y (vertical) direction by
whatever factor required to make its height `h`

. `scaleToY`

should not be applied to diagrams with a width of 0, such as
`hrule`

.

# Translation

translationX :: Double -> T2Source

Construct a transformation which translates by the given distance in the x (horizontal) direction.

translateX :: (Transformable t, V t ~ R2) => Double -> t -> tSource

Translate a diagram by the given distance in the x (horizontal) direction.

translationY :: Double -> T2Source

Construct a transformation which translates by the given distance in the y (vertical) direction.

translateY :: (Transformable t, V t ~ R2) => Double -> t -> tSource

Translate a diagram by the given distance in the y (vertical) direction.

translation :: HasLinearMap v => v -> Transformation v

Create a translation.

translate :: (Transformable t, HasLinearMap (V t)) => V t -> t -> t

Translate by a vector.

# Reflection

Construct a transformation which flips a diagram from left to right, i.e. sends the point (x,y) to (-x,y).

reflectX :: (Transformable t, V t ~ R2) => t -> tSource

Flip a diagram from left to right, i.e. send the point (x,y) to (-x,y).

Construct a transformation which flips a diagram from top to bottom, i.e. sends the point (x,y) to (x,-y).

reflectY :: (Transformable t, V t ~ R2) => t -> tSource

Flip a diagram from top to bottom, i.e. send the point (x,y) to (x,-y).

reflectionAbout :: P2 -> R2 -> T2Source

`reflectionAbout p v`

is a reflection in the line determined by
the point `p`

and vector `v`

.

reflectAbout :: (Transformable t, V t ~ R2) => P2 -> R2 -> t -> tSource

`reflectAbout p v`

reflects a diagram in the line determined by
the point `p`

and the vector `v`

.