diff --git a/doc/salome/gui/GEOM/images/restore-ss-OB-cut.png b/doc/salome/gui/GEOM/images/restore-ss-OB-cut.png new file mode 100644 index 000000000..51b5a4fb4 Binary files /dev/null and b/doc/salome/gui/GEOM/images/restore-ss-OB-cut.png differ diff --git a/doc/salome/gui/GEOM/images/restore-ss-OB.png b/doc/salome/gui/GEOM/images/restore-ss-OB.png index 022c284a4..4db07ebfa 100644 Binary files a/doc/salome/gui/GEOM/images/restore-ss-OB.png and b/doc/salome/gui/GEOM/images/restore-ss-OB.png differ diff --git a/doc/salome/gui/GEOM/images/restore-ss-cut.png b/doc/salome/gui/GEOM/images/restore-ss-cut.png new file mode 100644 index 000000000..cf6a41278 Binary files /dev/null and b/doc/salome/gui/GEOM/images/restore-ss-cut.png differ diff --git a/doc/salome/gui/GEOM/images/restore-ss-dialog.png b/doc/salome/gui/GEOM/images/restore-ss-dialog.png index 168cba257..d51a68ecf 100644 Binary files a/doc/salome/gui/GEOM/images/restore-ss-dialog.png and b/doc/salome/gui/GEOM/images/restore-ss-dialog.png differ diff --git a/doc/salome/gui/GEOM/images/restore-ss-viewer-after.png b/doc/salome/gui/GEOM/images/restore-ss-viewer-after.png index af13c7f1c..d25b113d1 100644 Binary files a/doc/salome/gui/GEOM/images/restore-ss-viewer-after.png and b/doc/salome/gui/GEOM/images/restore-ss-viewer-after.png differ diff --git a/doc/salome/gui/GEOM/images/restore-ss-viewer-before.png b/doc/salome/gui/GEOM/images/restore-ss-viewer-before.png index 6d2e581bf..4fa5b1319 100644 Binary files a/doc/salome/gui/GEOM/images/restore-ss-viewer-before.png and b/doc/salome/gui/GEOM/images/restore-ss-viewer-before.png differ diff --git a/doc/salome/gui/GEOM/images/restore-ss-viewer-cut.png b/doc/salome/gui/GEOM/images/restore-ss-viewer-cut.png new file mode 100644 index 000000000..d745bce1f Binary files /dev/null and b/doc/salome/gui/GEOM/images/restore-ss-viewer-cut.png differ diff --git a/doc/salome/gui/GEOM/input/restore_presentation_parameters.doc b/doc/salome/gui/GEOM/input/restore_presentation_parameters.doc index 134871744..5460457d6 100644 --- a/doc/salome/gui/GEOM/input/restore_presentation_parameters.doc +++ b/doc/salome/gui/GEOM/input/restore_presentation_parameters.doc @@ -5,48 +5,52 @@ \n This functionality allows the operation result to inherit colour and subshapes from its arguments. -\n To activate this functionality, one should check the "Set -presentation parameters and subshapes from arguments" checkbox in +\n To activate this functionality, check in "Set +presentation parameters and subshapes from arguments" checkbox in the corresponding dialog. -\image html restore-ss-dialog.png - -\n Let us view an example to understand, how it works. -Before the partitioning we had box Box_1 with two published faces and -cylinder Cylinder_1 with free published edges. After the partition we -have also resulting object with several subshapes, that corresponds to -operation arguments and their published subshapes. We performed two -partitions: Partition_1 result obtained by partitioning two objects -Box_1 and Cylinder_1 as objects, with no tool, Partiton_2 obtained by -partitioning Box_1 object with Cylinder_1 tool: - -\image html restore-ss-OB.png - -\n If all the shapes and subshapes have their own colours before the -partitioning, the resultiong shape and its automatically generated -subshapes will inherit these colours. - -\n If the resulting shape corresponds to its first argument (like -after transformation or after the boolean operation Cut, or after the -partiton with one object shape), it inherits its colour, and also -inherits its subshapes (like Partition_2). - -\n In the case, when the resulting shape composed from multiple arguments -(like after boolean operations, except Cut, or after the partition with -several object shapes, or it is a compound), it will have default -colour, but its generated subshapes, corresponding to arguments and -their subshapes, will inherit corresponding colours. And in this case -it will have generated subshapes, corresponding to the arguments (like -Partition_1). - -\n See the picture before the partition: +\n For example, there exist two objects: Box_1 with two published +faces and Cylinder_1 with free published edges. \image html restore-ss-viewer-before.png -\n And the picture, displaying only the Partition_2 with subshapes: +First, we examine the case when the resulting shape corresponds to one argument (after transformation, +after the boolean operation Cut, or after the partiton with one object shape). + +We create a Cut of Box_1 with Cylinder_1. + +\image html restore-ss-cut.png + +The resulting shape inherits the subshapes and the colour of Box_1. + +\image html restore-ss-viewer-cut.png + +Second, we examine the case when the resulting shape is composed from multiple arguments +(after all boolean operations, except for Cut, or after the partition with +several object shapes, or if the resulting shape is a compound). + +We create a Common of Box_1 and Cylinder_1. + +\image html restore-ss-dialog.png + +\n The resulting object is created with several subshapes that correspond to the +operation arguments and their published subshapes. The resulting shape +has a default colour, but its subshapes inherit colors corresponding +to arguments and their subshapes. \image html restore-ss-viewer-after.png + +Please, note that when the resulting shape corresponds to one +argument, the inherited subshapes depend directly on the resulting shape. + +\image html restore-ss-OB-cut.png + +When the resulting shape is composed from multiple arguments, the +inherited subshapes depend on the arguments. + +\image html restore-ss-OB.png + \n You can also call this functionality from your python scripts. See our TUI Scripts for \ref tui_restore_prs_params "example".