Part Feature
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 uneRotation
(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.
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"
- 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.
- 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