vtkVolumeTexture.h

Go to the documentation of this file.

/*=========================================================================
 
  Program:   Visualization Toolkit
  Module:    vtkVolumeTexture.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 vtkVolumeTexture_h
#define vtkVolumeTexture_h
#include <map>    // For ImageDataBlockMap
#include <vector> // For ImageDataBlocks
 
#include "vtkMatrix4x4.h" // For vtkMatrix4
#include "vtkNew.h"       // For vtkNew
#include "vtkObject.h"
#include "vtkRenderingVolumeOpenGL2Module.h" // For export macro
#include "vtkSmartPointer.h"                 // For SmartPointer
#include "vtkTimeStamp.h"                    // For UploadTime
#include "vtkTuple.h"                        // For Size6 and Size3
 
class vtkDataArray;
class vtkDataSet;
class vtkImageData;
class vtkRenderer;
class vtkTextureObject;
class vtkVolumeProperty;
class vtkWindow;
 
class VTKRENDERINGVOLUMEOPENGL2_EXPORT vtkVolumeTexture : public vtkObject
{
  typedef vtkTuple<int, 6> Size6;
  typedef vtkTuple<int, 3> Size3;
 
public:
  static vtkVolumeTexture* New();
 
  struct VolumeBlock
  {
    VolumeBlock(vtkDataSet* dataset, vtkTextureObject* tex, Size3 const& texSize)
    {
      // Block extent is stored in vtkDataSet
      DataSet = dataset;
      TextureObject = tex;
      TextureSize = texSize;
      TupleIndex = 0;
 
      this->Extents[0] = VTK_INT_MAX;
      this->Extents[1] = VTK_INT_MIN;
      this->Extents[2] = VTK_INT_MAX;
      this->Extents[3] = VTK_INT_MIN;
      this->Extents[4] = VTK_INT_MAX;
      this->Extents[5] = VTK_INT_MIN;
    }
 
    vtkDataSet* DataSet;
    vtkTextureObject* TextureObject;
    Size3 TextureSize;
    vtkIdType TupleIndex;
    vtkNew<vtkMatrix4x4> TextureToDataset;
    vtkNew<vtkMatrix4x4> TextureToDatasetInv;
 
    float CellStep[3];
    double DatasetStepSize[3];
 
    double LoadedBounds[6];
    double LoadedBoundsAA[6];
    double VolumeGeometry[24];
    int Extents[6];
  };
 
  vtkTypeMacro(vtkVolumeTexture, vtkObject);
  void PrintSelf(ostream& os, vtkIndent indent) override;
 
  void SetPartitions(int const x, int const y, int const z);
  const Size3& GetPartitions();
 
  bool LoadVolume(vtkRenderer* ren, vtkDataSet* data, vtkDataArray* scalars, int const isCell,
    int const interpolation);
 
  void UpdateVolume(vtkVolumeProperty* property);
 
  void SortBlocksBackToFront(vtkRenderer* ren, vtkMatrix4x4* volumeMat);
 
  VolumeBlock* GetNextBlock();
  VolumeBlock* GetCurrentBlock();
 
  void ReleaseGraphicsResources(vtkWindow* win);
 
  static void GetScaleAndBias(const int scalarType, float* scalarRange, float& scale, float& bias);
  vtkDataArray* GetLoadedScalars();
 
  bool HandleLargeDataTypes;
  float Scale[4];
  float Bias[4];
  float ScalarRange[4][2];
  float CellSpacing[3];
  int InterpolationType;
  vtkTimeStamp UploadTime;
 
  int IsCellData = 0;
  vtkNew<vtkMatrix4x4> CellToPointMatrix;
  float AdjustedTexMin[4];
  float AdjustedTexMax[4];
 
  vtkSmartPointer<vtkTextureObject> CoordsTex;
 
  int CoordsTexSizes[3];
  float CoordsScale[3];
  float CoordsBias[3];
 
  vtkSmartPointer<vtkTextureObject> BlankingTex;
 
protected:
  vtkVolumeTexture();
  ~vtkVolumeTexture() override;
 
private:
  vtkVolumeTexture(const vtkVolumeTexture&) = delete;
  void operator=(const vtkVolumeTexture&) = delete;
 
  bool LoadTexture(int const interpolation, VolumeBlock* volBlock);
 
  void SplitVolume(vtkImageData* imageData, Size3 const& part);
 
  void CreateBlocks(unsigned int const format, unsigned int const internalFormat, int const type);
 
  void AdjustExtentForCell(Size6& extent);
  Size3 ComputeBlockSize(int* extent);
 
  void SelectTextureFormat(unsigned int& format, unsigned int& internalFormat, int& type,
    int const scalarType, int const noOfComponents);
 
  void ClearBlocks();
 
  // can be combined into one call
  void ComputeBounds(VolumeBlock* block);
  void UpdateTextureToDataMatrix(VolumeBlock* block);
 
  void ComputeCellToPointMatrix(int extents[6]);
 
 
  bool AreDimensionsValid(
    vtkTextureObject* texture, int const width, int const height, int const depth);
 
  bool SafeLoadTexture(vtkTextureObject* texture, int const width, int const height,
    int const depth, int numComps, int dataType, void* dataPtr);
 
  void UpdateInterpolationType(int const interpolation);
  void SetInterpolation(int const interpolation);
 
  //----------------------------------------------------------------------------
  vtkTimeStamp UpdateTime;
 
  vtkSmartPointer<vtkTextureObject> Texture;
  std::vector<vtkDataSet*> ImageDataBlocks;
  std::map<vtkDataSet*, VolumeBlock*> ImageDataBlockMap;
  std::vector<VolumeBlock*> SortedVolumeBlocks;
  size_t CurrentBlockIdx;
  bool StreamBlocks;
 
  std::vector<Size3> TextureSizes;
  Size6 FullExtent;
  Size3 FullSize;
  Size3 Partitions;
 
  vtkDataArray* Scalars;
};
 
#endif // vtkVolumeTexture_h