PartDesign MultiTransform: Difference between revisions

From FreeCAD Documentation
m (adjust example wording, include button links with icons)
(Add Usage section with details)
Line 8: Line 8:


==Introduction== <!--T:2-->
==Introduction== <!--T:2-->
'Make a pattern from combinations of transformations' - The {{Button|[[Image:PartDesign_MultiTransform.png|16px|link=PartDesign_MultiTransform]] [[PartDesign_MultiTransform|MultiTransform Feature]]}} 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.
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:
#started by clicking on the {{Button|[[Image:PartDesign_MultiTransform.png|16px|link=PartDesign_MultiTransform]] [[PartDesign_MultiTransform|MultiTransform Feature]]}} icon
#started by clicking on the {{Button|[[Image:PartDesign_MultiTransform.png|16px|link=PartDesign_MultiTransform]] [[PartDesign_MultiTransform|MultiTransform]]}} icon
#selected the hole as the 'feature' (base)
#selected the hole as the 'feature' (base)
#added a linear pattern with two occurrences in the X direction
#added a linear pattern with two occurrences in the X direction
Line 17: Line 17:
[[Image:multitransform_example.png|600px|left|alt="Flange with double row of holes"]]
[[Image:multitransform_example.png|600px|left|alt="Flange with double row of holes"]]
{{clear}}
{{clear}}
{{Caption|Flange with double row of holes. Hole pattern created with 'MultiTransform Feature' tool.}}
{{Caption|Flange with double row of holes. Hole pattern created with 'MultiTransform' tool.}}

==Usage==
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===
This method starts with no existing transformation features and no selections in the viewport or the Model object tree.

# 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. Select your feature(s) to be used for the transformations (multiple are permitted) and click OK to proceed.
# You will see the label(s) of the feature(s) you selected 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'' '''".
# Add a transformation by right-clicking in the '''Transformations''' list view to display the options list.
## Add the desired transformation by selecting it in the options list.
## The new transformation entry will appear in the '''Transformations''' list with corresponding settings appearing below the list.
## Adjust the settings for the new transformation. (''You will see the preview in the viewport.'')
## Click the {{KEY|OK}} button underneath these settings to save the new transformation.
# Continue to add transformations in the order you wish to apply them using Step 5
# You may also edit, delete, and move (change the order of) the transformations as needed by right-clicking an entry in the '''Transformations''' list and selecting the corresponding option.
# 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.<BR>When initiated and completed in this way, the {{Button|[[Image:PartDesign_MultiTransform.png|16px|link=PartDesign_MultiTransform]] [[PartDesign_MultiTransform | MultiTransform]]}} should correctly become the "Tip" of the Body object.

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

# 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.
# In the feature list view, you will see the label(s) of the feature(s) from 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.
When initiated and completed in this way, the {{Button|[[Image:PartDesign_MultiTransform.png|16px|link=PartDesign_MultiTransform]] [[PartDesign_MultiTransform | MultiTransform]]}} usually fails to become the "Tip" of the Body object. To correct this:
# Right click on the newly created {{Button|[[Image:PartDesign_MultiTransform.png|16px|link=PartDesign_MultiTransform]] [[PartDesign_MultiTransform | MultiTransform]]}}.
# Choose "'''Set tip'''".

===Alternate Method 2===
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.

# 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 the {{KEY|OK}} button at top to save and exit.
# In the object tree, select the newly created {{Button|[[Image:PartDesign_MultiTransform.png|16px|link=PartDesign_MultiTransform]] [[PartDesign_MultiTransform| MultiTransform]]}}.
# In the ''Property View'' window, locate the '''Transformations''' property in the ''Data'' tab.
# 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.
# Select all existing feature transformations that should be included. Multiple selections are permitted using CTRL-click.
# Click {{KEY|OK}} to save and close the '''Links''' window.
# Click the {{Button|[[Image:Std_Refresh.png|16px|link=Std_Refresh]] [[Std_Refresh|Refresh]]}} button if activated.
When initiated and completed in this way, the {{Button|[[Image:PartDesign_MultiTransform.png|16px|link=PartDesign_MultiTransform]] [[PartDesign_MultiTransform| MultiTransform]]}} might fail to become the "Tip" of the Body object. If you need it to be the "Tip":
# Right click on the newly created {{Button|[[Image:PartDesign_MultiTransform.png|16px|link=PartDesign_MultiTransform]] [[PartDesign_MultiTransform| MultiTransform]]}}.
# If available, choose "'''Set tip'''".

===Usage Notes===
* 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.

===Limitations=== <!--T:4-->
* 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 [[PartDesign_LinearPattern|linear pattern feature]]
{{clear}}



==Options== <!--T:3-->
==Options== <!--T:3-->
Line 40: Line 98:
{{clear}}
{{clear}}


==Limitations== <!--T:4-->
* 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 [[PartDesign_LinearPattern|linear pattern feature]]
{{clear}}


==Examples== <!--T:5-->
==Examples== <!--T:5-->

Revision as of 21:43, 4 July 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. started by clicking on the MultiTransform icon
  2. selected the hole as the 'feature' (base)
  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"

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.

  1. Click on the MultiTransform icon to initiate the operation.
  2. You will be prompted with the Select feature window. Select your feature(s) to be used for the transformations (multiple are permitted) and click OK to proceed.
  3. You will see the label(s) of the feature(s) you selected 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
  7. You may also edit, delete, and move (change the order of) the transformations as needed by right-clicking an entry 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.
    When initiated and completed in this way, the MultiTransform should correctly become the "Tip" of the Body object.

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.
  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 feature


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.