dox/Common/vtkStructuredData.h

Go to the documentation of this file.

/*=========================================================================

  Program:   Visualization Toolkit
  Module:    vtkStructuredData.h

  Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
  All rights reserved.
  See Copyright.txt or http://www.kitware.com/Copyright.htm for details.

     This software is distributed WITHOUT ANY WARRANTY; without even
     the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
     PURPOSE.  See the above copyright notice for more information.

=========================================================================*/
#ifndef __vtkStructuredData_h
#define __vtkStructuredData_h

#include "vtkObject.h"

class vtkIdList;

#define VTK_UNCHANGED 0
#define VTK_SINGLE_POINT 1
#define VTK_X_LINE 2
#define VTK_Y_LINE 3
#define VTK_Z_LINE 4
#define VTK_XY_PLANE 5
#define VTK_YZ_PLANE 6
#define VTK_XZ_PLANE 7
#define VTK_XYZ_GRID 8
#define VTK_EMPTY 9

class VTK_COMMON_EXPORT vtkStructuredData : public vtkObject
{
public:
  vtkTypeMacro(vtkStructuredData,vtkObject);


  static int SetDimensions(int inDim[3], int dim[3]);
  static int SetExtent(int inExt[6], int ext[6]);

  static int GetDataDescription(int dims[3]);

  static int GetDataDimension(int dataDescription);


  static void GetCellPoints(vtkIdType cellId, vtkIdList *ptIds,
                            int dataDescription, int dim[3]);

  static void GetPointCells(vtkIdType ptId, vtkIdList *cellIds, int dim[3]);


  static void GetCellNeighbors(vtkIdType cellId, vtkIdList *ptIds,
                               vtkIdList *cellIds, int dim[3]);


  static vtkIdType ComputePointIdForExtent(int extent[6], int ijk[3]) {
    vtkIdType ydim = static_cast<vtkIdType>(extent[3] - extent[2] + 1);
    vtkIdType xdim = static_cast<vtkIdType>(extent[1] - extent[0] + 1);
    return ((ijk[2] - extent[4])*ydim + (ijk[1] - extent[2]))*xdim 
            + (ijk[0] - extent[0]); }


  static vtkIdType ComputeCellIdForExtent(int extent[6], int ijk[3]) {
    vtkIdType ydim = static_cast<vtkIdType>(extent[3] - extent[2]);
    if (ydim == 0) ydim = 1;
    vtkIdType xdim = static_cast<vtkIdType>(extent[1] - extent[0]);
    if (xdim == 0) xdim = 1;
    return ((ijk[2] - extent[4])*(ydim) + (ijk[1] - extent[2]))*(xdim)
            + (ijk[0] - extent[0]); }


  static vtkIdType ComputePointId(int dim[3], int ijk[3]) {
    return (ijk[2]*static_cast<vtkIdType>(dim[1]) + ijk[1])*dim[0] + ijk[0];}


  static vtkIdType ComputeCellId(int dim[3], int ijk[3]) {
    return (ijk[2]*static_cast<vtkIdType>(dim[1]-1) + ijk[1])*(dim[0]-1) + ijk[0];}


  static void ComputeCellStructuredCoords(const vtkIdType cellId, int dim[3], int ijk[3])
  {
    int Ni  = dim[0]-1;
    int Nj  = dim[1]-1;
    
    int Nij = Ni*Nj;

    int k = cellId/Nij + 1;
    int j = (cellId - (k-1)*Nij)/Ni + 1;
    int i = cellId - (k-1)*Nij - (j-1)*Ni + 1;
    ijk[0] = i-1;
    ijk[1] = j-1;
    ijk[2] = k-1;
  }


  static void ComputePointStructuredCoords(const vtkIdType cellId, int dim[3], int ijk[3])
  {
    int Ni  = dim[0];
    int Nj  = dim[1];

    int Nij = Ni*Nj;

    int k = cellId/Nij + 1;
    int j = (cellId - (k-1)*Nij)/Ni + 1;
    int i = cellId - (k-1)*Nij - (j-1)*Ni + 1;
    ijk[0] = i-1;
    ijk[1] = j-1;
    ijk[2] = k-1;
  }

protected:
  vtkStructuredData() {};
  ~vtkStructuredData() {};

private:
  vtkStructuredData(const vtkStructuredData&);  // Not implemented.
  void operator=(const vtkStructuredData&);  // Not implemented.
};


#endif