qwt_color_map.h

Go to the documentation of this file.

/* -*- mode: C++ ; c-file-style: "stroustrup" -*- *****************************
 * Qwt Widget Library
 * Copyright (C) 1997   Josef Wilgen
 * Copyright (C) 2002   Uwe Rathmann
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the Qwt License, Version 1.0
 *****************************************************************************/

#ifndef QWT_COLOR_MAP_H
#define QWT_COLOR_MAP_H

#include "qwt_global.h"
#include "qwt_interval.h"
#include <qcolor.h>
#include <qvector.h>

class QWT_EXPORT QwtColorMap
{
public:
    enum Format
    {
        RGB,

        Indexed
    };

    explicit QwtColorMap( Format = QwtColorMap::RGB );
    virtual ~QwtColorMap();

    void setFormat( Format );
    Format format() const;

    virtual QRgb rgb( const QwtInterval &interval,
        double value ) const = 0;

    virtual uint colorIndex( int numColors,
        const QwtInterval &interval, double value ) const;

    QColor color( const QwtInterval &, double value ) const;
    virtual QVector<QRgb> colorTable( int numColors ) const;
    virtual QVector<QRgb> colorTable256() const;

private:
    Q_DISABLE_COPY(QwtColorMap)

    Format d_format;
};

class QWT_EXPORT QwtLinearColorMap: public QwtColorMap
{
public:
    enum Mode
    {
        FixedColors,

        ScaledColors
    };

    explicit QwtLinearColorMap( QwtColorMap::Format = QwtColorMap::RGB );
    QwtLinearColorMap( const QColor &from, const QColor &to,
        QwtColorMap::Format = QwtColorMap::RGB );

    virtual ~QwtLinearColorMap();

    void setMode( Mode );
    Mode mode() const;

    void setColorInterval( const QColor &color1, const QColor &color2 );
    void addColorStop( double value, const QColor& );
    QVector<double> colorStops() const;

    QColor color1() const;
    QColor color2() const;

    virtual QRgb rgb( const QwtInterval &, double value ) const;
    virtual uint colorIndex( int numColors,
        const QwtInterval &, double value ) const;

    class ColorStops;

private:
    class PrivateData;
    PrivateData *d_data;
};

class QWT_EXPORT QwtAlphaColorMap: public QwtColorMap
{
public:
    explicit QwtAlphaColorMap( const QColor & = QColor( Qt::gray ) );
    virtual ~QwtAlphaColorMap();

    void setAlphaInterval( int alpha1, int alpha2 ); 

    int alpha1() const;
    int alpha2() const;

    void setColor( const QColor & );
    QColor color() const;

    virtual QRgb rgb( const QwtInterval &, double value ) const;

private:
    class PrivateData;
    PrivateData *d_data;
};

class QWT_EXPORT QwtHueColorMap: public QwtColorMap
{
public:
    explicit QwtHueColorMap( QwtColorMap::Format = QwtColorMap::RGB );
    virtual ~QwtHueColorMap();

    void setHueInterval( int hue1, int hue2 ); // direction ?
    void setSaturation( int saturation );
    void setValue( int value );
    void setAlpha( int alpha ); 

    int hue1() const;
    int hue2() const;
    int saturation() const;
    int value() const;
    int alpha() const;

    virtual QRgb rgb( const QwtInterval &, double value ) const;

private:
    class PrivateData;
    PrivateData *d_data;
};

class QWT_EXPORT QwtSaturationValueColorMap: public QwtColorMap
{
public:
    QwtSaturationValueColorMap();
    virtual ~QwtSaturationValueColorMap();

    void setHue( int hue );
    void setSaturationInterval( int sat1, int sat2 ); 
    void setValueInterval( int value1, int value2 );
    void setAlpha( int alpha ); 

    int hue() const;
    int saturation1() const;
    int saturation2() const;
    int value1() const;
    int value2() const;
    int alpha() const;

    virtual QRgb rgb( const QwtInterval &, double value ) const;

private:
    class PrivateData;
    PrivateData *d_data;
};

inline QColor QwtColorMap::color(
    const QwtInterval &interval, double value ) const
{
    return QColor::fromRgba( rgb( interval, value ) );
}

inline QwtColorMap::Format QwtColorMap::format() const
{
    return d_format;
}

#endif