Salome HOME
[bos #40506][CEA] Cannot hide faces of a group
[modules/shaper.git] / doc / gui / General / Introduction.rst
index 3cb1c45b2098d74de2805449301855a62836a0d1..927f12705953f7b2d4d233b4ebd0d2997d07d025 100644 (file)
@@ -325,25 +325,31 @@ The information about  Plane, Face additionally shows coordinates of center poin
 
    **Inspection panel** for Face
 
+The shapes information, equal to the provided Inspection panel information on the shape is accessible inpython API by usage of **shapeInfo** command:
+
+ | *from salome.shaper import geom*
+ | *geom.shapeInfo(vertex)*
+ | *==> ('Vertex', 0.0, 0.0, 10.0)*
+
+
 .. _hidefaces_panel:
 
 Hide Faces panel
 ^^^^^^^^^^^^^^^^
 
-**Hide Faces** panel makes possible to hide temporary faces of any displayed object. **Hide Faces** panel looks like following:
+**Hide Faces** panel makes it possible to temporarily hide faces of any displayed object. **Hide Faces** panel looks like following:
 
 .. figure:: /images/hide_faces_panel.png
    :align: center
 
    **Hide Faces** panel
 
-- If this panel is activated it "listens" user selection.
+- If this panel is activated it "listens" to the user selection.
 - If a face is selected then its name will be shown in the panel's list and hidden in the viewer.
-- If user selects a group of faces (or at least a one face of this group) then whole group will be hidden and also all faces from all objects referenced by this group.
-- If user will display the hidden group again (by a show operation) then the group will be removed from Hide Faces list and visibility of all referenced faces will be restored.
+- If the user wants to display a hidden result body again (by a show operation) then the faces of this result body will be removed from Hide Faces list and the visibility of all referenced faces will be restored.
 
-It is also possible not to hide faces, but make them transparent. For this purpose **"Transparent"** check-box can be used. Value of the transparency can be changed in **Visualization** tab of **Preferences** dialog box.
-Closing of **Hide Faces** panel restores visibility state of all objects. If it is necessary to deactivete the **Hide Faces** panel (preserving the current display state) then user has to press **"Esc"** button.
+Instead of hiding the faces, it is also possible to make them transparent. For this purpose the **"Transparent"** check-box can be used. The value of the transparency can be changed under the **Visualization** tab of the **Preferences** dialog box.
+Closing the **Hide Faces** panel restores the visibility state of all objects. If it is necessary to deactivete the **Hide Faces** panel (preserving the current display state) then the user has to press the **"Esc"** button.
 
 .. _python console:
 
@@ -387,6 +393,13 @@ This point of view can be modified using viewer commands: **Panning**, **Zooming
 
    Two view windows
 
+The viewer is able to show direction of edges of objects.
+
+.. figure:: /images/edges_directions.png
+   :align: center
+
+   Showing the edges direction
+
 The description of OCC 3D Viewer architecture and functionality is provided in GUI module user's guide in chapter **OCC 3D Viewer**.
 
 .. _parameter_usage:
@@ -468,7 +481,7 @@ Other tabs are activated by click on tab header.
 General tab
 ^^^^^^^^^^^
 
-This tab defines what parts to be activated and what elements to be visible after opening a study or a script.
+This tab defines behavior of Parts and displayed objects on creation or opening of a study, or loading python scripts.
 
 .. figure:: /images/general_preferences.png
    :align: center
@@ -477,6 +490,8 @@ This tab defines what parts to be activated and what elements to be visible afte
 
 **Input fields**:
 
+- **Create new part** flag. If it is enabled, an empty part is created on a study creation.
+
 - **Activate** relates to activation of part when opening a HDF document. Its could be one of the following:
 
   - "Last part" - activate last part in the document (**default value**);
@@ -536,6 +551,7 @@ This tab defines presentation of objects displayed in OCC 3D viewer.
 - **Sketch fully constraint color** selects default color for a sketch with zero degrees of freedom.
 - **Zoom trihedron arrows** if this control is checked then arrows of a view trihedron will be scaled according to current view scale
 - **Axis arrow size** relative size of trihedron arrows. It has effect only in case if **Zoom trihedron arrows** is On.
+- **Enable automatic rotation** enables the perpetual rotation animation in the viewer.
 
 To redefine any color click on the corresponding line to access **Select color** dialog box
 
@@ -618,11 +634,16 @@ Sketch tab defines properties of coordinate planes shown for selection of sketch
 
 - **Size** defines size of coordinate planes;
 - **Thickness**  defines thickness of coordinate plane borders;
-- **Rotate to plane when selected** check-box turns on/off automatic switch the viewer to the top view for the selected sketch plane.
+- **Rotate to plane when selected** check-box turns on/off automatic switch the viewer to the top view for the selected sketch plane;
 - **Angular tolerance** defines defines an angular tolerance for automatic creation of horizontal and vertical constraints;
 - **Default spline weight** defines default weight for B-spline nodes during creation. The default value can be changed by editing of the spline;
-- **Cursor for sketch operation** defines a cursor which indicates a launched sketcher sub-operation.
+- **Cursor for sketch operation** defines a cursor which indicates a launched sketcher sub-operation;
 - **Create sketch entities by dragging** defines a style of sketch etities creation. It concerns creation of lines, rectangles, circles, arcs, ellipses, elliptic arcs. If it is switched ON then points of objects have to be defined by mouse press - mouse move - mouse release. Otherwise every point of an object has to be defined by mouse click;
+- **Allow automatic constraint substitution/remove** allows automatic resolving of conflicting constraints.
+  The following conflicts could be processed:
+    - Horizontal/Vertical automatic constraints (this last constraint will be removed);
+    - Pair of arcs connected smoothly, which centers are coincident (Tangency between arcs will be removed);
+- **Notify automatic constraint substitution/remove** defines a message box to be shown to the user, if the conflicting constraints situation is automatically resolved.
 
 .. _viewer_preferences: