OpenGL Moderne

On parle ici des #define et #include.

L'étape du préprocesseur est très simple : du copier-coller.

Lorsque le préprocesseur voit le code du fichier MyCode.c suivant :

#include "MyHeader.h"
 
void main(){
    FunctionDefinedInHeader();
}

Il ouvre simplement le fichier MyHeader.h et copie-colle son contenu dans le fichier MyCode.c.

// Début de MyCode.c
// Début de MyHeader.h
#ifndef MYHEADER_H
#define MYHEADER_H

void FunctionDefinedInHeader(); // Déclare la fonction

#endif
// Fin de MyHeader.h

void main(){
    FunctionDefinedInHeader(); // Utilisation
}

// Fin de MyCode.c

De façon similaire, les #define sont copiées-collées, les #if sont analysés et potentiellement retirés, etc.

À la fin de cette étape, vous obtenez un fichier C++, sans #define, #if, #ifdef, #include, prêt à être compilé.

Par exemple, voici le fichier main.cpp du sixième tutoriel, complètement prétraité dans Visual : fichier prétraité. Attention, c'est un immense fichier ! Mais cela vaut le coup de savoir ce qu'un fichier .cpp simple est réellement pour le compilateur.

Le compilateur traduit le code C++ en une représentation que le CPU peut comprendre directement. Par exemple, le code suivant :

int i=3;
int j=4*i+2;

sera traduit en ces opcodes x86 :

mov         dword ptr [i],3
mov         eax,dword ptr [i]
lea         ecx,[eax*4+2]
mov         dword ptr [j],ecx

Chaque fichier .cpp est compilé séparément et le code binaire résultant est écrit dans des fichiers .o/.obj.

L'éditeur de liens prend tout le code binaire (les vôtres, mais aussi celui des bibliothèques externes) et génère l'exécutable final. Quelques notes :

• Une bibliothèque possède l'extension .lib.
• Certaines bibliothèques sont statiques. Cela signifie que les .lib contiennent tous les opcodes x86 nécessaires.
• Certaines bibliothèques sont dynamiques (aussi appelées « bibliothèques partagées »). Cela signifie que le fichier .lib ne contient pas tout le code x86 ; il indique simplement : « Je jure que la fonction Foo, Bar et WhatsNot seront disponibles à l'exécution ».

Lorsque l'éditeur de liens a été exécuté, vous obtenez un exécutable (.exe sous Windows, sans extension sous Unix) :

Lorsque vous lancez l'exécutable, le système d'exploitation va ouvrir le .exe et placer les opcodes x86 en mémoire. Comme indiqué précédemment, certains codes ne sont pas disponibles à ce moment-là : le code des bibliothèques dynamiques. Mais l'éditeur de liens a été assez gentil pour indiquer où les trouver : le .exe indique clairement que la fonction glClearColor est implémentée dans le fichier OpenGL32.dll.

Windows va ouvrir la .dll et trouver glClearColor :

Quelques fois, une .dll ne peut être trouvée, sûrement, car l'installation a échoué et le programme ne peut pas s'exécuter.

III-A-1. Créer un nouveau projet▲

III-A-2. Ajouter un fichier source dans un projet▲

III-A-3. Ajouter un répertoire d'inclusion▲

III-A-4. Lier une bibliothèque▲

III-A-5. Compiler, exécuter et déboguer▲

QtCreator est disponible gratuitement à cette adresse.

III-B-1. Créer un nouveau projet▲

Utilisez un projet vide C ou C++ ; éviter les templates contenant des trucs de Qt.

Utilisez les options par défaut.

III-B-2. Ajouter un fichier source dans un projet▲

SOURCES += main.cpp \
           other.cpp \
           foo.cpp

III-B-3. Ajouter un répertoire d'inclusion▲

INCLUDEPATH += <chemin> \ <autre chemin>

III-B-4. Lier avec une bibliothèque▲

III-B-5. Compiler, exécuter et déboguer▲

CMake créera les projets et cela pour pratiquement tous les outils de compilation : Visual, Qt Creator, XCode, make, Code::Blocks, Eclipse, etc., sur n'importe quel système d'exploitation. Cela vous libère de la maintenance de multiples fichiers de projet.

III-C-1. Créer un nouveau projet▲

cmake_minimum_required (VERSION 2.6)
project (le_nom_du_projet)

find_package(OpenGL REQUIRED)

add_executable(le_nom_de_l_executable
    tutorial04_colored_cube/tutorial04.cpp
    common/shader.cpp
    common/shader.hpp
)

III-C-2. Ajouter un fichier source dans un projet▲

III-C-3. Ajouter des répertoires d'inclusion▲

include_directories(
    external/AntTweakBar-1.15/include/
    external/glfw-2.7.2/include/
    external/glm-0.9.1/
    external/glew-1.5.8/include/
    .
)

III-C-4. Lier une bibliothèque▲

set(ALL_LIBS
    ${OPENGL_LIBRARY}
    GLFW_272
    GLEW_158
    ANTTWEAKBAR_151_OGLCORE_GLFW
)

target_link_libraries(tutorial01_first_window
    ${ALL_LIBS}
)

III-C-5. Compiler, exécuter et déboguer▲

Veuillez, s'il vous plaît, ne pas utiliser cela.

Cela peut être intéressant de compiler un petit projet « à la main » afin de mieux comprendre le flux de travail. Ne le faites pas sur un vrai projet…

Compilez chaque fichier .cpp séparément :

g++ -c main.cpp
g++ -c tools.cpp

Comme indiqué précédemment, vous allez obtenir des fichiers main.o et tools.o. Liez-les :

g++ main.o tools.o

un fichier a.out apparaît ; c'est votre exécutable. Exécutez-le :

./a.out

C'est tout !

(Ou n'importe quel autre fichier.)

Certains entêtes ont des emplacements bizarres. Par exemple, les fichiers à inclure de GLEW sont situés dans external/glew-x.y.z/include. Le compilateur n'a aucune méthode magique pour le deviner, donc vous devez les lui indiquer. Dans les propriétés du projet, ajoutez le chemin approprié dans les options du compilateur (et non pas l'éditeur de liens).

Pour aucune raison vous ne devriez copier les fichiers dans les répertoires du compilateur (Program Files/Visual Studio/…). Techniquement, cela fonctionnera, mais c'est une très mauvaise pratique.

De plus, c'est une bonne chose d'utiliser des chemins relatifs (./external/glew/… au lieu de C:/Users/utilisateur/Downloads/…).

Par exemple, voici ce que contiennent les fichiers de CMake de ces tutoriels :

external/glfw-2.7.2/include
external/glm-0.9.1
external/glew-1.5.8/include

Répétez cela jusqu'à ce que tous les fichiers soient trouvés.

(ou n'importe quel autre fichier.)

Cela signifie que la bibliothèque n'est pas installée. Si vous êtes chanceux, la bibliothèque est connue et vous n'avez qu'à l'installer. C'est le cas pour GLFW, GLEW et GLM :

sudo apt-get install libglfw-dev libglm-dev libglew1.6-dev

Si ce n'est pas une bibliothèque répandue, regardez la réponse pour Visual Studio ci-dessus.

(ou n'importe quel autre symbole dans n'importe quelle autre fonction.)

Félicitations ! Vous avez une erreur d'édition de liens. C'est une excellente nouvelle : cela signifie que la compilation a réussi. Plus qu'une dernière étape !

Les fonctions GLFW se trouvent dans une bibliothèque externe. Vous devez indiquer cette bibliothèque à l'éditeur de liens. Ajoutez-la dans les options de l'éditeur de liens. N'oubliez pas d'ajouter le chemin menant à cette bibliothèque.

Par exemple, voici ce que le projet Visual Studio utilise. Les noms sont quelque peu inhabituels, car c'est une compilation personnalisée. De plus, GLM ne nécessite pas d'être compilée ou liée, donc elle n'est pas là.

external\Debug\GLFW_272.lib
external\Debug\GLEW_158.lib

Si vous téléchargez ces bibliothèques à partir de SourceForge (GLFW, GLEW) et les compilez vous-même, vous devez spécifier le chemin adéquat. Par exemple :

C:\Ou\Vous\Avez\Place\La\Bibliotheque\glfw.lib
C:\Ou\Vous\Avez\Place\La\Bibliotheque\glew32.lib

(ou n'importe quel autre symbole.)

Même réponse que pour Visual Studio ci-dessus.

Cela peut être quelque peu difficile à tracer. Il y a plusieurs solutions :

V-E-1. J'ai une erreur durant l'édition des liens avec _imp_glewInit ou d'autres symboles qui commencent par _imp▲

GLEW_STATIC

V-E-2. J'ai quelques problèmes étranges avec GLFW▲

GLFW_DLL

V-E-3. J'ai un autre problème avec l'éditeur de liens ! Aidez-moi, je suis bloqué !▲

V-E-4. J'aimerais résoudre cela moi-même. Quelles sont les règles générales ?▲

Il y a de multiples raisons qu'une application C++ OpenGL plante. Voici quelques-unes d'entre elles. Si vous ne connaissez pas la ligne exacte où votre programme plante, apprenez à utiliser un débogueur (voir les raccourcis ci-dessus). Veuillez NE PAS déboguer avec printf().

V-F-1. Je n'atteins même pas le main▲

V-F-2. Mon programme crashe sur glfwOpenWindow(), ou toute autre fonction qui crée un contexte OpenGL▲

Trois raisons sont possibles :

• vous n'avez pas appelé glewInit() APRÈS glfwOpenWindow() ;

• vous utilisez un profil OpenGL core et vous n'avez pas créé de VAO. Ajoutez le code suivant après glewInit() :
  

   

  Sélectionnez

  GLuint VertexArrayID;
  glGenVertexArrays(1, &VertexArrayID);
  glBindVertexArray(VertexArrayID);

• Vous utilisez la version de GLEW par défaut, qui contient un bogue. Vous ne pouvez utiliser un profil OpenGL core à cause de celui-ci. Utilisez soit glewExperimental=true

• avec glewInit(), ou demandez à GLFW d'utiliser un profil de compatibilité à la place :
  

glfwOpenWindowHint(GLFW_OPENGL_PROFILE, GLFW_OPENGL_COMPAT_PROFILE);

Définissez votre répertoire de travail correctement. Lisez le premier tutoriel.

Créez un fichier test.txt et essayez le code suivant :

if ( fopen("test.txt", "r" ) == NULL ){
    printf("I'm probably running my program from a wrong folder");
}

Sincèrement ! Ne déboguez pas avec printf() ; utilisez un bon EDI. http://www.dotnetperls.com/debugging est pour le C# mais est aussi valide pour le C++. Cela peut être différent pour XCode ou Qt Creator, mais les concepts restent exactement les mêmes.

Veuillez utiliser le forum.