TODO: Convert to the MediaWiki formatting as discussed at Converting Old MinGWiki Pages

!How to use Mark J. Kilgard's OpenGL Utility Toolkit (GLUT) with MinGW

• Download the binary and unpack the binary distribution of [Nate Robins' Win32 port of GLUT|http://www.xmission.com/~nate/glut.html]. These instructions are based version 3.7.6 and may not work with earlier or newer versions.
• Create a subdirectory called =GL= in your project's include directory, and copy the file =glut.h= from the package there.
• Copy the library, =glut32.lib=, to your project's build directory.
• Copy the DLL, =glut32.dll=, to the same directory where your project's executable will be created.
• Ensure that you're using version 2.16.91 or later of binutils.
• Define the macros =_STDCALL_SUPPORTED= and =_M_IX86= before including =<GL/glut.h>= in your source code. Three ways you can do this are:

* on the command line with =-D_STDCALL_SUPPORTED -D_M_IX86= * use macro defintions in your source code (eg. =#define _STDCALL_SUPPORTED=) * include =<windows.h>= before including =<GL/glut.h>=

• Compile your project, ensuring that =<GL/glut.h>= is in the include path, and that you're linking with =glut32.lib=.

When distributing any applications you built using GLUT, you need include a copy of =glut32.dll= in your distribution. This is not a standard Windows DLL so you can't expect your users to already have it installed on their systems. You should install =glut32.dll= in same directory as your application's executable. This ensures that other applications won't install a buggy or incompatible version of the GLUT DLL over yours.

!!Errors you may get:

<verbatim> E:\TEMP/ccwosggb.o:t10.c:(.text+0x1c): undefined reference to `__glutInitWithExit' E:\TEMP/ccwosggb.o:t10.c:(.text+0x37): undefined reference to `__glutCreateWindowWithExit' E:\TEMP/ccwosggb.o:t10.c:(.text+0x52): undefined reference to `__glutCreateMenuWithExit' E:\TEMP/ccwosggb.o:t10.c:(.text+0x15a): undefined reference to `glutDisplayFunc' E:\TEMP/ccwosggb.o:t10.c:(.text+0x15f): undefined reference to `glutMainLoop' ... </verbatim>

This indicates that you didn't define =_STDCALL_SUPPORTED= before including =<GL/glut.h>=. See the instructions above on different ways you can do this.

%%% <verbatim> E:\TEMP/ccMMoggb.o(.text+0x1c):t10.c: undefined reference to `__glutInitWithExit@12' E:\TEMP/ccMMoggb.o(.text+0x3e):t10.c: undefined reference to `__glutCreateWindowWithExit@8' E:\TEMP/ccMMoggb.o(.text+0x60):t10.c: undefined reference to `__glutCreateMenuWithExit@8' E:\TEMP/ccMMoggb.o(.text+0x1a5):t10.c: undefined reference to `glutDisplayFunc@4' E:\TEMP/ccMMoggb.o(.text+0x1ad):t10.c: undefined reference to `glutMainLoop@0' ... </verbatim>

This indicates you're using an older version of binutils. Upgrade to 2.16.91.

%%% <verbatim> E:\TEMP/ccMMoggb.o(.text+0x1c):t10.c: undefined reference to `__glutInitWithExit@12' E:\TEMP/ccMMoggb.o(.text+0x3e):t10.c: undefined reference to `__glutCreateWindowWithExit@8' E:\TEMP/ccMMoggb.o(.text+0x60):t10.c: undefined reference to `__glutCreateMenuWithExit@8' </verbatim>

If these are the only three undefined references then you probably linked with =-lglut32= instead of =glut32.lib=.

%%% <verbatim> ./GL/glut.h:58: warning: ignoring #pragma comment ./GL/glut.h:66: warning: ignoring #pragma comment ./GL/glut.h:67: warning: ignoring #pragma comment ./GL/glut.h:68: warning: ignoring #pragma comment ./GL/glut.h:76: warning: ignoring #pragma warning ./GL/glut.h:77: warning: ignoring #pragma warning </verbatim>

These warnings are harmless, but you can define the macros =GLUT_NO_LIB_PRAGMA= and =GLUT_NO_WARNING_DISABLE= before including =<GL/glut.h>= to prevent them.

%%% <verbatim> ./GL/glut.h:549: warning: 'glutCreateMenu_ATEXIT_HACK' defined but not used </verbatim>

This warning is also harmless, but I'm not sure of any safe way to prevent it without modifying =<GL/glut.h>=.