agi.foundation.geometry.discrete

(agi.foundation.graphics-2024r3.jar)

Class SurfacePolygonTriangulator

java.lang.Object

agi.foundation.geometry.discrete.SurfacePolygonTriangulator

public final class SurfacePolygonTriangulator
extends Object

Triangulates a polygon, with an optional hole, on a central body, into a triangle mesh and a surrounding boundary. The mesh is commonly visualized with the TriangleMeshPrimitive or SurfaceMeshPrimitive. The boundary is commonly visualized with the PolylinePrimitive.

See Also:

Triangle Mesh Primitive topic, SurfaceTriangulatorResult, TriangleMeshPrimitive, SurfaceMeshPrimitive, PolylinePrimitive

Method Summary

Modifier and Type	Method and Description
static SurfaceTriangulatorResult	compute(CentralBody centralBody, Iterable<Cartesian> positions) Computes the triangulation on the specified centralBody for a polygon whose boundary is defined by the specified positions.
static SurfaceTriangulatorResult	compute(CentralBody centralBody, Iterable<Cartesian> positions, double altitude, double granularity, WindingOrder positionsWindingOrder) Computes the triangulation on the specified centralBody for a polygon whose boundary is defined by the specified positions.
static SurfaceTriangulatorResult	compute(CentralBody centralBody, Iterable<Cartesian> positions, Iterable<Cartesian> holePositions) Computes the triangulation on the specified centralBody for a polygon whose boundary is defined by the specified positions with a hole specified by holePositions.
static SurfaceTriangulatorResult	compute(CentralBody centralBody, Iterable<Cartesian> positions, Iterable<Cartesian> holePositions, double altitude, double granularity) Computes the triangulation on the specified centralBody for a polygon whose boundary is defined by the specified positions with a hole specified by holePositions.
static SurfaceTriangulatorResult	computeCartographic(CentralBody centralBody, Iterable<Cartographic> positions) For convenience.
static SurfaceTriangulatorResult	computeCartographic(CentralBody centralBody, Iterable<Cartographic> positions, double altitude, double granularity, WindingOrder positionsWindingOrder) For convenience.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

compute

public static final SurfaceTriangulatorResult compute(CentralBody centralBody,
                                                      Iterable<Cartesian> positions)

Computes the triangulation on the specified centralBody for a polygon whose boundary is defined by the specified positions. This is equivalent to calling SurfacePolygonTriangulator.compute(agi.foundation.celestial.CentralBody,java.lang.Iterable,double,double,agi.foundation.geometry.discrete.WindingOrder) with an altitude of 0, a granularity of 1 degree, and a positionsWindingOrder of Compute.

Parameters:

centralBody - The central body to compute the triangulation on.

positions - The positions defining the boundary of the polygon, in the centralBody's fixed reference frame, to triangulate.

Returns:

A SurfaceTriangulatorResult object representing the triangulation, in the centralBody's fixed reference frame.

See Also:

SurfacePolygonTriangulator.compute(agi.foundation.celestial.CentralBody,java.lang.Iterable,double,double,agi.foundation.geometry.discrete.WindingOrder)

computeCartographic

public static final SurfaceTriangulatorResult computeCartographic(CentralBody centralBody,
                                                                  Iterable<Cartographic> positions)

For convenience. Computes the triangulation on the specified centralBody for a polygon whose boundary is defined by the specified Cartographic positions. Longitude and latitude are in radians, and altitude is in meters. This is equivalent to converting each position in positions to Cartesian and calling SurfacePolygonTriangulator.compute(agi.foundation.celestial.CentralBody,java.lang.Iterable)

See SurfacePolygonTriangulator.compute(agi.foundation.celestial.CentralBody,java.lang.Iterable,double,double,agi.foundation.geometry.discrete.WindingOrder) for a full discussion.

Parameters:

centralBody - The central body to compute the triangulation on.

positions - The positions defining the boundary of the polygon to triangulate.

Returns:

A SurfaceTriangulatorResult object representing the triangulation, in the centralBody's fixed reference frame.

See Also:

SurfacePolygonTriangulator.compute(agi.foundation.celestial.CentralBody,java.lang.Iterable,double,double,agi.foundation.geometry.discrete.WindingOrder)

compute

public static final SurfaceTriangulatorResult compute(CentralBody centralBody,
                                                      Iterable<Cartesian> positions,
                                                      Iterable<Cartesian> holePositions)

Computes the triangulation on the specified centralBody for a polygon whose boundary is defined by the specified positions with a hole specified by holePositions. This is equivalent to calling SurfacePolygonTriangulator.compute(agi.foundation.celestial.CentralBody,java.lang.Iterable,double,double,agi.foundation.geometry.discrete.WindingOrder) with an altitude of 0 and a granularity of 1 degree.

Parameters:

centralBody - The central body to compute the triangulation on.

positions - The positions defining the boundary of the polygon, in the centralBody's fixed reference frame, to triangulate.

holePositions - The positions defining the hole in the polygon, in the centralBody's fixed reference frame.

Returns:

A SurfaceTriangulatorResult object representing the triangulation, in the centralBody's fixed reference frame.

See Also:

SurfacePolygonTriangulator.compute(agi.foundation.celestial.CentralBody,java.lang.Iterable,double,double,agi.foundation.geometry.discrete.WindingOrder)

compute

public static final SurfaceTriangulatorResult compute(CentralBody centralBody,
                                                      Iterable<Cartesian> positions,
                                                      Iterable<Cartesian> holePositions,
                                                      double altitude,
                                                      double granularity)

Computes the triangulation on the specified centralBody for a polygon whose boundary is defined by the specified positions with a hole specified by holePositions.

Parameters:

centralBody - The central body to compute the triangulation on.

positions - The positions defining the boundary of the polygon, in the centralBody's fixed reference frame, to triangulate.

holePositions - The positions defining the hole in the polygon, in the centralBody's fixed reference frame.

altitude - The altitude of the triangulation. When 0, the mesh is computed to conform to the ellipsoid.

granularity - The angular separation, in radians, of positions in the triangulation. Lower granularities are more precise but create more triangles.

Returns:

A SurfaceTriangulatorResult object representing the triangulation, in the centralBody's fixed reference frame.

Throws:

ArgumentNullException - centralBody, positions, or holePositions is null.

ArgumentException - positions and holePositions must contain at least three elements.

ArgumentException - granularity must be greater than 0.

ArgumentException - Could not triangulate. The polygon may cross over itself or it may be too large.

compute

public static final SurfaceTriangulatorResult compute(CentralBody centralBody,
                                                      Iterable<Cartesian> positions,
                                                      double altitude,
                                                      double granularity,
                                                      WindingOrder positionsWindingOrder)

Computes the triangulation on the specified centralBody for a polygon whose boundary is defined by the specified positions.

Parameters:

centralBody - The central body to compute the triangulation on.

positions - The positions defining the boundary of the polygon, in the centralBody's fixed reference frame, to triangulate.

altitude - The altitude of the triangulation. When 0, the mesh is computed to conform to the ellipsoid.

granularity - The angular separation, in radians, of positions in the triangulation. Lower granularities are more precise but create more triangles.

positionsWindingOrder - The winding order of positions.

Returns:

A SurfaceTriangulatorResult object representing the triangulation, in the centralBody's fixed reference frame.

Throws:

ArgumentNullException - centralBody or positions is null.

ArgumentException - positions must contain at least three elements.

ArgumentException - granularity must be greater than 0.

UnsupportedCaseException - positionsWindingOrder must be a valid enumeration value in WindingOrder.

ArgumentException - Could not triangulate. The polygon may cross over itself or it may be too large.

computeCartographic

public static final SurfaceTriangulatorResult computeCartographic(CentralBody centralBody,
                                                                  Iterable<Cartographic> positions,
                                                                  double altitude,
                                                                  double granularity,
                                                                  WindingOrder positionsWindingOrder)

For convenience. Computes the triangulation on the specified centralBody for a polygon whose boundary is defined by the specified Cartographic positions. Longitude and latitude are in radians, and altitude is in meters. This is equivalent to converting each position in positions to Cartesian and calling SurfacePolygonTriangulator.compute(agi.foundation.celestial.CentralBody,java.lang.Iterable,double,double,agi.foundation.geometry.discrete.WindingOrder)

See SurfacePolygonTriangulator.compute(agi.foundation.celestial.CentralBody,java.lang.Iterable,double,double,agi.foundation.geometry.discrete.WindingOrder) for a full discussion.

Parameters:

centralBody - The central body to compute the triangulation on.

positions - The positions defining the boundary of the polygon to triangulate.

altitude - The altitude of the triangulation. When 0, the mesh is computed to conform to the ellipsoid.

granularity - The angular separation, in radians, of positions in the triangulation. Lower granularities are more precise but create more triangles.

positionsWindingOrder - The winding order of positions.

Returns:

A SurfaceTriangulatorResult object representing the triangulation, in the centralBody's fixed reference frame.

See Also:

SurfacePolygonTriangulator.compute(agi.foundation.celestial.CentralBody,java.lang.Iterable,double,double,agi.foundation.geometry.discrete.WindingOrder)