README.NanoX
changeset 30 57bf11a5efd7
child 471 26dafefeebb2
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/README.NanoX	Fri May 11 01:13:35 2001 +0000
     1.3 @@ -0,0 +1,81 @@
     1.4 +  =================================================================
     1.5 +  Patch version 0.8 of SDL(Simple DirectMedia Layer) for Nano-X API
     1.6 +  =================================================================
     1.7 +  
     1.8 +  Author: Hsieh-Fu Tsai, clare@setabox.com
     1.9 +
    1.10 +  There are two patch files in this package. 
    1.11 +
    1.12 +  1. The first patch file, nanox.patch, is to fix a bug in Nano-X. 
    1.13 +     This patch is proposed by Gary James (gjames@twcny.rr.com).
    1.14 +
    1.15 +  It fixes the client side GrClose(). In the original version, 
    1.16 +  GrOpen() can only be called once. When the GrOpen() is called at 
    1.17 +  the second time, the program will terminate. In order to prevent
    1.18 +  this situation, we need to insert "nxSocket = -1" after 
    1.19 +  "close(nxSocket)" in GrClose(). If you do not have this problem,
    1.20 +  you may skip this step. 
    1.21 +
    1.22 +  =============
    1.23 +  Quick Install 
    1.24 +  =============
    1.25 +
    1.26 +  1. ./configure --disable-video-x11 --disable-video-fbcon \ 
    1.27 +       --enable-video-nanox \ 
    1.28 +       --with-nanox-pixel-type=[rgb/0888/888/565/555/332/pal] 
    1.29 +  2. make clean 
    1.30 +  3. make 
    1.31 +  4. make install (as root) 
    1.32 +
    1.33 +  ============
    1.34 +  Nitty-gritty 
    1.35 +  ============
    1.36 +
    1.37 +  --with-nanox-pixel-type=[rgb/0888/888/565/555/332/pal] 
    1.38 +
    1.39 +  If the wrong pixel type is used, the program will crash when the 
    1.40 +  sub-routine updates the screen. This option depends on SCREEN_PIXTYPE 
    1.41 +  which is defined in Microwin0.89pre7/src/config. SCREEN_PIXTYPE 
    1.42 +  is used to define the pixel type in Microwindows/Nano-X. 
    1.43 +  I only test the program when the pixel type is in "rgb" 
    1.44 +  (Microwin under X11) or "888" (framebuffer in 24-bit).
    1.45 +
    1.46 +  --enable-nanox-debug           Show debug messages 
    1.47 +  --enable-nanox-share-memory    Use shared-memory to speed up 
    1.48 +
    1.49 +  =============================================
    1.50 +  Some programs can be used to test this patch. 
    1.51 +  =============================================
    1.52 +
    1.53 +  1. http://www.cs.berkeley.edu/~weimer/atris (a tetris-like game) 
    1.54 +  2. http://www.libsdl.org/projects/newvox/
    1.55 +  3. http://www.libsdl.org/projects/xflame/
    1.56 +  4. http://www.libsdl.org/projects/optimum/ 
    1.57 +  5. http://www.gnugeneration.com/software/loop/ 
    1.58 +    
    1.59 +  =========
    1.60 +  Todo List 
    1.61 +  =========
    1.62 +
    1.63 +  1. Create hardware surface
    1.64 +  2. Create YUVOverlay on hardware
    1.65 +  3. Use OpenGL
    1.66 +  4. Gamma correction
    1.67 +  5. Hide/Change mouse pointer
    1.68 +
    1.69 +  =====================
    1.70 +  Supporting Institutes
    1.71 +  =====================
    1.72 +  
    1.73 +  Many thanks to go to Setabox Co., Ltd. and CML (Communication and
    1.74 +  Multimedia Laboratory, http://www.cmlab.csie.ntu.edu.tw/) in the 
    1.75 +  Department of Computer Science and Information Engineering of 
    1.76 +  National Taiwan University for supporting this porting project.
    1.77 +  
    1.78 +  ===================
    1.79 +  Contact Information
    1.80 +  ===================
    1.81 +
    1.82 +  Welcome to give me any suggestion and to report bugs.
    1.83 +  My e-mail address : clare@setabox.com or niky@cmlab.csie.ntu.edu.tw
    1.84 +