Salome HOME
23615: EDF 17317 - Fit All when display one mesh
[modules/smesh.git] / doc / salome / gui / SMESH / input / viewing_meshes_overview.rst
1 .. _viewing_meshes_overview_page: 
2
3 **************
4 Viewing meshes
5 **************
6
7 By default a just :ref:`computed <compute_anchor>` mesh will be
8 automatically displayed in the **VTK 3D Viewer**. (You can switch
9 off :ref:`Automatic Update <automatic_update_pref>` preference parameter
10 to prevent this.)
11 Click **Display only** to hide all other objects at the same time.
12
13 **VTK 3D Viewer** is described in detail in the documentation on **GUI module**.
14
15 Use the following :ref:`preference parameters <mesh_preferences_page>` 
16 to adjust how the mesh is displayed by default:
17
18 * :ref:`Automatic Update <automatic_update_pref>` 
19 * :ref:`Default display mode <display_mode_pref>` 
20 * :ref:`Representation of the 2D quadratic elements <quadratic_2d_mode_pref>` 
21 * All parameters of :ref:`Mesh <mesh_tab_preferences>` tab page of Preferences dialog.
22
23 After the mesh has appeared in the Viewer, you can select it with
24 left mouse click and  get information about it, change its
25 presentation parameters and access to other useful options by
26 right-clicking on the selected mesh.
27
28 .. image:: ../images/dialog.png
29         :align: center
30
31
32 * **Rename** - allows to rename the object in the Object browser.
33 * **Hide all** - allows to hide all objects in the viewer.
34 * **Update** - refreshes the presentation of your mesh in the Object Browser, applying all recent changes. 
35 * :ref:`Mesh Information <mesh_infos_page>` -  provides information about the mesh.
36 * :ref:`Find Element by Point <find_element_by_point_page>` - allows to find all mesh elements, to which belongs a point with the given coordinates.
37 * **Auto Color** - switch on / off auto-assigning colors for the groups. If switched on, a default color of a new group in :ref:`Create Group <creating_groups_page>` dialog is chosen randomly. 
38 * :ref:`Numbering <numbering_page>` - allows to display the ID numbers of all meshing elements or nodes composing your mesh in the viewer.
39 * :ref:`Display Mode <display_mode_page>` - allows to select between Wireframe, Shading and Nodes presentation.
40 * :ref:`Display Entity <display_entity_page>` - allows to display entities by types (Faces, Edges, Volumes etc.).
41
42 .. _quadratic_2d_mode:
43
44 * **2D Quadratic** - allows to select between the representation of quadratic edges as broken **lines** or as **arcs**. A default representation can be set in :ref:`Preferences <quadratic_2d_mode_pref>`. Arc representation applies to 1D and 2D elements only.
45 * **Orientation of faces** - shows vectors of orientation of faces of the selected mesh. The orientation vector is shown for each 2D mesh element and for each free facet of a 3D mesh element. The vector direction is calculated by the first three nodes of the face produced by vectors n1-n2 and n1-n3.
46 * :ref:`Properties <colors_size_page>` - allows to define several visual properties, including color of elements, shrink size, ...
47 * :ref:`Transparency <transparency_page>` - allows to change the transparency of mesh elements.
48 * :ref:`Controls <quality_page>` - graphically presents various information about the mesh. 
49 * **Hide** - allows to hide the selected mesh from the viewer.
50 * **Show Only** - allows to display only the selected mesh, hiding all others from the viewer. If :ref:`Fit All upon Show Only <display_mode_pref>` Preference option is active, *Fit All* command is additionally performed.
51 * :doc:`clipping` - allows to create cross-sections of the displayed objects.
52 * **Dump view** - exports an object from the viewer in bmp, png or jpeg image format.
53 * **Change background** - allows to redefine the background color. By default it is black.
54 * **View Operations** - allows to show/hide the  visualization toolbar in the Viewer window.
55 * **Recording Operations** - allows to show/hide the recording toolbar in the Viewer window.
56
57 **Table of Contents**
58
59 .. toctree::
60    :maxdepth: 2
61    :titlesonly:
62
63    mesh_infos.rst
64    find_element_by_point.rst
65    numbering.rst
66    display_mode.rst
67    display_entity.rst
68    colors_size.rst
69    transparency.rst
70    clipping.rst