Treeland prelaunch splash v2
The key words "must", "must not", "required", "shall", "shall not", "should", "should not", "recommended", "may", and "optional" in this document are to be interpreted as described in RFC 2119.
Warning! This protocol is EXPERIMENTAL and under active development. It may change at any time, including in backward-incompatible ways, without incrementing the interface major version and without prior notice. No compatibility guarantees of any kind are provided. Clients and compositors must track the upstream definition in treeland-protocols and must not rely on the current interface names, requests, events, or semantics remaining stable across releases.
treeland_prelaunch_splash_manager_v2
This interface is a manager for creating prelaunch splash screens. A prelaunch splash screen is a placeholder surface that is shown before an application's main window is mapped. This helps to improve the perceived startup time.
It is particularly useful for application launchers to provide immediate feedback to the user.
Compared to treeland_prelaunch_splash_manager_v1, this version returns a splash object from create_splash. The caller can destroy the object to dismiss the splash, and the compositor can send events (e.g. timeout) back to the caller through the object.
This interface is a singleton. Only one client may bind it at a time within a given user session. If a second client attempts to bind while a binding is already active, the compositor must reject the attempt by sending a protocol error (binding_rejected). The singleton binding is released when the client destroys the manager object.
create_splash(splash: new_id<treeland_prelaunch_splash_v2>, app_id: string, instance_id: string, sandbox_engine_name: string, icon_buffer: object<wl_buffer>)
Argument | Type | Description |
|---|---|---|
| splash | new_id<treeland_prelaunch_splash_v2> | new splash object |
| app_id | string | the application ID |
| instance_id | string | the application instance ID |
| sandbox_engine_name | string | the sandbox engine / security context name (required, non-empty) |
| icon_buffer | object<wl_buffer>allow null | optional icon image as wl_buffer (e.g. wl_shm) |
Creates a new prelaunch splash screen and returns a splash object.
The `app_id` is a string that identifies the application. The compositor will use this ID together with `sandbox_engine_name` to match the splash screen with the actual application window when it appears. This matching mechanism should also work for XWayland windows.
The `instance_id` identifies a specific application instance, allowing multiple splashes for non-singleton applications. The compositor can use this to associate a splash with a particular launch instance.
Callers MUST provide a non-empty `sandbox_engine_name` string which identifies the sandboxing/container.
error { binding_rejected }
Argument | Value | Description |
|---|---|---|
| binding_rejected | 0 | the manager is already bound by another client |
Error codes sent as protocol errors via wl_display.error.
treeland_prelaunch_splash_v2
Represents a single prelaunch splash screen created by the manager.
The caller can destroy this object to dismiss the corresponding splash. The compositor may also send events through this object, for example to notify the caller that the splash was closed due to a timeout.
destroy()
Dismisses the splash screen and destroys this object.
Compositor Support
Copyright
SPDX-FileCopyrightText: 2026 UnionTech Software Technology Co., Ltd. SPDX-License-Identifier: MIT