diff --git a/unstable/wlr-export-dmabuf-unstable-v1.xml b/unstable/wlr-export-dmabuf-unstable-v1.xml index 751f7ef..69bfc19 100644 --- a/unstable/wlr-export-dmabuf-unstable-v1.xml +++ b/unstable/wlr-export-dmabuf-unstable-v1.xml @@ -36,7 +36,7 @@ interface version number is reset. - + This object is a manager with which to start capturing from sources. @@ -59,7 +59,7 @@ - + This object represents a single DMA-BUF frame. @@ -75,6 +75,9 @@ responsible for closing the associated file descriptor. All frames are read-only and may not be written into or altered. + + If a sync_fence event is received, clients must wait on the sync + fence to be signalled by the compositor before using the frame. @@ -141,9 +144,11 @@ - This event is sent as soon as the frame is presented, indicating it is - available for reading. This event includes the time at which - presentation happened at. + This event is sent as soon as all the data pertaining to the frame has + been received by the client. This event includes the time at which + the scanout began at. + If a sync_fence object has been received, the clients must wait for it + to be signalled, otherwise the frame can be considered ready to be read. The timestamp is expressed as tv_sec_hi, tv_sec_lo, tv_nsec triples, each component being an unsigned 32-bit value. Whole seconds are in @@ -199,5 +204,16 @@ to close any FDs it has been given. + + + + + This event provides a dma_fence kernel object which will be signalled + when the client can start sampling from the buffer. + + + +