BaseScenePose


public abstract class BaseScenePose<RtActivityPoseType extends ActivityPose> implements ScenePose

Known direct subclasses
BaseEntity

The BaseEntity is an implementation of Entity interface that wraps a platform entity.

CameraView

An ScenePose which tracks a camera view's position and view into physical space.

Head

Head is an ScenePose used to track the position of the user's head.

PerceptionSpace

PerceptionSpace is an ScenePose used to track the origin of the space used by ARCore for Jetpack XR APIs.

Known indirect subclasses
ActivityPanelEntity

ActivityPanelEntity creates a spatial panel for embedding an Activity in Android XR.

ActivitySpace

ActivitySpace is an Entity used to track the system-managed pose and boundary of the volume associated with a spatialized Activity.

AnchorEntity

An AnchorEntity tracks a androidx.xr.runtime.math.Pose relative to some position or surface in the "Real World." Children of this Entity will remain positioned relative to that location in the real world, for the purposes of creating Augmented Reality experiences.

GltfModelEntity

GltfModelEntity is a concrete implementation of Entity that hosts a glTF model.

GroupEntity

An Entity that contains no content, but can have an arbitrary number of children.

MainPanelEntity

Represents the main spatialized panel in a Scene.

PanelEntity

PanelEntity contains an arbitrary 2D Android View, within a spatialized XR scene.

SurfaceEntity

SurfaceEntity is a concrete implementation of Entity that hosts a StereoSurface Canvas.


The BaseScenePose implements the ScenePose interface.

Summary

Protected constructors

<RtActivityPoseType extends ActivityPose> BaseScenePose(
    @NonNull RtActivityPoseType rtActivityPose
)

Public methods

@NonNull Pose

The current Pose relative to the activity space root.

@NonNull HitTestResult
hitTest(@NonNull Vector3 origin, @NonNull Vector3 direction)

Creates a hit test from the specified origin in the specified direction into the Scene.

@NonNull HitTestResult
hitTest(
    @NonNull Vector3 origin,
    @NonNull Vector3 direction,
    int hitTestFilter
)

Creates a hit test from the specified origin in the specified direction into the scene.

@NonNull Pose
transformPoseTo(@NonNull Pose pose, @NonNull ScenePose destination)

Returns a Pose relative to this ScenePose, transformed into a Pose relative to the destination.

Protected constructors

BaseScenePose

protected <RtActivityPoseType extends ActivityPose> BaseScenePose(
    @NonNull RtActivityPoseType rtActivityPose
)

Public methods

getActivitySpacePose

public @NonNull Pose getActivitySpacePose()

The current Pose relative to the activity space root.

hitTest

public @NonNull HitTestResult hitTest(@NonNull Vector3 origin, @NonNull Vector3 direction)

Creates a hit test from the specified origin in the specified direction into the Scene.

Parameters
@NonNull Vector3 origin

The translation of the origin of the hit test relative to this ScenePose.

@NonNull Vector3 direction

The direction for the hit test ray from the origin.

Returns
@NonNull HitTestResult

a HitResult. The HitResult describes if it hit something and where relative to this ScenePose.

hitTest

public @NonNull HitTestResult hitTest(
    @NonNull Vector3 origin,
    @NonNull Vector3 direction,
    int hitTestFilter
)

Creates a hit test from the specified origin in the specified direction into the scene.

Parameters
@NonNull Vector3 origin

The translation of the origin of the hit test relative to this ScenePose.

@NonNull Vector3 direction

The direction for the hit test ray from the origin

int hitTestFilter

Filter for which scenes to hit test. Hitting other scenes is only allowed for apps with the com.android.extensions.xr.ACCESS_XR_OVERLAY_SPACE permission.

Returns
@NonNull HitTestResult

a HitResult. The HitResult describes if it hit something and where relative to this ScenePose.

transformPoseTo

public @NonNull Pose transformPoseTo(@NonNull Pose pose, @NonNull ScenePose destination)

Returns a Pose relative to this ScenePose, transformed into a Pose relative to the destination.

Parameters
@NonNull Pose pose

A Pose in this ScenePose's local coordinate space.

@NonNull ScenePose destination

The ScenePose which the returned Pose will be relative to.

Returns
@NonNull Pose

The Pose relative to the destination ScenePose.