/********************************************************************
**                Image Component Library (ICL)                    **
**                                                                 **
** Copyright (C) 2006-2012 CITEC, University of Bielefeld          **
**                         Neuroinformatics Group                  **
** Website: www.iclcv.org and                                      **
**          http://opensource.cit-ec.de/projects/icl               **
**                                                                 **
** File   : include/ICLGeom/ComplexCoordinateFrameSceneObject.h    **
** Module : ICLGeom                                                **
** Authors: Christof Elbrechter                                    **
**                                                                 **
**                                                                 **
** Commercial License                                              **
** ICL can be used commercially, please refer to our website       **
** www.iclcv.org for more details.                                 **
**                                                                 **
** GNU General Public License Usage                                **
** Alternatively, this file may be used under the terms of the     **
** GNU General Public License version 3.0 as published by the      **
** Free Software Foundation and appearing in the file LICENSE.GPL  **
** included in the packaging of this file.  Please review the      **
** following information to ensure the GNU General Public License  **
** version 3.0 requirements will be met:                           **
** http://www.gnu.org/copyleft/gpl.html.                           **
**                                                                 **
** The development of this software was supported by the           **
** Excellence Cluster EXC 277 Cognitive Interaction Technology.    **
** The Excellence Cluster EXC 277 is a grant of the Deutsche       **
** Forschungsgemeinschaft (DFG) in the context of the German       **
** Excellence Initiative.                                          **
**                                                                 **
*********************************************************************/

#ifndef ICL_COMPLEX_COORDINATE_FRAME_SCENE_OBJECT_H
#define ICL_COMPLEX_COORDINATE_FRAME_SCENE_OBJECT_H

#ifndef HAVE_OPENGL
#warning "this header must not be included if HAVE_OPENGL is not defined"
#else

#include <ICLGeom/SceneObject.h>
#include <ICLUtils/Mutex.h>

namespace icl{
  
  /// Special SceneObject implementation that define a visible coordinate frame
  /** In constrast to the <em>normal</em> CoordinateFrameSceneObject class, the
      ComplexCoordinateFrameSceneObject is build of cones and cylinders and 
      it uses billboard text as axix label.
      The ComplexCoordinateFrameSceneObject is already integrated with the Scene
      class. Simply set scene.setDrawCoordinateFrameEnabled(true,l,t) to
      visualize a Scene's coordintate frame. If you need a coordinate frame
      that is not alligned with the scene's origin, you can use this class. */
  class ComplexCoordinateFrameSceneObject : public SceneObject{
    /// internally used mutex
    Mutex mutex;

    /// length of each axis
    float axisLength;
    
    /// thickness of each axis
    float axisThickness;
    
    public:
    
    /// Default constructor with useful default size
    ComplexCoordinateFrameSceneObject(float axisLength=100,float axisThickness=5);

    /// Dynamic adaption
    void setParams(float axisLength, float axisThickness);
    
    /// returns current length of the axis'
    inline float getAxisLength() const { return axisLength; }

    /// returns current thickness of the axis'
    inline float getAxisThickness() const { return axisThickness; }
    
    /// locks the internal mutex
    virtual void lock() { mutex.lock(); }

    /// unlocks the internal mutex
    virtual void unlock() { mutex.unlock(); }
  };
}

#endif
#endif