| 1 |
@c -*- coding:utf-8 -*- |
| 2 |
Gauche-gl - Gauche OpenGL binding |
| 3 |
|
| 4 |
Up-to-date information about Gauche-gl is posted to the following URL: |
| 5 |
http://practical-scheme.net/gauche/ |
| 6 |
|
| 7 |
|
| 8 |
Prerequisites |
| 9 |
---------------------------------------------------------- |
| 10 |
|
| 11 |
|
| 12 |
* Gauche 0.9.3 or later must be installed. |
| 13 |
* OpenGL 1.1 or later, or Mesa 3.0 or later, required. |
| 14 |
* GLUT 3.7 or later is required (except when you compile |
| 15 |
on MinGW; see below.) |
| 16 |
|
| 17 |
|
| 18 |
Quick Start |
| 19 |
---------------------------------------------------------- |
| 20 |
|
| 21 |
|
| 22 |
% ./configure |
| 23 |
% make |
| 24 |
% make install |
| 25 |
Configure script figures out the necessary compiler options and the |
| 26 |
install location from the installed Gauche. |
| 27 |
|
| 28 |
|
| 29 |
Location of GLUT Library |
| 30 |
---------------------------------------------------------- |
| 31 |
|
| 32 |
|
| 33 |
If you have GLUT installed in non-standard place, you have to |
| 34 |
tell the configure script where it is. |
| 35 |
|
| 36 |
./configure --with-glut=DIR |
| 37 |
|
| 38 |
|
| 39 |
On MinGW, you can choose an option to use freeglut-2.6 binary included |
| 40 |
in the source tree instead of a separate GLUT library. The freeglut |
| 41 |
library is statically linked, which is convenient if you want to distribute |
| 42 |
your script. If you choose to do so, configure with the following option. |
| 43 |
|
| 44 |
./configure --with-glut=mingw-static |
| 45 |
|
| 46 |
|
| 47 |
If you distribute compiled libgauche-glut.dll with statically linked freeglut, |
| 48 |
check win32/freeglut-2.6.0-3/Copying.txt. Freeglut is basically a MIT-like |
| 49 |
license, but you need to include the copyright notice in your distribution. |
| 50 |
|
| 51 |
|
| 52 |
NVidia Cg binding |
| 53 |
---------------------------------------------------------- |
| 54 |
|
| 55 |
|
| 56 |
Optionally you can build and install NVidia's Cg Toolkit bindings, |
| 57 |
written by Issac Trotts. It only covers a part of API yet, but |
| 58 |
some examples are runnable. To build and install Cg binding, |
| 59 |
give --enable-cg to the configure script. |
| 60 |
|
| 61 |
./configure --enable-cg |
| 62 |
|
| 63 |
NVidia's Cg Toolkit has to be installed before building the |
| 64 |
binding. You can download the toolkit from the following URL. |
| 65 |
|
| 66 |
http://developer.nvidia.com/object/cg_toolkit.html |
| 67 |
|
| 68 |
|
| 69 |
Platform-specific information |
| 70 |
---------------------------------------------------------- |
| 71 |
|
| 72 |
|
| 73 |
It is reported that Mesa in FreeBSD ports is compiled with pthreads |
| 74 |
enabled. Thus Gauche-gl can't be linked unless Gauche itself is |
| 75 |
compiled with pthreads. The configure script of Gauche prints |
| 76 |
warning if you specify pthreads, but it is safe as far as you |
| 77 |
don't call make-thread in your program. |
| 78 |
|
| 79 |
|
| 80 |
On OSX 10.9 or later you'll get tons of warnings during compiling |
| 81 |
since they deprecate GLUT. It doesn't affect using the library. |
| 82 |
We'll provide alternatives in near future. |