1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
|
/*=========================================================================
Program: Visualization Toolkit
Module: vtkDicer.h
Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
All rights reserved.
See Copyright.txt or http://www.kitware.com/Copyright.htm for details.
This software is distributed WITHOUT ANY WARRANTY; without even
the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the above copyright notice for more information.
=========================================================================*/
// .NAME vtkDicer - abstract superclass to divide dataset into pieces
// .SECTION Description
// 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.
// .SECTION Caveats
// 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.
// .SECTION See Also
// vtkOBBDicer vtkConnectedDicer vtkSpatialDicer
#ifndef __vtkDicer_h
#define __vtkDicer_h
#include "vtkDataSetAlgorithm.h"
#define VTK_DICE_MODE_NUMBER_OF_POINTS 0
#define VTK_DICE_MODE_SPECIFIED_NUMBER 1
#define VTK_DICE_MODE_MEMORY_LIMIT 2
class VTK_GRAPHICS_EXPORT vtkDicer : public vtkDataSetAlgorithm
{
public:
vtkTypeMacro(vtkDicer,vtkDataSetAlgorithm);
void PrintSelf(ostream& os, vtkIndent indent);
// Description:
// 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.
vtkSetMacro(FieldData,int);
vtkGetMacro(FieldData,int);
vtkBooleanMacro(FieldData,int);
// Description:
// Specify the method to determine how many pieces the data should be
// broken into. By default, the number of points per piece is used.
vtkSetClampMacro(DiceMode,int,VTK_DICE_MODE_NUMBER_OF_POINTS,VTK_DICE_MODE_MEMORY_LIMIT);
vtkGetMacro(DiceMode,int);
void SetDiceModeToNumberOfPointsPerPiece()
{this->SetDiceMode(VTK_DICE_MODE_NUMBER_OF_POINTS);};
void SetDiceModeToSpecifiedNumberOfPieces()
{this->SetDiceMode(VTK_DICE_MODE_SPECIFIED_NUMBER);};
void SetDiceModeToMemoryLimitPerPiece()
{this->SetDiceMode(VTK_DICE_MODE_MEMORY_LIMIT);};
// Description:
// Use the following method after the filter has updated to
// determine the actual number of pieces the data was separated
// into.
vtkGetMacro(NumberOfActualPieces,int);
// Description:
// Control piece size based on the maximum number of points per piece.
// (This ivar has effect only when the DiceMode is set to
// SetDiceModeToNumberOfPoints().)
vtkSetClampMacro(NumberOfPointsPerPiece,int,1000,VTK_LARGE_INTEGER);
vtkGetMacro(NumberOfPointsPerPiece,int);
// Description:
// 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.
vtkSetClampMacro(NumberOfPieces,int,1,VTK_LARGE_INTEGER);
vtkGetMacro(NumberOfPieces,int);
// Description:
// 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.
vtkSetClampMacro(MemoryLimit,unsigned long,100,VTK_LARGE_INTEGER);
vtkGetMacro(MemoryLimit,unsigned long);
protected:
vtkDicer();
~vtkDicer() {};
virtual void UpdatePieceMeasures(vtkDataSet *input);
int NumberOfPointsPerPiece;
int NumberOfPieces;
unsigned long MemoryLimit;
int NumberOfActualPieces;
int FieldData;
int DiceMode;
private:
vtkDicer(const vtkDicer&); // Not implemented.
void operator=(const vtkDicer&); // Not implemented.
};
#endif
|
