NASA World Wind

gov.nasa.worldwind
Interface StereoSceneController

All Superinterfaces:
AVList, Disposable, EventListener, MessageListener, PropertyChangeListener, SceneController, WWObject
All Known Implementing Classes:
StereoOptionSceneController

public interface StereoSceneController
extends SceneController

An interface for scene controllers that provide stereo.

Note: The WorldWindow instance must support stereo display in order to use device-supported stereo. See WorldWindowGLCanvas to learn how to select a stereo device.


Method Summary
 Angle getFocusAngle()
          Returns this controller's focus angle, the angle difference between the left and right eye direction.
 String getStereoMode()
          Indicates the current stereo mode of this controller.
 boolean isHardwareStereo()
          Indicates whether stereo is being implemented directly by the display device rather than software.
 boolean isInStereo()
          Indicates whether stereo is being applied, either directly by the display device or simulated via software.
 boolean isSwapEyes()
          Indicates whether to switch the left/right stereo images.
 void setFocusAngle(Angle a)
          Specifies the angle difference between the left and right eye direction.
 void setStereoMode(String mode)
          Specifies the technique used to provide a stereo effect.
 void setSwapEyes(boolean swapEyes)
          Specifies whether to draw the right eye image in the left eye's position and the left eye's image in the right eye's position.
 
Methods inherited from interface gov.nasa.worldwind.SceneController
getClutterFilter, getDrawContext, getFramesPerSecond, getFrameTime, getGLRuntimeCapabilities, getGpuResourceCache, getModel, getObjectsInPickRectangle, getPerFrameStatistics, getPickedObjectList, getPickPoint, getPickRectangle, getRenderingExceptions, getScreenCreditController, getTerrain, getVerticalExaggeration, getView, isDeepPickEnabled, reinitialize, repaint, setClutterFilter, setDeepPickEnabled, setGLRuntimeCapabilities, setGpuResourceCache, setModel, setPerFrameStatisticsKeys, setPickPoint, setPickRectangle, setScreenCreditController, setVerticalExaggeration, setView
 
Methods inherited from interface gov.nasa.worldwind.avlist.AVList
addPropertyChangeListener, addPropertyChangeListener, clearList, copy, firePropertyChange, firePropertyChange, getEntries, getStringValue, getValue, getValues, hasKey, removeKey, removePropertyChangeListener, removePropertyChangeListener, setValue, setValues
 
Methods inherited from interface java.beans.PropertyChangeListener
propertyChange
 
Methods inherited from interface gov.nasa.worldwind.event.MessageListener
onMessage
 
Methods inherited from interface gov.nasa.worldwind.Disposable
dispose
 

Method Detail

getFocusAngle

Angle getFocusAngle()
Returns this controller's focus angle, the angle difference between the left and right eye direction.

Returns:
this controller's focus angle.

getStereoMode

String getStereoMode()
Indicates the current stereo mode of this controller.

Returns:
the current stereo mode. See this class' description for the possible modes. This method does not return null. If a null mode was passed to setStereoMode(String), this instance's mode was set to AVKey.STEREO_MODE_NONE.

isHardwareStereo

boolean isHardwareStereo()
Indicates whether stereo is being implemented directly by the display device rather than software.

Returns:
true if if stereo is being implemented by the display device, otherwise false.

isInStereo

boolean isInStereo()
Indicates whether stereo is being applied, either directly by the display device or simulated via software.

Returns:
true if stereo is being applied.

isSwapEyes

boolean isSwapEyes()
Indicates whether to switch the left/right stereo images.

Returns:
true to switch the images, otherwise false

setFocusAngle

void setFocusAngle(Angle a)
Specifies the angle difference between the left and right eye direction. Larger angles increase the stereo effect.

Parameters:
a - the left-right eye direction difference. If null, the angle is set to 0.

setStereoMode

void setStereoMode(String mode)
Specifies the technique used to provide a stereo effect. Defined options are AVKey.STEREO_MODE_DEVICE to request device supported stereo, AVKey.STEREO_MODE_RED_BLUE to request red-blue anaglyph stereo implemented in software, or AVKey.STEREO_MODE_NONE (the default) to request no stereo effect.

If STEREO_MODE_DEVICE is requested but the display device does not support stereo, stereo is not applied.

See the implementing class to determine how it detects the initial stereo mode.

Parameters:
mode - the technique used to provide the stereo effect. If null, the mode is set to AVKey.STEREO_MODE_NONE.

setSwapEyes

void setSwapEyes(boolean swapEyes)
Specifies whether to draw the right eye image in the left eye's position and the left eye's image in the right eye's position.

Parameters:
swapEyes - true to switch the left/right stereo images, otherwise false.

NASA World Wind