wumpus-core: Pure Haskell PostScript and SVG generation.

[ bsd3, graphics, library ] [ Propose Tags ]

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:

  1. 21.0 to 0.22.0:

  • Moved the deprecated module Wumpus.Extra.PictureLanguage into the package Wumpus-Basic along with the example Picture.hs.

  • Added vec as a synonym for the constructor V2.

  • Changed some of the Core.FontSize to use better terminology. Thus some of the constants have changed. Added a new example FontMetrics.hs to illustrate how FontSize works. Particularly, the function capHeight has been replaced with the function numeralHeight which has better semantics.

  • The CTM data type and ToCTM class are now hidden in the top-level import module Wumpus.Core. They can be accessed by importing Wumpus.Core.GraphicsState directly.

  • Exposed the PSUnit type class.

  1. 20.0 to 0.21.0:

  • Removed the Primitive instances of the Affine transformation classes. They have been replaced with special transformation functions: rotatePrimitive, scalePrimitive, translatePrimitive. As Primitives are not in an affine frame until they are lifted to Pictures the affine instances had ill-conceived semantics.

  • Due to changes to accommodate the new non-affine transformations, many of the class obligations have changed on the unit of Pictures, Primitives, Bounding Boxes etc. Generally many class contexts that previously required Fractional and Ord on the unit have changed to Real and Floating.

  • Removed demo/AffineTest04.hs - there is no longer a rotateAbout operation on Primitives as they do not exist in an affine frame until they they are lifted to Pictures. Added - Scaled.hs, Rotated.hs, Translated,hs.

  • Removed the UndecidableInstances pragma from Core.PictureInternal. It looks like Core.Geometry will always need UndecidableInstances though.

  • Removed the Ord superclass constriant from the Stroke and Fill classes and derived operations (e.g. zostroke).

Downloads

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'.

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

  • No Candidates
Versions [RSS] 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
Change log CHANGES
Dependencies algebra (<0.1), base (<5), containers, monadLib, time (>=1.1.3 && <1.2), vector-space, wl-pprint, xml [details]
License BSD-3-Clause
Copyright Stephen Tetley <stephen.tetley@gmail.com>
Author
Maintainer Stephen Tetley <stephen.tetley@gmail.com>
Revised Revision 1 made by HerbertValerioRiedel at 2015-11-07T12:22:40Z
Category Graphics
Home page http://code.google.com/p/copperbox/
Uploaded by StephenTetley at 2010-08-06T11:52:24Z
Distributions
Reverse Dependencies 5 direct, 0 indirect [details]
Downloads 25125 total (36 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs uploaded by user
Build status unknown [no reports yet]