Part Feature/fr: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
No edit summary
Line 41: Line 41:
{{TitleProperty|Base}}
{{TitleProperty|Base}}


<div class="mw-translate-fuzzy">
* {{PropertyView/fr|Angular Deflection}}: il accompagne {{PropertyView/fr|Dé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 [[3D view/fr|vue 3D]], et plus le maillage exporté sera fin.
* {{PropertyView/fr|Angular Deflection}}: il accompagne {{PropertyView/fr|Dé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 [[3D view/fr|vue 3D]], et plus le maillage exporté sera fin.
* {{PropertyView/fr|Bounding Box}}: s'il est réglé sur {{TRUE}}, l'objet affichera le cadre de sélection dans la [[3D view/fr|Vue 3D]].
* {{PropertyView/fr|Bounding Box}}: s'il est réglé sur {{TRUE}}, l'objet affichera le cadre de sélection dans la [[3D view/fr|Vue 3D]].
* {{PropertyView/fr|Deviation}}: il accompagne {{PropertyView/fr|Dé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 [[3D view/fr|vue 3D]], et plus le maillage exporté sera fin.
* {{PropertyView/fr|Deviation}}: il accompagne {{PropertyView/fr|Dé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 [[3D view/fr|vue 3D]], et plus le maillage exporté sera fin.
* {{PropertyView/fr|Display Mode}}: Lignes plates (visualisation régulière), Ombré (bords flous), Image filaire (sans faces), Points (uniquement les sommets).
* {{PropertyView/fr|Draw Style}}: Solide, Pointillé, Pointillé, Dashdot; définit le style des arêtes dans la [[3D view/fr|Vue 3D]].
* {{PropertyView/fr|Lighting}}: Deux côtés, un côté; l'éclairage provient de deux côtés ou d'un côté dans la [[3D view/fr|vue 3D]].
* {{PropertyView/fr|Line Color}}: un tuple de trois valeurs {{incode|(r, g, b)}} pour définir la couleur des arêtes dans la [[3D view/fr|Vue 3D]].
* {{PropertyView/fr|Line Width}}: un flottant qui détermine la largeur en pixels des bords dans la [[3D view/fr|Vue 3D]].
* {{PropertyView/fr|On Top When Selected}}: Désactivé, Activé, Objet, Élément.
* {{PropertyView/fr|Point Color}}: un tuple de trois valeurs {{incode|(r, g, b)}} pour définir la couleur des sommets dans la [[3D view/fr|Vue 3D]].
* {{PropertyView/fr|Point Size}}: un flottant qui détermine la taille en pixels des sommets dans la [[3D view/fr|Vue 3D]].
* {{PropertyView/fr|Selectable}}: s'il est réglé sur {{TRUE}}, l'objet peut être sélectionné avec le pointeur dans la [[3D view/fr|Vue 3D]]. Sinon, l'objet ne peut pas être sélectionné tant que cette option n'est pas définie sur {{TRUE}}.
* {{PropertyView/fr|Selection Style}}: Shape, BoundBox.
* {{PropertyView/fr|Shape Color}}: un tuple de trois valeurs {{incode|(r, g, b)}} pour définir la couleur des faces dans la [[3D view/fr|Vue 3D]].
* {{PropertyView/fr|Show In Tree}}: s'il est réglé sur {{TRUE}}, l'objet apparaît dans la [[tree view/fr|vue arborescente]]. Sinon, il est défini comme invisible.
* {{PropertyView/fr|Transparency}}: un flottant de 0 à 100 déterminant le niveau de transparence des faces dans la [[3D view/fr|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 {{PropertyView/fr| Selectable}} soit {{TRUE}}.
* {{PropertyView/fr|Visibility}}: s'il est réglé sur {{TRUE}}, l'objet apparaît dans la [[3D view/fr|Vue 3D]]; sinon il est invisible par défaut, cette propriété peut être activée ou désactivée en appuyant sur la barre {{KEY|Espace}} sur le clavier.
</div>


The formula to calculate this is
The formula to calculate this is

Revision as of 22:14, 15 December 2019

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 le programme. La classe Part::Feature est l’origine de la plupart des objets 2D (Draft, Sketcher) et 3D (Part, PartDesign).

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. Par exemple, il s'agit de la classe parente de PartDesign Body et de Part Part2DObject, spécialisée pour les formes 2D (planaires).

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

La plupart des objets dans FreeCAD ont ce qu'on appelle un "fournisseur de vues", c'est-à-dire une classe qui définit l'apparence visuelle de l'objet dans la vue 3D et dans la tree view . Le fournisseur de vue par défaut des objets Part Feature définit les propriétés suivantes. Les objets scriptés dérivés de Part Feature auront également accès à ces propriétés.

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.

The formula to calculate this is

deviation in mm = (w + h + d)/3 * value_in_percent/100

where w, h, d are the bounding box dimensions.

  • VueDisplay Mode: Flat Lines (regular visualization), Shaded (soft edges), Wireframe (no faces), Points (only vertices).
  • VueDraw Style: Solid, Dashed, Dotted, Dashdot; defines the style of the edges in the 3D view.
  • VueLighting: Two side, One side; the illumination comes from two sides or one side in the 3D view.
  • VueLine Color: a tuple of three values (r,g,b) to define the color of the edges in the 3D view.
  • VueLine Width: a float that determines the width in pixels of the edges in the 3D view.
  • VueOn Top When Selected: Disabled, Enabled, Object, Element.
  • VuePoint Color: a tuple of three values (r,g,b) to define the color of the vertices in the 3D view.
  • VuePoint Size: a float that determines the size in pixels of the vertices in the 3D view.
  • VueSelectable: 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: Shape, BoundBox.
  • VueShape Color: a tuple of three values (r,g,b) to define the color of the faces in the 3D view.
  • VueShow In Tree: if it is true, the object appears in the tree view. Otherwise, it is set as invisible.
  • VueTransparency: a float from 0 to 100 that determines the level of transparency of the faces in the 3D view. A value of 100 indicates completely invisible faces; the faces are invisible but they can still be picked as long as VueSelectable is true.
  • VueVisibility: 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 in the keyboard.

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.