Installing Squish Embedded Extension for Weston

The Wayland Protocol does not specify some functionality typically found in windowing systems, like screenshooting or input injection. In the default configuration, several Squish features which depend on these features will not work. This extension adds that functionality to the Weston compositor.

Installation

The Squish extension for Weston requires the following headers and libraries:

1. Weston >= 2.0.0
2. Pixman >= 0.32

It also requires the wayland-scanner command to be compatible with the wayland library installed on the target system. The Weston extension will be built with Squish when configured with --enable-weston-extension if the above requirements are met in the build environment.

When you have these dependencies installed in a non-standard location, you can use the following configure options:

1. --with-wayland-scanner=/path/to/wayland-scanner
2. --with-pixman=/path/to/pixman/install/prefix
3. --with-weston=/path/to/weston/install/prefix

The extension is found in the libsquish-weston-test.so file in the lib directory of the Squish installation. To use it, you need to edit the weston.ini file and add the path to the extension library to the modules setting in the [core] section, e.g.:

[core]
modules = /path/to/Squish/lib/libsquish-weston-test.so,<other modules>

The module path can also be provided on the Weston command line using the --modules option, e.g.:

$ weston --modules /path/to/Squish/lib/libsquish-weston-test.so,<other modules> <other options>

Alternatively, the extension library can be copied to Weston's default extension directory (e.g., /usr/lib/weston/). In this case, you can specify just the file name in the configuration file, e.g.:

[core]
modules = libsquish-weston-test.so,<other modules>

Or:

$ weston --modules libsquish-weston-test.so,<other modules> <other options>

Logging

The Weston extension has a logging facility that can be used to diagnose any issues. You can configure this using the squish-test section of the weston.ini file:

[squish-test]
log=+
log-level=detailed

The log option values can be:

The log-level option values can be:

The above options can also be passed on the Weston command line, e.g.:

$ weston --modules libsquish-weston-test.so,<other modules> --squish-log=+ --squish-log-level=detailed <other options>