Struct RavenSprite

Source

pub struct RavenSprite { /* private fields */ }

Expand description

The signature effect. A stylized raven 🐦 (painted from shapes — no asset dependency, so it never goes missing) that flies in along a bezier arc with ease-out and perches on a target egui::Rect, then idle-bobs.

Motion is deterministic given (start, target, elapsed) — that’s what makes RavenSprite::pos_at unit-testable. The egui-driven loop is:

raven.update(ctx);       // reads ctx.input(i.time), requests a repaint while flying
raven.paint(&painter);   // draws the bird at its current pos

Implementations§

Source §

impl RavenSprite

Source

pub fn new() -> Self

A raven waiting off the top-left, ready to be aimed with [fly_to].

Source

pub fn from(self, start: Pos2) -> Self

Launch point of the flight (defaults to off-screen top-left).

Source

pub fn color(self, color: Color32) -> Self

Raven body colour (override the default near-black, e.g. for hugin_noir you might tint the beak/eye via accent separately).

Source

pub fn scale(self, scale: f32) -> Self

Overall sprite scale (1.0 ≈ a ~14px-tall bird body).

Source

pub fn fly_to(self, target: Rect) -> Self

Aim the raven at target: it will perch centred on the top edge of the rect (like landing on a table row). Resets the flight clock.

Source

pub fn pos_at(&self, elapsed: f32) -> Pos2

Deterministic position at elapsed seconds since launch — the testable core. Eases along the bezier arc with easing::ease_out_back (a confident landing), holds the perch afterwards. Adds a subtle idle bob once perched.

Source

pub fn is_perched(&self) -> bool

True once the flight is over (raven is perched, idle-bobbing).

Source

pub fn pos(&self) -> Pos2

Current sprite position (set by the last update).

Source

pub fn update(&mut self, ctx: &Context)

Drive the animation from the egui clock. Pins the launch time on first call, advances current, and request_repaints while still in flight so the animation keeps ticking. Call once per frame before [paint].

Source

pub fn advance(&mut self, elapsed: f32)

Time-driven core shared by [update] and the headless test: set the current pos + facing + perched flag for elapsed seconds since launch.

Source

pub fn paint(&self, painter: &Painter)

Paint the raven at its current position. A stylized corvid built from a body ellipse-ish blob, swept wings, a wedge tail, a head, and a beak — wings flap while flying and fold once perched.