agi.foundation.graphics.advanced

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

Class TriangulatedSensorProjection

java.lang.Object

agi.foundation.graphics.advanced.TriangulatedSensorProjection

public class TriangulatedSensorProjection
extends Object

A SensorProjection that has been triangulated for rendering. In order to minimize memory allocations, an instance of this class can be re-used for multiple projections. Each time that TriangulatedSensorProjection.updateFromNewProjection(CentralBody,Cartesian,SensorProjection,int) is called, the triangulation is updated.

Constructor Summary

Constructors

Constructor and Description
TriangulatedSensorProjection() Initializes a new instance.

Method Summary

Modifier and Type	Method and Description
Cartesian[]	computeSurfaceBoundaryLines() Gets the boundary lines of the portions of the sensor that intersected with the surface of the central body as of the last call to TriangulatedSensorProjection.updateFromNewProjection(CentralBody,Cartesian,SensorProjection,int).
double	getMaximumRadius() Gets the maximum distance of any position in MeshVertexPositions (get) from the SensorOrigin (get) as of the last time that TriangulatedSensorProjection.updateFromNewProjection(CentralBody,Cartesian,SensorProjection,int) was called.
int[]	getMeshOutlineIndices() Gets the vertex indices defining the outline lines of the mesh.
int[]	getMeshVertexIndices() Gets the vertex indices defining the triangles of the sensor mesh.
Cartesian[]	getMeshVertexNormals() Gets the normals of the vertices defining the sensor volume mesh.
Cartesian[]	getMeshVertexPositions() Gets the positions of the vertices defining the sensor volume mesh.
Cartesian	getSensorOrigin() Gets the origin of the sensor as of the last time that TriangulatedSensorProjection.updateFromNewProjection(CentralBody,Cartesian,SensorProjection,int) was called.
BaseCollection<SurfaceTriangulatorResult>	triangulateSurfaceRegions() Triangulates the portions of the sensor that intersected with the surface of the central body as of the last call to TriangulatedSensorProjection.updateFromNewProjection(CentralBody,Cartesian,SensorProjection,int) and returns a SurfaceTriangulatorResult for each distinct region.
void	updateFromNewProjection(CentralBody centralBody, Cartesian sensorOrigin, SensorProjection projection, int approximateSamplesPerBoundary) Updates the triangulation from a given sensor projection.
void	updateFromNewProjection(CentralBody centralBody, Cartesian sensorOrigin, SensorProjection projection, int approximateSamplesPerBoundary, boolean triangulateProjectionEndCap) Updates the triangulation from a given sensor projection.

Methods inherited from class java.lang.Object

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

Constructor Detail

TriangulatedSensorProjection

public TriangulatedSensorProjection()

Initializes a new instance.

Method Detail

getMeshOutlineIndices

public final int[] getMeshOutlineIndices()

Gets the vertex indices defining the outline lines of the mesh. Each pair of indices defines one line segment. The returned array will always have at least two elements. If the sensor has no outline, the two indices will be both be zero.

getMeshVertexPositions

public final Cartesian[] getMeshVertexPositions()

Gets the positions of the vertices defining the sensor volume mesh. If the sensor has no projection, this property returns null. When TriangulatedSensorProjection.updateFromNewProjection(CentralBody,Cartesian,SensorProjection,int) is called, the content of this array may be modified, or a new array may be created.

getMeshVertexNormals

public final Cartesian[] getMeshVertexNormals()

Gets the normals of the vertices defining the sensor volume mesh. If the sensor has no projection, this property returns null. When TriangulatedSensorProjection.updateFromNewProjection(CentralBody,Cartesian,SensorProjection,int) is called, the content of this array may be modified, or a new array may be created.

getMeshVertexIndices

public final int[] getMeshVertexIndices()

Gets the vertex indices defining the triangles of the sensor mesh. Each set of three indices defines one triangle with counter-clockwise winding order. If the sensor has no projection, this property returns null. When TriangulatedSensorProjection.updateFromNewProjection(CentralBody,Cartesian,SensorProjection,int) is called, the content of this array may be modified, or a new array may be created.

getSensorOrigin

public final Cartesian getSensorOrigin()

Gets the origin of the sensor as of the last time that TriangulatedSensorProjection.updateFromNewProjection(CentralBody,Cartesian,SensorProjection,int) was called.

getMaximumRadius

public final double getMaximumRadius()

Gets the maximum distance of any position in MeshVertexPositions (get) from the SensorOrigin (get) as of the last time that TriangulatedSensorProjection.updateFromNewProjection(CentralBody,Cartesian,SensorProjection,int) was called.

triangulateSurfaceRegions

public final BaseCollection<SurfaceTriangulatorResult> triangulateSurfaceRegions()

Triangulates the portions of the sensor that intersected with the surface of the central body as of the last call to TriangulatedSensorProjection.updateFromNewProjection(CentralBody,Cartesian,SensorProjection,int) and returns a SurfaceTriangulatorResult for each distinct region. If the sensor has no projection, this property returns an empty collection.

computeSurfaceBoundaryLines

public final Cartesian[] computeSurfaceBoundaryLines()

Gets the boundary lines of the portions of the sensor that intersected with the surface of the central body as of the last call to TriangulatedSensorProjection.updateFromNewProjection(CentralBody,Cartesian,SensorProjection,int). Each pair of positions in the returned array defines a line segment on the surface. The line segments are not necessarily all connected. If there are no intersections with the central body, this method returns an empty array. When TriangulatedSensorProjection.updateFromNewProjection(CentralBody,Cartesian,SensorProjection,int) is called, the content of the returned array may be modified.

Returns:

The boundary lines.

updateFromNewProjection

public final void updateFromNewProjection(CentralBody centralBody,
                                          @Nonnull
                                          Cartesian sensorOrigin,
                                          @Nonnull
                                          SensorProjection projection,
                                          int approximateSamplesPerBoundary)

Updates the triangulation from a given sensor projection.

Parameters:

centralBody - The central body onto which the sensor is projected.

sensorOrigin - The origin of the sensor, expressed in the FixedFrame (get / set) of the centralBody.

projection - The new sensor projection.

approximateSamplesPerBoundary - The number of samples to use per sensor projection boundary when triangulating.

updateFromNewProjection

public final void updateFromNewProjection(CentralBody centralBody,
                                          @Nonnull
                                          Cartesian sensorOrigin,
                                          @Nonnull
                                          SensorProjection projection,
                                          int approximateSamplesPerBoundary,
                                          boolean triangulateProjectionEndCap)

Updates the triangulation from a given sensor projection.

Parameters:

centralBody - The central body onto which the sensor is projected.

sensorOrigin - The origin of the sensor, expressed in the FixedFrame (get / set) of the centralBody.

projection - The new sensor projection.

approximateSamplesPerBoundary - The number of samples to use per sensor projection boundary when triangulating.

triangulateProjectionEndCap - Whether trianglulations will be performed for an end cap of the projection.