Using GLFW with Code::Blocks - Revision history

Artojon: edit category

2006-07-08T12:47:16Z

edit category

Artojon: GLFW moved to Using GLFW with Code::Blocks

2006-07-08T12:46:21Z

GLFW moved to Using GLFW with Code::Blocks

Artojon: remove extra heading

2006-07-08T12:45:42Z

remove extra heading

Sethjackson at 20:23, 11 April 2006

2006-04-11T20:23:41Z

Thomas at 15:28, 6 February 2006

2006-02-06T15:28:27Z

Thomas: /* Building a GLFW Project */

2005-10-28T16:03:12Z

Building a GLFW Project

Thomas at 21:20, 9 October 2005

2005-10-09T21:20:03Z

Thomas at 13:47, 7 October 2005

2005-10-07T13:47:18Z

New page

==Using GLFW with Code::Blocks to develop OpenGL applications==

==What is GLFW==
<blockquote>"GLFW is a free, open source, portable framework for OpenGL application development.
In short, it is a link library that constitutes a powerful API for handling operating
system specific tasks, such as opening an OpenGL window and reading keyboard, mouse and joystick input."</blockquote>

You want to write a program using OpenGL and worry whether messing with W32 API, GLUT, or SDL is the least evil? 
In this case, GLFW is for you. GLFW lets you create a window with an OpenGL context (including full-screen windows), sample mouse and joysticks and read keyboard input in a platform-independent way. Additionally, GLFW offers portable high resolution timing and multithreading/message functionality. All of this goes into a 36kB library that is zlib-licensed, which more or less means you can do with it whatever you want, as long as you do not claim authorship of the library or have some other obviously illegal intent.
All in all, this is certainly one of the best available OpenGL toolkits.

==Prerequisites==
#Internet Connection 
#Some archiving program (tar, 7z, WinZip, PowerArchiver, ...) 
#Code::Blocks 1.0RC2 or later (for the application template)
#A working [[MinGW installation]] (alternatively, Borland or MSVC will work, too)

==Building the Libraries==
#Download the GLFW sources (including documentation) from: http://prdownloads.sourceforge.net/glfw/glfw-2.5.zip?download
#Unzip the archive anywhere you like (I will assume <tt>C:\glfw</tt> for simplicity).
#For Windows users, there is a batch file which allows to compile using a variety of compilers.
#*Open a DOS window, <tt>cd</tt> to the directory where GLFW lives (e.g. <tt>C:\glfw</tt>), and type <tt>compile make mgw</tt>. If you use the Borland compiler, type <tt>compile make bcc</tt> instead, and for MSVC, type <tt>compile make msvc</tt>.
#*Linux users will just want to type <tt>make</tt>.
Build time is ~1 minute.

==Installing GLFW==
#Navigate to the <tt>lib\win32</tt> folder (<tt>lib\x11</tt> for Linux).
#Copy <tt>libglfw.a</tt>, <tt>libglfwdll.a</tt>, and <tt>glfw.dll</tt> from inside the <tt>lib\win32</tt> folder (<tt>lib\x11</tt> for Linux) to where you keep your dll files (could be <tt>C:\MinGW\dll</tt> or <tt>C:\MinGW\lib</tt>, whatever).
#Go up two levels (to the GLFW base directory), and then into <tt>include/GL</tt>. Copy <tt>glfw.h</tt> to the <tt>GL</tt> folder inside your system includes folder (e.g. <tt>C:\MinGW\include\GL</tt> or <tt>C:\codeblocks\include\GL</tt>)

==Building a GLFW Project==
To build a program with GLFW, you need to include <tt>GL/glfw.h</tt> (no need to include <tt>GL/gl.h</tt>) and link to <tt>glfw</tt>, <tt>opengl32</tt>, <tt>glu32</tt>, <tt>gdi32</tt>, <tt>user32</tt>, and <tt>kernel32</tt>.

Code::Blocks 1.0RC2 includes a template to build a statically linked GLFW application. Since GLFW is really lightweight, there is actually no reason not to statically link to it, but if you insist on dynamic linkage, just change the include library in "Build Options" accordingly. 
Make a new project using the GLFW template, and hit the blue gear, you should see a windown with a few spinning triangles:

[[Image:Glfw-spin.png|The stereotypical OpenGL spinning triangle demo]]

← Older revision		Revision as of 12:47, 8 July 2006
Line 1:		Line 1:
−	[[Category:~~Installation\Build Instructions~~]]	+	[[Category:User Documentation]]

	==What is GLFW==		==What is GLFW==

← Older revision		Revision as of 12:45, 8 July 2006
Line 1:		Line 1:
	[[Category:Installation\Build Instructions]]		[[Category:Installation\Build Instructions]]
−	~~==Using GLFW with Code::Blocks to develop OpenGL applications==~~

	==What is GLFW==		==What is GLFW==

← Older revision		Revision as of 20:23, 11 April 2006
Line 1:		Line 1:
−	[[Category:~~Graphical Toolkits]]~~	+	[[Category:Installation\Build Instructions]]
−	~~[[Category:~~Build ~~Intructions]]~~
−	~~[[Category:Tutorials~~]]
	==Using GLFW with Code::Blocks to develop OpenGL applications==		==Using GLFW with Code::Blocks to develop OpenGL applications==

← Older revision		Revision as of 15:28, 6 February 2006
Line 1:		Line 1:
		+	[[Category:Graphical Toolkits]]
		+	[[Category:Build Intructions]]
		+	[[Category:Tutorials]]
	==Using GLFW with Code::Blocks to develop OpenGL applications==		==Using GLFW with Code::Blocks to develop OpenGL applications==

@@ Line 36: / Line 36: @@
 Code::Blocks 1.0RC2 includes a template to build a statically linked GLFW application. Since GLFW is really lightweight, there is actually no reason not to statically link to it, but if you insist on dynamic linkage, just change the include library in "Build Options" accordingly.<br /><br />
-Make a new project using the GLFW template, and hit the blue gear, you should see a windown with a few spinning triangles:
+Make a new project using the GLFW template, and hit the blue gear, you should see a window with a few spinning triangles:
 [[Image:Glfw-spin.png|The stereotypical OpenGL spinning triangle demo]]

← Older revision	Revision as of 12:46, 8 July 2006
(No difference)

@@ Line 21: / Line 21: @@
 #Download the GLFW sources (including documentation) from: http://prdownloads.sourceforge.net/glfw/glfw-2.5.zip?download
 #Unzip the archive anywhere you like (I will assume <tt>C:\glfw</tt> for simplicity).
-#For Windows users, there is a batch file which allows to compile using a variety of compilers.
+#Compile
-#*Open a DOS window, <tt>cd</tt> to the directory where GLFW lives (e.g. <tt>C:\glfw</tt>), and type <tt>compile make mgw</tt>. If you use the Borland compiler, type <tt>compile make bcc</tt> instead, and for MSVC, type <tt>compile make msvc</tt>.
+#*For Windows users, there is a batch file which allows to compile using a variety of compilers. Open a DOS window, <tt>cd</tt> to the directory where GLFW lives (e.g. <tt>C:\glfw</tt>), and type <tt>compile make mgw</tt>. If you use the Borland compiler, type <tt>compile make bcc</tt> instead, and for MSVC, type <tt>compile make msvc</tt>.
 #*Linux users will just want to type <tt>make</tt>.
 Build time is ~1 minute.
@@ Line 29: / Line 29: @@
 ==Installing GLFW==
 #Navigate to the <tt>lib\win32</tt> folder (<tt>lib\x11</tt> for Linux).
-#Copy <tt>libglfw.a</tt>, <tt>libglfwdll.a</tt>, and <tt>glfw.dll</tt> from inside the <tt>lib\win32</tt> folder (<tt>lib\x11</tt> for Linux) to where you keep your dll files (could be <tt>C:\MinGW\dll</tt> or <tt>C:\MinGW\lib</tt>, whatever).
+#Copy <tt>libglfw.a</tt>, <tt>libglfwdll.a</tt>, and <tt>glfw.dll</tt> from inside the <tt>lib\win32</tt> folder (<tt>lib\x11</tt> for Linux) to where you keep your libraries (could be <tt>C:\MinGW\dll</tt>, <tt>C:\MinGW\lib</tt>, or <tt>C:\CodeBlocks\lib</tt>, whatever).
 #Go up two levels (to the GLFW base directory), and then into <tt>include/GL</tt>. Copy <tt>glfw.h</tt> to the <tt>GL</tt> folder inside your system includes folder (e.g. <tt>C:\MinGW\include\GL</tt> or <tt>C:\codeblocks\include\GL</tt>)