Std Part/ro: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
 
(18 intermediate revisions by the same user not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{Docnav||[[Std Group|Group]]|[[PartDesign_Workbench|PartDesign]]|IconL=|IconC=Workbench_PartDesign.svg|IconR=Group.svg}}


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

<div class="mw-translate-fuzzy">
{{GuiCommand/ro
{{GuiCommand/ro
|Name=Std Part
|Name=Std Part
Line 10: Line 19:
|SeeAlso=[[Std Group/ro|Std Group]], [[PartDesign Body/ro|PartDesign Body]]
|SeeAlso=[[Std Group/ro|Std Group]], [[PartDesign Body/ro|PartDesign Body]]
}}
}}
</div>


<span id="Description"></span>
==Descriere==
==Descriere==


<div class="mw-translate-fuzzy">
'''Part'''(piesa) este un container de uz general care ține împreună un grup de obiecte astfel încât ele pot fi mișcate ca o unitate. Piesa poate conține majoritatea obiectelor FreeCAD, cum ar fi corpurile PartDesign, obiecte ale atelierului Part, obiecte Mesh etc.
'''Part'''(piesa) este un container de uz general care ține împreună un grup de obiecte astfel încât ele pot fi mișcate ca o unitate. Piesa poate conține majoritatea obiectelor FreeCAD, cum ar fi corpurile PartDesign, obiecte ale atelierului Part, obiecte Mesh etc.
</div>


<div class="mw-translate-fuzzy">
Piesa oferă un sistem local de coordonate la care se pot atașa schițe și alte obiecte.
Piesa oferă un sistem local de coordonate la care se pot atașa schițe și alte obiecte.
</div>


Although it is primarily intended for solid bodies, the Std Part can be used to manage any object that has a [[Placement|Placement]] property, so it can also contain [[Mesh_Feature|Mesh Features]], [[Sketch|sketches]], and other objects derived from the [[App_GeoFeature|App GeoFeature]] class.

<div class="mw-translate-fuzzy">
O Piesă se află în bara de instrumente Structure care este afișată în toate atelierele de lucru.
O Piesă se află în bara de instrumente Structure care este afișată în toate atelierele de lucru.
</div>


The {{Button|[[File:Std_Part.svg|16px]] [[Std_Part|Std Part]]}} tool is not defined by a particular workbench, but by the base system, thus it is found in the {{MenuCommand|structure toolbar}} that is available in all [[Workbenches|workbenches]]. To group objects arbitrarily without considering their position, use {{Button|[[File:Std_Group.svg|16px]] [[Std_Group|Std Group]]}}; this object does not affect the placements of the elements that it contains, it is essentially just a folder that is used to keep the [[Tree_view|Tree view]] organized.
{{Version|0.17}}
[[File:Std Part-tree.png|top]][[File:Std Part example.png]]
===Example de utilizări===
* As an assembly container that groups objects to be manufactured separately then glued or screwed together, like a wooden table.
* When importing a STEP assembly in FreeCAD, the main assembly and its sub-assemblies are Part containers.
* A part that is composed of multiple non-fused components, like a ball bearing.


[[File:Std Part-tree.png]][[File:Std Part example.png]]
===Status Active===

A FreeCAD document can contain multiple Parts. Only one Part can be active at a time. An active Part will be displayed in the tree with a light blue background color.
{{Caption|Left: elements inside a Std Part in the [[Tree_view|Tree view]]. Right: objects positioned in space, referred to the Origin of the Std Part.}}
[[File:Std Part-tree-active.png|none]]
===Origini===
The Origin consists of the three standard axes (X, Y, Z) and three standard planes (XY, XZ and YZ). Sketches can be attached to these planes. All elements inside the Part are referenced to the Part's Origin; which means that the Part can be moved and rotated in reference to the global coordinate system without affecting the placement of elements inside it.
[[File:PartDesign_Body_tree-02.png|none]]
===Managementul Vizibilității===
The Part's visibility supersedes the visibility of any object it contains. If the Part is hidden, the objects it contains will be hidden as well, even if their visibility is set to true. Multiple objects inside a Part can be visible at a time.


<span id="Usage"></span>
<div class="mw-translate-fuzzy">
== Cum se folosește ==
== Cum se folosește ==
</div>


<div class="mw-translate-fuzzy">
* Press the {{KEY|[[Image:Std Part.png|24px]] '''Create part'''}} button in the toolbar. The Part automatically becomes active.
* Press the {{KEY|[[Image:Std Part.png|24px]] '''Create part'''}} button in the toolbar. The Part automatically becomes active.
* Double-click the Part in the Model tree to activate or deactivate it.
* Double-click the Part in the Model tree to activate or deactivate it.
* To add objects to a Part, drag & drop them over the Part in the Model tree.
* To add objects to a Part, drag & drop them over the Part in the Model tree.
* To remove objects from a Part, drag & drop them out of the Part and on the document label at the top of the Model tree.
* To remove objects from a Part, drag & drop them out of the Part and on the document label at the top of the Model tree.
</div>


== Notes ==

* An object can only belong to a single Part.
* 3D operations like [[Part_Boolean|Part Boolean]] cannot be applied to Parts. For example, you cannot select two Parts, and perform a [[Part_Fuse|Part Fuse]] or [[Part_Cut|Part Cut]].

<span id="Properties"></span>
==Proprietăți==
==Proprietăți==


The [[Std_Part|Std Part]], internally called [[App_Part|App Part]] ({{incode|App::Part}} class), is derived from the [[App_GeoFeature|App GeoFeature]] ({{incode|App::GeoFeature}} class) and inherits all its properties. It also has several additional properties. Notably properties that help it manage information in the context of an assembly, for example, {{PropertyData|Type}}, {{PropertyData|Id}}, {{PropertyData|License}}, {{PropertyData|LicenseURL}} and {{PropertyData|Group}}.

These are the properties available in the [[Property_editor|property editor]]. Hidden properties can be shown by using the {{MenuCommand|Show all}} command in the context menu of the [[Property_editor|property editor]].

=== Data ===

{{TitleProperty|Base}}

<div class="mw-translate-fuzzy">
* {{PropertyData|Id}}: ID (Part number) of the item. This field is optional.
* {{PropertyData|Id}}: ID (Part number) of the item. This field is optional.
* {{PropertyData|License}}: the license under which the part is released.
* {{PropertyData|License}}: the license under which the part is released.
Line 50: Line 79:
* {{PropertyData|Label}}: the Label is the name given to the operation. This name can be changed at your convenience.
* {{PropertyData|Label}}: the Label is the name given to the operation. This name can be changed at your convenience.
* {{PropertyData|Group}}: lists the referenced objects.
* {{PropertyData|Group}}: lists the referenced objects.
</div>


==Limite==
=== View ===


{{TitleProperty|Display Options}}
*Chiar și atunci când o Piesă este activă, obiectele nou create nu sunt lasate în interiorul Piesei/Part, dar vor fi plasate în partea de jos a arborescenței. Pur și simplu glisați și fixați-le peste Piesă.
* O piesă nu are formă. Nu este posibil să aplicați cele mai multe operații 3D asupra unei Piesei, ca operații Booleene.
* În acest moment, [[Draft Snap | Draft Snaps]] nu funcționează pe unul sau mai multe containere Piesă selectate sau pe obiectele din interiorul unui container.
* '' Notă a Redactorului: în acest moment nu este clar statutul activ al piesei nu este clar. ''


* {{PropertyView|Display Mode|Enumeration}}: {{value|Group}}.
* {{PropertyView|Show In Tree|Bool}}: if it is {{TRUE}}, the object appears in the [[Tree_view|Tree view]]. Otherwise, it is set as invisible.
* {{PropertyView|Visibility|Bool}}: if it is {{TRUE}}, the object appears in the [[3D_view|3D view]]; otherwise it is invisible. By default this property can be toggled on and off by pressing the {{KEY|Space}} bar in the keyboard.


{{TitleProperty|Selection}}
{{Docnav||[[Std Group|Group]]|[[PartDesign_Workbench|PartDesign]]|IconL=|IconC=Workbench_PartDesign.svg|IconR=Group.svg}}


* {{PropertyView|On Top When Selected|Enumeration}}: {{value|Disabled}} (default), {{value|Enabled}}, {{value|Object}}, {{value|Element}}.
{{PartDesign Tools navi}}
* {{PropertyView|Selection Style|Enumeration}}: {{value|Shape}} (default), {{value|BoundBox}}. If the option is {{value|Shape}}, the entire shape (vertices, edges, and faces) will be highlighted in the [[3D_view|3D view]]; if it is {{value|BoundBox}} only the bounding box will be highlighted.

== Detailed explanation ==

<span id="Active_status"></span>
<div class="mw-translate-fuzzy">
===Status Active===
A FreeCAD document can contain multiple Parts. Only one Part can be active at a time. An active Part will be displayed in the tree with a light blue background color.
</div>

An open document can contain multiple Parts. But only one Part can be active. The active Part is displayed in the [[Tree_view|tree view]] with the background color specified by the {{MenuCommand|Active container}} value in the [[Preferences_Editor#Colors|preferences editor]] (by default, light blue). It will also be shown with bold text.

To activate or de-activate a Part:
* Double click on it on the [[Tree_view|Tree view]], or
* Open the context menu (right click) and select {{MenuCommand|Toggle active part}}.

[[File:Std_Part_active.png]]

{{Caption|Document with two Std Parts, of which the second one is active.}}

<span id="Origin"></span>
<div class="mw-translate-fuzzy">
===Origini===
The Origin consists of the three standard axes (X, Y, Z) and three standard planes (XY, XZ and YZ). Sketches can be attached to these planes. All elements inside the Part are referenced to the Part's Origin; which means that the Part can be moved and rotated in reference to the global coordinate system without affecting the placement of elements inside it.
</div>

The Origin consists of the three standard axes (X, Y, Z) and three standard planes (XY, XZ and YZ). [[Sketch|Sketches]] and other objects can be attached to these elements when creating them.

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

{{Caption|Left: Part Origin in the [[Tree_view|Tree view]]. Right: representation of the Origin elements in the [[3D_view|3D view]].}}

{{Emphasis|Note:}} the Origin is an [[App_OriginGroupExtension|App Origin]] object ({{incode|App::Origin}} class), while the axes and planes are objects of type {{incode|App::Line}} and {{incode|App::Plane}} respectively. Each of these elements can be hidden and unhidden individually with the {{KEY|Space}} bar; this is useful to choose the correct reference when creating other objects.

{{Emphasis|Note 2:}} all elements inside the Part are referenced to the Part's Origin which means that the Part can be moved and rotated in reference to the global coordinate system without affecting the placement of the elements inside.

<span id="Visibility_Management"></span>
<div class="mw-translate-fuzzy">
===Managementul Vizibilității===
The Part's visibility supersedes the visibility of any object it contains. If the Part is hidden, the objects it contains will be hidden as well, even if their visibility is set to true. Multiple objects inside a Part can be visible at a time.
</div>

The Part's visibility supersedes the visibility of any object it contains. If the Part is hidden, the objects it contains will be hidden as well, even if their individual {{PropertyView|Visibility}} property is set to {{TRUE}}. If the Part is visible, then each object's {{PropertyView|Visibility}} determines whether the object is shown or not.

[[File:Part_Visibility_off.png]] [[File:Part_Visibility_on.png]]
{{Caption|The visibility of the Std Part determines whether the objects grouped under it are shown in the [[3D_view|3D view]] or not. Left: the Part is hidden, so none of the objects will be shown in the [[3D_view|3D view]]. Right: the Part is visible, so each object controls its own visibility.}}

== Scripting ==

{{Emphasis|See also:}} [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]] and [[Scripted_objects|scripted objects]].

See [[Part_Feature|Part Feature]] for the general information on adding objects to the document.

A Std Part ([[App_Part|App Part]]) is created with the {{incode|addObject()}} method of the document. Once a Part exists, other objects can be added to it with the {{incode|addObject()}} or {{incode|addObjects()}} methods.

{{Code|code=
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()
}}

You cannot create a scripted {{incode|App::Part}}. However, you can add {{incode|App::Part}} behavior to a scripted {{incode|Part::FeaturePython}} object by using the following code:

{{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
|
|[[Std_Group|Group]]
|[[Std_Base|Std Base]]
|IconL=
|IconR=Std_Group.svg
|IconC=Freecad.svg
}}


{{Std_Base_navi{{#translation:}}}}
{{Userdocnavi}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 09:02, 27 January 2024

Std Part

poziția meniului
None
Ateliere
All
scurtătură
nici unul
Prezentat în versiune
0.17
A se vedea, de asemenea,
Std Group, PartDesign Body

Descriere

Part(piesa) este un container de uz general care ține împreună un grup de obiecte astfel încât ele pot fi mișcate ca o unitate. Piesa poate conține majoritatea obiectelor FreeCAD, cum ar fi corpurile PartDesign, obiecte ale atelierului Part, obiecte Mesh etc.

Piesa oferă un sistem local de coordonate la care se pot atașa schițe și alte obiecte.

Although it is primarily intended for solid bodies, the Std Part can be used to manage any object that has a Placement property, so it can also contain Mesh Features, sketches, and other objects derived from the App GeoFeature class.

O Piesă se află în bara de instrumente Structure care este afișată în toate atelierele de lucru.

The Std Part tool is not defined by a particular workbench, but by the base system, thus it is found in the structure toolbar that is available in all workbenches. To group objects arbitrarily without considering their position, use Std Group; this object does not affect the placements of the elements that it contains, it is essentially just a folder that is used to keep the Tree view organized.

Left: elements inside a Std Part in the Tree view. Right: objects positioned in space, referred to the Origin of the Std Part.

Cum se folosește

  • Press the Create part button in the toolbar. The Part automatically becomes active.
  • Double-click the Part in the Model tree to activate or deactivate it.
  • To add objects to a Part, drag & drop them over the Part in the Model tree.
  • To remove objects from a Part, drag & drop them out of the Part and on the document label at the top of the Model tree.

Notes

  • An object can only belong to a single Part.
  • 3D operations like Part Boolean cannot be applied to Parts. For example, you cannot select two Parts, and perform a Part Fuse or Part Cut.

Proprietăți

The Std Part, internally called App Part (App::Part class), is derived from the App GeoFeature (App::GeoFeature class) and inherits all its properties. It also has several additional properties. Notably properties that help it manage information in the context of an assembly, for example, DateType, DateId, DateLicense, DateLicenseURL and DateGroup.

These are the properties available in the property editor. Hidden properties can be shown by using the Show all command in the context menu of the property editor.

Data

Base

  • DateId: ID (Part number) of the item. This field is optional.
  • DateLicense: the license under which the part is released.
  • DateLicense URL: the Web address where the terms license can be found.
  • DatePlacement: specifies the orientation and position of the Part in the 3D space. See Placement.
  • DateLabel: the Label is the name given to the operation. This name can be changed at your convenience.
  • DateGroup: lists the referenced objects.

View

Display Options

  • VizualizareDisplay Mode (Enumeration): Group.
  • VizualizareShow In Tree (Bool): if it is true, the object appears in the Tree view. Otherwise, it is set as invisible.
  • VizualizareVisibility (Bool): 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.

Selection

  • VizualizareOn Top When Selected (Enumeration): Disabled (default), Enabled, Object, Element.
  • VizualizareSelection Style (Enumeration): Shape (default), BoundBox. If the option is Shape, the entire shape (vertices, edges, and faces) will be highlighted in the 3D view; if it is BoundBox only the bounding box will be highlighted.

Detailed explanation

Status Active

A FreeCAD document can contain multiple Parts. Only one Part can be active at a time. An active Part will be displayed in the tree with a light blue background color.

An open document can contain multiple Parts. But only one Part can be active. The active Part is displayed in the tree view with the background color specified by the Active container value in the preferences editor (by default, light blue). It will also be shown with bold text.

To activate or de-activate a Part:

  • Double click on it on the Tree view, or
  • Open the context menu (right click) and select Toggle active part.

Document with two Std Parts, of which the second one is active.

Origini

The Origin consists of the three standard axes (X, Y, Z) and three standard planes (XY, XZ and YZ). Sketches can be attached to these planes. All elements inside the Part are referenced to the Part's Origin; which means that the Part can be moved and rotated in reference to the global coordinate system without affecting the placement of elements inside it.

The Origin consists of the three standard axes (X, Y, Z) and three standard planes (XY, XZ and YZ). Sketches and other objects can be attached to these elements when creating them.

Left: Part Origin in the Tree view. Right: representation of the Origin elements in the 3D view.

Note: the Origin is an App Origin object (App::Origin class), while the axes and planes are objects of type App::Line and App::Plane respectively. Each of these elements can be hidden and unhidden individually with the Space bar; this is useful to choose the correct reference when creating other objects.

Note 2: all elements inside the Part are referenced to the Part's Origin which means that the Part can be moved and rotated in reference to the global coordinate system without affecting the placement of the elements inside.

Managementul Vizibilității

The Part's visibility supersedes the visibility of any object it contains. If the Part is hidden, the objects it contains will be hidden as well, even if their visibility is set to true. Multiple objects inside a Part can be visible at a time.

The Part's visibility supersedes the visibility of any object it contains. If the Part is hidden, the objects it contains will be hidden as well, even if their individual VizualizareVisibility property is set to true. If the Part is visible, then each object's VizualizareVisibility determines whether the object is shown or not.

The visibility of the Std Part determines whether the objects grouped under it are shown in the 3D view or not. Left: the Part is hidden, so none of the objects will be shown in the 3D view. Right: the Part is visible, so each object controls its own visibility.

Scripting

See also: FreeCAD Scripting Basics and scripted objects.

See Part Feature for the general information on adding objects to the document.

A Std Part (App Part) is created with the addObject() method of the document. Once a Part exists, other objects can be added to it with the addObject() or addObjects() methods.

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()

You cannot create a scripted App::Part. However, you can add App::Part behavior to a scripted Part::FeaturePython object by using the following 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)