Doc: more details about initialisation of display scale factors.

This commit is contained in:
ManoloFLTK 2020-03-26 06:29:25 +01:00
parent abe1c4f7c0
commit 89449280dc
2 changed files with 18 additions and 1 deletions

View File

@ -70,7 +70,10 @@ to two pixels.
</ul> </ul>
At application start time, FLTK attempts to detect the adequate scale factor value for At application start time, FLTK attempts to detect the adequate scale factor value for
each screen of the system. If this attempt fails, it's possible to set the each screen of the system. Here is how that's done under the \ref osissues_x_scaling "X11"
and \ref osissues_windows_scaling "Windows" platforms.
If the resulting scale factor is not satisfactory, and also under the macOS platform,
it's possible to set the
<tt>FLTK_SCALING_FACTOR</tt> environmental variable to the desired numerical value <tt>FLTK_SCALING_FACTOR</tt> environmental variable to the desired numerical value
(e.g., 1.75) and any FLTK app will start scaled with that value. Furthermore, (e.g., 1.75) and any FLTK app will start scaled with that value. Furthermore,
it's possible to change the scale factor value of any screen at run time it's possible to change the scale factor value of any screen at run time

View File

@ -474,6 +474,12 @@ the class "fltk" is used (e.g. <tt>fltk.background</tt>). If no
match is found, a global search is done (e.g. match is found, a global search is done (e.g.
<tt>*background</tt>). <tt>*background</tt>).
\subsection osissues_x_scaling Dislay Scaling Factor
FLTK uses the value of the Xft.dpi resource divided by 96.
to initialize the display scaling factor. That is also
what is done by the gnome and KDE desktops.
\section osissues_win32 The Windows Interface \section osissues_win32 The Windows Interface
The Windows interface provides access to the Windows GDI The Windows interface provides access to the Windows GDI
@ -577,6 +583,14 @@ DrawSomething(fl_gc, ..., fl_brush());
It may also be useful to refer to Fl_Window::current() It may also be useful to refer to Fl_Window::current()
to get the window's size or position. to get the window's size or position.
\subsection osissues_windows_scaling Dislay Scaling Factor
FLTK uses the value given by function GetDpiForMonitor() divided by 96.
to initialize the scaling factor of each display in the system.
This matches the value of
"Change the size of text, apps and other items" found in section
"System" subsection "Display" of Windows settings.
\subsection osissues_icon_windows Setting the Icon of a Window \subsection osissues_icon_windows Setting the Icon of a Window
FLTK currently supports setting a window's icon *before* it FLTK currently supports setting a window's icon *before* it