PartDesign MultiTransform/pl

Description
'Make a pattern from combinations of transformations' - The 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 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.



Usage
Before beginning any of the methods below, make sure the necessary object is active; if not, you will receive a pop-up error message stating you need an active  object before using the  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 should correctly become the "Tip" of the Body object.


 * 1) Click on the  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  to proceed.You may add additional features in the next step.
 * [[Image:PartDesign-MultiTransform-Select_feature.png|300px]]
 * 1) 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  and  buttons.
 * [[Image:PartDesign-MultiTransform-General.png|300px]]
 * If you want to include additional features for the transformations, follow these instructions:
 * 1) Click the  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.
 * 1) Click on anything in 3D view (viewport).
 * 2) Click on Tasks tab in Combo View to return to MultiTransform parameters window.
 * 3) 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.
 * [[Image:PartDesign-MultiTransform-Transformations_Right_Click.png|300px]]
 * 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.
 * [[Image:PartDesign-MultiTransform-Transformations-add_linear_pattern.png|300px]]
 * 1) Adjust the settings for the new transformation. (You will see the preview in the viewport.)
 * 2) Click the  button underneath these settings to save the new transformation.
 * 3) Continue to add transformations in the order you wish to apply them using Step 5 above.
 * 4) 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.
 * 5) When you are finished adding and editing the transformations, click the  button at the very top to save the  and exit.

Alternate Method 1
This method starts with one existing transformation feature in the object.


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

Alternate Method 2
This method starts with multiple existing, independent feature transformations in the 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.

When initiated and completed in this way, the might fail to become the "Tip" of the Body object. If you need it to be the "Tip":
 * 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  icon to initiate the operation.
 * 3) Click the  button at top to save and exit.
 * 4) In the object tree, select the newly created.
 * 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  + click.
 * 8) Click  to save and close the Links window.
 * 9) Click the  button if activated.
 * 1) Right click on the newly created.
 * 2) If available, choose "Set tip".

Usage Notes

 * Supported feature transformations are:, , , and SCALED transformation.
 * Each transformation linked to the should use the same feature, or set of features, in each.

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

Options
{| When creating a multitransform feature, the 'multitransform parameters' dialogue offers two different list views.
 * [[Image:Multitransfrom_parameters.png|left]]

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