InstallationOBT

Un article de OpenMASKWiki.

Jump to: navigation, search

Sommaire

Introduction

OBT (Open Bunraku Tools) DSI (Dot Scene Interface) et HBT (Humano Basic Tools) sont des petites bibliothèques d'utilitaires voir la documentation en ligne

Vous pouvez installer la totalité du projet à partir de la forge OBT : https://gforge.inria.fr/projects/obt/ (Install Linux ou Install Windows).

Il y a 3 packages à installer dans cet ordre :

  • obt : Open Bunraku Tools (archive OBT ou svn://scm.gforge.inria.fr/svn/obt/obt/... si vous préférez utiliser SVN)
  • dsi : Dot Scene Interface (archive DSI ou svn://scm.gforge.inria.fr/svn/obt/dsi/... si vous préférez utiliser SVN)
  • hbt : Humano Basic Tools (archive HBT ou svn://scm.gforge.inria.fr/svn/obt/hbt/... si vous préférez utiliser SVN). Ce module est optionnel à partir de la version 4.2 d'OpenMASK

Vous pouvez choisir d'utiliser les archives (recommandé) ou le SVN

Vous trouverez également sur cette forge les sources de WildMagic version 4 qui est une dépendance pour le visualiseur d'OpenMASK et difficile à trouvez sur la toile.

installation sous Linux

Installation à partir du SVN

  • Pour récupérer les sources par SVN (donc si vous ne souhaitez pas utiliser les archives) placez vous dans le répertoire approprié (par exemple pour obt : /local/soft/obt)
cd /local/soft
mkdir obt (si le répertoire /local/soft/obt n'existe pas)
cd obt

Si vous souhaitez utiliser la dernière version présente sur la forge (à vos propres risques):

svn checkout svn://scm.gforge.inria.fr/svn/obt/MODULE/trunk (ici , MODULE = obt)

Nous recommandons cependant d'utiliser la dernière release (l'exemple ci-dessous montre le cas de la version 1.4.0)

svn checkout svn://scm.gforge.inria.fr/svn/obt/MODULE/branches/v_1_4_0-branch  (ici , MODULE = obt)
  • svn crée un répertoire trunk ou v_x_x_x-branch et y télécharge l'ensemble des fichiers du projet
  • Allez dans le répertoire créé
cd trunk

ou

cd v_x_x_x-branch
  • puis suivez les étapes d'installation ci-dessous à partir de l'étape 2

Installation à partir des archives

  • Télécharger les archives aux adresses indiquées et les extraires. Aller dans le dossier ainsi créé
  • Créez un répertoire build
mkdir build
  • Entrez dans le répertoire build
cd build
  • Lancez la commande cmake avec le CMakelists.txt qui se trouve à la racine d'OBT en précisant éventuellement le répertoire d'installation (la variable INSTALLPREFIX est utilisée à cette fin), ainsi que le type de build (Debug ou Release, par défaut Release)
cmake .. -DINSTALLPREFIX:PATH=/local/soft -DCMAKE_BUILD_TYPE=Release
  • Lancez la compilation et l'installation
make install
  • L'installation créera les répertoires suivants dans le répertoire d'installation :
    • include contenant tous les entêtes (*.h) de la bibliothèque
    • lib contenant la bibliothèque (libOBT.so)
    • lib/pkgconfig contenant le configuration de la bibliothèque (OBT.pc)
  • Vous devez ajouter le chemin d'accès à OBT.pc dans votre variable d'environnement PKG_CONFIG_PATH et le chemin d'accès à libOBT.so dans votre variable d'environnement LD_LIBRARY_PATH, modifiez au besoin votre ~/.cshrc
setenv PKG_CONFIG_PATH "/local/soft/lib/pkgconfig:$PKG_CONFIG_PATH"
setenv LD_LIBRARY_PATH "/local/soft/lib:$LD_LIBRARY_PATH"
  • Pour savoir à posteriori si la librairie a été compilée en Debug ou en Release, il suffit de consulter la variable buildtype du fichier OBT.pc
pkg-config OBT --variable=buildtype

Installation sous Windows

Installation de HTB, OBT et DSI

Télécharger et extraire les archives (recommandé) ou récupérer les sources sur la forge pour chaque librairie avec un client SVN (ex: TortoiseSVN) dans le répertoire de votre choix (ex : c:\obt pour OBT): Si vous souhaitez utiliser la dernière version présente sur la forge (à vos propres risques):

svn://scm.gforge.inria.fr/svn/obt/MODULE/trunk 

Nous recommandons cependant d'utiliser la dernière release (l'exemple ci-dessous montre le cas de la version 1.4.0)

svn://scm.gforge.inria.fr/svn/obt/MODULE/branches/v_1_4_0-branch

Il y a 3 packages à installer dans cet ordre :

  • obt : Open Bunraku Tools (archive OBT ou svn://scm.gforge.inria.fr/svn/obt/obt/... si vous préférez utiliser SVN)
  • dsi : Dot Scene Interface (archive DSI ou svn://scm.gforge.inria.fr/svn/obt/dsi/... si vous préférez utiliser SVN)
  • hbt : Humano Basic Tools (archive HBT ou svn://scm.gforge.inria.fr/svn/obt/hbt/... si vous préférez utiliser SVN). Ce module est optionnel à partir de la version 4.2 d'OpenMASK


Pour chacun, la procédure d'installation est la suivante (l'exemple suivant montre l'installation d'obt):

  1. lancer cmake-gui (il peut être nécessaire de le relancer entre chaque installation pour prendre en compte les nouvelles variables d'environnement, voir même d'ouvrir l'éditeur de variables de windows, puis le fermer en faisant ok, pour les prendre en compte. Il n'y a pas de meilleure solution actuellement)
  2. Indiquer où se situe le code source (ex : c:\obt).
  3. Indiquer où créer la solution (ex : obt\build)
  4. Cliquer sur configure
  5. Indiquer l'outil de programmation que vous souhaitez utiliser
  6. Si vous souhaiter spécifier un répertoire d'installation autre que celui par défaut, modifiez l'entrée CMAKE_INSTALL_PREFIX (ex : c:\obt)
  7. Cliquer à nouveau sur configure
  8. Cliquer sur Generate
  9. Une fois la génération terminée, rendez-vous dans le répertoire où la solution a été créée (ex : obt\build) et lancez la solution (fichier .sln pour Microsoft Visual Studio)
  10. Vous pouvez sélectionner le mode de compilation Debug, Release, ...
  11. Pour lancer la compilation : clic droit sur ALL_BUILD et générer
  12. Pour lancer l'installation (lance également la compilation si necessaire) : clic droit sur INSTALL et générer
  13. Si vous avez spécifié un répertoire d'installation à l'étape 6 et si elle n'existe pas, créer la variable d'environnement correspondant indiquant le dossier où le package a été installé (ex : OBT_HOME => c:\obt).


Les variables d'environnement sont :

  • OBT_HOME
  • DSI_HOME
  • HBT_HOME
  • WM4_HOME

Installation de WildMagic 4

  1. WildMagic est décrit sur le site de Geometric Tools, mais de nouvelles versions ont remplacé celle utilisée dans OpenMASK. Aussi nous fournissons les sources de la version 4 dans la forge obt - Fichiers : [1] ainsi qu'un complément cmake pour le compiler comme dépendance d'OpenMASK.
  2. Récupérer le fichier zip et extraire l'archive des sources WM4
  3. Récupérer les fichiers cmake dans cette archive WildMagic4 (recommandé) ou en utilisant votre client SVN sur svn://scm.gforge.inria.fr/svn/obt/WildMagic4/
  4. Copier les fichiers récupérés dans l'arborescence extraite de l'archive extraite à l'étape 2.
  5. Suivre les étapes d'installation des autres packages d'OBT
Navigation