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 the QNX OS 8.0.
Graphics
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).
OpenWF Display Configuration Library Reference
The Wfdcfg library provides the modes and attributes of your display hardware to your display driver and to Screen. Your display driver (WFD driver) is the primary user of the Wfdcfg library, but the composition manager component in Screen also uses the modes and attributes from the Wfdcfg library.
wfdcfg_port_create()
Create a wfdcfg port

QNX Momentics IDE User's Guide
This User's Guide describes version 8.0 of the Integrated Development Environment (IDE) that's part of the QNX 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 the QNX OS 8.0.
- Quickstart Guide
- System Architecture
  The System Architecture guide accompanies the QNX OS and is intended for both application developers and end-users.
- OS Components & Operations
- Graphics
  - 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).
    - Before you begin
      This guide is intended to describe how to integrate a new display by setting the appropripate parameters based on your display specifications.
    - Introduction to the Wfdcfg library
      The Wfdcfg library provides the modes and attributes of your display hardware to your display driver and Screen.
    - Getting the source code
      The files from the compressed Wfdcfg archive are extracted onto your host.
    - Setting timing parameters
      Timing is mandatory component of a mode.
    - Updating Wfdcfg source (adding extensions)
      You may want to update your Wfdcfg source if your display supports specific options that you want to control.
    - Building the Wfdcfg library
    - Updating your target
      After you've completed updating and building your Wfdcfg library, you are ready to rebuild your QNX IFS and transfer it to your target.
    - Configuring Screen for your display
      You need to configure your display in graphics.conf and restart Screen.
    - OpenWF Display Configuration Library Reference
      The Wfdcfg library provides the modes and attributes of your display hardware to your display driver and to Screen. Your display driver (WFD driver) is the primary user of the Wfdcfg library, but the composition manager component in Screen also uses the modes and attributes from the Wfdcfg library.
      - Definitions in wfdcfg.h
        Preprocessor macro definitions for the wfdcfg.h header file in the libwfdcfg library
      - WFDCFG_FNPTR()
        Validate the type of a function pointer at compile time
      - wfdcfg_device
        Opaque data type representing an OpenWF device
      - wfdcfg_device_create()
        Create a wfdcfg device
      - wfdcfg_device_destroy()
        Destroy a wfdcfg device
      - wfdcfg_device_get_extension()
        Retrieve an extension identified by a key (string) from a device
      - wfdcfg_ext_fn_port_init1_t
        Initialize a port
      - wfdcfg_ext_fn_port_set_mode2_t
        Program a port
      - wfdcfg_ext_fn_port_uninit1_t
        Destroy a port
      - wfdcfg_ext_fn_set_power_mode_t
        Set the power mode on a port
      - wfdcfg_flags
        Flags used in the flags field of the timing structure that describes video timing parameters
      - wfdcfg_keyval
        Array(s) of this structure are used to allow for extensions
      - wfdcfg_mode_get_extension()
        Retrieve an extension from the specified mode
      - wfdcfg_mode_list
        Opaque data type representing a list of video modes
      - wfdcfg_mode_list_create()
        Create a list of video modes associated with specified port
      - wfdcfg_mode_list_destroy()
        Destroy a list of video modes
      - wfdcfg_mode_list_get_next()
        Retrieve a mode (timing) from the specified list of video modes
      - wfdcfg_port
        Opaque data type representing an OpenWF display port
      - wfdcfg_port_create()
        Create a wfdcfg port
      - wfdcfg_port_destroy()
        Destroy a wfdcfg port
      - wfdcfg_port_get_extension()
        Retrieve an extension identified by a key (string) from a port
      - wfdcfg_power_mode
        Power modes for display
      - wfdcfg_timing
        Structure that describes the video timing parameters for the display driver settings
  - OpenWF Display Server User's Guide
    The OpenWF Display Server (wfd-server) is a resource manager that provides applications the ability to show image buffers directly to the display controller via the OpenWF Display 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.
  - 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.
- Programming
- System Security Guide
  The QNX System Security Guide is intended for both system integrators who are responsible for the security of a QNX OS system and developers who want to create a QNX OS resource manager free from vulnerabilities.
- Utilities & Libraries
- Migrating to QNX OS 8.0
QNX Software in the Cloud
QNX Software in the Cloud enables developers to use the QNX OS in the Amazon cloud environment.
QNX Toolkit for Visual Studio Code
This User's Guide describes the QNX^® Toolkit for Visual Studio Code. The guide introduces you to the QNX Toolkit by explaining the QNX development environment and how to build, run, and debug your QNX^® Operating System (OS) applications and systems.
QNX Hypervisor User's Guide
This User's Guide explains the QNX hypervisor architecture and provides instructions for installing and running a QNX Hypervisor system, changing system components and configuration, and using hypervisor features such as virtual devices (vdevs).
Typographical Conventions, Support, and Licensing
This section describes the typographical conventions used throughout the documentation, explains how to obtain technical support, and provides some information about licensing.

wfdcfg_port_create()

Graphics and Screen4.0 (8.x)OpenWF Configuration Developer's GuideAPIProgramming

Create a wfdcfg port

Synopsis:

#include <wfdqnx/wfdcfg.h>

int wfdcfg_port_create(struct wfdcfg_port **port,
                       const struct wfdcfg_device *device,
                       int portid,
                       const struct wfdcfg_keyval *opts)

Arguments:

port: A handle to the port that is to be created
device: A handle to the device that is associated with the port to be created
portid: The identification number of the OpenWFD port
opts: An array of optional parameters that is terminated by .key=NULL

Library:

libwfdcfg

Description:

There must be at least one port created. Otherwise, the OpenWF display driver will report an error.

Returns:

0 if port was successfully created; *port is set to an opaque pointer. A code from errno.h if device failed to be created; *port remains unchanged. Possible error codes include:

ENOMEM: Unable to allocate a port
ENOENT: Invalid/Unknown port ID

Page updated: March 05, 2025