VTK  9.0.1
vtkSimpleCellTessellator.h
Go to the documentation of this file.
1 /*=========================================================================
2 
3  Program: Visualization Toolkit
4  Module: vtkSimpleCellTessellator.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 =========================================================================*/
45 #ifndef vtkSimpleCellTessellator_h
46 #define vtkSimpleCellTessellator_h
47 
48 #include "vtkCommonDataModelModule.h" // For export macro
50 
51 class vtkTriangleTile;
52 class vtkTetraTile;
53 class vtkCellArray;
54 class vtkDoubleArray;
60 class vtkPointData;
62 class vtkPolygon;
63 class vtkIdList;
64 
65 //-----------------------------------------------------------------------------
66 //
67 // The tessellation object
68 class VTKCOMMONDATAMODEL_EXPORT vtkSimpleCellTessellator : public vtkGenericCellTessellator
69 {
70 public:
73  void PrintSelf(ostream& os, vtkIndent indent) override;
74 
76 
79  vtkGetObjectMacro(GenericCell, vtkGenericAdaptorCell);
81 
97  vtkPointData* internalPd) override;
98 
110  vtkDoubleArray* points, vtkCellArray* cellArray, vtkPointData* internalPd) override;
111 
123  vtkDoubleArray* points, vtkCellArray* cellArray, vtkPointData* internalPd) override;
124 
128  void Reset();
129 
133  void Initialize(vtkGenericDataSet* ds) override;
134 
149 
159 
165 
173 
181 
191  void SetSubdivisionLevels(int fixed, int maxLevel);
192 
193 protected:
196 
201  void CopyPoint(vtkIdType pointId);
202 
207 
208  void InsertEdgesIntoEdgeTable(vtkTriangleTile& tri);
209  void RemoveEdgesFromEdgeTable(vtkTriangleTile& tri);
210  void InsertPointsIntoEdgeTable(vtkTriangleTile& tri);
211 
212  void InsertEdgesIntoEdgeTable(vtkTetraTile& tetra);
213  void RemoveEdgesFromEdgeTable(vtkTetraTile& tetra);
214 
232  vtkTetraTile& root, const vtkIdType* localIds, vtkIdType* ids, int* edgeIds, int* faceIds);
233 
254  vtkCellArray* cellArray, vtkPointData* internalPd);
255 
260 
266 
273  // Scalar buffer that stores the global coordinates, parametric coordinates,
274  // attributes at left, mid and right point. The format is:
275  // lxlylz lrlslt [lalb lcldle...] mxmymz mrmsmt [mamb mcmdme...]
276  // rxryrz rrrsrt [rarb rcrdre...]
277  // The ScalarsCapacity>=(6+attributeCollection->GetNumberOfComponents())*3
278 
279  double* Scalars;
281 
287 
292 
297 
299 
302  vtkDoubleArray* TessellatePoints; // Allow to use GetPointer
306 
307  int FindEdgeReferenceCount(double p1[3], double p2[3], vtkIdType& e1, vtkIdType& e2);
308 
309  int GetNumberOfCellsUsingFace(int faceId);
310  int GetNumberOfCellsUsingEdge(int edgeId);
311 
320  int IsEdgeOnFace(double p1[3], double p2[3]);
321 
330  int FindEdgeParent2D(double p1[3], double p2[3], int& localId);
331 
341  int FindEdgeParent(double p1[3], double p2[3], int& localId);
342 
348 
357  int FacesAreEqual(const vtkIdType* originalFace, const vtkIdType face[3]);
358 
363 
367 
378 
379  // The following variables are for complex cells.
380 
381  // Used to create tetra from more complex cells, because the tessellator
382  // is supposed to deal with simplices only.
384 
385  // Used to store the sub-tetra during the tessellation of complex
386  // cells.
388 
389  // Used to create triangles from a face of a complex cell.
391 
392  // Used to store the sub-triangles during the tessellation of complex cells.
394 
397 
398 private:
400  void operator=(const vtkSimpleCellTessellator&) = delete;
401 
402  friend class vtkTetraTile;
403  friend class vtkTriangleTile;
404 };
405 
406 #endif
vtkSimpleCellTessellator::RemoveEdgesFromEdgeTable
void RemoveEdgesFromEdgeTable(vtkTetraTile &tetra)
vtkSimpleCellTessellator::InsertPointsIntoEdgeTable
void InsertPointsIntoEdgeTable(vtkTriangleTile &tri)
vtkSimpleCellTessellator::TessellateCellArray
vtkCellArray * TessellateCellArray
Definition: vtkSimpleCellTessellator.h:303
vtkSimpleCellTessellator::GetMaxSubdivisionLevel
int GetMaxSubdivisionLevel()
Return the maximum level of subdivision.
vtkSimpleCellTessellator::Tessellate
void Tessellate(vtkGenericAdaptorCell *cell, vtkGenericAttributeCollection *att, vtkDoubleArray *points, vtkCellArray *cellArray, vtkPointData *internalPd) override
Tessellate a 3D ‘cell’.
vtkSimpleCellTessellator::New
static vtkSimpleCellTessellator * New()
vtkPointData
represent and manipulate point attribute data
Definition: vtkPointData.h:32
vtkIdType
int vtkIdType
Definition: vtkType.h:338
vtkGenericCellTessellator.h
vtkPolygon
a cell that represents an n-sided polygon
Definition: vtkPolygon.h:40
vtkSimpleCellTessellator::SetSubdivisionLevels
void SetSubdivisionLevels(int fixed, int maxLevel)
Set both the number of fixed subdivisions and the maximum level of subdivisions.
vtkSimpleCellTessellator::InsertEdgesIntoEdgeTable
void InsertEdgesIntoEdgeTable(vtkTetraTile &tetra)
vtkSimpleCellTessellator::AllocateScalars
void AllocateScalars(int size)
Allocate some memory if Scalars does not exists or is smaller than size.
vtkSimpleCellTessellator::TessellatePoints
vtkDoubleArray * TessellatePoints
To avoid New/Delete.
Definition: vtkSimpleCellTessellator.h:302
vtkSimpleCellTessellator::CurrentSubdivisionLevel
int CurrentSubdivisionLevel
Definition: vtkSimpleCellTessellator.h:366
vtkSimpleCellTessellator::FacesAreEqual
int FacesAreEqual(const vtkIdType *originalFace, const vtkIdType face[3])
Are the faces ‘originalFace’ and ‘face’ equal? The result is independent from any order or orientatio...
vtkSimpleCellTessellator::RemoveEdgesFromEdgeTable
void RemoveEdgesFromEdgeTable(vtkTriangleTile &tri)
vtkSimpleCellTessellator::IsEdgeOnFace
int IsEdgeOnFace(double p1[3], double p2[3])
Is the edge defined by vertices (‘p1’,‘p2’) in parametric coordinates on some edge of the original te...
vtkGenericAdaptorCell
defines cell interface
Definition: vtkGenericAdaptorCell.h:92
vtkSimpleCellTessellator::GetMaxAdaptiveSubdivisions
int GetMaxAdaptiveSubdivisions()
Return the maximum number of adaptive subdivisions.
vtkSimpleCellTessellator::Scalars
double * Scalars
Scalar buffer used to save the interpolate values of the attributes The capacity is at least the numb...
Definition: vtkSimpleCellTessellator.h:279
vtkGenericCellIterator
iterator used to traverse cells
Definition: vtkGenericCellIterator.h:42
vtkSimpleCellTessellator::TriangleIds
vtkIdList * TriangleIds
Definition: vtkSimpleCellTessellator.h:393
vtkSimpleCellTessellator::GetNumberOfCellsUsingEdge
int GetNumberOfCellsUsingEdge(int edgeId)
vtkGenericSubdivisionErrorMetric
Objects that compute error during cell tessellation.
Definition: vtkGenericSubdivisionErrorMetric.h:49
vtkSimpleCellTessellator::CellIterator
vtkGenericCellIterator * CellIterator
Used to iterate over edges boundaries in GetNumberOfCellsUsingEdges()
Definition: vtkSimpleCellTessellator.h:291
vtkSimpleCellTessellator
helper class to perform cell tessellation
Definition: vtkSimpleCellTessellator.h:69
vtkGenericDataSet
defines dataset interface
Definition: vtkGenericDataSet.h:70
vtkOrderedTriangulator
helper class to generate triangulations
Definition: vtkOrderedTriangulator.h:115
vtkSimpleCellTessellator::GenericCell
vtkGenericAdaptorCell * GenericCell
To access the higher order cell from third party library.
Definition: vtkSimpleCellTessellator.h:259
vtkSimpleCellTessellator::AllocatePointIds
void AllocatePointIds(int size)
Allocate some memory if PointIds does not exist or is smaller than size.
vtkSimpleCellTessellator::Triangulate
void Triangulate(vtkGenericAdaptorCell *cell, vtkGenericAttributeCollection *att, vtkDoubleArray *points, vtkCellArray *cellArray, vtkPointData *internalPd) override
Triangulate a 2D ‘cell’.
vtkSimpleCellTessellator::FixedSubdivisions
int FixedSubdivisions
Definition: vtkSimpleCellTessellator.h:364
vtkX3D::level
@ level
Definition: vtkX3D.h:401
vtkSimpleCellTessellator::Reset
void Reset()
Reset the output for repeated use of this class.
vtkSimpleCellTessellator::~vtkSimpleCellTessellator
~vtkSimpleCellTessellator() override
vtkX3D::points
@ points
Definition: vtkX3D.h:452
vtkGenericCellTessellator
helper class to perform cell tessellation
Definition: vtkGenericCellTessellator.h:59
vtkSimpleCellTessellator::SetFixedSubdivisions
void SetFixedSubdivisions(int level)
Set the number of fixed subdivisions.
vtkSimpleCellTessellator::Initialize
void Initialize(vtkGenericDataSet *ds) override
Initialize the tessellator with a data set ‘ds’.
vtkSimpleCellTessellator::AttributeCollection
vtkGenericAttributeCollection * AttributeCollection
To access the higher order field from third party library.
Definition: vtkSimpleCellTessellator.h:296
vtkSimpleCellTessellator::PointOffset
int PointOffset
Number of double value to skip to go to the next point into Scalars array It is 6+attributeCollection...
Definition: vtkSimpleCellTessellator.h:286
vtkSimpleCellTessellator::Triangulator
vtkOrderedTriangulator * Triangulator
Definition: vtkSimpleCellTessellator.h:383
vtkIndent
a simple class to control print indentation
Definition: vtkIndent.h:34
vtkSimpleCellTessellator::NumberOfPoints
vtkIdType NumberOfPoints
Number of points in the dataset to be tessellated.
Definition: vtkSimpleCellTessellator.h:362
vtkCellArray
object to represent cell connectivity
Definition: vtkCellArray.h:180
vtkIdList
list of point or cell ids
Definition: vtkIdList.h:31
vtkX3D::size
@ size
Definition: vtkX3D.h:259
vtkSimpleCellTessellator::TriangulateTriangle
void TriangulateTriangle(vtkGenericAdaptorCell *cell, vtkIdType *localIds, vtkIdType *ids, const vtkIdType *edgeIds, vtkGenericAttributeCollection *att, vtkDoubleArray *points, vtkCellArray *cellArray, vtkPointData *internalPd)
Triangulate a triangle of ‘cell’.
vtkSimpleCellTessellator::GetNumberOfCellsUsingFace
int GetNumberOfCellsUsingFace(int faceId)
vtkSimpleCellTessellator::EdgeTable
vtkGenericEdgeTable * EdgeTable
HashTable instead of vtkPointLocator.
Definition: vtkSimpleCellTessellator.h:206
vtkGenericEdgeTable
keep track of edges (defined by pair of integer id's)
Definition: vtkGenericEdgeTable.h:40
vtkSimpleCellTessellator::CopyPoint
void CopyPoint(vtkIdType pointId)
Extract point ‘pointId’ from the edge table to the output point and output point data.
vtkSimpleCellTessellator::PointIdsCapacity
int PointIdsCapacity
Definition: vtkSimpleCellTessellator.h:396
vtkSimpleCellTessellator::PrintSelf
void PrintSelf(ostream &os, vtkIndent indent) override
Methods invoked by print to print information about the object including superclasses.
vtkSimpleCellTessellator::FindEdgeParent2D
int FindEdgeParent2D(double p1[3], double p2[3], int &localId)
Return 1 if the parent of edge defined by vertices (‘p1’,‘p2’) in parametric coordinates,...
vtkSimpleCellTessellator::FaceIds
const vtkIdType * FaceIds
For each face (4) of the sub-tetra, there is the id of the original face or -1 if the face is not an ...
Definition: vtkSimpleCellTessellator.h:377
vtkSimpleCellTessellator::GetFixedSubdivisions
int GetFixedSubdivisions()
Return the number of fixed subdivisions.
vtkSimpleCellTessellator::vtkSimpleCellTessellator
vtkSimpleCellTessellator()
vtkSimpleCellTessellator::Polygon
vtkPolygon * Polygon
Definition: vtkSimpleCellTessellator.h:390
vtkSimpleCellTessellator::MaxSubdivisionLevel
int MaxSubdivisionLevel
Definition: vtkSimpleCellTessellator.h:365
vtkSimpleCellTessellator::FindEdgeParent
int FindEdgeParent(double p1[3], double p2[3], int &localId)
Return 1 if the parent of edge defined by vertices (‘p1’,‘p2’) in parametric coordinates,...
vtkSimpleCellTessellator::SetMaxSubdivisionLevel
void SetMaxSubdivisionLevel(int level)
Set the maximum level of subdivision.
vtkSimpleCellTessellator::FindEdgeReferenceCount
int FindEdgeReferenceCount(double p1[3], double p2[3], vtkIdType &e1, vtkIdType &e2)
vtkGenericAttributeCollection
a collection of attributes
Definition: vtkGenericAttributeCollection.h:34
vtkDoubleArray
dynamic, self-adjusting array of double
Definition: vtkDoubleArray.h:36
vtkSimpleCellTessellator::TessellateFace
void TessellateFace(vtkGenericAdaptorCell *cell, vtkGenericAttributeCollection *att, vtkIdType index, vtkDoubleArray *points, vtkCellArray *cellArray, vtkPointData *internalPd) override
Tessellate a face of a 3D ‘cell’.
vtkSimpleCellTessellator::InsertEdgesIntoEdgeTable
void InsertEdgesIntoEdgeTable(vtkTriangleTile &tri)
vtkSimpleCellTessellator::EdgeIds
const vtkIdType * EdgeIds
For each edge (6) of the sub-tetra, there is the id of the original edge or -1 if the edge is not an ...
Definition: vtkSimpleCellTessellator.h:372
vtkX3D::index
@ index
Definition: vtkX3D.h:252
vtkSimpleCellTessellator::PointIds
vtkIdType * PointIds
Definition: vtkSimpleCellTessellator.h:395
vtkSimpleCellTessellator::TessellatePointData
vtkPointData * TessellatePointData
Definition: vtkSimpleCellTessellator.h:304
vtkSimpleCellTessellator::Connectivity
vtkCellArray * Connectivity
Definition: vtkSimpleCellTessellator.h:387
vtkSimpleCellTessellator::ScalarsCapacity
int ScalarsCapacity
Definition: vtkSimpleCellTessellator.h:280
vtkSimpleCellTessellator::InitTetraTile
void InitTetraTile(vtkTetraTile &root, const vtkIdType *localIds, vtkIdType *ids, int *edgeIds, int *faceIds)
Initialize ‘root’ with the sub-tetra defined by the ‘localIds’ points on the complex cell,...