OpenXRAndroidGeospatialPose

Inherits: RefCounted

Represents a geospatial pose from XR_ANDROID_geospatial.

Description

Represents a position and orientation relative to the Earth, using coordinates relative to the WGS84 ellipsoid. When returned by OpenXRAndroidGeospatialExtension.transform_to_geospatial_pose, the pose also includes accuracy and validity information.

Properties

float

altitude

0.0

float

horizontal_accuracy

0.0

float

latitude

0.0

float

longitude

0.0

Quaternion

orientation

Quaternion(0, 0, 0, 1)

float

orientation_yaw_accuracy

0.0

float

vertical_accuracy

0.0

Methods

OpenXRAndroidGeospatialPose

create ( Quaternion orientation, float latitude, float longitude, float altitude ) static

bool

is_orientation_valid ( ) const

bool

is_position_valid ( ) const


Property Descriptions

float altitude = 0.0

  • void set_altitude ( float value )

  • float get_altitude ( )

The altitude in meters above the WGS84 ellipsoid.


float horizontal_accuracy = 0.0

  • float get_horizontal_accuracy ( )

The estimated horizontal accuracy of the position, defined as the radius in meters of the 68% confidence circle around the latitude and longitude. Only set when the pose is returned by OpenXRAndroidGeospatialExtension.transform_to_geospatial_pose.


float latitude = 0.0

  • void set_latitude ( float value )

  • float get_latitude ( )

The latitude in degrees, between -90 and +90.


float longitude = 0.0

  • void set_longitude ( float value )

  • float get_longitude ( )

The longitude in degrees, between -180 and +180.


Quaternion orientation = Quaternion(0, 0, 0, 1)

  • void set_orientation ( Quaternion value )

  • Quaternion get_orientation ( )

The orientation relative to an east-up-south (EUS) coordinate system, where +X is East, +Y is Up, and +Z is South. This coordinate system depends on the precise position.


float orientation_yaw_accuracy = 0.0

  • float get_orientation_yaw_accuracy ( )

The estimated yaw accuracy of the orientation, defined as the radius in degrees of the 68% confidence level around the orientation yaw angle. Only set when the pose is returned by OpenXRAndroidGeospatialExtension.transform_to_geospatial_pose.


float vertical_accuracy = 0.0

  • float get_vertical_accuracy ( )

The estimated vertical accuracy of the position in meters, defined as the 68% confidence distance around the altitude. Only set when the pose is returned by OpenXRAndroidGeospatialExtension.transform_to_geospatial_pose.


Method Descriptions

OpenXRAndroidGeospatialPose create ( Quaternion orientation, float latitude, float longitude, float altitude ) static

Creates a new OpenXRAndroidGeospatialPose with the given orientation, latitude, longitude, and altitude.


bool is_orientation_valid ( ) const

Returns true if the orientation data in this pose is valid. When false, the orientation and orientation_yaw_accuracy fields should not be used.


bool is_position_valid ( ) const

Returns true if the position data in this pose is valid. When false, the latitude, longitude, altitude, horizontal_accuracy, and vertical_accuracy fields should not be used.