You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
233 lines
7.9 KiB
C++
233 lines
7.9 KiB
C++
/*=========================================================================
|
|
|
|
Program: Visualization Toolkit
|
|
Module: vtkClipDataSet.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.
|
|
|
|
=========================================================================*/
|
|
/**
|
|
* @class vtkClipDataSet
|
|
* @brief clip any dataset with user-specified implicit function or input scalar data
|
|
*
|
|
* vtkClipDataSet is a filter that clips any type of dataset using either
|
|
* any subclass of vtkImplicitFunction, or the input scalar
|
|
* data. Clipping means that it actually "cuts" through the cells of
|
|
* the dataset, returning everything inside of the specified implicit
|
|
* function (or greater than the scalar value) including "pieces" of
|
|
* a cell. (Compare this with vtkExtractGeometry, which pulls out
|
|
* entire, uncut cells.) The output of this filter is an unstructured
|
|
* grid.
|
|
*
|
|
* To use this filter, you must decide if you will be clipping with an
|
|
* implicit function, or whether you will be using the input scalar
|
|
* data. If you want to clip with an implicit function, you must:
|
|
* 1) define an implicit function
|
|
* 2) set it with the SetClipFunction method
|
|
* 3) apply the GenerateClipScalarsOn method
|
|
* If a ClipFunction is not specified, or GenerateClipScalars is off
|
|
* (the default), then the input's scalar data will be used to clip
|
|
* the polydata.
|
|
*
|
|
* You can also specify a scalar value, which is used to decide what is
|
|
* inside and outside of the implicit function. You can also reverse the
|
|
* sense of what inside/outside is by setting the InsideOut instance
|
|
* variable. (The clipping algorithm proceeds by computing an implicit
|
|
* function value or using the input scalar data for each point in the
|
|
* dataset. This is compared to the scalar value to determine
|
|
* inside/outside.)
|
|
*
|
|
* This filter can be configured to compute a second output. The
|
|
* second output is the part of the cell that is clipped away. Set the
|
|
* GenerateClippedData boolean on if you wish to access this output data.
|
|
*
|
|
* @warning
|
|
* vtkClipDataSet will triangulate all types of 3D cells (i.e., create
|
|
* tetrahedra). This is true even if the cell is not actually cut. This
|
|
* is necessary to preserve compatibility across face neighbors. 2D cells
|
|
* will only be triangulated if the cutting function passes through them.
|
|
*
|
|
* @sa
|
|
* vtkImplicitFunction vtkCutter vtkClipVolume vtkClipPolyData
|
|
*/
|
|
|
|
#ifndef vtkClipDataSet_h
|
|
#define vtkClipDataSet_h
|
|
|
|
#include "vtkFiltersGeneralModule.h" // For export macro
|
|
#include "vtkUnstructuredGridAlgorithm.h"
|
|
|
|
class vtkCallbackCommand;
|
|
class vtkImplicitFunction;
|
|
class vtkIncrementalPointLocator;
|
|
|
|
class VTKFILTERSGENERAL_EXPORT vtkClipDataSet : public vtkUnstructuredGridAlgorithm
|
|
{
|
|
public:
|
|
vtkTypeMacro(vtkClipDataSet, vtkUnstructuredGridAlgorithm);
|
|
void PrintSelf(ostream& os, vtkIndent indent) override;
|
|
|
|
/**
|
|
* Construct with user-specified implicit function; InsideOut turned off;
|
|
* value set to 0.0; and generate clip scalars turned off.
|
|
*/
|
|
static vtkClipDataSet* New();
|
|
|
|
//@{
|
|
/**
|
|
* Set the clipping value of the implicit function (if clipping with
|
|
* implicit function) or scalar value (if clipping with
|
|
* scalars). The default value is 0.0. This value is ignored if
|
|
* UseValueAsOffset is true and a clip function is defined.
|
|
*/
|
|
vtkSetMacro(Value, double);
|
|
vtkGetMacro(Value, double);
|
|
//@}
|
|
|
|
//@{
|
|
/**
|
|
* If UseValueAsOffset is true, Value is used as an offset parameter to
|
|
* the implicit function. Otherwise, Value is used only when clipping
|
|
* using a scalar array. Default is true.
|
|
*/
|
|
vtkSetMacro(UseValueAsOffset, bool);
|
|
vtkGetMacro(UseValueAsOffset, bool);
|
|
vtkBooleanMacro(UseValueAsOffset, bool);
|
|
//@}
|
|
|
|
//@{
|
|
/**
|
|
* Set/Get the InsideOut flag. When off, a vertex is considered
|
|
* inside the implicit function if its value is greater than the
|
|
* Value ivar. When InsideOutside is turned on, a vertex is
|
|
* considered inside the implicit function if its implicit function
|
|
* value is less than or equal to the Value ivar. InsideOut is off
|
|
* by default.
|
|
*/
|
|
vtkSetMacro(InsideOut, vtkTypeBool);
|
|
vtkGetMacro(InsideOut, vtkTypeBool);
|
|
vtkBooleanMacro(InsideOut, vtkTypeBool);
|
|
//@}
|
|
|
|
//@{
|
|
/**
|
|
* Specify the implicit function with which to perform the
|
|
* clipping. If you do not define an implicit function,
|
|
* then the selected input scalar data will be used for clipping.
|
|
*/
|
|
virtual void SetClipFunction(vtkImplicitFunction*);
|
|
vtkGetObjectMacro(ClipFunction, vtkImplicitFunction);
|
|
//@}
|
|
|
|
//@{
|
|
/**
|
|
* If this flag is enabled, then the output scalar values will be
|
|
* interpolated from the implicit function values, and not the
|
|
* input scalar data. If you enable this flag but do not provide an
|
|
* implicit function an error will be reported.
|
|
*/
|
|
vtkSetMacro(GenerateClipScalars, vtkTypeBool);
|
|
vtkGetMacro(GenerateClipScalars, vtkTypeBool);
|
|
vtkBooleanMacro(GenerateClipScalars, vtkTypeBool);
|
|
//@}
|
|
|
|
//@{
|
|
/**
|
|
* Control whether a second output is generated. The second output
|
|
* contains the polygonal data that's been clipped away.
|
|
*/
|
|
vtkSetMacro(GenerateClippedOutput, vtkTypeBool);
|
|
vtkGetMacro(GenerateClippedOutput, vtkTypeBool);
|
|
vtkBooleanMacro(GenerateClippedOutput, vtkTypeBool);
|
|
//@}
|
|
|
|
//@{
|
|
/**
|
|
* Set the tolerance for merging clip intersection points that are near
|
|
* the vertices of cells. This tolerance is used to prevent the generation
|
|
* of degenerate primitives. Note that only 3D cells actually use this
|
|
* instance variable.
|
|
*/
|
|
vtkSetClampMacro(MergeTolerance, double, 0.0001, 0.25);
|
|
vtkGetMacro(MergeTolerance, double);
|
|
//@}
|
|
|
|
/**
|
|
* Return the Clipped output.
|
|
*/
|
|
vtkUnstructuredGrid* GetClippedOutput();
|
|
|
|
//@{
|
|
/**
|
|
* Specify a spatial locator for merging points. By default, an
|
|
* instance of vtkMergePoints is used.
|
|
*/
|
|
void SetLocator(vtkIncrementalPointLocator* locator);
|
|
vtkGetObjectMacro(Locator, vtkIncrementalPointLocator);
|
|
//@}
|
|
|
|
/**
|
|
* Create default locator. Used to create one when none is specified. The
|
|
* locator is used to merge coincident points.
|
|
*/
|
|
void CreateDefaultLocator();
|
|
|
|
/**
|
|
* Return the mtime also considering the locator and clip function.
|
|
*/
|
|
vtkMTimeType GetMTime() override;
|
|
|
|
//@{
|
|
/**
|
|
* Set/get the desired precision for the output types. See the documentation
|
|
* for the vtkAlgorithm::DesiredOutputPrecision enum for an explanation of
|
|
* the available precision settings.
|
|
*/
|
|
vtkSetClampMacro(OutputPointsPrecision, int, SINGLE_PRECISION, DEFAULT_PRECISION);
|
|
vtkGetMacro(OutputPointsPrecision, int);
|
|
//@}
|
|
|
|
protected:
|
|
vtkClipDataSet(vtkImplicitFunction* cf = nullptr);
|
|
~vtkClipDataSet() override;
|
|
|
|
int RequestData(vtkInformation*, vtkInformationVector**, vtkInformationVector*) override;
|
|
int FillInputPortInformation(int port, vtkInformation* info) override;
|
|
vtkImplicitFunction* ClipFunction;
|
|
|
|
vtkIncrementalPointLocator* Locator;
|
|
vtkTypeBool InsideOut;
|
|
double Value;
|
|
vtkTypeBool GenerateClipScalars;
|
|
|
|
vtkTypeBool GenerateClippedOutput;
|
|
double MergeTolerance;
|
|
|
|
// Callback registered with the InternalProgressObserver.
|
|
static void InternalProgressCallbackFunction(vtkObject*, unsigned long, void* clientdata, void*);
|
|
void InternalProgressCallback(vtkAlgorithm* algorithm);
|
|
// The observer to report progress from the internal readers.
|
|
vtkCallbackCommand* InternalProgressObserver;
|
|
|
|
// helper functions
|
|
void ClipVolume(vtkDataSet* input, vtkUnstructuredGrid* output);
|
|
|
|
int ClipPoints(
|
|
vtkDataSet* input, vtkUnstructuredGrid* output, vtkInformationVector** inputVector);
|
|
|
|
bool UseValueAsOffset;
|
|
int OutputPointsPrecision;
|
|
|
|
private:
|
|
vtkClipDataSet(const vtkClipDataSet&) = delete;
|
|
void operator=(const vtkClipDataSet&) = delete;
|
|
};
|
|
|
|
#endif
|