Salome HOME
53539: 0D Element
[modules/smesh.git] / doc / salome / gui / SMESH / input / mesh_preferences.doc
index 02574d07dde82aec065a16e08fb006bdb5b1ac2e..79a268d0a0a00952b76dc38ed8e6f9adf1a27d90 100644 (file)
@@ -2,23 +2,23 @@
 
 \page mesh_preferences_page Mesh preferences
 
-In the Mesh module you can set mesh preferences, which can be used in
-later sessions with this module.
+In the Mesh module you can set mesh preferences, which can be used right now 
+or in later sessions with this module according to the preferences.
 
 <h2>General Preferences</h2>
 
 \image html pref21.png
 
 - <b>Automatic Update</b>
-  - If you toggle <b>Automatic Update</b> checkbox, the model in your
-    viewer will be automatically updated when you make changes in it, depending on
+  - <b>Automatic Update</b> - if activated, the mesh in your
+    viewer will be automatically updated after it's computation, depending on
     values of additional preferences specified below.
   - <b>Size limit (elements)</b> - allows specifying the maximum
     number of elements in the resulting mesh for which the automatic updating
     of the presentation is performed. This option affects only
-    <b>Compute</b> operation. Zero value means "no limit". Default value
-    is 500 000 mesh elements.
-  - <b>Incremental limit check</b> - when this control is switched on,
+    \ref compute_anchor "Compute" operation. Zero value means "no
+    limit". Default value is 500 000 mesh elements. 
+  - <b>Incremental limit check</b> - if activated,
     the mesh size limit check is not applied to the total number of
     elements in the resulting mesh, it is applied iteratively to each entity type
     in the following order: 0D elements, edges, faces, volumes, balls.
@@ -28,32 +28,43 @@ later sessions with this module.
     this type are shown, otherwise the user is warned that some entities are not shown.
 
 - <b>Quality Controls</b>
-  - If you toggle <b>Display entity</b>, both faces and edges of an
-    object will be displayed in the viewer by default.
-  - If you toggle <b>Use precision</b> checkbox, you can display numbers in
-    <b>Quality Control</b> diagrams at the necessary level of precision.
-  - <b>Number of digits after point</b> - defines precision for
-    <b>Quality Controls</b>. By default, numbers in <b>Quality Control</b>
-    diagrams are presented as integers.
-  - <b>Double nodes tolerance</b> defines the maximal distance between two
-    mesh nodes, at which they are considered coincident by <b>Double nodes</b>
-    quality control.
-
-- <b>Display mode</b> - allows to set Wireframe, Shading, Nodes or Shrink
-  presentation mode as default.
-
+  - <b>Display entity</b> - if activated, only currently
+    \ref quality_page "controlled" entities are displayed in the
+    viewer and other entities are temporarily hidden. For example if you
+    activate \ref length_page "Length" quality control, which controls
+    the length of mesh segments, then only mesh segments are
+    displayed and faces and volumes are hidden. 
+  - <b>Use precision</b> - if activated, all quality controls
+    will be computed at precision defined by <b>Number of digits after
+    point</b> - as integers by default.
+  - <b>Double nodes tolerance</b> - defines the maximal distance between two
+    mesh nodes, at which they are considered coincident by
+    \ref double_nodes_control_page "Double nodes" quality control.
+
+- <b>Display mode</b>
+  - <b>Default display mode</b> - allows to set Wireframe, Shading, Nodes or Shrink
+    \ref display_mode_page "presentation mode" as default.
+
+\anchor quadratic_2d_mode_pref
 - <b>Representation of the 2D quadratic elements</b>
-  - <b>Representation of the 2D quadratic elements</b> combobox - allows
-    to select lines or arcs for representation of quadratic elements.
+  - <b>Default mode of the 2D quadratic elements</b> - allows to
+    select either \a Lines or \a Arcs as a default
+    \ref quadratic_2d_mode "representation" of 1D and 2D
+    \ref adding_quadratic_elements_page "quadratic elements".
   - <b>Maximum Angle</b> - maximum deviation angle used by the
     application to build arcs.
 
 - <b>Mesh export</b>
-  - If you toggle <b>Automatically create groups for MED export</b> checkbox,
-    this operation will be carried out automatically.
+\anchor export_auto_groups_pref
+  - <b>Automatically create groups for MED export</b> - defines a
+    default state of a corresponding check-box in \ref export_auto_groups
+    "MED Export" dialog.
+\anchor group_export_warning_pref
+  - <b>Show warning when exporting group</b> - if activated, a warning is
+    displayed when exporting a group.
 
 - <b>Mesh computation</b>
-  - <b>Show a computation result notification</b> combobox allows to
+  - <b>Show a computation result notification</b> combo-box allows to
     select the notification mode about a mesh computation result.
     There are 3 possible modes:
     - <b>Never</b> - do not show the result dialog at all;
@@ -130,13 +141,17 @@ later sessions with this module.
 
 \image html pref22.png
 
-- <b>Nodes</b>
+- <b>Nodes</b> allows to define default parameters for nodes, which will be applied 
+  for a newly created mesh only. Existing meshes can be customized using 
+  \ref colors_size_page "Properties dialog box" available from the context menu of a mesh.
   - <b>Color</b> -  allows to select the color of nodes. Click on the
     colored line to access to the <b>Select Color</b> dialog box.
   - <b>Type of marker</b> - allows to define the shape of nodes.
   - <b>Scale of marker</b> - allows to define the size of nodes.
 
-- <b>Elements</b>
+- <b>Elements</b> allows to define default parameters for different elements, which will be applied 
+  for a newly created mesh only. Existing meshes can be customized using 
+  \ref colors_size_page "Properties dialog box" available from the context menu of a mesh.
   - <b>Surface color</b>  - allows to select the surface color of 2D elements
     (seen in Shading mode). Click on the colored line to access to the
     <b>Select Color</b> dialog box.
@@ -149,8 +164,8 @@ later sessions with this module.
   - <b>Reversed volume color</b> - allows to select the surface color
     of reversed 3D elements. Use the slider to select the color generated basing on
     the <b>Volume color</b> by changing its brightness and saturation.
-  - <b>0D elements</b> - allows to choose color of 0D mesh elements.
-  - <b>Balls</b> - allows to choose color of discrete mesh elements (balls).
+  - <b>0D element color</b> - allows to choose color of 0D mesh elements.
+  - <b>Ball color</b> - allows to choose color of discrete mesh elements (balls).
   - <b>Outline color</b> - allows to select the color of element
     borders.
   - <b>Wireframe color</b> - allows to select the color of borders of
@@ -159,27 +174,32 @@ later sessions with this module.
   - <b>Size of 0D elements</b> - specifies default size of 0D elements.
   - <b>Size of ball elements</b> - specifies default size of discrete
     elements (balls).
+  - <b>Scale factor of ball elements</b> - specifies default scale factor of discrete
+    elements (balls).
   - <b>Line width</b> - allows to define the width of 1D elements (edges).
   - <b>Outline width</b> - allows to define the width of borders of
     2D and 3D elements (shown in the Shading mode).
   - <b>Shrink coef.</b> - allows to define relative space of elements
     compared to gaps between them in shrink mode.
 
-- <b>Groups</b> allows to define groups default properties:
+- <b>Groups</b>
   - <b>Names color</b> - specifies color of group names to be used in
     3D viewer.
-  - <b>Default color</b> - specifies default group color.
+  - <b>Default color</b> - specifies the default group color, which is used 
+  to create a new mesh group (see \ref creating_groups_page "Create Group dialog box").
 
 - <b>Numbering</b> allows to define properties of numbering functionality:
   - <b>Nodes</b> - specifies text properties of nodes numbering
     (font family, size, attributes, color).
   - <b>Elements</b> - same for elements.
 
-- <b>Orientation of Faces</b> - allows to define the behavior of
-  <b>Orientation of faces</b> functionality:
-  - \b Color - allows to define the color of orientation vertors;
+- <b>Orientation of Faces</b> - allows to define default properties of orientation vectors.
+  These preferences will be applied to the newly created meshes only; properties of existing meshes
+  can be customized using \ref colors_size_page "Properties dialog box"
+  available from the context menu of a mesh.
+  - \b Color - allows to define the color of orientation vectors;
   - \b Scale - allows to define the size of orientation vectors;
-  - <b>3D Vector</b> checkbox allows to choose between 2D planar
+  - <b>3D Vector</b> check-box allows to choose between 2D planar
     and 3D vectors.
 
 <br><h2>Selection Preferences</h2>
@@ -189,7 +209,7 @@ later sessions with this module.
 - <b>Selection</b> - performed with mouse-indexing (preselection)
   and left-clicking on an object, whose appearance changes as defined in
   the <b>Preferences</b>.
-  - <b>Object Color</b> -  allows to select the color of mesh (edges and
+  - <b>Object color</b> -  allows to select the color of mesh (edges and
     borders of meshes) of the selected entity. Click on the colored line
     to access to the <b>Select Color</b> dialog box.
   - <b>Element color</b> - allows to select the color of surface of selected
@@ -198,7 +218,7 @@ later sessions with this module.
 
 - <b>Preselection</b> - performed with mouse-indexing on an object,
   whose appearance changes as defined in the <b>Preferences</b>.
-  - <b>Highlight Color</b> -  allows to select the color of mesh (edges and
+  - <b>Highlight color</b> -  allows to select the color of mesh (edges and
     borders of meshes) of the entity . Click on the colored line to access
     to the <b>Select Color</b> dialog box.
 
@@ -209,6 +229,11 @@ later sessions with this module.
 
 \image html pref24.png
 
+\note The following settings are default and will be applied for 
+a newly created mesh only. Existing meshes 
+can be customized using local \ref scalar_bar_dlg "Scalar Bar Properties dialog box" 
+available from the context menu of a mesh.
+
 - <b>Font</b> - in this menu you can set type, face and color for
   the font of <b>Title</b> and <b>Labels</b>.