Screen Scaling Behavior

Screen Scaling is a result of the operating system, and outside of the control of Olive Helps, this page describe how this interdependency will affect some Aptitudes.

Windows

Note for workstations with multiple displays, the window coordinates will only be accurate on additional displays that are configured with the same Screen Scaling as the primary display.

Coordinate Systems:

Screen Coordinates:

X = the number of pixels from the left side of the screen. Y = the number of pixels from the top of the screen.

Logical Coordinates:

X = the number of pixels from the left side of the screen, scaled by the Screen Scaling, and offset by an invisible border (sometimes). Y = the number of pixels from the top side of the screen, scaled by the Screen Scaling, and offset by an invisible border (sometimes).

Client Coordinates:

X = the number of pixels from the left side of the window. Y = the number of pixels from the top side of the window.

MacOS

If a window is placed so that it spans multiple displays, MacOS only displays the window on the screen where the upper left corner of the window is present. Consequently, if the window region extends onto another monitor, it will not be visible, but the window system will still report it as present on that screen.

The fix here is to truncate the bounds reported by the OS for a window to fit within the bounds of the display that contains it. This will result in the reported bounds matching what is visible to the user.