Allegro Manual: QNX specifics

# QNX specifics

- DIGI_*/QNX — Supported QNX digital sound drivers.
- GFX_*/QNX — Supported QNX graphic drivers.
- MIDI_*/QNX — Supported QNX MIDI sound drivers.
- qnx_get_window — Retrieves a handle to the window used by Allegro.

In terms of file redistribution, the QNX platform behaves practically the same as the DOS platform. Read section chapter "Dos specifics" in the manual to learn more about this.

Drivers GFX_*/QNX
QNX Allegro supports the following card parameters for the set_gfx_mode() function:

- GFX_TEXT
  This closes any graphics mode previously opened with set_gfx_mode.
- GFX_AUTODETECT
  Let Allegro pick an appropriate graphics driver.
- GFX_AUTODETECT_FULLSCREEN
  Autodetects a graphics driver, but will only use fullscreen drivers, failing if these are not available on current platform.
- GFX_AUTODETECT_WINDOWED
  Same as above, but uses only windowed drivers.
- GFX_SAFE
  Special driver for when you want to reliably set a graphics mode and don't really care what resolution. See the set_gfx_mode() documentation for details.
- GFX_PHOTON
  Alias for GFX_PHOTON_ACCEL.
- GFX_PHOTON_ACCEL
  Fullscreen exclusive mode through Photon, running with hardware acceleration enabled.
- GFX_PHOTON_SOFT
  Fullscreen exclusive mode that only uses software drawing, rather than any hardware accelerated features.
- GFX_PHOTON_SAFE
  Simplified fullscreen exclusive driver that doesn't support any hardware acceleration, video or system bitmaps, etc.
- GFX_PHOTON_WIN
  The regular windowed Photon driver, running in color conversion mode when the color depth doesn't match that of the Photon desktop. Color conversion is much slower than direct drawing. Note that, mainly for performance reasons, this driver requires the width of the screen to be a multiple of 4.

> See also: set_gfx_mode.

Drivers DIGI_*/QNX
The QNX sound functions support the following digital sound cards:

>           DIGI_AUTODETECT      - let Allegro pick a digital sound driver
>           DIGI_NONE            - no digital sound
>           DIGI_ALSA            - ALSA sound driver

> See also: detect_digi_driver, install_sound, install_sound_input.

Drivers MIDI_*/QNX
The QNX sound functions support the following MIDI sound cards:

>           MIDI_AUTODETECT      - let Allegro pick a MIDI sound driver
>           MIDI_NONE            - no MIDI sound
>           MIDI_ALSA            - ALSA RawMIDI driver
>           MIDI_DIGMID          - sample-based software wavetable player

> See also: detect_midi_driver, install_sound, install_sound_input.

## QNX integration routines

The following functions provide a platform specific interface to seamlessly integrate Allegro into general purpose QNX programs. To use these routines, you must include qnxalleg.h after other Allegro headers.

PtWidget_t qnx_get_window(void);
Retrieves a handle to the window used by Allegro. Note that Allegro uses an underlying window even though you don't set any graphics mode, unless you have installed the neutral system driver (SYSTEM_NONE).

Back to contents