X-Git-Url: http://git.mutantstargoat.com/user/nuclear/?a=blobdiff_plain;f=README.win32;h=87247b11e3400a451098be976a247106e5b552df;hb=bbab633540758fcd520c94370db9f5fb6bb01bc3;hp=b02d38f9ddd6fd90bed5635b00f935af564e678d;hpb=cc5c5131e38e0e522f78e4712fd5ab33a56775d1;p=freeglut diff --git a/README.win32 b/README.win32 old mode 100755 new mode 100644 index b02d38f..87247b1 --- a/README.win32 +++ b/README.win32 @@ -1,31 +1,11 @@ -Windows 32 / MSVC Notes -======================= +NB +================================== +For ancient 16bit compatibility, windef.h (included through windows.h in +freeglut_std.h) defines near and far. Its best to avoid using variables +with these names in your own program. -The "freeglut" library installation package comes with MSVC 6.0 workspace and -project files. The workspace has two projects: "freeglut.dsp", which creates -a DLL file, and "freeglut_static.dsp", which creates a static library. - - -Building the Libraries -====================== - -To build the "freeglut" libraries, open MSVC and load the "freeglut" workspace. -This will load the two projects. Selecting "Build" - "Batch Build" from the -menu will build both the debug and the release versions of both libraries. - -The libraries will be found in the following places and will have the following -names: -- DLL, debug version: freeglut\freeglut\Debug\freeglut.lib -- DLL, release version: freeglut\freeglut\Release\freeglut.lib -- Static, debug version: freeglut\freeglut\DebugStatic\freeglut_static.lib -- Static, release version: freeglut\freeglut\ReleaseStatic\freeglut_static.lib - -Unlike the *nix release, the library names are NOT automatic replacements for -the GLUT library names. You may rename them manually if you wish. - - -Installing the Libraries -======================== +Installing the Libraries with MSVC +================================== To install "freeglut" on your system so that your other projects will see it, you will need to copy various files to various locations. @@ -39,19 +19,70 @@ you will need to copy various files to various locations. files "gl.h", "glaux.h", and "glu.h". - The library file "freeglut.lib" or "freeglut_static.lib" (from the corresponding debug or release directory) needs to be copied into the - MSVC library directory. This usually has a path similar to - "C:\Program Files\Microsoft Visual Studio\VC98\Lib" + MSVC library directory. This usually has a path similar to: + "%ProgramFiles%\Microsoft SDKs\Windows\v7.0A\Lib" - x86 32 bits LIB's + "%ProgramFiles(x86)%\Microsoft SDKs\Windows\v7.0A\Lib" - x64 32 bits LIB's + "%ProgramFiles(x86)%\Microsoft SDKs\Windows\v7.0A\Lib\x64" - x64 64 bits LIB's Note that there is no "GL" subdirectory here. This directory should already have the files "opengl32.lib", "glu32.lib", and "glaux.lib". - If you are using the DLL version of "freeglut", the file "freeglut.dll" needs to be copied from the Debug or the Release directory into the DLL directory. This usually has a path similar to + "%SystemRoot%\System32\" - x86 32 bits DLL's + "%SystemRoot%\SysWOW64\" - x64 32 bits DLL's + "%SystemRoot%\System32\" - x64 64 bits DLL's + and will probably already have the files "opengl32.dll" and "glu32.dll". + + +Building and Installing the Libraries with Open Watcom +====================================================== + +Start a command prompt and change directory to the freeglut installation +directory. Type "wmake -f Makefile.wat all" to build the DLL and static +libraries in both debug and release versions. + +To install "freeglut" on your system so that your other projects will see it, +you will need to copy various files to various locations. + + - The header files "freeglut.h", "freeglut_ext.h", "freeglut_std.h", and + "glut.h" (distributed in the directory "freeglut\freeglut\include\GL") + need to be copied to a "GL" directory under the Open Watcom 32-bit + Windows include directory. This usually has a path similar to + "C:\WATCOM\h\nt\GL" + - The library file "freeglut.lib" or "freeglut_static.lib" (from the + corresponding debug or release directory) needs to be copied into the + Open Watcom 32-bit Windows library directory. This usually has a path + similar to + "C:\WATCOM\lib386\nt" + - If you are using the DLL version of "freeglut", the file "freeglut.dll" + needs to be copied from the Debug or the Release directory into the + DLL directory. This usually has a path similar to "C:\Windows\System32" and will probably already have the files "opengl32.dll" and "glu32.dll". -If you don't have MSVC -====================== +Unlike the *nix release, the library names are NOT automatic replacements for +the GLUT library names. You may rename them manually if you wish, but this is +not necessary as the header file includes a pragma telling the compiler which +library file to look for. + + +Building and Installing the Libraries with Cygwin +================================================= + +To build "freeglut" under Cygwin, you have two choices: + +- You can build a normal Cygwin library, which depends on Cygwin's X11 + libraries. To do this, you can just use the normal autotools incantation: + ./configure && make install + +- Alternatively, you can build a DLL which does not depend on X11 and links + against the opengl32 DLL. To do this, configure need a few more flags: + ./configure CPPFLAGS=-mno-cygwin LDFLAGS=-mno-cygwin --without-x && make install + + +If you don't have MSVC, Open Watcom or Cygwin +============================================= The "freeglut" developers' community discussed the possibility of distributing binaries and decided against it. If you need Windows library files, please