Struct wayland_protocols::wp::linux_drm_syncobj::v1::client::wp_linux_drm_syncobj_surface_v1::WpLinuxDrmSyncobjSurfaceV1
source · pub struct WpLinuxDrmSyncobjSurfaceV1 { /* private fields */ }
Expand description
per-surface explicit synchronization
This object is an add-on interface for wl_surface to enable explicit synchronization.
Each surface can be associated with only one object of this interface at any time.
Explicit synchronization is guaranteed to be supported for buffers created with any version of the linux-dmabuf protocol. Compositors are free to support explicit synchronization for additional buffer types. If at surface commit time the attached buffer does not support explicit synchronization, an unsupported_buffer error is raised.
As long as the wp_linux_drm_syncobj_surface_v1 object is alive, the compositor may ignore implicit synchronization for buffers attached and committed to the wl_surface. The delivery of wl_buffer.release events for buffers attached to the surface becomes undefined.
Clients must set both acquire and release points if and only if a non-null buffer is attached in the same surface commit. See the no_buffer, no_acquire_point and no_release_point protocol errors.
If at surface commit time the acquire and release DRM syncobj timelines are identical, the acquire point value must be strictly less than the release point value, or else the conflicting_points protocol error is raised.
This interface has no events.
Implementations§
source§impl WpLinuxDrmSyncobjSurfaceV1
impl WpLinuxDrmSyncobjSurfaceV1
sourcepub fn destroy(&self)
pub fn destroy(&self)
destroy the surface synchronization object
Destroy this surface synchronization object.
Any timeline point set by this object with set_acquire_point or set_release_point since the last commit may be discarded by the compositor. Any timeline point set by this object before the last commit will not be affected.
sourcepub fn set_acquire_point(
&self,
timeline: &WpLinuxDrmSyncobjTimelineV1,
point_hi: u32,
point_lo: u32
)
pub fn set_acquire_point( &self, timeline: &WpLinuxDrmSyncobjTimelineV1, point_hi: u32, point_lo: u32 )
set the acquire timeline point
Set the timeline point that must be signalled before the compositor may sample from the buffer attached with wl_surface.attach.
The 64-bit unsigned value combined from point_hi and point_lo is the point value.
The acquire point is double-buffered state, and will be applied on the next wl_surface.commit request for the associated surface. Thus, it applies only to the buffer that is attached to the surface at commit time.
If an acquire point has already been attached during the same commit cycle, the new point replaces the old one.
If the associated wl_surface was destroyed, a no_surface error is raised.
If at surface commit time there is a pending acquire timeline point set but no pending buffer attached, a no_buffer error is raised. If at surface commit time there is a pending buffer attached but no pending acquire timeline point set, the no_acquire_point protocol error is raised.
sourcepub fn set_release_point(
&self,
timeline: &WpLinuxDrmSyncobjTimelineV1,
point_hi: u32,
point_lo: u32
)
pub fn set_release_point( &self, timeline: &WpLinuxDrmSyncobjTimelineV1, point_hi: u32, point_lo: u32 )
set the release timeline point
Set the timeline point that must be signalled by the compositor when it has finished its usage of the buffer attached with wl_surface.attach for the relevant commit.
Once the timeline point is signaled, and assuming the associated buffer is not pending release from other wl_surface.commit requests, no additional explicit or implicit synchronization with the compositor is required to safely re-use the buffer.
Note that clients cannot rely on the release point being always signaled after the acquire point: compositors may release buffers without ever reading from them. In addition, the compositor may use different presentation paths for different commits, which may have different release behavior. As a result, the compositor may signal the release points in a different order than the client committed them.
Because signaling a timeline point also signals every previous point, it is generally not safe to use the same timeline object for the release points of multiple buffers. The out-of-order signaling described above may lead to a release point being signaled before the compositor has finished reading. To avoid this, it is strongly recommended that each buffer should use a separate timeline for its release points.
The 64-bit unsigned value combined from point_hi and point_lo is the point value.
The release point is double-buffered state, and will be applied on the next wl_surface.commit request for the associated surface. Thus, it applies only to the buffer that is attached to the surface at commit time.
If a release point has already been attached during the same commit cycle, the new point replaces the old one.
If the associated wl_surface was destroyed, a no_surface error is raised.
If at surface commit time there is a pending release timeline point set but no pending buffer attached, a no_buffer error is raised. If at surface commit time there is a pending buffer attached but no pending release timeline point set, the no_release_point protocol error is raised.
Trait Implementations§
source§impl Borrow<ObjectId> for WpLinuxDrmSyncobjSurfaceV1
impl Borrow<ObjectId> for WpLinuxDrmSyncobjSurfaceV1
source§impl Clone for WpLinuxDrmSyncobjSurfaceV1
impl Clone for WpLinuxDrmSyncobjSurfaceV1
source§fn clone(&self) -> WpLinuxDrmSyncobjSurfaceV1
fn clone(&self) -> WpLinuxDrmSyncobjSurfaceV1
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl Debug for WpLinuxDrmSyncobjSurfaceV1
impl Debug for WpLinuxDrmSyncobjSurfaceV1
source§impl Hash for WpLinuxDrmSyncobjSurfaceV1
impl Hash for WpLinuxDrmSyncobjSurfaceV1
source§impl PartialEq<Weak<WpLinuxDrmSyncobjSurfaceV1>> for WpLinuxDrmSyncobjSurfaceV1
impl PartialEq<Weak<WpLinuxDrmSyncobjSurfaceV1>> for WpLinuxDrmSyncobjSurfaceV1
source§impl PartialEq for WpLinuxDrmSyncobjSurfaceV1
impl PartialEq for WpLinuxDrmSyncobjSurfaceV1
source§fn eq(&self, other: &WpLinuxDrmSyncobjSurfaceV1) -> bool
fn eq(&self, other: &WpLinuxDrmSyncobjSurfaceV1) -> bool
self
and other
values to be equal, and is used
by ==
.source§impl Proxy for WpLinuxDrmSyncobjSurfaceV1
impl Proxy for WpLinuxDrmSyncobjSurfaceV1
source§fn data<U: Send + Sync + 'static>(&self) -> Option<&U>
fn data<U: Send + Sync + 'static>(&self) -> Option<&U>
source§fn object_data(&self) -> Option<&Arc<dyn ObjectData>>
fn object_data(&self) -> Option<&Arc<dyn ObjectData>>
source§fn backend(&self) -> &WeakBackend
fn backend(&self) -> &WeakBackend
source§fn send_request(&self, req: Self::Request<'_>) -> Result<(), InvalidId>
fn send_request(&self, req: Self::Request<'_>) -> Result<(), InvalidId>
source§fn send_constructor<I: Proxy>(
&self,
req: Self::Request<'_>,
data: Arc<dyn ObjectData>
) -> Result<I, InvalidId>
fn send_constructor<I: Proxy>( &self, req: Self::Request<'_>, data: Arc<dyn ObjectData> ) -> Result<I, InvalidId>
source§fn from_id(conn: &Connection, id: ObjectId) -> Result<Self, InvalidId>
fn from_id(conn: &Connection, id: ObjectId) -> Result<Self, InvalidId>
source§fn inert(backend: WeakBackend) -> Self
fn inert(backend: WeakBackend) -> Self
source§fn parse_event(
conn: &Connection,
msg: Message<ObjectId, OwnedFd>
) -> Result<(Self, Self::Event), DispatchError>
fn parse_event( conn: &Connection, msg: Message<ObjectId, OwnedFd> ) -> Result<(Self, Self::Event), DispatchError>
source§fn write_request<'a>(
&self,
conn: &Connection,
msg: Self::Request<'a>
) -> Result<(Message<ObjectId, BorrowedFd<'a>>, Option<(&'static Interface, u32)>), InvalidId>
fn write_request<'a>( &self, conn: &Connection, msg: Self::Request<'a> ) -> Result<(Message<ObjectId, BorrowedFd<'a>>, Option<(&'static Interface, u32)>), InvalidId>
impl Eq for WpLinuxDrmSyncobjSurfaceV1
Auto Trait Implementations§
impl !RefUnwindSafe for WpLinuxDrmSyncobjSurfaceV1
impl Send for WpLinuxDrmSyncobjSurfaceV1
impl Sync for WpLinuxDrmSyncobjSurfaceV1
impl Unpin for WpLinuxDrmSyncobjSurfaceV1
impl !UnwindSafe for WpLinuxDrmSyncobjSurfaceV1
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
§impl<T> Downcast for Twhere
T: Any,
impl<T> Downcast for Twhere
T: Any,
§fn into_any(self: Box<T>) -> Box<dyn Any>
fn into_any(self: Box<T>) -> Box<dyn Any>
Box<dyn Trait>
(where Trait: Downcast
) to Box<dyn Any>
. Box<dyn Any>
can
then be further downcast
into Box<ConcreteType>
where ConcreteType
implements Trait
.§fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
Rc<Trait>
(where Trait: Downcast
) to Rc<Any>
. Rc<Any>
can then be
further downcast
into Rc<ConcreteType>
where ConcreteType
implements Trait
.§fn as_any(&self) -> &(dyn Any + 'static)
fn as_any(&self) -> &(dyn Any + 'static)
&Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &Any
’s vtable from &Trait
’s.§fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
&mut Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &mut Any
’s vtable from &mut Trait
’s.