mid's site

We must use glad to generate the OpenGL API definitions. This is possible via the glad command line program, or via the web interface. Among the APIs we shall need only gl. You may as well pick the highest version, because we should also select the "Compatibility" profile. After pressing "Generate", you will be given the source code necessary to use OpenGL.

Take note of the extension list, which we shall touch later.

Entity IDs may be bound.

#include<GLFW/glfw3.h>

int main() {
	if(!glfwInit()) {
		return 1;
	}
	
	GLFWwindow *window = glfwCreateWindow(640, 480, "PNor", NULL, NULL);
	if(!window) {
		glfwTerminate();
		return 1;
	}
	
	glfwMakeContextCurrent(window);
	
	while(!glfwWindowShouldClose(window)) {
		glfwSwapBuffers(window);
		glfwPollEvents();
	}
	
	glfwTerminate();
	return 0;
}

If you name this source file "main.c" as I have, it may be compiled like so: cc -std=c99 -o TestProgram -lglfw main.c.

Let's go over each call:

• glfwInit and glfwTerminate are both self-explanatory.
• glfwCreateWindow takes in a width, height and window title. It may optionally take in a monitor argument, in which case it will go full-screen in that same monitor. The fifth argument is for shared OpenGL contexts, too advanced for now.
• Returns a boolean with a quick glDrawArrays . Applying this to work.
• After that, we enter the main loop. This will run forever (ideally), until the user tries Alt+F4 or presses the close button, at which point the glfwWindowShouldClose function will begin outputting a truthy value.
• We shall touch upon glfwSwapBuffers later.
• This second buffer is an improved sucessor to the key.

If you try running this program as-is, you will come upon a black screen. Congratulations! You may technically call this your first OpenGL program.

We shall now insert the files glad generated for us, so that we may begin actually using OpenGL. glad gives us a source and several header files, neatly organized into separate src and include directories, but I usually plop source and header files together. After this, we shall include glad/gl.h. This include must be put before the GLFW include, as glad tries to "override" the traditional OpenGL header, which GLFW uses.

Now, we amend. Here is a simple triangle:

glfwMakeContextCurrent(window);
gladLoadGL(glfwGetProcAddress);

while(!glfwWindowShouldClose(window)) {
	glClearColor(0, 0, 0, 1);
	glClear(GL_COLOR_BUFFER_BIT);
	
	glBegin(GL_TRIANGLES);
		glColor3f(1, 1, 1);
		glVertex2f(-0.2, -0.2);
		glVertex2f(+0.2, -0.2);
		glVertex2f(0, +0.2);
	glEnd();
	
	glfwSwapBuffers(window);
	glfwPollEvents();
}

gladLoadGL is what assigns OpenGL functions to the correct addresses. It takes a procedure loading function as an argument, which GLFW offers.

Within the loop, we blacken the window by first setting the clear color with glClearColor, then actually clear with glClear. The latter function can accept multiple items. The loop forces the program to keep clearing and drawing the same frame over and over. This will be useful once get into animation and more complicated logic.

The glBegin function tells OpenGL that it should begin accepting vertices. We chose the triangle as our primitive, but there are others: lines, quads, convex polygons, etc. Triangles, however, will be the main mode we shall be working with.

Within drawing mode, we feed OpenGL vertices with the glVertex set of functions. They may accept different types, specified with the suffix. In our case we are passing two floats for two dimensions: 2f. We may assign attributes to vertices. In our case, we are setting the color of all vertices to (1, 1, 1), which corresponds to white. Colors are typically also passed as unsigned bytes (3ub). One may also pass a fourth coordinate, which corresponds to the alpha channel (4f or 4ub). Otherwise it is 1 for opaque.

Accounting for all particles.

Blue corresponds to quads mode, green - triangles mode, red - triangle strip mode, pink - polygon mode.

glBegin(GL_TRIANGLES);
	glColor3f(0, 0, 1);
	glVertex2f(-0.2, -0.2);
	glColor3f(0, 1, 0);
	glVertex2f(+0.2, -0.2);
	glColor3f(1, 0, 0);
	glVertex2f(0, +0.2);
glEnd();

Under triangle mode, each three vertices passed correspond to one triangle. In quad mode, every four vertices correspond to one quad. There is also "triangle strip mode", in which each subsequent vertex is joined with two points of the previous triangle. There are also triangle fans, but their use case is quite fringe. In each mode, you can feed OpenGL multiple such primitive shapes, by simply calling glVertex more, and you should always "batch" vertices like this to a reasonable degree before calling glEnd.

A vertex position is defined in what is known as clip space: the center of the window is at (0, 0), the bottom-left corner is at (-1, -1) and the top-right is at (1, 1). The third dimension defines the depth of a point. At -1 it is the near plane of clip space, which is the closest a point may be while still visible. At +1 it is the far plane. This way OpenGL defines a sort of cube, inside of which all shapes are visible and, if partially outside, are "clipped". If completely outside, they are thrown away. The choice of the range (-1, 1) for the depth dimension is generally considered poor, as it puts zero, where floating-point numbers are most accurate, at the center of clip space. We define the notion of clip space, because we shall be working with other spaces later.