{-# LANGUAGE MultiParamTypeClasses #-} -- {-# LANGUAGE MultiParamTypeClasses, FlexibleInstances #-} {-# language TypeFamilies, FlexibleContexts #-} {- | This module provides functionality for working with affine transformations (i.e. in the unit square) -} module Graphics.Rendering.Plot.Light.Internal.Geometry where import Graphics.Rendering.Plot.Light.Internal.Types -- | V2 is a vector in R^2 data V2 a = V2 a a deriving (Eq, Show) -- | Vectors form a monoid w.r.t. vector addition instance Num a => Monoid (V2 a) where mempty = V2 0 0 (V2 a b) `mappend` (V2 c d) = V2 (a + b) (c + d) -- | Additive group : -- v ^+^ zero = zero ^+^ v = v -- v ^-^ v == zero class AdditiveGroup v where zero :: v (^+^) :: v -> v -> v (^-^) :: v -> v -> v instance Num a => AdditiveGroup (V2 a) where zero = mempty (^+^) = mappend (V2 a b) ^-^ (V2 c d) = V2 (a - c) (b - d) -- | Vector space : multiplication by a scalar quantity class AdditiveGroup v => VectorSpace v where type Scalar v :: * (.*) :: Scalar v -> v -> v instance Num a => VectorSpace (V2 a) where type Scalar (V2 a) = a n .* (V2 vx vy) = V2 (n*vx) (n*vy) -- | Hermitian space : inner product class VectorSpace v => Hermitian v where type InnerProduct v :: * (<.>) :: v -> v -> InnerProduct v instance Num a => Hermitian (V2 a) where type InnerProduct (V2 a) = a (V2 a b) <.> (V2 c d) = (a*c) + (b*d) -- | Euclidean (L^2) norm norm2 :: (Hermitian v, Floating n, n ~ (InnerProduct v)) => v -> n norm2 v = sqrt $ v <.> v -- | Normalize a V2 w.r.t. its Euclidean norm normalize2 :: (InnerProduct v ~ Scalar v, Floating (Scalar v), Hermitian v) => v -> v normalize2 v = (1/norm2 v) .* v -- | Create a V2 `v` from two endpoints p1, p2. That is `v` can be seen as pointing from `p1` to `p2` mkV2fromEndpoints, (-.) :: Num a => Point a -> Point a -> V2 a mkV2fromEndpoints (Point px py) (Point qx qy) = V2 (qx-px) (qy-py) (-.) = mkV2fromEndpoints -- | The origin of the axes, point (0, 0) origin :: Num a => Point a origin = Point 0 0 -- | A Mat2 can be seen as a linear operator V2 -> V2 data Mat2 a = Mat2 a a a a deriving (Eq, Show) -- | Linear maps, i.e. linear transformations of vectors class Hermitian v => LinearMap m v where (#>) :: m -> v -> v -- | Multiplicative matrix semigroup ("multiplying" two matrices together) class MultiplicativeSemigroup m where (##) :: m -> m -> m instance Num a => LinearMap (Mat2 a) (V2 a) where (Mat2 a00 a01 a10 a11) #> (V2 vx vy) = V2 (a00 * vx + a01 * vy) (a10 * vx + a11 * vy) -- | Create a diagonal matrix diagMat2 :: Num a => a -> a -> Mat2 a diagMat2 rx ry = Mat2 rx 0 0 ry -- | Diagonal matrices in R2 behave as scaling transformations data DiagMat2 a = DMat2 a a deriving (Eq, Show) -- | The class of invertible linear transformations class LinearMap m v => MatrixGroup m v where (<\>) :: m -> v -> v instance Num a => MultiplicativeSemigroup (DiagMat2 a) where DMat2 a b ## DMat2 c d = DMat2 (a*c) (b*d) -- | Diagonal matrices can always be inverted instance Num a => LinearMap (DiagMat2 a) (V2 a) where DMat2 d1 d2 #> V2 vx vy = V2 (d1 * vx) (d2 * vy) instance Fractional a => MatrixGroup (DiagMat2 a) (V2 a) where DMat2 d1 d2 <\> V2 vx vy = V2 (vx / d1) (vy / d2) -- | Build a V2 from a `Point` p (i.e. assuming the V2 points from the origin (0,0) to p) v2fromPoint :: Num a => Point a -> V2 a v2fromPoint p = origin -. p -- | Move a point along a vector movePoint :: Num a => V2 a -> Point a -> Point a movePoint (V2 vx vy) (Point px py) = Point (px + vx) (py + vy) -- | Move a `LabeledPoint` along a vector moveLabeledPointV2 :: Num a => V2 a -> LabeledPoint l a -> LabeledPoint l a moveLabeledPointV2 = moveLabeledPoint . movePoint -- | The vector translation from a `Point` contained in a `Frame` onto the unit square -- -- NB: we do not check that `p` is actually contained within the frame. This has to be supplied correctly by the user toUnitSquare :: (Fractional a, MatrixGroup (Mat2 a) (V2 a)) => Frame a -> Point a -> Point a toUnitSquare from p = movePoint vmove p where mm = diagMat2 (width from) (height from) o1 = _fpmin from vmove = mm <\> (p -. o1) -- | The vector translation from a `Point` contained in the unit square onto a `Frame` -- -- NB: we do not check that `p` is actually contained in [0,1] x [0,1], This has to be supplied correctly by the user fromUnitSquare :: Num a => Frame a -> Point a -> Point a fromUnitSquare to p = movePoint vmove p where mm = diagMat2 (width to) (height to) vo = v2fromPoint (_fpmin to) vmove = (mm #> v2fromPoint p) ^+^ vo -- | Coordinate unit vectors e1, e2 :: Num a => V2 a e1 = V2 1 0 e2 = V2 0 1 -- class Located v where -- type Coords v :: * -- position :: v -> Coords v