Displays

A display represents the physical display hardware such as a monitor or touchscreen display.

You can use display API functions to:

query and set display properties
get display modes that are specific to a given hardware display
perform vsync operations

Note that to have full access to the display properties of the system, you must be working within a privileged context. You create a privileged context by calling the function screen_create_context() with a context type of SCREEN_DISPLAY_MANAGER_CONTEXT. Your process must have an effective user ID of root to be able to create this context type. Some API functions will fail to execute if you are not using the correct context.