Le jour de l'exposé
Une démo en direct comporte des risques, mais la plupart peuvent être anticipés. Cette page liste les points à vérifier avant l'exposé.
Avant de partir
- Un serveur web local. La démo est une page web qui charge
project.wasm: ouvrez les slides à travers un serveur, pas comme des fichiers.python3 -m http.server 8080dans le dossier des slides suffit, et marche sans réseau. - Hors ligne. Tout ce dont la démo a besoin est dans son dossier : pas de CDN. Vérifiez ce que les slides
chargent depuis le réseau (un framework de slides depuis un CDN, des polices) et copiez-le en local. Les
fichiers
.datasont téléchargés à la première visite de la slide : gardez-les petits. - Sur la machine de l'exposé. Une autre carte graphique, un autre navigateur, une autre résolution d'écran. Ouvrez-y une fois chaque slide avec une démo, et parcourez les slides à la télécommande, après un clic dans chaque démo.
- Plusieurs démos dans une même page (reveal.js charge ses slides ensemble) : un navigateur limite le
nombre de contextes WebGL. Chargez les cadres avec leur slide (
data-srcdans reveal.js) plutôt que tous au départ.
Lisibilité au projecteur
- Le panneau : gardez la taille par défaut sur une slide entière ;
compact=1seulement pour une petite démo. - ImGui : agrandissez-le (
gui_scale=1.4), et gardez ses sections fermées au départ. - Les lignes : WebGL dessine les lignes sur un pixel de large dans la plupart des navigateurs. Dessinez ce qui doit se voir en tubes ou en maillages.
- Les couleurs : la lumière d'un projecteur délave les tons sombres ; un fond blanc ou clair se lit généralement mieux qu'un fond sombre.
Une image dans le PDF
Les organisateurs demandent le PDF de l'exposé, et un PDF ne peut pas faire tourner un programme. Mettez une image de la démo dans la slide, montrée seulement à l'impression, avec le cadre montré seulement à l'écran :
<iframe class="demo live" src="demo/index.html?ampl=0.2"></iframe> <img class="still" src="demo/poster.png" alt="A ripple on a surface"> <style> @media screen { .still { display: none; } } @media print { .live, .controls { display: none; } } </style>
poster.png est une capture d'écran de la démo. Les tests du dépôt la capturent pour chaque exemple
(ci-dessous).
Une vidéo en plan B
Gardez une vidéo de chaque démo, prête à être jouée si la démo en direct échoue. La meilleure vidéo vient du programme lui-même, pas d'un enregistrement d'écran : lancez-le en natif avec un pas de temps fixe, enregistrez chaque image, puis faites la vidéo :
./project --dt 0.0166667 --record frames/ --frames 300 ffmpeg -framerate 60 -i frames/frame_%05d.png -pix_fmt yuv420p demo.mp4
(--dt, --record et --frames sont des options à ajouter à votre programme : un pas fixe au lieu de
l'horloge, glReadPixels après chaque image, un arrêt après N images.) Le mouvement est alors exactement
celui de la démo en direct, fluide quelle que soit la vitesse de la machine, et plusieurs vidéos sont
synchronisées image par image.
Le tester automatiquement
Un test dans un navigateur repère, avant l'exposé, la démo qui ne démarre pas, le bouton qui ne fait rien ou la flèche qui reste dans la démo. Chaque exemple en a un : voir Tester une démo.
En cas de problème
- Le cadre est vide : ouvrez la page de la démo seule, à travers le serveur, et lisez la console du
navigateur.
Cannot load project.js: un nom de fichier, ou une page ouverte comme fichier. - Le dessin occupe un coin du cadre : le programme a créé sa fenêtre à une taille fixe ; créez-la à la taille du canvas (exemple 1).
- Un contrôle ne fait rien : dans la console de la démo,
Module.ccall('slide_describe', 'string', [], [])liste les paramètres déclarés ; une clé decontrols=qui n'est pas déclarée est ignorée, avec un avertissement. - Les flèches s'arrêtent à la démo : la page de la démo n'est pas
slide-frame.html. - Le fil de fer manque sur le web :
glPolygonModen'existe pas en WebGL ; dessinez des lignes.