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 - <b>Automatic Update</b>
13 - <b>Automatic Update</b> - if activated, the mesh in your
14 viewer will be automatically updated after it's computation, depending on
15 values of additional preferences specified below.
16 - <b>Size limit (elements)</b> - allows specifying the maximum
17 number of elements in the resulting mesh for which the automatic updating
18 of the presentation is performed. This option affects only
19 \ref compute_anchor "Compute" operation. Zero value means "no
20 limit". Default value is 500 000 mesh elements.
21 - <b>Incremental limit check</b> - if activated,
22 the mesh size limit check is not applied to the total number of
23 elements in the resulting mesh, it is applied iteratively to each entity type
24 in the following order: 0D elements, edges, faces, volumes, balls.
25 At each step the number of entities of a certain type is added to the
26 total number of elements computed at the previous step - if the resulting
27 number of elements does not exceed the size limit, the entities of
28 this type are shown, otherwise the user is warned that some entities are not shown.
30 - <b>Quality Controls</b>
31 - <b>Display entity</b> - if activated, only currently
32 \ref quality_page "controlled" entities are displayed in the
33 viewer and other entities are temporarily hidden. For example if you
34 activate \ref length_page "Length" quality control, which controls
35 the length of mesh segments, then only mesh segments are
36 displayed and faces and volumes are hidden.
37 - <b>Use precision</b> - if activated, all quality controls
38 will be computed at precision defined by <b>Number of digits after
39 point</b> - as integers by default.
40 - <b>Double nodes tolerance</b> - defines the maximal distance between two
41 mesh nodes, at which they are considered coincident by
42 \ref double_nodes_control_page "Double nodes" quality control.
45 - <b>Default display mode</b> - allows to set Wireframe, Shading, Nodes or Shrink
46 \ref display_mode_page "presentation mode" as default.
48 \anchor quadratic_2d_mode_pref
49 - <b>Representation of the 2D quadratic elements</b>
50 - <b>Default mode of the 2D quadratic elements</b> - allows to
51 select either \a Lines or \a Arcs as a default
52 \ref quadratic_2d_mode "representation" of 1D and 2D
53 \ref adding_quadratic_elements_page "quadratic elements".
54 - <b>Maximum Angle</b> - maximum deviation angle used by the
55 application to build arcs.
58 \anchor export_auto_groups_pref
59 - <b>Automatically create groups for MED export</b> - defines a
60 default state of a corresponding check-box in \ref export_auto_groups
62 \anchor group_export_warning_pref
63 - <b>Show warning when exporting group</b> - if activated, a warning is
64 displayed when exporting a group.
66 - <b>Mesh computation</b>
67 - <b>Show a computation result notification</b> combo-box allows to
68 select the notification mode about a mesh computation result.
69 There are 3 possible modes:
70 - <b>Never</b> - do not show the result dialog at all;
71 - <b>Errors only</b> - the result dialog will be shown if there were
72 some errors during a mesh computation;
73 - <b>Always</b> - show the result dialog after each mesh
74 computation. This is a default mode.
76 - <b>Mesh information</b>
77 - <b>Mesh element information</b> - change the way mesh element
79 - <b>Simple</b> - as a plain text
80 - <b>Tree</b> - in a tree-like form
81 - <b>Automatic nodes compute limit</b> - allows defining the size limit for the
82 mesh groups for which the number of underlying nodes is calculated
83 automatically. If the group size exceeds the value set in the preferences,
84 the user will have to press \em Compute button explicitly. Zero value
85 means "no limit". By default the value is set to 100 000 mesh elements.
86 - <b>Automatic controls compute limit</b> - allows defining the size limit for the
87 mesh elements for which the Aspect Ratio histogram is calculated
88 automatically. If the mesh elements size exceeds the value set in the preferences,
89 it is possible to press \b Compute button explicitly to calculate the histogram . Zero value
90 means "no limit". By default the value is set to 3 000 mesh elements.
91 - <b>Show details on groups in element information tab</b> - when
92 this option is switched off (default), only the names of groups, to which the node
93 or element belongs, are shown in the \ref mesh_element_info_anchor "Info Tab"
94 tab of "Mesh Information" dialog box. If this option is
95 switched on, the detailed information on groups is shown.
96 - <b>Dump base information</b> - allows dumping base mesh information to the
97 file, see \ref mesh_infos_page.
98 - <b>Dump element information</b> - allows dumping element information to the
99 file, see \ref mesh_infos_page.
100 - <b>Dump additional information</b> - allows dumping additional mesh
101 information to the file, see \ref mesh_infos_page.
102 - <b>Dump controls information</b> - allows dumping quality mesh
103 information to the file, see \ref mesh_infos_page.
105 - <b>Automatic Parameters</b>
106 - <b>Ratio Bounding Box Diagonal / Max Size</b> - this parameter is
107 used for automatic meshing. This is the ratio between the bounding box of the
108 meshed object and the Max Size of segments.
109 - <b>Default Number of Segments</b> - defines the default
110 number of segments on each edge.
112 - <b>Mesh loading</b>
113 - If <b>No mesh loading from study file at hypothesis modification</b>
114 check-box is on, the mesh data will not be loaded from the study file
115 when a hypothesis is modified. This allows saving time by omitting
116 loading data of a large mesh that is planned to be recomputed with other parameters.
118 - <b>Input fields precision</b>
119 - <b>Length precision</b> - allows to adjust input precision of coordinates and dimensions.
120 - <b>Angular precision</b> - allows to adjust input precision of angles.
121 - <b>Length tolerance precision</b> - allows to adjust input precision of tolerance of coordinates and dimensions.
122 - <b>Parametric precision</b> - allows to adjust input precision of parametric values.
123 - <b>Area precision</b> - allows to adjust input precision of mesh element area.
124 - <b>Volume precision</b> - allows to adjust input precision of mesh element volume.
127 - <b>Sub-shapes preview chunk size</b> - allows to limit the number
128 of previewed sub-shapes shown in the hypotheses creation dialog boxes,
129 for example "Reverse Edges" parameter of \ref number_of_segments_anchor "Number of segments" hypothesis.
132 - <b>Historical python dump</b> checkbox allows switching between
133 \a Historical and \a Snapshot dump mode:
134 - In \a Historical mode, Python Dump script includes all commands
135 performed by SMESH engine.
136 - In \a Snapshot mode, the commands relating to objects removed
137 from the Study as well as the commands not influencing the
138 current state of meshes are excluded from the script.
140 <h2>Mesh Preferences</h2>
142 \image html pref22.png
144 - <b>Nodes</b> allows to define default parameters for nodes, which will be applied
145 for a newly created mesh only. Existing meshes can be customized using
146 \ref colors_size_page "Properties dialog box" available from the context menu of a mesh.
147 - <b>Color</b> - allows to select the color of nodes. Click on the
148 colored line to access to the <b>Select Color</b> dialog box.
149 - <b>Type of marker</b> - allows to define the shape of nodes.
150 - <b>Scale of marker</b> - allows to define the size of nodes.
152 - <b>Elements</b> allows to define default parameters for different elements, which will be applied
153 for a newly created mesh only. Existing meshes can be customized using
154 \ref colors_size_page "Properties dialog box" available from the context menu of a mesh.
155 - <b>Surface color</b> - allows to select the surface color of 2D elements
156 (seen in Shading mode). Click on the colored line to access to the
157 <b>Select Color</b> dialog box.
158 - <b>Back surface color</b> - allows to select the back surface color
159 of 2D elements. This is useful to differ 2d elements with
160 reversed orientation. Use the slider to select the color generated basing on
161 the <b>Surface color</b> by changing its brightness and saturation.
162 - <b>Volume color</b> - allows to select the surface color of 3D elements
163 (seen in Shading mode).
164 - <b>Reversed volume color</b> - allows to select the surface color
165 of reversed 3D elements. Use the slider to select the color generated basing on
166 the <b>Volume color</b> by changing its brightness and saturation.
167 - <b>0D element color</b> - allows to choose color of 0D mesh elements.
168 - <b>Ball color</b> - allows to choose color of discrete mesh elements (balls).
169 - <b>Outline color</b> - allows to select the color of element
171 - <b>Wireframe color</b> - allows to select the color of borders of
172 elements in the wireframe mode.
173 - <b>Preview color</b> - allows to select the preview color of the elements.
174 - <b>Size of 0D elements</b> - specifies default size of 0D elements.
175 - <b>Size of ball elements</b> - specifies default size of discrete
177 - <b>Scale factor of ball elements</b> - specifies default scale factor of discrete
179 - <b>Line width</b> - allows to define the width of 1D elements (edges).
180 - <b>Outline width</b> - allows to define the width of borders of
181 2D and 3D elements (shown in the Shading mode).
182 - <b>Shrink coef.</b> - allows to define relative space of elements
183 compared to gaps between them in shrink mode.
186 - <b>Names color</b> - specifies color of group names to be used in
188 - <b>Default color</b> - specifies the default group color, which is used
189 to create a new mesh group (see \ref creating_groups_page "Create Group dialog box").
191 - <b>Numbering</b> allows to define properties of numbering functionality:
192 - <b>Nodes</b> - specifies text properties of nodes numbering
193 (font family, size, attributes, color).
194 - <b>Elements</b> - same for elements.
196 - <b>Orientation of Faces</b> - allows to define default properties of orientation vectors.
197 These preferences will be applied to the newly created meshes only; properties of existing meshes
198 can be customized using \ref colors_size_page "Properties dialog box"
199 available from the context menu of a mesh.
200 - \b Color - allows to define the color of orientation vectors;
201 - \b Scale - allows to define the size of orientation vectors;
202 - <b>3D Vector</b> check-box allows to choose between 2D planar
205 <br><h2>Selection Preferences</h2>
207 \image html pref23.png
209 - <b>Selection</b> - performed with mouse-indexing (preselection)
210 and left-clicking on an object, whose appearance changes as defined in
211 the <b>Preferences</b>.
212 - <b>Object color</b> - allows to select the color of mesh (edges and
213 borders of meshes) of the selected entity. Click on the colored line
214 to access to the <b>Select Color</b> dialog box.
215 - <b>Element color</b> - allows to select the color of surface of selected
216 elements (seen in Shading mode). Click on the colored line to access
217 to the <b>Select Color</b> dialog box.
219 - <b>Preselection</b> - performed with mouse-indexing on an object,
220 whose appearance changes as defined in the <b>Preferences</b>.
221 - <b>Highlight color</b> - allows to select the color of mesh (edges and
222 borders of meshes) of the entity . Click on the colored line to access
223 to the <b>Select Color</b> dialog box.
225 - <b>Precision</b> - in this menu you can set the value of precision
226 used for <b>Nodes</b>, <b>Elements</b> and <b>Objects</b>.
228 <br><h2>Scalar Bar Preferences</h2>
230 \image html pref24.png
232 \note The following settings are default and will be applied for
233 a newly created mesh only. Existing meshes
234 can be customized using local \ref scalar_bar_dlg "Scalar Bar Properties dialog box"
235 available from the context menu of a mesh.
237 - <b>Font</b> - in this menu you can set type, face and color for
238 the font of <b>Title</b> and <b>Labels</b>.
240 - <b>Colors & Labels</b> - in this menu you can set the <b>number of
241 colors</b> and the <b>number of labels</b> in use.
243 - <b>Orientation</b> - here you can choose between vertical and
244 horizontal orientation of the <b>Scalar Bar</b>
246 - <b>Origin & Size Vertical & Horizontal</b> - allows to define
247 placement (<b>X</b> and <b>Y</b>) and lookout (<b>Width</b> and
248 <b>Height</b>) of Scalar Bars.
249 - <b>X</b>: abscissa of the point of origin (from the left
251 - <b>Y</b>: ordinate of the origin of the bar (from the bottom)
253 - <b>Distribution</b> in this menu you can Show/Hide distribution
254 histogram of the values of the <b>Scalar Bar</b> and specify the
255 <b>Coloring Type</b> of the histogram:
256 - <b>Multicolor</b> the histogram is colored as <b>Scalar Bar</b>
257 - <b>Monocolor</b> the histogram is colored as selected with
258 <b>Distribution color</b> selector