Add pkg-config script (cmake changes added by mistake in previous commit)
[freeglut] / README.win32
1 Installing the Libraries with MSVC
2 ==================================
3
4 To install "freeglut" on your system so that your other projects will see it,
5 you will need to copy various files to various locations.
6
7     - The header files "freeglut.h", "freeglut_ext.h", "freeglut_std.h", and
8       "glut.h" (distributed in the directory "freeglut\freeglut\include\GL")
9       need to be copied to a "GL" directory under the MSVC include directory.
10       The MSVC include directory generally has a path similar to
11               "C:\Program Files\Microsoft Visual Studio\VC98\Include"
12       The "GL" subdirectory under that will probably already have the header
13       files "gl.h", "glaux.h", and "glu.h".
14     - The library file "freeglut.lib" or "freeglut_static.lib" (from the
15       corresponding debug or release directory) needs to be copied into the
16       MSVC library directory.  This usually has a path similar to
17               "C:\Program Files\Microsoft Visual Studio\VC98\Lib"
18       Note that there is no "GL" subdirectory here.  This directory should
19       already have the files "opengl32.lib", "glu32.lib", and "glaux.lib".
20     - If you are using the DLL version of "freeglut", the file "freeglut.dll"
21       needs to be copied from the Debug or the Release directory into the
22       DLL directory.  This usually has a path similar to
23               "C:\Windows\System32"
24       and will probably already have the files "opengl32.dll" and "glu32.dll".
25
26
27 Building and Installing the Libraries with Open Watcom
28 ======================================================
29
30 Start a command prompt and change directory to the freeglut installation
31 directory.  Type "wmake -f Makefile.wat all" to build the DLL and static
32 libraries in both debug and release versions.
33
34 To install "freeglut" on your system so that your other projects will see it,
35 you will need to copy various files to various locations.
36
37     - The header files "freeglut.h", "freeglut_ext.h", "freeglut_std.h", and
38       "glut.h" (distributed in the directory "freeglut\freeglut\include\GL")
39           need to be copied to a "GL" directory under the Open Watcom 32-bit
40           Windows include directory.  This usually has a path similar to
41                           "C:\WATCOM\h\nt\GL"
42     - The library file "freeglut.lib" or "freeglut_static.lib" (from the
43       corresponding debug or release directory) needs to be copied into the
44           Open Watcom 32-bit Windows library directory.  This usually has a path
45           similar to
46                           "C:\WATCOM\lib386\nt"
47     - If you are using the DLL version of "freeglut", the file "freeglut.dll"
48       needs to be copied from the Debug or the Release directory into the
49       DLL directory.  This usually has a path similar to
50               "C:\Windows\System32"
51       and will probably already have the files "opengl32.dll" and "glu32.dll".
52
53
54 Unlike the *nix release, the library names are NOT automatic replacements for
55 the GLUT library names.  You may rename them manually if you wish, but this is
56 not necessary as the header file includes a pragma telling the compiler which
57 library file to look for.
58
59
60 Building and Installing the Libraries with Cygwin
61 =================================================
62
63 To build "freeglut" under Cygwin, you have two choices:
64
65 - You can build a normal Cygwin library, which depends on Cygwin's X11
66   libraries. To do this, you can just use the normal autotools incantation:
67       ./configure && make install
68
69 - Alternatively, you can build a DLL which does not depend on X11 and links
70   against the opengl32 DLL. To do this, configure need a few more flags:
71       ./configure CPPFLAGS=-mno-cygwin LDFLAGS=-mno-cygwin --without-x && make install
72
73
74 If you don't have MSVC, Open Watcom or Cygwin
75 =============================================
76
77 The "freeglut" developers' community discussed the possibility of distributing
78 binaries and decided against it.  If you need Windows library files, please
79 contact John F. Fay at <john.fay@eglin.af.mil> or put a request on the
80 "freeglut" developers' mailing list <freeglut-developer@lists.sourceforge.net>.
81