Home
QNX Software Development Platform
QNX SDP is a cross-compiling and debugging environment, including an IDE and command-line tools, for building binary images and programs for target boards running QNX Neutrino 7.1.
Audio & Graphics API
Screen Graphics Subsystem Developer's Guide
QNX Screen Graphics Subsystem is a graphics framework that provides all the functionality necessary to develop interactive user experiences.
Screen library reference
Two important aspects to note when using Screen are function safety and function execution types.
Displays (screen.h)
A display refers to a physical device, such as a touchscreen, that presents images to viewers. Use this handle to gain access to display properties (e.g., brightness, DPI, video mode).
screen_display_mode_t
A structure to contain values related to Screen display mode

QNX Momentics IDE User's Guide
This User's Guide describes version 7.1 of the Integrated Development Environment (IDE) that's part of the QNX Momentics tool suite.
QNX Software Development Platform
QNX SDP is a cross-compiling and debugging environment, including an IDE and command-line tools, for building binary images and programs for target boards running QNX Neutrino 7.1.
- Quickstart Guide
- OS Components & Operations
- Audio & Graphics API
  - Audio Developer's Guide
    The Audio Developer's Guide is intended for developers who want to write audio applications using the QNX Sound Architecture (QSA) drivers and library.
  - Gestures Library Reference
    The Gestures library provides gesture recognizers to detect gestures through touch events that occur when you place one or more fingers on a touch screen.
  - Image Library Reference
  - Input Events Library Reference
    The Input Events library provides the framework necessary for Screen Graphics Subsystem to communicate with your touch driver.
  - OpenWF Configuration Developer's Guide
    If you are integrating a new display, you must configure and provide the parameters of your display based on its specifications via the OpenWF Display Configuration API (Wfdcfg Library).
  - Screen Graphics Subsystem Developer's Guide
    QNX Screen Graphics Subsystem is a graphics framework that provides all the functionality necessary to develop interactive user experiences.
    - Application Development
      The Screen Graphics Subsystem is based on a client/server model where an application is a client that's requesting graphics services from the server (Screen). It includes a composited windowing system as one of these services, which means all application rendering is performed on off-screen buffers, which then can be later used to update the display.
    - Buffers
      A buffer is an area of memory that stores pixel data. Multiple buffers can be associated with a window or stream, but only one buffer can be associated with a pixmap.
    - Rendering
      Rendering refers to the generation of an image.
    - Windowing
      Windows are used to display content and to combine content produced by different renderers. Each of the different renderers can be in the same process, or in another process or processes.
    - Resource Sharing
      Resource sharing allows the access of buffers and their content within the same application and process, or between different applications and processes.
    - Displaying the contents of windows
      Displays are used to show the contents of your windows on physical hardware such as a computer monitor or a touchscreen display.
    - Input
      One key aspect of Screen that enables the development of fully interactive user experiences is the functionality to support input events and to deliver input and notifications back to applications.
    - Event Handling
      Screen events, which include both input and general events, are associated with a given context and are generally handled in your main application's loop.
    - Asynchronous Notifications
      Applications can request to be asynchronously notified of specific Screen events by way of a sigevent.
    - Permissions and Privileges
      Permissions and privileges together determine the level of access to API objects (e.g., windows and sessions).
    - Security policies
      This section on Screen security policies is intended for system integrators who are responsible for implementing and enforcing security policies that create and maintain a trusted execution environment.
    - Utilities and binaries
      Screen includes some utilities and binaries to help with calibration, debugging, and demonstrating features.
    - Debugging
      Debugging graphics isn't easy. Figuring out where the problem is can be challenging because of the many aspects and components when it comes to graphics. The goal of this chapter is to show the tools and techniques that you can use to help with your investigation.
    - Screen library reference
      Two important aspects to note when using Screen are function safety and function execution types.
      - Function safety
        Function safety refers to whether or not it's safe to use the Screen API functions in certain situations.
      - Function types
        The tables in this section list the type of each function, where the type indicates the expected timeliness of each function call.
      - General (screen.h)
        Constants and Datatypes that are applicable to multiple Screen API objects.
      - Platform-specific APIs (screen_ext.h)
        This section covers extended Screen API functions.
      - Blits (screen.h)
        Blit APIs are native rendering APIs that use the hardware blitter to move data from one area of memory to another without involving the CPU.
      - Buffers (screen.h)
        A buffer is an area of memory that stores pixel data. Although a buffer can be created in the scope of a context, it can't be used by Screen unless it's attached to a window, stream, or pixmap. Multiple buffers can be associated with a window or stream, but only one buffer can be associated with a pixmap.
      - Contexts (screen.h)
        A context provides the setting for graphics operations within Screen. All Screen API objects, with the exception of events, are created within the scope of a context and access to these objects is always with respect to the context associated with the object. Through a handle to a context, you can identify and access specific Screen API objects (e.g., windows, groups, displays, pixmaps) to set or change their properties.
      - Debugging (screen.h)
        Screen provides statistics that can be enabled to facilitate debugging your applications.
      - Devices (screen.h)
        A device refers to an input device (e.g., keyboard, mouse, joystick, multi-touch display).
      - Displays (screen.h)
        A display refers to a physical device, such as a touchscreen, that presents images to viewers. Use this handle to gain access to display properties (e.g., brightness, DPI, video mode).
        Screen display metric counts
        Types of metric counts for displays
        Screen display mode types
        The screen mode types
        Screen display technology types
        Types of technologies for a display
        Screen display types
        Types of connections to a display
        screen_display_mode_t
        A structure to contain values related to Screen display mode
        screen_display_t
        A handle to the display (or displays) associated with the Screen context
        screen_get_display_modes()
        Retrieve the display modes supported by a specified display
        screen_get_display_property_cv()
        Retrieve the current value of the specified display property of type char
        screen_get_display_property_iv()
        Retrieve the current value of the specified display property of type integer
        screen_get_display_property_llv()
        Retrieve the current value of the specified display property of type long long integer
        screen_get_display_property_pv()
        Retrieve the current value of the specified display property of type void*
        screen_read_display()
        Take a screenshot of the display and store the resulting image in the specified buffer
        screen_set_display_property_cv()
        Set the value of the specified display property of type char
        screen_set_display_property_iv()
        Set the value of the specified display property of type integer
        screen_set_display_property_llv()
        Set the value of the specified display property of type long long integer
        screen_set_display_property_pv()
        Set the value of the specified display property of type void*
        screen_wait_vsync()
        Block the calling thread until the next vsync happens on the specified display
      - Events (screen.h)
        A Screen event notifies applications of actions such as window creations, properties changing values, and keyboard events. The Screen API manages one event queue per context. However, you can also create an event that's independent of any association with a context.
      - Groups (screen.h)
        A group is used to organize and manage multiple windows in your applications. Groups establish relationships between properties of the windows belonging to the same group; therefore applying changes to some properties of the group has an effect on all windows belonging to that group.
      - Pixmaps (screen.h)
        A pixmap is an off-screen rendering target. Its contents can be made visible by association with a window.
      - Sessions (screen.h)
        An input session (session) receives one specific type of input event. Unlike windows, sessions don't produce any graphical content and can't be placed into groups. The only grouping that could be considered for a session is the one that's been established for the window that the session is associated with.
      - Streams (screen.h)
        A stream allows graphical content to be produced and processed by components. With streams, it's not necessary to associate their content to a display. The content can be consumed by components other than Screen. However, these components can still use Screen to display the content.
      - Windows (screen.h)
        A window represents a drawing surface whose content is targeted to a display. There are multiple types of windows (e.g, application, child, embedded) to accommodate the organization of the content for display.
    - Configuring Screen
      You configure libraries, drivers, and Screen parameters using the configuration file, graphics.conf.
    - Glossary
  - Video Capture Developer's Guide
    The video capture framework provides applications the ability to capture frames from a video input source. These frames can be passed to a graphics component such as Screen for display.
- Multimedia
- Networking Middleware
- Programming
- Sensor Framework
- System Security Guide
  The QNX System Security Guide is intended for both system integrators who are responsible for the security of a QNX Neutrino RTOS system and developers who want to create a QNX Neutrino resource manager free from vulnerabilities.
- Utilities & Libraries
QNX Hypervisor
The QNX Hypervisor allows you to run multiple OSs on a target system so you can separate critical and non-critical functions, support a wide variety of applications, and reduce hardware costs.
QNX Software in the Cloud
QNX Software in the Cloud enables developers to use the QNX software in Amazon Web Services (AWS) and Microsoft Azure (Azure).
QNX Advanced Virtualization Frameworks User's Guide
This User's Guide is aimed at all systems integrators and developers who want to design and build embedded systems using the QNX Advanced Virtualization Frameworks.
Typographical Conventions, Support, and Licensing
This section describes the typographical conventions used throughout the documentation and explains how to obtain technical support.

screen_display_mode_t

A structure to contain values related to Screen display mode

Synopsis:

#include <screen/screen.h>

typedef struct _screen_mode {
    uint32_t width;
    uint32_t height;
    uint32_t refresh;
    uint32_t interlaced;
    uint32_t aspect_ratio[2];
    uint32_t flags;
    uint32_t index;
    uint32_t reserved[5];
} screen_display_mode_t;

Data:

uint32_t width: Width in pixels.
uint32_t height: Height in pixels.
uint32_t refresh: Refresh rate in Hz.
uint32_t interlaced: Interlace mode. 1 for interlace, 0 for no interlace.
uint32_t aspect_ratio [2]: Aspect ratio.
uint32_t flags: See Screen mode types for more information.
uint32_t index: An index from the mode list retrieved using screen_get_display_modes().

Library:

libscreen

Page updated: March 12, 2026