/*!

\page view_geom_obj_page Viewing geometrical objects

Newly created geometrical objects are automatically displayed in
the <b>OCC 3D Viewer</b>.

<b>OCC 3D Viewer</b> is described in the documentation on <b>GUI
module</b>.

After the object has appeared in the Viewer, you can select it with
left mouse click to change its presentation parameters and access to
other useful options by right-clicking on the selected object.

\image html dialog.png

<ul>
<li><b>Rename</b> - allows to change the name of the geometric
object.</li>
<li><b>Delete</b> - irreversibly deletes the selected object from the
viewer and from the Object Browser.</li> 
<li>\subpage display_mode_page "Display Mode" - allows to select between
Wireframe and Shading presentation.</li>
<li>\subpage bring_to_front_page "Bring To Front" - allows to bring to 
front of the viewer the selected geometrical object.</li>
<li><b>Clear Top Level State</b> - allows to remove from the viewer foreground 
geometrical objects that have been placed there via <b>Bring To Front</b> command.</li>
<li>\subpage color_page "Color" - allows to change the filling color in
the standard <b>Select Color</b> menu.</li>
<li>\subpage transparency_page "Transparency" - allows to change the
transparency of geometrical objects.</li>
<li>\subpage isolines_page "Isos" - allows to change the number of
isolines displayed within a shape.</li>
<li>\subpage deflection_page "Deflection" - allows to change the
deflection coefficient of a shape.</li>
<li>\subpage material_page "Material" - allows to change the
material properties of a shape.</li>
<li>\subpage point_marker_page "Point Marker" - allows to change the
representation of geometrical vertices.</li>
<li>\subpage line_width_page "Line Width" - allows to change the
width of edges and isolines.</li>
<li><b>Auto color</b> / <b>Disable auto color</b> - activates the auto color
mode. When the auto color mode is enabled, the groups created on the
sub-shapes of the selected geometrical object are automatically
coloured by the unique colors. TUI Commands :
<em>go.SetAutoColor(enable)</em>, <em>enabled = go.GetAutoColor()</em></li>
<li><b>Hide</b> - allows to hide the selected geometrical object from the
viewer. TUI Command : <em>sg.EraseOnly(ID)</em></li>

\image html image18.png

<li><b>Hide all</b> - hides all objects from the viewer. TUI
Command: <em>sg.EraseAll()</em></li>

\image html image26.png

<li><b>Show Only</b> - displays only the selected
geometrical object. TUI Command: <em>sg.DisplayOnly(ID)</em></li>

\image html image33.png

<li><b>Dump view</b> - exports an object from the viewer in bmp, png,
jpg or jpeg image format.</li>
<li><b>Change background</b> - allows to redefine the background
color. By default it is black.</li>
</ul>

Some of these functionalities are available through right-clicking
on the viewer background:

\image html image22.png <br>

<ul>
<li><b>Select Only</b> provides a filter for exclusive selection of objects of a certain type.</li>
</ul>

The following commands appear in the Object Browser context menu
under certain conditions:

\image html ob_popup_menu.png <br>

<ul>
<li>\ref work_with_groups_page "Create Group" - allows creating groups of geometrical objects.</li>

<li><b>Conceal child items</b> / <b>Disclose child items</b> - hides / shows child
sub-objects in the Object Browser, if the selected geometric object has
child objects. When some child objects are hidden, the name of the
parent object is hilghlighted with bold font.</li>

<li><b>Show Only Children</b> - erases from the current viewer all objects
and then displays only the children of the selected object(s).
</li>

<li><b>Unpublish</b> - unpublishes the selected geometric object from the Object Browser 
  and erase it from all viewers. To publish unpublished geometric objects select in the 
  context menu of the <b>Geometry</b> root object <b>Publish...</b> item. 
  The following dialog box will appear

  \image html publish_dlg.png <br>

  Switch the checkbox near the appropriate object and
  click <b>Publish</b> or <b>Publish And Close</b> button. 

  "Eye" icons in this dialog box allow previewing unpublished objects in the viewer. All 
  unpublished objects are by default sorted by the name in ascending order. It is possible
  to change order of sorting (ascending / descending) by clicking the corresponding title
  bar of the objects list.
</li>
</ul>

At the bottom of the Object Browser, there is \b Information
window providing some information on a selected geometric object:

\image html creation_op_info.png Information window

- <b>Creation operation</b> shows a name of the operation
used to create the selected object.
- In a table under <b>Creation operation</b>, \b Parameter and \b
Value are a name and a value of a parameter used to create the
selected object.

*/