cosmic::cctk::sctk::reexports::protocols::wp::color_management::v1::client::wp_color_management_surface_feedback_v1

Struct WpColorManagementSurfaceFeedbackV1

pub struct WpColorManagementSurfaceFeedbackV1 { /* private fields */ }

Available on crate feature wayland and Linux only.

Expand description

color management extension to a surface

A wp_color_management_surface_feedback_v1 allows the client to get the preferred image description of a surface.

If the wl_surface associated with this object is destroyed, the wp_color_management_surface_feedback_v1 object becomes inert.

See also the Event enum for this interface.

Implementations§

§

impl WpColorManagementSurfaceFeedbackV1

pub fn destroy(&self)

destroy the color management interface for a surface

Destroy the wp_color_management_surface_feedback_v1 object.

pub fn get_preferred<U, D>( &self, qh: &QueueHandle<D>, udata: U, ) -> WpImageDescriptionV1
where U: Send + Sync + 'static, D: Dispatch<WpImageDescriptionV1, U> + 'static,

get the preferred image description

If this protocol object is inert, the protocol error inert is raised.

The preferred image description represents the compositor’s preferred color encoding for this wl_surface at the current time. There might be performance and power advantages, as well as improved color reproduction, if the image description of a content update matches the preferred image description.

This creates a new wp_image_description_v1 object for the currently preferred image description for the wl_surface. The client should stop using and destroy the image descriptions created by earlier invocations of this request for the associated wl_surface. This request is usually sent as a reaction to the preferred_changed event or when creating a wp_color_management_surface_feedback_v1 object if the client is capable of adapting to image descriptions.

The created wp_image_description_v1 object preserves the preferred image description of the wl_surface from the time the object was created.

The resulting image description object allows get_information request.

If the image description is parametric, the client should set it on its wl_surface only if the image description is an exact match with the client content. Particularly if everything else matches, but the target color volume is greater than what the client needs, the client should create its own parameric image description with its exact parameters.

If the interface version is inadequate for the preferred image description, meaning that the client does not support all the events needed to deliver the crucial information, the resulting image description object shall immediately deliver the wp_image_description_v1.failed event with the low_version cause, otherwise the object shall immediately deliver the ready event.

pub fn get_preferred_parametric<U, D>( &self, qh: &QueueHandle<D>, udata: U, ) -> WpImageDescriptionV1
where U: Send + Sync + 'static, D: Dispatch<WpImageDescriptionV1, U> + 'static,

get the preferred image description

The same description as for get_preferred applies, except the returned image description is guaranteed to be parametric. This is meant for clients that can only deal with parametric image descriptions.

If the compositor doesn’t support parametric image descriptions, the unsupported_feature error is emitted.