orx-force-2d/org.openrndr.extra.force2d/Body

Body

class Body(val nodes: List<Node>, val boundaryNodes: List<Int> = emptyList(), val links: List<Link> = emptyList(), val boundaryLinks: List<Int> = emptyList(), val triangles: List<Triangle> = emptyList(), var inverseBodyMass: Double = 1.0, var static: Boolean = false)(source)

Represents a physical body in a simulation composed of nodes, links, and triangles.

A Body serves as the central structure in simulations, encapsulating physical properties, relationships, and behaviors of its constituent parts. It supports initialization, integration of forces, resolution of constraints, and updates to its boundaries. The body can either be static or dynamic, depending on the static property.

Constructors

Body

constructor(nodes: List<Node>, boundaryNodes: List<Int> = emptyList(), links: List<Link> = emptyList(), boundaryLinks: List<Int> = emptyList(), triangles: List<Triangle> = emptyList(), inverseBodyMass: Double = 1.0, static: Boolean = false)

Properties

boundaryLinks

val boundaryLinks: List<Int>

the list of indices referring to links considered as boundary links.

boundaryNodes

val boundaryNodes: List<Int>

the list of indices referring to nodes considered as boundary nodes.

bounds

var bounds: Rectangle

the bounding rectangle that encapsulates the body's nodes, updated automatically.

constraints

var constraints: MutableList<Constraint>

the list of Constraints influencing the behavior and interaction of the body.

forces

var forces: MutableList<Force>

the list of Forces acting on the body in the simulation.

inverseBodyMass

var inverseBodyMass: Double

the reciprocal of the total mass of the body, used in weight calculations.

links

val links: List<Link>

the list of Links that define relationships or connections between nodes.

nodes

val nodes: List<Node>

the list of Nodes that make up the physical body.

static

var static: Boolean

a flag indicating whether the body is static (non-movable) or dynamic.

triangles

val triangles: List<Triangle>

the list of Triangles used for structural and mass-related calculations.

Functions

bodyAreaConstraint

fun Body.bodyAreaConstraint(configure: BodyAreaConstraint.() -> Unit = {})

Adds a body area constraint to the body, ensuring that its area remains close to a target rest area during simulation. The constraint includes compliance and uses iterative solving to maintain this condition.

boundaryNodeRelaxForce

fun Body.boundaryNodeRelaxForce(configure: BoundaryNodeRelaxForce.() -> Unit): Boolean

Adds a BoundaryNodeRelaxForce to the Body's list of forces. This force acts on the boundary nodes of the body to relax their positions by adjusting their velocities based on neighboring node positions.

gravity

fun Body.gravity(configure: GravityForce.() -> Unit): Boolean

Adds a gravitational force to the body and allows configuring its properties.

fun Body.gravity(gravity: GravityForce): Boolean

Applies a gravitational force to the body by adding it to the list of forces acting on the body.

initialize

suspend fun initialize()

initializeWeights

fun initializeWeights()

linkLengthConstraint

fun Body.linkLengthConstraint(configure: LinkLengthConstraint.() -> Unit = {})

manyNodeForce

fun Body.manyNodeForce(configure: ManyNodeForce.() -> Unit)

nodeCircleConstraint

fun Body.nodeCircleConstraint(configure: NodeCircleConstraint.() -> Unit)

Applies a circular constraint to the nodes of this Body.

nodeCollisionConstraint

fun Body.nodeCollisionConstraint(configure: NodeCollisionConstraint.() -> Unit): Boolean

Adds a node collision constraint to the body, configuring it using the provided lambda.

nodeContourConstraint

fun Body.nodeContourConstraint(configure: NodeContourConstraint.() -> Unit)

Applies a node contour constraint to the body and configures it using the provided configuration block.

nodeRepulseForce

fun Body.nodeRepulseForce(configure: NodeRepulseForce.() -> Unit): Boolean

nodeRepulseForceBVH

fun Body.nodeRepulseForceBVH(configure: NodeRepulseForceBVH.() -> Unit): Boolean

postsolve

fun postsolve(dt: Double)

presolve

suspend fun presolve(dt: Double)

rectangularBoundsConstraint

fun Body.rectangularBoundsConstraint(configure: RectangularBoundsConstraint.() -> Unit = {}): Boolean

Adds a rectangular boundary constraint to the body, ensuring that its nodes remain confined within a specified rectangular region during the simulation.

solve

suspend fun solve(dt: Double, alpha: Double)

triangleAreaConstraint

fun Body.triangleAreaConstraint(configure: TriangleAreaConstraint.() -> Unit = {})

Adds a triangle area constraint to the body, ensuring that the areas of triangles in the body remain consistent with their initial (rest) areas during simulation.

updateBounds

fun updateBounds()