Permalink
Switch branches/tags
Nothing to show
Find file
Fetching contributors…
Cannot retrieve contributors at this time
100 lines (79 sloc) 3.83 KB
/*=========================================================================
Program: Visualization Toolkit
Module: vtkAbstractPointLocator.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.
=========================================================================*/
// .NAME vtkAbstractPointLocator - abstract class to quickly locate points in 3-space
// .SECTION Description
// vtkAbstractPointLocator is an abstract spatial search object to quickly locate points
// in 3D. vtkAbstractPointLocator works by dividing a specified region of space into
// "rectangular" buckets, and then keeping a list of points that
// lie in each bucket. Typical operation involves giving a position in 3D
// and finding the closest point. The points are provided from the specified
// dataset input.
#ifndef __vtkAbstractPointLocator_h
#define __vtkAbstractPointLocator_h
#include "vtkLocator.h"
class vtkIdList;
class VTK_FILTERING_EXPORT vtkAbstractPointLocator : public vtkLocator
{
public:
vtkTypeMacro(vtkAbstractPointLocator,vtkLocator);
void PrintSelf(ostream& os, vtkIndent indent);
// Description:
// Given a position x, return the id of the point closest to it. Alternative
// method requires separate x-y-z values.
// These methods are thread safe if BuildLocator() is directly or
// indirectly called from a single thread first.
virtual vtkIdType FindClosestPoint(const double x[3]) = 0;
vtkIdType FindClosestPoint(double x, double y, double z);
// Description:
// Given a position x and a radius r, return the id of the point
// closest to the point in that radius.
// dist2 returns the squared distance to the point.
virtual vtkIdType FindClosestPointWithinRadius(
double radius, const double x[3], double& dist2) = 0;
// Description:
// Find the closest N points to a position. This returns the closest
// N points to a position. A faster method could be created that returned
// N close points to a position, but necessarily the exact N closest.
// The returned points are sorted from closest to farthest.
// These methods are thread safe if BuildLocator() is directly or
// indirectly called from a single thread first.
virtual void FindClosestNPoints(
int N, const double x[3], vtkIdList *result) = 0;
void FindClosestNPoints(int N, double x, double y, double z,
vtkIdList *result);
// Description:
// Find all points within a specified radius R of position x.
// The result is not sorted in any specific manner.
// These methods are thread safe if BuildLocator() is directly or
// indirectly called from a single thread first.
virtual void FindPointsWithinRadius(double R, const double x[3],
vtkIdList *result) = 0;
void FindPointsWithinRadius(double R, double x, double y, double z,
vtkIdList *result);
// Description:
// Provide an accessor to the bounds.
virtual double *GetBounds() { return this->Bounds; }
virtual void GetBounds(double*);
// Description:
// See vtkLocator interface documentation.
// These methods are not thread safe.
virtual void FreeSearchStructure() = 0;
virtual void BuildLocator() = 0;
virtual void GenerateRepresentation(int level, vtkPolyData *pd) = 0;
protected:
vtkAbstractPointLocator();
virtual ~vtkAbstractPointLocator();
double Bounds[6]; // bounds of points
private:
vtkAbstractPointLocator(const vtkAbstractPointLocator&); // Not implemented.
void operator=(const vtkAbstractPointLocator&); // Not implemented.
};
#endif