Module zwp_linux_dmabuf_feedback_v1

dmabuf feedback

This object advertises dmabuf parameters feedback. This includes the preferred devices and the supported formats/modifiers.

The parameters are sent once when this object is created and whenever they change. The done event is always sent once after all parameters have been sent. When a single parameter changes, all parameters are re-sent by the compositor.

Compositors can re-send the parameters when the current client buffer allocations are sub-optimal. Compositors should not re-send the parameters if re-allocating the buffers would not result in a more optimal configuration. In particular, compositors should avoid sending the exact same parameters multiple times in a row.

The tranche_target_device and tranche_formats events are grouped by tranches of preference. For each tranche, a tranche_target_device, one tranche_flags and one or more tranche_formats events are sent, followed by a tranche_done event finishing the list. The tranches are sent in descending order of preference. All formats and modifiers in the same tranche have the same preference.

To send parameters, the compositor sends one main_device event, tranches (each consisting of one tranche_target_device event, one tranche_flags event, tranche_formats events and then a tranche_done event), then one done event.

Structs

TrancheFlags

ZwpLinuxDmabufFeedbackV1

dmabuf feedback

Enums

Event

Request

Constants

EVT_DONE_OPCODE

The wire opcode for this event

EVT_DONE_SINCE

The minimal object version supporting this event

EVT_FORMAT_TABLE_OPCODE

The wire opcode for this event

EVT_FORMAT_TABLE_SINCE

The minimal object version supporting this event

EVT_MAIN_DEVICE_OPCODE

The wire opcode for this event

EVT_MAIN_DEVICE_SINCE

The minimal object version supporting this event

EVT_TRANCHE_DONE_OPCODE

The wire opcode for this event

EVT_TRANCHE_DONE_SINCE

The minimal object version supporting this event

EVT_TRANCHE_FLAGS_OPCODE

The wire opcode for this event

EVT_TRANCHE_FLAGS_SINCE

The minimal object version supporting this event

EVT_TRANCHE_FORMATS_OPCODE

The wire opcode for this event

EVT_TRANCHE_FORMATS_SINCE

The minimal object version supporting this event

EVT_TRANCHE_TARGET_DEVICE_OPCODE

The wire opcode for this event

EVT_TRANCHE_TARGET_DEVICE_SINCE

The minimal object version supporting this event

REQ_DESTROY_OPCODE

The wire opcode for this request

REQ_DESTROY_SINCE

The minimal object version supporting this request