thorvg 0.5.0

Safe Rust bindings to the ThorVG vector graphics library
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144

//! Demonstrates scene-level effects: drop shadow, fill, tint, and tritone.
//!
//! Run with: `cargo run --example scene_effects`
//! Output:   `scene_effects.png`

#![allow(clippy::cast_precision_loss)]

mod common;

use thorvg::{
    BlurBorder, BlurDirection, Circle, ColorSpace, DropShadow, EngineOption, GaussianBlur, Paint,
    Rect, Rgb, Rgba, Scene, Thorvg, Tint, Tritone,
};

fn make_shape_group(engine: &Thorvg, x: f32, y: f32) -> Scene<'_> {
    let mut scene = engine.scene().unwrap();

    let mut circle = engine.shape().unwrap();
    circle
        .append_circle(Circle::new(x + 60.0, y + 60.0, 40.0))
        .unwrap();
    circle.set_fill_color(Rgba::new(0, 180, 80, 255)).unwrap();
    scene.add(circle).unwrap();

    let mut rect = engine.shape().unwrap();
    rect.append_rect(Rect::new(x + 30.0, y + 30.0, 80.0, 60.0).corner_radius(8.0))
    .unwrap();
    rect.set_fill_color(Rgba::new(80, 80, 220, 200)).unwrap();
    scene.add(rect).unwrap();

    scene
}

fn main() {
    let engine = Thorvg::init(0).unwrap();
    let (w, h) = (800u32, 500u32);
    let mut buffer = vec![0u32; (w * h) as usize];
    let mut canvas = engine.sw_canvas(EngineOption::Default).unwrap();
    unsafe { canvas.set_target(&mut buffer, w, w, h, ColorSpace::ABGR8888) }.unwrap();

    // Background
    let mut bg = engine.shape().unwrap();
    bg.append_rect(Rect::new(0.0, 0.0, w as f32, h as f32))
    .unwrap();
    bg.set_fill_color(Rgba::new(245, 245, 245, 255)).unwrap();
    canvas.add(bg).unwrap();

    // ── No effect (reference) ──────────────────────────────────────
    let scene1 = make_shape_group(&engine, 30.0, 30.0);
    canvas.add(scene1).unwrap();

    // ── Gaussian blur ──────────────────────────────────────────────
    let mut scene2 = make_shape_group(&engine, 220.0, 30.0);
    scene2
        // Builder form: the Both / Duplicate defaults are left implicit.
        .add_gaussian_blur_effect(GaussianBlur::new().sigma(5.0).quality(80))
        .unwrap();
    canvas.add(scene2).unwrap();

    // ── Drop shadow ────────────────────────────────────────────────
    let mut scene3 = make_shape_group(&engine, 410.0, 30.0);
    scene3
        .add_drop_shadow_effect(DropShadow {
            color: Rgba::new(0, 0, 0, 150),
            angle: 135.0,
            distance: 8.0,
            sigma: 4.0,
            quality: 80,
        })
        .unwrap();
    canvas.add(scene3).unwrap();

    // ── Fill effect (recolor) ──────────────────────────────────────
    let mut scene4 = make_shape_group(&engine, 600.0, 30.0);
    scene4.add_fill_effect(Rgba::new(255, 60, 60, 200)).unwrap();
    canvas.add(scene4).unwrap();

    // ── Tint effect ────────────────────────────────────────────────
    let mut scene5 = make_shape_group(&engine, 30.0, 250.0);
    // Builder form to demonstrate the chainable API.
    scene5
        .add_tint_effect(
            Tint::new()
                .black(Rgb::new(20, 0, 40))
                .white(Rgb::new(255, 200, 180))
                .intensity(80.0),
        )
        .unwrap();
    canvas.add(scene5).unwrap();

    // ── Tritone effect ─────────────────────────────────────────────
    let mut scene6 = make_shape_group(&engine, 220.0, 250.0);
    scene6
        .add_tritone_effect(Tritone {
            shadow: Rgb::new(10, 10, 40),
            midtone: Rgb::new(200, 100, 50),
            highlight: Rgb::new(255, 240, 200),
            blend: 180,
        })
        .unwrap();
    canvas.add(scene6).unwrap();

    // ── Blur + drop shadow (stacked) ───────────────────────────────
    let mut scene7 = make_shape_group(&engine, 410.0, 250.0);
    scene7
        .add_gaussian_blur_effect(GaussianBlur {
            sigma: 2.0,
            direction: BlurDirection::Both,
            border: BlurBorder::Duplicate,
            quality: 60,
        })
        .unwrap();
    // Same effect, expressed via the chainable builder — fields
    // not mentioned inherit `DropShadow::new()`'s sensible defaults.
    scene7
        .add_drop_shadow_effect(
            DropShadow::new()
                .color(Rgba::new(0, 0, 0, 100))
                .angle(45.0)
                .distance(12.0)
                .sigma(6.0)
                .quality(80),
        )
        .unwrap();
    canvas.add(scene7).unwrap();

    // ── Scene with transform + blur ────────────────────────────────
    let mut scene8 = make_shape_group(&engine, 600.0, 250.0);
    scene8.scale(0.8).unwrap();
    scene8.translate(720.0, 310.0).unwrap();
    scene8
        .add_gaussian_blur_effect(GaussianBlur {
            sigma: 3.0,
            direction: BlurDirection::Horizontal,
            border: BlurBorder::Duplicate,
            quality: 70,
        })
        .unwrap();
    canvas.add(scene8).unwrap();

    canvas.draw(true).unwrap();
    canvas.sync().unwrap();
    common::save_png("scene_effects.png", &buffer, w, h);
}