PartDesign MultiTransform: Difference between revisions

From FreeCAD Documentation
No edit summary
 
(100 intermediate revisions by 12 users not shown)
Line 1: Line 1:
<languages/>
{{GuiCommand|Name=PartDesign_MultiTransform|Workbenches=[[PartDesign Workbench|PartDesign]], Complete|MenuLocation=PartDesign -> MultiTransform}}
<translate>
==Introduction==
'Make a pattern from combinations of transformations' - This tool takes a set of one or more selected features as its input (the 'originals'), and allows to apply several transformations in sequence to them. For example, to produce a flange with a double row of holes, the hole (the 'original') is first patterned in a linear pattern in the X direction, and then patterned eight times in a polar pattern around the Y axis.
[[Image:multitransform_example.png|left]]
{{clear}}
----
==Options==
[[Image:Multitransfrom_parameters.png|left]]
When creating a multitransform feature, the 'multitransform parameters' dialogue offers two different list views.


<!--T:6-->
===Select originals===
{{Docnav
The list view shows the 'originals', the features that are to be patterned. Clicking on any feature will add it to the list.
|[[PartDesign_PolarPattern|Polar Pattern]]
|[[PartDesign_Scaled|Scaled]]
|[[PartDesign_Workbench|PartDesign]]
|IconL=PartDesign_PolarPattern.svg
|IconR=PartDesign_Scaled.svg
|IconC=Workbench_PartDesign.svg
}}


<!--T:1-->
===Select transformations===
{{GuiCommand
This list can be filled with a combination of the simple transformations [[PartDesign_Mirrored|mirrored]], [[PartDesign_LinearPattern|linear pattern]], [[PartDesign_PolarPattern|polar pattern]] and [[PartDesign_Scaled|scaled]]. The transformations will be applied one after the other.
|Name=PartDesign MultiTransform
|MenuLocation=Part Design → Apply a pattern → Create MultiTransform
|Workbenches=[[PartDesign_Workbench|PartDesign]]
|SeeAlso=[[PartDesign_Mirrored|PartDesign Mirrored]], [[PartDesign_LinearPattern|PartDesign LinearPattern]], [[PartDesign_PolarPattern|PartDesign PolarPattern]], [[PartDesign_Scaled|PartDesign Scaled]]
}}


==Description== <!--T:2-->
==Limitations==


<!--T:18-->
* A scaled transformation should not be the first in the list
The [[Image:PartDesign_MultiTransform.svg|24px]] '''PartDesign MultiTransform''' tool creates a pattern of one or more features. The pattern can include multiple transformations where each subsequent transformation is applied to the result of the previous transformation.
* The scaled transformation must have the same number of occurrences as the transformation immediately preceding it in the list
* For further limitations, see the [[PartDesign_LinearPattern|linear pattern feature]]


<!--T:42-->
{{clear}}
The available transformations are: [[Image:PartDesign_Mirrored.svg|16px|link=PartDesign_Mirrored]] [[PartDesign_Mirrored|Mirrored]], [[Image:PartDesign_LinearPattern.svg|16px|link=PartDesign_LinearPattern]] [[PartDesign_LinearPattern|LinearPattern]], [[Image:PartDesign_PolarPattern.svg|16px|link=PartDesign_PolarPattern]] [[PartDesign_PolarPattern|PolarPattern]] and [[Image:PartDesign_Scaled.svg|16px|link=PartDesign_Scaled]] [[PartDesign_Scaled|Scaled]]. The first three are also available as separate tools.


</translate>
==Examples==
[[Image:mt_example2.png|c|center|800px]]
[[Image:multitransform_example.png|600px]]
<translate>
<!--T:20-->
{{Caption|A pattern of holes created from a single Hole feature by applying a LinearPattern with 2 occurences, followed by a PolarPattern with 8 occurrences.}}


==Usage== <!--T:22-->
The smallest pad was first patterned three times in X direction and then scaled to factor two (so the three occurrences have scaling factor 1.0, 1.5 and 2.0). Then a polar pattern was applied with 8 occurrences.


=== Create === <!--T:43-->
[[Image:mt_example3.png|c|center|800px]]


<!--T:44-->
The pocket was first mirrored on the YZ plane and then patterned with two linear patterns to give a rectangular pattern.
# Optionally [[PartDesign_Body#Active_status|activate]] the correct Body.
# Optionally select one or more features in the [[Tree_view|Tree view]] or the [[3D_view|3D view]].
# There are several ways to invoke the tool:
#* Press the {{Button|[[Image:PartDesign_MultiTransform.svg|16px]] [[PartDesign_MultiTransform|Create MultiTransform]]}} button.
#* Select the {{MenuCommand|Part Design → Apply a pattern → [[Image:PartDesign_MultiTransform.svg|16px]] Create MultiTransform}} option from the menu.
# If there is no active Body, and there are two or more Bodies in the document, the {{MenuCommand|Active Body Required}} dialog will open and prompt you to activate one. If there is a single Body it will be activated automatically.
# If no features were selected the {{MenuCommand|Select feature}} [[Task_panel|task panel]] opens: select one or more (hold down the {{KEY|Ctrl}} key) from the list and press the {{Button|OK}} button.
# The {{MenuCommand|MultiTransform parameters}} [[Task_panel|task panel]] opens. See [[#Options|Options]] for more information.
# Press the {{Button|OK}} button at the top to finish.


=== Edit === <!--T:45-->
{{clear}}


<!--T:46-->
{{languages | {{es|PartDesign_MultiTransform/es}} {{fr|PartDesign_MultiTransform/fr}} {{it|PartDesign_MultiTransform/it}} }}
# Do one of the following:
#* Double-click the MultiTransform object in the [[Tree_view|Tree view]].
#* Right-click the MultiTransform object in the [[Tree_view|Tree view]] and select {{MenuCommand|Edit MultiTransform}} from the context menu.
# The {{MenuCommand|MultiTransform parameters}} [[Task_panel|task panel]] opens. See [[#Options|Options]] for more information.
# Press the {{Button|OK}} button at the top to finish.

=== Combine existing transformations === <!--T:47-->

<!--T:48-->
It is possible to create a MultiTransform object from existing [[PartDesign_Mirrored|Mirrored]], [[PartDesign_LinearPattern|LinearPattern]] and [[PartDesign_PolarPattern|PolarPattern]] transformations.

<!--T:49-->
# Check the {{PropertyData|Originals}} property of the existing transformations to make sure they have been applied to the same features.
# Select those features in the [[Tree_view|Tree view]].
# There are several ways to invoke the tool:
#* Press the {{Button|[[Image:PartDesign_MultiTransform.svg|16px]] [[PartDesign_MultiTransform|Create MultiTransform]]}} button.
#* Select the {{MenuCommand|Part Design → Apply a pattern → [[Image:PartDesign_MultiTransform.svg|16px]] Create MultiTransform}} option from the menu.
# The {{MenuCommand|MultiTransform parameters}} [[Task_panel|task panel]] opens.
# Press the {{Button|OK}} button at the top.
# Edit the {{PropertyData|Tranformations}} property of the created MultiTransform object:
## Click in the field.
## Press the {{Button|...}} button that appears.
## The {{MenuCommand|Link}} dialog opens.
## Hold down the {{KEY|Ctrl}} key and select the existing transformations.
## Press the {{Button|OK}} button.
# Optionally [[#Edit|edit]] the MultiTransform object, see above.

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

<!--T:50-->
* To add features:
*# Press the {{Button|Add feature}} button.
*# Select a feature in the [[Tree_view|Tree view]] or the [[3D_view|3D view]].
*# Repeat to add more features.
* To remove features:
*# Press the {{Button|Remove feature}} button.
*# Do one of the following:
*#* Select a feature in the [[Tree_view|Tree view]] or the [[3D_view|3D view]].
*#* Select a feature in the list at the top and press the {{KEY|Del}} key.
*#* Right-click a feature in the list at the top and select {{MenuCommand|Remove}} from the context menu.
*# Repeat to remove more features.
* If there are several features in the pattern, their order can be important. See [[PartDesign_PolarPattern#Ordering_features|PartDesign PolarPattern]].
* To add transformations:
*# If there are existing transformations: select the transformation after which the new transformation should be added.
*# Right-click the {{MenuCommand|Transformations}} list.
*# Select one the following options from the context menu:
*#* {{MenuCommand|Add mirrored transformation}}. See [[PartDesign_Mirrored|PartDesign Mirrored]].
*#* {{MenuCommand|Add linear pattern}}. See [[PartDesign_LinearPattern|PartDesign LinearPattern]].
*#* {{MenuCommand|Add polar pattern}} See [[PartDesign_PolarPattern|PartDesign PolarPattern]].
*#* {{MenuCommand|Add scaled transformation}}. See [[PartDesign_Scaled|PartDesign Scaled]].
*# The selected transformation is added to the list and the settings for the transformation are displayed below the list.
*# Adjust the settings to suit.
*# Press the {{Button|OK}} bar at the bottom.
*# Repeat to add more transformations.
* To edit a transformation:
*# Right-click the transformation in the {{MenuCommand|Transformations}} list.
*# Select {{MenuCommand|Edit}} from the context menu.
*# Adjust the settings to suit.
*# Press the {{Button|OK}} bar at the bottom.
* To change the order of the transformations:
*# Right-click a transformation in the {{MenuCommand|Transformations}} list.
*# Select {{MenuCommand|Move up}} or {{MenuCommand|Move down}} from the context menu.
* If the {{MenuCommand|Update view}} checkbox is checked the view will update in real time.

== Limitations == <!--T:51-->

<!--T:52-->
See [[PartDesign_PolarPattern#Limitations|PartDesign PolarPattern]].

== Example == <!--T:53-->

<!--T:54-->
You can use this tool to create a fully parametric part that is symmetrical about two axes from a sketch.

<!--T:55-->
This could be a 150x100x10mm large mounting plate for a motor with symmetric holes.

</translate>
[[Image:PartDesign_MultiTransform_Example2.png|400px]]
<translate>

<!--T:56-->
# Create a [[Image:PartDesign_Body.svg|16px]] [[PartDesign_Body|Body]] and add a [[Image:PartDesign_NewSketch.svg|16px]] [[PartDesign_NewSketch|sketch]] on one of its base planes.
# In the sketch create geometry for one quadrant of the part (i.e. the upper right quadrant).
#* Note that the constraints must also only cover a quarter of the part, e.g. instead of the full dimension of {{Value|150mm}} enter {{Value|150/2mm}} or {{Value|75mm}}.
#* Make sure the sketch is closed by adding lines along the vertical and horizontal axes.
# Extrude the part with [[Image:PartDesign_Pad.svg|16px]] [[PartDesign_Pad|PartDesign Pad]].
# Select [[Image:PartDesign_MultiTransform.svg|16px]] '''PartDesign MultiTransform'''.
# The task dialog opens.
# The last feature of the Body is already selected. Since we want to mirror that feature we can ignore the {{Button|Add feature}} and {{Button|Remove feature}} buttons.
# Right-click in the {{MenuCommand|Transformations}} field and select {{MenuCommand|Add mirrored transformation}} from the context menu.
# For the {{MenuCommand|Plane}} select {{MenuCommand|Vertical sketch axis}}.
# If the {{MenuCommand|Update view}} checkbox is checked, you should now see the part mirrored about one axis.
# Again select {{MenuCommand|Add mirrored transformation}} from the context menu of the {{MenuCommand|Transformations}} field.
# Now for the {{MenuCommand|Plane}} select {{MenuCommand|Horizontal sketch axis}}.
# Press the {{Button|OK}} button to finish.
# To remove the edges along the axes of symmetry in the final result, set the {{PropertyData|Refine}} property of the new feature to {{Value|true}} in the [[Property_editor|Property editor]].

<!--T:57-->
To verify that the part is fully parametric open the initial sketch with the quarter part and change one dimension, say a hole diameter. After closing the sketch the three other holes will have changed accordingly. This works with all other dimensions as well. A sketch modelling the full part with a single extrusion and no mirroring would be a lot more complex and all later changes would be more complicated.


<!--T:7-->
{{Docnav
|[[PartDesign_PolarPattern|Polar Pattern]]
|[[PartDesign_Scaled|Scaled]]
|[[PartDesign_Workbench|PartDesign]]
|IconL=PartDesign_PolarPattern.svg
|IconR=PartDesign_Scaled.svg
|IconC=Workbench_PartDesign.svg
}}

</translate>
{{PartDesign Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 12:20, 20 January 2024

PartDesign MultiTransform

Menu location
Part Design → Apply a pattern → Create MultiTransform
Workbenches
PartDesign
Default shortcut
None
Introduced in version
-
See also
PartDesign Mirrored, PartDesign LinearPattern, PartDesign PolarPattern, PartDesign Scaled

Description

The PartDesign MultiTransform tool creates a pattern of one or more features. The pattern can include multiple transformations where each subsequent transformation is applied to the result of the previous transformation.

The available transformations are: Mirrored, LinearPattern, PolarPattern and Scaled. The first three are also available as separate tools.

A pattern of holes created from a single Hole feature by applying a LinearPattern with 2 occurences, followed by a PolarPattern with 8 occurrences.

Usage

Create

  1. Optionally activate the correct Body.
  2. Optionally select one or more features in the Tree view or the 3D view.
  3. There are several ways to invoke the tool:
    • Press the Create MultiTransform button.
    • Select the Part Design → Apply a pattern → Create MultiTransform option from the menu.
  4. If there is no active Body, and there are two or more Bodies in the document, the Active Body Required dialog will open and prompt you to activate one. If there is a single Body it will be activated automatically.
  5. If no features were selected the Select feature task panel opens: select one or more (hold down the Ctrl key) from the list and press the OK button.
  6. The MultiTransform parameters task panel opens. See Options for more information.
  7. Press the OK button at the top to finish.

Edit

  1. Do one of the following:
    • Double-click the MultiTransform object in the Tree view.
    • Right-click the MultiTransform object in the Tree view and select Edit MultiTransform from the context menu.
  2. The MultiTransform parameters task panel opens. See Options for more information.
  3. Press the OK button at the top to finish.

Combine existing transformations

It is possible to create a MultiTransform object from existing Mirrored, LinearPattern and PolarPattern transformations.

  1. Check the DataOriginals property of the existing transformations to make sure they have been applied to the same features.
  2. Select those features in the Tree view.
  3. There are several ways to invoke the tool:
    • Press the Create MultiTransform button.
    • Select the Part Design → Apply a pattern → Create MultiTransform option from the menu.
  4. The MultiTransform parameters task panel opens.
  5. Press the OK button at the top.
  6. Edit the DataTranformations property of the created MultiTransform object:
    1. Click in the field.
    2. Press the ... button that appears.
    3. The Link dialog opens.
    4. Hold down the Ctrl key and select the existing transformations.
    5. Press the OK button.
  7. Optionally edit the MultiTransform object, see above.

Options

  • To add features:
    1. Press the Add feature button.
    2. Select a feature in the Tree view or the 3D view.
    3. Repeat to add more features.
  • To remove features:
    1. Press the Remove feature button.
    2. Do one of the following:
      • Select a feature in the Tree view or the 3D view.
      • Select a feature in the list at the top and press the Del key.
      • Right-click a feature in the list at the top and select Remove from the context menu.
    3. Repeat to remove more features.
  • If there are several features in the pattern, their order can be important. See PartDesign PolarPattern.
  • To add transformations:
    1. If there are existing transformations: select the transformation after which the new transformation should be added.
    2. Right-click the Transformations list.
    3. Select one the following options from the context menu:
    4. The selected transformation is added to the list and the settings for the transformation are displayed below the list.
    5. Adjust the settings to suit.
    6. Press the OK bar at the bottom.
    7. Repeat to add more transformations.
  • To edit a transformation:
    1. Right-click the transformation in the Transformations list.
    2. Select Edit from the context menu.
    3. Adjust the settings to suit.
    4. Press the OK bar at the bottom.
  • To change the order of the transformations:
    1. Right-click a transformation in the Transformations list.
    2. Select Move up or Move down from the context menu.
  • If the Update view checkbox is checked the view will update in real time.

Limitations

See PartDesign PolarPattern.

Example

You can use this tool to create a fully parametric part that is symmetrical about two axes from a sketch.

This could be a 150x100x10mm large mounting plate for a motor with symmetric holes.

  1. Create a Body and add a sketch on one of its base planes.
  2. In the sketch create geometry for one quadrant of the part (i.e. the upper right quadrant).
    • Note that the constraints must also only cover a quarter of the part, e.g. instead of the full dimension of 150mm enter 150/2mm or 75mm.
    • Make sure the sketch is closed by adding lines along the vertical and horizontal axes.
  3. Extrude the part with PartDesign Pad.
  4. Select PartDesign MultiTransform.
  5. The task dialog opens.
  6. The last feature of the Body is already selected. Since we want to mirror that feature we can ignore the Add feature and Remove feature buttons.
  7. Right-click in the Transformations field and select Add mirrored transformation from the context menu.
  8. For the Plane select Vertical sketch axis.
  9. If the Update view checkbox is checked, you should now see the part mirrored about one axis.
  10. Again select Add mirrored transformation from the context menu of the Transformations field.
  11. Now for the Plane select Horizontal sketch axis.
  12. Press the OK button to finish.
  13. To remove the edges along the axes of symmetry in the final result, set the DataRefine property of the new feature to true in the Property editor.

To verify that the part is fully parametric open the initial sketch with the quarter part and change one dimension, say a hole diameter. After closing the sketch the three other holes will have changed accordingly. This works with all other dimensions as well. A sketch modelling the full part with a single extrusion and no mirroring would be a lot more complex and all later changes would be more complicated.