Part Feature
Introduction
Un objet Part Feature, ou formellement un Part::Feature
, est un élément simple associé à une forme 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
Part Feature (Part::Feature
class) est dérivé de la classe de base App GeoFeature (App::GeoFeature
class) de ce fait partage toutes les propriétés de cette dernière.
Outre les propriétés décrites dans App GeoFeature, Part Feature possède la propriété DonnéesShape qui contrôle le type de géométrie affiché dans la vue 3D. Elle stocke Part TopoShape de cet objet. Il s'agit de la géométrie affichée dans la Vue 3D.
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. 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.
Data
Base
- DonnéesPlacement: la position de l'objet dans la Vue 3D. Le placement est défini par une
Base
un point (vecteur) et uneRotation
(axe et angle). Voir Placement.- DonnéesAngle: l'angle de rotation autour de l'DonnéesAxis. Par défaut, il s'agit de
0°
(zéro en degré). - DonnéesAxis: vecteur unitaire qui définit l'axe de rotation pour le placement. Chaque composant est une valeur à virgule flottante entre
0
et1
. Si une valeur est supérieure à1
, le vecteur est normalisé de sorte que la magnitude du vecteur est1
. 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, c'est l'origine
(0, 0, 0)
.
- DonnéesAngle: l'angle de rotation autour de l'DonnéesAxis. Par défaut, il s'agit de
- DonnéesLabel: le nom modifiable par l'utilisateur de cet objet. Il s'agit d'une chaîne UTF8 arbitraire.
Propriétés cachées de Data
- DonnéesExpression Engine: une liste d'expressions. Par défaut, elle est vide
[]
. - DonnéesLabel2: description plus longue et modifiable par l'utilisateur de cet objet. C'est une chaîne UTF8 arbitraire. Par défaut, il s'agit d'une chaîne vide
""
. - DonnéesProxy: classe associée à cet objet.
- DonnéesShape: classe Part TopoShape associée à cet objet.
- DonnéesVisibility: affiche ou non 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.
La formule pour calculer ceci est
deviation in mm = (w + h + d)/3 * value_in_percent/100
où w
, h
, d
sont les dimensions de la boîte de délimitation.
- 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 surtrue
. - 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. - VueTransparency: 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
. - VueVisibility: s'il est réglé sur
true
, l'objet apparaît dans la 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 Espace sur le clavier.
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"
Ce Part::Feature
de base n'a pas d'objet Proxy, il ne peut donc pas être entièrement utilisé pour la sous-classification.
Par conséquent, pour les scripts Python, la recommandation est de créer l'objet Part::FeaturePython
.
import FreeCAD as App
doc = App.newDocument()
obj = App.ActiveDocument.addObject("Part::FeaturePython", "Name")
obj.Label = "Custom label"
- Le premier argument indique le type d'objet, dans ce cas,
"Part::FeaturePython"
. - 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__FeaturePython"
.- 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.
- Le
- Si vous le souhaitez, l'attribut
Label
peut être remplacé par un texte plus explicite.- Par défaut,
Label
est égal àName
. - Contrairement à
Name
, leLabel
peut accepter n'importe quelle chaîne UTF8, y compris les accents et les espaces. Étant donné que la Vue d'arborescence affiche leLabel
, il est recommandé de remplacer leLabel
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.
- Par défaut,
- Primitives : Box, Cylindre, Sphère, Cône, Tore, Tube, Primitives, Générateur de formes
- Création et modification des objets : Extrusion, Révolution, Miroir, Congé, Chanfrein, Créer une face, Surface réglée, Lissage, Balayage, Section, Coupes, Décalage 3D, Décalage 2D, Évidement, Projection sur surface, Ancrage
---
- Booléen : Créé un composé, Éclater le composé, Filtre composé, Opération booléenne, Soustraction, Union, Intersection, Connecter, Intégrer, Découper, Fragments booléens, Séparer/exploser, Scinder, OU exclusif
- Mesure : Mesure linéaire, Mesure Angulaire, Rafraîchir les mesures, Effacer toute mesure, Tout basculer, Mesures dans la 3D, Mesures selon le repère global
- Autre outils : Importation, Exportation, Sélection par zone, Forme à partir d'un maillage, Points à partir d'un maillage, Convertir en solide, Inverser les formes, Copie simple, Copie transformée, Copie d'un élément, Affiner la forme, Vérifier la géométrie, Supprimer la fonctionnalité, Apparence, Définir les couleurs
- Démarrer avec FreeCAD
- Installation : Téléchargements, Windows, Linux, Mac, Logiciels supplémentaires, Docker, AppImage, Ubuntu Snap
- Bases : À propos de FreeCAD, Interface, Navigation par la souris, Méthodes de sélection, Objet name, Préférences, Ateliers, Structure du document, Propriétés, Contribuer à FreeCAD, Faire un don
- Aide : Tutoriels, Tutoriels vidéo
- Ateliers : Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test