Assembly CreateView: Difference between revisions

From FreeCAD Documentation
(Created page with "<languages/> {{UnfinishedDocu{{#translation:}}}} <translate> {{Docnav |SolveAssembly |ExportASMT |Assembly |IconL=Assembly_SolveAssembly.svg |IconR=Assembly_ExportASMT.svg |IconC=Workbench_Assembly.svg }} {{GuiCommand |Name=Assembly CreateView |MenuLocation=Assembly → Create Exploded View |Workbenches=Assembly |Shortcut={{KEY|V}} |Version=1.0 |SeeAlso= }} ==Description==...")
 
(Marked this version for translation)
 
(30 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>

<!--T:1-->
{{VeryImportantMessage|This is an experimental feature. To enable it see [[Fine-tuning#Assembly_Workbench|Fine-tuning]].}}

</translate>
{{UnfinishedDocu{{#translation:}}}}
{{UnfinishedDocu{{#translation:}}}}
<translate>
<translate>


<!--T:2-->
{{Docnav
{{Docnav
|[[Assembly_SolveAssembly|SolveAssembly]]
|[[Assembly_SolveAssembly|Solve Assembly]]
|[[Assembly_ExportASMT|ExportASMT]]
|[[Assembly_ExportASMT|Export ASMT File]]
|[[Assembly_Workbench|Assembly]]
|[[Assembly_Workbench|Assembly]]
|IconL=Assembly_SolveAssembly.svg
|IconL=Assembly_SolveAssembly.svg
Line 12: Line 19:
}}
}}


<!--T:3-->
{{GuiCommand
{{GuiCommand
|Name=Assembly CreateView
|Name=Assembly CreateView
Line 21: Line 29:
}}
}}


==Description==
==Description== <!--T:4-->


<!--T:5-->
==Usage==
The [[Image:Assembly_CreateView.svg|24px]] [[Assembly_CreateView|Assembly CreateView]] tool creates an exploded views container (Exploded_Views object) in the active Assembly that contains one (default) or more exploded views (Exploded_View objects). An assembly can only hold one exploded views container.


<!--T:6-->
# There are several ways to invoke the command:
An exploded view collects the moves (Move objects) used to relocate parts from assembled position to exploded position. The altered positions of assembled parts and the representations of the moves are only visible when an exploded view is being edited and in TechDraw views derived from an exploded view.

==Usage== <!--T:7-->

<!--T:8-->
# Make sure an assembly is active.
# There are several ways to invoke the tool:
#* Press the {{Button|[[Image:Assembly_CreateView.svg|16px]] [[Assembly_CreateView|Create Exploded View]]}} button.
#* Press the {{Button|[[Image:Assembly_CreateView.svg|16px]] [[Assembly_CreateView|Create Exploded View]]}} button.
#* Select the {{MenuCommand|Assembly → [[Image:Assembly_CreateView.svg|16px]] Create Exploded View}} option from the menu.
#* Select the {{MenuCommand|Assembly → [[Image:Assembly_CreateView.svg|16px]] Create Exploded View}} option from the menu.
#* Use the keyboard shortcut: {{KEY|V}}.
#* Use the keyboard shortcut: {{KEY|V}}.
# If no Exploded_Views object pre-exists: An Exploded_Views container is added to the active assembly.
# ...
# An Exploded_View object is added to the Exploded_Views container.
# The '''Create Exploded View''' dialog opens in the [[Task_panel|task panel]].
# Optionally check '''Parts as single solid''' checkbox to...
# Optionally choose one way to add a Move:
#* Explode radially:
#*# Press {{Button|Explode radially}}
#*# All parts are selected and a dragger (see [[#Notes|Notes]]) appears.
#*# Optionally realign the dragger by selecting one option from the '''Align dragger to...''' drop-down list.
#*#* Align to...
#*#*# Select an edge or a face of any part to align the dragger.
#*#* Align to part center.
#*#*# The dragger is aligned according to the grounded part's center.
#*#* Align to part origin.
#*#*# The dragger is aligned according to the grounded part's origin.
#*# Move the dragger by one or more of the following options (only the offset from the start point counts, each part's direction is calculated separately):
#*#* Press and hold the left mouse button on an axis arrow and drag to translate the object along that axis.
#*#* Press and hold the left mouse button on a plane and drag to translate the object along that plane.
#*#* Press and hold the left mouse button on a sphere and drag to rotate the object around that axis.
#*# A Move (see [[#Notes|Notes]]) is added once the left mouse button is released.
#* Explode along separate movements:
#*# Select one or more parts.
#*# A dragger appears.
#*# Optionally realign the dragger (see above).
#*# Move the dragger as described above (the directions according to the dragger handles are taken into account).
#*# A Move is added once the left mouse button is released.
#*# Optionally select/deselect parts and/or repeat dragging to add more Moves.
# Do one of the following:
#* Press the {{Button|OK}} button to confirm and finish the tool.
#* Press the {{Button|Cancel}} button to revert all changes and finish the tool.
# All parts are moved back into their assembly position and the connecting lines are hidden.

==Notes== <!--T:9-->

<!--T:10-->
* The dragger is a tool similar to the transformation manipulator ([[Image:Std_TransformManip.svg|16px]] [[Std_TransformManip|Std TransformManip]]), but without an '''Increments''' task panel.
* A Move object in the [[Tree_view|tree view]] is represented in the [[3D_view|3D view]] by a dashed red line for each part involved in this move. These connecting lines are only visible when this tool is running, or in a TechDraw view that is derived from an Exploded_View object.

==Properties== <!--T:11-->

<!--T:12-->
See also: [[Property_editor|Property editor]].

<!--T:13-->
Exploded_Views containers are {{Incode|Assembly::ViewGroup}} objects. Exploded_View objects are derived from the {{Incode|ExplodedView}} class, and Move objects from the {{Incode|ExplodedViewStep}} class.

===Assembly::ViewGroup=== <!--T:14-->

====Data==== <!--T:15-->

<!--T:16-->
{{TitleProperty|Base}}

<!--T:17-->
* {{PropertyData|Label|String}}:
* {{PropertyData|Label2|String|Hidden}}:
* {{PropertyData|Expression Engine|ExpressionEngine|Hidden}}:
* {{PropertyData|Visibility|Bool|Hidden}}:
* {{PropertyData|Group|LinkList}}:
* {{PropertyData|_ Group Touched|Bool|Hidden}}:

====View==== <!--T:18-->

<!--T:19-->
{{TitleProperty|Display Options}}

<!--T:20-->
* {{PropertyView|Display Mode|Enumeration}}:
* {{PropertyView|Show In Tree|Bool}}:
* {{PropertyView|Visibility|Bool}}:

<!--T:21-->
{{TitleProperty|Selection}}

<!--T:22-->
* {{PropertyView|On Top When Selected|Enumeration}}:
* {{PropertyView|Selection Style|Enumeration}}:

===ExplodedView=== <!--T:23-->

<!--T:24-->
An '''ExplodedView''' object is derived from an [[App_FeaturePython|App FeaturePython]] object and inherits all its properties. It also has the following additional properties:

====Data==== <!--T:25-->

<!--T:26-->
{{TitleProperty|Exploded View}}

<!--T:27-->
* {{PropertyData|Moves|LinkList}}: List of the Move objects of the exploded view.

===ExplodedViewStep=== <!--T:28-->

<!--T:29-->
An '''ExplodedViewStep''' object is derived from an [[App_FeaturePython|App FeaturePython]] object and inherits all its properties. It also has the following additional properties:

====Data==== <!--T:30-->

<!--T:31-->
{{TitleProperty|Exploded Move}}

<!--T:32-->
* {{PropertyData|Move Type|Enumeration}}: The Type of the move. ({{Value|Normal}}, {{Value|Radial}}).
* {{PropertyData|Movement Transform|Placement}}: This is the movement of the move.
*: The end placement is the result of the start placement * this placement.
* {{PropertyData|Obj Names|StringList}}: The objects moved by the move.
* {{PropertyData|Parts|LinkList}}: The containing parts of objects moved by the move.



<!--T:33-->
{{Docnav
{{Docnav
|[[Assembly_SolveAssembly|SolveAssembly]]
|[[Assembly_SolveAssembly|Solve Assembly]]
|[[Assembly_ExportASMT|ExportASMT]]
|[[Assembly_ExportASMT|Export ASMT File]]
|[[Assembly_Workbench|Assembly]]
|[[Assembly_Workbench|Assembly]]
|IconL=Assembly_SolveAssembly.svg
|IconL=Assembly_SolveAssembly.svg

Latest revision as of 13:47, 23 May 2024

Other languages:
  • English
This is an experimental feature. To enable it see Fine-tuning.

This documentation is not finished. Please help and contribute documentation.

GuiCommand model explains how commands should be documented. Browse Category:UnfinishedDocu to see more incomplete pages like this one. See Category:Command Reference for all commands.

See WikiPages to learn about editing the wiki pages, and go to Help FreeCAD to learn about other ways in which you can contribute.

Assembly CreateView

Menu location
Assembly → Create Exploded View
Workbenches
Assembly
Default shortcut
V
Introduced in version
1.0
See also
None

Description

The Assembly CreateView tool creates an exploded views container (Exploded_Views object) in the active Assembly that contains one (default) or more exploded views (Exploded_View objects). An assembly can only hold one exploded views container.

An exploded view collects the moves (Move objects) used to relocate parts from assembled position to exploded position. The altered positions of assembled parts and the representations of the moves are only visible when an exploded view is being edited and in TechDraw views derived from an exploded view.

Usage

  1. Make sure an assembly is active.
  2. There are several ways to invoke the tool:
    • Press the Create Exploded View button.
    • Select the Assembly → Create Exploded View option from the menu.
    • Use the keyboard shortcut: V.
  3. If no Exploded_Views object pre-exists: An Exploded_Views container is added to the active assembly.
  4. An Exploded_View object is added to the Exploded_Views container.
  5. The Create Exploded View dialog opens in the task panel.
  6. Optionally check Parts as single solid checkbox to...
  7. Optionally choose one way to add a Move:
    • Explode radially:
      1. Press Explode radially
      2. All parts are selected and a dragger (see Notes) appears.
      3. Optionally realign the dragger by selecting one option from the Align dragger to... drop-down list.
        • Align to...
          1. Select an edge or a face of any part to align the dragger.
        • Align to part center.
          1. The dragger is aligned according to the grounded part's center.
        • Align to part origin.
          1. The dragger is aligned according to the grounded part's origin.
      4. Move the dragger by one or more of the following options (only the offset from the start point counts, each part's direction is calculated separately):
        • Press and hold the left mouse button on an axis arrow and drag to translate the object along that axis.
        • Press and hold the left mouse button on a plane and drag to translate the object along that plane.
        • Press and hold the left mouse button on a sphere and drag to rotate the object around that axis.
      5. A Move (see Notes) is added once the left mouse button is released.
    • Explode along separate movements:
      1. Select one or more parts.
      2. A dragger appears.
      3. Optionally realign the dragger (see above).
      4. Move the dragger as described above (the directions according to the dragger handles are taken into account).
      5. A Move is added once the left mouse button is released.
      6. Optionally select/deselect parts and/or repeat dragging to add more Moves.
  8. Do one of the following:
    • Press the OK button to confirm and finish the tool.
    • Press the Cancel button to revert all changes and finish the tool.
  9. All parts are moved back into their assembly position and the connecting lines are hidden.

Notes

  • The dragger is a tool similar to the transformation manipulator ( Std TransformManip), but without an Increments task panel.
  • A Move object in the tree view is represented in the 3D view by a dashed red line for each part involved in this move. These connecting lines are only visible when this tool is running, or in a TechDraw view that is derived from an Exploded_View object.

Properties

See also: Property editor.

Exploded_Views containers are Assembly::ViewGroup objects. Exploded_View objects are derived from the ExplodedView class, and Move objects from the ExplodedViewStep class.

Assembly::ViewGroup

Data

Base

  • DataLabel (String):
  • Data (Hidden)Label2 (String):
  • Data (Hidden)Expression Engine (ExpressionEngine):
  • Data (Hidden)Visibility (Bool):
  • DataGroup (LinkList):
  • Data (Hidden)_ Group Touched (Bool):

View

Display Options

  • ViewDisplay Mode (Enumeration):
  • ViewShow In Tree (Bool):
  • ViewVisibility (Bool):

Selection

  • ViewOn Top When Selected (Enumeration):
  • ViewSelection Style (Enumeration):

ExplodedView

An ExplodedView object is derived from an App FeaturePython object and inherits all its properties. It also has the following additional properties:

Data

Exploded View

  • DataMoves (LinkList): List of the Move objects of the exploded view.

ExplodedViewStep

An ExplodedViewStep object is derived from an App FeaturePython object and inherits all its properties. It also has the following additional properties:

Data

Exploded Move

  • DataMove Type (Enumeration): The Type of the move. (Normal, Radial).
  • DataMovement Transform (Placement): This is the movement of the move.
    The end placement is the result of the start placement * this placement.
  • DataObj Names (StringList): The objects moved by the move.
  • DataParts (LinkList): The containing parts of objects moved by the move.