3 \page mesh_preferences_page Mesh preferences
5 In the Mesh module you can set mesh preferences, which can be used right now
6 or in later sessions with this module according to the preferences.
8 <h2>General Preferences</h2>
10 \image html pref21.png
12 \anchor automatic_update_pref
13 - <b>Automatic Update</b>
14 - <b>Automatic Update</b> - if activated, the mesh in your
15 viewer will be automatically updated after it's computation, depending on
16 values of additional preferences specified below.
17 - <b>Size limit (elements)</b> - allows specifying the maximum
18 number of elements in the resulting mesh for which the automatic updating
19 of the presentation is performed. This option affects only
20 \ref compute_anchor "Compute" operation. Zero value means "no
21 limit". Default value is 500 000 mesh elements.
22 - <b>Incremental limit check</b> - if activated,
23 the mesh size limit check is not applied to the total number of
24 elements in the resulting mesh, it is applied iteratively to each entity type
25 in the following order: 0D elements, edges, faces, volumes, balls.
26 At each step the number of entities of a certain type is added to the
27 total number of elements computed at the previous step - if the resulting
28 number of elements does not exceed the size limit, the entities of
29 this type are shown, otherwise the user is warned that some entities are not shown.
31 \anchor display_mode_pref
33 - <b>Default display mode</b> - allows to set Wireframe, Shading, Nodes or Shrink
34 \ref display_mode_page "presentation mode" as default.
36 \anchor quadratic_2d_mode_pref
37 - <b>Representation of the 2D quadratic elements</b>
38 - <b>Default mode of the 2D quadratic elements</b> - allows to
39 select either \a Lines or \a Arcs as a default
40 \ref quadratic_2d_mode "representation" of 1D and 2D
41 \ref adding_quadratic_elements_page "quadratic elements".
42 - <b>Maximum Angle</b> - maximum deviation angle used by the
43 application to build arcs.
45 - <b>Quality Controls</b>
46 - <b>Display entity</b> - if activated, only currently
47 \ref quality_page "controlled" entities are displayed in the
48 viewer and other entities are temporarily hidden. For example if you
49 activate \ref length_page "Length" quality control, which controls
50 the length of mesh segments, then only mesh segments are
51 displayed and faces and volumes are hidden.
52 - <b>Use precision</b> - if activated, all quality controls
53 will be computed at precision defined by <b>Number of digits after
54 point</b> - as integers by default.
55 \anchor dbl_nodes_tol_pref
56 - <b>Double nodes tolerance</b> - defines the maximal distance between two
57 mesh nodes, at which they are considered coincident by
58 \ref double_nodes_control_page "Double nodes" quality control.
59 This value is also used in \ref mesh_quality_info_anchor "Quality Info"
60 tab page of \ref mesh_infos_page dialog.
63 \anchor export_auto_groups_pref
64 - <b>Automatically create groups for MED export</b> - defines a
65 default state of a corresponding check-box in \ref export_auto_groups
67 \anchor group_export_warning_pref
68 - <b>Show warning when exporting group</b> - if activated, a warning is
69 displayed when exporting a group.
71 \anchor show_comp_result_pref
72 - <b>Mesh computation</b>
73 - <b>Show a computation result notification</b> - allows to
74 select the notification mode about a \ref compute_anchor "mesh computation" result.
75 There are 3 possible modes:
76 - <b>Never</b> - not to show the \ref meshing_result_anchor "result dialog" at all;
77 - <b>Errors only</b> - the result dialog will be shown if there were
78 some errors during a mesh computation;
79 - <b>Always</b> - show the result dialog after each mesh
80 computation. This is a default mode.
82 \anchor mesh_information_pref
83 - <b>Mesh information</b>
84 - <b>Mesh element information</b> - allows changing the way
85 \ref mesh_element_info_anchor "mesh element information" is shown:
86 - <b>Simple</b> - as a plain text
87 - <b>Tree</b> - in a tree-like form
88 \anchor nb_nodes_limit_pref
89 - <b>Automatic nodes compute limit</b> - allows defining the size limit for the
90 \ref mesh_addition_info_group_anchor "mesh groups" for which
91 the number of underlying nodes is calculated
92 automatically. If the group size exceeds the value set in the preferences,
93 the user will have to press \em Compute button explicitly. Zero value
94 means "no limit". By default the value is set to 100 000 mesh elements.
95 \anchor auto_control_limit_pref
96 - <b>Automatic controls compute limit</b> - allows defining a
97 maximal number of mesh elements for which the quality controls
98 in the \ref mesh_quality_info_anchor "Quality Information"
99 tab page are calculated automatically. If the number of mesh elements
100 exceeds the value set in the preferences, it is necessary to press
101 \b Compute button explicitly to calculate a quality measure. Zero value
102 means "no limit". By default the value is set to 3 000 mesh
104 \anchor group_detail_info_pref
105 - <b>Show details on groups in element information tab</b> - when
106 this option is switched off (default), only the names of groups, to which the node
107 or element belongs, are shown in the \ref mesh_element_info_anchor "Element Info"
108 tab of "Mesh Information" dialog box. If this option is
109 switched on, the detailed information on groups is shown.
110 - <b>Dump base information</b> - allows dumping base mesh information to the
111 file, see \ref dump_mesh_infos "Mesh Information".
112 - <b>Dump element information</b> - allows dumping element information to the
113 file, see \ref dump_mesh_infos "Mesh Information".
114 - <b>Dump additional information</b> - allows dumping additional mesh
115 information to the file, see \ref dump_mesh_infos "Mesh Information".
116 - <b>Dump controls information</b> - allows dumping quality mesh
117 information to the file, see \ref dump_mesh_infos "Mesh Information".
119 - <b>Automatic Parameters</b>
120 \anchor diagonal_size_ratio_pref
121 - <b>Ratio Bounding Box Diagonal / Max Size</b> - defines the ratio
122 between the bounding box of the meshed object and the Max Size of
123 segments. It is used as a default value of \ref a1d_meshing_hypo_page
124 defining length of segments, especially by
125 \ref max_length_anchor "Max Size" hypothesis.
126 \anchor nb_segments_pref
127 - <b>Default Number of Segments</b> - defines the default number of
128 segments in \ref number_of_segments_anchor "Number of Segments"
131 - <b>Mesh loading</b>
132 - <b>No mesh loading from study file at hypothesis modification</b> - if
133 activated, the mesh data will not be loaded from the study file
134 when a hypothesis is modified. This allows saving time by omitting
135 loading data of a large mesh that is planned to be recomputed with other parameters.
137 - <b>Input fields precision</b> - allows to adjust input precision of
138 different parameters. The semantics of the precision values is
139 described in detail in <em>Using input widgets</em> chapter of GUI
140 documentation (Introduction to Salome Platform / Introduction to GUI /
141 Using input widgets). In brief: \b positive precision value is the
142 maximum allowed number of digits after the decimal point in the
143 fixed-point format; \b nagative precision value is the maximum
144 allowed number of significant digits in mantissa in either the
145 fixed-point or scientific format.
146 - <b>Length precision</b> - allows to adjust input precision of coordinates and dimensions.
147 - <b>Angular precision</b> - allows to adjust input precision of angles.
148 - <b>Length tolerance precision</b> - allows to adjust input precision of tolerance of coordinates and dimensions.
149 - <b>Parametric precision</b> - allows to adjust input precision of parametric values.
150 - <b>Area precision</b> - allows to adjust input precision of mesh element area.
151 - <b>Volume precision</b> - allows to adjust input precision of mesh element volume.
154 - <b>Sub-shapes preview chunk size</b> - allows to limit the number
155 of previewed sub-shapes shown in the hypotheses creation dialog boxes,
156 for example "Reverse Edges" parameter of
157 \ref number_of_segments_anchor "Number of segments" hypothesis.
160 - <b>Historical python dump</b> - allows switching between
161 \a Historical and \a Snapshot dump mode:
162 - In \a Historical mode, Python Dump script includes all commands
163 performed by SMESH engine.
164 - In \a Snapshot mode, the commands relating to objects removed
165 from the Study as well as the commands not influencing the
166 current state of meshes are excluded from the script.
168 \anchor mesh_tab_preferences
169 <h2>Mesh Preferences</h2>
171 \b Mesh tab page contains parameters defining the way the mesh is
172 displayed in the 3D Viewer.
174 \image html pref22.png
176 - <b>Nodes</b> - allows to define default parameters for nodes, which will be applied
177 for a newly created mesh only. Existing meshes can be customized using
178 \ref colors_size_page "Properties dialog box" available from the context menu of a mesh.
179 - <b>Color</b> - allows to select the color of nodes. Click on the
180 downward arrow near the colored line to access to the <b>Select Color</b> dialog box.
181 - <b>Type of marker</b> - allows to define the shape of nodes.
182 - <b>Scale of marker</b> - allows to define the size of nodes.
184 - <b>Elements</b> - allows to define default parameters for different
185 elements, which will be applied to a newly created mesh
186 only. Existing meshes can be customized using
187 \ref colors_size_page "Properties dialog box" available from the context menu of a mesh.
188 - <b>Surface color</b> - allows to select the surface color of 2D elements
189 (seen in Shading mode). Click on the downward arrow near the colored line to access to the
190 <b>Select Color</b> dialog box.
191 - <b>Back surface color</b> - allows to select the back surface color
192 of 2D elements. This is useful to differ 2d elements with
193 reversed orientation. Use the slider to select the color generated basing on
194 the <b>Surface color</b> by changing its brightness and saturation.
195 - <b>Volume color</b> - allows to select the surface color of 3D elements
196 (seen in Shading mode).
197 - <b>Reversed volume color</b> - allows to select the surface color
198 of reversed 3D elements. Use the slider to select the color generated basing on
199 the <b>Volume color</b> by changing its brightness and saturation.
200 - <b>0D element color</b> - allows to choose color of 0D mesh elements.
201 - <b>Ball color</b> - allows to choose color of discrete mesh elements (balls).
202 - <b>Outline color</b> - allows to select the color of element borders.
203 - <b>Wireframe color</b> - allows to select the color of borders of
204 elements in the wireframe mode.
205 - <b>Preview color</b> - allows to select the preview color of the
206 elements, which is used while
207 \ref adding_nodes_and_elements_page "manual creation of elements".
208 - <b>Size of 0D elements</b> - specifies default size of 0D elements.
209 - <b>Size of ball elements</b> - specifies default size of discrete
211 - <b>Scale factor of ball elements</b> - specifies default scale
212 factor of discrete elements (balls) allowing to adjust their size in the Viewer.
213 - <b>Line width</b> - allows to define the width of 1D elements (segments).
214 - <b>Outline width</b> - allows to define the width of borders of
215 2D and 3D elements (shown in the Shading mode).
216 - <b>Shrink coef.</b> - allows to define relative size of a shrunk
217 element compared a non-shrunk element in percents in the shrink mode.
220 - <b>Names color</b> - specifies color of group names to be used in
222 - <b>Default color</b> - specifies the default group color, which is used
223 to create a new mesh group (see \ref creating_groups_page "Create Group dialog box").
225 - <b>Numbering</b> allows to define properties of numbering functionality:
226 - <b>Nodes</b> - specifies text properties of nodes numbering
227 (font family, size, attributes, color).
228 - <b>Elements</b> - same for elements.
230 - <b>Orientation of Faces</b> - allows to define default properties of
231 orientation vectors. These preferences will be applied to the newly
232 created meshes only; properties of existing meshes can be customized
233 using \ref colors_size_page "Properties dialog box" available from
234 the context menu of a mesh.
235 - \b Color - allows to define the color of orientation vectors;
236 - \b Scale - allows to define the size of orientation vectors;
237 - <b>3D Vector</b> - allows to choose between 2D planar
240 <br><h2>Selection Preferences</h2>
242 \image html pref23.png
244 - <b>Selection</b> - performed with mouse-indexing (preselection)
245 and left-clicking on an object, whose appearance changes as defined in
246 the <b>Preferences</b>.
247 - <b>Object color</b> - allows to select the color of mesh (edges and
248 borders of meshes) of the selected entity. Click on the colored line
249 to access to the <b>Select Color</b> dialog box.
250 - <b>Element color</b> - allows to select the color of surface of selected
251 elements (seen in Shading mode). Click on the colored line to access
252 to the <b>Select Color</b> dialog box.
254 - <b>Preselection</b> - performed with mouse-indexing on an object,
255 whose appearance changes as defined in the <b>Preferences</b>.
256 - <b>Highlight color</b> - allows to select the color of mesh (edges and
257 borders of meshes) of the entity. Click on the colored line to access
258 to the <b>Select Color</b> dialog box.
260 - <b>Precision</b> - in this menu you can set the value of precision
261 used for <b>Nodes</b>, <b>Elements</b> and <b>Objects</b>.
263 <br><h2>Scalar Bar Preferences</h2>
265 \image html pref24.png
267 \note The following settings are default and will be applied to
268 a newly created mesh only. Existing meshes can be customized using
269 local \ref scalar_bar_dlg "Scalar Bar Properties dialog box" available
270 from the context menu of a mesh.
272 - <b>Font</b> - in this menu you can set type, face and color of
273 the font of <b>Title</b> and <b>Labels</b>.
275 - <b>Colors & Labels</b> - in this menu you can set the <b>number of
276 colors</b> and the <b>number of labels</b> in use.
278 - <b>Orientation</b> - here you can choose between vertical and
279 horizontal orientation of the <b>Scalar Bar</b>.
281 - <b>Origin & Size Vertical & Horizontal</b> - allows to define
282 placement (<b>X</b> and <b>Y</b>) and lookout (<b>Width</b> and
283 <b>Height</b>) of Scalar Bars.
284 - <b>X</b> - abscissa of the point of origin (from the left side).
285 - <b>Y</b> - ordinate of the origin of the bar (from the bottom).
287 - <b>Distribution</b> in this menu you can Show/Hide distribution
288 histogram of the values of the <b>Scalar Bar</b> and specify the
289 <b>Coloring Type</b> of the histogram:
290 - <b>Multicolor</b> - the histogram is colored as <b>Scalar Bar</b>.
291 - <b>Monocolor</b> - the histogram is colored as selected with
292 <b>Distribution color</b> selector.