JxrPlatformAdapter.StereoSurfaceEntity

Artifact: androidx.xr.scenecore:scenecore

Kotlin |Java

public interface JxrPlatformAdapter.StereoSurfaceEntity extends JxrPlatformAdapter.Entity

Interface for a surface which images can be rendered into.

Summary

Public methods
`abstract @NonNull JxrPlatformAdapter.Dimensions`	`getDimensions()` Retrieves the dimensions of the "spatial canvas" which the surface is mapped to.
`abstract int`	`getStereoMode()` Retrieves the StereoMode for this Entity.
`abstract @NonNull Surface`	`getSurface()` Retrieves the surface that the Entity will display.
`abstract void`	`setDimensions(@NonNull JxrPlatformAdapter.Dimensions dimensions)` Changes the width and height of the "spatial canvas" which the surface is mapped to.
`abstract void`	`setStereoMode(int mode)` Specifies how the surface content will be routed for stereo viewing.

Inherited methods

From androidx.xr.scenecore.JxrPlatformAdapter.ActivityPose

`abstract @NonNull Pose`	`getActivitySpacePose()` Returns the pose for this entity, relative to the activity space root.
`abstract @NonNull Vector3`	`getActivitySpaceScale()` Returns the scale of this WorldPose relative to the activity space.
`abstract @NonNull Vector3`	`getWorldSpaceScale()` Returns the scale of this ActivityPose.
`abstract @NonNull Pose`	`transformPoseTo( @NonNull Pose pose, @NonNull JxrPlatformAdapter.ActivityPose destination )` Returns a pose relative to this entity transformed into a pose relative to the destination.

From androidx.xr.scenecore.JxrPlatformAdapter.Entity

`abstract void`	`addChild(@NonNull JxrPlatformAdapter.Entity child)` Add given Entity as child.
`abstract void`	`addChildren(@NonNull List<JxrPlatformAdapter.Entity> children)`
`abstract boolean`	`addComponent(@NonNull JxrPlatformAdapter.Component component)` Add these components to entity.
`abstract void`	`addInputEventListener( @NonNull Executor executor, @NonNull JxrPlatformAdapter.InputEventListener listener )` Adds the listener to the set of active input listeners, for input events targeted to this entity or its child entities.
`abstract void`	`dispose()` Dispose any system resources held by this entity, and transitively calls dispose() on all the children.
`abstract float`	`getActivitySpaceAlpha()` Returns the total alpha transparency level for this Entity.
`abstract float`	`getAlpha()` Returns the set alpha transparency level for this Entity.
`abstract @NonNull List<JxrPlatformAdapter.Entity>`	`getChildren()`
`abstract @Nullable JxrPlatformAdapter.Entity`	`getParent()`
`abstract @NonNull Pose`	`getPose()` Returns the pose for this entity, relative to its parent.
`abstract @NonNull Vector3`	`getScale()` Returns the scale of this entity, relative to its parent.
`abstract boolean`	`isHidden(boolean includeParents)` Returns the hidden status of this Entity.
`abstract void`	`removeAllComponents()` Remove all components from this entity.
`abstract void`	`removeComponent(@NonNull JxrPlatformAdapter.Component component)` Remove the given component from the entity.
`abstract void`	`removeInputEventListener( @NonNull JxrPlatformAdapter.InputEventListener listener )` Removes the given listener from the set of active input listeners.
`abstract void`	`setAlpha(float alpha)` Sets the alpha transparency for the given Entity.
`abstract void`	`setContentDescription(@NonNull String text)`
`abstract void`	`setHidden(boolean hidden)` Sets the local hidden state of this Entity.
`abstract void`	`setParent(@Nullable JxrPlatformAdapter.Entity parent)`
`abstract void`	`setPose(@NonNull Pose pose)` Updates the pose (position and rotation) of the Entity relative to its parent.
`abstract void`	`setScale(@NonNull Vector3 scale)` Sets the scale of this entity relative to its parent.
`abstract void`	`setSize(@NonNull JxrPlatformAdapter.Dimensions dimensions)` Sets the size for the given Entity.

Public methods

getDimensions

Added in 1.0.0-alpha01

abstract @NonNull JxrPlatformAdapter.Dimensions getDimensions()

Retrieves the dimensions of the "spatial canvas" which the surface is mapped to. These values are not impacted by scale.

Returns
`@NonNull JxrPlatformAdapter.Dimensions`	The canvas [Dimensions].

getStereoMode

Added in 1.0.0-alpha01

abstract int getStereoMode()

Retrieves the StereoMode for this Entity.

Returns
`int`	An int StereoMode

getSurface

Added in 1.0.0-alpha01

abstract @NonNull Surface getSurface()

Retrieves the surface that the Entity will display. The app can write into this surface however it wants, i.e. MediaPlayer, ExoPlayer, or custom rendering.

Returns
`@NonNull Surface`	an Android [Surface]

setDimensions

Added in 1.0.0-alpha01

abstract void setDimensions(@NonNull JxrPlatformAdapter.Dimensions dimensions)

Changes the width and height of the "spatial canvas" which the surface is mapped to. (0,0,0) for this Entity is the canvas's center. (In ActivitySpace, this is 1/getWorldSpaceScale() unit per meter) (Z is ignored)

Parameters
`@NonNull JxrPlatformAdapter.Dimensions dimensions`	A [Dimensions] to set the canvas size.

setStereoMode

Added in 1.0.0-alpha01

abstract void setStereoMode(int mode)

Specifies how the surface content will be routed for stereo viewing. Applications must render into the surface in accordance with what is specified here in order for the compositor to correctly produce a stereoscopic view to the user.

Parameters
`int mode`	An int StereoMode