VTK  9.5.2
vtkStructuredGrid.h
Go to the documentation of this file.
1// SPDX-FileCopyrightText: Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
2// SPDX-License-Identifier: BSD-3-Clause
35
36#ifndef vtkStructuredGrid_h
37#define vtkStructuredGrid_h
38
39#include "vtkCommonDataModelModule.h" // For export macro
40#include "vtkPointSet.h"
41#include "vtkWrappingHints.h" // For VTK_MARSHALAUTO
42
43#include "vtkStructuredData.h" // Needed for inline methods
44
45VTK_ABI_NAMESPACE_BEGIN
46class vtkEmptyCell;
47class vtkHexahedron;
48class vtkLine;
49class vtkQuad;
51class vtkVertex;
52
53class VTKCOMMONDATAMODEL_EXPORT VTK_MARSHALAUTO vtkStructuredGrid : public vtkPointSet
54{
55public:
58
60 void PrintSelf(ostream& os, vtkIndent indent) override;
61
65 int GetDataObjectType() VTK_FUTURE_CONST override { return VTK_STRUCTURED_GRID; }
66
70 void CopyStructure(vtkDataSet* ds) override;
71
75 void Initialize() override;
76
78
81 vtkIdType GetNumberOfCells() override;
83 double* GetPoint(vtkIdType ptId) VTK_SIZEHINT(3) override
84 {
85 return this->vtkPointSet::GetPoint(ptId);
86 }
87 void GetPoint(vtkIdType ptId, double p[3]) override { this->vtkPointSet::GetPoint(ptId, p); }
88 vtkCell* GetCell(vtkIdType cellId) override;
89 vtkCell* GetCell(int i, int j, int k) override;
90 void GetCell(vtkIdType cellId, vtkGenericCell* cell) override;
91 void GetCellBounds(vtkIdType cellId, double bounds[6]) override;
92 int GetCellType(vtkIdType cellId) override;
94 void GetCellPoints(vtkIdType cellId, vtkIdType& npts, vtkIdType const*& pts, vtkIdList* ptIds)
95 VTK_SIZEHINT(pts, npts) override;
96 void GetCellPoints(vtkIdType cellId, vtkIdList* ptIds) override;
97 void GetPointCells(vtkIdType ptId, vtkIdList* cellIds) override
98 {
99 int dims[3];
100 this->GetDimensions(dims);
101 vtkStructuredData::GetPointCells(ptId, cellIds, dims);
102 }
103 int GetMaxCellSize() override { return 8; } // hexahedron is the largest
104 int GetMaxSpatialDimension() override;
105 int GetMinSpatialDimension() override;
106 void GetCellNeighbors(vtkIdType cellId, vtkIdList* ptIds, vtkIdList* cellIds) override;
107 void GetCellNeighbors(vtkIdType cellId, vtkIdList* ptIds, vtkIdList* cellIds, int* seedLoc);
109
116
124
126
135
137
146
152 unsigned char IsPointVisible(vtkIdType ptId);
153
159 unsigned char IsCellVisible(vtkIdType cellId);
160
165 bool HasAnyBlankPoints() override;
170 bool HasAnyBlankCells() override;
171
175 vtkGetMacro(DataDescription, int);
176
183 void GetCellDims(int cellDims[3]);
184
186
189 void SetDimensions(int i, int j, int k);
190
194 void SetDimensions(const int dims[3]);
196
200 virtual void GetDimensions(int dims[3]);
201
205 int GetDataDimension();
206
208
213 void SetExtent(VTK_FUTURE_CONST int extent[6]);
214 void SetExtent(int xMin, int xMax, int yMin, int yMax, int zMin, int zMax);
215 vtkGetVector6Macro(Extent, int);
217
226 unsigned long GetActualMemorySize() override;
227
229
232 void ShallowCopy(vtkDataObject* src) override;
233 void DeepCopy(vtkDataObject* src) override;
235
239 int GetExtentType() VTK_FUTURE_CONST override { return VTK_3D_EXTENT; }
240
246 void Crop(const int* updateExtent) override;
247
249
255
265 void GetPoint(int i, int j, int k, double p[3], bool adjustForExtent = true);
266
267protected:
270
272
274
275 int Extent[6];
276
279
284 void ComputeScalarRange() override;
285
289
290private:
291 // Internal method used by DeepCopy and ShallowCopy.
292 void InternalStructuredGridCopy(vtkStructuredGrid* src);
293
294 vtkStructuredGrid(const vtkStructuredGrid&) = delete;
295 void operator=(const vtkStructuredGrid&) = delete;
296};
297
298//------------------------------------------------------------------------------
303
304//------------------------------------------------------------------------------
309
310//------------------------------------------------------------------------------
315
316//------------------------------------------------------------------------------
321
322VTK_ABI_NAMESPACE_END
323#endif
abstract class to specify cell behavior
Definition vtkCell.h:51
virtual int GetMaxSpatialDimension()
Get the maximum/minimum spatial dimensionality of the data which is the maximum/minimum dimension of ...
virtual int GetMinSpatialDimension()
Get the maximum/minimum spatial dimensionality of the data which is the maximum/minimum dimension of ...
an empty cell used as a place-holder during processing
provides thread-safe access to cells
a cell that represents a linear 3D hexahedron
list of point or cell ids
Definition vtkIdList.h:24
a simple class to control print indentation
Definition vtkIndent.h:29
Store zero or more vtkInformation instances.
Store vtkAlgorithm input/output information.
cell represents a 1D line
Definition vtkLine.h:23
vtkIdType GetNumberOfCells() override
This method always returns 0, as there are no cells in a vtkPointSet.
vtkIdType GetNumberOfPoints() override
See vtkDataSet for additional information.
void GetPoint(vtkIdType ptId, double x[3]) override
See vtkDataSet for additional information.
a cell that represents a 2D quadrilateral
Definition vtkQuad.h:28
Hold a reference to a vtkObjectBase instance.
implicit object to represent cell connectivity
static vtkIdType GetNumberOfCells(const int ext[6], int dataDescription=VTK_EMPTY)
Given the grid extent, this method returns the total number of cells within the extent.
static int GetDataDimension(int dataDescription)
Return the topological dimension of the data (e.g., 0, 1, 2, or 3D).
static void GetPointCells(vtkIdType ptId, vtkIdList *cellIds, VTK_FUTURE_CONST int dim[3])
Get the cells using a point.
vtkSmartPointer< vtkStructuredCellArray > StructuredCells
virtual void GetDimensions(int dims[3])
Get dimensions of this structured grid based on its extent.
static vtkStructuredGrid * GetData(vtkInformation *info)
Retrieve an instance of this class from an information object.
void SetDimensions(int i, int j, int k)
Sets the extent to be 0 to i-1, 0 to j-1, and 0 to k-1.
vtkIdType GetCellSize(vtkIdType cellId) override
Standard vtkDataSet API methods.
void GetCellDims(int cellDims[3])
Given the node dimensions of this grid instance, this method computes the node dimensions.
void BlankCell(vtkIdType ptId)
Methods for supporting blanking of cells.
void GetPoint(vtkIdType ptId, double p[3]) override
Standard vtkDataSet API methods.
void BlankPoint(vtkIdType ptId)
Methods for supporting blanking of cells.
vtkStructuredCellArray * GetCells()
Return the structured grid connectivity array.
vtkCell * GetCell(int i, int j, int k) override
Standard vtkDataSet API methods.
void GetCellNeighbors(vtkIdType cellId, vtkIdList *ptIds, vtkIdList *cellIds) override
Standard vtkDataSet API methods.
void GetCellBounds(vtkIdType cellId, double bounds[6]) override
Standard vtkDataSet API methods.
void GetCellPoints(vtkIdType cellId, vtkIdList *ptIds) override
Standard vtkDataSet API methods.
void GetCell(vtkIdType cellId, vtkGenericCell *cell) override
Standard vtkDataSet API methods.
void PrintSelf(ostream &os, vtkIndent indent) override
Standard methods for type information and printing.
void GetPointCells(vtkIdType ptId, vtkIdList *cellIds) override
Standard vtkDataSet API methods.
int GetMaxCellSize() override
Standard vtkDataSet API methods.
int GetDataDimension()
Return the dimensionality of the data.
void BuildImplicitStructures()
int GetExtentType() VTK_FUTURE_CONST override
The extent type is a 3D extent.
~vtkStructuredGrid() override
void ComputeScalarRange() override
Compute the range of the scalars and cache it into ScalarRange only if the cache became invalid (Scal...
int GetMaxSpatialDimension() override
Standard vtkDataSet API methods.
vtkIdType GetNumberOfPoints() override
Standard vtkDataSet API methods.
double * GetPoint(vtkIdType ptId) override
Standard vtkDataSet API methods.
void DeepCopy(vtkDataObject *src) override
Shallow and Deep copy.
vtkIdType GetNumberOfCells() override
Standard vtkDataSet API methods.
bool HasAnyBlankCells() override
Returns 1 if there is any visibility constraint on the cells, 0 otherwise.
void UnBlankPoint(vtkIdType ptId)
Methods for supporting blanking of cells.
vtkCell * GetCell(vtkIdType cellId) override
Standard vtkDataSet API methods.
unsigned long GetActualMemorySize() override
Return the actual size of the data in kibibytes (1024 bytes).
void Crop(const int *updateExtent) override
Reallocates and copies to set the Extent to the UpdateExtent.
void GetCellPoints(vtkIdType cellId, vtkIdType &npts, vtkIdType const *&pts, vtkIdList *ptIds) override
Standard vtkDataSet API methods.
int GetDataObjectType() VTK_FUTURE_CONST override
Return what type of dataset this is.
unsigned char IsCellVisible(vtkIdType cellId)
Return non-zero value if specified point is visible.
int GetCellType(vtkIdType cellId) override
Standard vtkDataSet API methods.
void ShallowCopy(vtkDataObject *src) override
Shallow and Deep copy.
void CopyStructure(vtkDataSet *ds) override
Copy the geometric and topological structure of an input poly data object.
static vtkStructuredGrid * GetData(vtkInformationVector *v, int i=0)
Retrieve an instance of this class from an information object.
unsigned char IsPointVisible(vtkIdType ptId)
Return non-zero value if specified point is visible.
void GetPoint(int i, int j, int k, double p[3], bool adjustForExtent=true)
Get a point in the grid.
static vtkStructuredGrid * ExtendedNew()
bool HasAnyBlankPoints() override
Returns 1 if there is any visibility constraint on the points, 0 otherwise.
static vtkStructuredGrid * New()
void SetExtent(int xMin, int xMax, int yMin, int yMax, int zMin, int zMax)
Different ways to set the extent of the data array.
vtkSmartPointer< vtkConstantArray< int > > StructuredCellTypes
void SetExtent(VTK_FUTURE_CONST int extent[6])
Different ways to set the extent of the data array.
void GetCellNeighbors(vtkIdType cellId, vtkIdList *ptIds, vtkIdList *cellIds, int *seedLoc)
Standard vtkDataSet API methods.
void UnBlankCell(vtkIdType ptId)
Methods for supporting blanking of cells.
int GetMinSpatialDimension() override
Standard vtkDataSet API methods.
void Initialize() override
Restore object to initial state.
vtkConstantArray< int > * GetCellTypesArray()
Get the array of all cell types in the structured grid.
void SetDimensions(const int dims[3])
Sets the extent to be 0 to dim[i]-1 in all 3 dimensions.
dynamic, self-adjusting array of unsigned char
a cell that represents a 3D point
Definition vtkVertex.h:23
vtkImplicitArray< vtkConstantImplicitBackend< T > > vtkConstantArray
A utility alias for wrapping constant functions in implicit arrays.
#define VTK_3D_EXTENT
int vtkIdType
Definition vtkType.h:332
@ VTK_STRUCTURED_GRID
Definition vtkType.h:78
#define VTK_SIZEHINT(...)
#define VTK_MARSHALAUTO