README.QNX
changeset 663 8bedd6d61642
parent 380 bce7171e7a85
child 692 04dd6c6d7c30
equal deleted inserted replaced
662:66c02f83f5bf 663:8bedd6d61642
     1 README by Mike Gorchak <mike@malva.ua>, <lestat@i.com.ua>
     1 README by Mike Gorchak <mike@malva.ua>, <lestat@i.com.ua>
       
     2 Last changed at 29 Jul 2003.
       
     3 
       
     4 =========================================================================
       
     5 OpenGL:
     2 
     6 
     3     OpenGL in window mode  works well  and  stable, in fullscreen
     7     OpenGL in window mode  works well  and  stable, in fullscreen
     4 mode too, but fullscreen mode has not been heavily tested.
     8 mode too, but fullscreen mode has not been heavily tested yet.
     5     If you have QNX RtP 6.1.0 w/ or w/o Patch A you must download
     9     If you have QNX RtP version 6.1.0 and above you must download
     6 new Photon3D runtime from http://developers.qnx.com. The versions
    10 new Photon3D runtime from http://developers.qnx.com or install it
     7 of OS before 6.1.0 are not supported.
    11 from public repository or from public CD, available with QNX. The
       
    12 versions of OS before 6.1.0 are not supported.
       
    13     While  creating  OpenGL  context  software  renderer  mode is
       
    14 artificially selected (QSSL  made  acceleration  only for  Voodoo
       
    15 boards in fullscreen mode, sorry but I  don't have  this board to
       
    16 test OpenGL - maybe it work or maybe not :)). If you want accele-
       
    17 ration - you may remove some line in source code: find  the  file
       
    18 SDL_ph_video.c and remove the following
     8 
    19 
     9 Problems:
    20     OGLAttrib[OGLargc++]=PHOGL_ATTRIB_FORCE_SW;
    10 1. While  creating  OpenGL  context  software  renderer  mode  is
    21      
    11    artificially selected (QSSL made acceleration only for  Voodoo
    22 line in the ph_SetupOpenGLContext() function or  change  argument
    12    boards in fullscreen mode, sorry but I don't have  this board,
    23 to the PHOGL_ATTRIB_FORCE_HW or PHOGL_ATTRIB_FAVOR_HW.
    13    if you want acceleration - you may remove some line  in source
       
    14    code).
       
    15 2. Photon has some errors in detecting  how  much bits  per pixel
       
    16    videomode has.
       
    17 3. No  shared  libraries  yet.  We  need  manually  set  flag  to
       
    18    'configure' --disable-shared.
       
    19 4. Due to Photon API limitation, flag SDL_HWSURFACE supported on-
       
    20    ly in case of desktop bpp is equal requested bpp in window mo-
       
    21    de.
       
    22 
    24 
       
    25 =========================================================================
       
    26 Wheel and multibutton mouses:
       
    27 
       
    28     Photon emitting keyboard events (key up and down) when  moved
       
    29 mouse wheel. But key_scan field appears valid according to flags,
       
    30 and it contain zero. It is base method of detecting  mouse  wheel
       
    31 events under photon. It looks like a hack, but it works for me :)
       
    32 on different PC configurations.
       
    33 
       
    34 I'm tested it on:
       
    35 
       
    36 1. Genius Optical NetScroll/+ (1 wheel)
       
    37 2. A4Tech Optical GreatEye WheelMouse, model: WOP-35. (2 wheels +
       
    38    2 additional buttons). Wheel for vertical scrolling  works  as
       
    39    usual, but second wheel for horizontal scrolling emitting  two
       
    40    consequented events up or down, so it can  provide  more  fast
       
    41    scrolling then the  first  wheel. Additional  buttons  doesn't
       
    42    emitting any events, but its look like  handled by  photon  in
       
    43    unusual way - like click to front, but works not with any win-
       
    44    dow, looks like bug-o-feature :).
       
    45 
       
    46 =========================================================================
       
    47 CDROM handling issues:
       
    48 
       
    49     Access to CDROM can be provided only with 'root'  previleges.
       
    50 I can't do anything with this fact. /dev/cd0 have  the brw-------
       
    51 flags and root:root rights.
       
    52 
       
    53 =========================================================================
       
    54 Video Overlays:
       
    55 
       
    56     Overlays can flickering during the window movement, resizing,
       
    57 etc. It happens because photon driver  updates  the  real  window
       
    58 contents behind the overlay, then draws the temporary  chroma key
       
    59 color over window contents. It can be done without the chroma key
       
    60 using but it cause overlay will be  always  on top. So flickering
       
    61 during the movement much better in that case.
       
    62     Double buffering code temporary disabled in the photon driver
       
    63 code, beacuse on my GF2-MX it  cause  accidently  buffer  switch,
       
    64 which going to the old frame showing. S3 Savage3D have  the  same
       
    65 problem, but ATI Rage 128 has not this problem. I think it can be
       
    66 fixed later. Current code works very fine, so maybe double buffe-
       
    67 ring is not needed right now.
       
    68     Something strange appears when you tried to move window  with
       
    69 overlay beyond the left border of the screen. Overlay  trying  to
       
    70 stay at position x=0, but when tried to move  it  a  bit  more it
       
    71 jumps  at  posituin  x=-60. Really  strange, looks  like  overlay
       
    72 doesn't love the negotive coordinates.
       
    73 
       
    74 =========================================================================
       
    75 Shared library building:
       
    76 
       
    77     Shared  library can be  built, but before  running autogen.sh
       
    78 script you  need  manually  delete  the  libtool  m4  stuff  from
       
    79 the acinclude.m4 file (it comes after ESD  detection  code  up to
       
    80 end of the file). Because libtool stuff in the  acinclude.m4 file
       
    81 very old and doesn't know anything about the QNX. Just  remove it
       
    82 and run autogen.sh script.
       
    83 
       
    84 =========================================================================
    23 Some building issues:
    85 Some building issues:
       
    86 
       
    87     Feel free to not pass --disable-shared option  to  configure,
       
    88 if you read comment above about 'Shared library building'. Other-
       
    89 wise this option is strongly  recomended, because  the sdl-config
       
    90 script will be unfunctional.
    24 
    91 
    25     Run configure script without x11 support, e.g.:
    92     Run configure script without x11 support, e.g.:
    26 
    93 
    27     a) for OpenGL support:
    94     a) for OpenGL support:
    28     ./configure --prefix=/usr/local \
    95     ./configure --prefix=/usr/local \
    40 
   107 
    41     ./configure  --with-sdl-prefix=/usr/local      \
   108     ./configure  --with-sdl-prefix=/usr/local      \
    42                  --with-sdl-exec-prefix=/usr/local \
   109                  --with-sdl-exec-prefix=/usr/local \
    43                  --prefix=/usr/local --without-x
   110                  --prefix=/usr/local --without-x
    44 
   111 
       
   112