Std Group: Difference between revisions
Renatorivo (talk | contribs) (Marked this version for translation) |
No edit summary |
||
(30 intermediate revisions by 7 users not shown) | |||
Line 1: | Line 1: | ||
<languages/> |
|||
<translate> |
<translate> |
||
<!--T:19--> |
|||
{{Docnav |
|||
|[[Std_Part|Part]] |
|||
|[[Std_LinkMake|LinkMake]] |
|||
|[[Std_Base|Std Base]] |
|||
|IconL=Std_Part.svg |
|||
|IconR=Std_LinkMake.svg |
|||
|IconC=Freecad.svg |
|||
}} |
|||
<!--T:1--> |
<!--T:1--> |
||
{{GuiCommand |
|||
{{GuiCommand|Name=Std Group|MenuLocation=Tree View → Right click on the document name||Workbenches=All|Shortcut=|SeeAlso=[[Draft_SelectGroup|Draft SelectGroup]], [[Draft_AddToGroup|Draft AddToGroup]]}} |
|||
|Name=Std Group |
|||
|MenuLocation=[[Tree_view|Tree view]] → Right click on the document name → Create group |
|||
|Workbenches=All |
|||
|Shortcut= |
|||
|Version= |
|||
|SeeAlso=[[Std_Part|Std Part]], [[Draft_SelectGroup|Draft SelectGroup]], [[Draft_AddToGroup|Draft AddToGroup]] |
|||
}} |
|||
==Description== <!--T:2--> |
==Description== <!--T:2--> |
||
<!--T:3--> |
<!--T:3--> |
||
[[Std_Group|Std Group]] (internally called [[App_DocumentObjectGroup|App DocumentObjectGroup]]) is a general purpose container that allows you to group different types of objects in the [[tree_view|tree view]], regardless of their data type. It is used as a simple folder to categorize and organize the objects in your model, in order to keep a logical structure. Std Groups may be nested inside other Std Groups. |
|||
This command lets you create a group in the tree view. |
|||
<br /> |
|||
It can be used for organizing the structure of your model. |
|||
<!--T:27--> |
|||
The Std Group 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]]. |
|||
<!--T:28--> |
|||
To group 3D objects as a single unit, with the intention of creating assemblies, use [[Std_Part|Std Part]] instead. |
|||
<!--T: |
<!--T:7--> |
||
[[File:Std_Group_example.png]] |
|||
Right-click on the name of your FreeCAD-document in the tree-view and choose "create group". |
|||
<br /> |
|||
A group will be created automatically and give the icon of a directory and an automatically chosen name. |
|||
<br /> |
|||
You can rename the group by right-clicking on the group and choosing "rename" or using "F2" on your keyboard. |
|||
<br /> |
|||
Push FreeCAD-objects into the group or pull them out of the group by clicking on the desired object, |
|||
<br /> |
|||
keep left-mouse button pressed and using drag&drop-style to drag the object to desired new location. |
|||
<br /> |
|||
As long as there is a "circle with a diagonal line"-sign below the cursor you can't drop your object here. |
|||
<br /> |
|||
As soon as the sign changes to a "plus"-symbol it is possible to drop your object here. |
|||
<br /> |
|||
<!--T: |
<!--T:29--> |
||
{{Caption|Various elements inside Std Groups in the tree view.}} |
|||
# Right click on active document or on existing group in the [[Document structure|Tree View]] and select {{KEY|Create Group...}} |
|||
# Drag-n-drop objects into the group |
|||
==Usage== <!--T:4--> |
|||
<!--T: |
<!--T:5--> |
||
# Click on the name of the document in the [[tree_view|tree view]], open the context menu (right click), and choose {{Button|Create group}}. |
|||
[[Image:group_with_objects.png|300px]] |
|||
# Alternatively, press the {{Button|[[Image:Std_Group.svg|16px]] [[Std_Group|Group]]}} button in the structure toolbar. An empty Group is created. |
|||
# To add objects to a Group, select them in [[tree_view|tree view]], and then drag and drop them over the Group. |
|||
# To remove objects from a Group, drag them out of the Group, and onto the document label at the top of the [[tree_view|tree view]]. |
|||
== |
=== Notes === <!--T:30--> |
||
<!--T: |
<!--T:31--> |
||
* The Group object does not affect the positions in the [[3D_view|3D view]] of the elements that it contains; it is essentially just a folder that is used to keep the [[tree_view|tree view]] organized. |
|||
* To rename the group select a group and press {{KEY|F2}}, or right click a group and select {{KEY|Rename}} |
|||
* The Group can also be created from the [[Python console|Python console]], and sub-classed to create special "groups", as indicated in the [[Std_Group#Scripting|Scripting]] section. |
|||
==Properties== <!--T:10--> |
==Properties== <!--T:10--> |
||
<!--T:32--> |
|||
A [[Std_Group|Std Group]] is internally called [[App_DocumentObjectGroup|App DocumentObjectGroup]] ({{incode|App::DocumentObjectGroup}} class), and is derived from the basic [[App_DocumentObject|App DocumentObject]] ({{incode|App::DocumentObject}} class), therefore it shares all the latter's properties. |
|||
<!--T:33--> |
|||
In addition to the properties described in [[App_FeaturePython|App FeaturePython]], which is the most basic instance of an [[App_DocumentObject|App DocumentObject]], the App DocumentObjectGroup has the {{PropertyData|Group}} property. |
|||
<!--T:34--> |
|||
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 === <!--T:35--> |
|||
<!--T:36--> |
|||
{{TitleProperty|Base}} |
|||
<!--T:11--> |
<!--T:11--> |
||
* |
* {{PropertyData|Label|String}}: the user editable name of this object, it is an arbitrary UTF8 string. |
||
* {{PropertyData|Group|LinkList}}: a list of referenced objects. By default, it is empty {{value|[]}}. |
|||
==== Hidden properties Data ==== <!--T:37--> |
|||
<!--T:38--> |
|||
* {{PropertyData|Proxy|PythonObject}}: a custom class associated with this object. This only exists for the [[Python|Python]] version. See [[Std_Group#Scripting|Scripting]]. |
|||
=== View === <!--T:39--> |
|||
<!--T:40--> |
|||
{{TitleProperty|Base}} |
|||
<!--T:41--> |
|||
See [[App_FeaturePython|App FeaturePython]] for the basic view properties. |
|||
==== Hidden properties View ==== <!--T:42--> |
|||
<!--T:43--> |
|||
* {{PropertyView|Proxy|PythonObject}}: a custom view provider class associated with this object. This only exists for the [[Python|Python]] version. See [[Std_Group#Scripting|Scripting]]. |
|||
== Inheritance == <!--T:23--> |
|||
<!--T:24--> |
|||
A [[Std Group|Std Group]] is formally an instance of the class {{incode|App::DocumentObjectGroup}}, whose parent is the basic [[App_DocumentObject|App DocumentObject]] ({{incode|App::DocumentObject}} class), and is augmented with a Group extension. |
|||
<!--T:25--> |
|||
[[File:FreeCAD_core_objects.svg|800px]] |
|||
<!--T:26--> |
|||
{{Caption|Simplified diagram of the relationships between the core objects in the program. The {{incode|App::DocumentObjectGroup}} class is a simple container which uses the Group extension to be able to hold any type of object.}} |
|||
==Scripting== <!--T:12--> |
==Scripting== <!--T:12--> |
||
<!--T:13--> |
<!--T:13--> |
||
{{Emphasis|See also:}} [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]], and [[scripted objects|scripted objects]]. |
|||
Following command adds new group to the active document: |
|||
<!--T:44--> |
|||
See [[Part_Feature|Part Feature]] for the general information on adding objects to the document. |
|||
<!--T:45--> |
|||
A Std Group ([[App_DocumentObjectGroup|App DocumentObjectGroup]]) is created with the {{incode|addObject()}} method of the document. Once a Group exists, other objects can be added to it with the {{incode|addObject()}} or {{incode|addObjects()}} methods of this Group. |
|||
</translate> |
</translate> |
||
{{Code|code= |
{{Code|code= |
||
import FreeCAD as App |
|||
App.ActiveDocument.addObject("App::DocumentObjectGroup","Group") |
|||
doc = App.newDocument() |
|||
obj = App.ActiveDocument.addObject("App::DocumentObjectGroup", "Group") |
|||
bod1 = App.ActiveDocument.addObject("PartDesign::Body", "Body") |
|||
bod2 = App.ActiveDocument.addObject("Part::Box", "Box") |
|||
obj.addObjects([bod1, bod2]) |
|||
App.ActiveDocument.recompute() |
|||
}} |
|||
<translate> |
|||
<!--T:46--> |
|||
This basic {{incode|App::DocumentObjectGroup}} doesn't have a Proxy object so it can't be fully used for sub-classing. |
|||
<!--T:47--> |
|||
Therefore, for [[Python|Python]] subclassing, you should create the {{incode|App::DocumentObjectGroupPython}} object. |
|||
</translate> |
|||
{{Code|code= |
|||
import FreeCAD as App |
|||
doc = App.newDocument() |
|||
obj = App.ActiveDocument.addObject("App::DocumentObjectGroupPython", "Name") |
|||
obj.Label = "Custom label" |
|||
}} |
}} |
||
<translate> |
<translate> |
||
==Limitations== <!--T:14--> |
|||
<!--T: |
<!--T:48--> |
||
For example, a [[FEM Analysis|FEM Analysis]] is an {{incode|App::DocumentObjectGroupPython}} object with a custom icon and additional properties. |
|||
Command needs an open FreeCAD-document to work. |
|||
==Links== <!--T:16--> |
==Links== <!--T:16--> |
||
Line 71: | Line 151: | ||
* [[Document_structure|Document structure]] |
* [[Document_structure|Document structure]] |
||
* [http://www.freecadweb.org/wiki/index.php?title=Arch_tutorial#Organizing_your_model Organizing your model] |
* [http://www.freecadweb.org/wiki/index.php?title=Arch_tutorial#Organizing_your_model Organizing your model] |
||
* [[Ways_To_Organize_Objects|Organize objects in the document]] |
|||
==Notes== <!--T:18--> |
|||
<!--T:20--> |
|||
{{Docnav |
|||
|[[Std_Part|Part]] |
|||
|[[Std_LinkMake|LinkMake]] |
|||
|[[Std_Base|Std Base]] |
|||
|IconL=Std_Part.svg |
|||
|IconR=Std_LinkMake.svg |
|||
|IconC=Freecad.svg |
|||
}} |
|||
</translate> |
</translate> |
||
{{Std Base navi{{#translation:}}}} |
|||
{{Userdocnavi{{#translation:}}}} |
|||
{{clear}} |
{{clear}} |
||
<languages/> |
Revision as of 21:41, 21 December 2020
Std Group |
Menu location |
---|
Tree view → Right click on the document name → Create group |
Workbenches |
All |
Default shortcut |
None |
Introduced in version |
- |
See also |
Std Part, Draft SelectGroup, Draft AddToGroup |
Description
Std Group (internally called App DocumentObjectGroup) is a general purpose container that allows you to group different types of objects in the tree view, regardless of their data type. It is used as a simple folder to categorize and organize the objects in your model, in order to keep a logical structure. Std Groups may be nested inside other Std Groups.
The Std Group 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 3D objects as a single unit, with the intention of creating assemblies, use Std Part instead.
Various elements inside Std Groups in the tree view.
Usage
- Click on the name of the document in the tree view, open the context menu (right click), and choose Create group.
- Alternatively, press the Group button in the structure toolbar. An empty Group is created.
- To add objects to a Group, select them in tree view, and then drag and drop them over the Group.
- To remove objects from a Group, drag them out of the Group, and onto the document label at the top of the tree view.
Notes
- The Group object does not affect the positions in the 3D view of the elements that it contains; it is essentially just a folder that is used to keep the tree view organized.
- The Group can also be created from the Python console, and sub-classed to create special "groups", as indicated in the Scripting section.
Properties
A Std Group is internally called App DocumentObjectGroup (App::DocumentObjectGroup
class), and is derived from the basic App DocumentObject (App::DocumentObject
class), therefore it shares all the latter's properties.
In addition to the properties described in App FeaturePython, which is the most basic instance of an App DocumentObject, the App DocumentObjectGroup has the DataGroup property.
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
- DataLabel (
String
): the user editable name of this object, it is an arbitrary UTF8 string. - DataGroup (
LinkList
): a list of referenced objects. By default, it is empty[]
.
Hidden properties Data
- DataProxy (
PythonObject
): a custom class associated with this object. This only exists for the Python version. See Scripting.
View
Base
See App FeaturePython for the basic view properties.
Hidden properties View
- ViewProxy (
PythonObject
): a custom view provider class associated with this object. This only exists for the Python version. See Scripting.
Inheritance
A Std Group is formally an instance of the class App::DocumentObjectGroup
, whose parent is the basic App DocumentObject (App::DocumentObject
class), and is augmented with a Group extension.
Simplified diagram of the relationships between the core objects in the program. The App::DocumentObjectGroup
class is a simple container which uses the Group extension to be able to hold any type of object.
Scripting
See also: FreeCAD Scripting Basics, and scripted objects.
See Part Feature for the general information on adding objects to the document.
A Std Group (App DocumentObjectGroup) is created with the addObject()
method of the document. Once a Group exists, other objects can be added to it with the addObject()
or addObjects()
methods of this Group.
import FreeCAD as App
doc = App.newDocument()
obj = App.ActiveDocument.addObject("App::DocumentObjectGroup", "Group")
bod1 = App.ActiveDocument.addObject("PartDesign::Body", "Body")
bod2 = App.ActiveDocument.addObject("Part::Box", "Box")
obj.addObjects([bod1, bod2])
App.ActiveDocument.recompute()
This basic App::DocumentObjectGroup
doesn't have a Proxy object so it can't be fully used for sub-classing.
Therefore, for Python subclassing, you should create the App::DocumentObjectGroupPython
object.
import FreeCAD as App
doc = App.newDocument()
obj = App.ActiveDocument.addObject("App::DocumentObjectGroupPython", "Name")
obj.Label = "Custom label"
For example, a FEM Analysis is an App::DocumentObjectGroupPython
object with a custom icon and additional properties.
Links
- File: New, Open, Close, Close All, Save, Save As, Save a Copy, Save All, Revert, Import, Export,Merge project, Project information, Print, Print preview, Export PDF, Recent files, Exit
- Edit: Undo, Redo, Cut, Copy, Paste, Duplicate selection, Refresh, Box selection, Box element selection, Select All, Delete, Send to Python Console, Placement, Transform, Alignment, Toggle Edit mode, Edit mode, Preferences
- View:
- Miscellaneous: Create new view, Orthographic view, Perspective view, Fullscreen, Bounding box, Toggle axis cross, Clipping plane, Texture mapping, Toggle navigation/Edit mode, Appearance, Random color, Workbench, Status bar
- Standard views: Fit all, Fit selection, Isometric, Dimetric, Trimetric, Home, Front, Top, Right, Rear, Bottom, Left, Rotate Left, Rotate Right
- Freeze display: Save views, Load views, Freeze view, Clear views
- Draw style: As is, Points, Wireframe, Hidden line, No shading, Shaded, Flat lines
- Stereo: Stereo red/cyan, Stereo quad buffer, Stereo Interleaved Rows, Stereo Interleaved Columns, Stereo Off, Issue camera position
- Zoom: Zoom In, Zoom Out, Box zoom
- Document window: Docked, Undocked, Fullscreen
- Visibility: Toggle visibility, Show selection, Hide selection, Select visible objects, Toggle all objects, Show all objects, Hide all objects, Toggle selectability, Toggle measurement, Clear measurement
- Toolbars: File, Edit, Clipboard, Workbench, Macro, View, Structure, Help
- Panels: Tree view, Property view, Selection view, Tasks, Python console, DAG view, Model, Report view
- Link navigation: Go to linked object, Go to the deepest linked object, Select all links
- Tree view actions: Sync view, Sync selection, Sync placement, Pre-selection, Record selection, Single document, Multi document, Collapse/Expand, Initiate dragging, Go to selection, Selection Back, Selection Forward
- Tools: Edit parameters, Save image, Load image, Scene inspector, Dependency graph, Project utility, Measure distance, Add text document, View turntable, Units calculator, Customize, Addon manager
- Macro: Macro recording, Macros, Recent macros, Execute macro, Attach to remote debugger, Debug macro, Stop debugging, Step over, Step into, Toggle breakpoint
- Help: Help, FreeCAD Website, Donate, Users documentation, Python scripting documentation, Automatic Python modules documentation, FreeCAD Forum, FreeCAD FAQ, Report a bug, About FreeCAD, What's This
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
- Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate
- Help: Tutorials, Video tutorials
- Workbenches: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test Framework, Web
- Hubs: User hub, Power users hub, Developer hub