From 2397c22d696aace2a7f88dd4cd1f7e8a8af1133c Mon Sep 17 00:00:00 2001 From: Laszlo Agocs Date: Tue, 23 Jun 2015 15:18:27 +0200 Subject: Document the physical screen size override in settings Task-number: QTEE-949 Change-Id: I09ec569e83a7602e25271360345c071a2efc8f18 Reviewed-by: Rainer Keller Reviewed-by: Kalle Viironen --- src/doc/src/qtee-customization.qdoc | 14 ++++++++++++++ 1 file changed, 14 insertions(+) (limited to 'src/doc/src') diff --git a/src/doc/src/qtee-customization.qdoc b/src/doc/src/qtee-customization.qdoc index fa3186c..272bc07 100644 --- a/src/doc/src/qtee-customization.qdoc +++ b/src/doc/src/qtee-customization.qdoc @@ -184,6 +184,20 @@ For more information, see the Raspberry Pi documentation on \l{http://www.raspberrypi.org/documentation/configuration/config-txt.md}{config.txt}. + \section1 Configuring the physical screen size for scalable user interfaces + + The \e {\B2Q demo launcher} and Qt Quick Controls scale automatically to screens of + different sizes, from 7" touchscreens to 60" or larger TVs to ensure readability and + touch friendliness. For this, Qt has to know the physical dimensions of the screen. By + default it tries to query these values from the framebuffer devices. Many kernel + drivers do not provide this information, however. + + To override and manually set a desired screen size, go the Launcher Settings view and + check the \e {Override physical screen size} checkbox. Adjust the slider to the + desired size. The aspect ratio is assumed to be 16:9. Then tap the reboot button or + restart your application. The controls will adjust their sizes based on the new + settings. + \section1 Switching Between Portrait and Landscape Views Depending on device screen dimensions and application requirements, it might -- cgit v1.2.3