protocol: add Presentation feedback flags
authorPekka Paalanen <pekka.paalanen@collabora.co.uk>
Wed, 17 Dec 2014 14:20:39 +0000 (16:20 +0200)
committerBryce Harrington <bryce@osg.samsung.com>
Wed, 21 Jan 2015 01:12:56 +0000 (17:12 -0800)
commit0de22a38e6376521ec4003c1e6140714fd3500bc
tree147858708371fe0217a0cdd9d89e23a30d170d24
parent050c1ba7290e017358cbe5f7971f8f0ead3afbcd
protocol: add Presentation feedback flags

Add the missing feedback flags to the Presentation extension protocol
specification.

These flags are slightly different from the previous RFCv3.1 definition:
http://lists.freedesktop.org/archives/wayland-devel/2014-March/013598.html

Now, all compositors are safe to use 0 as the flags if they don't bother
setting them properly. 0 is the "worst case" with the least guarantees.

The meaning of ZERO_COPY is not exactly the opposite of the old COPY
flag. ZERO_COPY is more strict, but applies only to that one surface.
Therefore it can be used to verify a zero-copy video playback pipeline,
also to a hardware overlay.

There is no longer a flag to clearly indicate if the final presentation
was done by a copy or a page flip. ZERO_COPY forbids the copy, but VSYNC
alone does allow copy in case it cannot tear.  It is possible to have
first a compositing pass, and then another copy into the frontbuffer,
and still set VSYNC if it cannot tear.  Usually "cannot tear" is too
hard to guarantee with a copy, so it often implies a page flip.

Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
Reviewed-by: Mario Kleiner <mario.kleiner.de@gmail.com>
Tested-by: Mario Kleiner <mario.kleiner.de@gmail.com>
protocol/presentation_timing.xml