The wumpus-core package
Wumpus-Core 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 someways
efficient as the use of stack operations, i.e
grestore, is minimized (unfortunately there is no sharing
so the generated PostScript can be huge...).
Although Wumpus-Core only generates vector output, the generated PostScript can be interpreted by GraphicsMagick or a similar tool to convert EPS files into bitmap image files (e.g JPEGs).
Wumpus-Core 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-Core builds pictures by direct positioning of each element.
For actually building pictures, diagrams, etc. Wumpus-Core is
very low-level. There are two supplementary packages
Wumpus-Drawing also on Hackage that aim to
be a higher-level basis for creating certain types of diagram,
but they are experimental - functionality is added and dropped
between releases and curently the API is too unstable to write
code upon (they should be considered a technology preview rather
than re-usable libraries).
Also, some of the design decisions made for Wumpus-Core are not sophisticated - e.g. how path and text attributes like colour are handled, and how the bounding boxes of text labels are calculated. Compared to other systems, Wumpus might be rather limited, however, the design permits a fairly simple implementation.
v0.52.0 to v0.52.1:
(<>)format combinator that caused problems for GHC 7.4.
v0.51.0 to v0.52.0:
Added limited support for adding SVG ids to text and Primitives.
Fixed types of
r2dto Double for degrees, rather than a parametric (Real a, Floating a) type. Although this is less general, it removes the burden of type annotating the common case.
Added the vector functions
v0.50.0 to v0.51.0:
Added special cases to handle continuity to the function
Extended some Haddock documentation.
v0.43.0 to v0.50.0:
Major change hence the version number jump - the notion of parametric unit has been removed from the
Pictureobjects (it for remains the
Vec2etc.). Certain useful units, e.g.
en, are contextual on the "current point size", and having a parametric unit here was actually a hinderance to supporting units properly in higher-level layers. Now all Picture objects (those defined or exported from
Core.Picture) are fixed to use Double
representing PostScript points. Higher level layers that intend to support alternative units must translate drawing objects to PostScript point measurements before calling the Picture API. Geometric objects - objects defined in
Vec2- are still polymorphic on unit.
Picture API change - Various function names changed.
absCurveTo. The path builders are qualified with Prim,
API change -
PtSizedata type replaced by
AfmUnitfor font measurements.
API and representation change - clipping paths are represented as
Primitiveconstructor rather than a
Pictureconstructor. This should make them more useful. The type of the function
Core.Picturehas likewise changed.
Picture API change - changed
absPrimPath, added the functions
Added the class
Core.Geometryand made the Eq instances of
BoundingBoxtolerant. Tolerance accounts for a fairly lax equality on floating point numbers - it is suitable for Wumpus (printing) where high accuracy is needed.
v0.42.1 to v0.43.0:
API change - the function
Core.Geometryhas changed. It now implements a better method of drawing circles with Bezier curves and no longer needs the subvision factor. The old circle drawing function has been retained as
subdivisionCircleas it is useful for corroborating
bezierCircle, but the general use of
subdivisionCircleshould be avoided.
Added a function
|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.8), containers (>=0.3 && <=0.6), time (>=1.1.3 && <1.6), vector-space (>=0.6 && <1.0) [details]|
|Copyright||Stephen Tetley <firstname.lastname@example.org>|
|Maintainer||Stephen Tetley <email@example.com>|
|Uploaded||Tue May 1 12:50:58 UTC 2012 by StephenTetley|
|Updated||Sat Nov 7 11:42:34 UTC 2015 by HerbertValerioRiedel to revision 1|
|Downloads||5609 total (66 in the last 30 days)|
|Rating||0.0 (0 ratings) [clear rating]|
|Status||Docs uploaded by user
Build status unknown [no reports yet]
Hackage Matrix CI
For package maintainers and hackage trustees