kis_histogram.h

/*
 *  Copyright (c) 2004 Boudewijn Rempt
 *            (c) 2005 Bart Coppens <kde@bartcoppens.be>
 *
 *  This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 2 of the License, or
 *  (at your option) any later version.
 *
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with this program; if not, write to the Free Software
 *  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */
#ifndef KIS_HISTOGRAM_
#define KIS_HISTOGRAM_
 
#include "kis_types.h"
#include "kis_colorspace.h"
#include "kis_histogram_producer.h"
 
enum enumHistogramType {
    LINEAR,
    LOGARITHMIC
};
class KisHistogram : public TDEShared {
 
public:
    class Calculations {
 
        double m_max, m_min, m_mean, m_total, m_median, m_stddev;
 
        TQ_UINT32 m_high, m_low, m_count;
 
        friend class KisHistogram;
 
    public:
 
        Calculations() : m_max(0.0), m_min(0.0), m_mean(0.0), m_total(0.0), m_median(0.0),
            m_stddev(0.0), m_high(0), m_low(0), m_count(0) {}
        inline double getMax() { return m_max; }
        inline double getMin() { return m_min; }
        inline TQ_UINT32 getHighest() { return m_high; }
        inline TQ_UINT32 getLowest() { return m_low; }
        inline double getMean() { return m_mean; }
        //double getMedian() { return m_median; }
        //double getStandardDeviation() { return m_stddev; }
        inline TQ_UINT32 getCount() { return m_count; }
        inline double getTotal() { return m_total; }
        //TQ_UINT8 getPercentile() { return m_percentile; } // What is this exactly? XXX
    };
 
    KisHistogram(KisPaintLayerSP layer, 
                 KisHistogramProducerSP producer,
                 const enumHistogramType type);
 
    KisHistogram(KisPaintDeviceSP paintdev, 
                 KisHistogramProducerSP producer,
                 const enumHistogramType type);
 
    virtual ~KisHistogram();

    void updateHistogram();

    void computeHistogram();

    Calculations calculations();
    Calculations selectionCalculations();
 
    inline TQ_UINT32 getValue(TQ_UINT8 i) { return m_producer->getBinAt(m_channel, i); }
 
    inline enumHistogramType getHistogramType() { return m_type; }
    inline void setHistogramType(enumHistogramType type) { m_type = type; }
    inline void setProducer(KisHistogramProducerSP producer) { m_producer = producer; }
    inline void setChannel(TQ_INT32 channel) { m_channel = channel; }
    inline KisHistogramProducerSP producer() { return m_producer; }
    inline TQ_INT32 channel() { return m_channel; }
 
    inline bool hasSelection() { return m_selection; }
    inline double selectionFrom() { return m_selFrom; }
    inline double selectionTo() { return m_selTo; }
    inline void setNoSelection() { m_selection = false; }
    inline void setSelection(double from, double to)
        { m_selection = true; m_selFrom = from; m_selTo = to; }
 
 
private:
    // Dump the histogram to debug.
    void dump();
    TQValueVector<Calculations> calculateForRange(double from, double to);
    Calculations calculateSingleRange(int channel, double from, double to);
 
    KisPaintDeviceSP m_device;
    KisHistogramProducerSP m_producer;
 
    enumHistogramType m_type;
 
    TQ_INT32 m_channel;
    double m_selFrom, m_selTo;
    bool m_selection;
 
    KisPaintDeviceSP m_dev;
 
    TQValueVector<Calculations> m_completeCalculations, m_selectionCalculations;
};
 
 
#endif // KIS_HISTOGRAM_WIDGET_