/*
 * Project: MoleCuilder
 * Description: creates and alters molecular systems
 * Copyright (C)  2010 University of Bonn. All rights reserved.
 * Please see the LICENSE file or "Copyright notice" in builder.cpp for details.
 */

/**
 * \file graphical.dox
 *
 * Created on: Oct 31, 2011
 *    Author: heber
 */

/**
 * \page userinterfaces-graphical Graphical User Interface
 *
 * The GUI is based on Qt4. It uses Qt3D for displaying the GlWorldView and
 * allowing for easy selecting of atoms and molecules.
 *
 * The GUI consists of the following parts:
 * - a menu created in a likewise as the one for the \ref textmenu.
 * - a world view, implemented in GLWorldView, displaying atoms and bonds
 *   and allowing for selecting them.
 * - a tab widget on the right with hover info and a list of shapes.
 * - a tab widget below the world view enlisting molecules, elements, fragments,
 *   and homologies.
 *
 *
 * \section userinterfaces-graphical-query Queries in the graphical interface.
 *
 * As all Action's always instantiate a Dialog which behaves differently for
 * each of the three user interface, we give a brief description of what it
 * does here.
 *
 * Each of the query implementations receives a reference to a QLayout where
 * it just adds its own query, e.g. for a double or a list of strings.
 * Eventually, this concatenated dialog is presented to the user -- it might
 * be empty though as well -- he enters all values and clicks accept (even
 * in case of an empty dialog). These values are inspected with each Option's
 * validator and only if all are true, accept is actually clickable. If not, at
 * least one option is still invalid.
 *
 *
 * \section userinterfaces-graphical-world_view How the World view works ...
 *
 * GLWorldView handles the Observer translation to Qt's own signal/slot mechanism. 
 * Also, it contains an instance of the GLWorldScene. This instance knows all about
 * atoms and bonds present in this scene, i.e. it has lists on them and handles
 * adding and removing. Objects in this scene are GLMoleculeObject's which
 * are either .._atom (clickable) or .._bond (non-clickable). Also,
 * GLMoleculeObject implements all transformation routines because atom and
 * bond just differ in being a sphere or a cylinder.
 *
 * See \ref qt-gui for more in-depth information
 *
 *
 * \date 2014-03-10
 *
 */