diff options
author | der richter <der.richter@gmx.de> | 2024-04-20 15:21:31 +0200 |
---|---|---|
committer | der richter <der.richter@gmx.de> | 2024-04-24 20:35:38 +0200 |
commit | f7a32b5f29c062cf2d3210eb769f9843d5364331 (patch) | |
tree | 1470c88fa320cf4cf2d508346d06a3663d34c81f /DOCS/man | |
parent | afae94cfbd375f90859aa77077ecf150ae96ee81 (diff) | |
download | mpv-f7a32b5f29c062cf2d3210eb769f9843d5364331.tar.bz2 mpv-f7a32b5f29c062cf2d3210eb769f9843d5364331.tar.xz |
mac: make display-names unique to allow specific selection
the Screen property localizedName returns a none unique dynamic name
that doesn't allow a specific selection of a Screen on every OS boot.
the name consists of the vendor name and model name (eg DELL U2723QE).
if the same model display is connected to the system several times,
macOS starts to add numbers to the localizedName (eg DELL U2723QE (1)),
that may not be associated to the same Screen on every OS boot or
connecting the display. it also changes the name of the first connected
display by adding that numeration. this makes it impossible specify the
proper screen with the screen-name option every time.
to circumvent this we remove the enumeration from the name and instead
add the serial number to the display-names property. this makes the
actual Screen unique and none dynamic. furthermore the selection of a
screen by name will check for equality for the old localizedName, simple
name without enumeration, serial number and the combined name with
serial number. this makes it possible to select the screen by either of
those names and identifiers, and keeps backwards compatibility with the
old behaviour.
Examples:
localized name (System Settings name): DELL U2723QE, DELL U2723QE (1)
simple name: DELL U2723QE
serial number: 123456789
combined name: DELL U2723QE (123456789)
Diffstat (limited to 'DOCS/man')
-rw-r--r-- | DOCS/man/input.rst | 10 |
1 files changed, 5 insertions, 5 deletions
diff --git a/DOCS/man/input.rst b/DOCS/man/input.rst index f9fa59121d..67e545fbd1 100644 --- a/DOCS/man/input.rst +++ b/DOCS/man/input.rst @@ -2711,11 +2711,11 @@ Property list are the GDI names (\\.\DISPLAY1, \\.\DISPLAY2, etc.) and the first display in the list will be the one that Windows considers associated with the window (as determined by the MonitorFromWindow API.) On macOS these are the - Display Product Names as used in the System Information and only one display - name is returned since a window can only be on one screen. On Wayland, these - are the wl_output names if protocol version >= 4 is used - (LVDS-1, HDMI-A-1, X11-1, etc.), or the wl_output model reported by the - geometry event if protocol version < 4 is used. + Display Product Names as used in the System Information with a serial number + in brackets and only one display name is returned since a window can only be + on one screen. On Wayland, these are the wl_output names if protocol + version >= 4 is used (LVDS-1, HDMI-A-1, X11-1, etc.), or the wl_output model + reported by the geometry event if protocol version < 4 is used. ``display-fps`` The refresh rate of the current display. Currently, this is the lowest FPS |