patented/vtkMarchingCubes.h Source File

00001 /*=========================================================================
00002 
00003   Program:   Visualization Toolkit
00004   Module:    $RCSfile: vtkMarchingCubes.h,v $
00005   Language:  C++
00006 
00007 
00008 Copyright (c) 1993-2001 Ken Martin, Will Schroeder, Bill Lorensen 
00009 All rights reserved.
00010 
00011     THIS CLASS IS PATENTED UNDER UNITED STATES PATENT NUMBER 4,710,876
00012     "System and Method for the Display of Surface Structures Contained
00013     Within the Interior Region of a Solid Body".
00014     Application of this software for commercial purposes requires 
00015     a license grant from GE. Contact:
00016         Jerald Roehling
00017         GE Licensing
00018         One Independence Way
00019         PO Box 2023
00020         Princeton, N.J. 08540
00021         phone 609-734-9823
00022         e-mail:Roehlinj@gerlmo.ge.com
00023     for more information.
00024 
00025 Redistribution and use in source and binary forms, with or without
00026 modification, are permitted provided that the following conditions are met:
00027 
00028  * Redistributions of source code must retain the above copyright notice,
00029    this list of conditions and the following disclaimer.
00030 
00031  * Redistributions in binary form must reproduce the above copyright notice,
00032    this list of conditions and the following disclaimer in the documentation
00033    and/or other materials provided with the distribution.
00034 
00035  * Neither name of Ken Martin, Will Schroeder, or Bill Lorensen nor the names
00036    of any contributors may be used to endorse or promote products derived
00037    from this software without specific prior written permission.
00038 
00039  * Modified source versions must be plainly marked as such, and must not be
00040    misrepresented as being the original software.
00041 
00042 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS''
00043 AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
00044 IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
00045 ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE FOR
00046 ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
00047 DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
00048 SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
00049 CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
00050 OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
00051 OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
00052 
00053 =========================================================================*/
00076 #ifndef __vtkMarchingCubes_h
00077 #define __vtkMarchingCubes_h
00078 
00079 #include "vtkStructuredPointsToPolyDataFilter.h"
00080 #include "vtkContourValues.h"
00081 
00082 class VTK_EXPORT vtkMarchingCubes : public vtkStructuredPointsToPolyDataFilter
00083 {
00084 public:
00085   static vtkMarchingCubes *New();
00086   vtkTypeMacro(vtkMarchingCubes,vtkStructuredPointsToPolyDataFilter);
00087   void PrintSelf(ostream& os, vtkIndent indent);
00088 
00089   // Methods to set contour values
00090   void SetValue(int i, float value);
00091   float GetValue(int i);
00092   float *GetValues();
00093   void GetValues(float *contourValues);
00094   void SetNumberOfContours(int number);
00095   int GetNumberOfContours();
00096   void GenerateValues(int numContours, float range[2]);
00097   void GenerateValues(int numContours, float rangeStart, float rangeEnd);
00098 
00099   // Because we delegate to vtkContourValues
00100   unsigned long int GetMTime();
00101 
00106   vtkSetMacro(ComputeNormals,int);
00107   vtkGetMacro(ComputeNormals,int);
00108   vtkBooleanMacro(ComputeNormals,int);
00109 
00116   vtkSetMacro(ComputeGradients,int);
00117   vtkGetMacro(ComputeGradients,int);
00118   vtkBooleanMacro(ComputeGradients,int);
00119 
00121   vtkSetMacro(ComputeScalars,int);
00122   vtkGetMacro(ComputeScalars,int);
00123   vtkBooleanMacro(ComputeScalars,int);
00124 
00125   void SetLocator(vtkPointLocator *locator);
00126   vtkGetObjectMacro(Locator,vtkPointLocator);
00127 
00130   void CreateDefaultLocator();
00131 
00132 #ifndef VTK_REMOVE_LEGACY_CODE
00133 
00134   void SetLocator(vtkPointLocator& locator) 
00135     {VTK_LEGACY_METHOD(SetLocator,"3.2"); this->SetLocator(&locator);}
00136 #endif
00137   
00138 protected:
00139   vtkMarchingCubes();
00140   ~vtkMarchingCubes();
00141   vtkMarchingCubes(const vtkMarchingCubes&) {};
00142   void operator=(const vtkMarchingCubes&) {};
00143 
00144   void Execute();
00145 
00146   vtkContourValues *ContourValues;
00147   int ComputeNormals;
00148   int ComputeGradients;
00149   int ComputeScalars;
00150   vtkPointLocator *Locator;
00151 };
00152 
00155 inline void vtkMarchingCubes::SetValue(int i, float value)
00156 {this->ContourValues->SetValue(i,value);}
00157 
00159 inline float vtkMarchingCubes::GetValue(int i)
00160 {return this->ContourValues->GetValue(i);}
00161 
00164 inline float *vtkMarchingCubes::GetValues()
00165 {return this->ContourValues->GetValues();}
00166 
00170 inline void vtkMarchingCubes::GetValues(float *contourValues)
00171 {this->ContourValues->GetValues(contourValues);}
00172 
00176 inline void vtkMarchingCubes::SetNumberOfContours(int number)
00177 {this->ContourValues->SetNumberOfContours(number);}
00178 
00180 inline int vtkMarchingCubes::GetNumberOfContours()
00181 {return this->ContourValues->GetNumberOfContours();}
00182 
00185 inline void vtkMarchingCubes::GenerateValues(int numContours, float range[2])
00186 {this->ContourValues->GenerateValues(numContours, range);}
00187 
00190 inline void vtkMarchingCubes::GenerateValues(int numContours, float
00191                                              rangeStart, float rangeEnd)
00192 {this->ContourValues->GenerateValues(numContours, rangeStart, rangeEnd);}
00193 
00194 #endif
00195 
00196