/*
 * 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 used 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 list of all currently selected molecules.
 * - A list of all currently present molecules.
 *
 * \section userinterfaces-graphical-query Queries in the graphical interface.
 *
 * As all Action 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 passed via a Pipe mechanism
 * (this is a workaround as Qt's moc does not liked nested classes) to the
 * ValueStorage.
 *
 * \section userinterfaces-graphical-world_view How the World view works ...
 *
 * GLWorldView handles the Observer translation to Qt's own mechanism. Also, it
 * contains an instance of the GLWorldScene. This instance knows about all
 * 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.
 *
 *
 * \date 2011-10-31
 *
 */