diff options
author | Laszlo Agocs <laszlo.agocs@qt.io> | 2017-01-12 14:11:52 +0100 |
---|---|---|
committer | Laszlo Agocs <laszlo.agocs@qt.io> | 2017-01-16 12:20:27 +0000 |
commit | 44cdb4add08f558eedf60600df44121909c1529a (patch) | |
tree | b90af155864e2e8c7ec95ceea0b2e70d94809254 | |
parent | 5925021385abd8a45b620bdba121d84e27132265 (diff) |
Document the primary property for KMS screen config
Change-Id: Ibad259708c04bc011afc8ad97f57fd575ba7c093
Reviewed-by: Topi Reiniƶ <topi.reinio@qt.io>
-rw-r--r-- | doc/src/platforms/emb-linux.qdoc | 20 |
1 files changed, 20 insertions, 0 deletions
diff --git a/doc/src/platforms/emb-linux.qdoc b/doc/src/platforms/emb-linux.qdoc index 319e8be6d..a07b45235 100644 --- a/doc/src/platforms/emb-linux.qdoc +++ b/doc/src/platforms/emb-linux.qdoc @@ -731,6 +731,26 @@ not knowing about multiple screens and relying solely on the first screen's values. + Each active output from the \c outputs array corresponds to one QScreen + instance reported from QGuiApplication::screens(). The primary screen reported + by QGuiApplication::primaryScreen() is by default the screen that gets + registered first. When not using \c virtualIndex, this means the decision is + based on the DRM connector order. To override this, set the property + \c primary to \c true on the desired entry in the \c outputs list. For example, + to ensure the screen corresponding to the VGA output will be the primary even + when the system happens to report the HDMI one first, one can do the following: + + \badcode + { + "device": "/dev/dri/card0", + "outputs": [ + { "name": "HDMI1" }, + { "name": "VGA1", "mode": "1280x720", "primary": true }, + { "name": "LVDS1", "mode": "off" } + ] + } + \endcode + For troubleshooting it might be useful to enable debug logs from the KMS/DRM backend. To do this, enable the categorized logging rule, \c qt.qpa.eglfs.kms. |