synfig-core/trunk/src/synfig/gradient.h

   1 /* === S Y N F I G ========================================================= */
   2 /*!     \file gradient.h
   3 **      \brief Color Gradient Class
   4 **
   5 **      $Id$
   6 **
   7 **      \legal
   8 **      Copyright (c) 2002-2005 Robert B. Quattlebaum Jr., Adrian Bentley
   9 **
  10 **      This package is free software; you can redistribute it and/or
  11 **      modify it under the terms of the GNU General Public License as
  12 **      published by the Free Software Foundation; either version 2 of
  13 **      the License, or (at your option) any later version.
  14 **
  15 **      This package is distributed in the hope that it will be useful,
  16 **      but WITHOUT ANY WARRANTY; without even the implied warranty of
  17 **      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  18 **      General Public License for more details.
  19 **      \endlegal
  20 */
  21 /* ========================================================================= */
  22
  23 /* === S T A R T =========================================================== */
  24
  25 #ifndef __SYNFIG_GRADIENT_H
  26 #define __SYNFIG_GRADIENT_H
  27
  28 /* === H E A D E R S ======================================================= */
  29
  30 #include "real.h"
  31 #include "color.h"
  32 #include <vector>
  33 #include <utility>
  34 #include "uniqueid.h"
  35
  36 /* === M A C R O S ========================================================= */
  37
  38 /* === T Y P E D E F S ===================================================== */
  39
  40 /* === C L A S S E S & S T R U C T S ======================================= */
  41
  42 namespace synfig {
  43
  44 /*! \struct GradientCPoint
  45 **      \brief \todo
  46 */
  47 struct GradientCPoint : public UniqueID
  48 {
  49         Real pos;
  50         Color color;
  51
  52         bool operator<(const GradientCPoint &rhs)const { return pos<rhs.pos; }
  53         bool operator<(const Real &rhs)const { return pos<rhs; }
  54
  55         GradientCPoint() { }
  56         GradientCPoint(const Real &pos, const Color &color):pos(pos),color(color) { }
  57 }; // END of class GradientCPoint
  58
  59
  60 /*! \class Gradient
  61 **      \brief Color Gradient Class
  62 */
  63 using namespace std;
  64 class Gradient
  65 {
  66 public:
  67         typedef GradientCPoint CPoint;
  68         typedef vector<GradientCPoint>::const_iterator const_iterator;
  69         typedef vector<GradientCPoint>::iterator iterator;
  70         typedef vector<GradientCPoint>::const_reverse_iterator const_reverse_iterator;
  71         typedef vector<GradientCPoint>::reverse_iterator reverse_iterator;
  72 private:
  73         vector<GradientCPoint> cpoints;
  74 public:
  75         Gradient() { }
  76
  77         //! Two-Tone Color Gradient Convenience Constructor
  78         Gradient(const Color &c1, const Color &c2);
  79
  80         //! Three-Tone Color Gradient Convenience Constructor
  81         Gradient(const Color &c1, const Color &c2, const Color &c3);
  82
  83         //! Alias for sort (Implemented for consistency)
  84         void sync() { sort(); }
  85
  86         //! You should call this function after changing stuff.
  87         void sort();
  88
  89         void push_back(const GradientCPoint cpoint) { cpoints.push_back(cpoint); }
  90         iterator erase(iterator iter) { return cpoints.erase(iter); }
  91         bool empty()const { return cpoints.empty(); }
  92         size_t size()const { return cpoints.size(); }
  93
  94         iterator begin() { return cpoints.begin(); }
  95         iterator end() { return cpoints.end(); }
  96         reverse_iterator rbegin() { return cpoints.rbegin(); }
  97         reverse_iterator rend() { return cpoints.rend(); }
  98         const_iterator begin()const { return cpoints.begin(); }
  99         const_iterator end()const { return cpoints.end(); }
 100         const_reverse_iterator rbegin()const { return cpoints.rbegin(); }
 101         const_reverse_iterator rend()const { return cpoints.rend(); }
 102
 103         Color operator()(const Real &x, float supersample=0)const;
 104
 105         //! Returns the iterator of the CPoint closest to \a x
 106         iterator proximity(const Real &x);
 107
 108         //! Returns the const_iterator of the CPoint closest to \a x
 109         const_iterator proximity(const Real &x)const;
 110
 111         //! Returns the iterator of the CPoint with UniqueID \a id
 112         iterator find(const UniqueID &id);
 113
 114         //! Returns the const_iterator of the CPoint with UniqueID \a id
 115         const_iterator find(const UniqueID &id)const;
 116 }; // END of class Gradient
 117
 118 }; // END of namespace synfig
 119
 120 /* === E N D =============================================================== */
 121
 122 #endif