Débuter avec libfive Studio

Introduction

Comment désigner correctement ce logiciel? En fait, il s'agit d'un ensemble comprenant :

• Tout d'abord une bibliothèque, appelée libfive, conçue pour de multiples applications.
• Complétée d'une GUI (interface utilisateur graphique), nommée banalement Studio, minimaliste.

libfive Studio fonctionne à la manière d'OpenSCAD : On tape le code du modèle volumique pour visualiser le résultat. Par contre, le code peut s'écrire dans deux langages différents :

• Le Scheme.
• Le Python.

libfive Studio fonctionne sous Linux, Windows et Mac OS. Il est disponible en anglais. Voilà ce à quoi il ressemble, après l'avoir lancé et ouvert une pièce :

libfive et Studio sont respectivement sous licences MPL (Mozilla Public License) et GPL.

Installer libfive Studio

Une seule solution : Compiler les sources...

Première étape

Le cas échéant, installez git, le logiciel de gestion de versions décentralisé, adapté au service web d'hébergement github.

$ sudo apt install git

Deuxième étape

Récupérez les sources, avec la commande ci-dessous. Elle crée dans votre dossier personnel le dossier libfive, contenant les fichiers nécessaires à la compilation.

$ git clone https://github.com/libfive/libfive

Troisième étape

Installez les dépendances, c'est à dire l'ensemble des bibliothèques sur lesquelles s'appuie le logiciel.

$ sudo apt-get install cmake pkg-config libeigen3-dev libpng-dev libboost-all-dev guile-3.0-dev qtbase5-dev python3

Quatrième étape

Pour compiler le logiciel, tapez les commandes ci-dessous, les unes après les autres.

$ cd libfive
$ mkdir build
$ cd build
$ cmake ../
$ make
$ sudo make install
$ sudo ldconfig

Commentaires :

• On se place dans le dossier libfive.
• Pour créer le sous-dossier build.
• Puis on descend dans le sous-dossier build.
• cmake génère les makefile adaptés à l'architecture de la machine, à partir du fichier CMakeLists.txt.
• make compile le code source dans le dossier build. Cela évite de toucher aux fichiers d'origine, il n'y a qu'à effacer build et recommencer pour recompiler de nouveau.
• make install copie les fichiers compilés à leurs emplacements définitifs dans l'arborescence des dossiers.
• ldconfig, facultatif, évite dans certains cas de devoir redémarrer le PC pour prendre en compte les modifications.

Pour terminer

Démarrez le logiciel, en tapant la commande ci-dessous :

$ /usr/local/bin/Studio

En principe, cette commande (à adapter selon le nom de votre dossier personnel) devrait aussi fonctionner :

$ /home/dossier_personnel/libfive/build/studio/Studio

Ouvrir et visualiser une pièce

Avant d'ouvrir un fichier et selon le type de code qu'il contient, sélectionnez le menu Language → Guile Scheme ou Language → Python.

Après, sélectionnez le menu File → Open.... Une fenêtre apparaît pour choisir le dossier et le fichier à ouvrir. En principe, le nom du fichier porte l'extension .io, modifiable à souhait.

La pièce apparaît alors dans la zone graphique. Ensuite, on peut la visualiser selon l'orientation et le grossissement voulu.

• Pour tourner la pièce :
  Déplacez la souris en appuyant sur son bouton gauche.
• Pour déplacer la pièce :
  Déplacez la souris en appuyant sur son bouton droit.
• Pour rapprocher ou éloigner la pièce :
  Tournez la molette de la souris.

Le choix View → Projection → Perspective offre une perspective conique (ou centrale). L'autre choix View → Projection → Orthographic affiche une perspective axonométrique.

Les trois exemples de codes ci-dessous, en Scheme, proviennent du site https://github.com/libfive/libfive/tree/master/studio/examples :

• charm.io
• koalahedron.io
• menger.io

Modéliser une pièce

Le Python étant étudié depuis quelques années dans les Lycées français, nous le préférons au Scheme. En conséquence et pour commencer, sélectionnez le menu Language → Python.

Opérations booléennes sur volumes élémentaires

Commençons par générer trois volumes élémentaires :

Puis effectuons deux opérations booléennes, une addition et une soustraction :

Volume par déplacement de profil

Ci-dessous, le pentagone régulier, défini dans le plan horizontal, est translaté sur l'axe vertical pour créer la matière.

Ici, le profil commence par un cercle pour se terminer par un rectangle.

Evidemment, le déplacement du profil, dans le cas présent un triangle, peut se faire en rotation.

Conclusion

Ce projet repose sur deux sites web :

• Le site de présentation : https://libfive.com/
• Le site de développement : https://github.com/libfive/libfive

La documentation, en anglais uniquement, reste rudimentaire.

• Vous en trouverez une, illustrée d'images, à l'adresse : https://github.com/libfive/libfive/blob/master/doc/guide.md
• Le menu Help de Studio fournit un résumé sommaire.

libfive Studio manque encore de maturité. Tout le monde ne sait pas compiler des sources. Une procédure d'installation plus accessible, une documentation plus exhaustive et, peut-être, un nom plus évocateur métamorphoseraient libfive Studio en une splendide réalisation. Coder un modèle volumique en Python est très agréable. Ce projet prometteur mérite donc toute notre attention.