17 |
17 |
18 OpenGL works well and is stable, but fullscreen mode has not been |
18 OpenGL works well and is stable, but fullscreen mode has not been |
19 heavily tested yet. |
19 heavily tested yet. |
20 If you have QNX RtP version 6.1.0 or above you must download the |
20 If you have QNX RtP version 6.1.0 or above you must download the |
21 Photon3D runtime from http://developers.qnx.com or install it from the |
21 Photon3D runtime from http://developers.qnx.com or install it from the |
22 public repository or the public CD, available with QNX. OS versions |
22 public repository or from the public CD, available with QNX. OS versi- |
23 below 6.1.0 are not supported. |
23 ons below 6.1.0 are not supported. |
24 When creating an OpenGL context, software renderer mode is artifi- |
24 When creating an OpenGL context, software renderer mode is artifi- |
25 cially selected (QSSL made acceleration only for Voodoo boards in |
25 cially selected (QSSL made acceleration only for Voodoo boards in |
26 fullscreen mode, sorry but I don't have this board to test OpenGL - |
26 fullscreen mode, sorry but I don't have this board to test OpenGL - |
27 maybe it works or maybe not :)). If you want acceleration - you can |
27 maybe it works or maybe not :)). If you want acceleration - you can |
28 remove one line in the source code: find the file SDL_ph_image.c and |
28 remove one line in the source code: find the file SDL_ph_image.c and |
34 PHOGL_ATTRIB_FORCE_HW or PHOGL_ATTRIB_FAVOR_HW. |
34 PHOGL_ATTRIB_FORCE_HW or PHOGL_ATTRIB_FAVOR_HW. |
35 |
35 |
36 ====================================================================== |
36 ====================================================================== |
37 2. Wheel and multi-button mouses: |
37 2. Wheel and multi-button mouses: |
38 |
38 |
39 Photon emits keyboard events (key up and down) when the mouse |
39 Photon emits keyboard events (key up and down) when the mouse |
40 wheel is moved. The key_scan field appears valid, and it contains zero. |
40 wheel is moved. The key_scan field appears valid, and it contains zero. |
41 That is a basic method of detecting mouse wheel events under Photon. |
41 That is a basic method of detecting mouse wheel events under Photon. |
42 It looks like a hack, but it works for me :) on various PC configura- |
42 It looks like a hack, but it works for me :) on various PC configura- |
43 tions. |
43 tions. |
44 |
44 |
45 I've tested it on: |
45 I've tested it on: |
46 |
46 |
47 1. Genius Optical NetScroll/+ (1 wheel) |
47 1. Genius Optical NetScroll/+ PS/2 (1 wheel) |
48 2. A4Tech Optical GreatEye WheelMouse, model: WOP-35. (2 wheels + 2 |
48 2. A4Tech Optical GreatEye WheelMouse PS/2, model: WOP-35. (2 wheels |
49 additional buttons). The wheel for vertical scrolling works as usu- |
49 + 2 additional buttons). The wheel for vertical scrolling works as |
50 al, but the second wheel for horizontal scrolling emits two sequen- |
50 usual, but the second wheel for horizontal scrolling emits two se- |
51 tial events up or down, so it can provide faster scrolling than the |
51 quential events up or down, so it can provide faster scrolling than |
52 first wheel. Additional buttons don't emit any events, but it looks |
52 the first wheel. Additional buttons don't emit any events, but it |
53 like they're handled by photon in an unusual way - like click to |
53 looks like they're handled by photon in an unusual way - like click |
54 front, but works not with any window, looks like bug-o-feature :). |
54 to front, but works not with any window, looks like a fun bug-o-fe- |
|
55 ature :). |
55 |
56 |
56 ====================================================================== |
57 ====================================================================== |
57 3. CDROM handling issues: |
58 3. CDROM handling issues: |
58 |
59 |
59 Access to CDROM can only be provided with 'root' privileges. I |
60 Access to CDROM can only be provided with 'root' privileges. I |
87 A shared library can be built, but before running the autogen.sh |
88 A shared library can be built, but before running the autogen.sh |
88 script you must manually delete the libtool.m4 stuff from the acinclu- |
89 script you must manually delete the libtool.m4 stuff from the acinclu- |
89 de.m4 file (it comes after the ESD detection code up to the end of the |
90 de.m4 file (it comes after the ESD detection code up to the end of the |
90 file), because the libtool stuff in the acinclude.m4 file was very old |
91 file), because the libtool stuff in the acinclude.m4 file was very old |
91 in SDL distribution before the version 1.2.7 and doesn't knew anything |
92 in SDL distribution before the version 1.2.7 and doesn't knew anything |
92 about QNX. SDL 1.2.7 distribution contain the new libtool.m4 script, |
93 about QNX. SDL 1.2.7 distribution contains the new libtool.m4 script, |
93 but anyway it is broken :), Just remove it, then run "libtoolize |
94 but anyway it is broken :), Just remove it, then run "libtoolize |
94 --force --copy", delete the file aclocal.m4 and after that run the |
95 --force --copy", delete the file aclocal.m4 if it is exists and after |
95 autogen.sh script. |
96 that run the autogen.sh script. SDL 1.2.8 contains fixed libtool.m4, |
|
97 ltmain.sh and config.sub files, so you can just run the autogen.sh |
|
98 script. |
96 |
99 |
97 ====================================================================== |
100 ====================================================================== |
98 6. Some building issues: |
101 6. Some building issues: |
99 |
102 |
100 Feel free to not use the --disable-shared configure option if you' |
103 Feel free to not use the --disable-shared configure option if you' |
103 script will be broken. |
106 script will be broken. |
104 |
107 |
105 Run the configure script without x11 support, e.g.: |
108 Run the configure script without x11 support, e.g.: |
106 |
109 |
107 a) for OpenGL support: |
110 a) for OpenGL support: |
108 ./configure --prefix=/usr \ |
111 ./configure --prefix=/usr \ |
109 --disable-video-x11 \ |
112 --disable-video-x11 \ |
110 --disable-shared |
113 --disable-shared |
111 |
114 |
112 b) without OpenGL support: |
115 b) without OpenGL support: |
113 ./configure --prefix=/usr \ |
116 ./configure --prefix=/usr \ |
114 --disable-video-x11 \ |
117 --disable-video-x11 \ |
115 --disable-shared \ |
118 --disable-shared \ |
116 --disable-video-opengl |
119 --disable-video-opengl |
|
120 |
|
121 And of course dont forget to specify --disable-debug, which is on |
|
122 by default, to disable debug and enable the expensive optimizations. |
117 |
123 |
118 In the test directory also run the ./configure script without |
124 In the test directory also run the ./configure script without |
119 x11 support, e.g.: |
125 x11 support, e.g.: |
120 |
126 |
121 ./configure --with-sdl-prefix=/usr \ |
127 ./configure --with-sdl-prefix=/usr \ |
126 7. Environment variables: |
132 7. Environment variables: |
127 |
133 |
128 Please note that the photon driver is sensible to the following |
134 Please note that the photon driver is sensible to the following |
129 environmental variables: |
135 environmental variables: |
130 |
136 |
131 * SDL_PHOTON_FULLSCREEN_REFRESH - this environment variable controls |
137 * SDL_PHOTON_FULLSCREEN_REFRESH - this environment variable controls |
132 the refresh rate in all fullscreen modes. Be carefull !!! Photon drivers |
138 the refresh rate in all fullscreen modes. Be carefull !!! Photon |
133 usually do not checking the maximum refresh rate, which video adapter or |
139 drivers usually do not checking the maximum refresh rate, which video |
134 monitor supports. |
140 adapter or monitor supports. |
135 |
141 |
136 * SDL_VIDEO_WINDOW_POS - can be set in the "X,Y" format. If X and Y |
142 * SDL_VIDEO_WINDOW_POS - can be set in the "X,Y" format. If X and Y |
137 coordinates are bigger than the current desktop resolution, then win- |
143 coordinates are bigger than the current desktop resolution, then win- |
138 dow positioning across virtual consoles is activated. If X and Y are |
144 dow positioning across virtual consoles is activated. If X and Y are |
139 smaller than the desktop resolution then window positioning in the |
145 smaller than the desktop resolution then window positioning in the |
142 environmental variable. |
148 environmental variable. |
143 |
149 |
144 * SDL_VIDEO_CENTERED - if this environmental variable exists then the |
150 * SDL_VIDEO_CENTERED - if this environmental variable exists then the |
145 window centering is perfomed in the current virtual console. |
151 window centering is perfomed in the current virtual console. |
146 |
152 |
147 The SDL_VIDEO_CENTERED enviromental variable has greater priority |
153 Notes: The SDL_VIDEO_CENTERED enviromental variable has greater pri- |
148 than the SDL_VIDEO_WINDOW_POS in case if both variables are supplied |
154 ority than the SDL_VIDEO_WINDOW_POS in case if both variables are sup- |
149 to the application. |
155 plied to the application. |