Adding a \"README.Win32\" file with instructions on how to install \"freeglut\" under...
[freeglut] / README.win32
1 Windows 32 / MSVC Notes
2 =======================
3
4 The "freeglut" library installation package comes with MSVC 6.0 workspace and
5 project files.  The workspace has two projects:  "freeglut.dsp", which creates
6 a DLL file, and "freeglut_static.dsp", which creates a static library.
7
8
9 Building the Libraries
10 ======================
11
12 To build the "freeglut" libraries, open MSVC and load the "freeglut" workspace.
13 This will load the two projects.  Selecting "Build" - "Batch Build" from the
14 menu will build both the debug and the release versions of both libraries.
15
16 The libraries will be found in the following places and will have the following
17 names:
18 - DLL, debug version:  freeglut\freeglut\Debug\freeglut.lib
19 - DLL, release version:  freeglut\freeglut\Release\freeglut.lib
20 - Static, debug version:  freeglut\freeglut\DebugStatic\freeglut_static.lib
21 - Static, release version:  freeglut\freeglut\ReleaseStatic\freeglut_static.lib
22
23 Unlike the *nix release, the library names are NOT automatic replacements for
24 the GLUT library names.  You may rename them manually if you wish.
25
26
27 Installing the Libraries
28 ========================
29
30 To install "freeglut" on your system so that your other projects will see it,
31 you will need to copy various files to various locations.
32
33     - The header files "freeglut.h", "freeglut_ext.h", "freeglut_std.h", and
34       "glut.h" (distributed in the directory "freeglut\freeglut\include\GL")
35       need to be copied to a "GL" directory under the MSVC include directory.
36       The MSVC include directory generally has a path similar to
37               "C:\Program Files\Microsoft Visual Studio\VC98\Include"
38       The "GL" subdirectory under that will probably already have the header
39       files "gl.h", "glaux.h", and "glu.h".
40     - The library file "freeglut.lib" or "freeglut_static.lib" (from the
41       corresponding debug or release directory) needs to be copied into the
42       MSVC library directory.  This usually has a path similar to
43               "C:\Program Files\Microsoft Visual Studio\VC98\Lib"
44       Note that there is no "GL" subdirectory here.  This directory should
45       already have the files "opengl32.lib", "glu32.lib", and "glaux.lib".
46     - If you are using the DLL version of "freeglut", the file "freeglut.dll"
47       needs to be copied from the Debug or the Release directory into the
48       DLL directory.  This usually has a path similar to
49               "C:\Windows\System32"
50       and will probably already have the files "opengl32.dll" and "glu32.dll".
51
52
53 If you don't have MSVC
54 ======================
55
56 The "freeglut" developers' community discussed the possibility of distributing
57 binaries and decided against it.  If you need Windows library files, please
58 contact John F. Fay at <john.fay@eglin.af.mil> or put a request on the
59 "freeglut" developers' mailing list <freeglut-developer@lists.sourceforge.net>.
60