Extended Reality (XR) Session interface. More...

#include <Aspect_XRSession.hxx>

Inheritance diagram for Aspect_XRSession:

[legend]

Public Types
enum	TrackingUniverseOrigin { TrackingUniverseOrigin_Seated , TrackingUniverseOrigin_Standing }
	Identifies which style of tracking origin the application wants to use for the poses it is requesting. More...

enum	InfoString { InfoString_Vendor , InfoString_Device , InfoString_Tracker , InfoString_SerialNumber }
	Info string enumeration. More...

typedef void	base_type
	Returns a type descriptor about this object.

Public Member Functions
virtual bool	IsOpen () const =0
	Return TRUE if session is opened.

virtual bool	Open ()=0
	Initialize session.

virtual void	Close ()=0
	Release session.

virtual bool	WaitPoses ()=0
	Fetch actual poses of tracked devices.

virtual NCollection_Vec2< int >	RecommendedViewport () const =0
	Return recommended viewport Width x Height for rendering into VR.

virtual NCollection_Mat4< double >	EyeToHeadTransform (Aspect_Eye theEye) const =0
	Return transformation from eye to head.

NCollection_Mat4< double >	HeadToEyeTransform (Aspect_Eye theEye) const
	Return transformation from head to eye.

virtual NCollection_Mat4< double >	ProjectionMatrix (Aspect_Eye theEye, double theZNear, double theZFar) const =0
	Return projection matrix.

virtual bool	HasProjectionFrustums () const =0
	Return FALSE if projection frustums are unsupported and general 4x4 projection matrix should be fetched instead.

virtual void	ProcessEvents ()=0
	Receive XR events.

virtual bool	SubmitEye (void *theTexture, Aspect_GraphicsLibrary theGraphicsLib, Aspect_ColorSpace theColorSpace, Aspect_Eye theEye)=0
	Submit texture eye to XR Composer.

Standard_Real	UnitFactor () const
	Return unit scale factor defined as scale factor for m (meters); 1.0 by default.

void	SetUnitFactor (Standard_Real theFactor)
	Set unit scale factor.

Standard_Real	Aspect () const
	Return aspect ratio.

Standard_Real	FieldOfView () const
	Return field of view.

Standard_Real	IOD () const
	Return Intra-ocular Distance (IOD); also known as Interpupillary Distance (IPD). Defined in meters by default (.

Standard_ShortReal	DisplayFrequency () const
	Return display frequency or 0 if unknown.

const Aspect_FrustumLRBT< double > &	ProjectionFrustum (Aspect_Eye theEye) const
	Return projection frustum.

const gp_Trsf &	HeadPose () const
	Return head orientation in right-handed system: +y is up +x is to the right -z is forward Distance unit is meters by default (.

gp_Trsf	LeftHandPose () const
	Return left hand orientation.

gp_Trsf	RightHandPose () const
	Return right hand orientation.

const Aspect_TrackedDevicePoseArray &	TrackedPoses () const
	Return number of tracked poses array.

bool	HasTrackedPose (Standard_Integer theDevice) const
	Return TRUE if device orientation is defined.

virtual Standard_Integer	NamedTrackedDevice (Aspect_XRTrackedDeviceRole theDevice) const =0
	Return index of tracked device of known role, or -1 if undefined.

Handle< Graphic3d_ArrayOfTriangles >	LoadRenderModel (Standard_Integer theDevice, Handle< Image_Texture > &theTexture)
	Load model for displaying device.

Handle< Graphic3d_ArrayOfTriangles >	LoadRenderModel (Standard_Integer theDevice, Standard_Boolean theToApplyUnitFactor, Handle< Image_Texture > &theTexture)
	Load model for displaying device.

virtual Aspect_XRDigitalActionData	GetDigitalActionData (const Handle< Aspect_XRAction > &theAction) const =0
	Fetch data for digital input action (like button).

virtual Aspect_XRAnalogActionData	GetAnalogActionData (const Handle< Aspect_XRAction > &theAction) const =0
	Fetch data for digital input action (like axis).

virtual Aspect_XRPoseActionData	GetPoseActionDataForNextFrame (const Handle< Aspect_XRAction > &theAction) const =0
	Fetch data for pose input action (like fingertip position). The returned values will match the values returned by the last call to WaitPoses().

void	TriggerHapticVibrationAction (const Handle< Aspect_XRAction > &theAction, const Aspect_XRHapticActionData &theParams)
	Trigger vibration.

void	AbortHapticVibrationAction (const Handle< Aspect_XRAction > &theAction)
	Abort vibration.

TrackingUniverseOrigin	TrackingOrigin () const
	Return tracking origin.

virtual void	SetTrackingOrigin (TrackingUniverseOrigin theOrigin)
	Set tracking origin.

const Handle< Aspect_XRAction > &	GenericAction (Aspect_XRTrackedDeviceRole theDevice, Aspect_XRGenericAction theAction) const
	Return generic action for specific hand or NULL if undefined.

virtual TCollection_AsciiString	GetString (InfoString theInfo) const =0
	Query information.

Public Member Functions inherited from Standard_Transient
	Standard_Transient ()
	Empty constructor.

	Standard_Transient (const Standard_Transient &)
	Copy constructor – does nothing.

Standard_Transient &	operator= (const Standard_Transient &)
	Assignment operator, needed to avoid copying reference counter.

virtual	~Standard_Transient ()
	Destructor must be virtual.

virtual const opencascade::handle< Standard_Type > &	DynamicType () const
	Returns a type descriptor about this object.

Standard_Boolean	IsInstance (const opencascade::handle< Standard_Type > &theType) const
	Returns a true value if this is an instance of Type.

Standard_Boolean	IsInstance (const Standard_CString theTypeName) const
	Returns a true value if this is an instance of TypeName.

Standard_Boolean	IsKind (const opencascade::handle< Standard_Type > &theType) const
	Returns true if this is an instance of Type or an instance of any class that inherits from Type. Note that multiple inheritance is not supported by OCCT RTTI mechanism.

Standard_Boolean	IsKind (const Standard_CString theTypeName) const
	Returns true if this is an instance of TypeName or an instance of any class that inherits from TypeName. Note that multiple inheritance is not supported by OCCT RTTI mechanism.

Standard_Transient *	This () const
	Returns non-const pointer to this object (like const_cast). For protection against creating handle to objects allocated in stack or call from constructor, it will raise exception Standard_ProgramError if reference counter is zero.

Standard_Integer	GetRefCount () const noexcept
	Get the reference counter of this object.

void	IncrementRefCounter () noexcept
	Increments the reference counter of this object.

Standard_Integer	DecrementRefCounter () noexcept
	Decrements the reference counter of this object; returns the decremented value.

virtual void	Delete () const
	Memory deallocator for transient classes.

Protected Member Functions
	Aspect_XRSession ()
	Empty constructor.

virtual Handle< Graphic3d_ArrayOfTriangles >	loadRenderModel (Standard_Integer theDevice, Standard_Boolean theToApplyUnitFactor, Handle< Image_Texture > &theTexture)=0
	Load model for displaying device.

virtual void	triggerHapticVibrationAction (const Handle< Aspect_XRAction > &theAction, const Aspect_XRHapticActionData &theParams)=0
	Trigger vibration.

Protected Attributes
NCollection_Array1< Handle< Aspect_XRAction > >	myRoleActions [Aspect_XRTrackedDeviceRole_NB]
	generic actions

Aspect_XRActionSetMap	myActionSets
	actions sets

TrackingUniverseOrigin	myTrackOrigin
	tracking origin

Aspect_TrackedDevicePoseArray	myTrackedPoses
	array of tracked poses

gp_Trsf	myHeadPose
	head orientation

NCollection_Vec2< int >	myRendSize
	viewport Width x Height for rendering into VR

Aspect_FrustumLRBT< double >	myFrustumL
	left eye projection frustum

Aspect_FrustumLRBT< double >	myFrustumR
	right eye projection frustum

Standard_Real	myUnitFactor
	unit scale factor defined as scale factor for m (meters)

Standard_Real	myAspect
	aspect ratio

Standard_Real	myFieldOfView
	field of view

Standard_Real	myIod
	intra-ocular distance in meters

Standard_ShortReal	myDispFreq
	display frequency

Additional Inherited Members
static constexpr const char *	get_type_name ()
	Returns a type descriptor about this object.

static const opencascade::handle< Standard_Type > &	get_type_descriptor ()
	Returns type descriptor of Standard_Transient class.

Detailed Description

Extended Reality (XR) Session interface.

Member Enumeration Documentation

◆ InfoString

enum Aspect_XRSession::InfoString

Info string enumeration.

Enumerator
InfoString_Vendor
InfoString_Device
InfoString_Tracker
InfoString_SerialNumber

◆ TrackingUniverseOrigin

enum Aspect_XRSession::TrackingUniverseOrigin

Identifies which style of tracking origin the application wants to use for the poses it is requesting.

Enumerator
TrackingUniverseOrigin_Seated
TrackingUniverseOrigin_Standing	poses are provided relative to the seated zero pose

Constructor & Destructor Documentation

◆ Aspect_XRSession()

Aspect_XRSession::Aspect_XRSession ( )

protected

Empty constructor.

Member Function Documentation

◆ AbortHapticVibrationAction()

void Aspect_XRSession::AbortHapticVibrationAction ( const Handle< Aspect_XRAction > & theAction )

Abort vibration.

◆ Aspect()

Standard_Real Aspect_XRSession::Aspect ( ) const

inline

Return aspect ratio.

◆ Close()

virtual void Aspect_XRSession::Close ( )

pure virtual

Release session.

Implemented in Aspect_OpenVRSession.

◆ DisplayFrequency()

Standard_ShortReal Aspect_XRSession::DisplayFrequency ( ) const

inline

Return display frequency or 0 if unknown.

◆ EyeToHeadTransform()

virtual NCollection_Mat4< double > Aspect_XRSession::EyeToHeadTransform ( Aspect_Eye theEye ) const

pure virtual

Return transformation from eye to head.

Implemented in Aspect_OpenVRSession.

◆ FieldOfView()

Standard_Real Aspect_XRSession::FieldOfView ( ) const

inline

Return field of view.

◆ GenericAction()

const Handle< Aspect_XRAction > & Aspect_XRSession::GenericAction	(	Aspect_XRTrackedDeviceRole	theDevice,
		Aspect_XRGenericAction	theAction ) const

inline

Return generic action for specific hand or NULL if undefined.

◆ GetAnalogActionData()

virtual Aspect_XRAnalogActionData Aspect_XRSession::GetAnalogActionData ( const Handle< Aspect_XRAction > & theAction ) const

pure virtual

Fetch data for digital input action (like axis).

Parameters

[in] theAction action of Aspect_XRActionType_InputAnalog type

Implemented in Aspect_OpenVRSession.

◆ GetDigitalActionData()

virtual Aspect_XRDigitalActionData Aspect_XRSession::GetDigitalActionData ( const Handle< Aspect_XRAction > & theAction ) const

pure virtual

Fetch data for digital input action (like button).

Parameters

[in] theAction action of Aspect_XRActionType_InputDigital type

Implemented in Aspect_OpenVRSession.

◆ GetPoseActionDataForNextFrame()

virtual Aspect_XRPoseActionData Aspect_XRSession::GetPoseActionDataForNextFrame ( const Handle< Aspect_XRAction > & theAction ) const

pure virtual

Fetch data for pose input action (like fingertip position). The returned values will match the values returned by the last call to WaitPoses().

Parameters

[in] theAction action of Aspect_XRActionType_InputPose type

Implemented in Aspect_OpenVRSession.

◆ GetString()

virtual TCollection_AsciiString Aspect_XRSession::GetString ( InfoString theInfo ) const

pure virtual

Query information.

Implemented in Aspect_OpenVRSession.

◆ HasProjectionFrustums()

virtual bool Aspect_XRSession::HasProjectionFrustums ( ) const

pure virtual

Return FALSE if projection frustums are unsupported and general 4x4 projection matrix should be fetched instead.

Implemented in Aspect_OpenVRSession.

◆ HasTrackedPose()

bool Aspect_XRSession::HasTrackedPose ( Standard_Integer theDevice ) const

inline

Return TRUE if device orientation is defined.

◆ HeadPose()

const gp_Trsf & Aspect_XRSession::HeadPose ( ) const

inline

Return head orientation in right-handed system: +y is up +x is to the right -z is forward Distance unit is meters by default (.

See also: UnitFactor()).

◆ HeadToEyeTransform()

NCollection_Mat4< double > Aspect_XRSession::HeadToEyeTransform ( Aspect_Eye theEye ) const

inline

Return transformation from head to eye.

◆ IOD()

Standard_Real Aspect_XRSession::IOD ( ) const

inline

Return Intra-ocular Distance (IOD); also known as Interpupillary Distance (IPD). Defined in meters by default (.

See also: UnitFactor()).

◆ IsOpen()

virtual bool Aspect_XRSession::IsOpen ( ) const

pure virtual

Return TRUE if session is opened.

Implemented in Aspect_OpenVRSession.

◆ LeftHandPose()

gp_Trsf Aspect_XRSession::LeftHandPose ( ) const

inline

Return left hand orientation.

◆ LoadRenderModel() [1/2]

Handle< Graphic3d_ArrayOfTriangles > Aspect_XRSession::LoadRenderModel	(	Standard_Integer	theDevice,
		Handle< Image_Texture > &	theTexture )

inline

Load model for displaying device.

Parameters

[in]	theDevice	device index
[out]	theTexture	texture source

Returns: model triangulation or NULL if not found

◆ LoadRenderModel() [2/2]

Handle< Graphic3d_ArrayOfTriangles > Aspect_XRSession::LoadRenderModel	(	Standard_Integer	theDevice,
		Standard_Boolean	theToApplyUnitFactor,
		Handle< Image_Texture > &	theTexture )

inline

Load model for displaying device.

Parameters

[in]	theDevice	device index
[in]	theToApplyUnitFactor	flag to apply unit scale factor
[out]	theTexture	texture source

Returns: model triangulation or NULL if not found

◆ loadRenderModel()

virtual Handle< Graphic3d_ArrayOfTriangles > Aspect_XRSession::loadRenderModel	(	Standard_Integer	theDevice,
		Standard_Boolean	theToApplyUnitFactor,
		Handle< Image_Texture > &	theTexture )

protectedpure virtual

Load model for displaying device.

Parameters

[in]	theDevice	device index
[in]	theToApplyUnitFactor	flag to apply unit scale factor
[out]	theTexture	texture source

Returns: model triangulation or NULL if not found

Implemented in Aspect_OpenVRSession.

◆ NamedTrackedDevice()

virtual Standard_Integer Aspect_XRSession::NamedTrackedDevice ( Aspect_XRTrackedDeviceRole theDevice ) const

pure virtual

Return index of tracked device of known role, or -1 if undefined.

Implemented in Aspect_OpenVRSession.

◆ Open()

virtual bool Aspect_XRSession::Open ( )

pure virtual

Initialize session.

Implemented in Aspect_OpenVRSession.

◆ ProcessEvents()

virtual void Aspect_XRSession::ProcessEvents ( )

pure virtual

Receive XR events.

Implemented in Aspect_OpenVRSession.

◆ ProjectionFrustum()

const Aspect_FrustumLRBT< double > & Aspect_XRSession::ProjectionFrustum ( Aspect_Eye theEye ) const

inline

Return projection frustum.

See also: HasProjectionFrustums().

◆ ProjectionMatrix()

virtual NCollection_Mat4< double > Aspect_XRSession::ProjectionMatrix	(	Aspect_Eye	theEye,
		double	theZNear,
		double	theZFar ) const

pure virtual

Return projection matrix.

Implemented in Aspect_OpenVRSession.

◆ RecommendedViewport()

virtual NCollection_Vec2< int > Aspect_XRSession::RecommendedViewport ( ) const

pure virtual

Return recommended viewport Width x Height for rendering into VR.

Implemented in Aspect_OpenVRSession.

◆ RightHandPose()

gp_Trsf Aspect_XRSession::RightHandPose ( ) const

inline

Return right hand orientation.

◆ SetTrackingOrigin()

virtual void Aspect_XRSession::SetTrackingOrigin ( TrackingUniverseOrigin theOrigin )

inlinevirtual

Set tracking origin.

Reimplemented in Aspect_OpenVRSession.

◆ SetUnitFactor()

void Aspect_XRSession::SetUnitFactor ( Standard_Real theFactor )

inline

Set unit scale factor.

◆ SubmitEye()

virtual bool Aspect_XRSession::SubmitEye	(	void *	theTexture,
		Aspect_GraphicsLibrary	theGraphicsLib,
		Aspect_ColorSpace	theColorSpace,
		Aspect_Eye	theEye )

pure virtual

Submit texture eye to XR Composer.

Parameters

[in]	theTexture	texture handle
[in]	theGraphicsLib	graphics library in which texture handle is defined
[in]	theColorSpace	texture color space; sRGB means no color conversion by composer; Linear means to sRGB color conversion by composer
[in]	theEye	eye to display

Returns: FALSE on error

Implemented in Aspect_OpenVRSession.

◆ TrackedPoses()

const Aspect_TrackedDevicePoseArray & Aspect_XRSession::TrackedPoses ( ) const

inline

Return number of tracked poses array.

◆ TrackingOrigin()

TrackingUniverseOrigin Aspect_XRSession::TrackingOrigin ( ) const

inline

Return tracking origin.

◆ TriggerHapticVibrationAction()

void Aspect_XRSession::TriggerHapticVibrationAction	(	const Handle< Aspect_XRAction > &	theAction,
		const Aspect_XRHapticActionData &	theParams )

Trigger vibration.

◆ triggerHapticVibrationAction()

virtual void Aspect_XRSession::triggerHapticVibrationAction	(	const Handle< Aspect_XRAction > &	theAction,
		const Aspect_XRHapticActionData &	theParams )

protectedpure virtual

Trigger vibration.

Implemented in Aspect_OpenVRSession.

◆ UnitFactor()

Standard_Real Aspect_XRSession::UnitFactor ( ) const

inline

Return unit scale factor defined as scale factor for m (meters); 1.0 by default.

◆ WaitPoses()

virtual bool Aspect_XRSession::WaitPoses ( )

pure virtual

Fetch actual poses of tracked devices.

Implemented in Aspect_OpenVRSession.

Field Documentation

◆ myActionSets

Aspect_XRActionSetMap Aspect_XRSession::myActionSets

protected

actions sets

◆ myAspect

Standard_Real Aspect_XRSession::myAspect

protected

aspect ratio

◆ myDispFreq

Standard_ShortReal Aspect_XRSession::myDispFreq

protected

display frequency

◆ myFieldOfView

Standard_Real Aspect_XRSession::myFieldOfView

protected

field of view

◆ myFrustumL

Aspect_FrustumLRBT<double> Aspect_XRSession::myFrustumL

protected

left eye projection frustum

◆ myFrustumR

Aspect_FrustumLRBT<double> Aspect_XRSession::myFrustumR

protected

right eye projection frustum

◆ myHeadPose

gp_Trsf Aspect_XRSession::myHeadPose

protected

head orientation

◆ myIod

Standard_Real Aspect_XRSession::myIod

protected

intra-ocular distance in meters

◆ myRendSize

NCollection_Vec2<int> Aspect_XRSession::myRendSize

protected

viewport Width x Height for rendering into VR

◆ myRoleActions

NCollection_Array1< Handle< Aspect_XRAction > > Aspect_XRSession::myRoleActions[Aspect_XRTrackedDeviceRole_NB]

protected

generic actions

◆ myTrackedPoses

Aspect_TrackedDevicePoseArray Aspect_XRSession::myTrackedPoses

protected

array of tracked poses

◆ myTrackOrigin

TrackingUniverseOrigin Aspect_XRSession::myTrackOrigin

protected

tracking origin

◆ myUnitFactor

Standard_Real Aspect_XRSession::myUnitFactor

protected

unit scale factor defined as scale factor for m (meters)

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

Aspect_XRSession.hxx

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ InfoString

◆ TrackingUniverseOrigin

Constructor & Destructor Documentation

◆ Aspect_XRSession()

Member Function Documentation

◆ AbortHapticVibrationAction()

◆ Aspect()

◆ Close()

◆ DisplayFrequency()

◆ EyeToHeadTransform()

◆ FieldOfView()

◆ GenericAction()

◆ GetAnalogActionData()

◆ GetDigitalActionData()

◆ GetPoseActionDataForNextFrame()

◆ GetString()

◆ HasProjectionFrustums()

◆ HasTrackedPose()

◆ HeadPose()

◆ HeadToEyeTransform()

◆ IOD()

◆ IsOpen()

◆ LeftHandPose()

◆ LoadRenderModel() [1/2]

◆ LoadRenderModel() [2/2]

◆ loadRenderModel()

◆ NamedTrackedDevice()

◆ Open()

◆ ProcessEvents()

◆ ProjectionFrustum()

◆ ProjectionMatrix()

◆ RecommendedViewport()

◆ RightHandPose()

◆ SetTrackingOrigin()

◆ SetUnitFactor()

◆ SubmitEye()

◆ TrackedPoses()

◆ TrackingOrigin()

◆ TriggerHapticVibrationAction()

◆ triggerHapticVibrationAction()

◆ UnitFactor()

◆ WaitPoses()

Field Documentation

◆ myActionSets

◆ myAspect

◆ myDispFreq

◆ myFieldOfView

◆ myFrustumL

◆ myFrustumR

◆ myHeadPose

◆ myIod

◆ myRendSize

◆ myRoleActions

◆ myTrackedPoses

◆ myTrackOrigin

◆ myUnitFactor