Part Feature

From FreeCAD Documentation
Revision as of 21:46, 30 November 2019 by Mario52 (talk | contribs)

Introduction

Un objet Part Feature, ou formellement un Part::Feature, est un élément simple associé à un Shape topologique qui peut être affiché dans la Vue 3D.

Schéma simplifié des relations entre les objets principaux dans FreeCAD. La classe Part:: Feature est l’origine de la plupart des objets 2D (brouillon, dessin) et 3D (pièce, conception).

Comment l'utiliser

La Part Feature est un objet interne. Par conséquent, il ne peut pas être créé à partir de l'interface graphique, uniquement à partir de la Console Python, comme décrit dans la section Scrip. section.

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

Un objet Part::Feature possède de simples propriétés, telles qu'un emplacement, et des couleurs permettant de définir l'apparence de ses sommets, arêtes et faces. Les ateliers peuvent ajouter plus de propriétés à cet élément de base pour produire un objet avec un comportement complexe.

Propriétés

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

Ce sont les propriétés disponibles dans l'éditeur de propriétés.

Données

Base

  • DonnéesPlacement: la position de l'objet dans la Vue 3D. Le placement est défini par une Base un point (vecteur) et une Rotation (axe et angle). Voir Placement.
    • DonnéesAngle: l'angle de rotation autour de l'DonnéesAxis.
    • DonnéesAxis: le vecteur unitaire qui définit l'axe de rotation pour le placement. Chaque valeur est comprise entre 0 et 1. Si une valeur est supérieure à 1, le vecteur est normalisé de sorte que sa magnitude soit égale à 1.
    • DonnéesPosition: les coordonnées 3D du point de base du placement de l'objet.
  • DonnéesLabel: la description modifiable par l'utilisateur de l'objet.

Vue

Most objects in FreeCAD have what is called a "view provider", which is a class that defines the visual appearance of the object in the 3D view, and in the tree view. The default view provider of Part Feature objects defines the following properties. Scripted objects that are derived from Part Feature will have access to these properties as well.

Base

  • VueAngular Deflection: il accompagne VueDéviation. C'est un autre moyen de spécifier la précision avec laquelle générer le maillage pour le rendu à l'écran ou lors de l'exportation. La valeur par défaut est 28,5 degrés ou 0,5 radian. Plus la valeur est petite, plus l'apparence sera lisse dans la vue 3D, et plus le maillage exporté sera fin.
  • VueBounding Box: s'il est réglé sur true, l'objet affichera le cadre de sélection dans la Vue 3D.
  • VueDeviation: il accompagne VueDéviation angulaire. C'est un autre moyen de spécifier la précision avec laquelle générer le maillage pour le rendu à l'écran ou lors de l'exportation. La valeur par défaut est 0.5. Plus la valeur est petite, plus l'apparence sera lisse dans la vue 3D, et plus le maillage exporté sera fin.
  • VueDisplay Mode: Lignes plates (visualisation régulière), Ombré (bords flous), Image filaire (sans faces), Points (uniquement les sommets).
  • VueDraw Style: Solide, Pointillé, Pointillé, Dashdot; définit le style des arêtes dans la Vue 3D.
  • VueLighting: Deux côtés, un côté; l'éclairage provient de deux côtés ou d'un côté dans la vue 3D.
  • VueLine Color: un tuple de trois valeurs (r, g, b) pour définir la couleur des arêtes dans la Vue 3D.
  • VueLine Width: un flottant qui détermine la largeur en pixels des bords dans la Vue 3D.
  • VueOn Top When Selected: Désactivé, Activé, Objet, Élément.
  • VuePoint Color: un tuple de trois valeurs (r, g, b) pour définir la couleur des sommets dans la Vue 3D.
  • VuePoint Size: un flottant qui détermine la taille en pixels des sommets dans la Vue 3D.
  • VueSelectable: s'il est réglé sur 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: Shape, BoundBox.
  • VueShape Color: un tuple de trois valeurs (r, g, b) pour définir la couleur des faces dans la Vue 3D.
  • VueShow In Tree: s'il est réglé sur true, l'objet apparaît dans la vue arborescente. Sinon, il est défini comme invisible.
  • Vue Transparency: un flottant de 0 à 100 déterminant le niveau de transparence des faces dans la Vue 3D. Une valeur de 100 indique des faces complètement invisibles; les faces sont invisibles mais elles peuvent toujours être sélectionnées à condition que Vue Selectable soit true.
  • Vue Visibility: s'il est réglé sur true, l'objet apparaît dans la Vue 3D; sinon il est invisible.

Script

Voir aussi: Débuter avec les scripts et Objets créés par script.

Une entité de pièce, Part Feature, est créée avec la méthode addObject() du document.

import FreeCAD as App

doc = App.newDocument()
obj = App.ActiveDocument.addObject("Part::Feature", "Name")
obj.Label = "Custom label"
  • Le premier argument indique le type d'objet, dans ce cas, "Part::Feature".
  • Le deuxième argument est une chaîne qui définit l'attribut Name. S'il n'est pas fourni, la valeur par défaut est "Part__Feature".
    • Le Name est fixé au moment de la création. il ne peut pas être modifié par la suite.
    • Le Name ne peut inclure que des caractères alphanumériques simples et le trait de soulignement [_0-9a-zA-Z]. Si d’autres symboles sont donnés, ils seront convertis en caractères de soulignement; par exemple, "A+B:C*" est converti en "A_B_C_".
    • Le Name doit être unique dans tout le document. Si plusieurs objets portant le même nom sont créés, un numéro séquentiel sera ajouté pour les distinguer, par exemple, "Name001", "Name002", etc.
  • Si vous le souhaitez, l'attribut Label peut être remplacé par un texte plus explicite.
    • Par défaut, Label est égal à Name.
    • Contrairement à Name, le Label peut accepter n'importe quelle chaîne UTF8, y compris les accents et les espaces. Étant donné que la Vue d'arborescence affiche le Label, il est recommandé de remplacer le Label par une chaîne plus descriptive.
    • Par défaut, Label doit être unique. Ce comportement peut être modifié dans Réglage des préférences, Edition → Préférences → Général → Document → Autoriser la duplication des étiquettes dans un document.