summaryrefslogtreecommitdiffstats
path: root/DOCS/man
diff options
context:
space:
mode:
authorder richter <der.richter@gmx.de>2024-04-20 15:21:31 +0200
committerder richter <der.richter@gmx.de>2024-04-24 20:35:38 +0200
commitf7a32b5f29c062cf2d3210eb769f9843d5364331 (patch)
tree1470c88fa320cf4cf2d508346d06a3663d34c81f /DOCS/man
parentafae94cfbd375f90859aa77077ecf150ae96ee81 (diff)
downloadmpv-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.rst10
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