Man Page for vtkMarchingCubes
Table of Contents

NAME

vtkMarchingCubes - generate isosurface(s) from volume

SYNOPSIS


#include "/opt/vtk-c++/patented/vtkMarchingCubes.h"

class VTK_EXPORT vtkMarchingCubes : public vtkStructuredPointsToPolyDataFilter

vtkMarchingCubes();
static vtkMarchingCubes *New() {return new vtkMarchingCubes;};
~vtkMarchingCubes();
const char *GetClassName() {return "vtkMarchingCubes";};
void PrintSelf(ostream& os, vtkIndent indent);
void SetValue(int i, float value);
float GetValue(int i);
float *GetValues();
void GetValues(float *contourValues);
void SetNumberOfContours(int number);
int GetNumberOfContours();
void GenerateValues(int numContours, float range[2]);
void GenerateValues(int numContours, float rangeStart, float rangeEnd);
unsigned long int GetMTime();
void SetComputeNormals(int);
int GetComputeNormals();
void ComputeNormalsOn();
void ComputeNormalsOff();
void SetComputeGradients(int);
int GetComputeGradients();
void ComputeGradientsOn();
void ComputeGradientsOff();
void SetComputeScalars(int);
int GetComputeScalars();
void ComputeScalarsOn();
void ComputeScalarsOff();
void SetLocator(vtkPointLocator *locator);
void SetLocator(vtkPointLocator& locator) {this->SetLocator(&locator);};
vtkPointLocator *GetLocator();
void CreateDefaultLocator();

DESCRIPTION

vtkMarchingCubes is a filter that takes as input a volume (e.g., 3D structured point set) and generates on output one or more isosurfaces. One or more contour values must be specified to generate the isosurfaces. Alternatively, you can specify a min/max scalar range and the number of contours to generate a series of evenly spaced contour values.

CAVEATS

This filter is specialized to volumes. If you are interested in contouring other types of data, use the general vtkContourFilter. If you want to contour an image (i.e., a volume
slice), use vtkMarchingSquares.

SEE ALSO

vtkContourFilter vtkSliceCubes vtkMarchingSquares vtkDividingCubes

SUMMARY

void SetComputeNormals(int)
Set/Get the computation of normals. Normal computation is failrly expensive in both time and storage. If the output data will be processed by filters that modify topology or geometry, it may be wise to turn Normals and Gradients off.

void SetComputeGradients(int)
Set/Get the computation of gradients. Gradient computation is fairly expensive in both time and storage. Note that if ComputeNormals is on, gradients will have to be calculated, but will not be stored in the output dataset. If the output data will be processed by filters that modify topology or geometry, it may be wise to turn Normals and Gradients off.

void SetComputeScalars(int)
Set/Get the computation of scalars.

void SetValue(int i, float value)
Create default locator. Used to create one when none is specified. The locator is used to merge coincident points. Set a particular contour value at contour number i. The index i ranges between 0<=i float GetValue(int i)
Get the ith contour value.

float *GetValues()
Get a pointer to an array of contour values. There will be GetNumberOfContours() values in the list.

void GetValues(float *contourValues)
Fill a supplied list with contour values. There will be GetNumberOfContours() values in the list. Make sure you allocate enough memory to hold the list.

void SetNumberOfContours(int number)
Set the number of contours to place into the list. You only really need to use this method to reduce list size. The method SetValue() will automatically increase list size as needed.

int GetNumberOfContours()
Get the number of contours in the list of contour values.

void GenerateValues(int numContours, float range[2])
Generate numContours equally spaced contour values between specified range. Contour values will include min/max range values.

void GenerateValues(int numContours, float
Generate numContours equally spaced contour values between specified range. Contour values will include min/max range values.

vtkMarchingCubes()
Construct object with initial range (0,1) and single contour value of 0.0. ComputeNormal is on, ComputeGradients is off and ComputeScalars is on.

unsigned long GetMTime()
Overload standard modified time function. If contour values are modified, then this object is modified as well.

void SetLocator(vtkPointLocator *locator)
Specify a spatial locator for merging points. By default, an instance of vtkMergePoints is used.

Table of Contents