diagrams-cairo: Cairo backend for diagrams drawing EDSL
A full-featured backend for rendering diagrams using the cairo rendering engine.
This ultimately depends on a C library, via Haskell's FFI, and can be difficult to install on some platforms. If you are just looking for a quick way to visualize diagrams, try the diagrams-svg backend; if you want raster output like PNG, try the diagrams-rasterific backend; if you want to embed diagrams in LaTeX documents, try diagrams-pgf.
Diagrams.Backend.Cairo.CmdLine - if you're just getting started with diagrams, begin here.
Diagrams.Backend.Cairo - look at this next. The general API for the cairo backend.
Diagrams.Backend.Cairo.Internal - the implementation guts of the cairo backend. Users should normally not need to import this module.
Diagrams.Backend.Cairo.List - render diagrams to two-dimensional lists of colors (i.e. pixels).
Diagrams.Backend.Cairo.Ptr - render diagrams to buffers in memory.
[Skip to Readme]
Modules
[Index]
Downloads
- diagrams-cairo-1.3.1.2.tar.gz [browse] (Cabal source package)
- Package description (as included in the package)
Maintainer's Corner
For package maintainers and hackage trustees
Candidates
- No Candidates
| Versions [RSS] | 0.1, 0.1.1, 0.1.2, 0.2, 0.3, 0.4, 0.5, 0.5.0.1, 0.5.0.2, 0.6, 0.7, 1.0, 1.0.1, 1.0.1.1, 1.0.1.2, 1.1, 1.1.0.1, 1.1.0.2, 1.2, 1.2.0.1, 1.2.0.2, 1.2.0.3, 1.2.0.4, 1.2.0.5, 1.2.0.6, 1.2.0.7, 1.3, 1.3.0.1, 1.3.0.2, 1.3.0.3, 1.3.0.4, 1.3.0.5, 1.3.0.6, 1.3.1, 1.3.1.1, 1.3.1.2, 1.4, 1.4.1, 1.4.1.1, 1.4.2, 1.4.2.1, 1.4.3 |
|---|---|
| Change log | CHANGELOG.md |
| Dependencies | array (>=0.4.0 && <0.6), base (>=4.2 && <4.10), bytestring (>=0.9 && <0.11), cairo (>=0.12.4 && <0.14), colour, containers (>=0.3 && <0.6), data-default-class (>=0.0.1 && <0.2), diagrams-core (>=1.3 && <1.4), diagrams-lib (>=1.3 && <1.4), filepath, ghc-prim, hashable (>=1.1 && <1.3), JuicyPixels (>=3.1.3.2 && <3.3), lens (>=3.8 && <4.15), mtl (>=2.0 && <2.3), optparse-applicative (>=0.13 && <0.14), pango (>=0.12.5 && <0.14), split (>=0.1.2 && <0.3), statestack (>=0.2 && <0.3), transformers (>=0.3 && <0.6), unix (>=2.4 && <2.8), vector (>=0.10.0 && <0.12) [details] |
| Tested with | ghc ==7.6.3, ghc ==7.8.4, ghc ==7.10.2, ghc ==8.0.1 |
| License | BSD-3-Clause |
| Author | Brent Yorgey |
| Maintainer | diagrams-discuss@googlegroups.com |
| Category | Graphics |
| Home page | http://projects.haskell.org/diagrams |
| Bug tracker | http://github.com/diagrams/diagrams-cairo/issues |
| Source repo | head: git clone http://github.com/diagrams/diagrams-cairo.git |
| Uploaded | by BrentYorgey at 2016-08-23T01:45:51Z |
| Distributions | Debian:1.4.1.1, LTSHaskell:1.4.2.1, NixOS:1.4.2.1, Stackage:1.4.3 |
| Reverse Dependencies | 25 direct, 21 indirect [details] |
| Downloads | 40852 total (50 in the last 30 days) |
| Rating | (no votes yet) [estimated by Bayesian average] |
| Your Rating | |
| Status | Docs available [build log] Last success reported on 2016-08-23 [all 1 reports] |
Readme for diagrams-cairo-1.3.1.2
[back to package description]
diagrams-cairo is a rendering backend for diagrams, a powerful, flexible, declarative domain-specific language for creating vector graphics, using the Haskell programming language.
diagrams-cairo is implemented using the cairo rendering engine and is a fully-featured, officially supported backend for diagrams.
Installation
cabal update && cabal install gtk2hs-buildtools diagrams-cairo
Basic usage
A simple example that uses diagrams-cairo to draw a blue circle:
import Diagrams.Prelude
import Diagrams.Backend.Cairo.CmdLine
d = circle 1 # fc blue
main = mainWith (pad 1.1 d)
Save this to file named Circle.hs and compile it:
ghc --make Circle.hs
This will generate an executable which, when run, outputs a blue
circle to some file. Run the executable with the --help option to
find out more about how to call it.
$ ./Circle --help
./Circle
Usage: ./Circle [-w|--width WIDTH] [-h|--height HEIGHT] [-o|--output OUTPUT]
[--loop] [-s|--src ARG] [-i|--interval INTERVAL]
Command-line diagram generation.
Available options:
-?,--help Show this help text
-w,--width WIDTH Desired WIDTH of the output image
-h,--height HEIGHT Desired HEIGHT of the output image
-o,--output OUTPUT OUTPUT file
-l,--loop Run in a self-recompiling loop
-s,--src ARG Source file to watch
-i,--interval INTERVAL When running in a loop, check for changes every INTERVAL seconds.
ommand-line diagram generation.
The output type will be automatically determined from the file extension. Currently PNG, PDF, PS, and SVG are supported.
$ ./Circle -o circle.png -w 400
The command above generates a PNG file with a width of 400px.
Advanced usage
Instead of just creating a standalone executable, the cairo backend can also be called from within a larger program. For more information, see the Diagram.Backend.Cairo module.