/********************************************************************
**                Image Component Library (ICL)                    **
**                                                                 **
** Copyright (C) 2006-2013 CITEC, University of Bielefeld          **
**                         Neuroinformatics Group                  **
** Website: www.iclcv.org and                                      **
**          http://opensource.cit-ec.de/projects/icl               **
**                                                                 **
** File   : ICLQt/src/ICLQt/FSliderHandle.h                        **
** Module : ICLQt                                                  **
** Authors: Christof Elbrechter                                    **
**                                                                 **
**                                                                 **
** GNU LESSER GENERAL PUBLIC LICENSE                               **
** This file may be used under the terms of the GNU Lesser General **
** Public License version 3.0 as published by the                  **
**                                                                 **
** Free Software Foundation and appearing in the file LICENSE.LGPL **
** included in the packaging of this file.  Please review the      **
** following information to ensure the license requirements will   **
** be met: http://www.gnu.org/licenses/lgpl-3.0.txt                **
**                                                                 **
** 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.                                          **
**                                                                 **
********************************************************************/

#pragma once

#include <ICLUtils/CompatMacros.h>
#include <ICLQt/GUIHandle.h>
#include <ICLQt/ThreadedUpdatableSlider.h>

/** \cond */
class QSlider;
class QLCDNumber;
/** \endcond */

namespace icl{
  namespace qt{
    
    /// Handle class for slider componets \ingroup HANDLES
    class ICLQt_API FSliderHandle : public GUIHandle<ThreadedUpdatableSlider>{
      /// associated display
      QLCDNumber *lcd;
      public:
      /// Create an empty slider handle
      FSliderHandle();
  
      /// create a slider handle
      FSliderHandle(ThreadedUpdatableSlider *sl,float *minV, float *maxV, float *M, float *B,int range, GUIWidget *w, QLCDNumber *lcd=0);
      
      /// retuns the QLCDNumber that is used as display
      /** result is null, if the slider was created without display */
      inline QLCDNumber *getDisplay() { return lcd; }
      
      /// set the min value
      void setMin(float min);
  
      /// set the max value
      void setMax(float max);
  
      /// set the range of the slider
      void setRange(float min, float max){ setMin(min); setMax(max); }
      
      /// set the current value of the slider
      void setValue(float val);
  
      /// sets all parameters of a slider
      void setAll(float min ,float max, float val){ setRange(min,max); setValue(val); }
  
      /// returns the current min. of the slider
      float getMin() const;
  
      /// returns the current max. of the slider
      float getMax() const;
  
      /// returns the current value of the slider
      float getValue() const;
      
      /// assigns a new value to the slider (equal to setValue)
      void operator=(float val) { setValue(val); }
  
      /// overloaded method for registering callbacks to specific slider events
      /** <b>Please note:</b> Only this callback mechanism is overloaded for the slider class
          Simple GUI callbacks are stored within the ThreadedUpdatableSlider class, while
          complex callbacks (those that get the GUI components handle name as parameters) are
          stored and handled within the GUIHandleBase class.
          Allowed values for the event parameter are comma-separated lists that consist of 
          the following tokes:
          - press (slider is pressed)
          - release (slider is released)
          - move (slider is moved)
          - value (the slider value is changed)
          - all (all event types)
      */
      virtual void registerCallback(const GUI::Callback &cb, const std::string &events="value"){
        (***this).registerCallback(cb,events);
      }
      
      /// import the other register callback method
      using GUIHandleBase::registerCallback;
      
      /// empties both callback locations (GUIHandleBase and ThreadedUpdatableSlider)
      virtual void removeCallbacks(){
        GUIHandleBase::removeCallbacks();
        (***this).removeCallbacks();
      }
      
      private:
      
      /// internal utiltiy function which update the param for the slider equation
      void updateMB();
     
      /// current min value
      float *m_fMin;
      
      /// current max value
      float *m_fMax;
      
      /// utility function tranlating from valued to slider coordinates
      int f2i(float f) const{
        return (int)((f-*m_fB)/ *m_fM);
      }
  
      /// utility function tranlating from slider to value coordinates
      float i2f(int i) const{
        return *m_fM*i+*m_fB;
      } 
  
      /// Slope for the internal slider equation 
      float *m_fM;
  
      /// Bias for the internal slider equation 
      float *m_fB;
      
      /// accumulator of the current slider range
      int m_iSliderRange;
    };
    
  } // namespace qt
}