Mercurial > sdl-ios-xcode

comparison README.QNX @ 3099:82e60908fab1

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Date: Mon, 23 Mar 2009 09:17:24 +0200 From: "Mike Gorchak" Subject: New QNX patches Please apply patch qnx4.diff, which is attached. What has been done: 1)Added back OpenGL ES renderer for QNX target. Added few corrections to OpenGL ES renderer to let it work under QNX. OpenGL ES renderer do not support textures under QNX, so I think some additional work must be done. 2) Added GL_OES_query_matrix extension to SDL_opengles.h header file, which required by OpenGL ES 1.1 specification. 3) Added attribute clearing at the entrance of function SDL_GL_GetAttribure(). Added error checking into the function SDL_GL_GetAttribure(), because some attributes can't be obtained in OpenGL ES 1.0. 4) Porting testdyngles to OpenGL ES 1.0 (1.1 has glColor4ub() and glColor4f() functions, but 1.0 has glColor4f() only). 5) Added error checking after obtaining attributes using SDL_GL_GetAttribute() function to the testgl2 and testgles. 6) Small correction to testmultiaudio with printing errors. 7) Added software and accelerated OpenGL ES 1.0 support into the QNX GF driver. Please remove ./src/audio/nto directory - it will not be used anymore. Please create ./src/audio/qsa directory and add content of the archive qsa.tar.gz into this directory. I rewrote some sound code, added support for multiple audio cards, enumeration, etc. Added initial support for capture. As far as I can understand SDL 1.3 is not supporting audio capture right now ? Sam, Am I right ? Or audio capture must be supported through the PlayDevice routine ? And last, please put file SDL_gf_opengles.c to the ./src/video/qnxgf directory. It is OpenGL ES 1.1 emulation layer for some functions, which are not supported by OpenGL ES 1.0.
author Sam Lantinga <slouken@libsdl.org>
date Tue, 24 Mar 2009 10:33:12 +0000
parents cad1aefa2ed9
children 3cf236d3cd81
comparison
equal deleted inserted replaced
3098:5f372cef955d 3099:82e60908fab1
1 README.QNX by Mike Gorchak <mike@malva.ua>, <lestat@i.com.ua> 1 README.QNX by Mike Gorchak <mike@malva.ua>, <lestat@i.com.ua>
2 Last changed at 10 Mar 2009. 2 Last changed at 22 Mar 2009.
3 3
4 QNX Photon and GF drivers are under construction. Please be patient. 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.
8
9 ----------------------
10 -- SDL QSA driver --
11 ----------------------
12
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:
16
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
24
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.
28
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
31 opened by SDL.
32
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.
5 36
6 --------------------- 37 ---------------------
7 -- SDL GF driver -- 38 -- SDL GF driver --
8 --------------------- 39 ---------------------
9 40
13 * 2. Custom video modes. 44 * 2. Custom video modes.
14 * 3. Limitations. 45 * 3. Limitations.
15 46
16 0. Introduction. 47 0. Introduction.
17 48
18 SDL GF driver is a layer between SDL and QNX Graphics Framework (GF). Hardware 49 SDL GF driver is a layer between SDL and QNX Graphics Framework (GF).
19 accelerated features which SDL could support depends on real hardware capabilities. 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
52 capabilities.
20 53
21 1. Environment variables which GF driver supports. 54 1. Environment variables which GF driver supports.
22 55
23 GF driver supports the following environment variables for QNX GF specific 56 GF driver supports the following environment variables for QNX GF
24 customization options: 57 specific customization options:
25 a) SDL_VIDEO_GF_REFRESH_RATE - refresh rate of video output in Hz. Without 58 a) SDL_VIDEO_GF_REFRESH_RATE - refresh rate of video output in Hz.
26 this environment variable declaration SDL controls refresh rate of your 59 Without this environment variable declaration SDL controls refresh
27 display. If this enironment variable is set to 0, SDL will control refresh 60 rate of your display. If this enironment variable is set to 0, SDL
28 rate of display, otherwise value of SDL_VIDEO_GF_REFRESH_RATE is used for 61 will control refresh rate of display, otherwise value of flag
29 all screen resolutions as refresh rate. This example will set 60Hz refresh 62 SDL_VIDEO_GF_REFRESH_RATE is used for all screen resolutions as
30 rate as refresh rate for all graphics modes: 63 refresh rate. This example will set 60Hz refresh rate as refresh rate
64 for all graphics modes:
31 65
32 export SDL_VIDEO_GF_REFRESH_RATE=60 66 export SDL_VIDEO_GF_REFRESH_RATE=60
33 67
34 2. Custom video modes. 68 2. Custom video modes.
35 69
36 Since most QNX graphics drivers supports GENERIC video modes, i.e. you could 70 Since most QNX graphics drivers support GENERIC video modes, i.e. you
37 specify any horizontal and vertical resolution and any refresh rate, SDL GF 71 can specify any horizontal and vertical resolution and any refresh rate,
38 driver uses its own fullscreen modes list, which could be incomplete. You could 72 SDL GF driver uses its own fullscreen modes list, which can be incomplete.
39 add any custom video mode, which your QNX graphics driver supports by editing 73 You can add any custom video mode, which your QNX graphics driver supports
40 file ./src/video/qnxgf/SDL_qnxgf.c. Custom graphics mode definition looks like 74 by editing file ./src/video/qnxgf/SDL_qnxgf.c. Custom graphics mode
75 definition looks like this:
41 76
42 {0, 1024, 640, 60, NULL}, /* 1024x640 mode is 60Hz only */ 77 {0, 1024, 640, 60, NULL}, /* 1024x640 mode is 60Hz only */
43 78
44 You must specify horizontal resolution as second parameter, vertical resolution 79 You must specify horizontal resolution as the second parameter, vertical
45 as third parameter and refresh rate as fourth parameter. Please leave first and 80 resolution as the third one and refresh rate as the fourth parameter.
46 last parameters as 0 and NULL. Then please send me your changes to e-mail address 81 Please leave the first and the last parameters as 0 and NULL. Then send me
47 which is specified in the header of this document. 82 your changes to e-mail address which is specified in the header of this
83 document.
48 84
49 3. Limitations. 85 3. Limitations.
50 86
51 There are few limitations while using SDL GF driver: 87 There are few limitations while using SDL GF driver:
52 88
53 a) Since GF driver supports fullscreen modes only, when you are not specifing 89 a) Since GF driver supports fullscreen modes only, when flag
54 SDL_WINDOW_FULLSCREEN flag, an SDL GF driver will try to find the fullscreen 90 SDL_WINDOW_FULLSCREEN is not specified, SDL GF driver will try to find the
55 graphics mode which corresponds to SDL window size. Refresh rate will be the 91 fullscreen graphics mode which corresponds to SDL window size. Refresh rate
56 lowest available, if SDL_VIDEO_GF_REFRESH_RATE environment variable is not set. 92 will be the lowest available, if SDL_VIDEO_GF_REFRESH_RATE environment
93 variable is not set.
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
98 source file.
57 99
100 -------------------------
101 -- SDL Photon driver --
102 -------------------------
103
104 ----------------------------
105 -- SDL HID input driver --
106 ----------------------------