1 .. |scale.icon| image:: images/scale.png
6 **Scale** feature makes a scaled shape basing on the initial shape.
8 To create a Scale in the active part:
10 #. select in the Main Menu *Features - > Scale* item or
11 #. click |scale.icon| **Scale** button in the toolbar
13 Two Scale algorithms are:
15 .. figure:: images/scale_factor_32x32.png
21 .. figure:: images/scale_dimensions_32x32.png
25 by different factors along axes
27 --------------------------------------------------------------------------------
29 Scale by one common factor
30 --------------------------
32 Scale by one common factor scales the entire object without modification the geometry of the shape: dimensions change evenly in all three orthogonal directions.
34 .. figure:: images/Scale1.png
37 Scale by one common factor property panel
41 - **Main objects** panel contains shapes to be scaled. Shapes are selected in 3D OCC viewer or object browser; :ref:`transformation_subshapes`
42 - **Center point** defines the point relatively to which the object is scaled. Point is selected in 3D OCC viewer or object browser;
43 - **Scale factor** defines the multiplier of axial dimensions. If Scale Factor is negative, the object is mirrored through the Central Point.
47 .. py:function:: model.addScale(Part_doc, [shape], center, factor)
49 :param part: The current part object.
50 :param list: A list of shapes in format *model.selection(TYPE, shape)*.
51 :param object: A center point in format *model.selection(TYPE, shape)*.
52 :param real: Scale factor.
53 :return: Result object.
58 Result of operation is transformed initial shape shown in wireframe mode together with initial shape in shading mode.
60 .. figure:: images/Scale_common_factor.png
63 Scale by one common factor
65 **See Also** a sample TUI Script of :ref:`tui_Scale_common_factor` operation.
67 Scale by different factors along axes
68 -------------------------------------
70 Scale by different factors along axes is a general transformation, which can modify the geometry, for example, a sphere can be transformed into an ellipsoid.
72 .. figure:: images/Scale2.png
75 Scale: define by different factors property panel
79 - **Main objects** panel contains shapes to be scaled. Shapes are selected in 3D OCC viewer or object browser; :ref:`transformation_subshapes`
80 - **Center point** defines the point relatively to which the object is scaled. Point is selected in 3D OCC viewer or object browser;
81 - **Scale factor in X**, **Scale factor in Y**, **Scale factor in Z** define the the multipliers of axial dimensions. If Scale Factor is negative, the object is mirrored through the Central Point.
85 .. py:function:: model.addScale(Part_doc, [shape], center, factors)
87 :param part: The current part object.
88 :param list: A list of shapes in format *model.selection(TYPE, shape)*.
89 :param object: A center point in format *model.selection(TYPE, shape)*.
90 :param list: A list of three scale factor values along X. Y, Z axes.
91 :return: Result object.
96 Result of operation is transformed initial shape.
98 .. figure:: images/Scale_XYZ.png
101 Scale by different factors
103 **See Also** a sample TUI Script of :ref:`tui_Scale_XYZ` operation.