//! Distort & Transform effects. use serde_json::Value; use vectorcraft_geom::kurbo::ParamCurveArclen; use vectorcraft_geom::{Affine, Anchor, ParamCurve, PathData, Point, Rect, SubPath, Vec2}; use crate::util::*; fn diag(b: Rect) -> f64 { b.width().hypot(b.height()).max(1e-6) } /// Free Distort: bilinear map of the bounding box onto four new corners (unit box coordinates). pub fn free_distort(path: &PathData, b: Rect, p: &Value) -> PathData { let mut c = [Point::new(0.0, 0.0), Point::new(1.0, 0.0), Point::new(1.0, 1.0), Point::new(0.0, 1.0)]; if let Some(arr) = p.get("corners").and_then(Value::as_array) { for (i, v) in arr.iter().take(4).enumerate() { if let Some(a) = v.as_array() && let (Some(x), Some(y)) = (a.first().and_then(Value::as_f64), a.get(1).and_then(Value::as_f64)) && x.is_finite() && y.is_finite() { c[i] = Point::new(x, y); } } } let (w, h) = (b.width().max(1e-9), b.height().max(1e-9)); let to_doc = |q: Point| Point::new(b.x0 + q.x * w, b.y0 + q.y * h); let c = c.map(to_doc); let f = |q: Point| { let u = (q.x - b.x0) / w; let v = (q.y - b.y0) / h; let top = c[0].lerp(c[1], u); let bot = c[3].lerp(c[2], u); top.lerp(bot, v) }; map_nonlinear(path, diag(b) / 16.0, f) } /// Pucker & Bloat: anchors move toward (bloat) or away from (pucker) the centre, handles the /// opposite way. pub fn pucker_bloat(path: &PathData, b: Rect, amount: f64) -> PathData { let a = amount.clamp(-200.0, 200.0) / 100.0; if a == 0.0 { return path.clone(); } let c = b.center(); // Lines have retracted handles: give them handles at 1/3 before distorting so they bulge. { let mut res = path.clone(); for (si, sp) in res.subpaths.iter_mut().enumerate() { let n = sp.anchors.len(); let segs = sp.segment_count(); let orig = &path.subpaths[si]; for i in 0..segs { let cub = seg_cubic(orig, i); let j = (i + 1) % n; sp.anchors[i].h_out = cub.p1; sp.anchors[j].h_in = cub.p2; } for an in &mut sp.anchors { let p = an.p; *an = Anchor::with_handles(p.lerp(c, a * 0.5), an.h_in.lerp(c, -a * 0.5), an.h_out.lerp(c, -a * 0.5)); } } res } } /// Roughen: resample at `detail` points per inch and jitter each point by up to `size`. pub fn roughen(path: &PathData, b: Rect, p: &Value) -> PathData { let size = num(p, "size", 5.0).clamp(0.0, 1e4); let amp = if flag(p, "relative", true) { size / 100.0 * mean_size(b) } else { size }; let detail = num(p, "detail", 10.0).clamp(0.0, 100.0); let spacing = if detail > 0.0 { 72.0 / detail } else { f64::INFINITY }; let smooth = smooth_points(p); let seed = seed(p); let mut subs = vec![]; for (si, sp) in path.subpaths.iter().enumerate() { let mut pts = vec![]; for i in 0..sp.segment_count() { let c = sp.segment(i); let len = vectorcraft_geom::kurbo::ParamCurveArclen::arclen(&c, 0.1); let k = if spacing.is_finite() { ((len / spacing).ceil() as usize).clamp(1, 2000) } else { 1 }; for j in 0..k { pts.push(c.eval(j as f64 / k as f64)); } } if !sp.closed && let Some(l) = sp.anchors.last() { pts.push(l.p); } if pts.is_empty() { pts.extend(sp.anchors.iter().map(|a| a.p)); } for (k, q) in pts.iter_mut().enumerate() { q.x += amp * noise(seed, si as u64, k as u64, 1); q.y += amp * noise(seed, si as u64, k as u64, 2); } subs.push(if smooth { catmull_rom(&pts, sp.closed, 1.0) } else { SubPath::polyline(&pts, sp.closed) }); } PathData::new(subs) } /// Largest scale (%) and move (pt) the Transform effect takes. const MAX_SCALE: f64 = 100_000.0; const MAX_MOVE: f64 = 1.0e7; /// The Transform effect's copies stop before one reaches further than this (pt) from the origin. const MAX_REACH: f64 = 1.0e9; /// Transform effect: scale, rotate and reflect about reference point `reference` of the bounds /// (the 9-point grid, 4 = centre), then move; `copies` more times, each from the last. With /// `random`, each scale goes a random share of the way from 100 % to its value and each move and /// the angle a share of theirs, drawn from `seed` (the object's), so an object keeps its result /// on every redraw while each object varies its own way. pub fn transform(path: &PathData, b: Rect, p: &Value, seed: u64) -> PathData { let random = flag(p, "random", false); // The share (0..1) of value `k` applied. let share = |k: u64| if random { (noise(seed, k, 0, 0) + 1.0) / 2.0 } else { 1.0 }; let scale = |key: &str, k: u64| 1.0 + (num(p, key, 100.0).clamp(-MAX_SCALE, MAX_SCALE) / 100.0 - 1.0) * share(k); let moved = |key: &str, k: u64| num(p, key, 0.0).clamp(-MAX_MOVE, MAX_MOVE) * share(k); let reflect = |key: &str| if flag(p, key, false) { -1.0 } else { 1.0 }; let o = vectorcraft_geom::reference_point(b, num(p, "reference", 4.0).clamp(0.0, 8.0) as usize).to_vec2(); // Reflect X flips the x coordinates (left to right), Reflect Y the y coordinates. let m = Affine::translate(Vec2::new(moved("moveH", 2), moved("moveV", 3)) + o) * Affine::rotate(-(num(p, "rotate", 0.0) * share(4)).to_radians()) * Affine::scale_non_uniform(scale("scaleH", 0) * reflect("reflectX"), scale("scaleV", 1) * reflect("reflectY")) * Affine::translate(-o); let copies = num(p, "copies", 0.0).clamp(0.0, 1000.0) as usize; if copies == 0 { return path.transformed(m); } let within = |r: Rect| [r.x0, r.y0, r.x1, r.y1].iter().all(|v| v.abs() <= MAX_REACH); let mut out = path.clone(); let mut cur = path.clone(); for _ in 0..copies { cur = cur.transformed(m); if !cur.bounds().is_some_and(within) { break; } out.subpaths.extend(cur.subpaths.iter().cloned()); } out } /// Tweak: random displacement of anchors and/or control points. pub fn tweak(path: &PathData, b: Rect, p: &Value) -> PathData { let rel = flag(p, "relative", true); let h = num(p, "h", 10.0); let v = num(p, "v", 10.0); let (ah, av) = if rel { (h / 100.0 * b.width().abs(), v / 100.0 * b.height().abs()) } else { (h, v) }; let (anchors, ins, outs) = (flag(p, "anchors", true), flag(p, "in", true), flag(p, "out", true)); let seed = seed(p); let mut out = path.clone(); for (si, sp) in out.subpaths.iter_mut().enumerate() { for (ai, an) in sp.anchors.iter_mut().enumerate() { let key = ((si as u64) << 32) | ai as u64; let d = |c: u64| Vec2::new(ah * noise(seed, key, c, 1), av * noise(seed, key, c, 2)); let (mut pp, mut hi, mut ho) = (an.p, an.h_in, an.h_out); if anchors { let dp = d(0); pp += dp; hi += dp; ho += dp; } if ins { hi += d(1); } if outs { ho += d(2); } *an = Anchor::with_handles(pp, hi, ho); } } out } /// Twist: rotation that is strongest at the centre and fades to zero at the bounding circle. pub fn twist(path: &PathData, b: Rect, angle: f64) -> PathData { let ang = angle.clamp(-3600.0, 3600.0).to_radians(); if ang == 0.0 { return path.clone(); } let c = b.center(); let r = diag(b) / 2.0; let f = move |q: Point| { let d = q - c; let t = (1.0 - d.hypot() / r).max(0.0); let a = -ang * t; let (s, co) = a.sin_cos(); c + Vec2::new(d.x * co - d.y * s, d.x * s + d.y * co) }; let pieces = (r / 8.0).min(r / (1.0 + ang.abs() * 2.0)); map_nonlinear(path, pieces, f) } const ZIGZAG_ARCLEN_ACCURACY: f64 = 1e-4; /// Zig Zag: `ridges` extra points per segment, evenly spaced along its length and alternately /// displaced along the normal. pub fn zig_zag(path: &PathData, b: Rect, p: &Value) -> PathData { let size = num(p, "size", 10.0).clamp(-1e4, 1e4); let amp = if flag(p, "relative", false) { size / 100.0 * mean_size(b) } else { size }; let ridges = num(p, "ridges", 4.0).clamp(0.0, 100.0) as usize; let smooth = smooth_points(p); let mut subs = vec![]; for sp in &path.subpaths { let segs = sp.segment_count(); let mut pts = vec![]; let mut k = 0usize; for i in 0..segs { let c = sp.segment(i); // Ridges are spaced by length, not by `t`: a line's retracted handles bunch `t` up // near the anchors, and so does any uneven curve. let len = c.arclen(ZIGZAG_ARCLEN_ACCURACY); for j in 0..=ridges { let s = j as f64 / (ridges + 1) as f64; let t = if j > 0 && len > 1e-9 { c.inv_arclen(s * len, ZIGZAG_ARCLEN_ACCURACY).clamp(0.0, 1.0) } else { s }; let nrm = if j == 0 { // Average the normals of the segments meeting at the anchor. let prev = if i > 0 { Some(sp.segment(i - 1)) } else if sp.closed { Some(sp.segment(segs - 1)) } else { None }; let n1 = normal_at(&c, 0.0); match prev { Some(pc) => { let s = n1 + normal_at(&pc, 1.0); if s.hypot() > 1e-9 { s / s.hypot() } else { n1 } } None => n1, } } else { normal_at(&c, t) }; let sign = if k.is_multiple_of(2) { 1.0 } else { -1.0 }; pts.push(c.eval(t) + nrm * (amp * sign)); k += 1; } } if !sp.closed { if segs > 0 { let c = sp.segment(segs - 1); let sign = if k.is_multiple_of(2) { 1.0 } else { -1.0 }; pts.push(c.p3 + normal_at(&c, 1.0) * (amp * sign)); } else { pts.extend(sp.anchors.iter().map(|a| a.p)); } } subs.push(if smooth { catmull_rom(&pts, sp.closed, 1.0) } else { SubPath::polyline(&pts, sp.closed) }); } PathData::new(subs) }