PartDesign MultiTransform: Difference between revisions

From FreeCAD Documentation
(→‎Standard Method: Adjust wording, add instructions for adding additional features to the MultiTransform, and adjust image formatting)
(Remove {{clear}} template)
(8 intermediate revisions by 3 users not shown)
Line 8: Line 8:


==Introduction== <!--T:2-->
==Introduction== <!--T:2-->

<!--T:18-->
'Make a pattern from combinations of transformations' - The {{Button|[[Image:PartDesign_MultiTransform.png|16px|link=PartDesign_MultiTransform]] [[PartDesign_MultiTransform|MultiTransform]]}} tool takes one (or a set of) part 'features' as its input, and allows the user to apply multiple transformations to that feature (or set of features) progressively, in sequence - creating a combined or compound transformation.
'Make a pattern from combinations of transformations' - The {{Button|[[Image:PartDesign_MultiTransform.png|16px|link=PartDesign_MultiTransform]] [[PartDesign_MultiTransform|MultiTransform]]}} tool takes one (or a set of) part 'features' as its input, and allows the user to apply multiple transformations to that feature (or set of features) progressively, in sequence - creating a combined or compound transformation.

<!--T:21-->
For example, to produce the flange with a double row of holes as pictured below, the user:
For example, to produce the flange with a double row of holes as pictured below, the user:
#selected the hole as the 'feature' (base) in the Model tree
#selected the hole as the 'feature' (base) in the Model tree
Line 15: Line 19:
#added a linear pattern with two occurrences in the X direction
#added a linear pattern with two occurrences in the X direction
#added a polar pattern with eight occurrences around the Y axis.
#added a polar pattern with eight occurrences around the Y axis.

[[Image:multitransform_example.png|600px|left|alt="Flange with double row of holes"]]
</translate>
{{clear}}
[[Image:multitransform_example.png|600px]]
<translate>
<!--T:20-->
{{Caption|Flange with double row of holes. Hole pattern created with 'MultiTransform' tool.}}
{{Caption|Flange with double row of holes. Hole pattern created with 'MultiTransform' tool.}}


==Usage==
==Usage== <!--T:10-->
Before beginning any of the methods below, make sure the necessary {{Button|[[Image:PartDesign Body.png|16px|link=PartDesign_Body]] [[PartDesign_Body|Body]]}} object is [[PartDesign_Body#Usage_Notes|active]]; if not, you will receive a pop-up error message stating you need an active {{Button|[[Image:PartDesign Body.png|16px|link=PartDesign_Body]] [[PartDesign_Body|Body]]}} object before using the {{Button|[[Image:PartDesign_MultiTransform.png|16px|link=PartDesign_MultiTransform]] [[PartDesign_MultiTransform| MultiTransform]]}} tool.
Before beginning any of the methods below, make sure the necessary {{Button|[[Image:PartDesign Body.png|16px|link=PartDesign_Body]] [[PartDesign_Body|Body]]}} object is [[PartDesign_Body#Usage_Notes|active]]; if not, you will receive a pop-up error message stating you need an active {{Button|[[Image:PartDesign Body.png|16px|link=PartDesign_Body]] [[PartDesign_Body|Body]]}} object before using the {{Button|[[Image:PartDesign_MultiTransform.png|16px|link=PartDesign_MultiTransform]] [[PartDesign_MultiTransform| MultiTransform]]}} tool.


===Standard Method===
===Standard Method=== <!--T:11-->
This method starts with no existing transformation features and no selections in the viewport or the Model object tree.<BR>When initiated and completed with this method, the {{Button|[[Image:PartDesign_MultiTransform.png|16px|link=PartDesign_MultiTransform]] [[PartDesign_MultiTransform | MultiTransform]]}} should correctly become the "Tip" of the Body object.
This method starts with no existing transformation features and no selections in the viewport or the Model object tree.<BR>When initiated and completed with this method, the {{Button|[[Image:PartDesign_MultiTransform.png|16px|link=PartDesign_MultiTransform]] [[PartDesign_MultiTransform | MultiTransform]]}} should correctly become the "Tip" of the Body object.


<!--T:12-->
# Click on the {{Button|[[Image:PartDesign_MultiTransform.png|16px|link=PartDesign_MultiTransform]] [[PartDesign_MultiTransform| MultiTransform]]}} icon to initiate the operation.
# Click on the {{Button|[[Image:PartDesign_MultiTransform.png|16px|link=PartDesign_MultiTransform]] [[PartDesign_MultiTransform| MultiTransform]]}} icon to initiate the operation.
# You will be prompted with the '''Select feature''' window.<BR>From the list, select one initial feature to be used for the transformations and click OK to proceed.<BR>You may add additional features in the next step.[[Image:PartDesign-MultiTransform-Select_feature.png|center|300px]]
# You will be prompted with the '''Select feature''' window.<BR>From the list, select one initial feature to be used for the transformations and click OK to proceed.<BR>You may add additional features in the next step.[[Image:PartDesign-MultiTransform-Select_feature.png|center|300px]]
# The '''Transformed features messages''' and '''MultiTransform parameters''' window will appear.<BR>You will see the label of the feature you selected in the feature list view, below the {{Button|Add feature}} and {{Button|Remove feature}} buttons.[[Image:PartDesign-MultiTransform-General.png|center|300px]]<BR>If you want to include additional features for the transformations, follow these instructions:
# The '''Transformed features messages''' and '''MultiTransform parameters''' window will appear.<BR>You will see the label of the feature you selected in the feature list view, below the {{Button|Add feature}} and {{Button|Remove feature}} buttons.[[Image:PartDesign-MultiTransform-General.png|center|300px]]<BR>If you want to include additional features for the transformations, follow these instructions:
## Click the {{Button|Add feature}} button in the transform tool
## Click the {{Button|Add feature}} button in the transform tool
## Switch to the Model tree view
## Switch to the Model tree view (Click on '''Model''' tab)
## Select the feature you want to add, and make it visible(spacebar, '''''or''''' right-click and toggle visibility).<BR>'''Note:''' This will hide the previously visible feature.
## Select the feature you want to add, and make it visible(spacebar, '''''or''''' right-click and toggle visibility).<BR>'''Note:''' This will hide the previously visible feature.
## Click on anything in 3D view (viewport).
## Click on anything in 3D view (viewport).
## Click on '''Tasks''' tab in Combo View to return to '''MultiTransform parameters''' window.
## You should see the label of the recently selected feature appear in the feature list view.
## You should see the label of the recently selected feature appear in the feature list view.
# Below the feature list view is the '''Transformations''' list view. Within you should see the text, "''' ''Right-click to add'' '''".
# Below the feature list view is the '''Transformations''' list view. Within you should see the text, "''' ''Right-click to add'' '''".
Line 43: Line 52:
# When you are finished adding and editing the transformations, click the {{KEY|OK}} button at the very top to save the {{Button|[[Image:PartDesign_MultiTransform.png|16px|link=PartDesign_MultiTransform]] [[PartDesign_MultiTransform | MultiTransform]]}} and exit.
# When you are finished adding and editing the transformations, click the {{KEY|OK}} button at the very top to save the {{Button|[[Image:PartDesign_MultiTransform.png|16px|link=PartDesign_MultiTransform]] [[PartDesign_MultiTransform | MultiTransform]]}} and exit.


===Alternate Method 1===
===Alternate Method 1=== <!--T:13-->
This method starts with one existing transformation feature in the {{Button|[[Image:PartDesign Body.png|16px|link=PartDesign_Body]] [[PartDesign_Body|Body]]}} object.
This method starts with one existing transformation feature in the {{Button|[[Image:PartDesign Body.png|16px|link=PartDesign_Body]] [[PartDesign_Body|Body]]}} object.


<!--T:14-->
# In the Model tree, within the active Body object, select the existing transformation to be included.
# In the Model tree, within the active Body object, select the existing transformation to be included.
# Click on the {{Button|[[Image:PartDesign_MultiTransform.png|16px|link=PartDesign_MultiTransform]] [[PartDesign_MultiTransform| MultiTransform]]}} icon to initiate the operation.
# Click on the {{Button|[[Image:PartDesign_MultiTransform.png|16px|link=PartDesign_MultiTransform]] [[PartDesign_MultiTransform| MultiTransform]]}} icon to initiate the operation.
# In the feature list view, you will see the label(s) of the feature(s) from the existing transformation you included.
# In the feature list view, you will see the label(s) of the feature(s) from the existing transformation you included.<BR>To add additional features, see '''Step 3''' in the [[PartDesign_MultiTransform#Standard_Method|Standard Method]] above.
# Below the feature list view is the '''Transformations''' list view. Within you should see the label for the existing transformation you included.
# Below the feature list view is the '''Transformations''' list view. Within you should see the label for the existing transformation you included.
# Finish using '''Steps 5-8''' in the [[PartDesign_MultiTransform#Standard_Method|Standard Method]] above.
# Finish using '''Steps 5-8''' in the [[PartDesign_MultiTransform#Standard_Method|Standard Method]] above.
Line 55: Line 65:
# Choose "'''Set tip'''".
# Choose "'''Set tip'''".


===Alternate Method 2===
===Alternate Method 2=== <!--T:15-->
This method starts with multiple existing, independent feature transformations in the {{Button|[[Image:PartDesign Body.png|16px|link=PartDesign_Body]] [[PartDesign_Body|Body]]}} object - with the idea of combining them. '''NOTE:''' to combine existing transformations, they must be within the same Body object and should all use the same feature or feature set in each.
This method starts with multiple existing, independent feature transformations in the {{Button|[[Image:PartDesign Body.png|16px|link=PartDesign_Body]] [[PartDesign_Body|Body]]}} object - with the idea of combining them. '''NOTE:''' to combine existing transformations, they must be within the same Body object and should all use the same feature or feature set in each.


<!--T:16-->
# In the Model tree, within the active Body object, select one of existing transformation of those you wish to include.
# In the Model tree, within the active Body object, select one of existing transformation of those you wish to include.
# Click on the {{Button|[[Image:PartDesign_MultiTransform.png|16px|link=PartDesign_MultiTransform]] [[PartDesign_MultiTransform| MultiTransform]]}} icon to initiate the operation.
# Click on the {{Button|[[Image:PartDesign_MultiTransform.png|16px|link=PartDesign_MultiTransform]] [[PartDesign_MultiTransform| MultiTransform]]}} icon to initiate the operation.
Line 71: Line 82:
# If available, choose "'''Set tip'''".
# If available, choose "'''Set tip'''".


===Usage Notes===
===Usage Notes=== <!--T:17-->
* Supported feature transformations are: {{Button|[[Image:PartDesign_Mirrored.png|20px]] [[PartDesign_Mirrored|Mirrored]]}}, {{Button|[[Image:PartDesign_LinearPattern.png|20px]] [[PartDesign_LinearPattern|Linear Pattern]]}}, {{Button|[[Image:PartDesign_PolarPattern.png|20px]] [[PartDesign_PolarPattern|Polar Pattern]]}}, and SCALED transformation.
* Supported feature transformations are: {{Button|[[Image:PartDesign_Mirrored.png|20px]] [[PartDesign_Mirrored|Mirrored]]}}, {{Button|[[Image:PartDesign_LinearPattern.png|20px]] [[PartDesign_LinearPattern|Linear Pattern]]}}, {{Button|[[Image:PartDesign_PolarPattern.png|20px]] [[PartDesign_PolarPattern|Polar Pattern]]}}, and SCALED transformation.
* Each transformation linked to the {{Button|[[Image:PartDesign_MultiTransform.png|16px|link=PartDesign_MultiTransform]] [[PartDesign_MultiTransform| MultiTransform]]}} should use the same feature, or set of features, in each.
* Each transformation linked to the {{Button|[[Image:PartDesign_MultiTransform.png|16px|link=PartDesign_MultiTransform]] [[PartDesign_MultiTransform| MultiTransform]]}} should use the same feature, or set of features, in each.
Line 78: Line 89:
* A scaled transformation should not be the first in the list
* A scaled transformation should not be the first in the list
* The scaled transformation must have the same number of occurrences as the transformation immediately preceding it in the list
* 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]]
* For further limitations, see the {{Button|[[Image:PartDesign_LinearPattern.png|20px]] [[PartDesign_LinearPattern|Linear Pattern]]}}
{{clear}}
{{clear}}



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

Revision as of 07:02, 12 December 2019

PartDesign MultiTransform

Menu location
PartDesign → MultiTransform
Workbenches
PartDesign
Default shortcut
None
Introduced in version
-
See also
None

Introduction

'Make a pattern from combinations of transformations' - The MultiTransform tool takes one (or a set of) part 'features' as its input, and allows the user to apply multiple transformations to that feature (or set of features) progressively, in sequence - creating a combined or compound transformation.


For example, to produce the flange with a double row of holes as pictured below, the user:

  1. selected the hole as the 'feature' (base) in the Model tree
  2. clicked on the MultiTransform icon
  3. added a linear pattern with two occurrences in the X direction
  4. added a polar pattern with eight occurrences around the Y axis.

Flange with double row of holes. Hole pattern created with 'MultiTransform' tool.

Usage

Before beginning any of the methods below, make sure the necessary Body object is active; if not, you will receive a pop-up error message stating you need an active Body object before using the MultiTransform tool.

Standard Method

This method starts with no existing transformation features and no selections in the viewport or the Model object tree.
When initiated and completed with this method, the MultiTransform should correctly become the "Tip" of the Body object.

  1. Click on the MultiTransform icon to initiate the operation.
  2. You will be prompted with the Select feature window.
    From the list, select one initial feature to be used for the transformations and click OK to proceed.
    You may add additional features in the next step.
  3. The Transformed features messages and MultiTransform parameters window will appear.
    You will see the label of the feature you selected in the feature list view, below the Add feature and Remove feature buttons.

    If you want to include additional features for the transformations, follow these instructions:
    1. Click the Add feature button in the transform tool
    2. Switch to the Model tree view (Click on Model tab)
    3. Select the feature you want to add, and make it visible(spacebar, or right-click and toggle visibility).
      Note: This will hide the previously visible feature.
    4. Click on anything in 3D view (viewport).
    5. Click on Tasks tab in Combo View to return to MultiTransform parameters window.
    6. You should see the label of the recently selected feature appear in the feature list view.
  4. Below the feature list view is the Transformations list view. Within you should see the text, " Right-click to add ".
  5. Add a transformation by right-clicking in the Transformations list view to display the options list.
    1. Add the desired transformation by selecting it in the options list.
    2. The new transformation entry will appear in the Transformations list with corresponding settings appearing below the list.
    3. Adjust the settings for the new transformation. (You will see the preview in the viewport.)
    4. Click the OK button underneath these settings to save the new transformation.
  6. Continue to add transformations in the order you wish to apply them using Step 5 above.
  7. You may also edit, delete, and move (change the order of) the transformations as needed by right-clicking on a transformation in the Transformations list and selecting the corresponding option.
  8. When you are finished adding and editing the transformations, click the OK button at the very top to save the MultiTransform and exit.

Alternate Method 1

This method starts with one existing transformation feature in the Body object.

  1. In the Model tree, within the active Body object, select the existing transformation to be included.
  2. Click on the MultiTransform icon to initiate the operation.
  3. In the feature list view, you will see the label(s) of the feature(s) from the existing transformation you included.
    To add additional features, see Step 3 in the Standard Method above.
  4. Below the feature list view is the Transformations list view. Within you should see the label for the existing transformation you included.
  5. Finish using Steps 5-8 in the Standard Method above.

When initiated and completed in this way, the MultiTransform usually fails to become the "Tip" of the Body object. To correct this:

  1. Right click on the newly created MultiTransform.
  2. Choose "Set tip".

Alternate Method 2

This method starts with multiple existing, independent feature transformations in the Body object - with the idea of combining them. NOTE: to combine existing transformations, they must be within the same Body object and should all use the same feature or feature set in each.

  1. In the Model tree, within the active Body object, select one of existing transformation of those you wish to include.
  2. Click on the MultiTransform icon to initiate the operation.
  3. Click the OK button at top to save and exit.
  4. In the object tree, select the newly created MultiTransform.
  5. In the Property View window, locate the Transformations property in the Data tab.
  6. Edit the Transformations property by clicking on its value, then click on the ellipse box that appeared to open the Links window for this property.
  7. Select all existing feature transformations that should be included. Multiple selections are permitted using CTRL-click.
  8. Click OK to save and close the Links window.
  9. Click the Refresh button if activated.

When initiated and completed in this way, the MultiTransform might fail to become the "Tip" of the Body object. If you need it to be the "Tip":

  1. Right click on the newly created MultiTransform.
  2. If available, choose "Set tip".

Usage Notes

Limitations

  • A scaled transformation should not be the first in the list
  • The scaled transformation must have the same number of occurrences as the transformation immediately preceding it in the list
  • For further limitations, see the Linear Pattern

Options

When creating a multitransform feature, the 'multitransform parameters' dialogue offers two different list views.

Select originals

The list view shows the 'originals', the features that are to be patterned. Clicking on any feature will add it to the list.

Select transformations

This list can be filled with a combination of the simple transformations mirrored, linear pattern, polar pattern and scaled. The transformations will be applied one after the other. The context menu offers the following entries:

Edit

Allows editing the parameters of a transformation in the list (double-clicking will have the same effect)

Delete

Removes a transformation from the list

Add transformation

Adds a transformation to the list

Move Up/Down

Allows changing the order of transformations in the list


Examples

c
c

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.

c
c

The pocket was first mirrored on the YZ plane and then patterned with two linear patterns to give a rectangular pattern.