                       Gauche-gl - Gauche OpenGL binding

Up-to-date information about Gauche-gl is posted to the following URL:
  http://practical-scheme.net/gauche/


Prerequisites
----------------------------------------------------------


* Gauche 0.9.1 or later must be installed.
* OpenGL 1.1 or later, or Mesa 3.0 or later, required.
* GLUT 3.7 or later is required (except when you compile
  on MinGW; see below.)


Quick Start
----------------------------------------------------------


   % ./configure
   % make
   % make install
Configure script figures out the necessary compiler options and the
install location from the installed Gauche.


Location of GLUT Library
----------------------------------------------------------


If you have GLUT installed in non-standard place, you have to
tell the configure script where it is.

  ./configure --with-glut=DIR


On MinGW, you can choose an option to use freeglut-2.6 binary included
in the source tree instead of a separate GLUT library.  The freeglut
library is statically linked, which is convenient if you want to distribute
your script.   If you choose to do so, configure with the following option.

  ./configure --with-glut=mingw-static


If you distribute compiled libgauche-glut.dll with statically linked freeglut,
check win32/freeglut-2.6.0-3/Copying.txt.  Freeglut is basically a MIT-like
license, but you need to include the copyright notice in your distribution.


NVidia Cg binding
----------------------------------------------------------


Optionally you can build and install NVidia's Cg Toolkit bindings,
written by Issac Trotts.  It only covers a part of API yet, but
some examples are runnable.  To build and install Cg binding,
give --enable-cg to the configure script.

  ./configure --enable-cg

NVidia's Cg Toolkit has to be installed before building the
binding.  You can download the toolkit from the following URL.

  http://developer.nvidia.com/object/cg_toolkit.html


Platform-specific information
----------------------------------------------------------


It is reported that Mesa in FreeBSD ports is compiled with pthreads
enabled.  Thus Gauche-gl can't be linked unless Gauche itself is
compiled with pthreads.  The configure script of Gauche prints
warning if you specify pthreads, but it is safe as far as you
don't call make-thread in your program.


