Amebis/wxWidgets
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Fix table of contents generation for high DPI overview

Browse Source 
Add the required anchors, just the headers are not taken into account
for TOC generation.
This commit is contained in:
Vadim Zeitlin
2022-01-13 04:24:53 +01:00
parent caec339bc1
commit c1532c8d3c
1 changed files with 9 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
docs/doxygen/overviews/high_dpi.md
View File

@@ -2,7 +2,7 @@ High DPI Support in wxWidgets {#overview_high_dpi}
============================= =============================
[TOC] [TOC]
Introduction Introduction {#high_dpi_intro}
============ ============
Many modern displays have way more pixels on the same surface than used to be Many modern displays have way more pixels on the same surface than used to be
@@ -50,10 +50,10 @@ on high DPI displays is needed: one which allows to scale some pixel values
drawing, which should remain unscaled to use the full available resolution). drawing, which should remain unscaled to use the full available resolution).
Pixel Values in wxWidgets Pixel Values in wxWidgets {#high_dpi_pixel_types}
========================= =========================
Logical and Device-Independent Pixels Logical and Device-Independent Pixels {#high_dpi_lp_and_dip}
------------------------------------- -------------------------------------
Some systems like eg Apple's OSes automatically scale all the coordinates by Some systems like eg Apple's OSes automatically scale all the coordinates by
@@ -97,7 +97,7 @@ must be in logical pixels that can depend on the current DPI scaling, and so
should never be fixed at compilation time. should never be fixed at compilation time.
Physical Pixels Physical Pixels {#high_dpi_pp}
--------------- ---------------
In addition to (logical) pixels and DIPs discussed above, you may also need to In addition to (logical) pixels and DIPs discussed above, you may also need to
@@ -121,7 +121,7 @@ pixels first, but you can also do it directly, by using
wxWindow::GetDPIScaleFactor(). This function can return a value different from wxWindow::GetDPIScaleFactor(). This function can return a value different from
1 even under MSW, i.e. it returns DPI scaling for physical display pixels. 1 even under MSW, i.e. it returns DPI scaling for physical display pixels.
Summary of Different Pixel Kinds Summary of Different Pixel Kinds {#high_dpi_pixel_conversions}
-------------------------------- --------------------------------
Under MSW, logical pixels are always the same as physical pixels, but are Under MSW, logical pixels are always the same as physical pixels, but are
@@ -154,7 +154,7 @@ digraph Pixels
@enddot @enddot
High-Resolution Images and Artwork High-Resolution Images and Artwork {#high_dpi_artwork}
================================== ==================================
In order to benefit from the increased detail on High DPI devices you might want In order to benefit from the increased detail on High DPI devices you might want
@@ -168,7 +168,7 @@ sizes / resolutions.
[comment]: # (TODO: API and Use Cases) [comment]: # (TODO: API and Use Cases)
Platform-Specific Build Issues Platform-Specific Build Issues {#high_dpi_platform_specific}
============================== ==============================
Generally speaking, all systems handle applications not specifically marked as Generally speaking, all systems handle applications not specifically marked as
@@ -177,7 +177,7 @@ up, resulting in blurry graphics and fonts, but globally preserving the
application appearance. For the best results, the application needs to be application appearance. For the best results, the application needs to be
explicitly marked as DPI-aware in a platform-dependent way. explicitly marked as DPI-aware in a platform-dependent way.
MSW MSW {#high_dpi_platform_msw}
--- ---
The behaviour of the application when running on a high-DPI display depends on The behaviour of the application when running on a high-DPI display depends on
@@ -192,7 +192,7 @@ full, per-monitor DPI awareness supported by Windows 10 version 1703 or later.
[1]: https://docs.microsoft.com/en-us/windows/win32/sbscs/application-manifests [1]: https://docs.microsoft.com/en-us/windows/win32/sbscs/application-manifests
[2]: https://docs.microsoft.com/en-us/windows/win32/hidpi/high-dpi-desktop-application-development-on-windows [2]: https://docs.microsoft.com/en-us/windows/win32/hidpi/high-dpi-desktop-application-development-on-windows
macOS macOS {#high_dpi_platform_mac}
----- -----
DPI-aware applications must set their `NSPrincipalClass` to `wxNSApplication` DPI-aware applications must set their `NSPrincipalClass` to `wxNSApplication`