InstallationOBT

Un article de OpenMASKWiki.

Jump to: navigation, search

Sommaire

[modifier]

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 (Linux ou Windows).

[modifier]

Installation à partir de la forge sous Linux

Il y a 3 packages à installer dans cet ordre :

  • obt : Open Bunraku Tools (svn://scm.gforge.inria.fr/svn/obt/obt/...)
  • dsi : Dot Scene Interface (svn://scm.gforge.inria.fr/svn/obt/dsi/...)
  • hbt : Humano Basic Tools (svn://scm.gforge.inria.fr/svn/obt/hbt/...). Ce module est optionnel à partir de la version 4.2 d'OpenMASK


  • Pour récupérer les sources 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
  • 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


[modifier]

Installation sous Windows

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 (svn://scm.gforge.inria.fr/svn/obt/obt/...)
  • dsi : Dot Scene Interface (svn://scm.gforge.inria.fr/svn/obt/dsi/...)
  • hbt : Humano Basic Tools (svn://scm.gforge.inria.fr/svn/obt/hbt/...). 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). Il est conseillé d'utiliser la dernière branche, plutôt que le trunk
  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
[modifier]

Installation de WildMagic 4

  1. Téléchargez la dernière version sur le site de Geometric Tools
  2. Extraire l'archive
  3. Récupérer les fichiers supplémentaires en utilisant votre client SVN sur svn://scm.gforge.inria.fr/svn/obt/WildMagic4/
  4. Copier les fichiers récupérés par le SVN dans l'arborescence extraite de l'archive extraite à l'étape 2.
  5. Suivre les étapes d'installation des autres packages d'OBT
Récupérée de « http://www.openmask.org/wiki/index.php?title=InstallationOBT »
Navigation