2020-11-21 05:09:52 +00:00
|
|
|
# Pixie - A full-featured 2D graphics library for Nim
|
2020-11-20 02:41:32 +00:00
|
|
|
|
2020-11-21 05:09:52 +00:00
|
|
|
⚠️ WARNING: This library is still in heavy development. ⚠️
|
2020-11-20 17:13:53 +00:00
|
|
|
|
2020-11-27 21:51:40 +00:00
|
|
|
Pixie is a 2D graphics library similar to [Cairo](https://www.cairographics.org/) and [Skia](https://skia.org) written (almost) entirely in Nim.
|
2020-11-20 17:13:53 +00:00
|
|
|
|
2020-11-21 05:09:52 +00:00
|
|
|
This library is being actively developed and is not yet ready for use. Since you've managed to stumble onto it, give it a star and check back soon!
|
|
|
|
|
2021-02-14 04:14:16 +00:00
|
|
|
`nimble install pixie`
|
|
|
|
|
|
|
|
Features:
|
|
|
|
* Drawing paths, shapes and curves, with even-odd and non-zero windings.
|
|
|
|
* Strokes with joins and caps.
|
|
|
|
* Shadows, glows and blurs.
|
|
|
|
* Complex masking: Subtract, Intersect, Exclude.
|
|
|
|
* Complex blends: Darken, Multiply, Color Dodge, Hue, Luminosity... etc.
|
|
|
|
* Pixel perfect AA quality.
|
|
|
|
* Supported file formats: PNG, BMP, JPG, SVG + more in development.
|
|
|
|
|
2020-11-21 05:09:52 +00:00
|
|
|
## Testing
|
|
|
|
|
|
|
|
`nimble test`
|
2020-12-01 17:49:41 +00:00
|
|
|
|
|
|
|
## Examples
|
|
|
|
|
2021-02-14 04:45:27 +00:00
|
|
|
### Square
|
|
|
|
[examples/square.nim](examples/square.nim)
|
2020-12-04 16:32:03 +00:00
|
|
|
```nim
|
2021-02-18 19:55:26 +00:00
|
|
|
let
|
|
|
|
pos = vec2(50, 50)
|
|
|
|
wh = vec2(100, 100)
|
2021-01-29 20:17:24 +00:00
|
|
|
|
2021-02-19 18:04:27 +00:00
|
|
|
image.fillRect(rect(pos, wh), rgba(255, 0, 0, 255))
|
2020-12-04 16:32:03 +00:00
|
|
|
```
|
2021-02-14 04:45:27 +00:00
|
|
|
![example output](examples/square.png)
|
2020-12-04 16:32:03 +00:00
|
|
|
|
2021-02-18 18:14:55 +00:00
|
|
|
### Line
|
|
|
|
[examples/line.nim](examples/line.nim)
|
|
|
|
```nim
|
2021-02-18 19:55:26 +00:00
|
|
|
let
|
|
|
|
start = vec2(25, 25)
|
|
|
|
stop = vec2(175, 175)
|
|
|
|
color = parseHtmlColor("#FF5C00").rgba
|
|
|
|
|
2021-02-19 18:04:27 +00:00
|
|
|
image.strokeSegment(segment(start, stop), color, strokeWidth = 10)
|
2021-02-18 18:14:55 +00:00
|
|
|
```
|
|
|
|
![example output](examples/line.png)
|
|
|
|
|
2021-02-18 22:30:47 +00:00
|
|
|
### Rounded rectangle
|
|
|
|
[examples/rounded_rectangle.nim](examples/rounded_rectangle.nim)
|
|
|
|
```nim
|
|
|
|
let
|
|
|
|
pos = vec2(50, 50)
|
|
|
|
wh = vec2(100, 100)
|
|
|
|
r = 25.0
|
|
|
|
|
2021-02-19 18:04:27 +00:00
|
|
|
image.fillRoundedRect(rect(pos, wh), r, rgba(0, 255, 0, 255))
|
2021-02-18 22:30:47 +00:00
|
|
|
```
|
|
|
|
![example output](examples/rounded_rectangle.png)
|
|
|
|
|
2021-02-14 04:45:27 +00:00
|
|
|
### Heart
|
|
|
|
[examples/heart.nim](examples/heart.nim)
|
|
|
|
```nim
|
|
|
|
image.fillPath(
|
|
|
|
"""
|
|
|
|
M 20 60
|
|
|
|
A 40 40 90 0 1 100 60
|
|
|
|
A 40 40 90 0 1 180 60
|
|
|
|
Q 180 120 100 180
|
|
|
|
Q 20 120 20 60
|
|
|
|
z
|
|
|
|
""",
|
|
|
|
parseHtmlColor("#FC427B").rgba
|
|
|
|
)
|
|
|
|
```
|
|
|
|
![example output](examples/heart.png)
|
|
|
|
|
|
|
|
### Shadow
|
|
|
|
[examples/shadow.nim](examples/shadow.nim)
|
2020-12-01 17:49:41 +00:00
|
|
|
```nim
|
2021-02-18 22:40:35 +00:00
|
|
|
let polygonImage = newImage(200, 200)
|
2021-02-19 18:04:27 +00:00
|
|
|
polygonImage.fillPolygon(
|
2021-02-18 22:40:35 +00:00
|
|
|
vec2(100, 100),
|
|
|
|
70,
|
|
|
|
sides = 8,
|
|
|
|
rgba(255, 255, 255, 255)
|
|
|
|
)
|
2021-02-14 04:45:27 +00:00
|
|
|
|
2021-02-19 18:04:27 +00:00
|
|
|
let shadow = polygonImage.shadow(
|
2021-02-14 04:45:27 +00:00
|
|
|
offset = vec2(2, 2),
|
|
|
|
spread = 2,
|
|
|
|
blur = 10,
|
|
|
|
color = rgba(0, 0, 0, 200)
|
2021-02-19 18:04:27 +00:00
|
|
|
)
|
|
|
|
|
|
|
|
image.draw(shadow)
|
2021-02-18 22:40:35 +00:00
|
|
|
image.draw(polygonImage)
|
2020-12-01 17:49:41 +00:00
|
|
|
```
|
2021-02-14 04:45:27 +00:00
|
|
|
![example output](examples/shadow.png)
|
|
|
|
|
|
|
|
### Blur
|
|
|
|
[examples/blur.nim](examples/blur.nim)
|
|
|
|
```nim
|
|
|
|
let mask = newMask(200, 200)
|
2021-02-19 18:04:27 +00:00
|
|
|
mask.fillPolygon(vec2(100, 100), 70, sides = 6)
|
2021-02-14 04:45:27 +00:00
|
|
|
|
|
|
|
blur.blur(20)
|
|
|
|
blur.draw(mask, blendMode = bmMask)
|
|
|
|
|
|
|
|
image.draw(trees)
|
|
|
|
image.draw(blur)
|
|
|
|
```
|
|
|
|
![example output](examples/blur.png)
|
2020-12-04 17:25:00 +00:00
|
|
|
|
2020-12-04 17:41:28 +00:00
|
|
|
### Tiger
|
|
|
|
[examples/tiger.nim](examples/tiger.nim)
|
2020-12-04 17:25:00 +00:00
|
|
|
```nim
|
2021-01-29 20:17:24 +00:00
|
|
|
let tiger = readImage("examples/data/tiger.svg")
|
|
|
|
|
2020-12-04 17:25:00 +00:00
|
|
|
image.draw(
|
|
|
|
tiger,
|
|
|
|
translate(vec2(100, 100)) *
|
|
|
|
scale(vec2(0.2, 0.2)) *
|
|
|
|
translate(vec2(-450, -450))
|
|
|
|
)
|
|
|
|
```
|
|
|
|
![example output](examples/tiger.png)
|