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 .. image:: images/scale_factor_32x32.png
21 .. image:: 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 .. image:: images/Scale1.png
38 Scale by one common factor property panel
42 - **Main objects** panel contains shapes to be scaled. Shapes are selected in 3D OCC viewer or object browser;
43 - **Center point** defines the point relatively to which the object is scaled. Point is selected in 3D OCC viewer or object browser;
44 - **Scale factor** defines the multiplier of axial dimensions. If Scale Factor is negative, the object is mirrored through the Central Point.
48 .. py:function:: model.addScale(Part_doc, [shape], center, factor)
50 :param part: The current part object.
51 :param list: A list of shapes in format *model.selection(TYPE, shape)*.
52 :param object: A center point in format *model.selection(TYPE, shape)*.
53 :param real: Scale factor.
54 :return: Result object.
59 Result of operation is transformed initial shape shown in wireframe mode together with initial shape in shading mode.
61 .. image:: images/Scale_common_factor.png
65 Scale by one common factor
67 **See Also** a sample TUI Script of :ref:`tui_Scale_common_factor` operation.
69 Scale by different factors along axes
70 -------------------------------------
72 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.
74 .. image:: images/Scale2.png
78 Scale: define by different factors property panel
82 - **Main objects** panel contains shapes to be scaled. Shapes are selected in 3D OCC viewer or object browser;
83 - **Center point** defines the point relatively to which the object is scaled. Point is selected in 3D OCC viewer or object browser;
84 - **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.
88 .. py:function:: model.addScale(Part_doc, [shape], center, factors)
90 :param part: The current part object.
91 :param list: A list of shapes in format *model.selection(TYPE, shape)*.
92 :param object: A center point in format *model.selection(TYPE, shape)*.
93 :param list: A list of three scale factor values along X. Y, Z axes.
94 :return: Result object.
99 Result of operation is transformed initial shape.
101 .. image:: images/Scale_XYZ.png
105 Scale by different factors
107 **See Also** a sample TUI Script of :ref:`tui_Scale_XYZ` operation.