pub struct ImagePipe2Proxy { /* private fields */ }

Implementations§

source§

impl ImagePipe2Proxy

source

pub fn new(channel: AsyncChannel) -> Self

Create a new Proxy for fuchsia.images/ImagePipe2.

source

pub fn take_event_stream(&self) -> ImagePipe2EventStream

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

§Panics

Panics if the event stream was already taken.

source

pub fn add_buffer_collection( &self, buffer_collection_id: u32, buffer_collection_token: ClientEnd<BufferCollectionTokenMarker> ) -> Result<(), Error>

Adds a BufferCollection resource to the image pipe.

The producer is expected to set constraints on this resource for images added via AddImage(). The consumer can set its constraints on buffer_collection_token before or after. Note that the buffers won’t be allocated until all BufferCollectionToken instances are used to set constraints, on both the producer and consumer side. See collection.fidl for details.

The following errors will cause the connection to be closed:

  • buffer_collection_id is already registered
source

pub fn add_image( &self, image_id: u32, buffer_collection_id: u32, buffer_collection_index: u32, image_format: &ImageFormat2 ) -> Result<(), Error>

Adds an image resource to image pipe.

buffer_collection_id refers to the BufferCollectionToken instance that is registered via AddBufferCollection(). The underlying memory objects allocated are used to address to the image data. buffer_collection_index refers to the index of the memory object allocated in BufferCollection.

image_format specifiies image properties. coded_width and coded_height are used to set image dimensions.

It is valid to create multiple images backed by the same memory object; they may even overlap. Consumers must detect this and handle it accordingly.

The following errors will cause the connection to be closed:

  • image_id is already registered
  • buffer_collection_id refers to an unregistered BufferCollection.
  • buffer_collection_index points to a resource index out of the initialized BufferCollection bounds
  • No resource is allocated in the registered BufferCollection.
source

pub fn remove_buffer_collection( &self, buffer_collection_id: u32 ) -> Result<(), Error>

Removes a BufferCollection resource from the pipe.

The buffer_collection_id resource is detached as well as all Images that are associated with that BufferCollection. Leads to the same results as calling RemoveImage() on all Images for buffer_collection_id.

The producer must wait for all release fences associated with the Images to be signaled before freeing or modifying the underlying memory object since the image may still be in use in the presentation queue.

The following errors will cause the connection to be closed:

  • buffer_collection_id does not reference a currently registered BufferCollection
source

pub fn remove_image(&self, image_id: u32) -> Result<(), Error>

Removes an image resource from the pipe.

The image_id is detached from the image resource and is free to be reused to add a new image resource.

Removing an image from the image pipe does not affect the presentation queue or the currently presented image.

The producer must wait for all release fences associated with the image to be signaled before freeing or modifying the underlying memory object since the image may still be in use in the presentation queue.

The following errors will cause the connection to be closed:

  • image_id does not reference a currently registered image resource
source

pub fn present_image( &self, image_id: u32, presentation_time: u64, acquire_fences: Vec<Event>, release_fences: Vec<Event> ) -> QueryResponseFut<PresentationInfo>

Enqueues the specified image for presentation by the consumer.

The acquire_fences are a set of fences which must all be signaled by the producer before the consumer presents the image. The release_fences are a set of fences which inform the producer that it’s safe to free or modify the image_id image, and it’s safe to re-use the fences in acquire_fences. The consumer must signal all the fences in release_fences after image_id is no longer being presented. The producer may reuse resources after any of the release_fences is signaled.

This design allows a producer to distribute image processing across multiple threads / processes without unnecessary coordination delay. Each thread / process signals its own fence in acquire_fences when it’s done rendering its piece of image_id, and waits on its own fence in release_fences to render new content in image_id.

presentation_time specifies the time on or after which the client would like the enqueued operations should take visible effect (light up pixels on the screen), expressed in nanoseconds in the CLOCK_MONOTONIC timebase. Desired presentation times must be monotonically non-decreasing.

presentation_info returns timing information about the submitted frame and future frames (see presentation_info.fidl).

The producer may decide not to signal acquire_fences for an image. In that case, if a later image is enqueued and later image’s presentation_time is reached, the consumer presents the later image when later image’s acquire_fences are signaled. The consumer also signals earlier image’s release_fences and removes it from the presentation queue. This sequence works as a cancellation mechanism.

The following errors will cause the connection to be closed:

  • image_id does not reference a currently registered image resource

Trait Implementations§

source§

impl Clone for ImagePipe2Proxy

source§

fn clone(&self) -> ImagePipe2Proxy

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl Debug for ImagePipe2Proxy

source§

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

Formats the value using the given formatter. Read more
source§

impl ImagePipe2ProxyInterface for ImagePipe2Proxy

source§

fn add_buffer_collection( &self, buffer_collection_id: u32, buffer_collection_token: ClientEnd<BufferCollectionTokenMarker> ) -> Result<(), Error>

source§

fn add_image( &self, image_id: u32, buffer_collection_id: u32, buffer_collection_index: u32, image_format: &ImageFormat2 ) -> Result<(), Error>

source§

fn remove_buffer_collection( &self, buffer_collection_id: u32 ) -> Result<(), Error>

source§

fn remove_image(&self, image_id: u32) -> Result<(), Error>

§

type PresentImageResponseFut = QueryResponseFut<PresentationInfo>

source§

fn present_image( &self, image_id: u32, presentation_time: u64, acquire_fences: Vec<Event>, release_fences: Vec<Event> ) -> Self::PresentImageResponseFut

source§

impl Proxy for ImagePipe2Proxy

§

type Protocol = ImagePipe2Marker

The protocol which this Proxy controls.
source§

fn from_channel(inner: AsyncChannel) -> Self

Create a proxy over the given channel.
source§

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

Attempt to convert the proxy back into a channel. Read more
source§

fn as_channel(&self) -> &AsyncChannel

Get a reference to the proxy’s underlying channel. Read more
§

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

Attempt to convert the proxy back into a client end. Read more
§

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.

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
§

impl<T> Encode<Ambiguous1> for T

§

unsafe fn encode( self, _encoder: &mut Encoder<'_>, _offset: usize, _depth: Depth ) -> Result<(), Error>

Encodes the object into the encoder’s buffers. Any handles stored in the object are swapped for Handle::INVALID. Read more
§

impl<T> Encode<Ambiguous2> for T

§

unsafe fn encode( self, _encoder: &mut Encoder<'_>, _offset: usize, _depth: Depth ) -> Result<(), Error>

Encodes the object into the encoder’s buffers. Any handles stored in the object are swapped for Handle::INVALID. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

§

impl<T> Pointable for T

§

const ALIGN: usize = _

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more