Salome HOME
Synchronize adm files
[modules/gui.git] / doc / salome / gui / input / salome_desktop.doc
1 /*!
2
3 \page salome_desktop_page SALOME desktop
4
5 <b>Multi-Desktop Approach</b> used in Salome means that there is a separate Desktop
6 for each Study and all windows connected to the same Study (viewers, dockable
7 windows, etc.) are placed in one container. 
8 This approach positively differs from the classic multi document interface 
9 if many windows are used, i.e. when one document contains a lot of
10 viewers, dialogs, etc. Each desktop also has its own menu and toolbar.
11
12 The main SALOME Desktop consists of the following sections and toolbars:
13
14 \image html desktop.png
15
16
17 <b>Basic parts of the SALOME Desktop:</b>
18 <ul>
19 <li><b>Main menu</b> - This is a set of context-sensitive menus, which will
20 be updated according to the functionality of the currently active component. In
21 general, these menus contain all functional options of SALOME platform.</li>
22 <li><b>Standard toolbar</b> - contains standard actions
23 that allow creating new or opening existing study, saving study, deleting
24 objects etc.</li>
25 <li><b>Components toolbar</b> - allows activating
26 components in SALOME platform.</li>
27 <li><b>Module toolbars</b> - contains actions specific to the
28 currently active module.</li>
29 <li><b>Viewer toolbar</b> - provides a set of tools destined for visualization
30 of the presentations in the viewer.</li>
31 </ul>
32
33
34 All toolbars in the \b SALOME Platform are context-sensitive. Loading of a definite component
35 (Geometry, Mesh etc.) will automatically add some additional
36 toolbars specific to this component. To display/hide a toolbar, in the main menu choose <b>View > Toolbars</b>, and from this submenu check or uncheck the toolbar that you would like to display/hide.
37
38 By default all toolbars are located on top of the SALOME desktop, but you can relocate a toolbar by dragging it with the mouse and dropping in any place of the window.
39
40 <b>Parts of  the study window:</b>
41 <ul>
42 <li><b>Object browser</b> - Management of objects created or imported into
43 SALOME application.</li>
44 <li>\b Viewer - This window is destined for visualization of
45 presentations.</li>
46 <li><b>Python console</b> - Window for Python interpreter. This window
47 functions like a standard document: the pop-up menu invoked by
48 right-click in this window gives access to
49 <b>Copy/Paste/SelectAll/ClearAll</b> options.</li>
50 </ul>
51
52 Object Browser, Python Console, MenuBar, etc are, in fact, separate dockable windows.
53 Dockable windows can be placed in special areas, on the borders of
54 desktop like toolbars. You can change the size and the position of
55 dockable windows, hide them or even place outside desktop. SALOME
56 saves in the same file all positions and sizes of dockable windows. It
57 means that the difference in settings of the same windows (for example
58 Python console) is possible between different modules (the same window
59 can have different size and position when other module is
60 activated). Also each module can indicate which common windows are
61 necessary for working, and only they will be displayed when this
62 module is active.
63
64 All parts of Salome desktop and study window can be managed through \b View menu.
65
66 \image html viewmenu.png
67
68 <ul>
69 <li>\b Toolbars - allows to show and hide toolbars</li>
70 <li>\b Windows - allows to show and hide dockable windows, such as
71 Object Browser and Python Console</li>
72 <li><b> Status Bar </b> allows showing and hiding the Status Bar.</li>
73 <li>\ref themes_page "Theme" - allows to select and edit the style (colors and fonts) for Salome session.</li>
74 </ul>
75
76 If there are several viewer windows in your current study and you want to display more then one at the same time, you can use the functionalities provided by the \b Window menu.
77
78 \image html windowmenu.png
79
80 <ul>
81 <li><b>New window </b> - allows to open a new instance of any viewer.</li> 
82 <li><b>Close</b> - closes the currently active viewer window.</li> 
83 <li><b>Close all</b> - closes all viewer windows.</li>
84 <li><b>Group all</b> - arranges all created viewer windows on the same desktop</li>
85 <li><b>Arrange Views</b> - allows choosing the necessary views and their layout.
86
87 \image html arrange_views_dlg.png
88
89 - The radio-buttons in <b>Views Layout</b> section allow choosing the number of views to be arranged (2, 3 or 4). The buttons with images allow choosing the view layout (depending on the chosen number of views). 
90 - <b>Views List</b>  contains the list of opened view windows, where it is possible to check in the necessary views. 
91 - <b>Close the remaining views</b> check-box allows closing all non-selected views.    
92 - <b>Stack the remaining views</b> check-box allows stacking all non-selected views in the last tab area.
93       
94 <li><b>Split Vertically</b> and <b>Split Horizontally</b> allow splitting 
95 the representation area into two parts, in horizontal or vertical direction.</li>
96 <li>List of all opened viewer windows provides fast access to them.</li>
97 <li>\b Rename - allows renaming the currently selected viewer window. </li>
98 </ul>
99
100
101
102 */