ui: Remove deprecated parameters of -display sdl and switch to QAPI parser
PATCH 1/1 ui: Remove deprecated parameters of -display sdl and switch to QAPI parser
The "-display sdl" option still used a hand-crafted parser for its parameters since some of them used underscores which is forbidden in QAPI. Now that they've been deprecated and the deprecation period is over, we can remove the problematic parameters and switch to use the QAPI parser instead.
--- docs/about/deprecated.rst | 16 ----- docs/about/removed-features.rst | 17 +++++ qapi/ui.json | 16 ++++- include/sysemu/sysemu.h | 2 - softmmu/globals.c | 2 - softmmu/vl.c | 109 +------------------------------- ui/sdl2.c | 13 ++++ qemu-options.hx | 32 +--------- 8 files changed, 48 insertions(+), 159 deletions(-)
docs/about/deprecated.rst +0 -16
@@ -109,22 +109,6 @@ other options have been processed. This will either have no effect (if if they were not given. The property is therefore useless and should not be specified. -``-display sdl,window_close=...`` (since 6.1) -''''''''''''''''''''''''''''''''''''''''''''' - -Use ``-display sdl,window-close=...`` instead (i.e. with a minus instead of -an underscore between "window" and "close"). - -``-alt-grab`` and ``-display sdl,alt_grab=on`` (since 6.2) -'''''''''''''''''''''''''''''''''''''''''''''''''''''''''' - -Use ``-display sdl,grab-mod=lshift-lctrl-lalt`` instead. - -``-ctrl-grab`` and ``-display sdl,ctrl_grab=on`` (since 6.2) -'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' - -Use ``-display sdl,grab-mod=rctrl`` instead. - ``-sdl`` (since 6.2) ''''''''''''''''''''
docs/about/removed-features.rst +17 -0
@@ -355,6 +355,23 @@ The ``-writeconfig`` option was not able to serialize the entire contents of the QEMU command line. It is thus considered a failed experiment and removed without a replacement. +``-display sdl,window_close=...`` (removed in 7.1) +'''''''''''''''''''''''''''''''''''''''''''''''''' + +Use ``-display sdl,window-close=...`` instead (i.e. with a minus instead of +an underscore between "window" and "close"). + +``-alt-grab`` and ``-display sdl,alt_grab=on`` (removed in 7.1) +''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' + +Use ``-display sdl,grab-mod=lshift-lctrl-lalt`` instead. + +``-ctrl-grab`` and ``-display sdl,ctrl_grab=on`` (removed in 7.1) +''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' + +Use ``-display sdl,grab-mod=rctrl`` instead. + + QEMU Machine Protocol (QMP) commands ------------------------------------
qapi/ui.json +15 -1
@@ -1309,6 +1309,19 @@ '*swap-opt-cmd': 'bool' } } +## +# @DisplaySDL: +# +# SDL2 display options. +# +# @grab-mod: Modifier keys that should be pressed together +# with "G" to release the mouse grab. +# +# Since: 7.1 +## +{ 'struct' : 'DisplaySDL', + 'data' : { '*grab-mod' : 'str' } } + ## # @DisplayType: #
@@ -1391,7 +1404,8 @@ 'curses': { 'type': 'DisplayCurses', 'if': 'CONFIG_CURSES' }, 'egl-headless': { 'type': 'DisplayEGLHeadless', 'if': { 'all': ['CONFIG_OPENGL', 'CONFIG_GBM'] } }, - 'dbus': { 'type': 'DisplayDBus', 'if': 'CONFIG_DBUS_DISPLAY' } + 'dbus': { 'type': 'DisplayDBus', 'if': 'CONFIG_DBUS_DISPLAY' }, + 'sdl': { 'type': 'DisplaySDL', 'if': 'CONFIG_SDL' } } }
include/sysemu/sysemu.h +0 -2
@@ -42,8 +42,6 @@ extern int graphic_depth;extern int display_opengl;extern const char *keyboard_layout;extern int win2k_install_hack; -extern int alt_grab; -extern int ctrl_grab;extern int graphic_rotate;extern int old_param;extern int boot_menu;
softmmu/globals.c +0 -2
@@ -50,8 +50,6 @@ QEMUOptionRom option_rom[MAX_OPTION_ROMS];int nb_option_roms;int old_param;const char *qemu_name; -int alt_grab; -int ctrl_grab;unsigned int nb_prom_envs;const char *prom_envs[MAX_PROM_ENVS ];int boot_menu;
softmmu/vl.c +1 -108
127 lines not on this page · raw message
ui/sdl2.c +13 -0
@@ -40,6 +40,8 @@ static struct sdl2_console *sdl2_console;static SDL_Surface *guest_sprite_surface;static int gui_grab;/* if true, all keyboard/mouse events are grabbed */ +static bool alt_grab; +static bool ctrl_grab;static int gui_saved_grab;static int gui_fullscreen;
@@ -853,6 +855,17 @@ static void sdl2_display_init(DisplayState *ds, DisplayOptions *o) gui_fullscreen = o->has_full_screen && o->full_screen; +if (o->u.sdl.has_grab_mod) { +if (g_str_equal (o->u.sdl.grab_mod,"lshift-lctrl-lalt" )) { + alt_grab = true; + }else if (g_str_equal (o->u.sdl.grab_mod,"rctrl" )) { + ctrl_grab = true; + }else { +error_report ("Unsupported grab-mod: %s" , o->u.sdl.grab_mod); +exit (1 ); + } + } +for (i =0 ;; i++) {QemuConsole *con =qemu_console_lookup_by_index (i);if (!con) {
qemu-options.hx +2 -30
@@ -1903,8 +1903,8 @@ DEF("display", HAS_ARG, QEMU_OPTION_display, "-display spice-app[,gl=on|off]\n" #endif #if defined(CONFIG_SDL) - "-display sdl[,alt_grab=on|off][,ctrl_grab=on|off][,gl=on|core|es|off]\n" - " [,grab-mod=<mod>][,show-cursor=on|off][,window-close=on|off]\n" + "-display sdl[,gl=on|core|es|off][,grab-mod=<mod>][,show-cursor=on|off]\n" + " [,window-close=on|off]\n" #endif #if defined(CONFIG_GTK) "-display gtk[,full-screen=on|off][,gl=on|off][,grab-on-hover=on|off]\n"
@@ -1977,12 +1977,6 @@ SRST the mouse grabbing in conjunction with the "g" key. ``<mods>`` can be either ``lshift-lctrl-lalt`` or ``rctrl``. - ``alt_grab=on|off`` : Use Control+Alt+Shift-g to toggle mouse grabbing. - This parameter is deprecated - use ``grab-mod`` instead. - - ``ctrl_grab=on|off`` : Use Right-Control-g to toggle mouse grabbing. - This parameter is deprecated - use ``grab-mod`` instead. - ``gl=on|off|core|es`` : Use OpenGL for displaying ``show-cursor=on|off`` : Force showing the mouse cursor
@@ -2068,28 +2062,6 @@ SRST is displayed in graphical mode. ERST -DEF("alt-grab", 0, QEMU_OPTION_alt_grab, - "-alt-grab use Ctrl-Alt-Shift to grab mouse (instead of Ctrl-Alt)\n", - QEMU_ARCH_ALL) -SRST -``-alt-grab`` - Use Ctrl-Alt-Shift to grab mouse (instead of Ctrl-Alt). Note that - this also affects the special keys (for fullscreen, monitor-mode - switching, etc). This option is deprecated - please use - ``-display sdl,grab-mod=lshift-lctrl-lalt`` instead. -ERST - -DEF("ctrl-grab", 0, QEMU_OPTION_ctrl_grab, - "-ctrl-grab use Right-Ctrl to grab mouse (instead of Ctrl-Alt)\n", - QEMU_ARCH_ALL) -SRST -``-ctrl-grab`` - Use Right-Ctrl to grab mouse (instead of Ctrl-Alt). Note that this - also affects the special keys (for fullscreen, monitor-mode - switching, etc). This option is deprecated - please use - ``-display sdl,grab-mod=rctrl`` instead. -ERST - DEF("sdl", 0, QEMU_OPTION_sdl, "-sdl shorthand for -display sdl\n", QEMU_ARCH_ALL) SRST
Signature · 1 line
2.27.0
Quoted 5 lines · Thomas Huth
The "-display sdl" option still used a hand-crafted parser for its parameters since some of them used underscores which is forbidden in QAPI. Now that they've been deprecated and the deprecation period is over, we can remove the problematic parameters and switch to use the QAPI parser instead.
I'd say the removal of deprecated bits ought to be separate from the addition of new QAPI bits.
Quoted 10 lines
qapi/ui.json +2
-0@@ -1309,6 +1309,19 @@ '*swap-opt-cmd': 'bool' } } +## +# @DisplaySDL:
qapi/ui.json line 1323
Quoted 10 lines
qapi/ui.json +10
-0+# +# SDL2 display options. +# +# @grab-mod: Modifier keys that should be pressed together +# with "G" to release the mouse grab. +# +# Since: 7.1 +## +{ 'struct' : 'DisplaySDL', + 'data' : { '*grab-mod' : 'str' } }
So any arbitrary string here, but...
Quoted 17 lines
ui/sdl2.c +2
-0@@ -40,6 +40,8 @@ static struct sdl2_console *sdl2_console;static SDL_Surface *guest_sprite_surface;static int gui_grab;/* if true, all keyboard/mouse events are grabbed */ +static bool alt_grab; +static bool ctrl_grab;static int gui_saved_grab;static int gui_fullscreen;@@ -853,6 +855,17 @@ static void sdl2_display_init(DisplayState *ds, DisplayOptions *o) gui_fullscreen = o->has_full_screen && o->full_screen;
ui/sdl2.c static void sdl2_display_init(DisplayState *ds, DisplayOptions *o) · line 867
Quoted 10 lines
ui/sdl2.c +10
-0+if (o->u.sdl.has_grab_mod) { +if (g_str_equal (o->u.sdl.grab_mod,"lshift-lctrl-lalt" )) { + alt_grab = true; + }else if (g_str_equal (o->u.sdl.grab_mod,"rctrl" )) { + ctrl_grab = true; + }else { +error_report ("Unsupported grab-mod: %s" , o->u.sdl.grab_mod); +exit (1 ); + } + }
We're treating this more like an enum here. It does leave the door open for adding a generic parsing of arbitrary grab mods later I guess
With regards,
Daniel
Signature · 3 lines
|: https://berrange.com -o- https://www.flickr.com/photos/dberrange :| |: https://libvirt.org -o- https://fstop138.berrange.com :| |: https://entangle-photo.org -o- https://www.instagram.com/dberrange :|
Quoted 9 lines · Daniel P. Berrangé
Quoted 5 lines · Thomas Huth
The "-display sdl" option still used a hand-crafted parser for its parameters since some of them used underscores which is forbidden in QAPI. Now that they've been deprecated and the deprecation period is over, we can remove the problematic parameters and switch to use the QAPI parser instead.
I'd say the removal of deprecated bits ought to be separate from the addition of new QAPI bits.
Ok, agreed, that likely makes sense.
Quoted 41 lines
Quoted 11 lines
qapi/ui.json +2
-0@@ -1309,6 +1309,19 @@ '*swap-opt-cmd': 'bool' } } +## +# @DisplaySDL:qapi/ui.json line 1323
Quoted 10 lines
qapi/ui.json +10
-0+# +# SDL2 display options. +# +# @grab-mod: Modifier keys that should be pressed together +# with "G" to release the mouse grab. +# +# Since: 7.1 +## +{ 'struct' : 'DisplaySDL', + 'data' : { '*grab-mod' : 'str' } }So any arbitrary string here, but...
Quoted 17 lines
ui/sdl2.c +2
-0@@ -40,6 +40,8 @@ static struct sdl2_console *sdl2_console;static SDL_Surface *guest_sprite_surface;static int gui_grab;/* if true, all keyboard/mouse events are grabbed */ +static bool alt_grab; +static bool ctrl_grab;static int gui_saved_grab;static int gui_fullscreen;@@ -853,6 +855,17 @@ static void sdl2_display_init(DisplayState *ds, DisplayOptions *o) gui_fullscreen = o->has_full_screen && o->full_screen;
Quoted 14 lines
ui/sdl2.c static void sdl2_display_init(DisplayState *ds, DisplayOptions *o) · line 867
Quoted 10 lines
ui/sdl2.c +10
-0+if (o->u.sdl.has_grab_mod) { +if (g_str_equal (o->u.sdl.grab_mod,"lshift-lctrl-lalt" )) { + alt_grab = true; + }else if (g_str_equal (o->u.sdl.grab_mod,"rctrl" )) { + ctrl_grab = true; + }else { +error_report ("Unsupported grab-mod: %s" , o->u.sdl.grab_mod); +exit (1 ); + } + }We're treating this more like an enum here. It does leave the door open for adding a generic parsing of arbitrary grab mods later I guess
Yes, that's the basic idea - so one day, the user might specify an arbitrary string here consisting of their favorite modifiers.
Thomas