agi.foundation.graphics

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

Class SceneManager

java.lang.Object

agi.foundation.graphics.SceneManager

public final class SceneManager
extends Object

The static SceneManager class provides global properties and functionality that apply to all Scenes and thus affect the rendering of every Insight3D control. It also provides a Textures property for creating new textures, and controls the Time of all Scenes within an application. The Animation property and SceneManager.setTime(agi.foundation.time.JulianDate) method can be used to control Time. The Primitives and ScreenOverlays properties allow you to add Primitives and ScreenOverlays to all Scenes. To render these objects in specific scenes, see the SceneDisplayCondition class. To render all Scenes within an application, call the Render method.

See Also:

Animation topic, Primitives topic, Screen Overlays topic, Scene, SceneDisplayCondition

Method Summary

Modifier and Type	Method and Description
static void	addRendering(EventHandler<RenderingEventArgs> value) Adds a handler for an event that is raised when either Render is called on a scene or SceneManager.render() is called on the SceneManager.
static void	addTimeChanged(EventHandler<TimeChangedEventArgs> value) Adds a handler for an event that is raised when either SceneManager.setTime(agi.foundation.time.JulianDate) or SceneManager.setTime(agi.foundation.time.JulianDate,agi.foundation.time.JulianDate) is called.
static ForwardAnimation	getAnimation() Gets the Animation class for controlling and .
static AntiAliasing	getAntiAliasing() Gets the multisample anti-aliasing (MSAA) option for all Scenes.
static FrameRate	getFrameRate() Gets the FrameRate class, which can be used to keep track of how fast Scenes are being .
static GlobeOverlaySettings	getGlobeOverlaySettings() Gets the GlobeOverlaySettings, which are used to set global settings for all GlobeOverlays.
static PrimitiveManager	getPrimitives() Gets the PrimitiveManager, which is used to add Primitives to your Scenes.
static List<Scene>	getScenes() Gets a read-only collection of Scenes that are associated with the SceneManager.
static ScreenOverlayManager	getScreenOverlays() Gets the ScreenOverlayManager, which is used to add ScreenOverlays to your Scenes.
static Stereoscopic	getStereoscopic() Gets the stereoscopic options for all Scenes.
static Texture2DFactory	getTextures() Gets the Texture2DFactory, which can be used to create textures from various sources.
static JulianDate	getTime() Gets the current time of all Scenes.
static void	refreshEvaluators() Refreshes all evaluators used internally by Insight3D.
static void	removeRendering(EventHandler<RenderingEventArgs> value) Removes a handler for an event that is raised when either Render is called on a scene or SceneManager.render() is called on the SceneManager.
static void	removeTimeChanged(EventHandler<TimeChangedEventArgs> value) Removes a handler for an event that is raised when either SceneManager.setTime(agi.foundation.time.JulianDate) or SceneManager.setTime(agi.foundation.time.JulianDate,agi.foundation.time.JulianDate) is called.
static void	render() Renders all Scenes within an application.
static void	setAnimation(ForwardAnimation animation) Sets the Animation class for controlling and .
static void	setAntiAliasing(AntiAliasing antiAliasing) Sets the multisample anti-aliasing (MSAA) option for all Scenes.
static void	setTime(JulianDate time) Set the current Time of all Scenes.
static void	setTime(JulianDate time, JulianDate nextTime) Set the current Time of all Scenes, with a hint for what the next Time will be.

Methods inherited from class java.lang.Object

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

Method Detail

getPrimitives

public static final PrimitiveManager getPrimitives()

Gets the PrimitiveManager, which is used to add Primitives to your Scenes.

See Also:

Primitives topic

getScreenOverlays

public static final ScreenOverlayManager getScreenOverlays()

Gets the ScreenOverlayManager, which is used to add ScreenOverlays to your Scenes.

See Also:

Screen Overlays topic

getTextures

public static final Texture2DFactory getTextures()

Gets the Texture2DFactory, which can be used to create textures from various sources.

getGlobeOverlaySettings

public static final GlobeOverlaySettings getGlobeOverlaySettings()

Gets the GlobeOverlaySettings, which are used to set global settings for all GlobeOverlays.

See Also:

Globe Overlays topic

getTime

public static final JulianDate getTime()

Gets the current time of all Scenes. To set the current time, use the SceneManager.setTime(agi.foundation.time.JulianDate) or SceneManager.setTime(agi.foundation.time.JulianDate,agi.foundation.time.JulianDate) methods.

See Also:

Animation topic

getAnimation

public static final ForwardAnimation getAnimation()

Gets the Animation class for controlling and .

See Also:

Animation topic, RealTimeAnimation, SimulationAnimation, RealTimeSimulationAnimation

setAnimation

public static final void setAnimation(ForwardAnimation animation)

Sets the Animation class for controlling and .

See Also:

Animation topic, RealTimeAnimation, SimulationAnimation, RealTimeSimulationAnimation

getFrameRate

public static final FrameRate getFrameRate()

Gets the FrameRate class, which can be used to keep track of how fast Scenes are being .

See Also:

Animation topic

getScenes

public static final List<Scene> getScenes()

Gets a read-only collection of Scenes that are associated with the SceneManager.

See Also:

Scene

getAntiAliasing

public static final AntiAliasing getAntiAliasing()

Gets the multisample anti-aliasing (MSAA) option for all Scenes. As the level of anti-aliasing increases, performance will generally decrease, but the quality of the anti-aliasing will improve.

setAntiAliasing

public static final void setAntiAliasing(AntiAliasing antiAliasing)

Sets the multisample anti-aliasing (MSAA) option for all Scenes. As the level of anti-aliasing increases, performance will generally decrease, but the quality of the anti-aliasing will improve.

getStereoscopic

public static final Stereoscopic getStereoscopic()

Gets the stereoscopic options for all Scenes.

All Stereoscopic properties must be set before any other objects are created or methods are called within AGI.Foundation.Graphics. Once the options are specified, they cannot be changed for the lifetime of the application. These settings are typically best applied in a static constructor that is called early in an application's lifetime.

addTimeChanged

public static void addTimeChanged(EventHandler<TimeChangedEventArgs> value)

Adds a handler for an event that is raised when either SceneManager.setTime(agi.foundation.time.JulianDate) or SceneManager.setTime(agi.foundation.time.JulianDate,agi.foundation.time.JulianDate) is called.

Parameters:

value - The event handler.

See Also:

Animation topic

removeTimeChanged

public static void removeTimeChanged(EventHandler<TimeChangedEventArgs> value)

Removes a handler for an event that is raised when either SceneManager.setTime(agi.foundation.time.JulianDate) or SceneManager.setTime(agi.foundation.time.JulianDate,agi.foundation.time.JulianDate) is called.

Parameters:

value - The event handler.

See Also:

Animation topic

addRendering

public static void addRendering(EventHandler<RenderingEventArgs> value)

Adds a handler for an event that is raised when either Render is called on a scene or SceneManager.render() is called on the SceneManager.

Parameters:

value - The event handler.

removeRendering

public static void removeRendering(EventHandler<RenderingEventArgs> value)

Removes a handler for an event that is raised when either Render is called on a scene or SceneManager.render() is called on the SceneManager.

Parameters:

value - The event handler.

render

public static final void render()

Renders all Scenes within an application. To render a specific Scene, use the Scene.Render method.

See Also:

Animation topic

setTime

public static final void setTime(JulianDate time)

Set the current Time of all Scenes. If you know what the next Time will be, use the SceneManager.setTime(agi.foundation.time.JulianDate,agi.foundation.time.JulianDate) method.

Parameters:

time - The current Time for all Scenes.

See Also:

Animation topic

setTime

public static final void setTime(JulianDate time,
                                 JulianDate nextTime)

Set the current Time of all Scenes, with a hint for what the next Time will be.

Parameters:

time - The current Time for all Scenes.

nextTime - A hint for what the next Time for all Scenes will be.

See Also:

Animation topic

refreshEvaluators

public static final void refreshEvaluators()

Refreshes all evaluators used internally by Insight3D. It is necessary to call this method after making changes to definitional objects used by Insight3D in order for those changes to be reflected in the rendered scenes. For more information on evaluators, see the overview topic on Evaluators and Evaluator Groups topic.