agi.foundation.geometry.discrete

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

Class SurfaceExtentTriangulator

java.lang.Object

agi.foundation.geometry.discrete.SurfaceExtentTriangulator

public final class SurfaceExtentTriangulator
extends Object

Triangulates an extent 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, CartographicExtent extent) Computes a triangulation on the specified centralBody for the specified extent.
static SurfaceTriangulatorResult	compute(CentralBody centralBody, CartographicExtent extent, double altitude, double granularity) Computes a triangulation on the specified centralBody for the specified extent.

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,
                                                      CartographicExtent extent)

Computes a triangulation on the specified centralBody for the specified extent. This is equivalent to calling SurfaceExtentTriangulator.compute(agi.foundation.celestial.CentralBody,agi.foundation.coordinates.CartographicExtent,double,double) with an altitude of 0 and a granularity of 1 degree.

See SurfaceExtentTriangulator.compute(agi.foundation.celestial.CentralBody,agi.foundation.coordinates.CartographicExtent,double,double) for a full discussion.

Parameters:

centralBody - The central body to compute the triangulation on.

extent - The extent, in radians, to compute the triangulation for.

Returns:

A SurfaceTriangulatorResult object representing the triangulation.

See Also:

SurfaceExtentTriangulator.compute(agi.foundation.celestial.CentralBody,agi.foundation.coordinates.CartographicExtent,double,double)

compute

public static final SurfaceTriangulatorResult compute(CentralBody centralBody,
                                                      CartographicExtent extent,
                                                      double altitude,
                                                      double granularity)

Computes a triangulation on the specified centralBody for the specified extent.

Using SurfaceExtentTriangulator to compute the triangulation for an extent is almost always more efficient than using the more general purpose SurfacePolygonTriangulator with the 4 corners of the extent. Also, SurfacePolygonTriangulator will connect the corners with great arcs which aren't necessarily lines of constant latitude and longitude, which is guaranteed by SurfaceExtentTriangulator.

Parameters:

centralBody - The central body to compute the triangulation on.

extent - The extent, in radians, to compute the triangulation for.

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

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

Returns:

A SurfaceTriangulatorResult object representing the triangulation.

Throws:

ArgumentNullException - centralBody is null.

ArgumentOutOfRangeException - extent south and north must both be between -90 degrees and 90 degrees.

ArgumentException - granularity must be greater than 0.

See Also:

Triangle Mesh Primitive topic