wumpus-core-0.20.0: wumpus-core.cabal
name: wumpus-core
version: 0.20.0
license: BSD3
license-file: LICENSE
copyright: Stephen Tetley <stephen.tetley@gmail.com>
maintainer: Stephen Tetley <stephen.tetley@gmail.com>
homepage: http://code.google.com/p/copperbox/
category: Graphics
synopsis: Pure Haskell PostScript and SVG generation.
description:
.
Wumpus - (W)riter (M)onad (P)ost (S)cript.
.
Wumpus is a kernel library for generating 2D vector pictures,
its salient feature is portability due to no FFI dependencies.
It can generate PostScript (EPS) files and SVG files. The
generated PostScript code is plain [1] and reasonably
efficient as the use of stack operations, i.e @gsave@ and
@grestore@, is minimized.
.
Pictures in Wumpus are made from /paths/ and text /labels/.
Paths themselves are made from points. The usual affine
transformations (rotations, scaling, translations) can be
applied to geometric objects. Unlike PostScript there
is no notion of a current point, Wumpus builds pictures in a
coordinate-free style.
.
GENERAL DRAWBACKS...
.
For actually drawing pictures, diagrams, etc. Wumpus is very
low level. There is a supplemantary package @wumpus-basic@
available that helps create certain types of diagram, but even
this lacks the higher-level stuff (polygons, arrows etc.) that
would make creating general drawings easy.
.
Some of the design decisions made for wumpus-core are not
sophisticated (e.g. how attributes like colour are handled,
and how the bounding boxes of text labels are calculated), so
Wumpus might be limited compared to other systems. However,
the design permits a fairly simple implementation - which is
a priority. Text encoding an exception - I\'m not sure how
reasonable the design is. The current implementation
appears okay for Latin 1 but may be inadequate for other
character sets, so I may have to revise it significantly.
.
WARNING...
.
The module @Core.BoundingBox@ is likely to be reworked
significantly in the future. It has too many functions that do
not offer distinct functionality. Some functions were removed in
revision 0.17.0 and some more are likely to follow.
.
The module @Extra.PictureLanguage@ is deprecated. At some point
it will be superceded by @wumpus-basic@ but this will not be soon.
.
.
\[1\] Because the output is simple, straight-line PostScript
code, it is possible to use GraphicsMagick or a similar tool
to convert Wumpus'\s EPS files to many other formats
(bitmaps).
.
Changelog:
.
0.19.0 to 0.20.0:
.
* Removed the modules - Wumpus.Extra.SafeFonts,
Wumpus.Extra.SVGColours, Wumpus.Extra.X11Colours - they are
now in the package @wumpus-basic@.
.
* Removed the example FontPic.hs to @wumpus-basic@.
.
* Renamed two functions in Core.BoundingBox - @trace@ changed
to @traceBoundary@; @retrace@ changed to @retraceBoundary@.
.
* Fixed bug with @picOver@, previously the zorder was wrong
and the function was actually working as /picUnder/.
.
* Added @capHeight@ to FontSize - get the size of an upper
case letter without ascenders of descenders.
.
* Guide updated regarding the new package @wumpus-basic@.
.
.
build-type: Simple
stability: unstable
cabal-version: >= 1.2
extra-source-files:
CHANGES,
LICENSE,
demo/AffineTest01.hs,
demo/AffineTest02.hs,
demo/AffineTest03.hs,
demo/AffineTest04.hs,
demo/AffineTestBase.hs,
demo/LabelPic.hs,
demo/MultiPic.hs
demo/Picture.hs,
doc/Guide.pdf,
doc-src/Guide.lhs,
doc-src/Makefile,
doc-src/WorldFrame.hs
library
hs-source-dirs: src
build-depends: base < 5, containers,
time >= 1.1.3 && < 1.2,
wl-pprint, vector-space,
monadLib, xml, algebra
exposed-modules:
Wumpus.Core,
Wumpus.Core.AffineTrans,
Wumpus.Core.BoundingBox,
Wumpus.Core.Colour,
Wumpus.Core.FontSize,
Wumpus.Core.Geometry,
Wumpus.Core.GraphicsState,
Wumpus.Core.OutputPostScript,
Wumpus.Core.OutputSVG,
Wumpus.Core.Picture,
Wumpus.Core.TextEncoder,
Wumpus.Core.TextLatin1,
Wumpus.Core.VersionNumber,
Wumpus.Core.WumpusTypes,
Wumpus.Extra.PictureLanguage
other-modules:
Wumpus.Core.PictureInternal,
Wumpus.Core.PostScript,
Wumpus.Core.SVG,
Wumpus.Core.OneList,
Wumpus.Core.TextEncodingInternal,
Wumpus.Core.Utils
extensions:
ghc-options:
includes: