From: dbv Date: Wed, 3 Oct 2018 17:08:36 +0000 (+0300) Subject: Documentation X-Git-Tag: CEA_2018-2~17 X-Git-Url: http://git.salome-platform.org/gitweb/?a=commitdiff_plain;h=01bc2d6f9172471abe07e932c2f4b613a4bfe73f;p=modules%2Fshaper.git Documentation --- diff --git a/src/FeaturesPlugin/doc/TUI_extrusionFeature.rst b/src/FeaturesPlugin/doc/TUI_extrusionFeature.rst new file mode 100644 index 000000000..633cf7374 --- /dev/null +++ b/src/FeaturesPlugin/doc/TUI_extrusionFeature.rst @@ -0,0 +1,12 @@ + + .. tui_create_extrusion: + +Create Extrusion by sizes +========================= + +.. literalinclude:: examples/extrusion.py + :linenos: + :language: python + +:download:`Download this script ` + diff --git a/src/FeaturesPlugin/doc/commonFeature.rst b/src/FeaturesPlugin/doc/commonFeature.rst index e6a7dc763..0ea5c0dbe 100644 --- a/src/FeaturesPlugin/doc/commonFeature.rst +++ b/src/FeaturesPlugin/doc/commonFeature.rst @@ -1,36 +1,46 @@ -.. _featureCommon: - Common ====== The feature Common implements a boolean operation for extraction of a common part from a set of selected shapes. -To perform a boolean opration Common in the active part: +To perform a boolean operation Common in the active part: #. select in the Main Menu *Features - > Common* item or #. click **Common** button in the toolbar -.. image:: images/common_btn.png +.. image:: images/bool_common.png :align: center .. centered:: **Common** button -The following property panel will be opened: - -.. image:: images/Common.png - :align: center +There are 2 options for creation of a Common: + +.. image:: images/bool_common_simple.png + :align: left +**Simple** common part between all selected objects. + +.. image:: images/bool_common_advanced.png + :align: left +**Advanced** common part for each object between this object and all tools. + + +Simple +------ + +.. image:: images/boolean_common_simple_property_panel.png + :align: center .. centered:: - **Common operation** + **Simple** -- **Main Objects** contains a list of objects selected in the Object Browser or in the Viewer, which will be common with tool objects. -- **Tool Objects** contains a list of objects selected in the Object Browser or in the Viewer, which will be common with main objects. +- **Objects** contains a list of objects selected in the Object Browser or in the Viewer. + In case if subshape from compsolid/compound was selected then other shapes from this compsolid/compound will be ignored. - **See preview** button shows a result of the operation. -**TUI Command**: *model.addCommon(Part_doc, mainObjects, toolObjects)* +**TUI Command**: *model.addCommon(Part_doc, objects)* -**Arguments**: Part + list of main objects + list of tool objects. +**Arguments**: Part + list of objects. Result """""" @@ -44,3 +54,36 @@ The Result of the operation will be a shape which is a common for all selected s **Common created** **See Also** a sample TUI Script of a :ref:`tui_create_common` operation. + +Advanced +-------- + +.. image:: images/boolean_common_advanced_property_panel.png + :align: center + +.. centered:: + **Advanced** + +- **Objects** contains a list of objects selected in the Object Browser or in the Viewer. + In case if subshape from compsolid/compound was selected then other shapes from this compsolid/compound will be cut from + other objects (to avoid self intersection) and added to the result. +- **Tools** contains a list of objects selected in the Object Browser or in the Viewer, which will be fused with tool objects. + In case if subshape from compsolid/compound was selected then other shapes from this compsolid/compound will be ignored. +- **See preview** button shows a result of the operation. + +**TUI Command**: *model.addCommon(Part_doc, objects, tools)* + +**Arguments**: Part + list of objects + list of tools. + +Result +"""""" + +For each selected object result will be produced, which are common part between this object and all tools: + +.. image:: images/boolean_common_result.png + :align: center + +.. centered:: + **Common created** + +**See Also** a sample TUI Script of a :ref:`tui_create_common` operation. diff --git a/src/FeaturesPlugin/doc/cutFeature.rst b/src/FeaturesPlugin/doc/cutFeature.rst index e5c8bae88..bdf635e22 100644 --- a/src/FeaturesPlugin/doc/cutFeature.rst +++ b/src/FeaturesPlugin/doc/cutFeature.rst @@ -5,7 +5,7 @@ Cut The feature Cut implements a boolean operation to cut tool objects from a main objects. -To perform a boolean opration Cut in the active part: +To perform a boolean operation Cut in the active part: #. select in the Main Menu *Features - > Cut* item or #. click **Cut** button in the toolbar @@ -18,15 +18,19 @@ To perform a boolean opration Cut in the active part: The following property panel will be opened: -.. image:: images/Cut.png +.. image:: images/boolean_cut_property_panel.png :align: center .. centered:: **Cut operation** - **Main Objects** contains a list of objects selected in the Object Browser or in the Viewer, which will be cut by tool objects. -- **Tool Objects** contains a list of objects selected in the Object Browser or in the Viewer, which will be cut main objects. -- **See preview** button shows a result of the operation. + Any kind of shape can be selected. Also allows selection of compsolids/compound subshapes. + In this case only selected subshapes will be cut, other will stay untoched (as much as possible). +- **Tool Objects** contains a list of objects selected in the Object Browser or in the Viewer, which will be cut main objects. + Any kind of shape can be selected. Also allows selection of compsolids/compounds subshapes. + Non-selected subshapes from compsolids/compounds will be ignored. +- **See preview** button shows a result of the operation. **TUI Command**: *model.addCut(Part_doc, mainObjects, toolObjects)* @@ -35,12 +39,29 @@ The following property panel will be opened: Result """""" -The Result of the operation will be a shape which is a cut of tool objects from main objects: +For each selected object will be produced a result shape which is a cut of tool objects from main object: .. image:: images/CreatedCut.png - :align: center + :align: center .. centered:: **Cut created** +In case if subsolid (yellow wireframe) of compsolid was selected: + +.. image:: images/boolean_cut_subsolids_arguments.png + :align: center + +.. centered:: + **Cut arguments** + +then it will be cut in result and not selected subsolids will be added to it: + +.. image:: images/boolean_cut_subsolids_result.png + :align: center + +.. centered:: + **Cut subsolid result** + + **See Also** a sample TUI Script of a :ref:`tui_create_cut` operation. diff --git a/src/FeaturesPlugin/doc/examples/extrusion_by_sizes.py b/src/FeaturesPlugin/doc/examples/extrusion_by_sizes.py new file mode 100644 index 000000000..56f329f7a --- /dev/null +++ b/src/FeaturesPlugin/doc/examples/extrusion_by_sizes.py @@ -0,0 +1,17 @@ +# -*- coding: utf-8 -*- + +from salome.shaper import model + +model.begin() +partSet = model.moduleDocument() +Part_1 = model.addPart(partSet) +Part_1_doc = Part_1.document() +Sketch_1 = model.addSketch(Part_1_doc, model.standardPlane("XOY")) +SketchProjection_1 = Sketch_1.addProjection(model.selection("VERTEX", "PartSet/Origin"), False) +SketchPoint_1 = SketchProjection_1.createdFeature() +SketchCircle_1 = Sketch_1.addCircle(0, 0, 27.26724996788554) +SketchConstraintCoincidence_1 = Sketch_1.setCoincident(SketchPoint_1.result(), SketchCircle_1.center()) +model.do() +Extrusion_1 = model.addExtrusion(Part_1_doc, [model.selection("FACE", "Sketch_1/Face-SketchCircle_1_2f")], model.selection(), 50, 0) +model.do() +model.end() diff --git a/src/FeaturesPlugin/doc/extrusionFeature.rst b/src/FeaturesPlugin/doc/extrusionFeature.rst index 3fdf196be..d1b85f14c 100644 --- a/src/FeaturesPlugin/doc/extrusionFeature.rst +++ b/src/FeaturesPlugin/doc/extrusionFeature.rst @@ -3,6 +3,20 @@ Extrusion ========= +Extrusion feature extrudes selected objects along their normals or selected axis. + +To perform Extrusion in the active part: + +#. select in the Main Menu *Features - > Extrusion* item or +#. click **Extrusion** button in the toolbar + +.. image:: images/extrusion_btn.png + :align: center + +.. centered:: + **Extrusion** button + +The following property panel will be opened: .. image:: images/StartSketch.png :align: center @@ -10,6 +24,19 @@ Extrusion .. centered:: Start sketch +After selecting one of the options property panel for Extrusion will be opened with two variants: + +.. image:: images/extrusion_by_sizes.png + :align: left +**By Sizes** extrudes objects by specifying sizes. + +.. image:: images/extrusion_by_bounding_planes.png + :align: left +**By Bounding Planes** extrudes objects by specifying bounding planes and offsets. + + +Simple +------ .. image:: images/Extrusion1.png :align: center @@ -17,6 +44,42 @@ Extrusion .. centered:: Extrusion: definition by sizes +- **Base objects** contains a list of objects selected in the Object Browser or in the Viewer, which will be extruded. +- **Axis** if selected then it will be direction of extrusion, otherwise objects normals will be used. +- **To size** size for extrusion along direction. +- **From size** size for extrusion in opposite direction. + +**TUI Command**: *model.addExtrusion(part, objects, size);* + +**Arguments**: Part + list of objects + size. + +**TUI Command**: *model.addExtrusion(part, objects, direction, size);* + +**Arguments**: Part + list of objects + direction + size. + +**TUI Command**: *model.addExtrusion(part, objects, toSize, fromSize);* + +**Arguments**: Part + list of objects + to size + from size. + +**TUI Command**: *model.addExtrusion(part, objects, direction, toSize, fromSize);* + +**Arguments**: Part + list of objects + direction + to size + from size. + +Result +"""""" + +The Result of the operation will be an extruded shape: + +.. image:: images/extrusion_result.png + :align: center + +.. centered:: + **Extrusion created** + +**See Also** a sample TUI Script of a :ref:`tui_create_extrusion` operation. + + + .. image:: images/Extrusion2.png :align: center diff --git a/src/FeaturesPlugin/doc/fuseFeature.rst b/src/FeaturesPlugin/doc/fuseFeature.rst index c04c1ea8a..4f3d19bd7 100644 --- a/src/FeaturesPlugin/doc/fuseFeature.rst +++ b/src/FeaturesPlugin/doc/fuseFeature.rst @@ -2,9 +2,9 @@ Fuse ==== -The feature Fuse implements a boolean operation for fision of a set of main objects with a set of tool objects. +The feature Fuse implements a boolean operation for fusion of a set of main objects with a set of tool objects. -To perform a boolean opration Fuse in the active part: +To perform a boolean operation Fuse in the active part: #. select in the Main Menu *Features - > Fuse* item or #. click **Fuse** button in the toolbar @@ -15,26 +15,39 @@ To perform a boolean opration Fuse in the active part: .. centered:: **Fuse** button -The following property panel will be opened: +There are 2 options for creation of a Fuse: -.. image:: images/Fuse.png - :align: center +.. image:: images/bool_fuse_simple.png + :align: left +**Simple** simply fuses selected objects. + +.. image:: images/bool_fuse_advanced.png + :align: left +**Advanced** fuse with additional functionality for subshapes of compsolids/compounds. + + +Simple +------ + +.. image:: images/boolean_fuse_simple_property_panel.png + :align: center .. centered:: - **Fuse operation** + **Simple** -- **Main Objects** contains a list of objects selected in the Object Browser or in the Viewer, which will be fused with tool objects. -- **Tool Objects** contains a list of objects selected in the Object Browser or in the Viewer, which will fused with main objects. +- **Objects** contains a list of objects selected in the Object Browser or in the Viewer, which will be fused with tool objects. + In case if subshape from compsolid/compound was selected then other shapes from this compsolid/compound will be ignored. +- **Remove intersection edges** if enabled edges that lie on the same surface will be removed. - **See preview** button shows a result of the operation. -**TUI Command**: *model.addFuse(Part_doc, mainObjects, toolObjects)* +**TUI Command**: *model.addFuse(Part_doc, objects, isRemoveEdges)* -**Arguments**: Part + list of main objects + list of tool objects. +**Arguments**: Part + list of objects + remove edges flag (optional). Result """""" -The Result of the operation will be a shape which is a fuse of tool objects with main objects: +The Result of the operation will be a single shape which is a fuse of selected objects: .. image:: images/CreatedFuse.png :align: center @@ -43,3 +56,37 @@ The Result of the operation will be a shape which is a fuse of tool objects with **Fuse created** **See Also** a sample TUI Script of a :ref:`tui_create_fuse` operation. + +Advanced +-------- + +.. image:: images/boolean_fuse_advanced_property_panel.png + :align: center + +.. centered:: + **Advanced** + +- **Objects** contains a list of objects selected in the Object Browser or in the Viewer, which will be fused with tool objects. + In case if subshape from compsolid/compound was selected then other shapes from this compsolid/compound will be cut from + other objects (to avoid self intersection) and added to the result. +- **Tools** contains a list of objects selected in the Object Browser or in the Viewer, which will be fused with tool objects. + In case if subshape from compsolid/compound was selected then other shapes from this compsolid/compound will be ignored. +- **Remove intersection edges** if enabled edges that lie on the same surface will be removed. +- **See preview** button shows a result of the operation. + +**TUI Command**: *model.addFuse(Part_doc, objects, tools, isRemoveEdges)* + +**Arguments**: Part + list of objects + list of tools + remove edges flag (optional). + +Result +"""""" + +The Result of the operation will be a single shape which is a fuse of selected objects and tools: + +.. image:: images/boolean_fuse_result.png + :align: center + +.. centered:: + **Fuse created** + +**See Also** a sample TUI Script of a :ref:`tui_create_fuse` operation. diff --git a/src/FeaturesPlugin/doc/images/CreatedCommon.png b/src/FeaturesPlugin/doc/images/CreatedCommon.png index ea27ef656..50319719c 100644 Binary files a/src/FeaturesPlugin/doc/images/CreatedCommon.png and b/src/FeaturesPlugin/doc/images/CreatedCommon.png differ diff --git a/src/FeaturesPlugin/doc/images/CreatedCut.png b/src/FeaturesPlugin/doc/images/CreatedCut.png index 0c927fdd9..e560a653f 100644 Binary files a/src/FeaturesPlugin/doc/images/CreatedCut.png and b/src/FeaturesPlugin/doc/images/CreatedCut.png differ diff --git a/src/FeaturesPlugin/doc/images/CreatedFuse.png b/src/FeaturesPlugin/doc/images/CreatedFuse.png index 65c69dde2..3695563f2 100644 Binary files a/src/FeaturesPlugin/doc/images/CreatedFuse.png and b/src/FeaturesPlugin/doc/images/CreatedFuse.png differ diff --git a/src/FeaturesPlugin/doc/images/CreatedIntersection.png b/src/FeaturesPlugin/doc/images/CreatedIntersection.png index 3ca9179d1..65f32f9cd 100644 Binary files a/src/FeaturesPlugin/doc/images/CreatedIntersection.png and b/src/FeaturesPlugin/doc/images/CreatedIntersection.png differ diff --git a/src/FeaturesPlugin/doc/images/CreatedPartition.png b/src/FeaturesPlugin/doc/images/CreatedPartition.png index f1b197934..102009fb5 100644 Binary files a/src/FeaturesPlugin/doc/images/CreatedPartition.png and b/src/FeaturesPlugin/doc/images/CreatedPartition.png differ diff --git a/src/FeaturesPlugin/doc/images/CreatedSmash.png b/src/FeaturesPlugin/doc/images/CreatedSmash.png index 2e4d296e5..cf2f59824 100644 Binary files a/src/FeaturesPlugin/doc/images/CreatedSmash.png and b/src/FeaturesPlugin/doc/images/CreatedSmash.png differ diff --git a/src/FeaturesPlugin/doc/images/Partition.png b/src/FeaturesPlugin/doc/images/Partition.png index 101001e39..70fb721a2 100644 Binary files a/src/FeaturesPlugin/doc/images/Partition.png and b/src/FeaturesPlugin/doc/images/Partition.png differ diff --git a/src/FeaturesPlugin/doc/images/Smash.png b/src/FeaturesPlugin/doc/images/Smash.png index c3f27f19b..2104b0381 100644 Binary files a/src/FeaturesPlugin/doc/images/Smash.png and b/src/FeaturesPlugin/doc/images/Smash.png differ diff --git a/src/FeaturesPlugin/doc/images/bool_common.png b/src/FeaturesPlugin/doc/images/bool_common.png new file mode 100644 index 000000000..c8f86a1a3 Binary files /dev/null and b/src/FeaturesPlugin/doc/images/bool_common.png differ diff --git a/src/FeaturesPlugin/doc/images/bool_common_advanced.png b/src/FeaturesPlugin/doc/images/bool_common_advanced.png new file mode 100644 index 000000000..c96a1d559 Binary files /dev/null and b/src/FeaturesPlugin/doc/images/bool_common_advanced.png differ diff --git a/src/FeaturesPlugin/doc/images/bool_common_simple.png b/src/FeaturesPlugin/doc/images/bool_common_simple.png new file mode 100644 index 000000000..9d86c9bfb Binary files /dev/null and b/src/FeaturesPlugin/doc/images/bool_common_simple.png differ diff --git a/src/FeaturesPlugin/doc/images/bool_fuse_advanced.png b/src/FeaturesPlugin/doc/images/bool_fuse_advanced.png new file mode 100644 index 000000000..c96a1d559 Binary files /dev/null and b/src/FeaturesPlugin/doc/images/bool_fuse_advanced.png differ diff --git a/src/FeaturesPlugin/doc/images/bool_fuse_simple.png b/src/FeaturesPlugin/doc/images/bool_fuse_simple.png new file mode 100644 index 000000000..9d86c9bfb Binary files /dev/null and b/src/FeaturesPlugin/doc/images/bool_fuse_simple.png differ diff --git a/src/FeaturesPlugin/doc/images/boolean_common_advanced_property_panel.png b/src/FeaturesPlugin/doc/images/boolean_common_advanced_property_panel.png new file mode 100644 index 000000000..3a28dcb46 Binary files /dev/null and b/src/FeaturesPlugin/doc/images/boolean_common_advanced_property_panel.png differ diff --git a/src/FeaturesPlugin/doc/images/boolean_common_result.png b/src/FeaturesPlugin/doc/images/boolean_common_result.png new file mode 100644 index 000000000..1b767991f Binary files /dev/null and b/src/FeaturesPlugin/doc/images/boolean_common_result.png differ diff --git a/src/FeaturesPlugin/doc/images/boolean_common_simple_property_panel.png b/src/FeaturesPlugin/doc/images/boolean_common_simple_property_panel.png new file mode 100644 index 000000000..3a7577ee8 Binary files /dev/null and b/src/FeaturesPlugin/doc/images/boolean_common_simple_property_panel.png differ diff --git a/src/FeaturesPlugin/doc/images/boolean_cut_property_panel.png b/src/FeaturesPlugin/doc/images/boolean_cut_property_panel.png new file mode 100644 index 000000000..ba79dd142 Binary files /dev/null and b/src/FeaturesPlugin/doc/images/boolean_cut_property_panel.png differ diff --git a/src/FeaturesPlugin/doc/images/boolean_cut_subsolids_arguments.png b/src/FeaturesPlugin/doc/images/boolean_cut_subsolids_arguments.png new file mode 100644 index 000000000..245637ac8 Binary files /dev/null and b/src/FeaturesPlugin/doc/images/boolean_cut_subsolids_arguments.png differ diff --git a/src/FeaturesPlugin/doc/images/boolean_cut_subsolids_result.png b/src/FeaturesPlugin/doc/images/boolean_cut_subsolids_result.png new file mode 100644 index 000000000..fe1124b5b Binary files /dev/null and b/src/FeaturesPlugin/doc/images/boolean_cut_subsolids_result.png differ diff --git a/src/FeaturesPlugin/doc/images/boolean_fuse_advanced_property_panel.png b/src/FeaturesPlugin/doc/images/boolean_fuse_advanced_property_panel.png new file mode 100644 index 000000000..6c218f94c Binary files /dev/null and b/src/FeaturesPlugin/doc/images/boolean_fuse_advanced_property_panel.png differ diff --git a/src/FeaturesPlugin/doc/images/boolean_fuse_result.png b/src/FeaturesPlugin/doc/images/boolean_fuse_result.png new file mode 100644 index 000000000..ce3912ad4 Binary files /dev/null and b/src/FeaturesPlugin/doc/images/boolean_fuse_result.png differ diff --git a/src/FeaturesPlugin/doc/images/boolean_fuse_simple_property_panel.png b/src/FeaturesPlugin/doc/images/boolean_fuse_simple_property_panel.png new file mode 100644 index 000000000..48b017ef2 Binary files /dev/null and b/src/FeaturesPlugin/doc/images/boolean_fuse_simple_property_panel.png differ diff --git a/src/FeaturesPlugin/doc/images/common_btn.png b/src/FeaturesPlugin/doc/images/common_btn.png deleted file mode 100644 index c8f86a1a3..000000000 Binary files a/src/FeaturesPlugin/doc/images/common_btn.png and /dev/null differ diff --git a/src/FeaturesPlugin/doc/images/extrusion_btn.png b/src/FeaturesPlugin/doc/images/extrusion_btn.png new file mode 100644 index 000000000..290c2e46b Binary files /dev/null and b/src/FeaturesPlugin/doc/images/extrusion_btn.png differ diff --git a/src/FeaturesPlugin/doc/images/extrusion_by_bounding_planes.png b/src/FeaturesPlugin/doc/images/extrusion_by_bounding_planes.png new file mode 100644 index 000000000..49f81f8e9 Binary files /dev/null and b/src/FeaturesPlugin/doc/images/extrusion_by_bounding_planes.png differ diff --git a/src/FeaturesPlugin/doc/images/extrusion_by_sizes.png b/src/FeaturesPlugin/doc/images/extrusion_by_sizes.png new file mode 100644 index 000000000..b081893cd Binary files /dev/null and b/src/FeaturesPlugin/doc/images/extrusion_by_sizes.png differ diff --git a/src/FeaturesPlugin/doc/images/extrusion_result.png b/src/FeaturesPlugin/doc/images/extrusion_result.png new file mode 100644 index 000000000..4773d0ce8 Binary files /dev/null and b/src/FeaturesPlugin/doc/images/extrusion_result.png differ diff --git a/src/FeaturesPlugin/doc/images/intersection_property_panel.png b/src/FeaturesPlugin/doc/images/intersection_property_panel.png new file mode 100644 index 000000000..d3fd35333 Binary files /dev/null and b/src/FeaturesPlugin/doc/images/intersection_property_panel.png differ diff --git a/src/FeaturesPlugin/doc/intersectionFeature.rst b/src/FeaturesPlugin/doc/intersectionFeature.rst index 1b93530f3..14376d898 100644 --- a/src/FeaturesPlugin/doc/intersectionFeature.rst +++ b/src/FeaturesPlugin/doc/intersectionFeature.rst @@ -4,7 +4,7 @@ Intersection The feature Intersection implements a boolean operation for intersection of a set of main objects with a set of tool objects. -To perform a boolean opration Intersection in the active part: +To perform a boolean operation Intersection in the active part: #. select in the Main Menu *Features - > Intersection* item or #. click **Intersection** button in the toolbar @@ -17,13 +17,13 @@ To perform a boolean opration Intersection in the active part: The following property panel will be opened: -.. image:: images/Intersection.png +.. image:: images/intersection_property_panel.png :align: center .. centered:: **Intersection operation** -**Base Objects** contains a list of objects selected in the Object Browser or in the Viewer, which will be intersected. +**Objects** contains a list of objects selected in the Object Browser or in the Viewer, which will be intersected. **TUI Command**: *model.addIntersection(Part_doc, Objects)* diff --git a/src/FeaturesPlugin/doc/partitionFeature.rst b/src/FeaturesPlugin/doc/partitionFeature.rst index 2d64521b2..3c6ab820b 100644 --- a/src/FeaturesPlugin/doc/partitionFeature.rst +++ b/src/FeaturesPlugin/doc/partitionFeature.rst @@ -4,7 +4,7 @@ Partition The feature Partition implements a boolean operation for partitioning of a set of selected objects. -To perform a boolean opration Partition in the active part: +To perform a boolean operation Partition in the active part: #. select in the Main Menu *Features - > Partition* item or #. click **Partition** button in the toolbar diff --git a/src/FeaturesPlugin/doc/smashFeature.rst b/src/FeaturesPlugin/doc/smashFeature.rst index e9364a3f7..44a4e6826 100644 --- a/src/FeaturesPlugin/doc/smashFeature.rst +++ b/src/FeaturesPlugin/doc/smashFeature.rst @@ -4,7 +4,7 @@ Smash The feature Smash implements a boolean operation for smashing a set of main objects by a set of tool objects. -To a create boolean opration Smash in the active part: +To a create boolean operation Smash in the active part: #. select in the Main Menu *Features - > Smash* item or #. click **Smash** button in the toolbar @@ -23,11 +23,12 @@ The following property panel will be opened: .. centered:: **Smash operation** -Here it is necessary to select main objects and tool objects. - -**Apply** button creates the smash shape. - -**Cancel** button cancels operation. +- **Main Objects** contains a list of objects selected in the Object Browser or in the Viewer, which will be smashed by tool objects. + In case if subshape from compsolid was selected then other shapes from this compsolid/compound will be cut from + other objects (to avoid self intersection) and added to the result. +- **Tool Objects** contains a list of objects selected in the Object Browser or in the Viewer, which will be smashed into main objects. + In case if subshape from compsolid/compound was selected then other shapes from this compsolid/compound will be ignored. +- **See preview** button shows a result of the operation. **TUI Command**: *model.addSmash(Part_doc, mainObjects, toolObjects)*