    {-# LANGUAGE FlexibleContexts     #-}
    {-# LANGUAGE TypeFamilies         #-}
    {-# LANGUAGE TypeSynonymInstances #-}
    -----------------------------------------------------------------------------
    -- |
    -- Module      :  Diagrams.TwoD
    -- Copyright   :  (c) 2011 diagrams-lib team (see LICENSE)
    -- License     :  BSD-style (see LICENSE)
    -- Maintainer  :  diagrams-discuss@googlegroups.com
    --
    -- This module defines the two-dimensional vector space R^2,
    -- two-dimensional transformations, and various predefined
    -- two-dimensional shapes.  This module re-exports useful
    -- functionality from a group of more specific modules:
    --
    --   * "Diagrams.TwoD.Types" defines basic types for two-dimensional
    --     diagrams, including types representing the 2D Euclidean vector
    --     space and various systems of angle measurement.
    --
    --   * "Diagrams.TwoD.Align" defines alignment combinators specialized
    --     to two dimensions (see "Diagrams.Align" for more general
    --     alignment).
    --
    --   * "Diagrams.TwoD.Combinators" defines ways of combining diagrams
    --     specialized to two dimensions (see also "Diagrams.Combinators"
    --     for more general combining).
    --
    --   * "Diagrams.TwoD.Transform" defines R^2-specific transformations
    --     such as rotation by an angle, and scaling, translation, and
    --     reflection in the X and Y directions.
    --
    --   * "Diagrams.TwoD.Ellipse" defines circles and ellipses.
    --
    --   * "Diagrams.TwoD.Arc" defines circular arcs.
    --
    --   * "Diagrams.TwoD.Path" exports various operations on
    --     two-dimensional paths when viewed as regions of the plane.
    --
    --   * "Diagrams.TwoD.Polygons" defines general algorithms for drawing
    --     various types of polygons.
    --
    --   * "Diagrams.TwoD.Shapes" defines other two-dimensional shapes,
    --     e.g. various polygons.
    --
    --   * "Diagrams.TwoD.Text" defines primitive text diagrams.
    --
    --   * "Diagrams.TwoD.Image" allows importing external images into diagrams.
    --
    --   * "Diagrams.TwoD.Vector" defines some special 2D vectors and
    --     functions for converting between vectors and angles.
    --
    --   * "Diagrams.TwoD.Size" defines functions for working with the
    --     size of 2D objects.
    --
    --   * "Diagrams.TwoD.Model" defines some aids for visualizing
    --     diagrams' internal model (local origins, envelopes, etc.)
    --
    -----------------------------------------------------------------------------
    module Diagrams.TwoD
           ( -- * R^2
             R2, r2, unr2
           , P2, p2, unp2
           , T2
           , unitX, unitY, unit_X, unit_Y
           , direction, fromDirection, e

             -- * Angles
           , tau
           , Angle(..)
           , Turn(..), CircleFrac, Rad(..), Deg(..)
           , fullCircle, convertAngle

             -- * Paths
             -- ** Stroking
           , stroke, stroke', strokeT, strokeT', strokeLine, strokeLoop
           , strokeLocT, strokeLocLine, strokeLocLoop
           , FillRule(..), fillRule
           , StrokeOpts(..)

             -- ** Clipping
           , clipBy

             -- * Shapes
             -- ** Rules
           , hrule, vrule

             -- ** Circle-ish things
           , unitCircle
           , circle
           , ellipse
           , ellipseXY
           , arc
           , arc'
           , arcCW
           , wedge

             -- ** General polygons
           , polygon, polyTrail
           , PolygonOpts(..), PolyType(..), PolyOrientation(..)

             -- ** Star polygons
           , StarOpts(..), star

             -- ** Regular polygons
           , regPoly
           , triangle
           , eqTriangle
           , square
           , pentagon
           , hexagon
           , septagon
           , octagon
           , nonagon
           , decagon
           , hendecagon
           , dodecagon

             -- ** Other special polygons
           , unitSquare
           , rect

             -- ** Other shapes
           , roundedRect, roundedRect'
           , RoundedRectOpts(..)

             -- * Text
           , text, topLeftText, alignedText, baselineText
           , font, fontSize, italic, oblique, bold

             -- * Images
           , image

             -- * Transformations
             -- ** Rotation
           , rotation, rotate, rotateBy
           , rotationAbout, rotateAbout
             -- ** Scaling
           , scalingX, scaleX
           , scalingY, scaleY
           , scaling, scale
           , scaleToX, scaleToY
           , scaleUToX, scaleUToY
             -- ** Translation
           , translationX, translateX
           , translationY, translateY
           , translation, translate
             -- ** Reflection
           , reflectionX, reflectX
           , reflectionY, reflectY
           , reflectionAbout, reflectAbout
             -- ** Shears
           , shearingX, shearX
           , shearingY, shearY

             -- * Combinators
             -- ** Combining multiple diagrams
           , (===), (|||), atAngle
           , hcat, hcat'
           , vcat, vcat'

             -- ** Spacing and envelopes
           , strutX, strutY
           , padX, padY

           , extrudeLeft, extrudeRight, extrudeBottom, extrudeTop

           , view

             -- ** Background

           , boundingRect, bg

             -- * Alignment
           , alignL, alignR, alignT, alignB, alignTL, alignTR, alignBL, alignBR
           , alignX, alignY
           , centerX, centerY, centerXY

             -- * Size
             -- ** Computing size
           , width, height, size2D, sizeSpec2D
           , extentX, extentY, center2D

             -- ** Specifying size
           , SizeSpec2D(..)
           , mkSizeSpec

             -- ** Adjusting size
           , sized, sizedAs

             -- * Visual aids for understanding the internal model
           , showOrigin
           , showOrigin'
           , OriginOpts(..)
           , showLabels

           ) where

    import           Diagrams.TwoD.Align
    import           Diagrams.TwoD.Arc
    import           Diagrams.TwoD.Combinators
    import           Diagrams.TwoD.Ellipse
    import           Diagrams.TwoD.Image
    import           Diagrams.TwoD.Model
    import           Diagrams.TwoD.Path
    import           Diagrams.TwoD.Polygons
    import           Diagrams.TwoD.Shapes
    import           Diagrams.TwoD.Size
    import           Diagrams.TwoD.Text
    import           Diagrams.TwoD.Transform
    import           Diagrams.TwoD.Types
    import           Diagrams.TwoD.Vector

    import           Diagrams.Util             (tau)