OpenMS
MultiGradient.h
Go to the documentation of this file.
1 // --------------------------------------------------------------------------
2 // OpenMS -- Open-Source Mass Spectrometry
3 // --------------------------------------------------------------------------
4 // Copyright The OpenMS Team -- Eberhard Karls University Tuebingen,
5 // ETH Zurich, and Freie Universitaet Berlin 2002-2023.
6 //
7 // This software is released under a three-clause BSD license:
8 // * Redistributions of source code must retain the above copyright
9 // notice, this list of conditions and the following disclaimer.
10 // * Redistributions in binary form must reproduce the above copyright
11 // notice, this list of conditions and the following disclaimer in the
12 // documentation and/or other materials provided with the distribution.
13 // * Neither the name of any author or any participating institution
14 // may be used to endorse or promote products derived from this software
15 // without specific prior written permission.
16 // For a full list of authors, refer to the file AUTHORS.
17 // --------------------------------------------------------------------------
18 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
19 // AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20 // IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21 // ARE DISCLAIMED. IN NO EVENT SHALL ANY OF THE AUTHORS OR THE CONTRIBUTING
22 // INSTITUTIONS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
23 // EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
24 // PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
25 // OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
26 // WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
27 // OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
28 // ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29 //
30 // --------------------------------------------------------------------------
31 // $Maintainer: Timo Sachsenberg $
32 // $Authors: Marc Sturm $
33 // --------------------------------------------------------------------------
34 
35 #pragma once
36 
37 // OpenMS_GUI config
38 #include <OpenMS/VISUAL/OpenMS_GUIConfig.h>
39 
40 //OpenMS
41 #include <OpenMS/CONCEPT/Types.h>
42 #include <OpenMS/CONCEPT/Macros.h>
45 
46 //QT
47 #include <QtGui/QColor>
48 
49 //STL
50 #include <map>
51 #include <vector>
52 #include <cmath>
53 
54 namespace OpenMS
55 {
56 
67  class OPENMS_GUI_DLLAPI MultiGradient
68  {
69 public:
72 
75 
78  {
80  IM_STAIRS
81  };
82 
85 
87  MultiGradient(const MultiGradient & multigradient);
88 
91 
94 
96  void insert(double position, QColor color);
98  bool remove(double position);
100  bool exists(double position);
112  QColor color(UInt index);
113 
114 
121  QColor interpolatedColorAt(double position) const;
128  QColor interpolatedColorAt(double position, double min, double max) const;
129 
131  void activatePrecalculationMode(double min, double max, UInt steps);
134 
136  inline Int precalculatedColorIndex( double position ) const
137  {
138  OPENMS_PRECONDITION(pre_.size() != 0, "MultiGradient::precalculatedColorIndex(double): Precalculation mode not activated!");
139  OPENMS_PRECONDITION(position >= pre_min_, (String("MultiGradient::precalculatedColorIndex(double): position ") + position + " out of specified range (" + pre_min_ + "-" + (pre_min_ + pre_size_) + ")!").c_str());
140 
141  Int index = (Int)((position - pre_min_) / pre_size_ * pre_steps_);
142 
143  return qBound( 0, index, (Int)pre_.size() - 1 );
144  }
145 
147  inline QColor precalculatedColorByIndex( Int index ) const
148  {
149  OPENMS_PRECONDITION(pre_.size() != 0, "MultiGradient::precalculatedColorByIndex(Int): Precalculation mode not activated!");
150  OPENMS_PRECONDITION( index >= 0, "MultiGradient::precalculatedColorByIndex(Int): negative indexes not allowed");
151  OPENMS_PRECONDITION( index < (Int)pre_.size(), (String("MultiGradient::indexedColor(Int): index ") + index + " out of specified range (0-" + pre_.size() + ")!").c_str());
152 
153  return pre_[index];
154  }
155 
163  inline QColor precalculatedColorAt(double position) const
164  {
165  return precalculatedColorByIndex( precalculatedColorIndex( position ) );
166  }
167 
169  Size size() const;
170 
173  {
174  return pre_.size();
175  }
176 
181 
183  std::string toString() const;
199  void fromString(const std::string & gradient);
200 
201 protected:
203  std::map<double, QColor> pos_col_;
207  std::vector<QColor> pre_;
209  double pre_min_;
211  double pre_size_;
214 
215  };
216 
217 }
A gradient of multiple colors and arbitrary distances between colors.
Definition: MultiGradient.h:68
static MultiGradient getDefaultGradientLinearIntensityMode()
Returns the default gradient for linear intensity mode.
MultiGradient & operator=(const MultiGradient &rhs)
Assignment operator.
static MultiGradient getDefaultGradientLogarithmicIntensityMode()
Returns the default gradient for logarithmic intensity mode.
void deactivatePrecalculationMode()
deactivates the precalculation of values ( and deletes the precalculated values)
std::string toString() const
convert to string representation
std::vector< QColor > pre_
Precalculated colors.
Definition: MultiGradient.h:207
Int precalculatedColorIndex(double position) const
index of color in precalculated table by position in gradient
Definition: MultiGradient.h:136
MultiGradient(const MultiGradient &multigradient)
Copy constructor.
bool exists(double position)
returns if a value for position position exists
Size precalculatedSize() const
size of precalculated colors table
Definition: MultiGradient.h:172
~MultiGradient()
Destructor.
std::map< double, QColor > pos_col_
Map of index and color.
Definition: MultiGradient.h:203
void insert(double position, QColor color)
sets or replaces the color at position position
UInt pre_steps_
Steps of the precalculated color range.
Definition: MultiGradient.h:213
bool remove(double position)
removes the color at position position
void fromString(const std::string &gradient)
Sets the gradient by string representation.
QColor color(UInt index)
returns the color of the index -th point
MultiGradient()
Constructor.
double pre_size_
Width of the precalculated color range.
Definition: MultiGradient.h:211
QColor precalculatedColorByIndex(Int index) const
precalculated color by its index in the table
Definition: MultiGradient.h:147
void activatePrecalculationMode(double min, double max, UInt steps)
activates the precalculation of values (only approximate results are given)
Size size() const
return the number of color points
double pre_min_
Minimum of the precalculated color range.
Definition: MultiGradient.h:209
QColor interpolatedColorAt(double position) const
Returns the color as position.
QColor precalculatedColorAt(double position) const
Returns a precalculated color.
Definition: MultiGradient.h:163
QColor interpolatedColorAt(double position, double min, double max) const
returns the color as position with the gradient stretched between min and max.
InterpolationMode interpolation_mode_
Current interpolation mode.
Definition: MultiGradient.h:205
UInt position(UInt index)
returns the position of the index -th point
InterpolationMode
Interpolation mode.
Definition: MultiGradient.h:78
@ IM_LINEAR
IM_LINEAR returns the linear interpolation (default).
Definition: MultiGradient.h:79
void setInterpolationMode(InterpolationMode mode)
sets the interpolation mode (default or stairs). Default is linear
InterpolationMode getInterpolationMode() const
returns the interpolation mode
A more convenient string class.
Definition: String.h:60
int Int
Signed integer type.
Definition: Types.h:102
unsigned int UInt
Unsigned integer type.
Definition: Types.h:94
size_t Size
Size type e.g. used as variable which can hold result of size()
Definition: Types.h:127
#define OPENMS_PRECONDITION(condition, message)
Precondition macro.
Definition: openms/include/OpenMS/CONCEPT/Macros.h:120
Main OpenMS namespace.
Definition: FeatureDeconvolution.h:48