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