Std Part/fr: Difference between revisions

From FreeCAD Documentation
mNo edit summary
(Updating to match new version of source page)
 
(166 intermediate revisions by 8 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Docnav/fr
{{Docnav/fr
|
|
|[[Std Group/fr|Créer un groupe Std]]
|[[Std Group/fr|Groupe]]
|[[PartDesign_Workbench/fr|PartDesign]]
|[[Std_Base/fr|Std Base]]
|IconL=
|IconL=
|IconR=Std_Group.svg
|IconC=Workbench_PartDesign.svg
|IconR=Group.svg
|IconC=Freecad.svg
}}
}}


{{GuiCommand/fr
{{GuiCommand/fr
|Name=Std Part
|Name=Std Part
|Name/fr=Pièce Std
|Name/fr=Std Part
|Workbenches=Tous
|Workbenches=Tous
|MenuLocation=Aucun
|MenuLocation=Aucun
|Version=0.17
|Version=0.17
|SeeAlso=[[Std_Group/fr|Créer un groupe Std]], [[PartDesign Body/fr|Corps de pièce PartDesign]]
|SeeAlso=[[Std_Group/fr|Std Groupe]], [[PartDesign_Body/fr|PartDesign Corps]]
}}
}}


==Description==
==Description==


'''Part''' (Pièce) est un conteneur à usage général qui conserve ensemble un groupe d'objets afin qu'ils puissent être déplacés en tant qu'unité. La Pièce peut contenir la plupart des objets FreeCAD, par exemple des corps de pièces PartDesign, des objets de l'atelier Part, des objets de l'atelier Mesh, etc.
{{Button|[[File:Std_Part.svg|16px]] [[Std_Part/fr|Std Part]]}} (appelé en interne [[App_Part/fr|App Part]]) est un conteneur à usage général qui conserve ensemble un groupe d'objets afin qu'ils puissent être déplacés ensemble en tant qu'unité dans la [[3D_view/fr|vue 3D]].


L'élément Std Part a été développé pour être le bloc de construction de base pour créer des [[assembly/fr|assemblages]] mécaniques. En particulier, il est conçu pour organiser les objets qui ont une [[Part_TopoShape/fr|Part TopoShape]], comme [[Part_CreatePrimitives/fr|Part Primitives]], [[PartDesign_Body/fr|PartDesign Corps]], et d'autres [[Part_Feature/fr|Part Features]]. Std Part fournit un [[#Origine|objet Origin]] avec des axes X, Y et Z locaux et des plans standard, qui peuvent être utilisés comme référence pour positionner les objets contenus. De plus, des Std Parts peuvent être imbriquées dans d'autres Std Parts pour créer un grand assemblage à partir de sous-assemblages plus petits.
Pièce fournit un système de coordonnées local auquel des esquisses et d'autres objets peuvent être attachés.


Bien qu'elle soit principalement destinée aux corps solides, Std Part peut être utilisée pour gérer tout objet possédant une propriété [[Placement/fr|Positionnement]], elle peut donc également contenir [[Mesh_Feature/fr|Mesh Features]], [[Sketch/fr|Esquisses]] et d'autres objets dérivés de la classe [[App_GeoFeature/fr|App GeoFeature]].
Pièce se trouve dans la barre d'outils Structure affichée dans tous les ateliers.


Ne pas confondre {{Button|[[File:PartDesign_Body.svg|16px]] [[PartDesign_Body/fr|PartDesign Corps]]}} avec {{Button|[[File:Std_Part.svg|16px]] [[Std_Part/fr|Std Part]]}}. Le premier est un objet spécifique utilisé dans l'[[File:Workbench_PartDesign.svg|24px]] [[PartDesign_Workbench/fr|Atelier PartDesign]], destiné à modéliser un [[PartDesign_Body/fr#Solide_contigu_unique|solide contigu unique]] au moyen de [[PartDesign_Feature/fr|PartDesign Features]]. En revanche, [[Std_Part|Std Part]] n'est pas utilisée pour la modélisation, juste pour arranger différents objets dans l'espace, avec l'intention de créer des [[assembly/fr|assemblages]].
[[File:Std Part-tree.png|top]][[File:Std Part example.png]]


L'outil {{Button|[[File:Std_Part.svg|16px]] [[Std_Part/fr|Std Part]]}} n'est pas défini par un atelier particulier mais par le système de base. Il se trouve donc dans la {{MenuCommand|structure toolbar}} qui est disponible dans tous les [[Workbenches/fr|ateliers]]. Pour grouper des objets arbitrairement sans tenir compte de leur position, utilisez {{Button|[[File:Std_Group.svg|16px]] [[Std_Group/fr|Std Groupe]]}}. Cet objet n'affecte pas les placements des éléments qu'il contient, c'est essentiellement juste un dossier qui sert à garder la [[Tree_view/fr|Vue en arborescence]] organisée.
{{Caption|Système de coordonnées local défini par une pièce}}


[[File:Std Part-tree.png]][[File:Std Part example.png]]
=== Exemples d'utilisation ===
* En tant que conteneur d'assemblage qui regroupe des objets à fabriquer séparément puis collés ou vissés, comme une table en bois.
* Lors de l'importation d'un assemblage STEP dans FreeCAD, l'assemblage principal et ses sous-assemblages sont des conteneurs de pièces.
* Une pièce composée de plusieurs composants non fusionnés, comme un roulement à billes.


{{Caption|À gauche : éléments à l'intérieur d'une Std Part dans la [[Tree_view/fr|Vue en arborescence]]. À droite : les objets positionnés dans l'espace, référés à l'origine de Std Part.}}

<span id="Usage"></span>
==Utilisation==

# Appuyez sur le bouton {{Button|[[File:Std_Part.svg|16px]] [[Std_Part/fr|Créer une pièce]]}}.
# Une pièce vide est créée et devient automatiquement ''[[#Statut_actif|active]]''.
# Pour ajouter des objets à la pièce, sélectionnez-les dans la [[Tree_view/fr|Vue en arborescence]], puis faites-les glisser et déposez-les sur la pièce.
# Pour retirer des objets de la pièce, faites-les glisser hors de la pièce et déposez-les sur l'étiquette du document en haut de la [[Tree_view/fr|Vue en arborescence]].
# Vous pouvez également ajouter et supprimer des objets en modifiant la propriété {{PropertyData|Group}} de la pièce.

<span id="Notes"></span>
== Remarques ==

* Un objet ne peut appartenir qu'à une seule pièce.
* Les opérations 3D comme les [[Part_Boolean/fr|Part Opération booléenne]] ne peuvent pas être appliquées aux pièces. Par exemple, vous ne pouvez pas sélectionner deux pièces et effectuer un [[Part_Fuse/fr|Part Union]] ou un [[Part_Cut/fr|Part Soustraction]].

<span id="Properties"></span>
==Propriétés==

[[Std_Part/fr|Std Part]], appelée en interne [[App_Part/fr|App Part]] (classe {{incode|App::Part}}), est dérivé de [[App_GeoFeature/fr|App GeoFeature]] (classe {{incode|App::GeoFeature}}) et hérite de toutes ses propriétés. Il possède également plusieurs propriétés supplémentaires. Notamment des propriétés qui l'aident à gérer les informations dans le contexte d'un assemblage, par exemple, {{PropertyData|Type}}, {{PropertyData|Id}}, {{PropertyData|License}}, {{PropertyData|LicenseURL}} and {{PropertyData|Group}}.

Ce sont les propriétés disponibles dans l'[[Property_editor/fr|éditeur de propriétés]]. Les propriétés masquées peuvent être affichées en utilisant la commande {{MenuCommand|Show all}} dans le menu contextuel de l'[[Property_editor/fr|éditeur de propriétés]].

<span id="Data"></span>
=== Données ===

{{TitleProperty|Base}}

* {{PropertyData|Type|String}} : une description pour cet objet. Par défaut, il s'agit d'une chaîne vide {{value|""}}.
* {{PropertyData|Material|Link}} : le matériau de cet objet.
* {{PropertyData|Meta|Map|Hidden}} : avec des méta-informations supplémentaires. Par défaut, il est vide <code>{}</code>.
* {{PropertyData|Id|String}} : une identification ou un numéro de pièce pour cet objet. Par défaut, il s'agit d'une chaîne vide {{value|""}}.
* {{PropertyData|Uid|UUID|Hidden}} : l'[https://fr.wikipedia.org/wiki/Universally_unique_identifier identificateur unique et universel] (UUID) (numéro de 128 bits) de l'objet. Il est attribué au moment de la création.
* {{PropertyData|License|String}} : champ permettant de spécifier la licence de cet objet. Par défaut, il s'agit d'une chaîne vide {{value|""}}.
* {{PropertyData|LicenseURL|String}} : champ permettant de spécifier l'adresse web de la licence ou du contrat pour cet objet. Par défaut, il s'agit d'une chaîne vide {{value|""}}.
* {{PropertyData|Color|Color}} : un tuple de quatre valeurs RGBA à virgule flottante {{value|(r,g,b,a)}} pour définir la couleur de l'objet ; par défaut, il s'agit de {{value|(1.0, 1.0, 1.0, 1.0)}}, qui s'affiche comme {{value|[255,255,255]}} sur la base 255, <span style="background-color:#fff ; color:#000 ; border : 1px solid #888888; width:3em; height:12pt; padding: 2px 1em 2px;">couleur blanche</span>.
* {{PropertyData|Placement|Placement}} : la position de l'objet dans la [[3D_view/fr|Vue 3D]]. L'emplacement est défini par un point {{incode|Base}} (vecteur) et un {{incode|Rotation}} (axe et angle). Voir [[Placement/fr|Placement]].
** {{PropertyData|Angle}} : l'angle de rotation autour de {{PropertyData|Axis}}. Par défaut, il est {{value|0°}}. (zéro degré).
** {{PropertyData|Axis}} : le vecteur unitaire qui définit l'axe de rotation du placement. Chaque composante est une valeur à virgule flottante comprise entre {{value|0}} et {{value|1}}. Si une valeur est supérieure à {{value|1}}, le vecteur est normalisé de manière à ce que sa magnitude soit {{value|1}}. Par défaut, il s'agit de l'axe Z positif, {{value|(0, 0, 1)}}.
** {{PropertyData|Position}} : un vecteur contenant les coordonnées 3D du point de base. Par défaut, il s'agit de l'origine {{value|(0, 0, 0)}}.
* {{PropertyData|Label|String}} : le nom modifiable par l'utilisateur de cet objet, il s'agit d'une chaîne UTF8 arbitraire.
* {{PropertyData|Label2|String|Hidden}} : une description plus longue, modifiable par l'utilisateur, de cet objet. Il s'agit d'une chaîne UTF8 arbitraire qui peut inclure des nouvelles lignes. Par défaut, il s'agit d'une chaîne vide {{value|""}}.
* {{PropertyData|Expression Engine|ExpressionEngine|Hidden}} : une liste d'expressions. Par défaut, elle est vide {{value|[]}}.
* {{PropertyData|Visibility|Bool|Hidden}} : affichage ou non l'objet.
* {{PropertyData|Origin|Link|Hidden}} : l'objet [[App_OriginGroupExtension|App Origin]] qui sert de référence positionnelle pour tous les éléments énumérés dans {{PropertyData|Group}}.
* {{PropertyData|Group|LinkList}} : une liste d'objets référencés. Par défaut, elle est vide {{value|[]}}.
* {{PropertyData|_Group Touched|Bool|Hidden}} : indique si le groupe est touché ou non.

<span id="View"></span>
=== Vue ===

{{TitleProperty|Display Options}}

* {{PropertyView|Display Mode|Enumeration}} : {{value|Group}}.
* {{PropertyView|Show In Tree|Bool}} : si la valeur est {{TRUE}}, l'objet apparaît dans la [[Tree_view/fr|Vue en arborescence]]. Sinon, il est défini comme invisible.
* {{PropertyView|Visibility|Bool}} : si elle est {{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}} du clavier.

{{TitleProperty|Selection}}

* {{PropertyView|On Top When Selected|Enumeration}} : {{value|Disabled}} (par défaut) (par défaut), {{value|Enabled}}, {{value|Object}}, {{value|Element}}.
* {{PropertyView|Selection Style|Enumeration}} : {{value|Shape}}. (par défaut), {{value|BoundBox}}. Si l'option est {{value|Shape}}, la forme entière (sommets, arêtes et faces) sera mise en évidence dans la [[3D_view/fr|Vue 3D]] ; si elle est {{value|BoundBox}}, seule la boîte de délimitation sera mise en évidence.

<span id="Detailed_explanation"></span>
==Explications détaillées==

<span id="Active_status"></span>
=== Statut actif ===
=== Statut actif ===

Un document FreeCAD peut contenir plusieurs Pièces. Une seule Pièce peut être active à la fois. Une Pièce active sera affichée dans l'arbre avec une couleur de fond bleu clair.
Un document ouvert peut contenir plusieurs parties. Mais une seule pièce peut être active. La partie active est affichée dans la [[Tree_view/fr|vue en arborescence]] avec la couleur de fond spécifiée par la valeur {{MenuCommand|Contenant actif}} dans l'[[Preferences_Editor/fr#Couleurs|éditeur de préférences]] (par défaut, bleu clair). Il sera également affiché avec du texte en gras.
[[File:Std Part-tree-active.png|none]]

Pour activer ou désactiver un Part :
* Double-cliquez dessus dans l'[[Tree_view/fr|arborescence]] ou
* Ouvrez le menu contextuel (clic droit) et sélectionnez {{MenuCommand|Toggle active part}}.

[[File:Std_Part_active.png]]

{{Caption|Document avec deux Std Parts, dont le second est actif.}}

<span id="Origin"></span>
=== Origine ===
=== Origine ===

L'origine comprend les trois axes standard (X, Y, Z) et trois plans standard (XY, XZ et YZ). Des esquisses peuvent être attachées à ces plans. Tous les éléments à l'intérieur de la Pièce sont référencés à l'origine de la Pièce; ce qui signifie que la Pièce peut être déplacée et tournée en référence au système de coordonnées global sans affecter le placement des éléments à l'intérieur.
L'Origine se compose des trois axes standard (X, Y, Z) et de trois plans standard (XY, XZ et YZ). Les [[Sketch/fr|esquisses]] et d'autres objets peuvent être attachés à ces éléments lors de leur création.
[[File:PartDesign_Body_tree-02.png|none]]

[[File:Part_Origin_tree.png]] [[File:Part_Origin_view.png]]

{{Caption|À gauche : Part Origin dans la [[Tree_view/fr|vue en arborescence]]. À droite : représentation des éléments Origin dans la [[3D_view/fr|Vue 3D]].}}

{{Emphasis|Remarque}} : L'origine est un [[App_OriginGroupExtension/fr|App Origin]] objet (de classe {{incode|App::Origin}}) tandis que les axes et les plans sont respectivement des objets de type {{incode|App::Line}} et {{incode|App::Plane}}. Chacun de ces éléments peut être masqué et non masqué individuellement avec la barre {{KEY|Espace}}. Cela est utile pour choisir la référence correcte lors de la création d'autres objets.

{{Emphasis|Remarque 2 :}} tous les éléments à l'intérieur du Part sont référencés à l'origine du Part, ce qui signifie que le Part peut être déplacé et tourné en référence au système de coordonnées global sans affecter le placement des éléments à l'intérieur.

<span id="Visibility_Management"></span>
=== Gestion de la visibilité ===
=== Gestion de la visibilité ===
La visibilité de la Pièce remplace la visibilité de tout objet qu'elle contient. Si la Pièce est masquée, les objets qu'elle contient seront également masqués, même si leur visibilité est définie sur vraie. Plusieurs objets à l'intérieur d'une Pièce peuvent être visibles à la fois.


La visibilité d'un Part remplace la visibilité de tout objet qu'elle contient. Si Part est masqué, les objets qu'il contient seront également masqués, même si leur propriété individuelle {{PropertyView|Visibility}} est définie sur {{TRUE}}. Si Part est visible, la {{PropertyView|Visibility}} de chaque objet détermine si l'objet est affiché ou non.
== Comment l'utiliser ==


[[File:Part_Visibility_off.png]] [[File:Part_Visibility_on.png]]
* Appuyez sur le bouton {{KEY | [[Image: Std Part.png | 24px]] '''Créer une Pièce'''}} dans la barre d'outils. La Pièce devient automatiquement active.
{{Caption|La visibilité de Std Part détermine si les objets regroupés sous lui sont affichés dans la [[3D view/fr|vue 3D]] ou non. À gauche : Part est masqué, donc aucun des objets ne sera affiché dans la [[3D view/fr|vue 3D]]. À droite : Part est visible, donc chaque objet contrôle sa propre visibilité.}}
* Double-cliquez sur la Pièce dans l'arborescence du modèle pour l'activer ou la désactiver.
* Pour ajouter des objets à une Pièce, faites-les glisser sur la Pièce dans l'arborescence du modèle.
* Pour supprimer des objets d'une Pièce, faites-les glisser hors de la Pièce et sur le nom du document en haut de l'arborescence du modèle.


<span id="Scripting"></span>
==Propriétés==
== Script ==


{{Emphasis|Voir aussi :}} [[FreeCAD_Scripting_Basics/fr|Débuter avec les scripts]] et [[Scripted_objects/fr|Objets créés par script]].
* {{PropertyData/fr| Id}}: ID (numéro de Pièce) de l'élément. Ce champ est facultatif.
* {{PropertyData/fr | License}}: la licence sous laquelle la Pièce est produite.
* {{PropertyData/fr | License URL}}: l'adresse Web où les termes de la licence peuvent être trouvés.
* {{PropertyData/fr | Placement}}: spécifie l'orientation et la position de la Pièce dans l'espace 3D. Voir [[Placement/fr|Placement]].
* {{PropertyData/fr | Label}}: l'étiquette est le nom donné à l'opération. Ce nom peut être changé à votre convenance.
* {{PropertyData/fr | Group}}: liste les objets référencés.


Voir [[Part_Feature/fr|Part Feature]] pour les informations générales sur l'ajout d'objets au document.
==Limites==


Std Part ([[App_Part/fr|App Part]]) est créé avec la méthode {{incode|addObject()}} du document. Une fois que Part existe, d'autres objets peuvent y être ajoutés avec les méthodes {{incode|addObject()}} ou {{incode|addObjects()}}.
* Même lorsqu'une Pièce est active, les objets nouvellement créés ne sont pas placés à l'intérieur de la Pièce, mais au bas de l'arbre. Glissez-déposez-les simplement sur la Pièce.
* Une Pièce n'a pas de forme. Il n'est donc pas possible d'appliquer la plupart des opérations 3D sur une Pièce, telle que les opérations booléennes.
* À l'heure actuelle, l'[[Draft Snap/fr|accrochage Draft]] ne fonctionne pas sur un ou des conteneurs Pièces, ni sur des objets contenus dans un conteneur Pièce.
* '' Note du rédacteur : actuellement, le but du statut actif de la Pièce n'est pas clair. ''


{{Code|code=
<div class="mw-translate-fuzzy">
import FreeCAD as App
{{Docnav/fr||[[Std Group/fr|Créer un groupe Std]]|[[PartDesign_Workbench/fr|PartDesign]]|IconL=|IconC=Workbench_PartDesign.svg|IconR=Group.svg}}
</div>


doc = App.newDocument()
<div class="mw-translate-fuzzy">
part = App.ActiveDocument.addObject("App::Part", "Part")
{{PartDesign Tools navi/fr}}

</div>
obj1 = App.ActiveDocument.addObject("PartDesign::Body", "Body")
obj2 = App.ActiveDocument.addObject("Part::Box", "Box")

part.addObjects([obj1, obj2])
App.ActiveDocument.recompute()
}}

Vous ne pouvez pas créer un {{incode|App::Part}} scripté. Cependant, vous pouvez ajouter un comportement {{incode|App::Part}} à un objet {{incode|Part::FeaturePython}} scripté en utilisant le code suivant :

{{Code|code=
class MyGroup(object):
def __init__(self, obj=None):
self.Object = obj
if obj:
self.attach(obj)

def dumps(self):
return

def loads(self, _state):
return

def attach(self, obj):
obj.addExtension("App::OriginGroupExtensionPython")
obj.Origin = FreeCAD.ActiveDocument.addObject("App::Origin", "Origin")

def onDocumentRestored(self, obj):
self.Object = obj

class ViewProviderMyGroup(object):
def __init__(self, vobj=None):
if vobj:
vobj.Proxy = self
self.attach(vobj)
else:
self.ViewObject = None

def attach(self, vobj):
vobj.addExtension("Gui::ViewProviderOriginGroupExtensionPython")
self.ViewObject = vobj

def dumps(self):
return None

def loads(self, _state):
return None

App.ActiveDocument.addObject("Part::FeaturePython",
"Group",
group.MyGroup(),
group.ViewProviderMyGroup(),
True)
}}


{{Docnav/fr
|
|[[Std Group/fr|Groupe]]
|[[Std_Base/fr|Std Base]]
|IconL=
|IconR=Std_Group.svg
|IconC=Freecad.svg
}}


{{Std_Base_navi{{#translation:}}}}
{{Userdocnavi/fr}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 09:02, 27 January 2024

Std Part

Emplacement du menu
Aucun
Ateliers
Tous
Raccourci par défaut
Aucun
Introduit dans la version
0.17
Voir aussi
Std Groupe, PartDesign Corps

Description

Std Part (appelé en interne App Part) est un conteneur à usage général qui conserve ensemble un groupe d'objets afin qu'ils puissent être déplacés ensemble en tant qu'unité dans la vue 3D.

L'élément Std Part a été développé pour être le bloc de construction de base pour créer des assemblages mécaniques. En particulier, il est conçu pour organiser les objets qui ont une Part TopoShape, comme Part Primitives, PartDesign Corps, et d'autres Part Features. Std Part fournit un objet Origin avec des axes X, Y et Z locaux et des plans standard, qui peuvent être utilisés comme référence pour positionner les objets contenus. De plus, des Std Parts peuvent être imbriquées dans d'autres Std Parts pour créer un grand assemblage à partir de sous-assemblages plus petits.

Bien qu'elle soit principalement destinée aux corps solides, Std Part peut être utilisée pour gérer tout objet possédant une propriété Positionnement, elle peut donc également contenir Mesh Features, Esquisses et d'autres objets dérivés de la classe App GeoFeature.

Ne pas confondre PartDesign Corps avec Std Part. Le premier est un objet spécifique utilisé dans l' Atelier PartDesign, destiné à modéliser un solide contigu unique au moyen de PartDesign Features. En revanche, Std Part n'est pas utilisée pour la modélisation, juste pour arranger différents objets dans l'espace, avec l'intention de créer des assemblages.

L'outil Std Part n'est pas défini par un atelier particulier mais par le système de base. Il se trouve donc dans la structure toolbar qui est disponible dans tous les ateliers. Pour grouper des objets arbitrairement sans tenir compte de leur position, utilisez Std Groupe. Cet objet n'affecte pas les placements des éléments qu'il contient, c'est essentiellement juste un dossier qui sert à garder la Vue en arborescence organisée.

À gauche : éléments à l'intérieur d'une Std Part dans la Vue en arborescence. À droite : les objets positionnés dans l'espace, référés à l'origine de Std Part.

Utilisation

  1. Appuyez sur le bouton Créer une pièce.
  2. Une pièce vide est créée et devient automatiquement active.
  3. Pour ajouter des objets à la pièce, sélectionnez-les dans la Vue en arborescence, puis faites-les glisser et déposez-les sur la pièce.
  4. Pour retirer des objets de la pièce, faites-les glisser hors de la pièce et déposez-les sur l'étiquette du document en haut de la Vue en arborescence.
  5. Vous pouvez également ajouter et supprimer des objets en modifiant la propriété DonnéesGroup de la pièce.

Remarques

Propriétés

Std Part, appelée en interne App Part (classe App::Part), est dérivé de App GeoFeature (classe App::GeoFeature) et hérite de toutes ses propriétés. Il possède également plusieurs propriétés supplémentaires. Notamment des propriétés qui l'aident à gérer les informations dans le contexte d'un assemblage, par exemple, DonnéesType, DonnéesId, DonnéesLicense, DonnéesLicenseURL and DonnéesGroup.

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éesType (String) : une description pour cet objet. Par défaut, il s'agit d'une chaîne vide "".
  • DonnéesMaterial (Link) : le matériau de cet objet.
  • Données (Hidden)Meta (Map) : avec des méta-informations supplémentaires. Par défaut, il est vide {}.
  • DonnéesId (String) : une identification ou un numéro de pièce pour cet objet. Par défaut, il s'agit d'une chaîne vide "".
  • Données (Hidden)Uid (UUID) : l'identificateur unique et universel (UUID) (numéro de 128 bits) de l'objet. Il est attribué au moment de la création.
  • DonnéesLicense (String) : champ permettant de spécifier la licence de cet objet. Par défaut, il s'agit d'une chaîne vide "".
  • DonnéesLicenseURL (String) : champ permettant de spécifier l'adresse web de la licence ou du contrat pour cet objet. Par défaut, il s'agit d'une chaîne vide "".
  • DonnéesColor (Color) : un tuple de quatre valeurs RGBA à virgule flottante (r,g,b,a) pour définir la couleur de l'objet ; par défaut, il s'agit de (1.0, 1.0, 1.0, 1.0), qui s'affiche comme [255,255,255] sur la base 255, couleur blanche.
  • DonnéesPlacement (Placement) : la position de l'objet dans la Vue 3D. L'emplacement est défini par un point Base (vecteur) et un Rotation (axe et angle). Voir Placement.
    • DonnéesAngle : l'angle de rotation autour de DonnéesAxis. Par défaut, il est . (zéro degré).
    • DonnéesAxis : le vecteur unitaire qui définit l'axe de rotation du placement. Chaque composante est une valeur à virgule flottante comprise entre 0 et 1. Si une valeur est supérieure à 1, le vecteur est normalisé de manière à ce que sa magnitude soit 1. Par défaut, il s'agit de l'axe Z positif, (0, 0, 1).
    • DonnéesPosition : un vecteur contenant 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, il s'agit d'une chaîne UTF8 arbitraire.
  • Données (Hidden)Label2 (String) : une description plus longue, modifiable par l'utilisateur, de cet objet. Il s'agit d'une chaîne UTF8 arbitraire qui peut inclure des nouvelles lignes. Par défaut, il s'agit d'une chaîne vide "".
  • Données (Hidden)Expression Engine (ExpressionEngine) : une liste d'expressions. Par défaut, elle est vide [].
  • Données (Hidden)Visibility (Bool) : affichage ou non l'objet.
  • Données (Hidden)Origin (Link) : l'objet App Origin qui sert de référence positionnelle pour tous les éléments énumérés dans DonnéesGroup.
  • DonnéesGroup (LinkList) : une liste d'objets référencés. Par défaut, elle est vide [].
  • Données (Hidden)_Group Touched (Bool) : indique si le groupe est touché ou non.

Vue

Display Options

  • VueDisplay Mode (Enumeration) : Group.
  • VueShow In Tree (Bool) : si la valeur est true, l'objet apparaît dans la Vue en arborescence. Sinon, il est défini comme invisible.
  • VueVisibility (Bool) : si elle est 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 du clavier.

Selection

  • VueOn Top When Selected (Enumeration) : Disabled (par défaut) (par défaut), Enabled, Object, Element.
  • 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 la Vue 3D ; si elle est BoundBox, seule la boîte de délimitation sera mise en évidence.

Explications détaillées

Statut actif

Un document ouvert peut contenir plusieurs parties. Mais une seule pièce peut être active. La partie active est affichée dans la vue en arborescence avec la couleur de fond spécifiée par la valeur Contenant actif dans l'éditeur de préférences (par défaut, bleu clair). Il sera également affiché avec du texte en gras.

Pour activer ou désactiver un Part :

  • Double-cliquez dessus dans l'arborescence ou
  • Ouvrez le menu contextuel (clic droit) et sélectionnez Toggle active part.

Document avec deux Std Parts, dont le second est actif.

Origine

L'Origine se compose des trois axes standard (X, Y, Z) et de trois plans standard (XY, XZ et YZ). Les esquisses et d'autres objets peuvent être attachés à ces éléments lors de leur création.

À gauche : Part Origin dans la vue en arborescence. À droite : représentation des éléments Origin dans la Vue 3D.

Remarque : L'origine est un App Origin objet (de classe App::Origin) tandis que les axes et les plans sont respectivement des objets de type App::Line et App::Plane. Chacun de ces éléments peut être masqué et non masqué individuellement avec la barre Espace. Cela est utile pour choisir la référence correcte lors de la création d'autres objets.

Remarque 2 : tous les éléments à l'intérieur du Part sont référencés à l'origine du Part, ce qui signifie que le Part peut être déplacé et tourné en référence au système de coordonnées global sans affecter le placement des éléments à l'intérieur.

Gestion de la visibilité

La visibilité d'un Part remplace la visibilité de tout objet qu'elle contient. Si Part est masqué, les objets qu'il contient seront également masqués, même si leur propriété individuelle VueVisibility est définie sur true. Si Part est visible, la VueVisibility de chaque objet détermine si l'objet est affiché ou non.

La visibilité de Std Part détermine si les objets regroupés sous lui sont affichés dans la vue 3D ou non. À gauche : Part est masqué, donc aucun des objets ne sera affiché dans la vue 3D. À droite : Part est visible, donc chaque objet contrôle sa propre visibilité.

Script

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

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

Std Part (App Part) est créé avec la méthode addObject() du document. Une fois que Part existe, d'autres objets peuvent y être ajoutés avec les méthodes addObject() ou addObjects().

import FreeCAD as App

doc = App.newDocument()
part = App.ActiveDocument.addObject("App::Part", "Part")

obj1 = App.ActiveDocument.addObject("PartDesign::Body", "Body")
obj2 = App.ActiveDocument.addObject("Part::Box", "Box")

part.addObjects([obj1, obj2])
App.ActiveDocument.recompute()

Vous ne pouvez pas créer un App::Part scripté. Cependant, vous pouvez ajouter un comportement App::Part à un objet Part::FeaturePython scripté en utilisant le code suivant :

class MyGroup(object):
    def __init__(self, obj=None):
        self.Object = obj
        if obj:
            self.attach(obj)

    def dumps(self):
        return

    def loads(self, _state):
        return

    def attach(self, obj):
        obj.addExtension("App::OriginGroupExtensionPython")
        obj.Origin = FreeCAD.ActiveDocument.addObject("App::Origin", "Origin")

    def onDocumentRestored(self, obj):
        self.Object = obj

class ViewProviderMyGroup(object):
    def __init__(self, vobj=None):
        if vobj:
            vobj.Proxy = self
            self.attach(vobj)
        else:
            self.ViewObject = None

    def attach(self, vobj):
        vobj.addExtension("Gui::ViewProviderOriginGroupExtensionPython")
        self.ViewObject = vobj

    def dumps(self):
        return None

    def loads(self, _state):
        return None

App.ActiveDocument.addObject("Part::FeaturePython",
                             "Group",
                             group.MyGroup(),
                             group.ViewProviderMyGroup(),
                             True)