Constructs a new QPlatformScreen.

Destroys the current QPlatformScreen.

Additional documentation pending.

Reimplement in subclass to return the pixel geometry of the available space This normally is the desktop screen minus the task manager, global menubar etc.

Reimplement this function in subclass to return the cursor of the screen. The default implementation returns a nullptr.

Reimplement in subclass to return current depth of the screen.

Additional documentation pending.

Reimplement this function in subclass to return the device pixel ratio for the screen. This is the ratio between physical pixels and the device-independent pixels of the windowing system. The default implementation returns 1.0.

See also

QPlatformWindow::devicePixelRatio(), QPlatformScreen::pixelDensity()

Reimplement in subclass to return the image format which corresponds to the screen format

Reimplement in subclass to return the pixel geometry of the screen

This method is called when CopperSpice needs to grab the content of a window. Returns the content of the window specified with the WId handle within the boundaries of QRect(x, y, width, height).

Reimplement this function in subclass to return the logical horizontal and vertical dots per inch metrics of the screen.

The logical dots per inch metrics are used by QFont to convert point sizes to pixel sizes. The default implementation uses the screen pixel size and physical size to compute the metrics.

See also

physicalSize

Additional documentation pending.

Additional documentation pending.

Reimplement this method in a subclass to return the native orientation of the screen, e.g. the orientation where the logo sticker of the device appears the right way up.

The default implementation returns Qt::PrimaryOrientation.

Reimplement this method in a subclass to return the current orientation of the screen, for example based on accelerometer data to determine the device orientation.

The default implementation returns Qt::PrimaryOrientation.

Reimplement this function in subclass to return the physical size of the screen, in millimeters. The physical size represents the actual physical dimensions of the display.

The default implementation takes the pixel size of the screen, considers a resolution of 100 dots per inch, and returns the calculated physical size. A device with a screen that has different resolutions will need to be supported by a suitable reimplementation of this function.

See also

logicalDpi

Reimplement this function in subclass to return the pixel density of the screen. This is the scale factor needed to make a low DPI application usable on this screen. The default implementation returns 1.0.

Returning something else than 1.0 from this function causes CopperSpice to apply the scale factor to the application's coordinate system. This is different from devicePixelRatio, which reports a scale factor already applied by the windowing system. A platform plugin typically implements one (or none) of these two functions.

See also

QPlatformWindow::devicePixelRatio()

Additional documentation pending.

Returns the current power state. The default implementation always returns PowerStateOn.

Reimplement in subclass to return the vertical refresh rate of the screen, in Hz. The default returns 60, a sensible default for modern displays.

Convenience method to resize all the maximized and fullscreen windows of this platform screen.

Additional documentation pending.

Find the sibling screen corresponding to point. Returns this screen if no suitable screen is found at the position.

Reimplement in subclass to filter out unneeded screen orientation updates.

The orientations will anyway be filtered before QScreen::orientationChanged() is emitted, but the mask can be used by the platform plugin for example to prevent having to have an accelerometer sensor running all the time, or to improve the reported values. As an example of the latter, in case of only Landscape | InvertedLandscape being set in the mask, on a platform that gets its orientation readings from an accelerometer sensor embedded in a handheld device, the platform can report transitions between the two even when the device is held in an orientation that's closer to portrait.

By default the orientation update mask is empty, so unless this function has been called with a non-empty mask the platform does not need to report any orientation updates through QWindowSystemInterface::handleScreenOrientationChange().

Sets the state for this screen.

Returns a hint about this screen's subpixel layout structure. The default implementation queries the QT_SUBPIXEL_AA_TYPE environment variable. This is just a hint because most platforms do not have a way to retrieve the correct value from hardware and instead rely on font configurations.

Returns the given top level window for a given position. Default implementation retrieves a list of all top level windows and finds the first window which contains point.

Additional documentation pending.

Returns a list of all the platform screens that are part of the same virtual desktop. Screens part of the same virtual desktop share a common coordinate system, and windows can be freely moved between them.