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
Image Library Reference
Image API
img_format_t
Image formats

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
    - Working with Images
    - Image API
      - img_cfg_read()
        Read a configuration file and load codecs
      - img_codec_get_criteria()
        Get the extension and mime information for a given codec
      - img_codec_list()
        Enumerate codecs
      - img_codec_list_byext()
        Enumerate codecs by file extension
      - img_codec_list_bymime()
        Enumerate codecs by MIME type
      - img_convert_data()
        Convert data from one image format to another
      - img_convert_getfunc()
        Get a function to convert one image format to another
      - img_crop()
        Crop an image
      - img_decode_begin()
        Prepare to decode one or more frames from a stream
      - img_decode_callouts_t
        Decoder callout table
      - img_decode_finish()
        Release decode resources
      - img_decode_frame()
        Decode a frame
      - img_decode_validate()
        Find a codec for decoding
      - img_dtransform()
        Convert an image from one format to another
      - img_dtransform_apply()
        Apply a data transform
      - img_dtransform_create()
        Prepare to transform an image
      - img_dtransform_free()
        Free a transform structure
      - img_encode_begin()
        Prepare to encode one or more frames to a stream
      - img_encode_callouts_t
        Encoder callout table
      - img_encode_finish()
        Release encode resources
      - img_encode_frame()
        Encode a frame
      - img_expand_getfunc()
        Get a function to convert a palette format to a direct format
      - IMG_FMT_BPL()
        Calculate the minimum number of bytes required to represent a pixel run
      - IMG_FMT_BPP()
        Determine the number of bits per pixel for the specified format
      - img_format_t
        Image formats
      - img_lib_attach()
        Initialize the image library
      - img_lib_detach()
        Detach from the library
      - img_load()
        Decode a frame from a stream
      - img_load_file()
        Decode a frame from a file on the filesystem
      - img_load_resize()
        Decode and resize a frame from a stream
      - img_load_resize_file()
        Decode and resize a frame from a file on the filesystem
      - img_resize_fs()
        Resize an image
      - img_rotate_ortho()
        Rotate an image by 90-degree increments
      - img_write()
        Encode a frame to an output stream on the filesystem
      - img_write_file()
        Encode a frame to a file on the filesystem
      - img_t
        Information describing an image
      - io_close()
        Release an input stream
      - io_open()
        Initialize an IO stream
  - 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).
  - 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.

img_format_t

QNX SDP8.0Image Library ReferenceAPIDeveloperProgramming

Image formats

Synopsis:

#include <img/img.h>

typedef enum {
   ...
} img_format_t;

Description:

The img_format_t is an enumeration of these possible image formats:

IMG_FMT_INVALID: Invalid image format
IMG_FMT_MONO: Monochromatic bitmap with 1 bit/pixel, packing 8 pixels per byte.
IMG_FMT_G8: 8-bits/pixel graymap.
IMG_FMT_PAL1: 1-bit/pixel index into a palette of 2 entries, packing 8 pixels per byte.
IMG_FMT_PAL4: 4-bits/pixel index into a palette of up to 16 entries, packing 2 pixels per byte.
IMG_FMT_PAL8: 8-bits/pixel index into a palette of up to 256 entries.
IMG_FMT_PKLE_RGB565: 16-bits/pixel RGB packed into 16-bit little-endian integer type with bits 0-4 for B, 5-10 for G, and 11-15 for R.
IMG_FMT_PKBE_RGB565: A big-endian version of IMG_FMT_PKLE_RGB565
IMG_FMT_PKLE_ARGB1555: 16-bits/pixel ARGB packed into 16-bit little-endian integer type with bits 0-4 for B, 5-9 for G, 10-14 for R and most significant bit for A.
IMG_FMT_PKBE_ARGB1555: A big-endian version of IMG_FMT_PKLE_ARGB1555
IMG_FMT_BGR888: 24-bits/pixel BGR with 8 bits per channel as an ordered byte sequence.
IMG_FMT_RGB888: 24-bits/pixel RGB with 8 bits per channel as an ordered byte sequence.
IMG_FMT_RGBA8888: 32-bits/pixel RGBA with 8 bits per channel as an ordered byte sequence.
IMG_FMT_PKLE_ARGB8888: 32-bits/pixel ARGB packed into 32-bit little-endian integer type with byte 0 (least-significant byte) for B, byte 1 for G, byte 2 for R and byte 3 for A.
IMG_FMT_PKBE_ARGB8888: A big endian version of IMG_FMT_PKLE_ARGB8888
IMG_FMT_PKLE_XRGB8888: 24-bits/pixel BGR with 8 bits per channel as an ordered byte sequence, followed by a single byte of padding.
IMG_FMT_PKBE_XRGB8888: A big endian version of IMG_FMT_PKLE_XRGB8888

In addition to PKLE and PKBE variants listed above, there are PKHE and PKOE variants that make it easier to identify host-endian (HE) formats and other-endian (OE). So for example, if your code is executing on an x86 platform, IMG_FMT_PKHE_ARGB1555 equals IMG_FMT_PKLE_ARGB1555.

Classification:

Image library

Page updated: August 11, 2025