agi.foundation.platforms.advanced

(agi.foundation.platforms.graphics-2024r2.jar)

Class ServiceProviderVisualizer

java.lang.Object

agi.foundation.platforms.advanced.ServiceProviderVisualizer

All Implemented Interfaces:

IDisposable, AutoCloseable

Direct Known Subclasses:

AzimuthElevationMaskVisualizer, CentralBodySurfaceCurveVisualizer, CentralBodySurfaceRegionVisualizer, FieldOfViewCentralBodyProjectionVisualizer, LinkVisualizer, LocationPointCovarianceVisualizer, MarkerVisualizer, ModelVisualizer, PointVisualizer, ReferenceFrameVisualizer, TextVisualizer, VectorVisualizer

public abstract class ServiceProviderVisualizer
extends Object
implements IDisposable

Base class for all IServiceProvider visualizers, which are used by ServiceProviderDisplay to draw IServiceProviders in Insight3D.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ServiceProviderVisualizer() Initializes a new instance.

Method Summary

Modifier and Type	Method and Description
abstract void	clear() Removes all primitives and evaluators and prepares the visualizer to be re-used by a future call to ServiceProviderVisualizer.createEvaluators(java.lang.Iterable<? extends agi.foundation.IServiceProvider>, agi.foundation.EvaluatorGroup)
abstract void	createEvaluators(Iterable<? extends IServiceProvider> serviceProviders, EvaluatorGroup group) Called by ServiceProviderDisplay to instruct the visualizer to create an Evaluator objects needed for visualization.
void	dispose() Releases any resources associated with this instance.
protected abstract void	dispose(boolean disposing) Releases any resources associated with this instance.
abstract void	initialUpdate() Called by the ServiceProviderDisplay after all evaluators have been created to instruct the visualizer to finish any remaining initialization and draw its static graphics.
abstract Collection<IServiceProvider>	pick(PickResult pickResult) Returns a list of IServiceProvider instances that were contained in the provided PickResult
abstract void	update(JulianDate time) Updates any dynamic graphics to the provided time.
abstract void	updateReferences(EvaluatorGroup group) Called by ServiceProviderDisplay to instruct the visualizer to update its evaluator references.

Methods inherited from class java.lang.Object

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

Methods inherited from interface agi.foundation.compatibility.IDisposable

close

Constructor Detail

ServiceProviderVisualizer

protected ServiceProviderVisualizer()

Initializes a new instance.

Method Detail

dispose

public final void dispose()

Releases any resources associated with this instance.

Specified by:

dispose in interface IDisposable

dispose

protected abstract void dispose(boolean disposing)

Releases any resources associated with this instance.

Parameters:

disposing - true to release both managed and unmanaged resources; false to release only unmanaged resources.

createEvaluators

public abstract void createEvaluators(@Nonnull
                                      Iterable<? extends IServiceProvider> serviceProviders,
                                      @Nonnull
                                      EvaluatorGroup group)

Called by ServiceProviderDisplay to instruct the visualizer to create an Evaluator objects needed for visualization.

Parameters:

serviceProviders - The list of service providers being visualized.

group - The EvaluatorGroup in which evaluators should be created.

updateReferences

public abstract void updateReferences(EvaluatorGroup group)

Called by ServiceProviderDisplay to instruct the visualizer to update its evaluator references.

Parameters:

group - The group from which to update evaluator references.

initialUpdate

public abstract void initialUpdate()

Called by the ServiceProviderDisplay after all evaluators have been created to instruct the visualizer to finish any remaining initialization and draw its static graphics.

update

public abstract void update(@Nonnull
                            JulianDate time)

Updates any dynamic graphics to the provided time.

Parameters:

time - The time for which to draw graphics.

clear

public abstract void clear()

Removes all primitives and evaluators and prepares the visualizer to be re-used by a future call to ServiceProviderVisualizer.createEvaluators(java.lang.Iterable<? extends agi.foundation.IServiceProvider>, agi.foundation.EvaluatorGroup)

pick

@Nonnull
public abstract Collection<IServiceProvider> pick(@Nonnull
                                                            PickResult pickResult)

Returns a list of IServiceProvider instances that were contained in the provided PickResult

Parameters:

pickResult - The pick result for which to retrieve data.

Returns:

The collection of picked service providers.

Throws:

ArgumentNullException - Thrown when pickResult is null.