102 lines
4.7 KiB
Plaintext
102 lines
4.7 KiB
Plaintext
![]() |
freeglut 2.8.1-1.mp for MSVC
|
|||
|
|
|||
|
This package contains freeglut import libraries, headers, and Windows DLLs.
|
|||
|
These allow 32 and 64 bit GLUT applications to be compiled on Windows using
|
|||
|
Microsoft Visual C++.
|
|||
|
|
|||
|
For more information on freeglut, visit http://freeglut.sourceforge.net/.
|
|||
|
|
|||
|
|
|||
|
Installation
|
|||
|
|
|||
|
Create a folder on your PC which is readable by all users, for example
|
|||
|
<EFBFBD>C:\Program Files\Common Files\MSVC\freeglut\<5C> on a typical Windows system. Copy
|
|||
|
the <20>lib\<5C> and <20>include\<5C> folders from this zip archive to that location.
|
|||
|
|
|||
|
The appropriate freeglut DLL can either be placed in the same folder as your
|
|||
|
application, or can be installed in a system-wide folder which appears in your
|
|||
|
%PATH% environment variable. Be careful not to mix the 32 bit DLL up with the 64
|
|||
|
bit DLL, as they are not interchangeable.
|
|||
|
|
|||
|
|
|||
|
Compiling 32 bit Applications
|
|||
|
|
|||
|
To create a 32 bit freeglut application, create a new Win32 C++ project in MSVC.
|
|||
|
From the <20>Win32 Application Wizard<72>, choose a <20>Windows application<6F>, check the
|
|||
|
<EFBFBD>Empty project<63> box, and submit.
|
|||
|
|
|||
|
You<EFBFBD>ll now need to configure the compiler and linker settings. Open up the
|
|||
|
project properties, and select <20>All Configurations<6E> (this is necessary to ensure
|
|||
|
our changes are applied for both debug and release builds). Open up the
|
|||
|
<EFBFBD>general<EFBFBD> section under <20>C/C++<2B>, and configure the <20>include\<5C> folder you created
|
|||
|
above as an <20>Additional Include Directory<72>. If you have more than one GLUT
|
|||
|
package which contains a <20>glut.h<> file, it<69>s important to ensure that the
|
|||
|
freeglut include folder appears above all other GLUT include folders.
|
|||
|
|
|||
|
Now open up the <20>general<61> section under <20>Linker<65>, and configure the <20>lib\<5C>
|
|||
|
folder you created above as an <20>Additional Library Directory<72>. A freeglut
|
|||
|
application depends on the import libraries <20>freeglut.lib<69> and <20>opengl32.lib<69>,
|
|||
|
which can be configured under the <20>Input<75> section. However, it shouldn<64>t be
|
|||
|
necessary to explicitly state these dependencies, since the freeglut headers
|
|||
|
handle this for you. Now open the <20>Advanced<65> section, and enter <20>mainCRTStartup<75>
|
|||
|
as the <20>Entry Point<6E> for your application. This is necessary because GLUT
|
|||
|
applications use <20>main<69> as the application entry point, not <20>WinMain<69><6E>without it
|
|||
|
you<EFBFBD>ll get an undefined reference when you try to link your application.
|
|||
|
|
|||
|
That<EFBFBD>s all of your project properties configured, so you can now add source
|
|||
|
files to your project and build the application. If you want your application to
|
|||
|
be compatible with GLUT, you should <20>#include <GL/glut.h><3E>. If you want to use
|
|||
|
freeglut specific extensions, you should <20>#include <GL/freeglut.h><3E> instead.
|
|||
|
|
|||
|
Don<EFBFBD>t forget to either include the freeglut DLL when distributing applications,
|
|||
|
or provide your users with some method of obtaining it if they don<6F>t already
|
|||
|
have it!
|
|||
|
|
|||
|
|
|||
|
Compiling 64 bit Applications
|
|||
|
|
|||
|
Building 64 bit applications is almost identical to building 32 bit applications.
|
|||
|
When you use the configuration manager to add the x64 platform, it<69>s easiest to
|
|||
|
copy the settings from the Win32 platform. If you do so, it<69>s then only necessary
|
|||
|
to change the <20>Additional Library Directories<65> configuration so that it
|
|||
|
references the directory containing the 64 bit import library rather
|
|||
|
than the 32 bit one.
|
|||
|
|
|||
|
|
|||
|
Problems?
|
|||
|
|
|||
|
If you have problems using this package (compiler / linker errors etc.), please
|
|||
|
check that you have followed all of the steps in this readme file correctly.
|
|||
|
Almost all of the problems which are reported with these packages are due to
|
|||
|
missing a step or not doing it correctly, for example trying to build a 32 bit
|
|||
|
app against the 64 bit import library. If you have followed all of the steps
|
|||
|
correctly but your application still fails to build, try building a very simple
|
|||
|
but functional program (the example at
|
|||
|
http://www.transmissionzero.co.uk/computing/using-glut-with-mingw/ works fine
|
|||
|
with MSVC). A lot of people try to build very complex applications after
|
|||
|
installing these packages, and often the error is with the application code or
|
|||
|
other library dependencies rather than freeglut.
|
|||
|
|
|||
|
If you still can<61>t get it working after trying to compile a simple application,
|
|||
|
then please get in touch via http://www.transmissionzero.co.uk/contact/,
|
|||
|
providing as much detail as you can. Please don<6F>t complain to the freeglut guys
|
|||
|
unless you<6F>re sure it<69>s a freeglut bug, and have reproduced the issue after
|
|||
|
compiling freeglut from the latest SVN version<6F>if that<61>s still the case, I<>m sure
|
|||
|
they would appreciate a bug report or a patch.
|
|||
|
|
|||
|
|
|||
|
Changelog
|
|||
|
|
|||
|
2013<EFBFBD>05<EFBFBD>11: Release 2.8.1-1.mp
|
|||
|
|
|||
|
<20> First 2.8.1 MSVC release. I<>ve built the package using Visual Studio 2012,
|
|||
|
and the only change I<>ve made is to the DLL version resource<63>I<EFBFBD>ve changed
|
|||
|
the description so that my MinGW and MSVC builds are distinguishable from
|
|||
|
each other (and other builds) using Windows Explorer.
|
|||
|
|
|||
|
|
|||
|
Martin Payne
|
|||
|
2013<EFBFBD>05<EFBFBD>11
|
|||
|
|
|||
|
http://www.transmissionzero.co.uk/
|