diagrams-cairo
Cairo backend for diagrams drawing EDSL
http://projects.haskell.org/diagrams
| Version on this page: | 1.2.0.5 |
| LTS Haskell 24.17: | 1.5@rev:1 |
| Stackage Nightly 2025-10-26: | 1.5@rev:1 |
| Latest on Hackage: | 1.5@rev:1 |
diagrams-cairo-1.2.0.5@sha256:7dca335f2e6ee2488194fb6c0aa3db6dd21cb5d3da3c04e974a6ddaaa010fd0b,3496Module documentation for 1.2.0.5
- Diagrams
- Diagrams.Backend
- Diagrams.Backend.Cairo
- Diagrams.Backend.Cairo.CmdLine
- Diagrams.Backend.Cairo.Internal
- Diagrams.Backend.Cairo.List
- Diagrams.Backend.Cairo.Ptr
- Diagrams.Backend.Cairo.Text
- Diagrams.Backend.Cairo
- Diagrams.Backend
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.