Votre propre programme dans une slide
Cette page rassemble, en une seule liste d'étapes, ce que les exemples montrent morceau par morceau : comment prendre votre propre programme C++ OpenGL (avec GLFW) et le montrer dans une slide. Chaque étape renvoie à l'exemple où elle est expliquée en détail. Si votre programme utilise la bibliothèque CGP, voyez le cas de CGP à la fin de la page.
1. Copier le pont dans votre projet
Depuis le zip du dépôt (ou celui de
l'exemple 1), copiez les trois fichiers de bridge/ :
slide_bridge.hppetslide_bridge.cpp: ajoutez-les aux sources de votre programme. Ils lisent les réglages donnés par la slide, et ne dépendent que de la bibliothèque standard.slide-frame.html: la page qui montre votre programme dans le cadre de la slide (étape 4).
2. Adapter le programme pour le web
Le programme se compile pour le web avec Emscripten (WebGL 2, qui correspond à OpenGL ES 3.0). Quatre endroits
diffèrent de la version bureau ; dans l'exemple 1, ils sont marqués par
#ifdef __EMSCRIPTEN__ :
-
Les en-têtes :
<GLES3/gl3.h>(et<emscripten/emscripten.h>,<emscripten/html5.h>) au lieu de votre chargeur OpenGL (glad, glew). -
La première ligne des shaders :
#version 300 esetprecision highp float;au lieu de#version 330 core. -
La taille de la fenêtre : la taille du canvas de la page,
emscripten_get_canvas_element_size("#canvas", &width, &height), utilisée pourglfwCreateWindowet relue à chaque image pour le viewport. Demandez à GLFW un contexte OpenGL ES 3.0 (GLFW_CLIENT_API,GLFW_OPENGL_ES_API). -
La boucle principale : déplacez le corps de votre boucle
whiledans une fonctionframe(), et donnez-la au navigateur :#ifdef __EMSCRIPTEN__ emscripten_set_main_loop(frame, 0, 1); #else while (!glfwWindowShouldClose(window)) frame(); #endif
Rem. Certaines fonctions OpenGL n'existent pas en WebGL, comme glPolygonMode (fil de fer) ou les lignes
épaisses : voir les notes de l'exemple 4 et de l'exemple 6.
3. Déclarer les réglages
Au début de main(), lisez les arguments, puis déclarez les variables que la slide peut régler :
#include "slide_bridge.hpp" int main(int argc, char* argv[]) { slide::parse(argc, argv); // the settings of the address: ?speed=0.2 gives --speed 0.2 slide::param("speed", speed, 0.0f, 1.0f, 0.01f); // a float, with its range and its step slide::param("wireframe", wireframe); // a bool slide::action("reset", [] { reset_scene(); }); // a button // ... the rest of your program }
La page construit son panneau à partir de ces déclarations (exemple 2) ; les boutons de la slide utilisent les mêmes noms (exemple 4). La liste complète est dans la référence.
4. Compiler pour le web
Ajoutez les options d'édition de liens d'Emscripten à la compilation web. Avec CMake :
if(EMSCRIPTEN) target_link_options(project PRIVATE -sUSE_GLFW=3 -sMIN_WEBGL_VERSION=2 -sMAX_WEBGL_VERSION=2 -sEXPORTED_FUNCTIONS=_main,_slide_set,_slide_describe -sEXPORTED_RUNTIME_METHODS=ccall) endif()
-sEXPORTED_FUNCTIONSet-sEXPORTED_RUNTIME_METHODSpermettent à la page de communiquer avec le pont.- Si le programme lit des fichiers (shaders, maillages, textures), ajoutez
--preload-file <folder>: ils sont regroupés dansproject.data, à côté deproject.js. - Rem. Le module raw_opengl_demo.cmake des exemples fait tout cela, et peut être inclus comme dans l'exemple 1.
Compilez ensuite, avec le SDK Emscripten activé :
emcmake cmake -S . -B build_web cmake --build build_web
build_web/ contient alors project.js et project.wasm (et project.data avec --preload-file). Copiez
slide-frame.html à côté d'eux, sous le nom index.html : c'est la page de la démo. Si votre exécutable ne
s'appelle pas project, changez script: 'project.js' dans le bloc CONFIG en haut de slide-frame.html.
5. Mettre la démo dans une slide
Copiez le dossier de la démo (index.html, project.js, project.wasm...) à côté de vos slides, par exemple
dans demo/, puis :
- reveal.js : un cadre dans une
<section>,<iframe class="demo" data-src="demo/index.html?speed=0.2"></iframe>(voir slides.html de l'exemple 1). - lhtml-site : le dossier dans
src/_demo/, et dans la slidedemo::../_demo/index.html?speed=0.2(voir la slide lhtml-site de l'exemple 1).
Montrez les slides à travers un serveur web (python3 -m http.server 8080 dans leur dossier), et non comme
des fichiers.
- > Vérifiez que la démo remplit son cadre, que les réglages de l'adresse sont appliqués, et que les flèches changent toujours de slide après un clic dans la démo.
Avec CGP
Un projet CGP se compile déjà pour le web. Trois étapes suffisent (exemple 3) :
- copiez
slide_bridge.hppetslide_bridge.cppdanssrc/; - ajoutez les options d'édition de liens du pont à la compilation web de
CMakeLists.txt:-sEXPORTED_FUNCTIONS=_main,_slide_set,_slide_describe -sEXPORTED_RUNTIME_METHODS=ccall; - utilisez
slide-frame.htmlcomme page de la démo (copiée sous le nomindex.htmlà côté deproject.js).
Déclarez ensuite les réglages comme à l'étape 3, par exemple dans scene.cpp (exemple 4).
Ensuite : Le jour de l'exposé.