README.NanoX
author Sam Lantinga <slouken@libsdl.org>
Fri, 14 Dec 2001 13:13:20 +0000
changeset 254 4fc12b8edf74
parent 30 57bf11a5efd7
child 471 26dafefeebb2
permissions -rw-r--r--
*** empty log message ***
     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