<?xml version="1.0" ?>
<ComponentSchema packageName="com.meta.aether.apps.experiments.physics">
 <Component name="CustomPhysics">
   <Vector3Attribute
     name="initialLinearVelocity"
     defaultValue="0.0f, 0.0f, 0.0f"
   />
 </Component>
</ComponentSchema>

System:

class CustomPhysicsSystem() : SystemBase() {
private val physicsObjects_ = HashMap<Entity, ScenePhysicsObject>()
override fun execute() {
  val q = Query.where { changed(CustomPhysics.id) and has(Transform.id) }
  for (ent in q.eval()) {
    if (physicsObjects_.containsKey(ent)) {
      continue
    }
    val physics = ScenePhysicsObject.createBox(getScene(), ent, 0.25f, 0.25f, 0.25f, 0.5f)
    physicsObjects_.put(ent, physics)
    physics.setPose(ent.getComponent<Transform>().transform)
    physics.setLinearVelocity(ent.getComponent<CustomPhysics>().initialLinearVelocity)
    Log.i("Physics", "Created physics object for entity $ent $physics")
  }
}
override fun delete(entity: Entity) {
  if (physicsObjects_.containsKey(entity)) {
    physicsObjects_[entity]?.destroy()
    physicsObjects_.remove(entity)
  }
}

Signature

open class ScenePhysicsObject

Properties

entity : Entity? `[Get]`	Signature val entity: Entity?
handle : Long `[Get]`	Native handle to the physics object. Signature var handle: Long

Functions

applyForce ( force )	Applies a force to this physics object Signature fun applyForce(force: Vector3) Parameters force: Vector3 The force vector to apply (in newtons)
applyForceAtRelativePosition ( force , relativePos )	Applies a force to this physics object at a specified position relative to its center. This can create both linear and angular acceleration depending on the force and position. Signature fun applyForceAtRelativePosition(force: Vector3, relativePos: Vector3) Parameters force: Vector3 The force vector to apply (in newtons) relativePos: Vector3 The position relative to the center of mass where the force is applied
applyTorque ( torqueX , torqueY , torqueZ )	Applies a torque (rotational force) to this physics object. Signature fun applyTorque(torqueX: Float, torqueY: Float, torqueZ: Float) Parameters torqueX: Float The X component of the torque vector torqueY: Float The Y component of the torque vector torqueZ: Float The Z component of the torque vector
destroy ()	Signature fun destroy()
getPose () : Pose	Gets the current position and rotation of this physics object. Signature fun getPose(): Pose Returns Pose The current pose
setAngularVelocity ( angularVelocity )	Sets the angular velocity of this physics object. Signature fun setAngularVelocity(angularVelocity: Vector3) Parameters angularVelocity: Vector3 The angular velocity vector (in radians per second)
setFriction ( friction , rolling , spinning )	Sets the friction properties of this physics object. Signature fun setFriction(friction: Float, rolling: Float = friction, spinning: Float) Parameters friction: Float The surface friction coefficient rolling: Float The rolling friction coefficient (defaults to the same as surface friction) spinning: Float The spinning friction coefficient
setLinearVelocity ( velocity )	Sets the linear velocity of this physics object. Signature fun setLinearVelocity(velocity: Vector3) Parameters velocity: Vector3 The linear velocity vector (in meters per second)
setPose ( pose )	Sets the position and rotation of this physics object. Signature fun setPose(pose: Pose) Parameters pose: Pose The position and rotation to set
setRestitution ( restitution )	Sets the restitution (bounciness) of this physics object. Signature fun setRestitution(restitution: Float) Parameters restitution: Float The restitution value (0.0 = no bounce)

Companion Object

Companion Object Functions

createBox ( scene , entity , width , height , depth , mass ) : ScenePhysicsObject	Creates a box-shaped physics object. Signature fun createBox(scene: Scene, entity: Entity?, width: Float, height: Float, depth: Float, mass: Float): ScenePhysicsObject Parameters scene: Scene The scene in which to create the physics object entity: Entity? Optional entity to associate with this physics object width: Float Width of the box in meters height: Float Height of the box in meters depth: Float Depth of the box in meters mass: Float Mass of the box in kilograms (0 for static objects) Returns ScenePhysicsObject A new box-shaped physics object
createGLTF ( scene , entity , filename , mass ) : ScenePhysicsObject	Creates a physics object from a GLTF model file. The collision shape will be generated from the model's geometry. Signature fun createGLTF(scene: Scene, entity: Entity?, filename: String, mass: Float): ScenePhysicsObject Parameters scene: Scene The scene in which to create the physics object entity: Entity? Optional entity to associate with this physics object filename: String Path to the GLTF model file mass: Float Mass of the object in kilograms (0 for static objects) Returns ScenePhysicsObject A new physics object based on the GLTF model
createSphere ( scene , entity , radius , mass ) : ScenePhysicsObject	Creates a sphere-shaped physics object. Signature fun createSphere(scene: Scene, entity: Entity?, radius: Float, mass: Float): ScenePhysicsObject Parameters scene: Scene The scene in which to create the physics object entity: Entity? Optional entity to associate with this physics object radius: Float Radius of the sphere in meters mass: Float Mass of the sphere in kilograms (0 for static objects) Returns ScenePhysicsObject A new sphere-shaped physics object
setCallbackEntities ( scene , entities )	Sets the entities that will receive physics callbacks. Signature fun setCallbackEntities(scene: Long, entities: LongArray) Parameters scene: Long The scene handle entities: LongArray Array of entity IDs that will receive physics callbacks