mirror of
https://github.com/Cloudef/bemenu
synced 2025-03-11 10:17:28 +00:00
Wayland: fix monitor and scaling detection
The whole management of monitor_name with the Wayland backend seems heavily broken, and doesn't allow to (1) select the target output with -m, and (2) to correctly detect the used output and use correct attributes. When used with two monitors with different scale values, depending on the output order, you get a blurry menu. To fix this we attach a listener to wayland surfaces to store which outputs it belongs to. This rewrite almost completly the "recreate_windows" function. This also drop completly the xdg-output-unstable-v1 protocol, cause v4 already add the "name" event to fetch the output name. I did not pushed this to support v6, with the new "preferred_buffer_scale" event, cause anyway we need to fetch the output max_height.
This commit is contained in:
Willow Barraco
Jari Vetoniemi
parent
eb92e7b39d
commit
c22cc64bdb
11
GNUmakefile
11
GNUmakefile
@ -85,24 +85,15 @@ lib/renderers/wayland/wlr-layer-shell-unstable-v1.h: lib/renderers/wayland/wlr-l
|
||||
lib/renderers/wayland/wlr-layer-shell-unstable-v1.c: lib/renderers/wayland/wlr-layer-shell-unstable-v1.xml
|
||||
wayland-scanner private-code < $^ > $@
|
||||
|
||||
lib/renderers/wayland/xdg-output-unstable-v1.h: lib/renderers/wayland/xdg-output-unstable-v1.xml
|
||||
wayland-scanner client-header < $^ > $@
|
||||
|
||||
lib/renderers/wayland/xdg-output-unstable-v1.c: lib/renderers/wayland/xdg-output-unstable-v1.xml
|
||||
wayland-scanner private-code < $^ > $@
|
||||
|
||||
xdg-shell.a: private override LDFLAGS += -fPIC
|
||||
xdg-shell.a: private override CPPFLAGS += $(shell $(PKG_CONFIG) --cflags-only-I wayland-client)
|
||||
xdg-shell.a: lib/renderers/wayland/xdg-shell.c
|
||||
wlr-layer-shell.a: private override LDFLAGS += -fPIC
|
||||
wlr-layer-shell.a: private override CPPFLAGS += $(shell $(PKG_CONFIG) --cflags-only-I wayland-client)
|
||||
wlr-layer-shell.a: lib/renderers/wayland/wlr-layer-shell-unstable-v1.c lib/renderers/wayland/wlr-layer-shell-unstable-v1.h
|
||||
xdg-output.a: private override LDFLAGS += -fPIC
|
||||
xdg-output.a: private override CPPFLAGS += $(shell $(PKG_CONFIG) --cflags-only-I wayland-client)
|
||||
xdg-output.a: lib/renderers/wayland/xdg-output-unstable-v1.c lib/renderers/wayland/xdg-output-unstable-v1.h
|
||||
bemenu-renderer-wayland.so: private override LDLIBS += $(shell $(PKG_CONFIG) --libs wayland-client cairo pango pangocairo xkbcommon)
|
||||
bemenu-renderer-wayland.so: private override CPPFLAGS += $(shell $(PKG_CONFIG) --cflags-only-I wayland-client cairo pango pangocairo xkbcommon)
|
||||
bemenu-renderer-wayland.so: lib/renderers/cairo_renderer.h lib/renderers/wayland/wayland.c lib/renderers/wayland/wayland.h lib/renderers/wayland/registry.c lib/renderers/wayland/window.c xdg-shell.a wlr-layer-shell.a xdg-output.a util.a
|
||||
bemenu-renderer-wayland.so: lib/renderers/cairo_renderer.h lib/renderers/wayland/wayland.c lib/renderers/wayland/wayland.h lib/renderers/wayland/registry.c lib/renderers/wayland/window.c xdg-shell.a wlr-layer-shell.a util.a
|
||||
|
||||
common.a: client/common/common.c client/common/common.h
|
||||
bemenu: common.a client/bemenu.c
|
||||
|
||||
@ -516,46 +516,6 @@ static const struct wl_seat_listener seat_listener = {
|
||||
.name = seat_handle_name
|
||||
};
|
||||
|
||||
static void
|
||||
xdg_output_handle_logical_position(void *data, struct zxdg_output_v1 *xdg_output, int32_t x, int32_t y)
|
||||
{
|
||||
(void)data, (void)xdg_output, (void)x, (void)y;
|
||||
}
|
||||
|
||||
static void
|
||||
xdg_output_handle_logical_size(void *data, struct zxdg_output_v1 *xdg_output, int32_t width, int32_t height)
|
||||
{
|
||||
(void)data, (void)xdg_output, (void)width, (void)height;
|
||||
}
|
||||
|
||||
static void
|
||||
xdg_output_handle_done(void *data, struct zxdg_output_v1 *xdg_output)
|
||||
{
|
||||
(void)data, (void)xdg_output;
|
||||
}
|
||||
|
||||
static void
|
||||
xdg_output_handle_name(void *data, struct zxdg_output_v1 *xdg_output, const char *name)
|
||||
{
|
||||
(void)xdg_output;
|
||||
struct output *output = data;
|
||||
output->name = bm_strdup(name);
|
||||
}
|
||||
|
||||
static void
|
||||
xdg_output_handle_description(void *data, struct zxdg_output_v1 *xdg_output, const char *description)
|
||||
{
|
||||
(void)data, (void)xdg_output, (void)description;
|
||||
}
|
||||
|
||||
static const struct zxdg_output_v1_listener xdg_output_listener = {
|
||||
.logical_position = xdg_output_handle_logical_position,
|
||||
.logical_size = xdg_output_handle_logical_size,
|
||||
.done = xdg_output_handle_done,
|
||||
.name = xdg_output_handle_name,
|
||||
.description = xdg_output_handle_description,
|
||||
};
|
||||
|
||||
static void
|
||||
display_handle_geometry(void *data, struct wl_output *wl_output, int x, int y, int physical_width, int physical_height, int subpixel, const char *make, const char *model, int transform)
|
||||
{
|
||||
@ -589,11 +549,28 @@ display_handle_mode(void *data, struct wl_output *wl_output, uint32_t flags, int
|
||||
}
|
||||
}
|
||||
|
||||
static void
|
||||
display_handle_name(void *data, struct wl_output *wl_output, const char *name)
|
||||
{
|
||||
(void)wl_output;
|
||||
struct output *output = data;
|
||||
|
||||
output->name = bm_strdup(name);
|
||||
}
|
||||
|
||||
static void
|
||||
display_handle_description(void *data, struct wl_output *wl_output, const char *description)
|
||||
{
|
||||
(void)data, (void)wl_output, (void)description;
|
||||
}
|
||||
|
||||
static const struct wl_output_listener output_listener = {
|
||||
.geometry = display_handle_geometry,
|
||||
.mode = display_handle_mode,
|
||||
.done = display_handle_done,
|
||||
.scale = display_handle_scale
|
||||
.scale = display_handle_scale,
|
||||
.name = display_handle_name,
|
||||
.description = display_handle_description,
|
||||
};
|
||||
|
||||
static void
|
||||
@ -613,14 +590,11 @@ registry_handle_global(void *data, struct wl_registry *registry, uint32_t id, co
|
||||
wayland->shm = wl_registry_bind(registry, id, &wl_shm_interface, 1);
|
||||
wl_shm_add_listener(wayland->shm, &shm_listener, data);
|
||||
} else if (strcmp(interface, "wl_output") == 0) {
|
||||
struct wl_output *wl_output = wl_registry_bind(registry, id, &wl_output_interface, 2);
|
||||
struct wl_output *wl_output = wl_registry_bind(registry, id, &wl_output_interface, 4);
|
||||
struct output *output = calloc(1, sizeof(struct output));
|
||||
output->output = wl_output;
|
||||
output->scale = 1;
|
||||
wl_list_insert(&wayland->outputs, &output->link);
|
||||
wl_output_add_listener(wl_output, &output_listener, output);
|
||||
} else if (!strcmp(interface, zxdg_output_manager_v1_interface.name)) {
|
||||
wayland->xdg_output_manager = wl_registry_bind(registry, id, &zxdg_output_manager_v1_interface, 2);
|
||||
}
|
||||
}
|
||||
|
||||
@ -682,14 +656,6 @@ bm_wl_registry_register(struct wayland *wayland)
|
||||
if (!wayland->compositor || !wayland->seat || !wayland->shm || !wayland->layer_shell)
|
||||
return false;
|
||||
|
||||
struct output *output;
|
||||
wl_list_for_each(output, &wayland->outputs, link) {
|
||||
output->xdg_output = zxdg_output_manager_v1_get_xdg_output(
|
||||
wayland->xdg_output_manager, output->output);
|
||||
zxdg_output_v1_add_listener(
|
||||
output->xdg_output, &xdg_output_listener, output);
|
||||
}
|
||||
|
||||
wl_display_roundtrip(wayland->display); // trip 2, global listeners
|
||||
if (!wayland->input.keyboard || !(wayland->formats & (1 << WL_SHM_FORMAT_ARGB8888)))
|
||||
return false;
|
||||
|
||||
@ -421,6 +421,50 @@ set_overlap(const struct bm_menu *menu, bool overlap)
|
||||
}
|
||||
}
|
||||
|
||||
void
|
||||
wl_surface_enter(void *data, struct wl_surface *wl_surface,
|
||||
struct wl_output *wl_output)
|
||||
{
|
||||
(void)wl_surface;
|
||||
struct window *window = data;
|
||||
struct wayland *wayland = window->wayland;
|
||||
|
||||
struct output *output;
|
||||
wl_list_for_each(output, &wayland->outputs, link) {
|
||||
if (output->output == wl_output) {
|
||||
struct surf_output *surf_output = calloc(1, sizeof(struct surf_output));
|
||||
surf_output->output = output;
|
||||
wl_list_insert(&window->surf_outputs, &surf_output->link);
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
window_update_output(window);
|
||||
}
|
||||
|
||||
void
|
||||
wl_surface_leave(void *data, struct wl_surface *wl_surface,
|
||||
struct wl_output *wl_output)
|
||||
{
|
||||
(void)wl_surface;
|
||||
struct window *window = data;
|
||||
|
||||
struct surf_output *surf_output;
|
||||
wl_list_for_each(surf_output, &window->surf_outputs, link) {
|
||||
if (surf_output->output->output == wl_output) {
|
||||
wl_list_remove(&surf_output->link);
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
window_update_output(window);
|
||||
}
|
||||
|
||||
static const struct wl_surface_listener surface_listener = {
|
||||
.enter = wl_surface_enter,
|
||||
.leave = wl_surface_leave,
|
||||
};
|
||||
|
||||
static void
|
||||
destroy_windows(struct wayland *wayland)
|
||||
{
|
||||
@ -431,57 +475,71 @@ destroy_windows(struct wayland *wayland)
|
||||
wl_list_init(&wayland->windows);
|
||||
}
|
||||
|
||||
static void
|
||||
void
|
||||
window_update_output(struct window *window)
|
||||
{
|
||||
int32_t max_scale = 1;
|
||||
uint32_t max_height = 0;
|
||||
|
||||
struct surf_output *surf_output;
|
||||
wl_list_for_each(surf_output, &window->surf_outputs, link) {
|
||||
if (surf_output->output->scale > max_scale) {
|
||||
max_scale = surf_output->output->scale;
|
||||
}
|
||||
if (max_height == 0 || surf_output->output->height < max_height) {
|
||||
max_height = surf_output->output->height;
|
||||
};
|
||||
}
|
||||
|
||||
const char *scale = getenv("BEMENU_SCALE");
|
||||
if (scale) {
|
||||
max_scale = fmax(strtof(scale, NULL), 1.0f);
|
||||
}
|
||||
|
||||
if (max_height != window->max_height) {
|
||||
window->max_height = max_height;
|
||||
}
|
||||
|
||||
if (max_scale != window->scale) {
|
||||
window->scale = max_scale;
|
||||
}
|
||||
}
|
||||
|
||||
void
|
||||
recreate_windows(const struct bm_menu *menu, struct wayland *wayland)
|
||||
{
|
||||
destroy_windows(wayland);
|
||||
|
||||
int32_t monitors = 0;
|
||||
struct output *output;
|
||||
wl_list_for_each(output, &wayland->outputs, link)
|
||||
monitors++;
|
||||
struct window *window = calloc(1, sizeof(struct window));
|
||||
wl_list_init(&window->surf_outputs);
|
||||
window->wayland = wayland;
|
||||
window->align = menu->align;
|
||||
window->hmargin_size = menu->hmargin_size;
|
||||
window->width_factor = menu->width_factor;
|
||||
|
||||
int32_t monitor = 0;
|
||||
wl_list_for_each(output, &wayland->outputs, link) {
|
||||
struct wl_surface *surface = NULL;
|
||||
if (!(surface = wl_compositor_create_surface(wayland->compositor)))
|
||||
goto fail;
|
||||
|
||||
if (!menu->monitor_name) {
|
||||
if (menu->monitor > -1) {
|
||||
if (menu->monitor < monitors && monitor != menu->monitor) {
|
||||
++monitor;
|
||||
continue;
|
||||
}
|
||||
}
|
||||
} else if (strcmp(menu->monitor_name, output->name)) {
|
||||
continue;
|
||||
}
|
||||
wl_surface_add_listener(surface, &surface_listener, window);
|
||||
|
||||
struct wl_surface *surface;
|
||||
if (!(surface = wl_compositor_create_surface(wayland->compositor)))
|
||||
goto fail;
|
||||
struct output *output = NULL;
|
||||
if (wayland->selected_output) {
|
||||
fprintf(stderr, "selected output\n");
|
||||
output = wayland->selected_output;
|
||||
};
|
||||
|
||||
wl_surface_set_buffer_scale(surface, output->scale);
|
||||
struct wl_output *wl_output = NULL;
|
||||
if (output)
|
||||
wl_output = output->output;
|
||||
|
||||
struct window *window = calloc(1, sizeof(struct window));
|
||||
window->align = menu->align;
|
||||
window->hmargin_size = menu->hmargin_size;
|
||||
window->width_factor = menu->width_factor;
|
||||
if (!bm_wl_window_create(window, wayland->display, wayland->shm,
|
||||
wl_output, wayland->layer_shell, surface))
|
||||
free(window);
|
||||
|
||||
const char *scale = getenv("BEMENU_SCALE");
|
||||
if (scale) {
|
||||
window->scale = fmax(strtof(scale, NULL), 1.0f);
|
||||
} else {
|
||||
window->scale = output->scale;
|
||||
}
|
||||
|
||||
if (!bm_wl_window_create(window, wayland->display, wayland->shm, (menu->monitor == -1) ? NULL : output->output, wayland->layer_shell, surface))
|
||||
free(window);
|
||||
|
||||
window->notify.render = bm_cairo_paint;
|
||||
window->max_height = output->height;
|
||||
window->render_pending = true;
|
||||
wl_list_insert(&wayland->windows, &window->link);
|
||||
if (menu->monitor != -2) break;
|
||||
}
|
||||
window->notify.render = bm_cairo_paint;
|
||||
window->render_pending = true;
|
||||
wl_list_insert(&wayland->windows, &window->link);
|
||||
|
||||
set_overlap(menu, menu->overlap);
|
||||
grab_keyboard(menu, menu->grabbed);
|
||||
@ -508,7 +566,19 @@ set_monitor_name(const struct bm_menu *menu, char *monitor_name)
|
||||
(void)monitor_name;
|
||||
struct wayland *wayland = menu->renderer->internal;
|
||||
assert(wayland);
|
||||
recreate_windows(menu, wayland);
|
||||
|
||||
if (!monitor_name) {
|
||||
return;
|
||||
}
|
||||
|
||||
struct output *output;
|
||||
wl_list_for_each(output, &wayland->outputs, link) {
|
||||
if (0 == strcmp(monitor_name, output->name)) {
|
||||
wayland->selected_output = output;
|
||||
recreate_windows(menu, wayland);
|
||||
return;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
static void
|
||||
|
||||
@ -8,7 +8,6 @@
|
||||
#include <linux/input-event-codes.h>
|
||||
|
||||
#include "wlr-layer-shell-unstable-v1.h"
|
||||
#include "xdg-output-unstable-v1.h"
|
||||
#include "renderers/cairo_renderer.h"
|
||||
|
||||
struct bm_menu;
|
||||
@ -115,6 +114,8 @@ struct buffer {
|
||||
};
|
||||
|
||||
struct window {
|
||||
struct wayland *wayland;
|
||||
struct wl_list surf_outputs;
|
||||
struct wl_surface *surface;
|
||||
struct wl_callback *frame_cb;
|
||||
struct zwlr_layer_surface_v1 *layer_surface;
|
||||
@ -137,13 +138,17 @@ struct window {
|
||||
|
||||
struct output {
|
||||
struct wl_output *output;
|
||||
struct zxdg_output_v1 *xdg_output;
|
||||
struct wl_list link;
|
||||
int height;
|
||||
uint32_t height;
|
||||
int scale;
|
||||
char *name;
|
||||
};
|
||||
|
||||
struct surf_output {
|
||||
struct output *output;
|
||||
struct wl_list link;
|
||||
};
|
||||
|
||||
struct wayland {
|
||||
struct {
|
||||
int32_t display;
|
||||
@ -154,12 +159,12 @@ struct wayland {
|
||||
struct wl_registry *registry;
|
||||
struct wl_compositor *compositor;
|
||||
struct wl_list outputs;
|
||||
struct output *selected_output;
|
||||
struct wl_seat *seat;
|
||||
struct zwlr_layer_shell_v1 *layer_shell;
|
||||
struct wl_shm *shm;
|
||||
struct input input;
|
||||
struct wl_list windows;
|
||||
struct zxdg_output_manager_v1 *xdg_output_manager;
|
||||
uint32_t formats;
|
||||
};
|
||||
|
||||
@ -175,6 +180,9 @@ void bm_wl_window_set_overlap(struct window *window, struct wl_display *display,
|
||||
bool bm_wl_window_create(struct window *window, struct wl_display *display, struct wl_shm *shm, struct wl_output *output, struct zwlr_layer_shell_v1 *layer_shell, struct wl_surface *surface);
|
||||
void bm_wl_window_destroy(struct window *window);
|
||||
|
||||
void recreate_windows(const struct bm_menu *menu, struct wayland *wayland);
|
||||
void window_update_output(struct window *window);
|
||||
|
||||
#endif /* _BM_WAYLAND_H_ */
|
||||
|
||||
/* vim: set ts=8 sw=4 tw=0 :*/
|
||||
|
||||
@ -189,6 +189,8 @@ next_buffer(struct window *window)
|
||||
if (!buffer->buffer && !create_buffer(window->shm, buffer, window->width * window->scale, window->height * window->scale, WL_SHM_FORMAT_ARGB8888, window->scale))
|
||||
return NULL;
|
||||
|
||||
wl_surface_set_buffer_scale(window->surface, window->scale);
|
||||
|
||||
return buffer;
|
||||
}
|
||||
|
||||
|
||||
@ -1,220 +0,0 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<protocol name="xdg_output_unstable_v1">
|
||||
|
||||
<copyright>
|
||||
Copyright © 2017 Red Hat Inc.
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a
|
||||
copy of this software and associated documentation files (the "Software"),
|
||||
to deal in the Software without restriction, including without limitation
|
||||
the rights to use, copy, modify, merge, publish, distribute, sublicense,
|
||||
and/or sell copies of the Software, and to permit persons to whom the
|
||||
Software is furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice (including the next
|
||||
paragraph) shall be included in all copies or substantial portions of the
|
||||
Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
|
||||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
|
||||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
|
||||
DEALINGS IN THE SOFTWARE.
|
||||
</copyright>
|
||||
|
||||
<description summary="Protocol to describe output regions">
|
||||
This protocol aims at describing outputs in a way which is more in line
|
||||
with the concept of an output on desktop oriented systems.
|
||||
|
||||
Some information are more specific to the concept of an output for
|
||||
a desktop oriented system and may not make sense in other applications,
|
||||
such as IVI systems for example.
|
||||
|
||||
Typically, the global compositor space on a desktop system is made of
|
||||
a contiguous or overlapping set of rectangular regions.
|
||||
|
||||
Some of the information provided in this protocol might be identical
|
||||
to their counterparts already available from wl_output, in which case
|
||||
the information provided by this protocol should be preferred to their
|
||||
equivalent in wl_output. The goal is to move the desktop specific
|
||||
concepts (such as output location within the global compositor space,
|
||||
the connector name and types, etc.) out of the core wl_output protocol.
|
||||
|
||||
Warning! The protocol described in this file is experimental and
|
||||
backward incompatible changes may be made. Backward compatible
|
||||
changes may be added together with the corresponding interface
|
||||
version bump.
|
||||
Backward incompatible changes are done by bumping the version
|
||||
number in the protocol and interface names and resetting the
|
||||
interface version. Once the protocol is to be declared stable,
|
||||
the 'z' prefix and the version number in the protocol and
|
||||
interface names are removed and the interface version number is
|
||||
reset.
|
||||
</description>
|
||||
|
||||
<interface name="zxdg_output_manager_v1" version="3">
|
||||
<description summary="manage xdg_output objects">
|
||||
A global factory interface for xdg_output objects.
|
||||
</description>
|
||||
|
||||
<request name="destroy" type="destructor">
|
||||
<description summary="destroy the xdg_output_manager object">
|
||||
Using this request a client can tell the server that it is not
|
||||
going to use the xdg_output_manager object anymore.
|
||||
|
||||
Any objects already created through this instance are not affected.
|
||||
</description>
|
||||
</request>
|
||||
|
||||
<request name="get_xdg_output">
|
||||
<description summary="create an xdg output from a wl_output">
|
||||
This creates a new xdg_output object for the given wl_output.
|
||||
</description>
|
||||
<arg name="id" type="new_id" interface="zxdg_output_v1"/>
|
||||
<arg name="output" type="object" interface="wl_output"/>
|
||||
</request>
|
||||
</interface>
|
||||
|
||||
<interface name="zxdg_output_v1" version="3">
|
||||
<description summary="compositor logical output region">
|
||||
An xdg_output describes part of the compositor geometry.
|
||||
|
||||
This typically corresponds to a monitor that displays part of the
|
||||
compositor space.
|
||||
|
||||
For objects version 3 onwards, after all xdg_output properties have been
|
||||
sent (when the object is created and when properties are updated), a
|
||||
wl_output.done event is sent. This allows changes to the output
|
||||
properties to be seen as atomic, even if they happen via multiple events.
|
||||
</description>
|
||||
|
||||
<request name="destroy" type="destructor">
|
||||
<description summary="destroy the xdg_output object">
|
||||
Using this request a client can tell the server that it is not
|
||||
going to use the xdg_output object anymore.
|
||||
</description>
|
||||
</request>
|
||||
|
||||
<event name="logical_position">
|
||||
<description summary="position of the output within the global compositor space">
|
||||
The position event describes the location of the wl_output within
|
||||
the global compositor space.
|
||||
|
||||
The logical_position event is sent after creating an xdg_output
|
||||
(see xdg_output_manager.get_xdg_output) and whenever the location
|
||||
of the output changes within the global compositor space.
|
||||
</description>
|
||||
<arg name="x" type="int"
|
||||
summary="x position within the global compositor space"/>
|
||||
<arg name="y" type="int"
|
||||
summary="y position within the global compositor space"/>
|
||||
</event>
|
||||
|
||||
<event name="logical_size">
|
||||
<description summary="size of the output in the global compositor space">
|
||||
The logical_size event describes the size of the output in the
|
||||
global compositor space.
|
||||
|
||||
For example, a surface without any buffer scale, transformation
|
||||
nor rotation set, with the size matching the logical_size will
|
||||
have the same size as the corresponding output when displayed.
|
||||
|
||||
Most regular Wayland clients should not pay attention to the
|
||||
logical size and would rather rely on xdg_shell interfaces.
|
||||
|
||||
Some clients such as Xwayland, however, need this to configure
|
||||
their surfaces in the global compositor space as the compositor
|
||||
may apply a different scale from what is advertised by the output
|
||||
scaling property (to achieve fractional scaling, for example).
|
||||
|
||||
For example, for a wl_output mode 3840×2160 and a scale factor 2:
|
||||
|
||||
- A compositor not scaling the surface buffers will advertise a
|
||||
logical size of 3840×2160,
|
||||
|
||||
- A compositor automatically scaling the surface buffers will
|
||||
advertise a logical size of 1920×1080,
|
||||
|
||||
- A compositor using a fractional scale of 1.5 will advertise a
|
||||
logical size to 2560×1620.
|
||||
|
||||
For example, for a wl_output mode 1920×1080 and a 90 degree rotation,
|
||||
the compositor will advertise a logical size of 1080x1920.
|
||||
|
||||
The logical_size event is sent after creating an xdg_output
|
||||
(see xdg_output_manager.get_xdg_output) and whenever the logical
|
||||
size of the output changes, either as a result of a change in the
|
||||
applied scale or because of a change in the corresponding output
|
||||
mode(see wl_output.mode) or transform (see wl_output.transform).
|
||||
</description>
|
||||
<arg name="width" type="int"
|
||||
summary="width in global compositor space"/>
|
||||
<arg name="height" type="int"
|
||||
summary="height in global compositor space"/>
|
||||
</event>
|
||||
|
||||
<event name="done">
|
||||
<description summary="all information about the output have been sent">
|
||||
This event is sent after all other properties of an xdg_output
|
||||
have been sent.
|
||||
|
||||
This allows changes to the xdg_output properties to be seen as
|
||||
atomic, even if they happen via multiple events.
|
||||
|
||||
For objects version 3 onwards, this event is deprecated. Compositors
|
||||
are not required to send it anymore and must send wl_output.done
|
||||
instead.
|
||||
</description>
|
||||
</event>
|
||||
|
||||
<!-- Version 2 additions -->
|
||||
|
||||
<event name="name" since="2">
|
||||
<description summary="name of this output">
|
||||
Many compositors will assign names to their outputs, show them to the
|
||||
user, allow them to be configured by name, etc. The client may wish to
|
||||
know this name as well to offer the user similar behaviors.
|
||||
|
||||
The naming convention is compositor defined, but limited to
|
||||
alphanumeric characters and dashes (-). Each name is unique among all
|
||||
wl_output globals, but if a wl_output global is destroyed the same name
|
||||
may be reused later. The names will also remain consistent across
|
||||
sessions with the same hardware and software configuration.
|
||||
|
||||
Examples of names include 'HDMI-A-1', 'WL-1', 'X11-1', etc. However, do
|
||||
not assume that the name is a reflection of an underlying DRM
|
||||
connector, X11 connection, etc.
|
||||
|
||||
The name event is sent after creating an xdg_output (see
|
||||
xdg_output_manager.get_xdg_output). This event is only sent once per
|
||||
xdg_output, and the name does not change over the lifetime of the
|
||||
wl_output global.
|
||||
</description>
|
||||
<arg name="name" type="string" summary="output name"/>
|
||||
</event>
|
||||
|
||||
<event name="description" since="2">
|
||||
<description summary="human-readable description of this output">
|
||||
Many compositors can produce human-readable descriptions of their
|
||||
outputs. The client may wish to know this description as well, to
|
||||
communicate the user for various purposes.
|
||||
|
||||
The description is a UTF-8 string with no convention defined for its
|
||||
contents. Examples might include 'Foocorp 11" Display' or 'Virtual X11
|
||||
output via :1'.
|
||||
|
||||
The description event is sent after creating an xdg_output (see
|
||||
xdg_output_manager.get_xdg_output) and whenever the description
|
||||
changes. The description is optional, and may not be sent at all.
|
||||
|
||||
For objects of version 2 and lower, this event is only sent once per
|
||||
xdg_output, and the description does not change over the lifetime of
|
||||
the wl_output global.
|
||||
</description>
|
||||
<arg name="description" type="string" summary="output description"/>
|
||||
</event>
|
||||
|
||||
</interface>
|
||||
</protocol>
|
||||
Loading…
Reference in New Issue
Block a user