Documentation: use 'figure' instead of 'image'; improve caption layout; fix warnings.

[modules/shaper.git] / src / CollectionPlugin / doc / groupFeature.rst

diff --git a/src/CollectionPlugin/doc/groupFeature.rst b/src/CollectionPlugin/doc/groupFeature.rst
index 5944cdadc70ec425166212e0cb2c724a2ec314fd..becce7777eaedbae8bdbf0fd7653dd45ea0eebaa 100644 (file)
--- a/src/CollectionPlugin/doc/groupFeature.rst
+++ b/src/CollectionPlugin/doc/groupFeature.rst
@@ -1,4 +1,6 @@
-.. |shape_group.icon|    image:: images/shape_group.png
+.. |shape_group.icon| image:: images/shape_group.png
+
+.. _groupPage:
 
 Group
 =====
@@ -11,37 +13,38 @@ To create a Group in the active part:
 
 The following property panel appears. 
 
-.. image:: images/group_property_panel.png
+.. figure:: images/group_property_panel.png
   :align: center
 
-.. centered::
   Create a group
 
+.. |group_vertices| image:: images/group_property_panel_vertice.png
+.. |group_edges| image:: images/group_property_panel_edge.png
+.. |group_faces| image:: images/group_property_panel_face.png
+.. |group_solids| image:: images/group_property_panel_solid.png
+
 Input fields:
 
 - **Name** defines the name of the group, by default, it is **Group_n**.
 - **Type** buttons select geometrical entities to be included in group:
   
-    .. image:: images/group_property_panel_vertice.png
-         :align: left
-    Vertices;
-  
-    .. image:: images/group_property_panel_edge.png
-         :align: left
-    Edges;
+    |group_vertices| Vertices;
+
+    |group_edges| Edges;
 
-    .. image:: images/group_property_panel_face.png
-         :align: left
-    Faces;
+    |group_faces| Faces;
 
-    .. image:: images/group_property_panel_solid.png
-         :align: left         
-    Solids;
+    |group_solids| Solids;
  
 - The list of selected entities of the given type.  Multiple selection can be done manually in OCC 3D Viewer by mouse click with Shift button pressed or by rectangle selection. To delete entities from the list, select them and call pop-up menu *Delete* item.
 
+- **Selection by filters** button opens "selection by filters" property panel and allows to select entities by set of selected filters. For details on filters see :ref:`filtersPlugin`
+
+- **Show only** button allows to hide all other objects and shapes and show only selected ones.
+
 - Control **Add elements that share the same topology** allows to add automatically all elements laying on the same topology that was selected and remove these elements if they have disappeared due to the parametrical update. They will be represented as one line in the list of selection and managed in the viewer as one object if this flag is enabled. If flag becomes disabled when such elements are already in the list, they will become divided in one line per one shape.
 
+
 **TUI Command**:
 
 .. py:function:: model.addGroup(Part_1_doc, [model.selection("EDGE", "Cone_1_1/Face_1&Cone_1_1/Face_2"), model.selection("EDGE", "Cone_1_1/Face_1")])
@@ -55,10 +58,9 @@ Result
 
 Created Group appears in the view.
 
-.. image:: images/group_res.png
-          :align: center
+.. figure:: images/group_res.png
+   :align: center
 
-.. centered::
    Created group
 
 **See Also** a sample TUI Script of :ref:`tui_create_group` operation.