|
VTK
|
a cell that represents an n-sided polygon More...
#include <vtkPolygon.h>
Public Types | |
| typedef vtkCell | Superclass |
Public Types inherited from vtkCell | |
| typedef vtkObject | Superclass |
Public Types inherited from vtkObject | |
| typedef vtkObjectBase | Superclass |
Public Member Functions | |
| virtual int | IsA (const char *type) |
| vtkPolygon * | NewInstance () const |
| void | PrintSelf (ostream &os, vtkIndent indent) |
| 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 () |
| double | ComputeArea () |
| virtual void | InterpolateFunctions (double x[3], double *sf) |
| int | ParameterizePolygon (double p0[3], double p10[3], double &l10, double p20[3], double &l20, double n[3]) |
| int | Triangulate (vtkIdList *outTris) |
| int | NonDegenerateTriangulate (vtkIdList *outTris) |
| virtual bool | GetUseMVCInterpolation () |
| virtual void | SetUseMVCInterpolation (bool) |
Public Member Functions inherited from vtkCell | |
| vtkCell * | NewInstance () const |
| void | Initialize (int npts, vtkIdType *pts, vtkPoints *p) |
| virtual void | ShallowCopy (vtkCell *c) |
| virtual void | DeepCopy (vtkCell *c) |
| virtual int | IsLinear () |
| virtual int | RequiresInitialization () |
| virtual void | Initialize () |
| virtual int | IsExplicitCell () |
| virtual int | RequiresExplicitFaceRepresentation () |
| virtual void | SetFaces (vtkIdType *vtkNotUsed(faces)) |
| virtual vtkIdType * | GetFaces () |
| vtkPoints * | GetPoints () |
| vtkIdType | GetNumberOfPoints () |
| vtkIdList * | GetPointIds () |
| vtkIdType | GetPointId (int ptId) |
| void | GetBounds (double bounds[6]) |
| double * | GetBounds () |
| double | GetLength2 () |
| virtual int | GetParametricCenter (double pcoords[3]) |
| virtual double | GetParametricDistance (double pcoords[3]) |
| virtual double * | GetParametricCoords () |
| virtual void | InterpolateFunctions (double vtkNotUsed(pcoords)[3], double *vtkNotUsed(weight)) |
| virtual void | InterpolateDerivs (double vtkNotUsed(pcoords)[3], double *vtkNotUsed(derivs)) |
Public Member Functions inherited from vtkObject | |
| vtkObject * | NewInstance () const |
| virtual void | DebugOn () |
| virtual void | DebugOff () |
| bool | GetDebug () |
| void | SetDebug (bool debugFlag) |
| virtual void | Modified () |
| virtual unsigned long | GetMTime () |
| unsigned long | AddObserver (unsigned long event, vtkCommand *, float priority=0.0f) |
| unsigned long | AddObserver (const char *event, vtkCommand *, float priority=0.0f) |
| vtkCommand * | GetCommand (unsigned long tag) |
| void | RemoveObserver (vtkCommand *) |
| void | RemoveObservers (unsigned long event, vtkCommand *) |
| void | RemoveObservers (const char *event, vtkCommand *) |
| int | HasObserver (unsigned long event, vtkCommand *) |
| int | HasObserver (const char *event, vtkCommand *) |
| void | RemoveObserver (unsigned long tag) |
| void | RemoveObservers (unsigned long event) |
| void | RemoveObservers (const char *event) |
| void | RemoveAllObservers () |
| int | HasObserver (unsigned long event) |
| int | HasObserver (const char *event) |
| template<class U , class T > | |
| unsigned long | AddObserver (unsigned long event, U observer, void(T::*callback)(), float priority=0.0f) |
| template<class U , class T > | |
| unsigned long | AddObserver (unsigned long event, U observer, void(T::*callback)(vtkObject *, unsigned long, void *), float priority=0.0f) |
| template<class U , class T > | |
| unsigned long | AddObserver (unsigned long event, U observer, bool(T::*callback)(vtkObject *, unsigned long, void *), float priority=0.0f) |
| int | InvokeEvent (unsigned long event, void *callData) |
| int | InvokeEvent (const char *event, void *callData) |
| int | InvokeEvent (unsigned long event) |
| int | InvokeEvent (const char *event) |
Public Member Functions inherited from vtkObjectBase | |
| const char * | GetClassName () const |
| virtual void | Delete () |
| virtual void | FastDelete () |
| void | Print (ostream &os) |
| virtual void | PrintHeader (ostream &os, vtkIndent indent) |
| virtual void | PrintTrailer (ostream &os, vtkIndent indent) |
| virtual void | Register (vtkObjectBase *o) |
| virtual void | UnRegister (vtkObjectBase *o) |
| int | GetReferenceCount () |
| void | SetReferenceCount (int) |
| void | PrintRevisions (ostream &) |
Static Public Member Functions | |
| static vtkPolygon * | New () |
| static int | IsTypeOf (const char *type) |
| static vtkPolygon * | SafeDownCast (vtkObjectBase *o) |
| 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 | ComputeNormal (int numPts, double *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]) |
Static Public Member Functions inherited from vtkCell | |
| static int | IsTypeOf (const char *type) |
| static vtkCell * | SafeDownCast (vtkObjectBase *o) |
Static Public Member Functions inherited from vtkObject | |
| static int | IsTypeOf (const char *type) |
| static vtkObject * | SafeDownCast (vtkObjectBase *o) |
| static vtkObject * | New () |
| static void | BreakOnError () |
| static void | SetGlobalWarningDisplay (int val) |
| static void | GlobalWarningDisplayOn () |
| static void | GlobalWarningDisplayOff () |
| static int | GetGlobalWarningDisplay () |
Static Public Member Functions inherited from vtkObjectBase | |
| static int | IsTypeOf (const char *name) |
| static vtkObjectBase * | New () |
Protected Member Functions | |
| virtual vtkObjectBase * | NewInstanceInternal () const |
| vtkPolygon () | |
| ~vtkPolygon () | |
| void | InterpolateFunctionsUsingMVC (double x[3], double *weights) |
| int | EarCutTriangulation () |
Protected Member Functions inherited from vtkCell | |
| vtkCell () | |
| ~vtkCell () | |
Protected Member Functions inherited from vtkObject | |
| vtkObject () | |
| virtual | ~vtkObject () |
| virtual void | RegisterInternal (vtkObjectBase *, int check) |
| virtual void | UnRegisterInternal (vtkObjectBase *, int check) |
| void | InternalGrabFocus (vtkCommand *mouseEvents, vtkCommand *keypressEvents=NULL) |
| void | InternalReleaseFocus () |
Protected Member Functions inherited from vtkObjectBase | |
| vtkObjectBase () | |
| virtual | ~vtkObjectBase () |
| virtual void | CollectRevisions (ostream &) |
| virtual void | ReportReferences (vtkGarbageCollector *) |
| vtkObjectBase (const vtkObjectBase &) | |
| void | operator= (const vtkObjectBase &) |
Protected Attributes | |
| double | Tolerance |
| int | SuccessfulTriangulation |
| double | Normal [3] |
| vtkIdList * | Tris |
| vtkTriangle * | Triangle |
| vtkQuad * | Quad |
| vtkDoubleArray * | TriScalars |
| vtkLine * | Line |
| bool | UseMVCInterpolation |
Protected Attributes inherited from vtkCell | |
| double | Bounds [6] |
Protected Attributes inherited from vtkObject | |
| bool | Debug |
| vtkTimeStamp | MTime |
| vtkSubjectHelper * | SubjectHelper |
Protected Attributes inherited from vtkObjectBase | |
| vtkAtomicInt32 | ReferenceCount |
| vtkWeakPointerBase ** | WeakPointers |
Additional Inherited Members | |
Public Attributes inherited from vtkCell | |
| vtkPoints * | Points |
| vtkIdList * | PointIds |
a cell that represents an n-sided polygon
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 44 of file vtkPolygon.h.
| typedef vtkCell vtkPolygon::Superclass |
Definition at line 48 of file vtkPolygon.h.
|
protected |
|
protected |
|
static |
|
static |
|
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 |
|
protectedvirtual |
Reimplemented from vtkCell.
| vtkPolygon* vtkPolygon::NewInstance | ( | ) | const |
|
virtual |
|
inlinevirtual |
See the vtkCell API for descriptions of these methods.
Implements vtkCell.
Definition at line 53 of file vtkPolygon.h.
|
inlinevirtual |
Return the topological dimensional of the cell (0,1,2, or 3).
Implements vtkCell.
Definition at line 54 of file vtkPolygon.h.
|
inlinevirtual |
Return the number of edges in the cell.
Implements vtkCell.
Definition at line 55 of file vtkPolygon.h.
|
inlinevirtual |
Return the number of faces in the cell.
Implements vtkCell.
Definition at line 56 of file vtkPolygon.h.
Return the edge cell from the edgeId of the cell.
Implements vtkCell.
Return the face cell from the faceId of the cell.
Implements vtkCell.
Definition at line 58 of file vtkPolygon.h.
Given parametric coordinates of a point, return the closest cell boundary, and whether the point is inside or outside of the cell. The cell boundary is defined by a list of points (pts) that specify a face (3D cell), edge (2D cell), or vertex (1D cell). If the return value of the method is != 0, then the point is inside the cell.
Implements vtkCell.
|
virtual |
Generate contouring primitives. The scalar list cellScalars are scalar values at each cell point. The point locator is essentially a points list that merges points as they are inserted (i.e., prevents duplicates). Contouring primitives can be vertices, lines, or polygons. It is possible to interpolate point data along the edge by providing input and output point data - if outPd is NULL, then no interpolation is performed. Also, if the output cell data is non-NULL, the cell data from the contoured cell is passed to the generated contouring primitives. (Note: the CopyAllocate() method must be invoked on both the output cell and point data. The cellId refers to the cell from which the cell data is copied.)
Implements vtkCell.
|
virtual |
Cut (or clip) the cell based on the input cellScalars and the specified value. The output of the clip operation will be one or more cells of the same topological dimension as the original cell. The flag insideOut controls what part of the cell is considered inside - normally cell points whose scalar value is greater than "value" are considered inside. If insideOut is on, this is reversed. Also, if the output cell data is non-NULL, the cell data from the clipped cell is passed to the generated contouring primitives. (Note: the CopyAllocate() method must be invoked on both the output cell and point data. The cellId refers to the cell from which the cell data is copied.)
Implements vtkCell.
|
virtual |
Given a point x[3] return inside(=1), outside(=0) cell, or (-1) computational problem encountered; evaluate parametric coordinates, sub-cell id (!=0 only if cell is composite), distance squared of point x[3] to cell (in particular, the sub-cell indicated), closest point on cell to x[3] (unless closestPoint is null, in which case, the closest point and dist2 are not found), and interpolation weights in cell. (The number of weights is equal to the number of points defining the cell). Note: on rare occasions a -1 is returned from the method. This means that numerical error has occurred and all data returned from this method should be ignored. Also, inside/outside is determine parametrically. That is, a point is inside if it satisfies parametric limits. This can cause problems for cells of topological dimension 2 or less, since a point in 3D can project onto the cell within parametric limits but be "far" from the cell. Thus the value dist2 may be checked to determine true in/out.
Implements vtkCell.
|
virtual |
Determine global coordinate (x[3]) from subId and parametric coordinates. Also returns interpolation weights. (The number of weights is equal to the number of points in the cell.)
Implements vtkCell.
|
virtual |
Intersect with a ray. Return parametric coordinates (both line and cell) and global intersection coordinates, given ray definition p1[3], p2[3] and tolerance tol. The method returns non-zero value if intersection occurs. A parametric distance t between 0 and 1 along the ray representing the intersection point, the point coordinates x[3] in data coordinates and also pcoords[3] in parametric coordinates. subId is the index within the cell if a composed cell like a triangle strip.
Implements vtkCell.
Generate simplices of proper dimension. If cell is 3D, tetrahedron are generated; if 2D triangles; if 1D lines; if 0D points. The form of the output is a sequence of points, each n+1 points (where n is topological cell dimension) defining a simplex. The index is a parameter that controls which triangulation to use (if more than one is possible). If numerical degeneracy encountered, 0 is returned, otherwise 1 is returned. This method does not insert new points: all the points that define the simplices are the points that define the cell.
Implements vtkCell.
|
virtual |
Compute derivatives given cell subId and parametric coordinates. The values array is a series of data value(s) at the cell points. There is a one-to-one correspondence between cell point and data value(s). Dim is the number of data values per cell point. Derivs are derivatives in the x-y-z coordinate directions for each data value. Thus, if computing derivatives for a scalar function in a hexahedron, dim=1, 8 values are supplied, and 3 deriv values are returned (i.e., derivatives in x-y-z directions). On the other hand, if computing derivatives of velocity (vx,vy,vz) dim=3, 24 values are supplied ((vx,vy,vz)1, (vx,vy,vz)2, ....()8), and 9 deriv values are returned ((d(vx)/dx),(d(vx)/dy),(d(vx)/dz), (d(vy)/dx),(d(vy)/dy), (d(vy)/dz), (d(vz)/dx),(d(vz)/dy),(d(vz)/dz)).
Implements vtkCell.
|
inlinevirtual |
Return whether this cell type has a fixed topology or whether the topology varies depending on the data (e.g., vtkConvexPointSet). This compares to composite cells that are typically composed of primary cells (e.g., a triangle strip composite cell is made up of triangle primary cells).
Reimplemented from vtkCell.
Definition at line 80 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.
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 |
Polygon specific methods.
|
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 |
Compute the centroid of a set of points.
|
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 |
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.
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.
Same as Triangulate(vtkIdList *outTris) but with a first pass to split the polygon into non-degenerate polygons.
|
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 |
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 |
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 |
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 |
|
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).
|
protected |
Definition at line 208 of file vtkPolygon.h.
|
protected |
Definition at line 209 of file vtkPolygon.h.
|
protected |
Definition at line 210 of file vtkPolygon.h.
|
protected |
Definition at line 211 of file vtkPolygon.h.
|
protected |
Definition at line 212 of file vtkPolygon.h.
|
protected |
Definition at line 213 of file vtkPolygon.h.
|
protected |
Definition at line 214 of file vtkPolygon.h.
|
protected |
Definition at line 215 of file vtkPolygon.h.
|
protected |
Definition at line 219 of file vtkPolygon.h.