README.QNX
changeset 663 8bedd6d61642
parent 380 bce7171e7a85
child 692 04dd6c6d7c30
     1.1 --- a/README.QNX	Mon Jul 28 01:47:55 2003 +0000
     1.2 +++ b/README.QNX	Mon Aug 04 00:52:42 2003 +0000
     1.3 @@ -1,27 +1,94 @@
     1.4  README by Mike Gorchak <mike@malva.ua>, <lestat@i.com.ua>
     1.5 +Last changed at 29 Jul 2003.
     1.6 +
     1.7 +=========================================================================
     1.8 +OpenGL:
     1.9  
    1.10      OpenGL in window mode  works well  and  stable, in fullscreen
    1.11 -mode too, but fullscreen mode has not been heavily tested.
    1.12 -    If you have QNX RtP 6.1.0 w/ or w/o Patch A you must download
    1.13 -new Photon3D runtime from http://developers.qnx.com. The versions
    1.14 -of OS before 6.1.0 are not supported.
    1.15 +mode too, but fullscreen mode has not been heavily tested yet.
    1.16 +    If you have QNX RtP version 6.1.0 and above you must download
    1.17 +new Photon3D runtime from http://developers.qnx.com or install it
    1.18 +from public repository or from public CD, available with QNX. The
    1.19 +versions of OS before 6.1.0 are not supported.
    1.20 +    While  creating  OpenGL  context  software  renderer  mode is
    1.21 +artificially selected (QSSL  made  acceleration  only for  Voodoo
    1.22 +boards in fullscreen mode, sorry but I  don't have  this board to
    1.23 +test OpenGL - maybe it work or maybe not :)). If you want accele-
    1.24 +ration - you may remove some line in source code: find  the  file
    1.25 +SDL_ph_video.c and remove the following
    1.26  
    1.27 -Problems:
    1.28 -1. While  creating  OpenGL  context  software  renderer  mode  is
    1.29 -   artificially selected (QSSL made acceleration only for  Voodoo
    1.30 -   boards in fullscreen mode, sorry but I don't have  this board,
    1.31 -   if you want acceleration - you may remove some line  in source
    1.32 -   code).
    1.33 -2. Photon has some errors in detecting  how  much bits  per pixel
    1.34 -   videomode has.
    1.35 -3. No  shared  libraries  yet.  We  need  manually  set  flag  to
    1.36 -   'configure' --disable-shared.
    1.37 -4. Due to Photon API limitation, flag SDL_HWSURFACE supported on-
    1.38 -   ly in case of desktop bpp is equal requested bpp in window mo-
    1.39 -   de.
    1.40 +    OGLAttrib[OGLargc++]=PHOGL_ATTRIB_FORCE_SW;
    1.41 +     
    1.42 +line in the ph_SetupOpenGLContext() function or  change  argument
    1.43 +to the PHOGL_ATTRIB_FORCE_HW or PHOGL_ATTRIB_FAVOR_HW.
    1.44  
    1.45 +=========================================================================
    1.46 +Wheel and multibutton mouses:
    1.47 +
    1.48 +    Photon emitting keyboard events (key up and down) when  moved
    1.49 +mouse wheel. But key_scan field appears valid according to flags,
    1.50 +and it contain zero. It is base method of detecting  mouse  wheel
    1.51 +events under photon. It looks like a hack, but it works for me :)
    1.52 +on different PC configurations.
    1.53 +
    1.54 +I'm tested it on:
    1.55 +
    1.56 +1. Genius Optical NetScroll/+ (1 wheel)
    1.57 +2. A4Tech Optical GreatEye WheelMouse, model: WOP-35. (2 wheels +
    1.58 +   2 additional buttons). Wheel for vertical scrolling  works  as
    1.59 +   usual, but second wheel for horizontal scrolling emitting  two
    1.60 +   consequented events up or down, so it can  provide  more  fast
    1.61 +   scrolling then the  first  wheel. Additional  buttons  doesn't
    1.62 +   emitting any events, but its look like  handled by  photon  in
    1.63 +   unusual way - like click to front, but works not with any win-
    1.64 +   dow, looks like bug-o-feature :).
    1.65 +
    1.66 +=========================================================================
    1.67 +CDROM handling issues:
    1.68 +
    1.69 +    Access to CDROM can be provided only with 'root'  previleges.
    1.70 +I can't do anything with this fact. /dev/cd0 have  the brw-------
    1.71 +flags and root:root rights.
    1.72 +
    1.73 +=========================================================================
    1.74 +Video Overlays:
    1.75 +
    1.76 +    Overlays can flickering during the window movement, resizing,
    1.77 +etc. It happens because photon driver  updates  the  real  window
    1.78 +contents behind the overlay, then draws the temporary  chroma key
    1.79 +color over window contents. It can be done without the chroma key
    1.80 +using but it cause overlay will be  always  on top. So flickering
    1.81 +during the movement much better in that case.
    1.82 +    Double buffering code temporary disabled in the photon driver
    1.83 +code, beacuse on my GF2-MX it  cause  accidently  buffer  switch,
    1.84 +which going to the old frame showing. S3 Savage3D have  the  same
    1.85 +problem, but ATI Rage 128 has not this problem. I think it can be
    1.86 +fixed later. Current code works very fine, so maybe double buffe-
    1.87 +ring is not needed right now.
    1.88 +    Something strange appears when you tried to move window  with
    1.89 +overlay beyond the left border of the screen. Overlay  trying  to
    1.90 +stay at position x=0, but when tried to move  it  a  bit  more it
    1.91 +jumps  at  posituin  x=-60. Really  strange, looks  like  overlay
    1.92 +doesn't love the negotive coordinates.
    1.93 +
    1.94 +=========================================================================
    1.95 +Shared library building:
    1.96 +
    1.97 +    Shared  library can be  built, but before  running autogen.sh
    1.98 +script you  need  manually  delete  the  libtool  m4  stuff  from
    1.99 +the acinclude.m4 file (it comes after ESD  detection  code  up to
   1.100 +end of the file). Because libtool stuff in the  acinclude.m4 file
   1.101 +very old and doesn't know anything about the QNX. Just  remove it
   1.102 +and run autogen.sh script.
   1.103 +
   1.104 +=========================================================================
   1.105  Some building issues:
   1.106  
   1.107 +    Feel free to not pass --disable-shared option  to  configure,
   1.108 +if you read comment above about 'Shared library building'. Other-
   1.109 +wise this option is strongly  recomended, because  the sdl-config
   1.110 +script will be unfunctional.
   1.111 +
   1.112      Run configure script without x11 support, e.g.:
   1.113  
   1.114      a) for OpenGL support:
   1.115 @@ -42,3 +109,4 @@
   1.116                   --with-sdl-exec-prefix=/usr/local \
   1.117                   --prefix=/usr/local --without-x
   1.118  
   1.119 +