Struct InstanceProxy

pub struct InstanceProxy { /* private fields */ }

Implementations

impl InstanceProxy

pub fn new(channel: AsyncChannel) -> Self

Create a new Proxy for examples.canvas.clientrequesteddraw/Instance.

pub fn take_event_stream(&self) -> InstanceEventStream

Get a Stream of events from the remote end of the protocol.

Panics

Panics if the event stream was already taken.

pub fn add_lines(&self, lines: &[[Point; 2]]) -> Result<(), Error>

Add multiple lines to the canvas. We are able to reduce protocol chatter and the number of requests needed by batching instead of calling the simpler AddLine(...) one line at a time.

pub fn ready(&self) -> QueryResponseFut<(), DefaultFuchsiaResourceDialect>

Rather than the server randomly performing draws, or trying to guess when to do so, the client must explicitly ask for them. This creates a bit of extra chatter with the additional method invocation, but allows much greater client-side control of when the canvas is “ready” for a view update, thereby eliminating unnecessary draws.

This method also has the benefit of “throttling” the -> OnDrawn(...) event - rather than allowing a potentially unlimited flood of -> OnDrawn(...) calls, we now have the runtime enforced semantic that each -> OnDrawn(...) call must follow a unique Ready() -> () call from the client. An unprompted -> OnDrawn(...) is invalid, and should cause the channel to immediately close.

Trait Implementations

impl Clone for InstanceProxy

fn clone(&self) -> InstanceProxy

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for InstanceProxy

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

Formats the value using the given formatter.

impl InstanceProxyInterface for InstanceProxy

type ReadyResponseFut = QueryResponseFut<()>

fn add_lines(&self, lines: &[[Point; 2]]) -> Result<(), Error>

fn ready(&self) -> Self::ReadyResponseFut

impl Proxy for InstanceProxy

type Protocol = InstanceMarker

The protocol which this Proxy controls.

fn from_channel(inner: AsyncChannel) -> Self

Create a proxy over the given channel.

fn into_channel(self) -> Result<AsyncChannel, Self>

Attempt to convert the proxy back into a channel.

fn as_channel(&self) -> &AsyncChannel

Get a reference to the proxy’s underlying channel.

fn into_client_end(self) -> Result<ClientEnd<Self::Protocol>, Self>

Attempt to convert the proxy back into a client end.

fn is_closed(&self) -> bool

Returns true if the proxy has received the PEER_CLOSED signal.

fn on_closed(&self) -> OnSignals<'_, Unowned<'_, Handle>>

Returns a future that completes when the proxy receives the PEER_CLOSED signal.