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 "vtkIdList.h"       // Needed for inline methods
#include "vtkSmartPointer.h" // Needed for vtkSmartPointer

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; }

  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