Drag[en]gine Script Module DragonScript  1.23
Dragengine.CameraDirectors.VRPlayerControlledActorCameraDirector Class Reference

Line up position and orientation with VR HMD position and orientation. More...

Inheritance diagram for Dragengine.CameraDirectors.VRPlayerControlledActorCameraDirector:
Dragengine.CameraDirectors.PlayerControlledActorCameraDirector Dragengine.CameraDirectors.ElementCameraDirector Dragengine.CameraDirectors.CameraDirector

Public Member Functions

void activate ()
 Camera director has been activated. More...
 
void deactivate ()
 Camera director has been deactivated. More...
 
bool getActive ()
 Camera director is active. More...
 
DMatrix getCameraMatrix ()
 Calculate camera matrix. More...
 
ECBehaviorVRHMD.Instance getHMD ()
 VR HMD behavior instance or null if absent. More...
 
VRPlayerControlledActorCameraDirector new ()
 Create camera director. More...
 
VRPlayerControlledActorCameraDirector new (Camera camera, Microphone microphone)
 Create camera director. More...
 
VRPlayerControlledActorCameraDirector new (Camera camera, Microphone microphone, ECBehaviorPlayerControllable.Tracker tracker)
 Create camera director. More...
 
void setCamera (Camera camera)
 Set camera. More...
 
void updateCamera (float elapsed)
 Update camera. More...
 
- Public Member Functions inherited from Dragengine.CameraDirectors.PlayerControlledActorCameraDirector
ECBehaviorPlayerControllable.Instance getActor ()
 Actor or null. More...
 
ECBehaviorColliderAI.Instance getColliderAI ()
 Collider AI or null if absent. More...
 
bool getLockAzimuth ()
 Do not update azimuth from locomotion changes. More...
 
bool getLockElevation ()
 Do not update elevation from locomotion changes. More...
 
ECBehaviorLocomotion.Instance getLocomotion ()
 Locomotion or null if absent. More...
 
ECBehaviorPlayerControllable.Tracker getTracker ()
 Tracker or null. More...
 
void setActor (ECBehaviorPlayerControllable.Instance actor)
 Set actor or null. More...
 
void setLockAzimuth (bool lock)
 Set to not update azimuth from locomotion changes. More...
 
void setLockElevation (bool lock)
 Set to not update elevation from locomotion changes. More...
 
void setPivotAboveGround (float distance)
 Set pivot point at desired distance above ground. More...
 
void setTracker (ECBehaviorPlayerControllable.Tracker tracker)
 Set tracker or null. More...
 
void updateMicrophone (float elapsed)
 Update microphone. More...
 
- Public Member Functions inherited from Dragengine.CameraDirectors.ElementCameraDirector
float getAzimuth ()
 Vertical rotation. More...
 
float getDistance ()
 Distance. More...
 
Element getElement ()
 Element. More...
 
float getElevation ()
 Horizontal rotation. More...
 
DMatrix getLocalMatrix ()
 Local matrix. More...
 
DVector getPivot ()
 Rotation point. More...
 
bool getUseOrientation ()
 Use element orientation. More...
 
ElementCameraDirector new (Element element)
 Create camera director. More...
 
ElementCameraDirector new (Element element, Camera camera, Microphone microphone)
 Create camera director. More...
 
void setAzimuth (float azimuth)
 Set vertical rotation. More...
 
void setDistance (float distance)
 Set distance. More...
 
void setElement (Element element)
 Set element. More...
 
void setElevation (float elevation)
 Set horizontal rotation. More...
 
void setLocalMatrix (DMatrix localMatrix)
 Set local matrix. More...
 
void setLocalMatrix (Vector position, Vector rotation)
 Set local matrix from position and rotation. More...
 
void setPivot (DVector pivot)
 Set rotation point. More...
 
void setUseOrientation (bool useOrientation)
 Set use element orientation. More...
 
- Public Member Functions inherited from Dragengine.CameraDirectors.CameraDirector
void applyParameters (Camera camera)
 Apply parameters to camera. More...
 
void applyParameters (Microphone microphone)
 Apply parameters to microphone. More...
 
void copyParameters (Camera camera)
 Copy parameters from camera. More...
 
void copyParameters (CameraDirector director)
 Copy parameters from camera director. More...
 
void copyParameters (Microphone microphone)
 Copy parameters from microphone. More...
 
float getAdaptionTime ()
 Adaption time. More...
 
float getBloomBlend ()
 Bloom blend as multiplier of intensity beyond bloom intensity. More...
 
float getBloomIntensity ()
 Bloom intensity multiplier. More...
 
float getBloomSize ()
 Bloom size as percentage of screen width. More...
 
float getBloomStrength ()
 Bloom strength as multiplier of intensity beyond bloom intensity. More...
 
Camera getCamera ()
 Camera to modify. More...
 
bool getEnableAuralization ()
 Enable auralization if supported. More...
 
bool getEnableGI ()
 Enable global illumination (GI) if supported. More...
 
bool getEnableHDRR ()
 Enable high definition range rendering (HDRR) if supported. More...
 
float getExposure ()
 Exposure. More...
 
float getFov ()
 Field of view. More...
 
float getFovRatio ()
 Field of view ratio (height / width). More...
 
float getHighestIntensity ()
 Highest intensity. More...
 
float getImageDistance ()
 Camera image distance. More...
 
LayerMask getLayerMask ()
 Layer mask. More...
 
float getLowestIntensity ()
 Lowest intensity. More...
 
Microphone getMicrophone ()
 Microphone to modify. More...
 
CurveBezier getToneMapCurve ()
 Custom tone mapping curve or empty curve to disable. More...
 
float getViewDistance ()
 Camera view distance. More...
 
float getWhiteIntensity ()
 White intensity multiplier. More...
 
void initCameraParameters ()
 Init camera parameters. More...
 
void initMicrophoneParameters ()
 Init microphone parameters. More...
 
void resetCameraAdaptedIntensity ()
 Request graphic module to reset camera adapted intensity to optimal value. More...
 
void setAdaptionTime (float time)
 Set adaption time. More...
 
void setBloomBlend (float blend)
 Set bloom blend as multiplier of intensity beyond bloom intensity. More...
 
void setBloomIntensity (float intensity)
 Set bloom intensity multiplier. More...
 
void setBloomSize (float size)
 Bloom size as percentage of screen width. More...
 
void setBloomStrength (float strength)
 Set bloom strength as multiplier of intensity beyond bloom intensity. More...
 
void setEnableAuralization (bool enable)
 Set to enable auralization if supported. More...
 
void setEnableGI (bool enable)
 Set to enable global illumination (GI) if supported. More...
 
void setEnableHDRR (bool enable)
 Set to enable high definition range rendering (HDRR) if supported. More...
 
void setExposure (float exposure)
 Set exposure. More...
 
void setFov (float fov)
 Set field of view. More...
 
void setFovRatio (float ratio)
 Set field of view ratio (height / width). More...
 
void setHighestIntensity (float intensity)
 Set highest intensity. More...
 
void setImageDistance (float distance)
 Set camera image distance. More...
 
void setLayerMask (LayerMask layerMask)
 Set layer mask. More...
 
void setLowestIntensity (float intensity)
 Set lowest intensity. More...
 
void setMicrophone (Microphone microphone)
 Set microphone to modify. More...
 
void setToneMapCurve (CurveBezier curve)
 Set custom tone mapping curve or empty curve to disable. More...
 
void setViewDistance (float distance)
 Set camera view distance. More...
 
void setWhiteIntensity (float intensity)
 Set white intensity multiplier. More...
 
void update (float elapsed)
 Update director. More...
 

Protected Member Functions

void actorChanged ()
 Actor changed. More...
 
- Protected Member Functions inherited from Dragengine.CameraDirectors.PlayerControlledActorCameraDirector
void initBehaviors (BehaviorElement element)
 Init behaviors. More...
 

Protected Attributes

ECBehaviorVRHMD.Instance hmd
 VR HMD behavior instance or null if absent. More...
 
- Protected Attributes inherited from Dragengine.CameraDirectors.PlayerControlledActorCameraDirector
ECBehaviorColliderAI.Instance colliderAI
 Collider AI or null if absent. More...
 
ECBehaviorLocomotion.Instance locomotion
 Locomotion or null if absent. More...
 

Additional Inherited Members

- Public Attributes inherited from Dragengine.CameraDirectors.ElementCameraDirector
float pAzimuth
 
float pDistance
 
Element pElement
 
float pElevation
 
DMatrix pLocalMatrix
 
DVector pPivot
 
bool pUseOrientation
 
- Public Attributes inherited from Dragengine.CameraDirectors.CameraDirector
final float fovFirstPerson = 90
 Typical first person FOV. More...
 
final float fovLongTele = 6.87
 Long tele camera FOV. More...
 
final float fovMediumTele = 10.29
 Medium tele camera FOV. More...
 
final float fovNormal = 39.6
 Normal camera FOV. More...
 
final float fovShortFirstPerson = 75
 Shorter first person FOV. More...
 
final float fovShortTele = 22.62
 Short tele camera FOV. More...
 
final float fovUltraWide = 83.97
 Ultra wide camera FOV. More...
 
final float fovWide = 65.47
 Wide camera FOV. More...
 
float pAdaptionTime
 
float pBloomBlend
 
float pBloomIntensity
 
float pBloomSize
 
float pBloomStrength
 
Camera pCamera
 
bool pEnableAuralization
 
bool pEnableGI
 
bool pEnableHDRR
 
float pExposure
 
float pFov
 
float pFovRatio
 
float pHighestIntensity
 
float pImageDistance
 
LayerMask pLayerMask
 
float pLowestIntensity
 
Microphone pMicrophone
 
CurveBezier pToneMapCurve
 
float pViewDistance
 
float pWhiteIntensity
 

Detailed Description

Line up position and orientation with VR HMD position and orientation.

Version
1.6

Uses PlayerControlledActorCameraDirector as super class to get player tracking for free. If HMD is not attached the camera is not updated anymore.

Member Function Documentation

◆ activate()

void Dragengine.CameraDirectors.VRPlayerControlledActorCameraDirector.activate ( )

Camera director has been activated.

Modifies base class behavior assigning camera to VR System.

Reimplemented from Dragengine.CameraDirectors.CameraDirector.

◆ actorChanged()

void Dragengine.CameraDirectors.VRPlayerControlledActorCameraDirector.actorChanged ( )
protected

Actor changed.

Stores the VR HMD behavior instance from the player actor is present. If actor is absent VR HMD behavior instance is set to null

Reimplemented from Dragengine.CameraDirectors.PlayerControlledActorCameraDirector.

◆ deactivate()

void Dragengine.CameraDirectors.VRPlayerControlledActorCameraDirector.deactivate ( )

Camera director has been deactivated.

Modifies base class behavior resigns camera from VR System.

Reimplemented from Dragengine.CameraDirectors.CameraDirector.

◆ getActive()

bool Dragengine.CameraDirectors.VRPlayerControlledActorCameraDirector.getActive ( )

Camera director is active.

Active VR camera director assigned camera to VR System.

◆ getCameraMatrix()

DMatrix Dragengine.CameraDirectors.VRPlayerControlledActorCameraDirector.getCameraMatrix ( )

Calculate camera matrix.

If VR HMD behavior instance is present and HMD is attached returns HMD matrix as provided by VR HMD behavior instance. Otherwise creates matrix from the current camera position and orientation.

Reimplemented from Dragengine.CameraDirectors.ElementCameraDirector.

◆ getHMD()

ECBehaviorVRHMD.Instance Dragengine.CameraDirectors.VRPlayerControlledActorCameraDirector.getHMD ( )

VR HMD behavior instance or null if absent.

◆ new() [1/3]

VRPlayerControlledActorCameraDirector Dragengine.CameraDirectors.VRPlayerControlledActorCameraDirector.new ( )

Create camera director.

Reimplemented from Dragengine.CameraDirectors.PlayerControlledActorCameraDirector.

◆ new() [2/3]

VRPlayerControlledActorCameraDirector Dragengine.CameraDirectors.VRPlayerControlledActorCameraDirector.new ( Camera  camera,
Microphone  microphone 
)

Create camera director.

Reimplemented from Dragengine.CameraDirectors.PlayerControlledActorCameraDirector.

◆ new() [3/3]

VRPlayerControlledActorCameraDirector Dragengine.CameraDirectors.VRPlayerControlledActorCameraDirector.new ( Camera  camera,
Microphone  microphone,
ECBehaviorPlayerControllable.Tracker  tracker 
)

Create camera director.

Reimplemented from Dragengine.CameraDirectors.PlayerControlledActorCameraDirector.

◆ setCamera()

void Dragengine.CameraDirectors.VRPlayerControlledActorCameraDirector.setCamera ( Camera  camera)

Set camera.

Modifies base class behavior assigning camera to VR System if director is active.

Reimplemented from Dragengine.CameraDirectors.CameraDirector.

◆ updateCamera()

void Dragengine.CameraDirectors.VRPlayerControlledActorCameraDirector.updateCamera ( float  elapsed)

Update camera.

If VR HMD behavior instance is present and HMD is attached assigns the HMD position and orientation to the camera.

Reimplemented from Dragengine.CameraDirectors.PlayerControlledActorCameraDirector.

Member Data Documentation

◆ hmd

ECBehaviorVRHMD.Instance Dragengine.CameraDirectors.VRPlayerControlledActorCameraDirector.hmd
protected

VR HMD behavior instance or null if absent.


The documentation for this class was generated from the following file: