agi.foundation.geometry.discrete

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

Class SurfaceTriangulatorResult

java.lang.Object

agi.foundation.geometry.discrete.TriangulatorResult

agi.foundation.geometry.discrete.SurfaceTriangulatorResult

All Implemented Interfaces:

IDisposable, AutoCloseable

public final class SurfaceTriangulatorResult
extends TriangulatorResult
implements IDisposable

The result from a triangulation on the surface of a central body: a triangle mesh defined using an indexed triangle list and boundary positions surrounding the mesh. The mesh is commonly visualized with the TriangleMeshPrimitive or SurfaceMeshPrimitive. The boundary are commonly visualized with the PolylinePrimitive.

See Also:

Triangle Mesh Primitive topic, SurfaceExtentTriangulator, SurfacePolygonTriangulator, TriangleMeshPrimitive, SurfaceMeshPrimitive, PolylinePrimitive

Method Summary

Modifier and Type	Method and Description
protected void	dispose(boolean disposing)
protected void	finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
BaseCollection<Integer>	getBoundaryIndices() Gets indices into Positions that define the boundary positions that surround the mesh.
PolylineType	getBoundaryPolylineType() Gets the PolylineType of BoundaryPositions.
BaseCollection<Cartesian>	getBoundaryPositions() Gets the boundary positions that surround the mesh.
WindingOrder	getBoundaryPositionsWindingOrder() Gets the winding order of BoundaryPositions.
BoundingSphere	getBoundingSphere() Gets the bounding sphere that encompasses the mesh.
double	getGranularity() Gets the granularity, in radians, used when the triangulation was computed.
BaseCollection<Integer>	getIndices() Gets indices into Positions and Normals.
BaseCollection<Cartesian>	getNormals() Gets the normals of the mesh.
BaseCollection<Cartesian>	getPositions() Gets the positions of the mesh.
WindingOrder	getTriangleWindingOrder() Gets the orientation of front-facing triangles in the mesh.

Methods inherited from class agi.foundation.geometry.discrete.TriangulatorResult

dispose

Methods inherited from class java.lang.Object

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

Methods inherited from interface agi.foundation.compatibility.IDisposable

close, dispose

Method Detail

finalize

protected void finalize()
                 throws Throwable

Description copied from class: java.lang.Object

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. A subclass overrides the finalize method to dispose of system resources or to perform other cleanup.

The general contract of finalize is that it is invoked if and when the Java™ virtual machine has determined that there is no longer any means by which this object can be accessed by any thread that has not yet died, except as a result of an action taken by the finalization of some other object or class which is ready to be finalized. The finalize method may take any action, including making this object available again to other threads; the usual purpose of finalize, however, is to perform cleanup actions before the object is irrevocably discarded. For example, the finalize method for an object that represents an input/output connection might perform explicit I/O transactions to break the connection before the object is permanently discarded.

The finalize method of class Object performs no special action; it simply returns normally. Subclasses of Object may override this definition.

The Java programming language does not guarantee which thread will invoke the finalize method for any given object. It is guaranteed, however, that the thread that invokes finalize will not be holding any user-visible synchronization locks when finalize is invoked. If an uncaught exception is thrown by the finalize method, the exception is ignored and finalization of that object terminates.

After the finalize method has been invoked for an object, no further action is taken until the Java virtual machine has again determined that there is no longer any means by which this object can be accessed by any thread that has not yet died, including possible actions by other objects or classes which are ready to be finalized, at which point the object may be discarded.

The finalize method is never invoked more than once by a Java virtual machine for any given object.

Any exception thrown by the finalize method causes the finalization of this object to be halted, but is otherwise ignored.

Overrides:

finalize in class Object

Throws:

Throwable - the Exception raised by this method

See Also:

WeakReference, PhantomReference

dispose

protected void dispose(boolean disposing)

Overrides:

dispose in class TriangulatorResult

getGranularity

public final double getGranularity()

Gets the granularity, in radians, used when the triangulation was computed. Lower granularities are more precise but create more triangles.

getBoundaryIndices

public final BaseCollection<Integer> getBoundaryIndices()

Gets indices into Positions that define the boundary positions that surround the mesh.

See BoundaryPositions for a full discussion of boundary positions.

See Also:

BoundaryPositions

getBoundaryPositions

public final BaseCollection<Cartesian> getBoundaryPositions()

Gets the boundary positions that surround the mesh. BoundaryPositions is not necessarily the same boundary positions used to compute the mesh. In many cases, new positions are introduced to compute a mesh that conforms to the ellipsoid surface. Therefore, BoundaryPositions may contain additional positions so that a PolylinePrimitive defined with BoundaryPositions will be watertight next to a TriangleMeshPrimitive defined with SurfaceTriangulatorResult.

See Also:

BoundaryIndices, BoundaryPositionsWindingOrder

getBoundaryPositionsWindingOrder

public final WindingOrder getBoundaryPositionsWindingOrder()

Gets the winding order of BoundaryPositions.

See Also:

BoundaryPositions

getBoundaryPolylineType

public final PolylineType getBoundaryPolylineType()

Gets the PolylineType of BoundaryPositions.

getPositions

public BaseCollection<Cartesian> getPositions()

Description copied from class: TriangulatorResult

Gets the positions of the mesh.

Overrides:

getPositions in class TriangulatorResult

getNormals

public BaseCollection<Cartesian> getNormals()

Description copied from class: TriangulatorResult

Gets the normals of the mesh. Every position in Positions has corresponding normal. Normals are commonly used for lighting.

Overrides:

getNormals in class TriangulatorResult

See Also:

Triangle Mesh Primitive topic - Normals

getIndices

public BaseCollection<Integer> getIndices()

Description copied from class: TriangulatorResult

Gets indices into Positions and Normals. Every 3 indices represent 1 triangle.

Overrides:

getIndices in class TriangulatorResult

See Also:

Triangle Mesh Primitive topic - Indexed Triangle Lists, Positions, Normals

getTriangleWindingOrder

public WindingOrder getTriangleWindingOrder()

Description copied from class: TriangulatorResult

Gets the orientation of front-facing triangles in the mesh.

Overrides:

getTriangleWindingOrder in class TriangulatorResult

getBoundingSphere

public BoundingSphere getBoundingSphere()

Description copied from class: TriangulatorResult

Gets the bounding sphere that encompasses the mesh.

Overrides:

getBoundingSphere in class TriangulatorResult