// SPDX-FileCopyrightText: Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
// SPDX-License-Identifier: BSD-3-Clause
/**
 * @class   vtkSliceCubes
 * @brief   generate isosurface(s) from volume four slices at a time
 *
 * vtkSliceCubes is a special version of the marching cubes filter. Instead
 * of ingesting an entire volume at once it processes only four slices at
 * a time. This way, it can generate isosurfaces from huge volumes. Also, the
 * output of this object is written to a marching cubes triangle file. That
 * way, output triangles do not need to be held in memory.
 *
 * To use vtkSliceCubes you must specify an instance of vtkVolumeReader to
 * read the data. Set this object up with the proper file prefix, image range,
 * data origin, data dimensions, header size, data mask, and swap bytes flag.
 * The vtkSliceCubes object will then take over and read slices as necessary.
 * You also will need to specify the name of an output marching cubes triangle
 * file.
 *
 * @warning
 * This process object is both a source and mapper (i.e., it reads and writes
 * data to a file). This is different than the other marching cubes objects
 * (and most process objects in the system). It's specialized to handle very
 * large data.
 *
 * @warning
 * This object only extracts a single isosurface. This compares with the other
 * contouring objects in vtk that generate multiple surfaces.
 *
 * @warning
 * To read the output file use vtkMCubesReader.
 *
 * @sa
 * vtkMarchingCubes vtkContourFilter vtkMCubesReader vtkDividingCubes vtkVolumeReader
 */

#ifndef vtkSliceCubes_h
#define vtkSliceCubes_h

#include "vtkImagingHybridModule.h" // For export macro
#include "vtkObject.h"

VTK_ABI_NAMESPACE_BEGIN
class vtkVolumeReader;

class VTKIMAGINGHYBRID_EXPORT vtkSliceCubes : public vtkObject
{
public:
  static vtkSliceCubes* New();
  vtkTypeMacro(vtkSliceCubes, vtkObject);
  void PrintSelf(ostream& os, vtkIndent indent) override;

  // methods to make it look like a filter
  void Write() { this->Update(); }
  void Update();

  ///@{
  /**
   * Set/get object to read slices.
   */
  virtual void SetReader(vtkVolumeReader*);
  vtkGetObjectMacro(Reader, vtkVolumeReader);
  ///@}

  ///@{
  /**
   * Specify file name of marching cubes output file.
   */
  vtkSetFilePathMacro(FileName);
  vtkGetFilePathMacro(FileName);
  ///@}

  ///@{
  /**
   * Set/get isosurface contour value.
   */
  vtkSetMacro(Value, double);
  vtkGetMacro(Value, double);
  ///@}

  ///@{
  /**
   * Specify file name of marching cubes limits file. The limits file
   * speeds up subsequent reading of output triangle file.
   */
  vtkSetFilePathMacro(LimitsFileName);
  vtkGetFilePathMacro(LimitsFileName);
  ///@}

protected:
  vtkSliceCubes();
  ~vtkSliceCubes() override;

  void Execute();

  vtkVolumeReader* Reader;
  char* FileName;
  double Value;
  char* LimitsFileName;

private:
  vtkSliceCubes(const vtkSliceCubes&) = delete;
  void operator=(const vtkSliceCubes&) = delete;
};

VTK_ABI_NAMESPACE_END
#endif
