README.NanoX
changeset 30 57bf11a5efd7
child 471 26dafefeebb2
equal deleted inserted replaced
29:a8360daed17d 30:57bf11a5efd7
       
     1   =================================================================
       
     2   Patch version 0.8 of SDL(Simple DirectMedia Layer) for Nano-X API
       
     3   =================================================================
       
     4   
       
     5   Author: Hsieh-Fu Tsai, clare@setabox.com
       
     6 
       
     7   There are two patch files in this package. 
       
     8 
       
     9   1. The first patch file, nanox.patch, is to fix a bug in Nano-X. 
       
    10      This patch is proposed by Gary James (gjames@twcny.rr.com).
       
    11 
       
    12   It fixes the client side GrClose(). In the original version, 
       
    13   GrOpen() can only be called once. When the GrOpen() is called at 
       
    14   the second time, the program will terminate. In order to prevent
       
    15   this situation, we need to insert "nxSocket = -1" after 
       
    16   "close(nxSocket)" in GrClose(). If you do not have this problem,
       
    17   you may skip this step. 
       
    18 
       
    19   =============
       
    20   Quick Install 
       
    21   =============
       
    22 
       
    23   1. ./configure --disable-video-x11 --disable-video-fbcon \ 
       
    24        --enable-video-nanox \ 
       
    25        --with-nanox-pixel-type=[rgb/0888/888/565/555/332/pal] 
       
    26   2. make clean 
       
    27   3. make 
       
    28   4. make install (as root) 
       
    29 
       
    30   ============
       
    31   Nitty-gritty 
       
    32   ============
       
    33 
       
    34   --with-nanox-pixel-type=[rgb/0888/888/565/555/332/pal] 
       
    35 
       
    36   If the wrong pixel type is used, the program will crash when the 
       
    37   sub-routine updates the screen. This option depends on SCREEN_PIXTYPE 
       
    38   which is defined in Microwin0.89pre7/src/config. SCREEN_PIXTYPE 
       
    39   is used to define the pixel type in Microwindows/Nano-X. 
       
    40   I only test the program when the pixel type is in "rgb" 
       
    41   (Microwin under X11) or "888" (framebuffer in 24-bit).
       
    42 
       
    43   --enable-nanox-debug           Show debug messages 
       
    44   --enable-nanox-share-memory    Use shared-memory to speed up 
       
    45 
       
    46   =============================================
       
    47   Some programs can be used to test this patch. 
       
    48   =============================================
       
    49 
       
    50   1. http://www.cs.berkeley.edu/~weimer/atris (a tetris-like game) 
       
    51   2. http://www.libsdl.org/projects/newvox/
       
    52   3. http://www.libsdl.org/projects/xflame/
       
    53   4. http://www.libsdl.org/projects/optimum/ 
       
    54   5. http://www.gnugeneration.com/software/loop/ 
       
    55     
       
    56   =========
       
    57   Todo List 
       
    58   =========
       
    59 
       
    60   1. Create hardware surface
       
    61   2. Create YUVOverlay on hardware
       
    62   3. Use OpenGL
       
    63   4. Gamma correction
       
    64   5. Hide/Change mouse pointer
       
    65 
       
    66   =====================
       
    67   Supporting Institutes
       
    68   =====================
       
    69   
       
    70   Many thanks to go to Setabox Co., Ltd. and CML (Communication and
       
    71   Multimedia Laboratory, http://www.cmlab.csie.ntu.edu.tw/) in the 
       
    72   Department of Computer Science and Information Engineering of 
       
    73   National Taiwan University for supporting this porting project.
       
    74   
       
    75   ===================
       
    76   Contact Information
       
    77   ===================
       
    78 
       
    79   Welcome to give me any suggestion and to report bugs.
       
    80   My e-mail address : clare@setabox.com or niky@cmlab.csie.ntu.edu.tw
       
    81