X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=src%2FFeaturesPlugin%2Fdoc%2FfuseFeature.rst;h=739d249f6b883eecbe736eec7c0a1542aaa78d35;hb=d3afed6da21a10db226a968698b63af318e6111e;hp=9944cfcc40c11cad26f59d626d5c383245a258c5;hpb=c5ec43297b55923e1cf2ee39978bf42d733ee465;p=modules%2Fshaper.git diff --git a/src/FeaturesPlugin/doc/fuseFeature.rst b/src/FeaturesPlugin/doc/fuseFeature.rst index 9944cfcc4..739d249f6 100644 --- a/src/FeaturesPlugin/doc/fuseFeature.rst +++ b/src/FeaturesPlugin/doc/fuseFeature.rst @@ -1,10 +1,104 @@ +.. |bool_fuse.icon| image:: images/bool_fuse.png + :height: 16px Fuse ==== +Fuse feature implements a Boolean operation for fusion of a set of main objects with a set of tool objects. -.. image:: images/Fuse.png - :align: center +To perform Fuse in the active part: + +#. select in the Main Menu *Features - > Fuse* item or +#. click |bool_fuse.icon| **Fuse** button in the toolbar + +There are 2 options for creation of a Fuse: + +.. image:: images/bool_fuse_simple.png + :align: left + :height: 24px + +**Simple** simply fuses selected objects. + +.. image:: images/bool_fuse_advanced.png + :align: left + :height: 24px + +**Advanced** fuse with additional functionality for subshapes of compsolids/compounds. + +-------------------------------------------------------------------------------- + +Simple +------ + +.. image:: images/boolean_fuse_simple_property_panel.png + :align: center .. centered:: - Fuse definition + **Simple** + +- **Objects** - contains a list of objects selected in the Object Browser or in the Viewer, which will be fused with tool objects. + If a subshape that belongs to a compsolid/compound was selected, other shapes of 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**: + +.. py:function:: model.addFuse(Part_doc, objects, isRemoveEdges) + + :param part: The current part object. + :param list: A list of objects. + :param boolean: Remove edges flag (optional). + :return: Created object. + +Result +"""""" + +The Result of the operation will be a single shape which is a fuse of selected objects: + +.. image:: images/CreatedFuse.png + :align: center + +.. centered:: + **Fuse created** + +**See Also** a sample TUI Script of :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. + If a subshape that belongs to a compsolid/compound was selected, other shapes of 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. + If a subshape that belongs to a compsolid/compound was selected, other shapes of 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**: + +.. py:function:: model.addFuse(Part_doc, objects, tools, isRemoveEdges) + + :param part: The current part object. + :param list: A list of objects. + :param list: A list of tools. + :param boolean: Remove edges flag (optional). + :return: Created object. + +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 :ref:`tui_create_fuse` operation.