vtkStructuredGrid.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 vtkStructuredGrid_h
#define vtkStructuredGrid_h
 
#include "vtkCommonDataModelModule.h" // For export macro
#include "vtkDeprecation.h"           // For VTK_DEPRECATED_IN_9_3_0
#include "vtkPointSet.h"
 
#include "vtkStructuredData.h" // Needed for inline methods
 
VTK_ABI_NAMESPACE_BEGIN
class vtkEmptyCell;
class vtkHexahedron;
class vtkLine;
class vtkQuad;
class vtkUnsignedCharArray;
class vtkVertex;
 
class VTKCOMMONDATAMODEL_EXPORT vtkStructuredGrid : public vtkPointSet
{
public:
  static vtkStructuredGrid* New();
  static vtkStructuredGrid* ExtendedNew();
 
  vtkTypeMacro(vtkStructuredGrid, vtkPointSet);
  void PrintSelf(ostream& os, vtkIndent indent) override;

  int GetDataObjectType() override { return VTK_STRUCTURED_GRID; }

  void CopyStructure(vtkDataSet* ds) override;

  void Initialize() override;


  vtkIdType GetNumberOfCells() override;
  vtkIdType GetNumberOfPoints() override { return vtkPointSet::GetNumberOfPoints(); }
  double* GetPoint(vtkIdType ptId) VTK_SIZEHINT(3) override
  {
    return this->vtkPointSet::GetPoint(ptId);
  }
  void GetPoint(vtkIdType ptId, double p[3]) override { this->vtkPointSet::GetPoint(ptId, p); }
  vtkCell* GetCell(vtkIdType cellId) override;
  vtkCell* GetCell(int i, int j, int k) override;
  void GetCell(vtkIdType cellId, vtkGenericCell* cell) override;
  void GetCellBounds(vtkIdType cellId, double bounds[6]) override;
  int GetCellType(vtkIdType cellId) override;
  vtkIdType GetCellSize(vtkIdType cellId) override;
  void GetCellPoints(vtkIdType cellId, vtkIdType& npts, vtkIdType const*& pts, vtkIdList* ptIds)
    VTK_SIZEHINT(pts, npts) override;
  void GetCellPoints(vtkIdType cellId, vtkIdList* ptIds) override;
  void GetPointCells(vtkIdType ptId, vtkIdList* cellIds) override
  {
    int dims[3];
    this->GetDimensions(dims);
    vtkStructuredData::GetPointCells(ptId, cellIds, dims);
  }
  int GetMaxCellSize() override { return 8; } // hexahedron is the largest
  int GetMaxSpatialDimension() override;
  void GetCellNeighbors(vtkIdType cellId, vtkIdList* ptIds, vtkIdList* cellIds) override;
  void GetCellNeighbors(vtkIdType cellId, vtkIdList* ptIds, vtkIdList* cellIds, int* seedLoc);

  vtkStructuredCellArray* GetCells();

  vtkConstantArray<int>* GetCellTypesArray();


  void BlankPoint(vtkIdType ptId);
  void UnBlankPoint(vtkIdType ptId);


  void BlankCell(vtkIdType ptId);
  void UnBlankCell(vtkIdType ptId);

  unsigned char IsPointVisible(vtkIdType ptId);

  unsigned char IsCellVisible(vtkIdType cellId);

  bool HasAnyBlankPoints() override;
  bool HasAnyBlankCells() override;

  vtkGetMacro(DataDescription, int);

  void GetCellDims(int cellDims[3]);


  void SetDimensions(int i, int j, int k);

  void SetDimensions(const int dims[3]);


  VTK_DEPRECATED_IN_9_3_0("Please use GetDimensions(int dims[3]) instead.")
  virtual int* GetDimensions() VTK_SIZEHINT(3);

  virtual void GetDimensions(int dims[3]);

  int GetDataDimension();


  void SetExtent(VTK_FUTURE_CONST int extent[6]);
  void SetExtent(int xMin, int xMax, int yMin, int yMax, int zMin, int zMax);
  vtkGetVector6Macro(Extent, int);

  unsigned long GetActualMemorySize() override;


  void ShallowCopy(vtkDataObject* src) override;
  void DeepCopy(vtkDataObject* src) override;

  int GetExtentType() override { return VTK_3D_EXTENT; }

  void Crop(const int* updateExtent) override;


  static vtkStructuredGrid* GetData(vtkInformation* info);
  static vtkStructuredGrid* GetData(vtkInformationVector* v, int i = 0);

  void GetPoint(int i, int j, int k, double p[3], bool adjustForExtent = true);
 
protected:
  vtkStructuredGrid();
  ~vtkStructuredGrid() override;
 
  int Dimensions[3];
 
  int DataDescription;
 
  int Extent[6];
 
  vtkSmartPointer<vtkStructuredCellArray> StructuredCells;
  vtkSmartPointer<vtkConstantArray<int>> StructuredCellTypes;

  void ComputeScalarRange() override;
 
  void BuildImplicitStructures();
  void BuildCells();
  void BuildCellTypes();
 
private:
  // Internal method used by DeepCopy and ShallowCopy.
  void InternalStructuredGridCopy(vtkStructuredGrid* src);
 
  vtkStructuredGrid(const vtkStructuredGrid&) = delete;
  void operator=(const vtkStructuredGrid&) = delete;
};
 
//------------------------------------------------------------------------------
inline int vtkStructuredGrid::GetDataDimension()
{
  return vtkStructuredData::GetDataDimension(this->DataDescription);
}
 
//------------------------------------------------------------------------------
inline vtkIdType vtkStructuredGrid::GetNumberOfCells()
{
  return vtkStructuredData::GetNumberOfCells(this->Extent);
}
 
inline int vtkStructuredGrid::GetMaxSpatialDimension()
{
  return vtkStructuredData::GetDataDimension(this->DataDescription);
}
 
VTK_ABI_NAMESPACE_END
#endif