VTK  9.3.0
vtkHull.h
Go to the documentation of this file.
1 // SPDX-FileCopyrightText: Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
2 // SPDX-License-Identifier: BSD-3-Clause
32 #ifndef vtkHull_h
33 #define vtkHull_h
34 
35 #include "vtkFiltersCoreModule.h" // For export macro
36 #include "vtkPointSetAlgorithm.h"
37 #include <vector> //for storing planes
38 
39 VTK_ABI_NAMESPACE_BEGIN
40 class vtkCellArray;
41 class vtkPlanes;
42 class vtkPoints;
43 class vtkPolyData;
44 
45 class VTKFILTERSCORE_EXPORT vtkHull : public vtkPointSetAlgorithm
46 {
47 public:
49 
53  static vtkHull* New();
54  vtkTypeMacro(vtkHull, vtkPointSetAlgorithm);
55  void PrintSelf(ostream& os, vtkIndent indent) override;
57 
62 
64 
75  int AddPlane(double A, double B, double C);
76  int AddPlane(double plane[3]);
78 
80 
88  void SetPlane(int i, double A, double B, double C);
89  void SetPlane(int i, double plane[3]);
91 
93 
97  int AddPlane(double A, double B, double C, double D);
98  int AddPlane(double plane[3], double D);
99  void SetPlane(int i, double A, double B, double C, double D);
100  void SetPlane(int i, double plane[3], double D);
102 
107  void SetPlanes(vtkPlanes* planes);
108 
113 
120 
128 
134 
145 
147 
158  void GenerateHull(vtkPolyData* pd, double* bounds);
160  vtkPolyData* pd, double xmin, double xmax, double ymin, double ymax, double zmin, double zmax);
162 
163 protected:
164  vtkHull() = default;
165  ~vtkHull() override = default;
166 
167  // The planes - 4 doubles per plane for A, B, C, D.
168  std::vector<double> Planes;
169 
170  // Internal method used to find the position of each plane
172 
173  // Internal method used to create the actual polygons from the set
174  // of planes
175  void ClipPolygonsFromPlanes(vtkPoints* points, vtkCellArray* polys, const double* bounds);
176 
177  // Internal method used to create the initial "big" polygon from the
178  // plane equation. This polygon is clipped by all other planes to form
179  // the final polygon (or it may be clipped entirely)
180  void CreateInitialPolygon(double*, int, const double*);
181 
182  // The method that does it all...
184 
185  // Specify that the output is of type vtkPolyData
187 
188 private:
189  vtkHull(const vtkHull&) = delete;
190  void operator=(const vtkHull&) = delete;
191 };
192 
193 VTK_ABI_NAMESPACE_END
194 #endif
object to represent cell connectivity
Definition: vtkCellArray.h:176
produce an n-sided convex hull
Definition: vtkHull.h:46
void AddCubeVertexPlanes()
Add the 8 planes that represent the vertices of a cube - the combination of the three face planes con...
int GetNumberOfPlanes()
Get the number of planes in the current set of planes.
void AddCubeEdgePlanes()
Add the 12 planes that represent the edges of a cube - halfway between the two connecting face planes...
void RemoveAllPlanes()
Remove all planes from the current set of planes.
void ClipPolygonsFromPlanes(vtkPoints *points, vtkCellArray *polys, const double *bounds)
void SetPlane(int i, double plane[3], double D)
Variations of AddPlane()/SetPlane() that allow D to be set.
int FillOutputPortInformation(int port, vtkInformation *info) override
Fill the output port information objects for this algorithm.
void SetPlane(int i, double plane[3])
Set the normal values for plane i.
int AddPlane(double plane[3], double D)
Variations of AddPlane()/SetPlane() that allow D to be set.
int AddPlane(double plane[3])
Add a plane to the current set of planes.
void PrintSelf(ostream &os, vtkIndent indent) override
Standard methods to instantiate, obtain type information, and print information about the class.
~vtkHull() override=default
void AddRecursiveSpherePlanes(int level)
Add the planes that represent the normals of the vertices of a polygonal sphere formed by recursively...
void ComputePlaneDistances(vtkPointSet *input)
vtkHull()=default
int RequestData(vtkInformation *, vtkInformationVector **, vtkInformationVector *) override
This is called by the superclass.
void CreateInitialPolygon(double *, int, const double *)
void GenerateHull(vtkPolyData *pd, double *bounds)
A special method that is used to generate a polyhedron directly from a set of n planes.
void GenerateHull(vtkPolyData *pd, double xmin, double xmax, double ymin, double ymax, double zmin, double zmax)
A special method that is used to generate a polyhedron directly from a set of n planes.
static vtkHull * New()
Standard methods to instantiate, obtain type information, and print information about the class.
int AddPlane(double A, double B, double C)
Add a plane to the current set of planes.
void SetPlane(int i, double A, double B, double C, double D)
Variations of AddPlane()/SetPlane() that allow D to be set.
int AddPlane(double A, double B, double C, double D)
Variations of AddPlane()/SetPlane() that allow D to be set.
void AddCubeFacePlanes()
Add the six planes that make up the faces of a cube - (1,0,0), (-1, 0, 0), (0,1,0),...
void SetPlanes(vtkPlanes *planes)
Set all the planes at once using a vtkPlanes implicit function.
std::vector< double > Planes
Definition: vtkHull.h:168
void SetPlane(int i, double A, double B, double C)
Set the normal values for plane i.
a simple class to control print indentation
Definition: vtkIndent.h:29
Store zero or more vtkInformation instances.
Store vtkAlgorithm input/output information.
implicit function for convex set of planes
Definition: vtkPlanes.h:42
Superclass for algorithms that produce output of the same type as input.
concrete class for storing a set of points
Definition: vtkPointSet.h:59
represent and manipulate 3D points
Definition: vtkPoints.h:29
concrete dataset represents vertices, lines, polygons, and triangle strips
Definition: vtkPolyData.h:80
@ points
Definition: vtkX3D.h:446
@ info
Definition: vtkX3D.h:376
@ level
Definition: vtkX3D.h:395
@ port
Definition: vtkX3D.h:447