To learn the basics, refer to the srm-basic example. For creating textures from a single allocation and setting the hardware cursor pixels and position, you can check the srm-all-connectors example.

Additionally, to learn how to enable multi-session functionality and integrate input events with Libinput, please refer to the srm-multi-session example.

Running Included Examples

Those examples are included when installing SRM. To run them, follow these steps:

1. srm-basic: This example displays a continuously changing solid color on the screen until you press CTRL + C to stop it. It's a simple demonstration of SRM's graphics pipeline.
2. srm-all-connectors: In this example, SRM renders a shared texture created from a single allocation to all available connectors and animates the hardware cursor for 10 secs or until CTRL + C is pressed.
3. srm-multi-session: In this example, SRM opens devices using libseat, allowing you to switch TTY sessions by pressing CTRL + ALT + F[1, 2, 3, ... 10]. It renders solid colors to all available connectors and enables you to move the hardware cursor using any pointing device, such as a touchpad or mouse, until you press ESC.
4. srm-display-info: This example outputs the current machine's configuration in JSON format, providing a snapshot of display-related information.

To run any of these examples, switch to a free TTY by pressing CTRL + ALT + F[1, 2, 3, ... 10], fn + CTRL + ALT + F[1, 2, 3, ... 10], or using the chvt N command (replace N with the desired virtual terminal number). Then, simply execute the desired example's command.

The srm-basic and srm-all-connectors examples may necessitate elevated privileges for execution. Alternatively, you can include your user in the video group.

In contrast, srm-multi-session doesn't demand superuser privileges but relies on your system having a seat service.

Similarly, srm-display-info doesn't mandate superuser privileges, as it solely retrieves information from DRM devices without performing any KMS operations.