#include <vtkPolygon.h>
vtkPolygon is a concrete implementation of vtkCell to represent a 2D n-sided polygon. The polygons cannot have any internal holes, and cannot self-intersect. Define the polygon with n-points ordered in the counter- clockwise direction; do not repeat the last point.
Definition at line 43 of file vtkPolygon.h.
Public Types | |
typedef vtkCell | Superclass |
Public Member Functions | |
virtual const char * | GetClassName () |
virtual int | IsA (const char *type) |
void | PrintSelf (ostream &os, vtkIndent indent) |
double | ComputeArea () |
void | ComputeWeights (double x[3], double *weights) |
int | Triangulate (vtkIdList *outTris) |
int | NonDegenerateTriangulate (vtkIdList *outTris) |
int | GetCellType () |
int | GetCellDimension () |
int | GetNumberOfEdges () |
int | GetNumberOfFaces () |
vtkCell * | GetEdge (int edgeId) |
vtkCell * | GetFace (int) |
int | CellBoundary (int subId, double pcoords[3], vtkIdList *pts) |
void | Contour (double value, vtkDataArray *cellScalars, vtkIncrementalPointLocator *locator, vtkCellArray *verts, vtkCellArray *lines, vtkCellArray *polys, vtkPointData *inPd, vtkPointData *outPd, vtkCellData *inCd, vtkIdType cellId, vtkCellData *outCd) |
void | Clip (double value, vtkDataArray *cellScalars, vtkIncrementalPointLocator *locator, vtkCellArray *tris, vtkPointData *inPd, vtkPointData *outPd, vtkCellData *inCd, vtkIdType cellId, vtkCellData *outCd, int insideOut) |
int | EvaluatePosition (double x[3], double *closestPoint, int &subId, double pcoords[3], double &dist2, double *weights) |
void | EvaluateLocation (int &subId, double pcoords[3], double x[3], double *weights) |
int | IntersectWithLine (double p1[3], double p2[3], double tol, double &t, double x[3], double pcoords[3], int &subId) |
int | Triangulate (int index, vtkIdList *ptIds, vtkPoints *pts) |
void | Derivatives (int subId, double pcoords[3], double *values, int dim, double *derivs) |
int | IsPrimaryCell () |
virtual void | InterpolateFunctions (double x[3], double *sf) |
virtual void | InterpolateDerivs (double x[3], double *derivs) |
int | ParameterizePolygon (double p0[3], double p10[3], double &l10, double p20[3], double &l20, double n[3]) |
virtual bool | GetUseMVCInterpolation () |
virtual void | SetUseMVCInterpolation (bool) |
Static Public Member Functions | |
static vtkPolygon * | New () |
static int | IsTypeOf (const char *type) |
static vtkPolygon * | SafeDownCast (vtkObject *o) |
static void | ComputeNormal (int numPts, double *pts, double n[3]) |
static void | ComputeNormal (vtkPoints *p, int numPts, vtkIdType *pts, double n[3]) |
static void | ComputeNormal (vtkPoints *p, double n[3]) |
static void | ComputeNormal (vtkIdTypeArray *ids, vtkPoints *pts, double n[3]) |
static void | ComputeCentroid (vtkIdTypeArray *ids, vtkPoints *pts, double centroid[3]) |
static double | ComputeArea (vtkPoints *p, vtkIdType numPts, vtkIdType *pts, double normal[3]) |
static int | PointInPolygon (double x[3], int numPts, double *pts, double bounds[6], double n[3]) |
static double | DistanceToPolygon (double x[3], int numPts, double *pts, double bounds[6], double closest[3]) |
static int | IntersectPolygonWithPolygon (int npts, double *pts, double bounds[6], int npts2, double *pts2, double bounds2[3], double tol, double x[3]) |
static int | IntersectConvex2DCells (vtkCell *cell1, vtkCell *cell2, double tol, double p0[3], double p1[3]) |
Protected Member Functions | |
vtkPolygon () | |
~vtkPolygon () | |
void | InterpolateFunctionsUsingMVC (double x[3], double *weights) |
int | EarCutTriangulation () |
Protected Attributes | |
double | Tolerance |
int | SuccessfulTriangulation |
double | Normal [3] |
vtkIdList * | Tris |
vtkTriangle * | Triangle |
vtkQuad * | Quad |
vtkDoubleArray * | TriScalars |
vtkLine * | Line |
bool | UseMVCInterpolation |
typedef vtkCell vtkPolygon::Superclass |
vtkPolygon::vtkPolygon | ( | ) | [protected] |
vtkPolygon::~vtkPolygon | ( | ) | [protected] |
static vtkPolygon* vtkPolygon::New | ( | ) | [static] |
Create an object with Debug turned off, modified time initialized to zero, and reference counting on.
Reimplemented from vtkObject.
virtual const char* vtkPolygon::GetClassName | ( | ) | [virtual] |
Reimplemented from vtkCell.
static int vtkPolygon::IsTypeOf | ( | const char * | name | ) | [static] |
Return 1 if this class type is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeMacro found in vtkSetGet.h.
Reimplemented from vtkCell.
virtual int vtkPolygon::IsA | ( | const char * | name | ) | [virtual] |
Return 1 if this class is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeMacro found in vtkSetGet.h.
Reimplemented from vtkCell.
static vtkPolygon* vtkPolygon::SafeDownCast | ( | vtkObject * | o | ) | [static] |
Reimplemented from vtkCell.
void vtkPolygon::PrintSelf | ( | ostream & | os, | |
vtkIndent | indent | |||
) | [virtual] |
int vtkPolygon::GetCellType | ( | ) | [inline, virtual] |
See the vtkCell API for descriptions of these methods.
Implements vtkCell.
Definition at line 52 of file vtkPolygon.h.
int vtkPolygon::GetCellDimension | ( | ) | [inline, virtual] |
See the vtkCell API for descriptions of these methods.
Implements vtkCell.
Definition at line 53 of file vtkPolygon.h.
int vtkPolygon::GetNumberOfEdges | ( | ) | [inline, virtual] |
See the vtkCell API for descriptions of these methods.
Implements vtkCell.
Definition at line 54 of file vtkPolygon.h.
int vtkPolygon::GetNumberOfFaces | ( | ) | [inline, virtual] |
See the vtkCell API for descriptions of these methods.
Implements vtkCell.
Definition at line 55 of file vtkPolygon.h.
vtkCell* vtkPolygon::GetEdge | ( | int | edgeId | ) | [virtual] |
vtkCell* vtkPolygon::GetFace | ( | int | ) | [inline, virtual] |
See the vtkCell API for descriptions of these methods.
Implements vtkCell.
Definition at line 57 of file vtkPolygon.h.
int vtkPolygon::CellBoundary | ( | int | subId, | |
double | pcoords[3], | |||
vtkIdList * | pts | |||
) | [virtual] |
void vtkPolygon::Contour | ( | double | value, | |
vtkDataArray * | cellScalars, | |||
vtkIncrementalPointLocator * | locator, | |||
vtkCellArray * | verts, | |||
vtkCellArray * | lines, | |||
vtkCellArray * | polys, | |||
vtkPointData * | inPd, | |||
vtkPointData * | outPd, | |||
vtkCellData * | inCd, | |||
vtkIdType | cellId, | |||
vtkCellData * | outCd | |||
) | [virtual] |
void vtkPolygon::Clip | ( | double | value, | |
vtkDataArray * | cellScalars, | |||
vtkIncrementalPointLocator * | locator, | |||
vtkCellArray * | tris, | |||
vtkPointData * | inPd, | |||
vtkPointData * | outPd, | |||
vtkCellData * | inCd, | |||
vtkIdType | cellId, | |||
vtkCellData * | outCd, | |||
int | insideOut | |||
) | [virtual] |
int vtkPolygon::EvaluatePosition | ( | double | x[3], | |
double * | closestPoint, | |||
int & | subId, | |||
double | pcoords[3], | |||
double & | dist2, | |||
double * | weights | |||
) | [virtual] |
void vtkPolygon::EvaluateLocation | ( | int & | subId, | |
double | pcoords[3], | |||
double | x[3], | |||
double * | weights | |||
) | [virtual] |
int vtkPolygon::IntersectWithLine | ( | double | p1[3], | |
double | p2[3], | |||
double | tol, | |||
double & | t, | |||
double | x[3], | |||
double | pcoords[3], | |||
int & | subId | |||
) | [virtual] |
void vtkPolygon::Derivatives | ( | int | subId, | |
double | pcoords[3], | |||
double * | values, | |||
int | dim, | |||
double * | derivs | |||
) | [virtual] |
int vtkPolygon::IsPrimaryCell | ( | ) | [inline, virtual] |
See the vtkCell API for descriptions of these methods.
Reimplemented from vtkCell.
Definition at line 79 of file vtkPolygon.h.
double vtkPolygon::ComputeArea | ( | ) |
Compute the area of a polygon. This is a convenience function which simply calls static double ComputeArea(vtkPoints *p, vtkIdType numPts, vtkIdType *pts, double normal[3]); with the appropriate parameters from the instantiated vtkPolygon.
virtual void vtkPolygon::InterpolateFunctions | ( | double | x[3], | |
double * | sf | |||
) | [virtual] |
Compute the interpolation functions/derivatives. (aka shape functions/derivatives) Two interpolation algorithms are available: 1/r^2 and Mean Value Coordinate. The former is used by default. To use the second algorithm, set UseMVCInterpolation to be true. The function assumes the input point lies on the polygon plane without checking that.
virtual void vtkPolygon::InterpolateDerivs | ( | double | x[3], | |
double * | derivs | |||
) | [virtual] |
Compute the interpolation functions/derivatives. (aka shape functions/derivatives) Two interpolation algorithms are available: 1/r^2 and Mean Value Coordinate. The former is used by default. To use the second algorithm, set UseMVCInterpolation to be true. The function assumes the input point lies on the polygon plane without checking that.
static void vtkPolygon::ComputeNormal | ( | vtkPoints * | p, | |
int | numPts, | |||
vtkIdType * | pts, | |||
double | n[3] | |||
) | [static] |
Polygon specific methods.
static void vtkPolygon::ComputeNormal | ( | vtkPoints * | p, | |
double | n[3] | |||
) | [static] |
Polygon specific methods.
static void vtkPolygon::ComputeNormal | ( | vtkIdTypeArray * | ids, | |
vtkPoints * | pts, | |||
double | n[3] | |||
) | [static] |
Polygon specific methods.
static void vtkPolygon::ComputeNormal | ( | int | numPts, | |
double * | pts, | |||
double | n[3] | |||
) | [static] |
Compute the polygon normal from an array of points. This version assumes that the polygon is convex, and looks for the first valid normal.
static void vtkPolygon::ComputeCentroid | ( | vtkIdTypeArray * | ids, | |
vtkPoints * | pts, | |||
double | centroid[3] | |||
) | [static] |
Compute the centroid of a set of points.
void vtkPolygon::ComputeWeights | ( | double | x[3], | |
double * | weights | |||
) |
Compute interpolation weights using 1/r**2 normalized sum.
static double vtkPolygon::ComputeArea | ( | vtkPoints * | p, | |
vtkIdType | numPts, | |||
vtkIdType * | pts, | |||
double | normal[3] | |||
) | [static] |
Compute the area of a polygon in 3D. The area is returned, as well as the normal (a side effect of using this method). If you desire to compute the area of a triangle, use vtkTriangleArea which is faster. If you already have a vtkPolygon instantiated, a convenience function, ComputeArea() is provided.
int vtkPolygon::ParameterizePolygon | ( | double | p0[3], | |
double | p10[3], | |||
double & | l10, | |||
double | p20[3], | |||
double & | l20, | |||
double | n[3] | |||
) |
Create a local s-t coordinate system for a polygon. The point p0 is the origin of the local system, p10 is s-axis vector, and p20 is the t-axis vector. (These are expressed in the modeling coordinate system and are vectors of dimension [3].) The values l20 and l20 are the lengths of the vectors p10 and p20, and n is the polygon normal.
static int vtkPolygon::PointInPolygon | ( | double | x[3], | |
int | numPts, | |||
double * | pts, | |||
double | bounds[6], | |||
double | n[3] | |||
) | [static] |
Determine whether point is inside polygon. Function uses ray-casting to determine if point is inside polygon. Works for arbitrary polygon shape (e.g., non-convex). Returns 0 if point is not in polygon; 1 if it is. Can also return -1 to indicate degenerate polygon.
int vtkPolygon::Triangulate | ( | vtkIdList * | outTris | ) |
Triangulate this polygon. The user must provide the vtkIdList outTris. On output, the outTris list contains the ids of the points defining the triangulation. The ids are ordered into groups of three: each three-group defines one triangle.
int vtkPolygon::NonDegenerateTriangulate | ( | vtkIdList * | outTris | ) |
Same as Triangulate(vtkIdList *outTris) but with a first pass to split the polygon into non-degenerate polygons.
static double vtkPolygon::DistanceToPolygon | ( | double | x[3], | |
int | numPts, | |||
double * | pts, | |||
double | bounds[6], | |||
double | closest[3] | |||
) | [static] |
Compute the distance of a point to a polygon. The closest point on the polygon is also returned. The bounds should be provided to accelerate the computation.
static int vtkPolygon::IntersectPolygonWithPolygon | ( | int | npts, | |
double * | pts, | |||
double | bounds[6], | |||
int | npts2, | |||
double * | pts2, | |||
double | bounds2[3], | |||
double | tol, | |||
double | x[3] | |||
) | [static] |
Method intersects two polygons. You must supply the number of points and point coordinates (npts, *pts) and the bounding box (bounds) of the two polygons. Also supply a tolerance squared for controlling error. The method returns 1 if there is an intersection, and 0 if not. A single point of intersection x[3] is also returned if there is an intersection.
static int vtkPolygon::IntersectConvex2DCells | ( | vtkCell * | cell1, | |
vtkCell * | cell2, | |||
double | tol, | |||
double | p0[3], | |||
double | p1[3] | |||
) | [static] |
Intersect two convex 2D polygons to produce a line segment as output. The return status of the methods indicated no intersection (returns 0); a single point of intersection (returns 1); or a line segment (i.e., two points of intersection, returns 2). The points of intersection are returned in the arrays p0 and p1. If less than two points of intersection are generated then p1 and/or p0 may be indeterminiate. Finally, if the two convex polygons are parallel, then "0" is returned (i.e., no intersection) even if the triangles lie on one another.
virtual bool vtkPolygon::GetUseMVCInterpolation | ( | ) | [virtual] |
Set/Get the flag indicating whether to use Mean Value Coordinate for the interpolation. If true, InterpolateFunctions() uses the Mean Value Coordinate to compute weights. Otherwise, the conventional 1/r^2 method is used. The UseMVCInterpolation parameter is set to false by default.
virtual void vtkPolygon::SetUseMVCInterpolation | ( | bool | ) | [virtual] |
Set/Get the flag indicating whether to use Mean Value Coordinate for the interpolation. If true, InterpolateFunctions() uses the Mean Value Coordinate to compute weights. Otherwise, the conventional 1/r^2 method is used. The UseMVCInterpolation parameter is set to false by default.
void vtkPolygon::InterpolateFunctionsUsingMVC | ( | double | x[3], | |
double * | weights | |||
) | [protected] |
int vtkPolygon::EarCutTriangulation | ( | ) | [protected] |
A fast triangulation method. Uses recursive divide and conquer based on plane splitting to reduce loop into triangles. The cell (e.g., triangle) is presumed properly initialized (i.e., Points and PointIds).
double vtkPolygon::Tolerance [protected] |
Definition at line 215 of file vtkPolygon.h.
int vtkPolygon::SuccessfulTriangulation [protected] |
Definition at line 216 of file vtkPolygon.h.
double vtkPolygon::Normal[3] [protected] |
Definition at line 217 of file vtkPolygon.h.
vtkIdList* vtkPolygon::Tris [protected] |
Definition at line 218 of file vtkPolygon.h.
vtkTriangle* vtkPolygon::Triangle [protected] |
Definition at line 219 of file vtkPolygon.h.
vtkQuad* vtkPolygon::Quad [protected] |
Definition at line 220 of file vtkPolygon.h.
vtkDoubleArray* vtkPolygon::TriScalars [protected] |
Definition at line 221 of file vtkPolygon.h.
vtkLine* vtkPolygon::Line [protected] |
Definition at line 222 of file vtkPolygon.h.
bool vtkPolygon::UseMVCInterpolation [protected] |
Definition at line 226 of file vtkPolygon.h.