Mesh Feature

From FreeCAD Documentation
Revision as of 09:15, 22 February 2022 by David69 (talk | contribs)
Other languages:

Introduction

Un objet Mesh Feature, ou formellement un Mesh::Feature, est un élément simple avec un objet de maillage associé qui peut être affiché dans la vue 3D.

Une fonction de maillage (Mesh Feature) est conceptuellement similaire à une Part Feature. Le premier est l'objet de base pour les éléments avec des informations de "maillage", tandis que le second est l'objet de base pour les éléments avec des informations de "forme géométrique".

Notez que l' atelier FEM utilise également des maillages, mais dans ce cas, il utilise un objet différent, appelé FEM FemMeshObject (classe Fem::FemMeshObject). Cet objet n'est pas dérivé de la fonction de maillage et possède des propriétés différentes.

Diagramme simplifié des relations entre les objets centraux dans Freecad

Utilisation

Presque tous les objets maillés créés par les commandes disponibles dans l'interface graphique de l'atelier Mesh sont des Mesh Features. Les objets maillés paramétriques créés par la commande Mesh Solide régulier sont les seules exceptions. Un Mesh Feature peut également être créé à partir de la console Python comme décrit dans la section Script.

L'objet Mesh::Feature est défini dans l'atelier Mesh mais peut être utilisé comme classe de base pour les objets scriptés dans tous les ateliers générant des formes géométriques 2D et 3D.

Un Mesh::Feature a des propriétés simples comme un placement et des propriétés visuelles pour définir l'apparence de ses arêtes et faces.

Propriétés

Voir Propriétés pour tous les types de propriétés que les objets crées par script peuvent avoir.

La classe Mesh Feature (classe Mesh::Feature) est dérivée de App GeoFeature de base. (classe App::GeoFeature) et hérite de toutes ses propriétés. Elle possède également plusieurs propriétés supplémentaires, notamment une propriété DonnéesMesh, qui stocke son Mesh MeshObject. Il s'agit de la géométrie qui est affichée dans la vue 3D.

Ce sont les propriétés disponibles dans l'éditeur de propriétés. Les propriétés masquées peuvent être affichées en utilisant la commande Show all dans le menu contextuel de l'éditeur de propriétés.

Données

Base

  • DonnéesMesh (MeshKernel): une classe Mesh MeshObject associée à cet objet. Elle répertorie le nombre de Points, Edges et Faces du maillage.
  • DonnéesPlacement (Placement): la position de l'objet dans la vue 3D. Le placement est défini par un Base point (vecteur) et un Rotation (axe et angle). Voir Placement.
    • DonnéesAngle: l'angle de rotation autour de DonnéesAxis. Par défaut, (zéro degré).
    • DonnéesAxis: le vecteur unitaire qui définit l'axe de rotation du placement. Chaque composant est une valeur à virgule flottante entre 0 et 1. Si une valeur est supérieure à 1, le vecteur est normalisé de sorte que la norme du vecteur soit 1. Par défaut, il s'agit de l'axe Z positif, (0, 0, 1).
    • DonnéesPosition: un vecteur avec les coordonnées 3D du point de base. Par défaut, il s'agit de l'origine (0, 0, 0).
  • DonnéesLabel (String): le nom modifiable par l'utilisateur de cet objet, c'est une chaîne UTF8 arbitraire.

Vue

Base

  • Vue (Hidden)Proxy (PythonObject): a custom viewprovider class associated with this object. This only exists for the Python version. See Scripting.

Display Options

  • VueBounding Box (Bool): if it is true, the object will show the bounding box in the 3D view.
  • VueDisplay Mode (Enumeration): Shaded (no edges), Wireframe (no faces), Flat Lines (regular visualization), Points (only vertices).
  • VueShow In Tree (Bool): if it is true, the object appears in the Tree view. Otherwise, it is set as invisible.
  • VueVisibility (Bool): if it is true, the object appears in the 3D view; otherwise it is invisible. By default this property can be toggled on and off by pressing the Space bar.

Object Style

  • VueBounding Box (Bool): s'il est true, l'objet affichera le cadre de délimitation dans la vue 3D.
  • VueCrease Angle (FloatConstraint):
  • VueDisplay Mode (Enumeration): Shaded (sans arêtes), Wireframe (sans faces), Flat Lines (visualisation régulière), Points (uniquement les sommets).
  • VueLighting (Enumeration): One side (par défaut), Two side. L'éclairage provient de deux côtés ou d'un côté dans la vue 3D.
  • VueLine Color (Color): un tuple de trois valeurs RVB à virgule flottante (r,g,b) pour définir la couleur des arêtes dans la vue 3D; par défaut, il s'agit de (0.0, 0.0, 0.0), qui s'affiche sous la forme [0,0,0] en base 255, complètement noir.
  • VueLine Transparency (Percent): un entier de 0 à 100 (un pourcentage) qui détermine le niveau de transparence des arêtes dans la Vue 3D. Une valeur de 100 indique des arêtes complètement invisibles; les bords sont invisibles mais ils peuvent toujours être choisis tant que VueSelectable est true.
  • VueLine Width (FloatConstraint): valeur en flottant qui détermine la largeur en pixels des bords dans la vue 3D. La valeur par défaut est 1.0.
  • VueOn Top When Selected (Enumeration): Disabled (par défaut), Enabled, Object, Element.
  • VueOpen Edges (Bool): la valeur par défaut est false.
  • VuePoint Size (FloatConstraint): similaire à VueLine Width, définit la taille des sommets.
  • VueSelectable (Bool): s'il est true, l'objet peut être sélectionné avec le pointeur dans la vue 3D. Sinon, l'objet ne peut pas être sélectionné tant que cette option n'est pas définie sur true.
  • VueSelection Style (Enumeration): Shape (par défaut), BoundBox. Si l'option est Shape, la forme entière (sommets, arêtes et faces) sera mise en évidence dans vue 3D; s'il s'agit de BoundBox, seul le cadre englobant sera mis en surbrillance.
  • VueShape Color (Color): similaire à VueLine Color, définit la couleur des faces. La valeur par défaut est (0.8, 0.8, 0.8), qui s'affiche sous la forme [204,204,204] sur la base 255, un gris clair.
  • VueShow In Tree (Bool): s'il vaut true, l'objet apparaît dans la vue en arborescence. Sinon, il est défini comme invisible.
  • VueTransparency (Percent): un entier de 0 à 100 (un pourcentage) qui détermine le niveau de transparence des faces dans la 3D vue. Une valeur de 100 indique des faces complètement invisibles; les faces sont invisibles mais elles peuvent toujours être sélectionnées tant que VueSelectable est true.
  • VueVisibility (Bool): s'il est true, l'objet apparaît dans la vue 3D; sinon, il est invisible. Par défaut, cette propriété peut être activée et désactivée en appuyant sur la barre Espace du clavier.

Selection

  • VueOn Top When Selected (Enumeration): Disabled (default), Enabled, Object, Element.
  • VueSelectable (Bool): if it is true, the object can be picked with the pointer in the 3D view. Otherwise, the object cannot be selected until this option is set to true.
  • VueSelection Style (Enumeration): Shape (default), BoundBox. If the option is Shape, the entire shape (vertices, edges, and faces) will be highlighted in the 3D view; if it is BoundBox only the bounding box will be highlighted.

Script

Voir Part Feature pour les informations générales sur l'ajout d'objets au programme.

Un Mesh Feature est créée avec la méthode addObject() du document.

import FreeCAD as App

doc = App.newDocument()
obj = App.ActiveDocument.addObject("Mesh::Feature", "Name")
obj.Label = "Custom label"

Par conséquent, pour la sous-classe Python, vous devez créer l'objet Mesh::FeaturePython.

import FreeCAD as App

doc = App.newDocument()
obj = App.ActiveDocument.addObject("Mesh::FeaturePython", "Name")
obj.Label = "Custom label"