public interface StereoDevice
Modifier and Type | Field and Description |
---|---|
static boolean |
DEBUG |
static boolean |
DUMP_DATA |
static int |
SENSOR_ORIENTATION
Sensor Bit: Orientation tracking
|
static int |
SENSOR_POSITION
Sensor Bit: Positional tracking
|
static int |
SENSOR_YAW_CORRECTION
Sensor Bit: Yaw correction
|
Modifier and Type | Method and Description |
---|---|
StereoDeviceRenderer |
createRenderer(int distortionBits,
int textureCount,
float[] eyePositionOffset,
FovHVHalves[] eyeFov,
float pixelsPerDisplayPixel,
int textureUnit)
Create a new
StereoDeviceRenderer instance. |
void |
dispose()
Disposes this
StereoDevice , if valid . |
float[] |
getDefaultEyePositionOffset()
Return the device default eye position offset for
#createRenderer(int, int, float[], FovHVHalves[], float) . |
FovHVHalves[] |
getDefaultFOV()
Returns the device default
FovHVHalves for all supported eyes
in natural order, i.e. |
int |
getEnabledSensorBits()
Returns the actual used sensor capability bits, e.g.
|
int[] |
getEyeRenderOrder()
Returns an array of the preferred eye rendering order.
|
StereoDeviceFactory |
getFactory()
Return the factory used to create this device.
|
LocationSensorParameter |
getLocationSensorParams()
Returns the
LocationSensorParameter of the device
if SENSOR_POSITION is supported ,
otherwise returns null . |
int |
getMinimumDistortionBits()
Returns the minimum distortion compensation bits as required by the
StereoDeviceRenderer ,
e.g. |
PointImmutable |
getPosition()
If operation within a device spanning virtual desktop,
returns the device position.
|
int |
getRecommendedDistortionBits()
Returns the recommended distortion compensation bits for the
StereoDeviceRenderer ,
e.g. |
int |
getRequiredRotation()
Returns the CCW rotation as required by this display device.
|
boolean |
getSensorsStarted()
Return true if sensors have been started, false otherwise.
|
int |
getSupportedDistortionBits()
Returns the supported distortion compensation of the
StereoDeviceRenderer ,
e.g. |
int |
getSupportedSensorBits()
Returns the supported sensor capability bits, e.g.
|
DimensionImmutable |
getSurfaceSize()
Returns the required surface size in pixel
in target space.
|
boolean |
isValid()
|
void |
resetLocationSensorOrigin()
Sets the location sensor's origin of this device to the current position.
|
boolean |
startSensors(int desiredSensorBits,
int requiredSensorBits)
Start desired and required sensors.
|
boolean |
stopSensors()
Stop sensors.
|
static final boolean DEBUG
static final boolean DUMP_DATA
static final int SENSOR_ORIENTATION
static final int SENSOR_YAW_CORRECTION
static final int SENSOR_POSITION
StereoDeviceFactory getFactory()
void dispose()
boolean isValid()
PointImmutable getPosition()
Otherwise simply 0/0.
DimensionImmutable getSurfaceSize()
int getRequiredRotation()
float[] getDefaultEyePositionOffset()
#createRenderer(int, int, float[], FovHVHalves[], float)
.
Result is an array of float values for
FovHVHalves[] getDefaultFOV()
FovHVHalves
for all supported eyes
in natural order, i.e. left and right if supported.
Monoscopic devices return an array length of one, without the value for the right-eye!
LocationSensorParameter getLocationSensorParams()
LocationSensorParameter
of the device
if SENSOR_POSITION
is supported
,
otherwise returns null
.void resetLocationSensorOrigin()
In case SENSOR_POSITION
is not supported
,
this method is a no-op.
boolean startSensors(int desiredSensorBits, int requiredSensorBits)
Method fails if required sensors are not supported
.
desiredSensorBits
- the desired optional sensorsrequiredSensorBits
- the required sensorsstopSensors()
,
getSensorsStarted()
,
getSupportedSensorBits()
,
getEnabledSensorBits()
boolean stopSensors()
boolean getSensorsStarted()
int getSupportedSensorBits()
SENSOR_ORIENTATION
, SENSOR_POSITION
of the StereoDevice
.int getEnabledSensorBits()
SENSOR_ORIENTATION
, SENSOR_POSITION
in case the device supports
them and if they are enabled.int[] getEyeRenderOrder()
Monoscopic devices only support one eye, where stereoscopic device two eyes.
int getSupportedDistortionBits()
StereoDeviceRenderer
,
e.g. StereoDeviceRenderer.DISTORTION_BARREL
, StereoDeviceRenderer.DISTORTION_CHROMATIC
, etc.int getRecommendedDistortionBits()
StereoDeviceRenderer
,
e.g. StereoDeviceRenderer.DISTORTION_BARREL
, StereoDeviceRenderer.DISTORTION_CHROMATIC
StereoDeviceRenderer.DISTORTION_VIGNETTE
.
User shall use the recommended distortion compensation to achieve a distortion free view.
int getMinimumDistortionBits()
StereoDeviceRenderer
,
e.g. StereoDeviceRenderer.DISTORTION_BARREL
in case the stereoscopic display uses [a]spherical lenses.
Minimum distortion compensation bits are being enforced by the StereoDeviceRenderer
.
StereoDeviceRenderer createRenderer(int distortionBits, int textureCount, float[] eyePositionOffset, FovHVHalves[] eyeFov, float pixelsPerDisplayPixel, int textureUnit)
StereoDeviceRenderer
instance.distortionBits
- StereoDeviceRenderer
distortion bits, e.g. StereoDeviceRenderer.DISTORTION_BARREL
, etc,
see getRecommendedDistortionBits()
.textureCount
- desired texture count for post-processing, see StereoDeviceRenderer.getTextureCount()
and StereoDeviceRenderer.ppAvailable()
eyePositionOffset
- eye position offset, e.g. getDefaultEyePositionOffset()
.eyeFov
- FovHVHalves[] field-of-view per eye, e.g. getDefaultFOV()
. May contain only one value for monoscopic devices,
see getEyeRenderOrder()
.pixelsPerDisplayPixel
- textureUnit
- Copyright 2010 JogAmp Community.