Rigid Body

Component, Subscription Handler, and Motion Type

AddAngularImpulse Method

Adds an angular impulse to this RigidBodyComponent.

Syntax

[Sansar.Script.Interface] public void AddAngularImpulse (Sansar.Vector impulse)

Parameters

impulse

The impulse.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


AddAngularImpulse Method

Adds an angular impulse to this RigidBodyComponent.

Syntax

Parameters

impulse

The impulse.

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


AddAngularImpulse Method

Adds an angular impulse to this RigidBodyComponent.

Syntax

Parameters

impulse

The impulse.

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


AddLinearImpulse Method

Adds a linear impulse the the center of mass of this RigidBodyComponent.

Syntax

[Sansar.Script.Interface] public void AddLinearImpulse (Sansar.Vector impulse)

Parameters

impulse

The impulse.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


AddLinearImpulse Method

Adds a linear impulse the the center of mass of this RigidBodyComponent.

Syntax

Parameters

impulse

The impulse.

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


AddLinearImpulse Method

Adds a linear impulse the the center of mass of this RigidBodyComponent.

Syntax

Parameters

impulse

The impulse.

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


ComponentId Property

Retrieves the component id for this RigidBodyComponent.

Syntax

Value

The id.

Remarks

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


ComponentType Field

Syntax

Remarks

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


GetAngularDamping Method

Retrieves the amount of damping applied to this object's angular motion.

Syntax

[Sansar.Script.Interface] public float GetAngularDamping ()

Returns

The angular damping factor.

Remarks

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


GetAngularVelocity Method

Retrieves the angular velocity for this RigidBodyComponent.

Syntax

[Sansar.Script.Interface] public Sansar.Vector GetAngularVelocity ()

Returns

The velocity.

Remarks

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


GetBounce Method

Retrieves the bounce of this RigidBodyComponent.

Syntax

[Sansar.Script.Interface] public float GetBounce ()

Returns

The bounce factor.

Remarks

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


GetCanGrab Method

The can grab state for this RigidBodyComponent.

Syntax

[Sansar.Script.Interface] public bool GetCanGrab ()

Returns

A bool indicating if the object can be picked up.

Remarks

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


GetCenterOfMass Method

Retrieves the center of mass of this object in local space.

Syntax

[Sansar.Script.Interface] public Sansar.Vector GetCenterOfMass ()

Returns

A Vector to the center of mass of this object, in the objects local space.

Remarks

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


GetColliderCenter Method

Retrieves the center of the collision shape for this object in local space.

Syntax

[Sansar.Script.Interface] public Sansar.Vector GetColliderCenter ()

Returns

The center of the collision shape.

Remarks

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


GetColliderExtents Method

Retrieves the extents of the collision shape for this object in local space.

Syntax

[Sansar.Script.Interface] public Sansar.Vector GetColliderExtents ()

Returns

The extents of the collision shape.

Remarks

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


GetDynamicFriction Method

Retrieves the dynamic friction of this RigidBodyComponent.

Syntax

[Sansar.Script.Interface] public float GetDynamicFriction ()

Returns

The dynamic friction.

Remarks

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


GetGravityFactor Method

Retrieves what factor of the world's gravity is applied to this object.

Syntax

[Sansar.Script.Interface] public float GetGravityFactor ()

Returns

The gravity factor.

Remarks

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


GetHeldObjectInfo Method

Data about who is holding this RigidBodyComponent.

Syntax

[Sansar.Script.Interface] public HeldObjectInfo GetHeldObjectInfo ()

Returns

A Sansar.Simulation.HeldObjectInfo struct.

Remarks

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


GetInverseInertia Method

Retrieves the moment of inertia for this object.

Syntax

[Sansar.Script.Interface] public Sansar.Vector GetInverseInertia ()

Returns

A Vector representation of the inverse moment of inertia.

Remarks

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


GetLinearDamping Method

Retrieves the amount of damping applied to this object's linear motion.

Syntax

[Sansar.Script.Interface] public float GetLinearDamping ()

Returns

The linear damping factor.

Remarks

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


GetLinearVelocity Method

Retrieves the linear velocity for this RigidBodyComponent.

Syntax

[Sansar.Script.Interface] public Sansar.Vector GetLinearVelocity ()

Returns

The velocity.

Remarks

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


GetMass Method

Retrieves the mass of this RigidBodyComponent.

Syntax

[Sansar.Script.Interface] public float GetMass ()

Returns

The mass.

Remarks

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


GetMotionType Method

The motion type for this RigidBodyComponent.

Syntax

Returns

A RigidBodyMotionType enum for the motion type.

Remarks

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


GetOrientation Method

Retrieves the orientation of this RigidBodyComponent.

Syntax

Returns

The orientation.

Remarks

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


GetPosition Method

Retrieves the position of this RigidBodyComponent.

Syntax

[Sansar.Script.Interface] public Sansar.Vector GetPosition ()

Returns

The position.

Remarks

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


GetSitObjectInfo Method

Data about who is sitting on this RigidBodyComponent.

Syntax

[Sansar.Script.Interface] public SitObjectInfo[] GetSitObjectInfo ()

Returns

A Sansar.Simulation.SitObjectInfo struct.

Remarks

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


GetStaticFriction Method

Retrieves the static friction of this RigidBodyComponent.

Syntax

[Sansar.Script.Interface] public float GetStaticFriction ()

Returns

The static friction.

Remarks

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


IsDynamic Method

Whether this rigidbody is dynamic.

Syntax

[Sansar.Script.Interface] [System.Obsolete("Use GetMotionType()", false)] public bool IsDynamic ()

Returns

True if this is a dynamic object.

Remarks

Deprecated. Use GetMotionType() instead.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


IsTriggerVolume Method

Whether this RigidBodyComponent is a TriggerVolume.

Syntax

[Sansar.Script.Interface] public bool IsTriggerVolume ()

Returns

True if this RigidBodyComponent is a TriggerVolume.

Remarks

TriggerVolumes can be moved through and generate CollisionEventType.cTrigger collision events instead of normal collision events.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


Name Property

This RigidBodyComponent name, as specified in the editor.

Syntax

[get: Sansar.Script.Interface] public string Name { get; }

Value

Remarks

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


ReleaseHeldObject Method

Force any agent holding this object to drop it.

Syntax

[Sansar.Script.Interface] public void ReleaseHeldObject ()

Remarks

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


ReleaseHeldObject Method

Force any agent holding this object to drop it.

Syntax

Parameters

handler

Handler to be called when the event completes.

Remarks

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetAngularDamping Method

Sets the amount of damping to apply to this object's angular motion.

Syntax

[Sansar.Script.Interface] public void SetAngularDamping (float angularDamping)

Parameters

angularDamping

The angular damping factor. Default value is 0.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetAngularDamping Method

Sets the amount of damping to apply to this object's angular motion.

Syntax

Parameters

angularDamping

The angular damping factor. Default value is 0.

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetAngularDamping Method

Sets the amount of damping to apply to this object's angular motion.

Syntax

Parameters

angularDamping

The angular damping factor. Default value is 0.

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetAngularVelocity Method

Sets the angular velocity for this RigidBodyComponent. Angular velocity is clamped between -100m/s and 100m/s.

Syntax

[Sansar.Script.Interface] public void SetAngularVelocity (Sansar.Vector velocity)

Parameters

velocity

The velocity.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. Subsequent calls to RigidBodyComponent.GetAngularVelocity will return the previous velocity until the write occurs. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetAngularVelocity Method

Sets the angular velocity for this RigidBodyComponent.

Syntax

Parameters

velocity

The velocity.

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. Subsequent calls to RigidBodyComponent.GetAngularVelocity will return the previous velocity until the write occurs. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetAngularVelocity Method

Sets the angular velocity for this RigidBodyComponent. Angular velocity is clamped between -100m/s and 100m/s.

Syntax

Parameters

velocity

The velocity.

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. Subsequent calls to RigidBodyComponent.GetAngularVelocity will return the previous velocity until the write occurs. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetBounce Method

Sets the bounce of this RigidBodyComponent.

Syntax

[Sansar.Script.Interface] public void SetBounce (float bounce)

Parameters

bounce

The bounce factor. Value should be between 0 and 1 (inclusive)

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetBounce Method

Sets the bounce of this RigidBodyComponent.

Syntax

Parameters

bounce

The bounce factor. Value should be between 0 and 1 (inclusive)

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetBounce Method

Sets the bounce of this RigidBodyComponent.

Syntax

Parameters

bounce

The bounce factor. Value should be between 0 and 1 (inclusive)

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetCanGrab Method

Sets the can grab state for this rigidbody.

Syntax

[Sansar.Script.Interface] public void SetCanGrab (bool canGrab)

Parameters

canGrab

Boolean value to indicate if the rigid body can be grabbed.

Returns

The return value is an internal event id.

Remarks

This method will throw an exception if the rigid body has the static motion type. This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetCanGrab Method

Sets the can grab state for this rigidbody.

Syntax

Parameters

canGrab

Boolean value to indicate if the rigid body can be grabbed.

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

This method will throw an exception if the rigid body has the static motion type. This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetCenterOfMass Method

Sets the center of mass of this object in local space.

Syntax

[Sansar.Script.Interface] public void SetCenterOfMass (Sansar.Vector centerOfMass)

Parameters

centerOfMass

A Vector to the center of mass of this object, in the objects local space.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetCenterOfMass Method

Sets the center of mass of this object in local space.

Syntax

Parameters

centerOfMass

A Vector to the center of mass of this object, in the objects local space.

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetCenterOfMass Method

Sets the center of mass of this object in local space.

Syntax

Parameters

centerOfMass

A Vector to the center of mass of this object, in the objects local space.

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetDynamicFriction Method

Sets the dynamic friction of this RigidBodyComponent.

Syntax

[Sansar.Script.Interface] public void SetDynamicFriction (float dynamicFriction)

Parameters

dynamicFriction

The dynamic friction. Value should be between 0 and 1 (inclusive)

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetDynamicFriction Method

Sets the dynamic friction of this RigidBodyComponent.

Syntax

Parameters

dynamicFriction

The dynamic friction. Value should be between 0 and 1 (inclusive)

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetDynamicFriction Method

Sets the dynamic friction of this RigidBodyComponent.

Syntax

Parameters

dynamicFriction

The dynamic friction. Value should be between 0 and 1 (inclusive)

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetGravityFactor Method

Sets what factor of the world's gravity is applied to this object.

Syntax

[Sansar.Script.Interface] public void SetGravityFactor (float gravityFactor)

Parameters

gravityFactor

The gravityFactor. Default value is 1, range is -2 to 2

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetGravityFactor Method

Sets what factor of the world's gravity is applied to this object.

Syntax

Parameters

gravityFactor

The gravityFactor. Default value is 1, range is -2 to 2

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetGravityFactor Method

Sets what factor of the world's gravity is applied to this object.

Syntax

Parameters

gravityFactor

The gravityFactor. Default value is 1, range is -2 to 2

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetInverseInertia Method

Sets the moment of inertia for this object.

Syntax

[Sansar.Script.Interface] public void SetInverseInertia (Sansar.Vector inverseInertia)

Parameters

inverseInertia

A Vector representation of the inverse moment of inertia for this object in world space.

Returns

The return value is an internal event id.

Remarks

Setting this to zero in the x and y components, for example, will give this object infinite inertia on the x and y axes and only permit it to rotate around the z axis. This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetInverseInertia Method

Sets the moment of inertia for this object.

Syntax

Parameters

inverseInertia

A Vector representation of the inverse moment of inertia for this object in world space.

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

Setting this to zero in the x and y components, for example, will give this object infinite inertia on the x and y axes and only permit it to rotate around the z axis. This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetLinearDamping Method

Sets the amount of damping to apply to this object's linear motion.

Syntax

[Sansar.Script.Interface] public void SetLinearDamping (float linearDamping)

Parameters

linearDamping

The linear damping factor. Default value is 0.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetLinearDamping Method

Sets the amount of damping to apply to this object's linear motion.

Syntax

Parameters

linearDamping

The linear damping factor. Default value is 0.

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetLinearDamping Method

Sets the amount of damping to apply to this object's linear motion.

Syntax

Parameters

linearDamping

The linear damping factor. Default value is 0.

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetLinearVelocity Method

Sets the linear velocity for this RigidBodyComponent. Linear velocity is clamped between -200m/s and 200m/s.

Syntax

[Sansar.Script.Interface] public void SetLinearVelocity (Sansar.Vector velocity)

Parameters

velocity

The velocity.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. Subsequent calls to RigidBodyComponent.GetLinearVelocity will return the previous velocity until the write occurs. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetLinearVelocity Method

Sets the linear velocity for this RigidBodyComponent.

Syntax

Parameters

velocity

The velocity.

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. Subsequent calls to RigidBodyComponent.GetLinearVelocity will return the previous velocity until the write occurs. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetLinearVelocity Method

Sets the linear velocity for this RigidBodyComponent. Linear velocity is clamped between -200m/s and 200m/s.

Syntax

Parameters

velocity

The velocity.

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. Subsequent calls to RigidBodyComponent.GetLinearVelocity will return the previous velocity until the write occurs. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetMass Method

Sets the mass of this RigidBodyComponent.

Syntax

[Sansar.Script.Interface] public void SetMass (float mass)

Parameters

mass

The mass.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetMass Method

Sets the mass of this RigidBodyComponent.

Syntax

Parameters

mass

The mass.

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetMass Method

Sets the mass of this RigidBodyComponent.

Syntax

Parameters

mass

The mass.

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetMotionType Method

Sets the motion type for this rigidbody.

Syntax

Parameters

motionType

The motion type.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetMotionType Method

Sets the motion type for this rigidbody.

Syntax

Parameters

motionType

The motion type.

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetMotionType Method

Sets the motion type for this rigidbody.

Syntax

Parameters

motionType

The motion type.

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetOrientation Method

Sets the orientation of this RigidBodyComponent.

Syntax

Parameters

orientation

The orientation.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetOrientation Method

Sets the orientation of this $className$.

Syntax

[Sansar.Script.Interface] [System.Obsolete("Use SetOrientation(Quaternion)", false)] public ulong SetOrientation (Sansar.Vector orientation)

Parameters

orientation

The orientation.

Returns

The return value is an internal event id.

Remarks

Deprecated. Use SetOrientation(Quaternion) instead.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetOrientation Method

Sets the orientation of this RigidBodyComponent.

Syntax

Parameters

orientation

The orientation.

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetOrientation Method

Sets the orientation of this RigidBodyComponent.

Syntax

Parameters

orientation

The orientation.

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetOrientation Method

Sets the orientation of this $className$.

Syntax

Parameters

orientation

The orientation.

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

Deprecated. Use SetOrientation(Quaternion) instead.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetOrientation Method

Sets the orientation of this $className$.

Syntax

Parameters

orientation

The orientation.

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

Deprecated. Use SetOrientation(Quaternion) instead.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetPosition Method

Sets the position of this RigidBodyComponent.

Syntax

[Sansar.Script.Interface] public void SetPosition (Sansar.Vector position)

Parameters

position

The position.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetPosition Method

Sets the position of this RigidBodyComponent.

Syntax

Parameters

position

The position.

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetPosition Method

Sets the position of this RigidBodyComponent.

Syntax

Parameters

position

The position.

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetStaticFriction Method

Sets the static friction of this RigidBodyComponent.

Syntax

[Sansar.Script.Interface] public void SetStaticFriction (float staticFriction)

Parameters

staticFriction

The static friction. Value should be between 0 and 1 (inclusive)

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetStaticFriction Method

Sets the static friction of this RigidBodyComponent.

Syntax

Parameters

staticFriction

The static friction. Value should be between 0 and 1 (inclusive)

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SetStaticFriction Method

Sets the static friction of this RigidBodyComponent.

Syntax

Parameters

staticFriction

The static friction. Value should be between 0 and 1 (inclusive)

handler

Handler to be called when the event completes.

Returns

The return value is an internal event id.

Remarks

This asynchronous method queues the write then returns. To block until the write has occurred, pass this method to Sansar.Script.ScriptBase.WaitFor while in a coroutine.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


Subscribe Method

Subscribes to Collision Events.

Syntax

Parameters

EventType

The type of collision which occurred.

callback

Callback which is executed when the event completes.

persistent

Optional, set to false to unsubscribe after one event.

Remarks

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


Subscribe Method

Subscribes to Collision Events.

Syntax

See Also

Parameters

EventType

The type of collision which occurred.

callback

Callback which is executed when the event completes.

persistent

Optional, set to false to unsubscribe after one event.

Returns

An Sansar.Script.IEventSubscription that can be used to cancel the subscription.

Remarks

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


Subscribe Method

Subscribes to Collision Events.

Syntax

Parameters

EventType

The type of collision which occurred.

HitComponentId

The id of the rigid body component or character that was hit.

callback

Callback which is executed when the event completes.

persistent

Optional, set to false to unsubscribe after one event.

Remarks

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


Subscribe Method

Subscribes to Collision Events.

Syntax

See Also

Parameters

EventType

The type of collision which occurred.

HitComponentId

The id of the rigid body component or character that was hit.

callback

Callback which is executed when the event completes.

persistent

Optional, set to false to unsubscribe after one event.

Returns

An Sansar.Script.IEventSubscription that can be used to cancel the subscription.

Remarks

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SubscribeToHeldObject Method

Subscribes to HeldObject Events.

Syntax

See Also

Parameters

HeldObjectEvent

The type of held object event which occurred.

callback

Callback which is executed when the event completes.

persistent

Optional, set to false to unsubscribe after one event.

Returns

An Sansar.Script.IEventSubscription that can be used to cancel the subscription.

Remarks

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


SubscribeToSitObject Method

Subscribes to SitObject Events.

Syntax

See Also

Parameters

SitObjectEvent

The type of sit event which occurred.

callback

Callback which is executed when the event completes.

persistent

Optional, set to false to unsubscribe after one event.

Returns

An Sansar.Script.IEventSubscription that can be used to cancel the subscription.

Remarks

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


ToString Method

A string representation of this object.

Syntax

[Sansar.Script.Interface] public override string ToString ()

Returns

A string representation of this object.

Remarks

The format of this string may change between releases.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


RigidBodyComponent.SubscriptionHandler

RigidBodyComponent.SubscriptionHandler Delegate

Handler for rigid body events.

Parameters

EventType

The type of collision which occurred.

ComponentId

The id of the rigid body component.

HitComponentId

The id of the rigid body component or character that was hit.

HitObject

The Sansar.Simulation.ObjectPublic that was hit.

Phase

used by trigger events to determine if trigger enter or exit occurred

HitControlPoint

The specific control point hit, if any

Remarks

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


RigidBodyMotionType

RigidBodyMotionType Enum

Type of motion that can be applied to a rigid body.

Syntax

[Sansar.Script.Interface] public enum RigidBodyMotionType

Remarks

Documentation for this section has not yet been entered.

Members

Member NameDescription

MotionTypeDynamic

Dynamic. This object is fully affected by the physics simulation.

MotionTypeKeyframed

Keyframed. This object has its position and velocity directly controlled by scripts.

MotionTypeStatic

Static. This object never moves.

Requirements

Namespace: Sansar.Simulation Assembly: Sansar.Simulation (in Sansar.Simulation.dll) Assembly Versions: 1.1.0.0


Last updated