color_palette.hpp

Go to the documentation of this file.

#ifndef COLOR_WIDGETS_COLOR_PALETTE_HPP
#define COLOR_WIDGETS_COLOR_PALETTE_HPP

#include <QColor>
#include <QString>
#include <QVector>
#include <QObject>
#include <QPair>
#include <QPixmap>

namespace color_widgets {

class  ColorPalette : public QObject
{
    Q_OBJECT

    Q_PROPERTY(QVector<value_type> colors READ colors WRITE setColors NOTIFY colorsChanged)
    Q_PROPERTY(QString name READ name WRITE setName NOTIFY nameChanged)
    Q_PROPERTY(int columns READ columns WRITE setColumns NOTIFY columnsChanged)
    Q_PROPERTY(int count READ count)
    Q_PROPERTY(QString fileName READ fileName WRITE setFileName NOTIFY fileNameChanged)
    Q_PROPERTY(bool dirty READ dirty WRITE setDirty NOTIFY dirtyChanged)

public:
    typedef QPair<QColor,QString> value_type;

    ColorPalette(const QVector<QColor>& colors, const QString& name = QString(), int columns = 0);
    ColorPalette(const QVector<QPair<QColor,QString> >& colors, const QString& name = QString(), int columns = 0);
    explicit ColorPalette(const QString& name = QString());
    ColorPalette(const ColorPalette& other);
    ColorPalette& operator=(const ColorPalette& other);
    ~ColorPalette();
    ColorPalette(ColorPalette&& other);
    ColorPalette& operator=(ColorPalette&& other);

    Q_INVOKABLE QColor colorAt(int index) const;

    Q_INVOKABLE QString nameAt(int index) const;

    QVector<QPair<QColor,QString> > colors() const;
    QVector<QColor> onlyColors() const;

    int count() const;
    int columns();

    QString name() const;

    Q_INVOKABLE void loadColorTable(const QVector<QRgb>& color_table);

    Q_INVOKABLE QVector<QRgb> colorTable() const;
    
    static ColorPalette fromColorTable(const QVector<QRgb>& table);

    Q_INVOKABLE bool loadImage(const QImage& image);

    static ColorPalette fromImage(const QImage& image);

    Q_INVOKABLE bool load(const QString& name);

    static ColorPalette fromFile(const QString& name);

    QString fileName() const;

    bool dirty() const;

    QPixmap preview(const QSize& size, const QColor& background=Qt::transparent) const;

public slots:
    void setColumns(int columns);

    void setColors(const QVector<QColor>& colors);
    void setColors(const QVector<QPair<QColor,QString> >& colors);

    void setColorAt(int index, const QColor& color);
    void setColorAt(int index, const QColor& color, const QString& name);
    void setNameAt(int index, const QString& name = QString());
    void appendColor(const QColor& color, const QString& name = QString());
    void insertColor(int index, const QColor& color, const QString& name = QString());
    void eraseColor(int index);

    bool save(const QString& filename);
    bool save();

    void setName(const QString& name);
    void setFileName(const QString& name);
    void setDirty(bool dirty);

signals:
    void colorsChanged(const QVector<QPair<QColor,QString> >&);
    void columnsChanged(int);
    void nameChanged(const QString&);
    void fileNameChanged(const QString&);
    void dirtyChanged(bool);
    void colorChanged(int index);
    void colorRemoved(int index);
    void colorAdded(int index);
    void colorsUpdated(const QVector<QPair<QColor,QString>>&);

private:
    QString unnamed(const QString& name = QString()) const;

    void emitUpdate();

    class Private;
    Private *p;
};

} // namespace color_widgets

#endif // COLOR_WIDGETS_COLOR_PALETTE_HPP