vtkCell.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 vtkCell_h
#define vtkCell_h
 
#define VTK_CELL_SIZE 512
#define VTK_TOL 1.e-05 // Tolerance for geometric calculation
 
#include "vtkCommonDataModelModule.h" // For export macro
#include "vtkObject.h"
 
#include "vtkBoundingBox.h" // Needed for IntersectWithCell
#include "vtkCellType.h"    // Needed to define cell types
#include "vtkDeprecation.h" // For VTK_DEPRECATED_IN_9_4_0
#include "vtkIdList.h"      // Needed for inline methods
 
VTK_ABI_NAMESPACE_BEGIN
class vtkCellArray;
class vtkCellData;
class vtkDataArray;
class vtkPointData;
class vtkIncrementalPointLocator;
class vtkPoints;
 
class VTKCOMMONDATAMODEL_EXPORT vtkCell : public vtkObject
{
public:
  vtkTypeMacro(vtkCell, vtkObject);
  void PrintSelf(ostream& os, vtkIndent indent) override;

  void Initialize(int npts, const vtkIdType* pts, vtkPoints* p);

  void Initialize(int npts, vtkPoints* p);

  virtual void ShallowCopy(vtkCell* c);

  virtual void DeepCopy(vtkCell* c);

  virtual int GetCellType() = 0;

  virtual int GetCellDimension() = 0;

  virtual int IsLinear() VTK_FUTURE_CONST { return 1; }

  virtual int RequiresInitialization() { return 0; }
  virtual void Initialize() {}

  virtual int IsExplicitCell() VTK_FUTURE_CONST { return 0; }

  virtual int RequiresExplicitFaceRepresentation() VTK_FUTURE_CONST { return 0; }
 
  VTK_DEPRECATED_IN_9_4_0("Use SetCellFaces() after casting the cell to vtkPolyhedron.")
  virtual void SetFaces(vtkIdType* vtkNotUsed(faces)) {}
  VTK_DEPRECATED_IN_9_4_0("Use GetCellFaces() after casting the cell to vtkPolyhedron.")
  virtual vtkIdType* GetFaces() { return nullptr; }

  vtkPoints* GetPoints() { return this->Points; }

  vtkIdType GetNumberOfPoints() const { return this->PointIds->GetNumberOfIds(); }

  virtual int GetNumberOfEdges() = 0;

  virtual int GetNumberOfFaces() = 0;

  vtkIdList* GetPointIds() { return this->PointIds; }

  vtkIdType GetPointId(int ptId) VTK_EXPECTS(0 <= ptId && ptId < GetPointIds()->GetNumberOfIds())
  {
    return this->PointIds->GetId(ptId);
  }

  virtual vtkCell* GetEdge(int edgeId) = 0;

  virtual vtkCell* GetFace(int faceId) = 0;

  virtual int CellBoundary(int subId, const double pcoords[3], vtkIdList* pts) = 0;

  virtual int EvaluatePosition(const double x[3], double closestPoint[3], int& subId,
    double pcoords[3], double& dist2, double weights[]) = 0;

  virtual void EvaluateLocation(
    int& subId, const double pcoords[3], double x[3], double* weights) = 0;

  virtual void Contour(double value, vtkDataArray* cellScalars, vtkIncrementalPointLocator* locator,
    vtkCellArray* verts, vtkCellArray* lines, vtkCellArray* polys, vtkPointData* inPd,
    vtkPointData* outPd, vtkCellData* inCd, vtkIdType cellId, vtkCellData* outCd) = 0;

  virtual void Clip(double value, vtkDataArray* cellScalars, vtkIncrementalPointLocator* locator,
    vtkCellArray* connectivity, vtkPointData* inPd, vtkPointData* outPd, vtkCellData* inCd,
    vtkIdType cellId, vtkCellData* outCd, int insideOut) = 0;

  virtual int Inflate(double dist);

  virtual double ComputeBoundingSphere(double center[3]) const;

  virtual int IntersectWithLine(const double p1[3], const double p2[3], double tol, double& t,
    double x[3], double pcoords[3], int& subId) = 0;


  virtual int IntersectWithCell(vtkCell* other, double tol = 0.0);
  virtual int IntersectWithCell(vtkCell* other, const vtkBoundingBox& boudingBox,
    const vtkBoundingBox& otherBoundingBox, double tol = 0.0);

  virtual int Triangulate(int index, vtkIdList* ptIds, vtkPoints* pts);

  virtual int TriangulateIds(int index, vtkIdList* ptIds);

  virtual int TriangulateLocalIds(int index, vtkIdList* ptIds) = 0;

  virtual void Derivatives(
    int subId, const double pcoords[3], const double* values, int dim, double* derivs) = 0;

  void GetBounds(double bounds[6]);

  double* GetBounds() VTK_SIZEHINT(6);

  double GetLength2();

  virtual int GetParametricCenter(double pcoords[3]);

  virtual double GetParametricDistance(const double pcoords[3]);

  virtual int IsPrimaryCell() VTK_FUTURE_CONST { return 1; }

  virtual double* GetParametricCoords() VTK_SIZEHINT(3 * GetNumberOfPoints());

  virtual void InterpolateFunctions(const double vtkNotUsed(pcoords)[3], double* vtkNotUsed(weight))
  {
  }
  virtual void InterpolateDerivs(const double vtkNotUsed(pcoords)[3], double* vtkNotUsed(derivs)) {}
 
  // left public for quick computational access
  vtkPoints* Points;
  vtkIdList* PointIds;
 
protected:
  vtkCell();
  ~vtkCell() override;
 
  double Bounds[6];
 
private:
  vtkCell(const vtkCell&) = delete;
  void operator=(const vtkCell&) = delete;
};
 
VTK_ABI_NAMESPACE_END
#endif