The wumpus-core package

[Tags: bsd3, library]

Wumpus - (W)riter (M)onad (P)ost (S)cript.

Wumpus is a 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 quite efficient (no unnecessary stack operations).

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. There is a set of combinators for composing pictures (more-or-less similar to the usual pretty printing combinators).

With revision 0.15.0 I've added three extra helper modules that are not really part of the "core", but they provide lists of named colours and fonts.

WARNING...

wumpus-core is likely to change quite a bit with the next revision as I want to see if I can make Primitives support affine translations. Hopefully this will not change the API significantly though it will mean the generated SVG and PostScript files will be different (possibly clearer). Also the Core.BoundingBox module is not too well designed, too many functions that do not offer distinct functionality. Some functionality was removed in this revision (0.17.0) and more is likely to follow.

GENERAL DRAWBACKS...

For actually drawing pictures, diagrams, etc. Wumpus is very low level. I've worked on a complementary package wumpus-extra with higher-level stuff (polygons, arrows etc.) but it is too unstable for Hackage. Preview releases can be found at http://code.google.com/p/copperbox/ though.

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 its design permits a 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 I'm not sure about other character sets, and I may have to revise it significantly.

With revision 0.14.0, I've added the first draft of a user guide. Source for the guide is included as well as the PDF as there is an extra example picture. wumpus-extra hasn't received any more attention unfortunately, so Wumpus is still really a bit too primitive for general use. However, if you want FFI-free vector graphics and Wumpus seems to otherwise fit the task, please email me and I will try to help.

[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.16.0 to 0.17.0:

0.15.0 to 0.16.0:


Properties

Versions0.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
Dependenciesalgebra, base (<5), containers, monadLib, time (>=1.1.3 && <1.2), vector-space, wl-pprint, xml
LicenseBSD3
CopyrightStephen Tetley <stephen.tetley@gmail.com>
MaintainerStephen Tetley <stephen.tetley@gmail.com>
Stabilityunstable
CategoryGraphics
Home pagehttp://code.google.com/p/copperbox/
Upload dateMon May 17 14:57:08 UTC 2010
Uploaded byStephenTetley
Downloads2082 total (258 in last 30 days)

Modules

[Index]

Downloads

Maintainers' corner

For package maintainers and hackage trustees