Tutorials

Tutorials for getting started with programming on Linux

Red Circle

Rendering a 3D Model from the Terminal without a window manager.

Published
Liked the article? Share it!

We’ve gone from drawing one triangle, to two triangles, so in this article we cover how to draw an abritrary number of triangles. In this article we generate a circular shape by generating an array of triangles to be drawn during our draw call.

In this article we have two magor changes. The first change is that we move the shaders to be an independent file as opposed to having the shader declared as a fixed string in the main.c file. Along with this we’re going to start developing a dashgl.h header file where we will be putting functions that are useful for working with OpenGL in a self-defined library. The second change is that we’re going to generate a “circle” by generating an arbitrary number of triangles, to demonstrate to to draw multiple triangles. Let’s take a look at the file layout to see what’s changed.

- lib/ 
	- dashgl.c
	- dashgl.h
- shaders/
	- fragment.glsl
	- vertex.glsl
- main.c

As you can see we’ve moved the shaders into their own files. So let’s take a quick look at the fragment and vertex shaders respectively.

shaders/vertex.glsl
attribute vec3 vertex; void main(void) { gl_Position = vec4(vertex, 1.0); }

Basically we have the exact same shader as in the previous article, but we’ve moved it into its own file.

shaders/fragment.glsl
void main(void) { gl_FragColor = vec4(1.0, 0.0, 0.0, 1.0); }

And same with our fragment shader. The only difference is we’ve changed the color from yellow to red. To see how we’re compiling and linking the shaders, let’s go ahead and look at the main.c file to see what’s changed.

main.c
int main () { int terminate = 0; GLOBAL_T state; // Clear application state memset( &state, 0, sizeof( GLOBAL_T ) ); dgl_init_graphics(); state.program = dgl_create_program("shaders/vertex.glsl", "shaders/fragment.glsl"); init_buffers(&state); dgl_set_viewport(); while (!terminate) { draw_triangles(&state); dgl_update_screen(); } return 0; }

Most of our main function is the same from previous articles. The dgl_init_graphics is a renamed version of init_ogl from the first article, dgl_set_viewport is a renamed version of setViewport from the second article. And dgl_update_screen is also a renamed version of updateScreen from the second article. Generally with respect to code, we want to avoid any “magic” syntax that appears out of nowhere, so adding the prefix of dgl_ onto a function gives us a hint that the function is defined in dashgl.h and if someone wants to take a look at it to see how it works, or to debug something, they know where to find it.

The main difference in the main function is the newly found dgl_create_program function. Hopefully the purpose of this function is self-evident with the arguments and the name of the function. The function takes a string for the filename of a vertex shader, and the filename of a fragment shader and then compiles and links them into a program. We can go ahead and copy the definition here from dashgl.c.

lib/dashgl.c
GLuint dgl_create_program(const char *vertex, const char *fragment) { GLuint vs = dgl_create_shader(vertex, GL_VERTEX_SHADER); GLuint fs = dgl_create_shader(fragment, GL_FRAGMENT_SHADER); if(vs == 0 || fs == 0) { return 0; } GLint link_ok; GLuint program = glCreateProgram(); glAttachShader(program, vs); glAttachShader(program, fs); glLinkProgram(program); glGetProgramiv(program, GL_LINK_STATUS, &link_ok); if(!link_ok) { fprintf(stderr, "Program Link Error: "); dgl_print_log(program); return 0; } return program; }

The code here is simply code that was previously in the main.c file in the previous articles, so there’s not much to cover here. But if you’re interested in looking at the definition for the functions dgl_create_shader or dgl_print_log you can find the links for those here and here.

EGL Red Circle coordinates

Now that we have the shader aspect out of the way, we might as well get to the part where we generate an arbitrary number of triangles to generate a circular shape. Obviously the more points on the shape we draw, the more round it will appear. In this demo we chose to use a decagon as it would still show straight edges to give some not-so-subtle clues on how it was generated. And specifically how we generate the circle is shown in the figure above, and the code below.

main.c
static void init_buffers(GLOBAL_T *state) { int i, k; const int num_segments = 10; float a, b; GLfloat *circle_data; circle_data = malloc(num_segments * sizeof(GLfloat) * 9); memset( circle_data, 0, sizeof( circle_data) ); for(i = 0; i < num_segments; i++) { a = i * 2.0f * M_PI / num_segments; b = (i+1) * 2.0f * M_PI / num_segments; circle_data[i*9+0] = cos(a); circle_data[i*9+1] = sin(a); circle_data[i*9+2] = 1.0f; circle_data[i*9+3] = 0; circle_data[i*9+4] = 0; circle_data[i*9+5] = 1.0f; circle_data[i*9+6] = cos(b); circle_data[i*9+7] = sin(b); circle_data[i*9+8] = 1.0f; } ... }

Since the corndinates of the screen we’re working with go from -1 to 1, that means we’re working with a unit circle, so the distance around the circle is simply 2*PI (or tau if you’re civiliazed). So we can divide the distance around the circle into segments as a radian messurement. Then to find the point on the circle we multiply by cos of the radian to get the x position, and the position by sin to get the y position. So to generate triangles around the circle, we find the position of one segment on the circle for the first vertex, move to the center for the second vertex, and then find the position of the next segment for the third vertex. And that way we can generate a circular polygon. If you want to increase the number of segments, you will end up with a more circular result.

main.c
static void init_buffers(GLOBAL_T *state) { ... // Upload vertex data to a buffer glBindBuffer(GL_ARRAY_BUFFER, state->buf); glBufferData(GL_ARRAY_BUFFER, num_segments * sizeof(GLfloat) * 9, circle_data, GL_STATIC_DRAW); glVertexAttribPointer(state->attr_vertex, 3, GL_FLOAT, 0, 12, 0); glEnableVertexAttribArray(state->attr_vertex); free(circle_data); }

The other aspect of genrating mutliple triangles is making sure the size of the buffer and draw calls match up. In this case we want to look at the glBufferData function. We need to tell OpenGL the size of the array in bytes to store of all the data that we want to store in GPU memory. Each vertice is going to be three float values. And for each triangle we have three vertexes. So the size of the buffer is the number of segments (which becomes triangles), times three coordinates, times three vertices, times the size of a float. As for glVertexAttribPointer we don’t need to change any of the values as the count has changes, but not the stride, so this function will still work with the arguments from the previous article.

main.c
static void draw_triangles(GLOBAL_T *state) { glBindFramebuffer(GL_FRAMEBUFFER,0); glClear(GL_COLOR_BUFFER_BIT|GL_DEPTH_BUFFER_BIT); glBindBuffer(GL_ARRAY_BUFFER, state->buf); glUseProgram ( state->program ); glDrawArrays ( GL_TRIANGLES, 0, 3 * 10 ); glFlush(); glFinish(); }

Finally the last change in this article is the drawArrays function. With this function we need to tell OpenGL how many triangles we want to draw. So if each triangle has three vertices, then the number we need to put it needs to be divisible by three. And since we have 10 segments define, that means the length in vertices for the draw count is 3* 10;

Review

In these first three articles we’ve gone from drawing one triangle, to two triangles, to an arbitrary number of triangles. We’ve filled in on some of the basics of drawing triangles by compiling shaders, bindbing attributes, binding buffers and then drawing to the screen. In the next article we will move our focus to something we have skipped over in these previous articles which is the fragment shader.