vtkCellIterator.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
// SPDX-License-Identifier: BSD-3-Clause
 
#ifndef vtkCellIterator_h
#define vtkCellIterator_h
 
#include "vtkCellArray.h"             // For inline methods
#include "vtkCellType.h"              // For VTK_EMPTY_CELL
#include "vtkCommonDataModelModule.h" // For export macro
#include "vtkDeprecation.h"           // For VTK_DEPRECATED_IN_9_4_0
#include "vtkIdList.h"                // For inline methods
#include "vtkIdTypeArray.h"           // For inline methods
#include "vtkNew.h"                   // For vtkNew
#include "vtkObject.h"
 
VTK_ABI_NAMESPACE_BEGIN
class vtkGenericCell;
class vtkPoints;
 
class VTKCOMMONDATAMODEL_EXPORT vtkCellIterator : public vtkObject
{
public:
  void PrintSelf(ostream& os, vtkIndent indent) override;
  vtkAbstractTypeMacro(vtkCellIterator, vtkObject);
 
  void InitTraversal();
 
  void GoToNextCell();
 
  virtual bool IsDoneWithTraversal() = 0;
 
  int GetCellType();
 
  int GetCellDimension();
 
  virtual vtkIdType GetCellId() = 0;
 
  vtkIdList* GetPointIds();
 
  vtkPoints* GetPoints();
 
  vtkCellArray* GetCellFaces();
 
  VTK_DEPRECATED_IN_9_4_0("Please use GetCellFaces instead.")
  vtkIdList* GetFaces();
 
  void GetCell(vtkGenericCell* cell);
 
  vtkIdType GetNumberOfPoints();
 
  vtkIdType GetNumberOfFaces();
 
protected:
  vtkCellIterator();
  ~vtkCellIterator() override;
 
  virtual void ResetToFirstCell() = 0;
 
  virtual void IncrementToNextCell() = 0;
 
  virtual void FetchCellType() = 0;
 
  virtual void FetchPointIds() = 0;
 
  virtual void FetchPoints() = 0;
 
  virtual void FetchFaces() {}
 
  int CellType;
  vtkPoints* Points;
  vtkIdList* PointIds;
  vtkCellArray* Faces;
 
private:
  vtkCellIterator(const vtkCellIterator&) = delete;
  void operator=(const vtkCellIterator&) = delete;
 
  enum
  {
    UninitializedFlag = 0x0,
    CellTypeFlag = 0x1,
    PointIdsFlag = 0x2,
    PointsFlag = 0x4,
    FacesFlag = 0x8
  };
 
  void ResetCache()
  {
    this->CacheFlags = UninitializedFlag;
    this->CellType = VTK_EMPTY_CELL;
  }
 
  void SetCache(unsigned char flags) { this->CacheFlags |= flags; }
 
  bool CheckCache(unsigned char flags) { return (this->CacheFlags & flags) == flags; }
 
  vtkNew<vtkPoints> PointsContainer;
  vtkNew<vtkIdList> PointIdsContainer;
  vtkNew<vtkCellArray> FacesContainer;
  vtkNew<vtkIdList> LegacyFacesContainer;
  unsigned char CacheFlags;
};
 
//------------------------------------------------------------------------------
inline void vtkCellIterator::InitTraversal()
{
  this->ResetToFirstCell();
  this->ResetCache();
}
 
//------------------------------------------------------------------------------
inline void vtkCellIterator::GoToNextCell()
{
  this->IncrementToNextCell();
  this->ResetCache();
}
 
//------------------------------------------------------------------------------
inline int vtkCellIterator::GetCellType()
{
  if (!this->CheckCache(CellTypeFlag))
  {
    this->FetchCellType();
    this->SetCache(CellTypeFlag);
  }
  return this->CellType;
}
 
//------------------------------------------------------------------------------
inline vtkIdList* vtkCellIterator::GetPointIds()
{
  if (!this->CheckCache(PointIdsFlag))
  {
    this->FetchPointIds();
    this->SetCache(PointIdsFlag);
  }
  return this->PointIds;
}
 
//------------------------------------------------------------------------------
inline vtkPoints* vtkCellIterator::GetPoints()
{
  if (!this->CheckCache(PointsFlag))
  {
    this->FetchPoints();
    this->SetCache(PointsFlag);
  }
  return this->Points;
}
 
//------------------------------------------------------------------------------
inline vtkCellArray* vtkCellIterator::GetCellFaces()
{
  if (!this->CheckCache(FacesFlag))
  {
    this->FetchFaces();
    this->SetCache(FacesFlag);
  }
  return this->Faces;
}
 
//------------------------------------------------------------------------------
// To be removed when deprecating
inline vtkIdList* vtkCellIterator::GetFaces()
{
  if (!this->CheckCache(FacesFlag))
  {
    this->FetchFaces();
    this->SetCache(FacesFlag);
  }
  // Export Legacy Format
  vtkNew<vtkIdTypeArray> tmp;
  this->Faces->ExportLegacyFormat(tmp);
  this->LegacyFacesContainer->Initialize();
  this->LegacyFacesContainer->InsertNextId(this->Faces->GetNumberOfCells());
  for (vtkIdType idx = 0; idx < tmp->GetNumberOfValues(); ++idx)
  {
    this->LegacyFacesContainer->InsertNextId(tmp->GetValue(idx));
  }
  return this->LegacyFacesContainer;
}
 
//------------------------------------------------------------------------------
inline vtkIdType vtkCellIterator::GetNumberOfPoints()
{
  if (!this->CheckCache(PointIdsFlag))
  {
    this->FetchPointIds();
    this->SetCache(PointIdsFlag);
  }
  return this->PointIds->GetNumberOfIds();
}
 
//------------------------------------------------------------------------------
inline vtkIdType vtkCellIterator::GetNumberOfFaces()
{
  switch (this->GetCellType())
  {
    case VTK_EMPTY_CELL:
    case VTK_VERTEX:
    case VTK_POLY_VERTEX:
    case VTK_LINE:
    case VTK_POLY_LINE:
    case VTK_TRIANGLE:
    case VTK_TRIANGLE_STRIP:
    case VTK_POLYGON:
    case VTK_PIXEL:
    case VTK_QUAD:
    case VTK_QUADRATIC_EDGE:
    case VTK_QUADRATIC_TRIANGLE:
    case VTK_QUADRATIC_QUAD:
    case VTK_QUADRATIC_POLYGON:
    case VTK_BIQUADRATIC_QUAD:
    case VTK_QUADRATIC_LINEAR_QUAD:
    case VTK_BIQUADRATIC_TRIANGLE:
    case VTK_CUBIC_LINE:
    case VTK_CONVEX_POINT_SET:
    case VTK_PARAMETRIC_CURVE:
    case VTK_PARAMETRIC_SURFACE:
    case VTK_PARAMETRIC_TRI_SURFACE:
    case VTK_PARAMETRIC_QUAD_SURFACE:
    case VTK_HIGHER_ORDER_EDGE:
    case VTK_HIGHER_ORDER_TRIANGLE:
    case VTK_HIGHER_ORDER_QUAD:
    case VTK_HIGHER_ORDER_POLYGON:
    case VTK_LAGRANGE_CURVE:
    case VTK_LAGRANGE_TRIANGLE:
    case VTK_LAGRANGE_QUADRILATERAL:
    case VTK_BEZIER_CURVE:
    case VTK_BEZIER_TRIANGLE:
    case VTK_BEZIER_QUADRILATERAL:
      return 0;
 
    case VTK_TETRA:
    case VTK_QUADRATIC_TETRA:
    case VTK_PARAMETRIC_TETRA_REGION:
    case VTK_HIGHER_ORDER_TETRAHEDRON:
    case VTK_LAGRANGE_TETRAHEDRON:
    case VTK_BEZIER_TETRAHEDRON:
      return 4;
 
    case VTK_PYRAMID:
    case VTK_QUADRATIC_PYRAMID:
    case VTK_TRIQUADRATIC_PYRAMID:
    case VTK_HIGHER_ORDER_PYRAMID:
    case VTK_WEDGE:
    case VTK_QUADRATIC_WEDGE:
    case VTK_QUADRATIC_LINEAR_WEDGE:
    case VTK_BIQUADRATIC_QUADRATIC_WEDGE:
    case VTK_HIGHER_ORDER_WEDGE:
    case VTK_LAGRANGE_WEDGE:
    case VTK_BEZIER_WEDGE:
      return 5;
 
    case VTK_VOXEL:
    case VTK_HEXAHEDRON:
    case VTK_QUADRATIC_HEXAHEDRON:
    case VTK_TRIQUADRATIC_HEXAHEDRON:
    case VTK_HIGHER_ORDER_HEXAHEDRON:
    case VTK_PARAMETRIC_HEX_REGION:
    case VTK_BIQUADRATIC_QUADRATIC_HEXAHEDRON:
    case VTK_LAGRANGE_HEXAHEDRON:
    case VTK_BEZIER_HEXAHEDRON:
      return 6;
 
    case VTK_PENTAGONAL_PRISM:
      return 7;
 
    case VTK_HEXAGONAL_PRISM:
      return 8;
 
    case VTK_POLYHEDRON: // Need to look these up
      if (!this->CheckCache(FacesFlag))
      {
        this->FetchFaces();
        this->SetCache(FacesFlag);
      }
      return this->Faces->GetNumberOfCells();
 
    default:
      vtkGenericWarningMacro("Unknown cell type: " << this->CellType);
      break;
  }
 
  return 0;
}
 
VTK_ABI_NAMESPACE_END
#endif // vtkCellIterator_h