This repo holds an API for 2D graphics drawing.
The motivation for this crate is set forth in this blog post. Ideally it will become a layer to help druid become cross-platform.
This repo is structured as a core API crate, "piet" and a separate crate for each back-end. One motivation for this structure is that additional back-ends can be written without coupling to the main crate, and clients can opt in to the back-ends they need. In addition, it's possible use multiple back-ends, which will likely be useful for testing.
A companion for Bézier path representation and geometry is kurbo.
For cross-platform use, the piet-common
crate reexports the most
appropriate implementation for the current target.
The piet-cairo
crate depends on the cairo library, found at
https://www.cairographics.org/download/. A simple test of the cairo
backend is to run cargo run --example test-picture 0
, which should
produce an image file called cairo-test-0.png
.
The piet-coregraphics
crate works on macOS only. A simple test of the coregraphics
backend is to run cargo run --example test-picture 0
, which should
produce an image file called coregraphics-test-0.png
.
The piet-direct2d
create works on Windows only. A simple test of the direct2d
backend is to run cargo run --example test-picture 0
, which should
produce an image called d2d-test-0.png
.
Since the project is in its infant stages, there's not currently a set roadmap. For a good idea of what the library will eventually be capable of see this list of requirements to be a backend 2D graphics library for the SVG rendering library resvg.
Contributions are welcome! It's in early stages, so there are lots of opportunities to fill things out.
You can find other collaborators at xi.zulipchat.com under the #druid stream.
Piet's interface is largely inspired by the Skia Graphics Library as well as the C++ 2D graphics api proposal although piet aims to be much more lightweight and modular.
The library is of course named after Piet Mondrian. It's abstract and hopefully will be used for drawing lots of rectangles.