motion-content 0.2.0

Backend-independent images, text, vectors, particles and artwork
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

//! Composable brush presets that configure ordinary brush stroke builders.

use super::super::{BrushStroke, BrushStrokeBuilder, Ink};
use super::NibMode;
use crate::vector::ink::Paper;
use motion_core::{Color, NodeModifiers, Paint, Path2D, ValidationError};

/// Composable brush geometry/material presets; all settings remain overridable on the returned
/// builder.
#[derive(Clone, Copy, Debug)]
pub enum BrushPreset {
    /// Fine rounded ink pen.
    Pen,
    /// Flat self-darkening marker.
    Marker,
    /// Tangent-following bristle brush.
    Brush,
    /// Rough granular chalk.
    Chalk,
    /// Rough paper-responsive charcoal.
    Charcoal,
    /// Fine granular pencil.
    Pencil,
    /// Feathered edge-pooling watercolor.
    Watercolor,
    /// Fixed wide nib and tapered pressure.
    Calligraphy,
    /// Translucent marker; `node` applies Multiply compositing.
    Highlighter,
    /// Glow pen; `node` adds the existing linear-light Bloom filter.
    Neon,
}

impl BrushPreset {
    /// Returns a normal [`BrushStrokeBuilder`] with deterministic preset parameters.
    pub fn stroke(self, path: Path2D, width: f64, paint: impl Into<Paint>) -> BrushStrokeBuilder {
        let stroke = BrushStroke::builder(path, width, paint);
        match self {
            Self::Pen => stroke.ink(Ink::new(0).edge_roughness(0.1)),
            Self::Marker | Self::Highlighter => stroke
                .nib(0.3, 0.4)
                .nib_mode(NibMode::Fixed(0.4))
                .ink(Ink::new(0).build_up(0.3)),
            Self::Brush => stroke
                .nib(0.5, 0.0)
                .nib_mode(NibMode::FollowPath(0.0))
                .pressure(0.2, 1.0, 0.1)
                .bristles(5, width, 0.2, 0)
                .sample_limit(64)
                .speed_response(0.001)
                .ink(Ink::new(0).dryness(0.25).fibers(0.8).bleed(1.0)),
            Self::Chalk | Self::Charcoal => {
                stroke.ink(Ink::new(0).granulation(0.8).edge_roughness(1.0).paper(
                    Paper::Procedural {
                        seed: 1,
                        strength: 0.7,
                        scale: 1.0,
                    },
                ))
            }
            Self::Pencil => stroke.ink(Ink::new(0).granulation(0.4).paper(Paper::Procedural {
                seed: 1,
                strength: 0.5,
                scale: 0.5,
            })),
            Self::Watercolor => stroke.ink(
                Ink::new(0)
                    .bleed(4.0)
                    .edge_pooling(0.7, 2.0)
                    .granulation(0.2)
                    .edge_darkening(0.3),
            ),
            Self::Calligraphy => stroke
                .nib(0.2, 0.7)
                .nib_mode(NibMode::Fixed(0.7))
                .pressure(0.3, 1.2, 0.1)
                .ink(Ink::new(0).dryness(0.2)),
            Self::Neon => stroke,
        }
    }

    /// Composes preset-specific opacity/blending/lighting after constructing its stroke.
    pub fn node(
        self,
        path: Path2D,
        width: f64,
        paint: impl Into<Paint>,
    ) -> Result<motion_core::Node, ValidationError> {
        let node = motion_core::Node::from(self.stroke(path, width, paint).build()?);
        Ok(match self {
            Self::Highlighter => node
                .opacity(0.45)
                .blend_mode(motion_core::BlendMode::Multiply),
            Self::Marker => node.blend_mode(motion_core::BlendMode::Multiply),
            Self::Watercolor => node
                .opacity(0.6)
                .blend_mode(motion_core::BlendMode::Multiply),
            Self::Neon => node.filter(motion_core::Filter::Bloom {
                threshold: 0.1,
                knee: 0.1,
                radius: 3.0,
                levels: 3,
                falloff: 0.5,
                intensity: 1.0,
                tint: Color::WHITE,
            }),
            _ => node,
        })
    }
}