Struct flo_canvas::DrawingTarget

pub struct DrawingTarget { /* fields omitted */ }

A drawing target sends drawing instructions to a DrawStream

flo_draw provides two structures for sending drawing instructions to other part of the application. DrawingTarget is used when the instructions do not need to be retained: eg, when rendering to a window or to an offscreen target.

See Canvas for a structure that can store drawing instructions as well as send them to a target.

Implementations

impl DrawingTarget

pub fn new() -> (DrawingTarget, DrawStream)

Creates a new drawing target and a stream that can be used to read the instructions sent to it

pub fn write<Drawing: Send + IntoIterator<Item = Draw>>(&self, drawing: Drawing)

Sends some drawing instructions to this target

pub fn draw<FnAction>(&self, action: FnAction) where
    FnAction: Send + FnOnce(&mut Vec<Draw>), 

Provides a way to draw on this target via a graphics context

pub fn receive<DrawStream: Unpin + Stream<Item = Draw>>(
    self,
    actions: DrawStream
) -> impl Future

Sends the results of a future to this target

Trait Implementations

impl Clone for DrawingTarget

A drawing context can be cloned in order to create multiple sources for a single drawing target.

This is particularly useful when combined with layers: multiple threads can draw to different layers without interfering with each other, so it’s possible to design renderers where the rendering instructions have multiple sources (see the mandelbrot example for an example of where this is used)

fn clone(&self) -> DrawingTarget

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Drop for DrawingTarget

fn drop(&mut self)

Executes the destructor for this type.