X-Git-Url: http://git.salome-platform.org/gitweb/?p=modules%2Fsmesh.git;a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Fmesh_preferences.doc;h=26efbe272d13a378a0161f22292bb56a58419bf6;hp=2dd1b7b952e2ceb962eae0ecbc39e9f47a75fe39;hb=f6e2eed4240c426f1e65b40d1bd7e8d109a4d4b5;hpb=14570f80e3fa5f4abce93a814405f3b3f930c2d3 diff --git a/doc/salome/gui/SMESH/input/mesh_preferences.doc b/doc/salome/gui/SMESH/input/mesh_preferences.doc index 2dd1b7b95..26efbe272 100644 --- a/doc/salome/gui/SMESH/input/mesh_preferences.doc +++ b/doc/salome/gui/SMESH/input/mesh_preferences.doc @@ -2,228 +2,249 @@ \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.

General Preferences

\image html pref21.png - +- Automatic Update + - If you toggle Automatic Update checkbox, the model in your + viewer will be automatically updated when you make changes in it, depending on + values of additional preferences specified below. + - Size limit (elements) - 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 + Compute operation. Zero value means "no limit". Default value + is 500 000 mesh elements. + - Incremental limit check - when this control is switched on, + 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. + +- Quality Controls + - If you toggle Display entity, both faces and edges of an + object will be displayed in the viewer by default. + - If you toggle Use precision checkbox, you can display numbers in + Quality Control diagrams at the necessary level of precision. + - Number of digits after point - defines precision for + Quality Controls. By default, numbers in Quality Control + diagrams are presented as integers. + - Double nodes tolerance defines the maximal distance between two + mesh nodes, at which they are considered coincident by Double nodes + quality control. + +- Display mode + - Default display mode - allows to set Wireframe, Shading, Nodes or Shrink + presentation mode as default. + +- Representation of the 2D quadratic elements + - Default mode of the 2D quadratic elements combo-box - allows + to select lines or arcs for representation of quadratic elements as default. + - Maximum Angle - maximum deviation angle used by the + application to build arcs. + +- Mesh export + - If you toggle Automatically create groups for MED export check-box, + this operation will be carried out automatically. + +- Mesh computation + - Show a computation result notification combo-box allows to + select the notification mode about a mesh computation result. + There are 3 possible modes: + - Never - do not show the result dialog at all; + - Errors only - the result dialog will be shown if there were + some errors during a mesh computation; + - Always - show the result dialog after each mesh + computation. This is a default mode. + +- Mesh information + - Mesh element information - change the way mesh element + information is shown: + - Simple - as a plain text + - Tree - in a tree-like form + - Automatic nodes compute limit - 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. + - Automatic controls compute limit - 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, + 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. + - Show details on groups in element information tab - 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. + - Dump base information - allows dumping base mesh information to the + file, see \ref mesh_infos_page. + - Dump element information - allows dumping element information to the + file, see \ref mesh_infos_page. + - Dump additional information - allows dumping additional mesh + information to the file, see \ref mesh_infos_page. + - Dump controls information - allows dumping quality mesh + information to the file, see \ref mesh_infos_page. + +- Automatic Parameters + - Ratio Bounding Box Diagonal / Max Size - this parameter is + used for automatic meshing. This is the ratio between the bounding box of the + meshed object and the Max Size of segments. + - Default Number of Segments - defines the default + number of segments on each edge. + +- Mesh loading + - If No mesh loading from study file at hypothesis modification + 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. + +- Input fields precision + - Length precision - allows to adjust input precision of coordinates and dimensions. + - Angular precision - allows to adjust input precision of angles. + - Length tolerance precision - allows to adjust input precision of tolerance of coordinates and dimensions. + - Parametric precision - allows to adjust input precision of parametric values. + - Area precision - allows to adjust input precision of mesh element area. + - Volume precision - allows to adjust input precision of mesh element volume. + +- Preview + - Sub-shapes preview chunk size - allows to limit the number + of previewed sub-shapes shown in the hypotheses creation dialog boxes, + for example "Reverse Edges" parameter of \ref number_of_segments_anchor "Number of segments" hypothesis. + +- Python Dump + - Historical python dump checkbox allows switching between + \a Historical and \a Snapshot dump mode: + - In \a Historical mode, Python Dump script includes all commands + performed by SMESH engine. + - In \a Snapshot mode, the commands relating to objects removed + from the Study as well as the commands not influencing the + current state of meshes are excluded from the script.

Mesh Preferences

\image html pref22.png - +- Nodes 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. + - Color - allows to select the color of nodes. Click on the + colored line to access to the Select Color dialog box. + - Type of marker - allows to define the shape of nodes. + - Scale of marker - allows to define the size of nodes. + +- Elements 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. + - Surface color - allows to select the surface color of 2D elements + (seen in Shading mode). Click on the colored line to access to the + Select Color dialog box. + - Back surface color - allows to select the back surface color + of 2D elements. This is useful to differ 2d elements with + reversed orientation. Use the slider to select the color generated basing on + the Surface color by changing its brightness and saturation. + - Volume color - allows to select the surface color of 3D elements + (seen in Shading mode). + - Reversed volume color - allows to select the surface color + of reversed 3D elements. Use the slider to select the color generated basing on + the Volume color by changing its brightness and saturation. + - 0D element color - allows to choose color of 0D mesh elements. + - Ball color - allows to choose color of discrete mesh elements (balls). + - Outline color - allows to select the color of element + borders. + - Wireframe color - allows to select the color of borders of + elements in the wireframe mode. + - Preview color - allows to select the preview color of the elements. + - Size of 0D elements - specifies default size of 0D elements. + - Size of ball elements - specifies default size of discrete + elements (balls). + - Scale factor of ball elements - specifies default scale factor of discrete + elements (balls). + - Line width - allows to define the width of 1D elements (edges). + - Outline width - allows to define the width of borders of + 2D and 3D elements (shown in the Shading mode). + - Shrink coef. - allows to define relative space of elements + compared to gaps between them in shrink mode. + +- Groups + - Names color - specifies color of group names to be used in + 3D viewer. + - Default color - specifies the default group color, which is used + to create a new mesh group (see \ref creating_groups_page "Create Group dialog box"). + +- Numbering allows to define properties of numbering functionality: + - Nodes - specifies text properties of nodes numbering + (font family, size, attributes, color). + - Elements - same for elements. + +- Orientation of Faces - 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; + - 3D Vector check-box allows to choose between 2D planar + and 3D vectors.

Selection Preferences

\image html pref23.png - +- Selection - performed with mouse-indexing (preselection) + and left-clicking on an object, whose appearance changes as defined in + the Preferences. + - Object color - 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 Select Color dialog box. + - Element color - allows to select the color of surface of selected + elements (seen in Shading mode). Click on the colored line to access + to the Select Color dialog box. + +- Preselection - performed with mouse-indexing on an object, + whose appearance changes as defined in the Preferences. + - Highlight color - allows to select the color of mesh (edges and + borders of meshes) of the entity . Click on the colored line to access + to the Select Color dialog box. + +- Precision - in this menu you can set the value of precision + used for Nodes, Elements and Objects.

Scalar Bar Preferences

\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. + +- Font - in this menu you can set type, face and color for + the font of Title and Labels. + +- Colors & Labels - in this menu you can set the number of + colors and the number of labels in use. + +- Orientation - here you can choose between vertical and + horizontal orientation of the Scalar Bar + +- Origin & Size Vertical & Horizontal - allows to define + placement (X and Y) and lookout (Width and + Height) of Scalar Bars. + - X: abscissa of the point of origin (from the left + side) + - Y: ordinate of the origin of the bar (from the bottom) + +- Distribution in this menu you can Show/Hide distribution + histogram of the values of the Scalar Bar and specify the + Coloring Type of the histogram: + - Multicolor the histogram is colored as Scalar Bar + - Monocolor the histogram is colored as selected with + Distribution color selector */