VTK  9.1.0
vtkPolyDataConnectivityFilter.h
Go to the documentation of this file.
1 /*=========================================================================
2 
3  Program: Visualization Toolkit
4  Module: vtkPolyDataConnectivityFilter.h
5 
6  Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
7  All rights reserved.
8  See Copyright.txt or http://www.kitware.com/Copyright.htm for details.
9 
10  This software is distributed WITHOUT ANY WARRANTY; without even
11  the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
12  PURPOSE. See the above copyright notice for more information.
13 
14 =========================================================================*/
149 #ifndef vtkPolyDataConnectivityFilter_h
150 #define vtkPolyDataConnectivityFilter_h
151 
152 #include "vtkFiltersCoreModule.h" // For export macro
153 #include "vtkPolyDataAlgorithm.h"
154 
155 #define VTK_EXTRACT_POINT_SEEDED_REGIONS 1
156 #define VTK_EXTRACT_CELL_SEEDED_REGIONS 2
157 #define VTK_EXTRACT_SPECIFIED_REGIONS 3
158 #define VTK_EXTRACT_LARGEST_REGION 4
159 #define VTK_EXTRACT_ALL_REGIONS 5
160 #define VTK_EXTRACT_CLOSEST_POINT_REGION 6
161 
162 class vtkDataArray;
163 class vtkIdList;
164 class vtkIdTypeArray;
165 
166 class VTKFILTERSCORE_EXPORT vtkPolyDataConnectivityFilter : public vtkPolyDataAlgorithm
167 {
168 public:
170  void PrintSelf(ostream& os, vtkIndent indent) override;
171 
173 
177  vtkGetObjectMacro(RegionSizes, vtkIdTypeArray);
179 
184 
186 
191  vtkSetMacro(ScalarConnectivity, vtkTypeBool);
192  vtkGetMacro(ScalarConnectivity, vtkTypeBool);
193  vtkBooleanMacro(ScalarConnectivity, vtkTypeBool);
195 
197 
206  vtkSetMacro(FullScalarConnectivity, vtkTypeBool);
207  vtkGetMacro(FullScalarConnectivity, vtkTypeBool);
208  vtkBooleanMacro(FullScalarConnectivity, vtkTypeBool);
210 
212 
215  vtkSetVector2Macro(ScalarRange, double);
216  vtkGetVector2Macro(ScalarRange, double);
218 
220 
223  vtkSetClampMacro(
225  vtkGetMacro(ExtractionMode, int);
227  {
228  this->SetExtractionMode(VTK_EXTRACT_POINT_SEEDED_REGIONS);
229  }
231  {
232  this->SetExtractionMode(VTK_EXTRACT_CELL_SEEDED_REGIONS);
233  }
236  {
237  this->SetExtractionMode(VTK_EXTRACT_SPECIFIED_REGIONS);
238  }
240  {
241  this->SetExtractionMode(VTK_EXTRACT_CLOSEST_POINT_REGION);
242  }
243  void SetExtractionModeToAllRegions() { this->SetExtractionMode(VTK_EXTRACT_ALL_REGIONS); }
244  const char* GetExtractionModeAsString();
246 
251 
255  void AddSeed(int id);
256 
260  void DeleteSeed(int id);
261 
266 
270  void AddSpecifiedRegion(int id);
271 
275  void DeleteSpecifiedRegion(int id);
276 
278 
282  vtkSetVector3Macro(ClosestPoint, double);
283  vtkGetVectorMacro(ClosestPoint, double, 3);
285 
290 
292 
295  vtkSetMacro(ColorRegions, vtkTypeBool);
296  vtkGetMacro(ColorRegions, vtkTypeBool);
297  vtkBooleanMacro(ColorRegions, vtkTypeBool);
299 
301 
306  vtkSetMacro(MarkVisitedPointIds, vtkTypeBool);
307  vtkGetMacro(MarkVisitedPointIds, vtkTypeBool);
308  vtkBooleanMacro(MarkVisitedPointIds, vtkTypeBool);
310 
312 
316  vtkGetObjectMacro(VisitedPointIds, vtkIdList);
318 
320 
325  vtkSetMacro(OutputPointsPrecision, int);
326  vtkGetMacro(OutputPointsPrecision, int);
328 
329 protected:
332 
333  // Usual data generation method
335 
336  vtkTypeBool ColorRegions; // boolean turns on/off scalar gen for separate regions
337  int ExtractionMode; // how to extract regions
338  vtkIdList* Seeds; // id's of points or cells used to seed regions
339  vtkIdList* SpecifiedRegionIds; // regions specified for extraction
340  vtkIdTypeArray* RegionSizes; // size (in cells) of each region extracted
341 
342  double ClosestPoint[3];
343 
346 
347  // Does this cell qualify as being scalar connected ?
349 
350  double ScalarRange[2];
351 
353 
354  // used to support algorithm execution
365  std::vector<vtkIdType> Wave;
366  std::vector<vtkIdType> Wave2;
370 
373 
374 private:
376  void operator=(const vtkPolyDataConnectivityFilter&) = delete;
377 };
378 
383 {
385  {
386  return "ExtractPointSeededRegions";
387  }
389  {
390  return "ExtractCellSeededRegions";
391  }
393  {
394  return "ExtractSpecifiedRegions";
395  }
396  else if (this->ExtractionMode == VTK_EXTRACT_ALL_REGIONS)
397  {
398  return "ExtractAllRegions";
399  }
401  {
402  return "ExtractClosestPointRegion";
403  }
404  else
405  {
406  return "ExtractLargestRegion";
407  }
408 }
409 
410 #endif
vtkPolyDataConnectivityFilter::RequestData
int RequestData(vtkInformation *, vtkInformationVector **, vtkInformationVector *) override
This is called by the superclass.
vtkPolyDataConnectivityFilter::GetNumberOfExtractedRegions
int GetNumberOfExtractedRegions()
Obtain the number of connected regions.
vtkPolyDataConnectivityFilter::RegionNumber
vtkIdType RegionNumber
Definition: vtkPolyDataConnectivityFilter.h:360
vtkPolyDataConnectivityFilter::SetExtractionModeToSpecifiedRegions
void SetExtractionModeToSpecifiedRegions()
Control the extraction of connected surfaces.
Definition: vtkPolyDataConnectivityFilter.h:235
vtkPolyDataConnectivityFilter::FullScalarConnectivity
vtkTypeBool FullScalarConnectivity
Definition: vtkPolyDataConnectivityFilter.h:345
vtkPolyDataConnectivityFilter::OutputPointsPrecision
int OutputPointsPrecision
Definition: vtkPolyDataConnectivityFilter.h:372
vtkIdType
int vtkIdType
Definition: vtkType.h:332
vtkPolyDataConnectivityFilter::DeleteSeed
void DeleteSeed(int id)
Delete a seed id (point or cell id).
vtkPolyDataConnectivityFilter::Wave
std::vector< vtkIdType > Wave
Definition: vtkPolyDataConnectivityFilter.h:365
vtkInformationVector
Store zero or more vtkInformation instances.
Definition: vtkInformationVector.h:145
vtkPolyDataConnectivityFilter::~vtkPolyDataConnectivityFilter
~vtkPolyDataConnectivityFilter() override
vtkPolyDataConnectivityFilter
extract polygonal data based on geometric connectivity
Definition: vtkPolyDataConnectivityFilter.h:167
vtkPolyDataConnectivityFilter::NeighborCellPointIds
vtkIdList * NeighborCellPointIds
Definition: vtkPolyDataConnectivityFilter.h:356
vtkPolyDataConnectivityFilter::InitializeSpecifiedRegionList
void InitializeSpecifiedRegionList()
Initialize list of region ids to extract.
vtkPolyDataConnectivityFilter::IsScalarConnected
int IsScalarConnected(vtkIdType cellId)
vtkPolyDataConnectivityFilter::PrintSelf
void PrintSelf(ostream &os, vtkIndent indent) override
Methods invoked by print to print information about the object including superclasses.
vtkDataArray
abstract superclass for arrays of numeric data
Definition: vtkDataArray.h:159
vtkPolyDataConnectivityFilter::Wave2
std::vector< vtkIdType > Wave2
Definition: vtkPolyDataConnectivityFilter.h:366
vtkPolyDataConnectivityFilter::InitializeSeedList
void InitializeSeedList()
Initialize list of point ids/cell ids used to seed regions.
vtkPolyDataConnectivityFilter::GetExtractionModeAsString
const char * GetExtractionModeAsString()
Return the method of extraction as a string.
Definition: vtkPolyDataConnectivityFilter.h:382
VTK_EXTRACT_CLOSEST_POINT_REGION
#define VTK_EXTRACT_CLOSEST_POINT_REGION
Definition: vtkPolyDataConnectivityFilter.h:160
vtkPolyDataConnectivityFilter::DeleteSpecifiedRegion
void DeleteSpecifiedRegion(int id)
Delete a region id to extract.
vtkPolyDataConnectivityFilter::RegionSizes
vtkIdTypeArray * RegionSizes
Definition: vtkPolyDataConnectivityFilter.h:340
vtkPolyDataAlgorithm.h
VTK_EXTRACT_LARGEST_REGION
#define VTK_EXTRACT_LARGEST_REGION
Definition: vtkPolyDataConnectivityFilter.h:158
vtkPolyDataConnectivityFilter::InScalars
vtkDataArray * InScalars
Definition: vtkPolyDataConnectivityFilter.h:363
vtkPolyDataConnectivityFilter::SetExtractionModeToClosestPointRegion
void SetExtractionModeToClosestPointRegion()
Control the extraction of connected surfaces.
Definition: vtkPolyDataConnectivityFilter.h:239
vtkPolyDataConnectivityFilter::SetExtractionModeToPointSeededRegions
void SetExtractionModeToPointSeededRegions()
Control the extraction of connected surfaces.
Definition: vtkPolyDataConnectivityFilter.h:226
vtkPolyDataConnectivityFilter::ExtractionMode
int ExtractionMode
Definition: vtkPolyDataConnectivityFilter.h:337
vtkPolyDataConnectivityFilter::TraverseAndMark
void TraverseAndMark()
vtkPolyDataConnectivityFilter::PointIds
vtkIdList * PointIds
Definition: vtkPolyDataConnectivityFilter.h:367
vtkPolyDataConnectivityFilter::VisitedPointIds
vtkIdList * VisitedPointIds
Definition: vtkPolyDataConnectivityFilter.h:369
vtkPolyDataConnectivityFilter::NewScalars
vtkDataArray * NewScalars
Definition: vtkPolyDataConnectivityFilter.h:359
vtkIndent
a simple class to control print indentation
Definition: vtkIndent.h:113
vtkPolyDataConnectivityFilter::vtkPolyDataConnectivityFilter
vtkPolyDataConnectivityFilter()
vtkIdList
list of point or cell ids
Definition: vtkIdList.h:140
vtkPolyDataConnectivityFilter::Mesh
vtkPolyData * Mesh
Definition: vtkPolyDataConnectivityFilter.h:364
vtkPolyDataConnectivityFilter::ColorRegions
vtkTypeBool ColorRegions
Definition: vtkPolyDataConnectivityFilter.h:336
vtkPolyDataConnectivityFilter::MarkVisitedPointIds
vtkTypeBool MarkVisitedPointIds
Definition: vtkPolyDataConnectivityFilter.h:371
vtkPolyDataConnectivityFilter::CellScalars
vtkDataArray * CellScalars
Definition: vtkPolyDataConnectivityFilter.h:355
vtkPolyDataConnectivityFilter::PointNumber
vtkIdType PointNumber
Definition: vtkPolyDataConnectivityFilter.h:361
vtkPolyDataConnectivityFilter::SetExtractionModeToLargestRegion
void SetExtractionModeToLargestRegion()
Control the extraction of connected surfaces.
Definition: vtkPolyDataConnectivityFilter.h:234
vtkInformation
Store vtkAlgorithm input/output information.
Definition: vtkInformation.h:183
VTK_EXTRACT_ALL_REGIONS
#define VTK_EXTRACT_ALL_REGIONS
Definition: vtkPolyDataConnectivityFilter.h:159
vtkIdTypeArray
dynamic, self-adjusting array of vtkIdType
Definition: vtkIdTypeArray.h:145
VTK_EXTRACT_POINT_SEEDED_REGIONS
#define VTK_EXTRACT_POINT_SEEDED_REGIONS
Definition: vtkPolyDataConnectivityFilter.h:155
vtkPolyDataConnectivityFilter::CellIds
vtkIdList * CellIds
Definition: vtkPolyDataConnectivityFilter.h:368
vtkPolyDataConnectivityFilter::ScalarConnectivity
vtkTypeBool ScalarConnectivity
Definition: vtkPolyDataConnectivityFilter.h:344
vtkPolyDataConnectivityFilter::AddSpecifiedRegion
void AddSpecifiedRegion(int id)
Add a region id to extract.
vtkPolyDataConnectivityFilter::Seeds
vtkIdList * Seeds
Definition: vtkPolyDataConnectivityFilter.h:338
vtkPolyData
concrete dataset represents vertices, lines, polygons, and triangle strips
Definition: vtkPolyData.h:195
vtkPolyDataConnectivityFilter::Visited
vtkIdType * Visited
Definition: vtkPolyDataConnectivityFilter.h:357
vtkPolyDataConnectivityFilter::NumCellsInRegion
vtkIdType NumCellsInRegion
Definition: vtkPolyDataConnectivityFilter.h:362
vtkPolyDataConnectivityFilter::AddSeed
void AddSeed(int id)
Add a seed id (point or cell id).
vtkPolyDataConnectivityFilter::SetExtractionModeToAllRegions
void SetExtractionModeToAllRegions()
Control the extraction of connected surfaces.
Definition: vtkPolyDataConnectivityFilter.h:243
VTK_EXTRACT_SPECIFIED_REGIONS
#define VTK_EXTRACT_SPECIFIED_REGIONS
Definition: vtkPolyDataConnectivityFilter.h:157
vtkPolyDataConnectivityFilter::SpecifiedRegionIds
vtkIdList * SpecifiedRegionIds
Definition: vtkPolyDataConnectivityFilter.h:339
VTK_EXTRACT_CELL_SEEDED_REGIONS
#define VTK_EXTRACT_CELL_SEEDED_REGIONS
Definition: vtkPolyDataConnectivityFilter.h:156
vtkPolyDataConnectivityFilter::PointMap
vtkIdType * PointMap
Definition: vtkPolyDataConnectivityFilter.h:358
vtkTypeBool
int vtkTypeBool
Definition: vtkABI.h:69
vtkPolyDataConnectivityFilter::SetExtractionModeToCellSeededRegions
void SetExtractionModeToCellSeededRegions()
Control the extraction of connected surfaces.
Definition: vtkPolyDataConnectivityFilter.h:230
vtkPolyDataConnectivityFilter::New
static vtkPolyDataConnectivityFilter * New()
Construct with default extraction mode to extract largest regions.
vtkPolyDataAlgorithm
Superclass for algorithms that produce only polydata as output.
Definition: vtkPolyDataAlgorithm.h:151