Wakefield Protocol

This is a Weston protocol extension created to satisfy the requirements of the Wakefield project testing.

Rationale

Many of java.awt.Robot capabilities contradict the basic principles of Wayland. The examples include obtaining the color of a pixel at specified coordinates by automated tests. This extension aims to help in implementation of those capabilities for the use in test environment only.

Prerequisites

On Ubuntu 21.04 (in addition to the usual C development environment):

$ sudo apt install cmake libwayland-dev wayland-protocols \
   libweston-9-0 libweston-9-dev weston libpixman-1-dev libpixman-1-0 \
   libcairo-dev

Build

$ cd wakefield
$ mkdir build
$ cd build
$ cmake ..
$ make install

This should build libwakefield.so and install it to the source root (overwriting the existing one stored in git).

Run

Use ./run.sh in the project root or

PWD=`pwd`
weston -B wayland-backend.so --socket=wayland-test \
    --width=800 --height=600 --use-pixman \
    --socket=wayland-42 \
    --modules="$PWD/libwakefield.so"

This will create a new weston compositor instance with the Wayland socket named wayland-42. Now you can verify that a new global has been published by running this command:

$ WAYLAND_DISPLAY=wayland-42 weston-info | grep wakefield
interface: 'wakefield', version: 1, name: 21