A display represents the physical display hardware such as a monitor or touch screen 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 the the correct context.