Main Page | Directories | Class Hierarchy | Alphabetical List | Class List | File List | Class Members | File Members | Related Pages

vtkDicer Class Reference

#include <vtkDicer.h>

Inheritance diagram for vtkDicer:

Inheritance graph
[legend]
Collaboration diagram for vtkDicer:

Collaboration graph
[legend]
List of all members.

Detailed Description

abstract superclass to divide dataset into pieces

Subclasses of vtkDicer divides the input dataset into separate pieces. These pieces can then be operated on by other filters (e.g., vtkThreshold). One application is to break very large polygonal models into pieces and performing viewing and occlusion culling on the pieces. Multiple pieces can also be streamed through the visualization pipeline.

To use this filter, you must specify the execution mode of the filter; i.e., set the way that the piece size is controlled (do this by setting the DiceMode ivar). The filter does not change the geometry or topology of the input dataset, rather it generates integer numbers that indicate which piece a particular point belongs to (i.e., it modifies the point and cell attribute data). The integer number can be placed into the output scalar data, or the output field data.

Warning:
The number of pieces generated may not equal the specified number of pieces. Use the method GetNumberOfActualPieces() after filter execution to get the actual number of pieces generated.
See also:
vtkOBBDicer vtkConnectedDicer vtkSpatialDicer
Created by:
  • Schroeder, Will
CVS contributions (if > 5%):
  • Schroeder, Will (85%)
  • Martin, Ken (5%)
CVS logs (CVSweb):
  • .cxx (/Graphics/vtkDicer.cxx)
  • .h (/Graphics/vtkDicer.h)

Definition at line 63 of file vtkDicer.h.

Public Types

typedef vtkDataSetToDataSetFilter Superclass

Public Member Functions

virtual const char * GetClassName ()
virtual int IsA (const char *type)
void PrintSelf (ostream &os, vtkIndent indent)
virtual void SetFieldData (int)
virtual int GetFieldData ()
virtual void FieldDataOn ()
virtual void FieldDataOff ()
virtual void SetDiceMode (int)
virtual int GetDiceMode ()
void SetDiceModeToNumberOfPointsPerPiece ()
void SetDiceModeToSpecifiedNumberOfPieces ()
void SetDiceModeToMemoryLimitPerPiece ()
virtual int GetNumberOfActualPieces ()
virtual void SetNumberOfPointsPerPiece (int)
virtual int GetNumberOfPointsPerPiece ()
virtual void SetNumberOfPieces (int)
virtual int GetNumberOfPieces ()
virtual void SetMemoryLimit (unsigned long)
virtual unsigned long GetMemoryLimit ()

Static Public Member Functions

int IsTypeOf (const char *type)
vtkDicerSafeDownCast (vtkObject *o)

Protected Member Functions

 vtkDicer ()
 ~vtkDicer ()
virtual void UpdatePieceMeasures ()

Protected Attributes

int NumberOfPointsPerPiece
int NumberOfPieces
unsigned long MemoryLimit
int NumberOfActualPieces
int FieldData
int DiceMode


Member Typedef Documentation

typedef vtkDataSetToDataSetFilter vtkDicer::Superclass
 

Reimplemented from vtkDataSetToDataSetFilter.

Reimplemented in vtkOBBDicer.

Definition at line 66 of file vtkDicer.h.


Constructor & Destructor Documentation

vtkDicer::vtkDicer  )  [protected]
 

vtkDicer::~vtkDicer  )  [inline, protected]
 

Definition at line 127 of file vtkDicer.h.


Member Function Documentation

virtual const char* vtkDicer::GetClassName  )  [virtual]
 

Reimplemented from vtkDataSetToDataSetFilter.

Reimplemented in vtkOBBDicer.

int vtkDicer::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 vtkTypeRevisionMacro found in vtkSetGet.h.

Reimplemented from vtkDataSetToDataSetFilter.

Reimplemented in vtkOBBDicer.

virtual int vtkDicer::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 vtkTypeRevisionMacro found in vtkSetGet.h.

Reimplemented from vtkDataSetToDataSetFilter.

Reimplemented in vtkOBBDicer.

vtkDicer* vtkDicer::SafeDownCast vtkObject o  )  [static]
 

Reimplemented from vtkDataSetToDataSetFilter.

Reimplemented in vtkOBBDicer.

void vtkDicer::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 vtkDataSetToDataSetFilter.

Reimplemented in vtkOBBDicer.

virtual void vtkDicer::SetFieldData int   )  [virtual]
 

Set/Get the flag which controls whether to generate point scalar data or point field data. If this flag is off, scalar data is generated. Otherwise, field data is generated. Note that the generated the data are integer numbers indicating which piece a particular point belongs to.

virtual int vtkDicer::GetFieldData  )  [virtual]
 

Set/Get the flag which controls whether to generate point scalar data or point field data. If this flag is off, scalar data is generated. Otherwise, field data is generated. Note that the generated the data are integer numbers indicating which piece a particular point belongs to.

virtual void vtkDicer::FieldDataOn  )  [virtual]
 

Set/Get the flag which controls whether to generate point scalar data or point field data. If this flag is off, scalar data is generated. Otherwise, field data is generated. Note that the generated the data are integer numbers indicating which piece a particular point belongs to.

virtual void vtkDicer::FieldDataOff  )  [virtual]
 

Set/Get the flag which controls whether to generate point scalar data or point field data. If this flag is off, scalar data is generated. Otherwise, field data is generated. Note that the generated the data are integer numbers indicating which piece a particular point belongs to.

virtual void vtkDicer::SetDiceMode int   )  [virtual]
 

Specify the method to determine how many pieces the data should be broken into. By default, the number of points per piece is used.

virtual int vtkDicer::GetDiceMode  )  [virtual]
 

Specify the method to determine how many pieces the data should be broken into. By default, the number of points per piece is used.

void vtkDicer::SetDiceModeToNumberOfPointsPerPiece  )  [inline]
 

Specify the method to determine how many pieces the data should be broken into. By default, the number of points per piece is used.

Definition at line 85 of file vtkDicer.h.

References VTK_DICE_MODE_NUMBER_OF_POINTS.

void vtkDicer::SetDiceModeToSpecifiedNumberOfPieces  )  [inline]
 

Specify the method to determine how many pieces the data should be broken into. By default, the number of points per piece is used.

Definition at line 87 of file vtkDicer.h.

References VTK_DICE_MODE_SPECIFIED_NUMBER.

void vtkDicer::SetDiceModeToMemoryLimitPerPiece  )  [inline]
 

Specify the method to determine how many pieces the data should be broken into. By default, the number of points per piece is used.

Definition at line 89 of file vtkDicer.h.

References VTK_DICE_MODE_MEMORY_LIMIT.

virtual int vtkDicer::GetNumberOfActualPieces  )  [virtual]
 

Use the following method after the filter has updated to determine the actual number of pieces the data was separated into.

virtual void vtkDicer::SetNumberOfPointsPerPiece int   )  [virtual]
 

Control piece size based on the maximum number of points per piece. (This ivar has effect only when the DiceMode is set to SetDiceModeToNumberOfPoints().)

virtual int vtkDicer::GetNumberOfPointsPerPiece  )  [virtual]
 

Control piece size based on the maximum number of points per piece. (This ivar has effect only when the DiceMode is set to SetDiceModeToNumberOfPoints().)

virtual void vtkDicer::SetNumberOfPieces int   )  [virtual]
 

Set/Get the number of pieces the object is to be separated into. (This ivar has effect only when the DiceMode is set to SetDiceModeToSpecifiedNumber()). Note that the ivar NumberOfPieces is a target - depending on the particulars of the data, more or less number of pieces than the target value may be created.

virtual int vtkDicer::GetNumberOfPieces  )  [virtual]
 

Set/Get the number of pieces the object is to be separated into. (This ivar has effect only when the DiceMode is set to SetDiceModeToSpecifiedNumber()). Note that the ivar NumberOfPieces is a target - depending on the particulars of the data, more or less number of pieces than the target value may be created.

virtual void vtkDicer::SetMemoryLimit unsigned  long  )  [virtual]
 

Control piece size based on a memory limit. (This ivar has effect only when the DiceMode is set to SetDiceModeToMemoryLimit()). The memory limit should be set in kilobytes.

virtual unsigned long vtkDicer::GetMemoryLimit  )  [virtual]
 

Control piece size based on a memory limit. (This ivar has effect only when the DiceMode is set to SetDiceModeToMemoryLimit()). The memory limit should be set in kilobytes.

virtual void vtkDicer::UpdatePieceMeasures  )  [protected, virtual]
 


Member Data Documentation

int vtkDicer::NumberOfPointsPerPiece [protected]
 

Definition at line 131 of file vtkDicer.h.

int vtkDicer::NumberOfPieces [protected]
 

Definition at line 132 of file vtkDicer.h.

unsigned long vtkDicer::MemoryLimit [protected]
 

Definition at line 133 of file vtkDicer.h.

int vtkDicer::NumberOfActualPieces [protected]
 

Definition at line 134 of file vtkDicer.h.

int vtkDicer::FieldData [protected]
 

Definition at line 135 of file vtkDicer.h.

int vtkDicer::DiceMode [protected]
 

Definition at line 136 of file vtkDicer.h.


The documentation for this class was generated from the following file: