Struct SongFace 

pub struct SongFace { /* private fields */ }

A song on screen, cross-fading to the next: see the module docs.

Implementations

impl SongFace

pub fn new() -> SongFace

Showing nothing yet.

pub fn showing(song: &Song) -> SongFace

Showing song at rest: for a surface that paints from scratch each time and keeps no motion of its own (the lock screen, the desk).

pub fn show( &mut self, song: &Song, motion: EffectiveMotion, now: Instant, ) -> bool

Show song from the frame at now; whether it changed what is shown. The first song a surface shows is there at once; a later change cross-fades, unless a key or an action made it.

pub fn stand_art(&mut self, art: TransportArt)

Take art as the shown song’s art, in place: a cover’s bytes arrived and the song it belongs to shows them at once, never cross-fading a cover into itself.

pub fn song(&self) -> &Song

The song shown (the newest one, while the old still fades).

pub fn is_moving(&self, now: Instant) -> bool

pub fn settles_at(&self) -> Option<Instant>

pub fn paint_art( &self, ctx: &mut PaintCtx<'_>, art: Rect, radius: f64, now: Instant, )

Paint the cover in art with corners of radius: the picture cover-fitted, or the placeholder seeded with the song’s art name.

pub fn paint_lines( &self, ctx: &mut PaintCtx<'_>, rect: Rect, styles: Option<(&TextStyle, &TextStyle)>, now: Instant, )

Paint the lines in rect, centred vertically and elided to its width, in the theme’s song type or in styles (title, caption) for a surface that scales its type itself.

pub fn spoken(&self) -> String

What a screen reader says for the song shown.

Trait Implementations

impl Clone for SongFace

fn clone(&self) -> SongFace

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SongFace

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for SongFace

fn default() -> SongFace

Returns the “default value” for a type.