Class RigidBodyShape

Namespace

Jitter2.Collision.Shapes

Assembly

Jitter2.dll

Represents the abstract base class for shapes that can be attached to a rigid body.

public abstract class RigidBodyShape : Shape, IDynamicTreeProxy, IPartitionedSetIndex, IUpdatableBoundingBox, ISupportMappable, IRayCastable, ISweepTestable, IDistanceTestable

Inheritance

object

Shape

RigidBodyShape

Implements

IDynamicTreeProxy

IPartitionedSetIndex

IUpdatableBoundingBox

ISupportMappable

IRayCastable

ISweepTestable

IDistanceTestable

Derived

BoxShape

CapsuleShape

ConeShape

ConvexHullShape

CylinderShape

PointCloudShape

SphereShape

TransformedShape

TriangleShape

Inherited Members

Shape.ShapeId

Shape.WorldBoundingBox

Shape.SweptExpandBoundingBox(float)

Shape.SupportMap(in JVector, out JVector)

Shape.GetCenter(out JVector)

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Properties

RigidBody

The instance of RigidBody to which this shape is attached.

public RigidBody RigidBody { get; }

Property Value

RigidBody

Velocity

Gets the velocity of the entity, used for bounding box expansion.

public override sealed JVector Velocity { get; }

Property Value

JVector

Methods

CalculateBoundingBox(in JQuaternion, in JVector, out JBoundingBox)

public virtual void CalculateBoundingBox(in JQuaternion orientation, in JVector position, out JBoundingBox box)

Parameters

orientation JQuaternion

position JVector

box JBoundingBox

CalculateMassInertia(out JMatrix, out JVector, out float)

Calculates the mass and inertia of the shape. Can be overridden by child classes to improve performance or accuracy. The default implementation relies on an approximation of the shape constructed using the support map function.

[ReferenceFrame(ReferenceFrame.Local)]
public virtual void CalculateMassInertia(out JMatrix inertia, out JVector com, out float mass)

Parameters

inertia JMatrix

com JVector

mass float

Remarks

The inertia tensor is computed relative to the coordinate system origin (0,0,0), not the center of mass.

Distance<T>(in T, in JQuaternion, in JVector, out JVector, out JVector, out JVector, out float)

Finds the closest points between this object and the query shape.

[ReferenceFrame(ReferenceFrame.World)]
public override sealed bool Distance<T>(in T support, in JQuaternion orientation, in JVector position, out JVector pointA, out JVector pointB, out JVector normal, out float distance) where T : ISupportMappable

Parameters

support T

The query shape.

orientation JQuaternion

The query shape orientation in world space.

position JVector

The query shape position in world space.

pointA JVector

Closest point on the query shape in world space. Undefined when the shapes overlap.

pointB JVector

Closest point on this object in world space. Undefined when the shapes overlap.

normal JVector

Unit direction from the query shape toward this object, or Zero when the shapes overlap. Do not use this to test whether a result was found.

distance float

The separation distance between the shapes. Zero when overlapping.

Returns

bool

true if the shapes are separated; false if they overlap.

Type Parameters

T

The query support-map type.

LocalRayCast(in JVector, in JVector, out JVector, out float)

Performs a local ray cast against the shape, checking if a ray originating from a specified point and traveling in a specified direction intersects with the object. It does not take into account the transformation of the associated rigid body.

[ReferenceFrame(ReferenceFrame.Local)]
public virtual bool LocalRayCast(in JVector origin, in JVector direction, out JVector normal, out float lambda)

Parameters

origin JVector

The starting point of the ray.

direction JVector

The direction of the ray. This vector does not need to be normalized.

normal JVector

When this method returns, contains the surface normal at the point of intersection, if an intersection occurs.

lambda float

When this method returns, contains the scalar value representing the distance along the ray's direction vector from the origin to the intersection point. The hit point can be calculated as: origin + lambda * direction.

Returns

bool

true if the ray intersects with the object; otherwise, false.

RayCast(in JVector, in JVector, out JVector, out float)

Performs a ray cast against this object.

[ReferenceFrame(ReferenceFrame.World)]
public override sealed bool RayCast(in JVector origin, in JVector direction, out JVector normal, out float lambda)

Parameters

origin JVector

The starting point of the ray.

direction JVector

The direction of the ray. Does not need to be normalized.

normal JVector

The surface normal at the intersection point, or Zero if the ray origin is inside the object. Use the return value, not this parameter, to test whether a hit occurred.

lambda float

The distance along the ray to the intersection: hitPoint = origin + lambda * direction. Zero when the ray origin is inside the object.

Returns

bool

true if the ray intersects with the object; otherwise, false. Also returns true when the ray origin is inside the object, with lambda set to zero and normal set to Zero.

Sweep<T>(in T, in JQuaternion, in JVector, in JVector, out JVector, out JVector, out JVector, out float)

Performs a sweep test against this object.

[ReferenceFrame(ReferenceFrame.World)]
public override sealed bool Sweep<T>(in T support, in JQuaternion orientation, in JVector position, in JVector sweep, out JVector pointA, out JVector pointB, out JVector normal, out float lambda) where T : ISupportMappable

Parameters

support T

The query shape.

orientation JQuaternion

The query shape orientation in world space.

position JVector

The query shape position in world space.

sweep JVector

The query shape translation in world space.

pointA JVector

Collision point on the query shape in world space at the sweep origin. Undefined when the shapes already overlap.

pointB JVector

Collision point on this object in world space at the sweep origin. Undefined when the shapes already overlap.

normal JVector

Collision normal in world space, or Zero if the shapes already overlap. Use the return value to determine whether a hit occurred; do not rely on this being non-zero.

lambda float

The time of impact expressed in units of sweep. Zero if the shapes already overlap.

Returns

bool

true if the query shape hits or already overlaps this object; otherwise, false.

Type Parameters

T

The query support-map type.

UpdateWorldBoundingBox(float)

Recomputes the world-space bounding box.

public override sealed void UpdateWorldBoundingBox(float dt = 0)

Parameters

dt float

The timestep for velocity-based expansion. Default is zero.