The wumpus-core package
Wumpus is a low-level library for generating static 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  and reasonably
efficient as the use of stack operations, i.e
grestore, is minimized.
Wumpus makes pictures from paths and text labels. Paths themselves are made from points. The usual affine transformations (rotations, scaling, translations) can be applied to Pictures. Unlike PostScript there is no notion of a current point, Wumpus builds pictures in a coordinate-free style.
For actually drawing pictures, diagrams, etc. Wumpus is very
low-level. There is a supplemantary package
available that helps create certain types of diagram, but it is
experimental - functionality is added and dropped between
releases, it has no stable API.
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
\[1\] Because the output is simple, straight-line PostScript code, it is possible to use GraphicsMagick or a similar tool to convert EPS files generated by Wumpus to many other formats (bitmaps).
VERSION 0.36.0 UPGRADE NOTES
There are two major changes between 0.35.0 and 0.36.0.
PrimElement has been removed and the grouping constructor it
provided has been moved into the
Primitive type. As both
types are opaque, definitions in client code will work without
change, but all type signatures referencing
need to replace
Rotations and scalings on Primitives have changed again.
Primitives are now instances of the affine classes so support -
translate. Primitives are
now considered to be in the implicit affine frame with origin at
(0,0). Previously rotatation on Primitives (via the function
rotatePrim) was really a special case to allow slanted text,
the rotation was about the text's baseline origin and not the
affine frame. As rotation now works differently there is a
special constructor for slanted text
35.0 to 0.36.0:
API / behaviour change - rotation on primitives changed. New functions have been added to create rotated text labels and ellipses (
rstrokeEllipse, etc.), and Primitives have been made instances of the Affine classes except for the general matrix Transform class. The old functions for transforming Primitives (
scalePrim, etc.) have been removed. The demos (Rotated.hs, Scaled.hs, Translated.hs) have been removed as they pertain to the old behaviour, there are new demos highlighting the new behaviour (TransformEllipse.hs, etc.).
Major change - removed the PrimElement type. The (opaque) Primitive type has been changed to incorporate a grouping constructor equivalent to PrimElement's
XLinkGroupcontructor. The change has made the implementation of SVG hyperlinks more efficient, but has forced various type signatures to change in
Core.Picture. Client code will also have to change type signatures -
Core.PtSize- the class
FromPtSizehas been given a
Numsuperclass constraint. This can shorten type signatures of functions that use
Corrected a bug where textlabels would generate an invalid bounding box and cause a runtime error when supplied with an empty string. Now there is no runtime error - and no-ops are generated in the output.
Internal changes - moved
Core.PictureInternalinto separate module. Moved utility modules into their own directory
Utils. Move text modules into their own directory
Removed dependency on
Semigroup. The equivalent
Core.GraphicProps. Moved the property datatypes from
Core.GraphicProps(StrokeProps, LabelProps, etc.).
Haddock docs improved.
|Versions||0.12.0, 0.13.0, 0.13.1, 0.14.0, 0.15.0, 0.16.0, 0.17.0, 0.18.0, 0.19.0, 0.20.0, 0.21.0, 0.22.0, 0.23.0, 0.30.0, 0.31.0, 0.32.0, 0.33.0, 0.34.0, 0.35.0, 0.36.0, 0.37.0, 0.40.0, 0.41.0, 0.42.0, 0.42.1, 0.43.0, 0.50.0, 0.51.0, 0.52.0, 0.52.1|
|Dependencies||base (<4.5), containers (>=0.3 && <=0.4), time (>=1.1.3 && <1.2), vector-space (>=0.6 && <1.0) [details]|
|Copyright||Stephen Tetley <firstname.lastname@example.org>|
|Maintainer||Stephen Tetley <email@example.com>|
|Uploaded||Wed Oct 13 19:39:00 UTC 2010 by StephenTetley|
|Updated||Sat Nov 7 11:44:52 UTC 2015 by HerbertValerioRiedel to revision 1 [What is this?]|
|Downloads||8245 total (2593 in the last 30 days)|
|Rating||(no votes yet) [estimated by rule of succession]|
|Status||Docs uploaded by user
Build status unknown [no reports yet]
Hackage Matrix CI
- wumpus-core-0.36.0.tar.gz [browse] (Cabal source package)
- Package description (revised from the package)
Note: This package has metadata revisions in the cabal description newer than included in the tarball. To unpack the package including the revisions, use 'cabal get'.
For package maintainers and hackage trustees