weston

Pekka Paalanen 7e62d25257 protocol: add presentation extension v5 Add accurate presentation timing features to Wayland: queueing and feedback. This specification is based on the draft written by Frederic Plourde <frederic.plourde@collabora.co.uk> and redesigned by Pekka Paalanen. The RFC v2 version is from http://lists.freedesktop.org/archives/wayland-devel/2014-January/012988.html Changes in v3: * associate presentation time to current surface contents This implements the suggestion from http://lists.freedesktop.org/archives/wayland-devel/2014-February/013066.html which prevents surface content from jumping backwards in time if a client retroactively queues an update with a target time in the past. * use 64-bit tv_sec in presentation The time_t type used in struct timespec could be almost anything. POSIX probably defines it to be an integer, but not the size. Apparently it is usually 'long', which makes it 64-bit on x86_64. To be able to fully represent timespec values returned by clock_gettime, change the protocol to use 64 bits for the tv_sec part. * define an error for invalid tv_nsec This allow us to rely on the normalized timestamp form. * define some interactions with sub-surfaces Sub-surface cached state updates (synchronized mode) are designed especially for resizing. As queued updates are not meant to produce any resizing-like effects, they also do not trigger any sub-surface operations. * add sub-headings as xml comments * queued update cannot map Because before mapping, the surface has no main output assigned. An immediate commit is needed anyway, to be able to set all the surface state, which a queued update cannot touch. * frame callbacks are not queued It is not known when queueing frame callbacks would be useful. Changes in v4: * remove mentions of the queuing feature The specification has been split and the queuing feature will be added back in another version of the extension. * add flags argument to 'presented' event Describe the nature of how the update was presented to screen and the characteristics of the feedback information. No flags have been defined for now. * add a protocol error code for invalid flags Changes in v5: * remove the destroy method for the feedback object The protocol object should instead be automatically destroyed after a 'presented' or 'discarded' event has been triggered. * some grammatical corrections to the specification [Louis-Francis Ratté-Boulianne: split the spec in two parts] Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk> Signed-off-by: Louis-Francis Ratté-Boulianne <lfrb@collabora.com> v3 Reviewed-by: Mario Kleiner <mario.kleiner.de@gmail.com>		10 years ago
clients	clients: Maximize window when double touch on title bar	10 years ago
data	build: Move data/Makefile.am into Makefile.am	11 years ago
desktop-shell	shell: fix weston_output_mode_switch() usage	10 years ago
fullscreen-shell	shell: fix weston_output_mode_switch() usage	10 years ago
m4	weston-build: Fix aclocal error during autogen.sh	11 years ago
man	compositor: add an option to set the default numlock value	10 years ago
protocol	protocol: add presentation extension v5	10 years ago
shared	clients: Maximize window when double touch on title bar	10 years ago
src	cosmetic: Move WL_EXPORT out of header files	10 years ago
tests	matrix-test: fix units in report	10 years ago
wcap	wcap: Check for mmap and malloc return value in wcap decode module	11 years ago
xwayland	xwm: Do not activate override redirect windows	10 years ago
.gitignore	Add a simple client for testing compositor damage handling	11 years ago
COPYING	Add COPYING	13 years ago
Makefile.am	protocol: add presentation extension v5	10 years ago
README	README: Fix typo; add link to testing docs	11 years ago
autogen.sh	Update autotools configuration	14 years ago
configure.ac	configure.ac: bump version to 1.6.90	10 years ago
notes.txt	Add informal notes file	12 years ago
releasing.txt	Add releasing.txt to describe the release steps and other bits of process	11 years ago
weston.ini.in	libinput: Add tap configuration to weston.ini	10 years ago

README

Weston

Weston is the reference implementation of a Wayland compositor, and a
useful compositor in its own right.  Weston has various backends that
lets it run on Linux kernel modesetting and evdev input as well as
under X11.  Weston ships with a few example clients, from simple
clients that demonstrate certain aspects of the protocol to more
complete clients and a simplistic toolkit.  There is also a quite
capable terminal emulator (weston-terminal) and an toy/example desktop
shell.  Finally, weston also provides integration with the Xorg server
and can pull X clients into the Wayland desktop and act as a X window
manager.

Refer to http://wayland.freedesktop.org/building.html for building
weston and its dependencies.

The test suite can be invoked via `make check`; see
http://wayland.freedesktop.org/testing.html for additional details.