Debian Codegraph @

INSTALL

raw
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.