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.
Note: The Weston Extension is only included in the Squish Embedded source packages.
The Squish extension for Weston requires the following headers and libraries:
- Weston >= 2.0.0
- 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:
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>
$ weston --modules libsquish-weston-test.so,<other modules> <other options>
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
log option values can be:
|No logging (default)|
|Logging to Weston standard output stream|
|Logging to Weston standard error stream|
|Logging to the specified file|
log-level option values can be:
|no logging (default)|
|only critical messages|
|warnings and critical messages|
|detailed information about performed operations|
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>
© 2023 The Qt Company Ltd.
Documentation contributions included herein are the copyrights of
their respective owners.
The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation.
Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.