Graphe de scène

From FreeCAD Documentation
Revision as of 13:36, 31 May 2020 by David69 (talk | contribs)

Introduction

La géométrie qui apparaît dans la vues 3D de FreeCAD est rendue par la bibliothèque Coin3D. Coin3D est une implémentation de la norme OpenInventor. Le logiciel OpenCASCADE fournit également la même fonctionnalité mais il a été décidé au tout début de FreeCAD de ne pas utiliser la visionneuse OpenCASCADE intégrée et plutôt de basculer vers le logiciel Coin3D plus performant. Un bon moyen de découvrir cette bibliothèque est le livre Open Inventor Mentor.

Description

Actuellement OpenInventor est un langage de description de scènes en 3 dimensions. La scène décrite dans OpenInventor est restituée en OpenGL sur votre moniteur. Coin3D prend en charge toutes ces procédures, de telle sorte que le programmeur n'a pas besoin de traiter les appels complexes d'OpenGL, il lui suffit simplement de fournir le code OpenInventor adéquat.

L'un des gros travaux que FreeCAD fait pour vous est de traduire les informations de géométrie d'OpenCASCADE en langage OpenInventor.

OpenInventor décrit une scène 3D sous la forme d'une Graphe de scène comme le montre l'exemple ci dessous:

Image prise de Inventor mentor

Un graphe de scène openInventor décrit tout ce qui fait partie d'une scène 3D, comme la géométrie, les couleurs, les matériaux, les lumières, etc et organise toutes ces données dans une structure pratique et claire. Tout peut être regroupé en sous-structures, ce qui vous permet d'organiser le contenu de votre scène à peu près comme vous le souhaitez. Voici un exemple de fichier openInventor:

#Inventor V2.0 ascii
 
Separator { 
    RotationXYZ {	
       axis Z
       angle 0
    }
    Transform {
       translation 0 0 0.5
    }
    Separator {	
       Material {
          diffuseColor 0.05 0.05 0.05
       }
       Transform {
          rotation 1 0 0 1.5708
          scaleFactor 0.2 0.5 0.2
       }
       Cylinder {
       }
    }
}

Comme vous pouvez le voir, la structure est très simple. Vous utilisez des séparateurs (Separator) pour organiser vos blocs de données, un peu comme vous le feriez pour organiser vos fichiers dans des dossiers.
Chaque instruction influe celle qui suit, par exemple, les deux premiers articles à la racine de nos Separator sont une rotation (RotationXYZ {..}) et une transformation (Transform {..}), ils auront une incidence directe sur tous les éléments suivants (comme, si vous changez l'attribut d'un dossier, tous les sous dossiers seront affectés).
Dans un séparateur, nous définirons la matière, dans un autre, la transformation. Notre cylindre sera donc affecté par les deux transformations, celle qui lui a été appliqué directement et celle qui a été appliquée à son séparateur parent (Separator{..Separator{..}} à la manière des dossiers dans un disque dur).

Nous avons également beaucoup d'autres d'éléments pour organiser notre scène (projet), tels que des groupes, des commutateurs ou des annotations.
Nous pouvons donner à nos objets des définitions très complexes, de la couleur, des textures des modes d'ombrage et de transparence. Nous pouvons aussi définir de la lumière, des caméras et, même du mouvement.
Il est aussi possible d'intégrer des portions de scripts dans des fichiers OpenInventor et de définir des comportements plus complexes.

Si vous souhaitez en savoir plus sur openInventor, rendez-vous directement à sa référence la plus célèbre: Inventor mentor.

Normalement, dans FreeCAD, nous n'avons pas besoin d'interagir directement avec le scène de graphe OpenInventor. Dans un document FreeCAD, chaque objet maillé, forme Part ou toute autre chose, est automatiquement converti en code OpenInventor et est inséré dans le scène de graphe que vous voyez dans la vue 3D. Toutes modifications dans le document, ajout ou suppression d'objets, sont en permanence mises à jour dans le scène de graphe. En fait, chaque objet (dans l'espace App) dispose d'un constructeur de vue (un objet correspondant dans l'espace Gui) responsable de la création du code OpenInventor.

Mais il y a de nombreux avantages à accéder directement au scène de graphe. Par exemple, nous pouvons modifier temporairement l'apparence d'un objet ou nous pouvons ajouter des objets à la scène qui n'ont aucune existence réelle dans le document FreeCAD, tels que la géométrie de construction, les aides, les conseils graphiques ou les outils telles que les manipulations ou les informations à l'écran .

FreeCAD dispose de plusieurs outils pour voir ou modifier le code OpenInventor.

Par exemple, le code Python suivant, montre la représentation OpenInventor d'un objet sélectionné:

obj = FreeCAD.ActiveDocument.ActiveObject
viewprovider = obj.ViewObject
print viewprovider.toString()

Mais nous avons aussi un module Python qui permet un accès complet à toute chose gérée par Coin3D, comme, notre scène graphique FreeCAD.
Alors, lisez la suite sur la page de pivy.