Installation#

Pour le tutoriel Premiers pas avec Splash, vous devez installer Splash uniquement.

Les autres exemples de la section Tutoriels nécessitent l’utilisation de l’outil d’export de Blender. Vous devez installer Blender ainsi que le Addon Blender en plus d’installer Splash. Lorsque vous avez complété ces installations, vous pourrez continuer avec le tutoriel Exemple avec un seul projecteur.

Télécharger et installer Splash#

Pour pouvoir commencer à utiliser Splash sur votre poste de travail, vous devez le télécharger puis l’installer.

Voici des instructions sur comment réaliser ces deux étapes, et ce, selon votre configuration et votre cas d’utilisation.

Configurations disponibles :

Information au sujet des dépendances de Splash#

Splash nécessite quelques bibliothèques pour lui permettre de fonctionner. Les bibliothèques obligatoires sont :

  • Dépendances externes :

    • FFmpeg pour lire et écrire des fichiers vidéo,

    • OpenGL, qui devrait installé par le pilote de la carte graphique,

    • GSL (GNU Scientific Library) pour calculer le calibrage,

  • Dépendances externes empaquetées comme des sous-modules :

    • GLFW pour gérer la création du contexte GL,

    • GLM pour faciliter la manipulation de matrices,

    • Snappy pour gérer la décompression du codec Hap,

    • cppzmq pour ses liaisons C++ avec ZMQ

    • JsonCpp pour télécharger et sauvegarder la configuration,

    • stb_image pour lire des images.

    • stduuid pour lire des images.

  • Dépendances de sous-modules réalisées à l’étape de compilation :

    • doctest pour effectuer des tests unitaires,

    • ImGui pour dessiner l’interface graphique,

    • ZMQ pour communiquer entre les différents processus d’une séance Splash,

D’autres bibliothèques sont optionnelles :

  • Dépendances externes :

    • libshmdata pour lire des flux vidéos à partir d’une mémoire partagée,

    • portaudio pour lire et jouer du son,

    • Python pour ses capacités de scriptage,

    • GPhoto pour utiliser une caméra pour le calibrage des couleurs.

  • Dépendances de sous-modules réalisées à l’étape de compilation :

    • libltc pour lire des codes temporels provenant d’une entrée sonore,

Aussi, la police de caractère Roboto et la famille de polices DSEG sont utilisées et distribuées sous la licence Apache.

Par défaut Splash est compilé en utilisant les librairies fournies comme sous-modules, mais il est possible de l’obliger à utiliser les librairies déjà installées sur le système. Ceci est décrit dans la section Compilation manuelle.