Salome HOME
23173: EDF 11552 - Problem using Add 0D element function
[modules/smesh.git] / doc / salome / gui / SMESH / input / mesh_preferences.doc
index 80d751d6f057132817336fe10f77ce2592eb342d..26efbe272d13a378a0161f22292bb56a58419bf6 100644 (file)
@@ -2,8 +2,8 @@
 
 \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>
 
@@ -11,22 +11,21 @@ later sessions with this module.
 
 - <b>Automatic Update</b>
   - If you toggle <b>Automatic Update</b> checkbox, the model in your
-    viewer automatically updated when you make changes in it, depending on
+    viewer will be automatically updated when you make changes in it, depending on
     values of additional preferences specified below.
-  - <b>Size limit (elements)</b> - allows to specify the maximum
+  - <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,
-    check for mesh size limit will be applied not to total number of
-    elements in resulting mesh, but iteratively to each entity types
-    in the following order: 0D elements, edges, faces, volumes, balls;
-    at each step number of entities of given type will be added to the
-    total number of elements computed at previous step - if resulting
-    number of elements does not exceed size limit, the entities of
-    this type will be shown, otherwise user will be warned that some
-    entities are not shown.
+    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.
+    At each step the number of entities of a certain type is added to the
+    total number of elements computed at the previous step - if the resulting
+    number of elements does not exceed the size limit, the entities of
+    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
@@ -40,21 +39,22 @@ later sessions with this module.
     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
+- <b>Display mode</b>
+  - <b>Default display mode</b> - allows to set Wireframe, Shading, Nodes or Shrink
   presentation mode as default.
 
 - <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> combo-box - allows
+    to select lines or arcs for representation of quadratic elements as default.
   - <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,
+  - If you toggle <b>Automatically create groups for MED export</b> check-box,
     this operation will be carried out automatically.
 
 - <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;
@@ -68,40 +68,40 @@ later sessions with this module.
     information is shown:
     - <b>Simple</b> - as a plain text
     - <b>Tree</b> - in a tree-like form
-  - <b>Automatic nodes compute limit</b> - allows to define the size limit for the
+  - <b>Automatic nodes compute limit</b> - allows defining the size limit for the
     mesh groups for which the number of underlying nodes is calculated
     automatically. If the group size exceeds the value set in the preferences,
     the user will have to press \em Compute button explicitly. Zero value
     means "no limit". By default the value is set to 100 000 mesh elements.
-  - <b>Automatic controls compute limit</b> - allows to define the size limit for the
+  - <b>Automatic controls compute limit</b> - allows defining the size limit for the
     mesh elements for which the Aspect Ratio histogram is calculated
     automatically. If the mesh elements size exceeds the value set in the preferences,
-    the user will have to press \em Compute button explicitly. Zero value
+    it is possible to press \b Compute button explicitly to calculate the histogram . Zero value
     means "no limit". By default the value is set to 3 000 mesh elements.
   - <b>Show details on groups in element information tab</b> - when
     this option is switched off (default), only the names of groups, to which the node
     or element belongs, are shown in the \ref mesh_element_info_anchor "Info Tab"
     tab of "Mesh Information" dialog box. If this option is
     switched on, the detailed information on groups is shown.
-  - <b>Dump base information</b> - allows to dump base mesh information to the
+  - <b>Dump base information</b> - allows dumping base mesh information to the
     file, see \ref mesh_infos_page.
-  - <b>Dump element information</b> - allows to dump element information to the
+  - <b>Dump element information</b> - allows dumping element information to the
     file, see \ref mesh_infos_page.
-  - <b>Dump additional information</b> - allows to dump additional mesh
+  - <b>Dump additional information</b> - allows dumping additional mesh
     information to the file, see \ref mesh_infos_page.
-  - <b>Dump controls information</b> - allows to dump quality mesh
+  - <b>Dump controls information</b> - allows dumping quality mesh
     information to the file, see \ref mesh_infos_page.
 
 - <b>Automatic Parameters</b>
   - <b>Ratio Bounding Box Diagonal / Max Size</b> - this parameter is
-    used for automatic meshing: ratio between the bounding box of the
+    used for automatic meshing. This is the ratio between the bounding box of the
     meshed object and the Max Size of segments.
-  - <b>Default Number of Segments</b> - allows defining the default
+  - <b>Default Number of Segments</b> - defines the default
     number of segments on each edge.
 
 - <b>Mesh loading</b>
   - If <b>No mesh loading from study file at hypothesis modification</b>
-    checkbox is on, the mesh data will not be loaded from the study file
+    check-box is on, the mesh data will not be loaded from the study file
     when a hypothesis is modified. This allows  saving time by omitting
     loading data of a large mesh that is planned to be recomputed with other parameters.
 
@@ -131,13 +131,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.
@@ -150,36 +154,42 @@ 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
     elements in the wireframe mode.
+  - <b>Preview color</b> - allows to select the preview color of the elements.
   - <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 +199,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 +208,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 +219,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>.