1 README.QNX by Mike Gorchak <mike@malva.ua>, <lestat@i.com.ua>
2 Last changed at 23 Mar 2009.
4 QNX Photon and GF drivers are being constructed.
5 QNX QSA (QNX Sound Architecture) driver is ready.
6 QNX CDROM driver is ready.
7 QNX HID input driver is being constructed.
11 ----------------------
13 Due to QNX Sound Architecture limitations software could not determine
14 what playback channels are designed for, so some casus can be. For example,
15 output after testmultiaudio test utility execution:
17 Using audio driver: qsa
18 playing on device #0: ('Vortex 8820 @ fb000000 d0')...done.
19 playing on device #1: ('Vortex 8820 @ fb000000 d1')...done.
20 playing on device #2: ('i8x0 @ d800 d0')...done.
21 playing on device #3: ('i8x0 @ d800 d1')...done.
22 playing on all devices...
23 Open device 3 failed: QSA: snd_pcm_channel_params failed: Invalid argument
25 If speakers are connected to both audio cards: Vortex 8820 and Intel
26 Integrated Audio we can hear sound playback on device #0 and devices #2, #3
27 only. Device #1 is an unknown PCM channel which does not produce any sound.
29 As for error during device #3 opening, it's caused by QSA software mixer
30 channel, because it can't open real hardware device #2, since it's already
33 After simultaneous sound playback on all devices utility testmultiaudio
34 stays running waiting for sound playback finish on device #1, which is
35 locked up due to some Aureal Vortex 8820 driver limitations.
41 Here is an additional information about SDL GF driver:
43 * 1. Environment variables which SDL GF driver supports.
44 * 2. Custom video modes.
49 SDL GF driver is a layer between SDL and QNX Graphics Framework (GF).
50 SDL GF driver also supports OpenGL ES through the QNX Graphics Framework.
51 Hardware accelerated features which SDL can support depend on real hardware
54 1. Environment variables which GF driver supports.
56 GF driver supports the following environment variables for QNX GF
57 specific customization options:
58 a) SDL_VIDEO_GF_REFRESH_RATE - refresh rate of video output in Hz.
59 Without this environment variable declaration SDL controls refresh
60 rate of your display. If this enironment variable is set to 0, SDL
61 will control refresh rate of display, otherwise value of flag
62 SDL_VIDEO_GF_REFRESH_RATE is used for all screen resolutions as
63 refresh rate. This example will set 60Hz refresh rate as refresh rate
64 for all graphics modes:
66 export SDL_VIDEO_GF_REFRESH_RATE=60
68 2. Custom video modes.
70 Since most QNX graphics drivers support GENERIC video modes, i.e. you
71 can specify any horizontal and vertical resolution and any refresh rate,
72 SDL GF driver uses its own fullscreen modes list, which can be incomplete.
73 You can add any custom video mode, which your QNX graphics driver supports
74 by editing file ./src/video/qnxgf/SDL_qnxgf.c. Custom graphics mode
75 definition looks like this:
77 {0, 1024, 640, 60, NULL}, /* 1024x640 mode is 60Hz only */
79 You must specify horizontal resolution as the second parameter, vertical
80 resolution as the third one and refresh rate as the fourth parameter.
81 Please leave the first and the last parameters as 0 and NULL. Then send me
82 your changes to e-mail address which is specified in the header of this
87 There are few limitations while using SDL GF driver:
89 a) Since GF driver supports fullscreen modes only, when flag
90 SDL_WINDOW_FULLSCREEN is not specified, SDL GF driver will try to find the
91 fullscreen graphics mode which corresponds to SDL window size. Refresh rate
92 will be the lowest available, if SDL_VIDEO_GF_REFRESH_RATE environment
94 b) As confirmed by QSSL none of existing video drivers has support of
95 doublescan low-resolution video modes. So modes below 640x480 are not
96 supported. If your video driver supports low-resolution video modes, please
97 add SDL_GF_LOWRESOLUTION flag to the gf_devicename array in the SDL_qnxgf.c
100 -------------------------
101 -- SDL Photon driver --
102 -------------------------
104 ----------------------------
105 -- SDL HID input driver --
106 ----------------------------