core: improve DPI awareness & add docs #1102

New issue

Open

opened 2023-11-05 04:57:57 +00:00 by emidoots · 2 comments

emidoots commented

2023-11-05 04:57:57 +00:00

(Migrated from github.com)

Today mach-core provides:

Framebuffer size in pixels (arbitrary units)
Window size in pixels (arbitrary units)
A guarantee that framebuffer size is always >= window size.

Example A: on a non-retina/HDPI display, the framebuffer size and window size may be the same.
Example B: on a retina/HDPI display, the framebuffer size may be twice the window size.

The following issues exist:

https://machengine.org/core should have documentation about how mach-core handles resolutions, DPI and Retina displays, etc.
on MacOS, today we always choose to have the framebuffer size match the actual native resolution (e.g. 2x the window size), see [0] [1], this should be made configurable.
on Windows, we currently do not have a way to opt-in to e.g. "Per-Monitor (V2) DPI Awareness"
on Linux, it is unclear how mach-core/GLFW behaves currently when using e.g. fractional scaling in gnome or similar.

Today mach-core provides: 1. Framebuffer size in pixels (arbitrary units) 2. Window size in pixels (arbitrary units) 3. A guarantee that framebuffer size is always >= window size. * Example A: on a non-retina/HDPI display, the framebuffer size and window size may be the same. * Example B: on a retina/HDPI display, the framebuffer size may be twice the window size. The following issues exist: * [ ] https://machengine.org/core should have documentation about how mach-core handles resolutions, DPI and Retina displays, etc. * [ ] on MacOS, today we always choose to have the framebuffer size match the actual native resolution (e.g. 2x the window size), see [[0]](https://github.com/hexops/mach-core/blob/cce02fb96ca787378289c5855b381f0ca9f3e090/src/platform/native/Core.zig#L156) [[1]](https://github.com/hexops/mach-core/blob/cce02fb96ca787378289c5855b381f0ca9f3e090/src/platform/native/Core.zig#L156), this should be made configurable. * [ ] on Windows, we currently do not have a way to opt-in to e.g. ["Per-Monitor (V2) DPI Awareness"](https://learn.microsoft.com/en-us/windows/win32/hidpi/high-dpi-desktop-application-development-on-windows) * [ ] on Linux, it is unclear how mach-core/GLFW behaves currently when using e.g. fractional scaling in gnome or similar.

Rows
Columns