vtkLookupTable.h

Go to the documentation of this file.

 /*=========================================================================
 
  Program:   Visualization Toolkit
  Module:    vtkLookupTable.h
 
  Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
  All rights reserved.
  See Copyright.txt or http://www.kitware.com/Copyright.htm for details.
 
     This software is distributed WITHOUT ANY WARRANTY; without even
     the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
     PURPOSE.  See the above copyright notice for more information.
 
=========================================================================*/
#ifndef vtkLookupTable_h
#define vtkLookupTable_h
 
#include "vtkCommonCoreModule.h" // For export macro
#include "vtkScalarsToColors.h"
 
#include "vtkUnsignedCharArray.h" // Needed for inline method
 
#define VTK_RAMP_LINEAR 0
#define VTK_RAMP_SCURVE 1
#define VTK_RAMP_SQRT 2
#define VTK_SCALE_LINEAR 0
#define VTK_SCALE_LOG10 1
 
class VTKCOMMONCORE_EXPORT vtkLookupTable : public vtkScalarsToColors
{
public:
 
  const static vtkIdType BELOW_RANGE_COLOR_INDEX;
  const static vtkIdType ABOVE_RANGE_COLOR_INDEX;
  const static vtkIdType NAN_COLOR_INDEX;
  const static vtkIdType NUMBER_OF_SPECIAL_COLORS;
 
  static vtkLookupTable *New();
 
  vtkTypeMacro(vtkLookupTable,vtkScalarsToColors);
  void PrintSelf(ostream& os, vtkIndent indent);
 
  virtual int IsOpaque();
 
  int Allocate(int sz=256, int ext=256);
 
  virtual void Build();
 
  virtual void ForceBuild();
 
 
  vtkSetMacro(Ramp,int);
  void SetRampToLinear() { this->SetRamp(VTK_RAMP_LINEAR); };
  void SetRampToSCurve() { this->SetRamp(VTK_RAMP_SCURVE); };
  void SetRampToSQRT() { this->SetRamp(VTK_RAMP_SQRT); };
  vtkGetMacro(Ramp,int);
 
 
  void SetScale(int scale);
  void SetScaleToLinear() { this->SetScale(VTK_SCALE_LINEAR); };
  void SetScaleToLog10() { this->SetScale(VTK_SCALE_LOG10); };
  vtkGetMacro(Scale,int);
 
 
  void SetTableRange(double r[2]);
  virtual void SetTableRange(double min, double max);
  vtkGetVectorMacro(TableRange,double,2);
 
 
  vtkSetVector2Macro(HueRange,double);
  vtkGetVector2Macro(HueRange,double);
 
 
  vtkSetVector2Macro(SaturationRange,double);
  vtkGetVector2Macro(SaturationRange,double);
 
 
  vtkSetVector2Macro(ValueRange,double);
  vtkGetVector2Macro(ValueRange,double);
 
 
  vtkSetVector2Macro(AlphaRange,double);
  vtkGetVector2Macro(AlphaRange,double);
 
 
  vtkSetVector4Macro(NanColor, double);
  vtkGetVector4Macro(NanColor, double);
 
  unsigned char* GetNanColorAsUnsignedChars();
 
 
  static void GetColorAsUnsignedChars(const double colorIn[4],
                                      unsigned char colorOut[4]);
 
 
  vtkSetVector4Macro(BelowRangeColor, double);
  vtkGetVector4Macro(BelowRangeColor, double);
 
 
  vtkSetMacro(UseBelowRangeColor, int);
  vtkGetMacro(UseBelowRangeColor, int);
  vtkBooleanMacro(UseBelowRangeColor, int);
 
 
  vtkSetVector4Macro(AboveRangeColor, double);
  vtkGetVector4Macro(AboveRangeColor, double);
 
 
  vtkSetMacro(UseAboveRangeColor, int);
  vtkGetMacro(UseAboveRangeColor, int);
  vtkBooleanMacro(UseAboveRangeColor, int);
 
  unsigned char* MapValue(double v);
 
  void GetColor(double x, double rgb[3]);
 
  double GetOpacity(double v);
 
  virtual vtkIdType GetIndex(double v);
 
 
  void SetNumberOfTableValues(vtkIdType number);
  vtkIdType GetNumberOfTableValues() { return this->NumberOfColors; };
 
  virtual void SetTableValue(vtkIdType indx, double rgba[4]);
 
 
  virtual void SetTableValue(vtkIdType indx,
                              double r, double g, double b, double a=1.0);
 
  double *GetTableValue(vtkIdType id);
 
  void GetTableValue(vtkIdType id, double rgba[4]);
 
 
  unsigned char *GetPointer(const vtkIdType id) {
    return this->Table->GetPointer(4*id); };
 
  unsigned char *WritePointer(const vtkIdType id, const int number);
 
 
  double *GetRange() { return this->GetTableRange(); };
  void SetRange(double min, double max) { this->SetTableRange(min, max); };
  void SetRange(double rng[2]) { this->SetRange(rng[0], rng[1]); };
 
  //BTX
  static void GetLogRange(const double range[2], double log_range[2]);
 
 
  static double ApplyLogScale(double v, const double range[2],
    const double log_range[2]);
  //ETX
 
 
  vtkSetClampMacro(NumberOfColors,vtkIdType,2,VTK_ID_MAX);
  vtkGetMacro(NumberOfColors,vtkIdType);
 
 
  void SetTable(vtkUnsignedCharArray *);
  vtkGetObjectMacro(Table,vtkUnsignedCharArray);
 
 
  void MapScalarsThroughTable2(void *input, unsigned char *output,
                               int inputDataType, int numberOfValues,
                               int inputIncrement, int outputIncrement);
 
  void DeepCopy(vtkScalarsToColors *lut);
 
 
  virtual int UsingLogScale()
    {
    return (this->GetScale() == VTK_SCALE_LOG10)? 1 : 0;
    }
 
  virtual vtkIdType GetNumberOfAvailableColors();
 
  virtual void GetIndexedColor(vtkIdType idx, double rgba[4]);
 
protected:
  vtkLookupTable(int sze=256, int ext=256);
  ~vtkLookupTable();
 
  vtkIdType NumberOfColors;
  vtkUnsignedCharArray *Table;
  double TableRange[2];
  double HueRange[2];
  double SaturationRange[2];
  double ValueRange[2];
  double AlphaRange[2];
  double NanColor[4];
  double BelowRangeColor[4];
  int    UseBelowRangeColor;
  double AboveRangeColor[4];
  int    UseAboveRangeColor;
 
  int Scale;
  int Ramp;
  vtkTimeStamp InsertTime;
  vtkTimeStamp BuildTime;
  double RGBA[4]; //used during conversion process
  unsigned char NanColorChar[4];
 
  int OpaqueFlag;
  vtkTimeStamp OpaqueFlagBuildTime;
 
  void ResizeTableForSpecialColors();
 
private:
  vtkLookupTable(const vtkLookupTable&);  // Not implemented.
  void operator=(const vtkLookupTable&);  // Not implemented.
};
 
//----------------------------------------------------------------------------
inline unsigned char *vtkLookupTable::WritePointer(const vtkIdType id,
                                                   const int number)
{
  this->InsertTime.Modified();
  return this->Table->WritePointer(4*id,4*number);
}
 
#endif