BaseEntity

Artifact: androidx.xr.scenecore:scenecore

Kotlin |Java

public abstract class BaseEntity<RtEntityType extends Entity> extends BaseScenePose implements Entity

java.lang.Object
↳	androidx.xr.scenecore.BaseScenePose
	↳	androidx.xr.scenecore.BaseEntity

Known direct subclasses

ActivitySpace, AnchorEntity, GltfModelEntity, GroupEntity, PanelEntity, SurfaceEntity

`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.
`PanelEntity`	PanelEntity contains an arbitrary 2D Android `View`, within a spatialized XR scene.
`SurfaceEntity`	SurfaceEntity is an `Entity` that hosts a `Surface`, which will be texture mapped onto the `Shape`.

Known indirect subclasses

ActivityPanelEntity, MainPanelEntity

`ActivityPanelEntity`	ActivityPanelEntity creates a spatial panel for embedding an `Activity` in Android XR.
`MainPanelEntity`	Represents the main spatialized panel in a `Scene`.

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

Summary

Public methods
`void`	`addChild(@NonNull Entity child)` Sets an Entity to be a child of this Entity in the scene graph.
`boolean`	`addComponent(@NonNull Component component)` Adds a Component to this Entity.
`void`	`dispose()` Disposes of any system resources held by this Entity, and transitively calls dispose() on all its children.
`float`	`getAlpha(@NonNull Space relativeTo)` Returns the alpha transparency set for this Entity, relative to given Space.
`@NonNull List<@NonNull Entity>`	`getChildren()` Provides the list of all children of this entity.
`@NonNull List<@NonNull Component>`	`getComponents()` Retrieves all components attached to this Entity.
`@NonNull List<@NonNull T>`	`<T extends Component> getComponentsOfType(@NonNull Class<@NonNull T> type)` Retrieves all Components of the given type `T` and its sub-types attached to this Entity.
`@NonNull CharSequence`	`getContentDescription()` Alternate text for this Entity to be consumed by Accessibility systems.
`Entity`	`getParent()` The parent of this Entity, from which this Entity will inherit most of its properties.
`@NonNull Pose`	`getPose(@NonNull Space relativeTo)` Returns the `Pose` for this Entity, relative to the provided `Space`.
`float`	`getScale(@NonNull Space relativeTo)` Returns the scale of this entity, relative to given space.
`boolean`	`isEnabled(boolean includeParents)` Returns the enabled status of this Entity.
`void`	`removeAllComponents()` Remove all components from this Entity.
`void`	`removeComponent(@NonNull Component component)` Removes the given Component from this Entity.
`void`	`setAlpha(float alpha, @NonNull Space relativeTo)` Sets the alpha transparency of the Entity relative to given Space.
`void`	`setContentDescription(@NonNull CharSequence contentDescription)` Alternate text for this Entity to be consumed by Accessibility systems.
`void`	`setEnabled(boolean enabled)` Sets the local enabled state of this Entity.
`void`	`setParent(Entity parent)` The parent of this Entity, from which this Entity will inherit most of its properties.
`void`	`setPose(@NonNull Pose pose, @NonNull Space relativeTo)` Sets the `Pose` for this Entity.
`void`	`setScale(float scale, @NonNull Space relativeTo)` Sets the scale of this Entity relative to the given Space.

Inherited methods

From androidx.xr.scenecore.Entity

`@FloatRange(from = 0.0, to = 1.0) float`	`getAlpha()` Returns the alpha transparency set for this Entity.
`@NonNull Pose`	`getPose()` Returns the `Pose` for this Entity, relative to its parent.
`@FloatRange(from = 0.0) float`	`getScale()` Returns the local scale of this Entity, not inclusive of the parent's scale.
`void`	`setAlpha(@FloatRange(from = 0.0, to = 1.0) float alpha)` Sets the alpha transparency of the Entity and its children.
`void`	`setPose(@NonNull Pose pose)` Sets the `Pose` for this Entity, relative to its parent.
`void`	`setScale(@FloatRange(from = 0.0) float scale)` Sets the scale of this Entity relative to its parent.

From androidx.xr.scenecore.ScenePose

`abstract @NonNull Pose`	`getActivitySpacePose()` The current `Pose` relative to the activity space root.
`abstract HitTestResult`	`hitTest(@NonNull Vector3 origin, @NonNull Vector3 direction)` Perform a hit test from the specified origin in the specified direction into the Scene.
`abstract 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.
`abstract @NonNull Pose`	`transformPoseTo(@NonNull Pose pose, @NonNull ScenePose destination)` Returns a `Pose` relative to this ScenePose, transformed into a Pose relative to the destination.

Public methods

addChild

public void addChild(@NonNull Entity child)

Sets an Entity to be a child of this Entity in the scene graph. The child Entity will inherit properties from the parent, and will be represented in the parent's coordinate space. From a User's perspective, as this Entity moves, the child Entity will move with it.

Parameters
`@NonNull Entity child`	The `Entity` to be attached.

addComponent

public boolean addComponent(@NonNull Component component)

Adds a Component to this Entity.

Parameters
`@NonNull Component component`	the Component to be added to the Entity.

Returns
`boolean`	True if given Component was successfully added to the Entity.

dispose

public void dispose()

Disposes of any system resources held by this Entity, and transitively calls dispose() on all its children. Once disposed, this Entity is invalid and cannot be used again.

getAlpha

public float getAlpha(@NonNull Space relativeTo)

Returns the alpha transparency set for this Entity, relative to given Space.

Parameters
`@NonNull Space relativeTo`	Gets alpha relative to given Space. Default value is the parent space.

getChildren

public @NonNull List<@NonNull Entity> getChildren()

Provides the list of all children of this entity.

getComponents

public @NonNull List<@NonNull Component> getComponents()

Retrieves all components attached to this Entity.

Returns
`@NonNull List<@NonNull Component>`	List attached to this Entity.

getComponentsOfType

public @NonNull List<@NonNull T> <T extends Component> getComponentsOfType(@NonNull Class<@NonNull T> type)

Retrieves all Components of the given type T and its sub-types attached to this Entity.

Parameters
`@NonNull Class<@NonNull T> type`	The type of Component to retrieve.

Returns
`@NonNull List<@NonNull T>`	List of the given type attached to this Entity.

getContentDescription

public @NonNull CharSequence getContentDescription()

Alternate text for this Entity to be consumed by Accessibility systems.

getParent

public Entity getParent()

The parent of this Entity, from which this Entity will inherit most of its properties. For example, this Entity's Pose is defined in relation to the parent Entity's coordinate space, so as the parent moves, this Entity will move with it. Setting the parent to null will remove the Entity from the scene graph.

getPose

public @NonNull Pose getPose(@NonNull Space relativeTo)

Returns the Pose for this Entity, relative to the provided Space.

Parameters
`@NonNull Space relativeTo`	Get the Pose relative to given Space. Default value is the parent space.

Returns
`@NonNull Pose`	Current `Pose` of the Entity relative to the given space.

getScale

public float getScale(@NonNull Space relativeTo)

Returns the scale of this entity, relative to given space.

Parameters
`@NonNull Space relativeTo`	Get the scale relative to given Space. Default value is the parent space.

Returns
`float`	Current uniform scale applied to self and children.

isEnabled

public boolean isEnabled(boolean includeParents)

Returns the enabled status of this Entity.

Parameters
`boolean includeParents`	Whether to include the enabled status of parents in the returned value.

Returns
`boolean`	If includeParents is `true`, the returned value will be `true` if this Entity or any of its ancestors is enabled. If includeParents is `false`, the local enabled state is returned. Regardless of the local enabled state, an Entity will be considered disabled if any of its ancestors are disabled.

removeAllComponents

public void removeAllComponents()

Remove all components from this Entity.

removeComponent

public void removeComponent(@NonNull Component component)

Removes the given Component from this Entity.

Parameters
`@NonNull Component component`	Component to be removed from this entity.

setAlpha

public void setAlpha(float alpha, @NonNull Space relativeTo)

Sets the alpha transparency of the Entity relative to given Space. Values are in the range 0, 1 with 0 being fully transparent and 1 being fully opaque.

This value will affect the rendering of this Entity's children. Children of this node will have their alpha levels multiplied by this value and any alpha of this entity's ancestors.

Usage restrictions:

If the provided alpha is outside the 0, 1 range, it will be clamped automatically to 0, 1.

Parameters
`float alpha`	Alpha transparency level for the Entity.
`@NonNull Space relativeTo`	Sets alpha relative to given Space. Default value is the parent Space.

setContentDescription

public void setContentDescription(@NonNull CharSequence contentDescription)

Alternate text for this Entity to be consumed by Accessibility systems.

setEnabled

public void setEnabled(boolean enabled)

Sets the local enabled state of this Entity.

When false, this Entity and all descendants will not be rendered in the scene, and the Entity will not respond to input events. If an Entity's local enabled state is true, the Entity will still be considered not enabled if at least one of its ancestors is not enabled.

Parameters
`boolean enabled`	The new local enabled state of this Entity.

setParent

public void setParent(Entity parent)

setPose

public void setPose(@NonNull Pose pose, @NonNull Space relativeTo)

Sets the Pose for this Entity. The Pose given is set relative to the Space provided.

Parameters
`@NonNull Pose pose`	The `Pose` offset from the parent.
`@NonNull Space relativeTo`	Set the pose relative to given Space. Default value is the parent space.

setScale

public void setScale(float scale, @NonNull Space relativeTo)

Sets the scale of this Entity relative to the given Space. This value will affect the rendering of this Entity's children. As the scale increases, this will uniformly stretch the content of the Entity.

Parameters
`float scale`	The uniform scale factor.
`@NonNull Space relativeTo`	Set the scale relative to given Space. Default value is the parent Space.