/*========================================================================= Program: Visualization Toolkit Module: $RCSfile: vtkLookupTable.cxx,v $ Language: C++ Date: $Date: 2000/12/10 20:08:12 $ Version: $Revision: 1.62 $ Copyright (c) 1993-2001 Ken Martin, Will Schroeder, Bill Lorensen All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither name of Ken Martin, Will Schroeder, or Bill Lorensen nor the names of any contributors may be used to endorse or promote products derived from this software without specific prior written permission. * Modified source versions must be plainly marked as such, and must not be misrepresented as being the original software. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. =========================================================================*/ #include #include "vtkLookupTable.h" #include "vtkScalars.h" #include "vtkObjectFactory.h" //------------------------------------------------------------------------------ vtkLookupTable* vtkLookupTable::New() { // First try to create the object from the vtkObjectFactory vtkObject* ret = vtkObjectFactory::CreateInstance("vtkLookupTable"); if(ret) { return (vtkLookupTable*)ret; } // If the factory was unable to create the object, then create it here. return new vtkLookupTable; } // Construct with range=(0,1); and hsv ranges set up for rainbow color table // (from red to blue). vtkLookupTable::vtkLookupTable(int sze, int ext) { this->NumberOfColors = sze; this->Table = vtkUnsignedCharArray::New(); this->Table->SetNumberOfComponents(4); this->Table->Allocate(4*sze,4*ext); this->HueRange[0] = 0.0; this->HueRange[1] = 0.66667; this->SaturationRange[0] = 1.0; this->SaturationRange[1] = 1.0; this->TableRange[0] = 0.0; this->TableRange[1] = 1.0; this->ValueRange[0] = 1.0; this->ValueRange[1] = 1.0; this->AlphaRange[0] = 1.0; this->AlphaRange[1] = 1.0; } vtkLookupTable::~vtkLookupTable() { this->Table->Delete(); this->Table = NULL; } // Scalar values greater than maximum range value are clamped to maximum // range value. void vtkLookupTable::SetTableRange(float r[2]) { this->SetTableRange(r[0],r[1]); } // Set the minimum/maximum scalar values for scalar mapping. Scalar values // less than minimum range value are clamped to minimum range value. // Scalar values greater than maximum range value are clamped to maximum // range value. void vtkLookupTable ::SetTableRange(float min, float max) { if ( min >= max ) { vtkErrorMacro (<<"Bad table range: " << min << " >= " << max); return; } if (this->TableRange[0] != min || this->TableRange[1] != max) { this->Modified(); } this->TableRange[0] = min; this->TableRange[1] = max; } // Allocate a color table of specified size. int vtkLookupTable::Allocate(int sz, int ext) { this->Modified(); this->NumberOfColors = sz; return this->Table->Allocate(4*this->NumberOfColors,4*ext); } // Generate lookup table from hue, saturation, value, alpha min/max values. // Table is built from linear ramp of each value. void vtkLookupTable::Build() { int i, hueCase; float hue, sat, val, lx, ly, lz, frac, hinc, sinc, vinc, ainc; float rgba[4], alpha; unsigned char *c_rgba; if ( this->Table->GetNumberOfTuples() < 1 || (this->GetMTime() > this->BuildTime && this->InsertTime < this->BuildTime) ) { hinc = (this->HueRange[1] - this->HueRange[0])/(this->NumberOfColors-1); sinc = (this->SaturationRange[1] - this->SaturationRange[0])/(this->NumberOfColors-1); vinc = (this->ValueRange[1] - this->ValueRange[0])/(this->NumberOfColors-1); ainc = (this->AlphaRange[1] - this->AlphaRange[0])/(this->NumberOfColors-1); for (i=0; i < this->NumberOfColors; i++) { hue = this->HueRange[0] + i * hinc; sat = this->SaturationRange[0] + i * sinc; val = this->ValueRange[0] + i * vinc; alpha = this->AlphaRange[0] + i * ainc; hueCase = (int)(hue * 6); frac = 6*hue - hueCase; lx = val*(1.0 - sat); ly = val*(1.0 - sat*frac); lz = val*(1.0 - sat*(1.0 - frac)); switch (hueCase) { /* 0Table->WritePointer(4*i,4); c_rgba[0] = (unsigned char) ((float)127.5*(1.0+(float)cos((1.0-(double)rgba[0])*3.141593))); c_rgba[1] = (unsigned char) ((float)127.5*(1.0+(float)cos((1.0-(double)rgba[1])*3.141593))); c_rgba[2] = (unsigned char) ((float)127.5*(1.0+(float)cos((1.0-(double)rgba[2])*3.141593))); c_rgba[3] = (unsigned char) (alpha*255.0); } this->BuildTime.Modified(); } } // get the color for a scalar value void vtkLookupTable::GetColor(float v, float rgb[3]) { unsigned char *rgb8 = this->MapValue(v); rgb[0] = rgb8[0]/255.0; rgb[1] = rgb8[1]/255.0; rgb[2] = rgb8[2]/255.0; } // get the opacity (alpha) for a scalar value float vtkLookupTable::GetOpacity(float v) { unsigned char *rgb8 = this->MapValue(v); return rgb8[3]/255.0; } // Given a scalar value v, return an rgba color value from lookup table. unsigned char *vtkLookupTable::MapValue(float v) { float findx; float maxIndex = this->NumberOfColors-1; float shift = -this->TableRange[0]; float scale = this->NumberOfColors/(this->TableRange[1]+shift); findx = (v+shift)*scale; if (findx < 0) { findx = 0; } if (findx > maxIndex) { findx = maxIndex; } return this->Table->GetPointer(4*(int)findx); } // accelerate the mapping by copying the data in 32-bit chunks instead // of 8-bit chunks template static void vtkLookupTableMapData(vtkLookupTable *self, T *input, unsigned char *output, int length, int inIncr, int outFormat) { float findx; int i = length; float *range = self->GetTableRange(); float maxIndex = self->GetNumberOfColors()-1; float shift = -range[0]; float scale = self->GetNumberOfColors()/(range[1]-range[0]); unsigned char *table = self->GetPointer(0); unsigned char *cptr; if (outFormat == VTK_RGBA) { while (--i >= 0) { findx = (*input + shift)*scale; if (findx < 0) { findx = 0; } if (findx > maxIndex) { findx = maxIndex; } cptr = &table[4*(int)findx]; *output++ = *cptr++; *output++ = *cptr++; *output++ = *cptr++; *output++ = *cptr++; input += inIncr; } } else if (outFormat == VTK_RGB) { while (--i >= 0) { findx = (*input + shift)*scale; if (findx < 0) { findx = 0; } if (findx > maxIndex) { findx = maxIndex; } cptr = &table[4*(int)findx]; *output++ = *cptr++; *output++ = *cptr++; *output++ = *cptr++; input += inIncr; } } else if (outFormat == VTK_LUMINANCE_ALPHA) { while (--i >= 0) { findx = (*input + shift)*scale; if (findx < 0) { findx = 0; } if (findx > maxIndex) { findx = maxIndex; } cptr = &table[4*(int)findx]; *output++ = (unsigned char)(cptr[0]*0.30+cptr[1]*0.59+cptr[2]*0.11+0.5); *output++ = cptr[3]; input += inIncr; } } else // outFormat == VTK_LUMINANCE { while (--i >= 0) { findx = (*input + shift)*scale; if (findx < 0) { findx = 0; } if (findx > maxIndex) { findx = maxIndex; } cptr = &table[4*(int)findx]; *output++ = (unsigned char)(cptr[0]*0.30+cptr[1]*0.59+cptr[2]*0.11+0.5); input += inIncr; } } } void vtkLookupTable::MapScalarsThroughTable2(void *input, unsigned char *output, int inputDataType, int numberOfValues, int inputIncrement, int outputFormat) { switch (inputDataType) { case VTK_CHAR: vtkLookupTableMapData(this,(char *)input,output,numberOfValues, inputIncrement,outputFormat); break; case VTK_UNSIGNED_CHAR: vtkLookupTableMapData(this,(unsigned char *)input,output,numberOfValues, inputIncrement,outputFormat); break; case VTK_SHORT: vtkLookupTableMapData(this,(short *)input,output,numberOfValues, inputIncrement,outputFormat); break; case VTK_UNSIGNED_SHORT: vtkLookupTableMapData(this,(unsigned short *)input,output,numberOfValues, inputIncrement,outputFormat); break; case VTK_INT: vtkLookupTableMapData(this,(int *)input,output,numberOfValues, inputIncrement,outputFormat); break; case VTK_UNSIGNED_INT: vtkLookupTableMapData(this,(unsigned int *)input,output,numberOfValues, inputIncrement,outputFormat); break; case VTK_LONG: vtkLookupTableMapData(this,(long *)input,output,numberOfValues, inputIncrement,outputFormat); break; case VTK_UNSIGNED_LONG: vtkLookupTableMapData(this,(unsigned long *)input,output, numberOfValues, inputIncrement,outputFormat); break; case VTK_FLOAT: vtkLookupTableMapData(this,(float *)input,output,numberOfValues, inputIncrement,outputFormat); break; case VTK_DOUBLE: vtkLookupTableMapData(this,(double *)input,output,numberOfValues, inputIncrement,outputFormat); break; default: vtkErrorMacro(<< "MapImageThroughTable: Unknown input ScalarType"); return; } } // Specify the number of values (i.e., colors) in the lookup // table. This method simply allocates memory and prepares the table // for use with SetTableValue(). It differs from Build() method in // that the allocated memory is not initialized according to HSVA ramps. void vtkLookupTable::SetNumberOfTableValues(int number) { if ( number < 0 || number > 65536 ) { vtkErrorMacro( << "The Number of Table Values must be between 0 and 65536" ); return; } this->NumberOfColors = number; this->Table->SetNumberOfTuples(number); } // Directly load color into lookup table. Use [0,1] float values for color // component specification. Make sure that you've either used the // Build() method or used SetNumberOfTableValues() prior to using this method. void vtkLookupTable::SetTableValue (int indx, float rgba[4]) { unsigned char *_rgba; // Check the index to make sure it is valid if ( indx < 0 ) { vtkErrorMacro(<< "Can't set the table value for negative index " << indx); return; } if ( indx >= this->NumberOfColors ) { vtkErrorMacro( << "Index " << indx << " is greater than the number of colors " << this->NumberOfColors ); return; } _rgba = this->Table->WritePointer(4*indx,4); for (int i=0; i<4; i++) { _rgba[i] = (unsigned char) ((float)255.0 * rgba[i]); } this->InsertTime.Modified(); this->Modified(); } // Directly load color into lookup table. Use [0,1] float values for color // component specification. void vtkLookupTable::SetTableValue(int indx, float r, float g, float b, float a) { float rgba[4]; rgba[0] = r; rgba[1] = g; rgba[2] = b; rgba[3] = a; this->SetTableValue(indx,rgba); } // Return a rgba color value for the given index into the lookup Table. Color // components are expressed as [0,1] float values. void vtkLookupTable::GetTableValue (int indx, float rgba[4]) { unsigned char *_rgba; indx = (indx < 0 ? 0 : (indx >= this->NumberOfColors ? this->NumberOfColors-1 : indx)); _rgba = this->Table->GetPointer(indx*4); // For some strange reason the Sun compiler crashes on the following // line with a -O5 optimization level // for (int i=0; i<4; i++) rgba[i] = _rgba[i] / 255.0; rgba[0] = _rgba[0] / 255.0; rgba[1] = _rgba[1] / 255.0; rgba[2] = _rgba[2] / 255.0; rgba[3] = _rgba[3] / 255.0; } // Return a rgba color value for the given index into the lookup table. Color // components are expressed as [0,1] float values. float *vtkLookupTable::GetTableValue (int indx) { this->GetTableValue(indx, this->RGBA); return this->RGBA; } void vtkLookupTable::PrintSelf(ostream& os, vtkIndent indent) { vtkScalarsToColors::PrintSelf(os,indent); os << indent << "Build Time: " <BuildTime.GetMTime() << "\n"; os << indent << "Table Range: (" << this->TableRange[0] << ", " << this->TableRange[1] << ")\n"; os << indent << "Hue Range: (" << this->HueRange[0] << ", " << this->HueRange[1] << ")\n"; os << indent << "Insert Time: " <InsertTime.GetMTime() << "\n"; os << indent << "Number Of Colors: " << this->GetNumberOfColors() << "\n"; os << indent << "Saturation Range: (" << this->SaturationRange[0] << ", " << this->SaturationRange[1] << ")\n"; os << indent << "Value Range: (" << this->ValueRange[0] << ", " << this->ValueRange[1] << ")\n"; os << indent << "Alpha Range: (" << this->AlphaRange[0] << ", " << this->AlphaRange[1] << ")\n"; }