Main Page   Class Hierarchy   Alphabetical List   Compound List   Compound Members   Related Pages  

vtkImageMarchingCubes Class Reference

generate isosurface(s) from volume/images. More...

#include <vtkImageMarchingCubes.h>

Inheritance diagram for vtkImageMarchingCubes:

Inheritance graph
[legend]
Collaboration diagram for vtkImageMarchingCubes:

Collaboration graph
[legend]
List of all members.

Public Methods

virtual const char * GetClassName ()
virtual int IsA (const char *type)
void PrintSelf (ostream &os, vtkIndent indent)
void SetInput (vtkImageData *input)
vtkImageDataGetInput ()
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 ()
virtual void SetComputeScalars (int)
virtual int GetComputeScalars ()
virtual void ComputeScalarsOn ()
virtual void ComputeScalarsOff ()
virtual void SetComputeNormals (int)
virtual int GetComputeNormals ()
virtual void ComputeNormalsOn ()
virtual void ComputeNormalsOff ()
virtual void SetComputeGradients (int)
virtual int GetComputeGradients ()
virtual void ComputeGradientsOn ()
virtual void ComputeGradientsOff ()
int GetLocatorPoint (int cellX, int cellY, int edge)
void AddLocatorPoint (int cellX, int cellY, int edge, int ptId)
void IncrementLocatorZ ()
void Update ()
virtual void SetInputMemoryLimit (int)
virtual int GetInputMemoryLimit ()

Static Public Methods

vtkImageMarchingCubes * New ()
int IsTypeOf (const char *type)
vtkImageMarchingCubes * SafeDownCast (vtkObject *o)

Public Attributes

int ComputeScalars
int ComputeNormals
int ComputeGradients
int NeedGradients
vtkCellArrayTriangles
vtkScalarsScalars
vtkPointsPoints
vtkNormalsNormals
vtkVectorsGradients

Protected Methods

 vtkImageMarchingCubes ()
 ~vtkImageMarchingCubes ()
 vtkImageMarchingCubes (const vtkImageMarchingCubes &)
void operator= (const vtkImageMarchingCubes &)
void Execute ()
void March (vtkImageData *inData, int chunkMin, int chunkMax, int numContours, float *values)
void InitializeLocator (int min0, int max0, int min1, int max1)
void DeleteLocator ()
int * GetLocatorPointer (int cellX, int cellY, int edge)

Protected Attributes

int NumberOfSlicesPerChunk
int InputMemoryLimit
vtkContourValuesContourValues
int * LocatorPointIds
int LocatorDimX
int LocatorDimY
int LocatorMinX
int LocatorMinY

Detailed Description

generate isosurface(s) from volume/images.

Date:
2000/12/10 20:09:16
Revision:
1.25
Thanks:
Thanks to C. Charles Law who developed this class.
vtkImageMarchingCubes is a filter that takes as input images (e.g., 3D image region) 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. This filter can stream, so that the entire volume need not be loaded at once. Streaming is controlled using the instance variable InputMemoryLimit, which has units KBytes.

Warning:
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
Examples:
vtkImageMarchingCubes (examples)


Member Function Documentation

void vtkImageMarchingCubes::GenerateValues int    numContours,
float    rangeStart,
float    rangeEnd
[inline]
 

Generate numContours equally spaced contour values between specified range. Contour values will include min/max range values.

void vtkImageMarchingCubes::GenerateValues int    numContours,
float    range[2]
[inline]
 

Generate numContours equally spaced contour values between specified range. Contour values will include min/max range values.

virtual const char* vtkImageMarchingCubes::GetClassName   [virtual]
 

Return the class name as a string. This method is defined in all subclasses of vtkObject with the vtkTypeMacro found in vtkSetGet.h.

Reimplemented from vtkPolyDataSource.

unsigned long int vtkImageMarchingCubes::GetMTime   [virtual]
 

Return this object's modified time.

Reimplemented from vtkObject.

int vtkImageMarchingCubes::GetNumberOfContours   [inline]
 

Get the number of contours in the list of contour values.

float vtkImageMarchingCubes::GetValue int    i [inline]
 

Get the ith contour value.

void vtkImageMarchingCubes::GetValues float *    contourValues [inline]
 

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.

float * vtkImageMarchingCubes::GetValues   [inline]
 

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

virtual int vtkImageMarchingCubes::IsA const char *    type [virtual]
 

Return 1 if this class is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeMacro found in vtkSetGet.h.

Reimplemented from vtkPolyDataSource.

int vtkImageMarchingCubes::IsTypeOf const char *    type [static]
 

Return 1 if this class type is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeMacro found in vtkSetGet.h.

Reimplemented from vtkPolyDataSource.

vtkImageMarchingCubes* vtkImageMarchingCubes::New   [static]
 

Instantiate object with no start, end, or progress methods.

Reimplemented from vtkPolyDataSource.

void vtkImageMarchingCubes::PrintSelf ostream &    os,
vtkIndent    indent
[virtual]
 

Methods invoked by print to print information about the object including superclasses. Typically not called by the user (use Print() instead) but used in the hierarchical print process to combine the output of several classes.

Reimplemented from vtkSource.

vtkImageMarchingCubes* vtkImageMarchingCubes::SafeDownCast vtkObject   o [static]
 

Will cast the supplied object to vtkObject* is this is a safe operation (i.e., a safe downcast); otherwise NULL is returned. This method is defined in all subclasses of vtkObject with the vtkTypeMacro found in vtkSetGet.h.

Reimplemented from vtkPolyDataSource.

virtual void vtkImageMarchingCubes::SetComputeGradients int    [virtual]
 

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.

virtual void vtkImageMarchingCubes::SetComputeNormals int    [virtual]
 

Set/Get the computation of normals. Normal computation is fairly 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.

virtual void vtkImageMarchingCubes::SetComputeScalars int    [virtual]
 

Set/Get the computation of scalars.

void vtkImageMarchingCubes::SetInput vtkImageData   input
 

Set/Get the source for the scalar data to contour.

virtual void vtkImageMarchingCubes::SetInputMemoryLimit int    [virtual]
 

The InputMemoryLimit determines the chunk size (the number of slices requested at each iteration). The units of this limit is KiloBytes. For now, only the Z axis is split.

void vtkImageMarchingCubes::SetNumberOfContours int    number [inline]
 

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.

void vtkImageMarchingCubes::SetValue int    i,
float    value
[inline]
 

Set a particular contour value at contour number i. The index i ranges between 0<=i<NumberOfContours.

void vtkImageMarchingCubes::Update   [virtual]
 

Bring object up-to-date before execution. Update() checks modified time against last execution time, and re-executes object if necessary.

Reimplemented from vtkSource.


The documentation for this class was generated from the following file:
Generated on Tue Mar 19 13:26:38 2002 for VTK by doxygen1.2.14 written by Dimitri van Heesch, © 1997-2002