name: wumpus-core version: 0.32.0 x-revision: 1 license: BSD3 license-file: LICENSE copyright: Stephen Tetley maintainer: Stephen Tetley homepage: http://code.google.com/p/copperbox/ category: Graphics synopsis: Pure Haskell PostScript and SVG generation. description: . 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 Pictures. 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 it is experimental - functionality is added an dropped between releases. . 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. . \[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.31.0 to 0.32.0: . * Major API changes to @Core.Picture@ for XML hyperlinks. Hyperlinks now group one-or-more Primitives (path or label), instead of being attached to a single Primitive. This better corresponds with XML but it has made the Picture type more complicated, and has mandated significant changes to the Picture API. All the hyperlink variants of the Primitive constructors have been removed (xcstroke, xfill, xtextlabel, ...), and hyperlinks are now created with @xlinkGroup@. . * The type signatures for the /primitive/ constructors (fill, cstroke, textlabel, ...) in the Picture API have changed and are now more complicated as there is an extra layer of indirection in the type hierarchy. . * The primitive constructors for filled and stroked paths and ellipses have been renamed: @bordered@ is now @fillStroke@, @borderedEllipse@ is now @fillStrokeEllipse@. . * @Core.FontSize@ - the arguments to the function @textBounds@ have been changed to take the String in question, rather than its precomputed length. The size of the string is then calculated with the new function @charCount@ which takes into account escaped characters. . * Added @yellow@, @cyan@ and @magenta@ to the predefined colours in @Core.Colour@. . 0.30.0 to 0.31.0: . * Extended the label type to optionally handle horizontal or vertical \"kerning\". This can be efficiently implemented in SVG. . * Major API change - the Primitive constructors defined in @Core.PictureLanguage@ are no longer overloaded (@cstroke@, @ostroke@, @fill@, @textlabel@, @ellipse@). The respective classes (@Stroke@, @TextLabel@, @Ellipse@) have been removed and the constructors now have monomorphic types. This is because Wumpus-Core now only has one colour type and stroke attributes are now a single type, so polymorphism became less useful (and the simplicity of monomorphic types became more favourable). @ellipse@ is no longer a constructor instead there variants @fillEllipse@ and @strokeEllipse@. . * Added support for /bordered/ closed paths - i.e. paths that are both stroked and filled. These can be efficiently drawn in SVG with a single @path@ element. . * Changed StrokeAttr representation to be a regular data type rather than a list of /deltas/ - i.e. differences to the graphics state. . * Added SVG font attribute /delta optimizations/ to help reduce SVG code size - via the @fontDeltaContext@ function in @Core.Picture@. This functionality was partially inplemented in the last release using the @GSUpdate@ datatype - this datatype it is now called @FontCtx@. . * Some internal work documenting text encoding. . 0.23.0 to 0.30.0: . * Substantial changes - the output machinery has been heavily modified, the intention was to reduce the use of matrix transformations in SVG output. Though this goal has not been achieved, some code-size improvements in the SVG output have been made. . * The code generation monads have been changed - Wumpus no longer uses a writer monad for code generation, but it will keep the Wumpus name. . * Added support for hyperlinks in the SVG output. . * Improved internal pretty printing and added the function @printPicture@ for debugging. . * The @Core.Colour@ module has been simplified to support just one (new) type - RGBi, and the conversion type class @PSColour@ has been eliminated. . * @Core.Picture@ - the type of the @frame@ function has been changed to take a list of Primitives rather than a single Primitive. The function @frameMulti@ which previously provided this functionality has been removed. SVG hyperlinks are now supported for Primitives. . * The default font size has been changed to 14 pt. . * The Path datatype has been renamed PrimPath, likewise Ellipse is now PrimEllispe and Label becomes PrimLabel. . * @Core.Geometry@ now longer defines an affine frame datatype. . * @Core.BoundingBox@ module changed significantly. The corner functions (@boundaryBottomLeft@, etc.) have been removed, along with the plane functions (@leftPlane@, etc.). Some functions have been given more verbose names - @corners@ is now @boundaryCorners@, @within@ is now @withinBoundary@ and @union@ is now @boundaryUnion@. . . . build-type: Simple stability: unstable cabal-version: >= 1.2 extra-source-files: CHANGES, LICENSE, demo/AffineTest01.hs, demo/AffineTest02.hs, demo/AffineTest03.hs, demo/AffineTestBase.hs, demo/DeltaPic.hs, demo/FontMetrics.hs, demo/KernPic.hs, demo/LabelPic.hs, demo/Latin1Pic.hs, demo/MultiPic.hs, demo/Rotated.hs, demo/Scaled.hs, demo/Translated.hs, demo/ZOrderPic.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 >= 0.3 && <= 0.4, time >= 1.1.3 && < 1.2, vector-space >= 0.6 && < 1.0, algebra >= 0.0.0.1 && < 0.1 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.PtSize, Wumpus.Core.TextEncoder, Wumpus.Core.TextLatin1, Wumpus.Core.VersionNumber, Wumpus.Core.WumpusTypes other-modules: Wumpus.Core.FormatCombinators, Wumpus.Core.PageTranslation, Wumpus.Core.PictureInternal, Wumpus.Core.PostScriptDoc, Wumpus.Core.SVGDoc, Wumpus.Core.OneList, Wumpus.Core.TextInternal, Wumpus.Core.Utils extensions: ghc-options: includes: