API Docs for: 0.7.1
Show:

DistanceConstraint Class

Extends Constraint
Defined in: src/constraints/DistanceConstraint.js:8

保持两个物体之间的距离不变的约束。

构造器

DistanceConstraint

(
  • bodyA
  • bodyB
  • [options]
)

Defined in src/constraints/DistanceConstraint.js:8

参数:

  • bodyA Body
  • bodyB Body
  • [options] Object 可选
    • [distance] Number 可选

      两个目标点保持的距离，默认为当前两个刚体之间的距离

    • [localAnchorA] Array 可选

      刚体A 的目标点，在刚体A的范围内定义，默认为[0, 0]

    • [localAnchorB] Array 可选

      刚体B 的目标点，在刚体A的范围内定义，默认为[0, 0]

    • [maxForce=Number.MAX_VALUE] Object 可选

      施加的最大作用力

Example:

// 如果距离没在参数中给出，则使用当前两个刚体之间的距离
        //下例中，刚体之间将被约束与彼此中心有两个单位的距离
        var bodyA = new Body({ mass: 1, position: [-1, 0] });
        var bodyB = new Body({ mass: 1, position: [1, 0] });
        var constraint = new DistanceConstraint(bodyA, bodyB);
        world.addConstraint(constraint);
        
// 自定义设置距离和目标点
        var constraint = new DistanceConstraint(bodyA, bodyB, {
            distance: 1,          // Distance to keep between the points
            localAnchorA: [1, 0], // Point on bodyA
            localAnchorB: [-1, 0] // Point on bodyB
        });
        world.addConstraint(constraint);

Methods

getMaxForce

() Number

Defined in src/constraints/DistanceConstraint.js:260

获取最大作用力

Returns:

Number:

setMaxForce

(
  • maxForce
)

Defined in src/constraints/DistanceConstraint.js:249

设置使用的最大作用力

参数:

  • maxForce Number

setRelaxation

(
  • relaxation
)

Inherited from Constraint: src/constraints/Constraint.js:123

为这个约束设置弛豫度

参数:

  • relaxation Number

setStiffness

(
  • stiffness
)

Inherited from Constraint: src/constraints/Constraint.js:109

为这个约束设置刚度

参数:

  • stiffness Number

update

()

Inherited from Constraint but overwritten in src/constraints/DistanceConstraint.js:180

在求解前更新约束方程，任何刚体改变位置时完成

Properties

bodyA

Body

Inherited from Constraint: src/constraints/Constraint.js:38

将要参与约束的第一个刚体.

bodyB

Body

Inherited from Constraint: src/constraints/Constraint.js:45

将要参与约束的第二个刚体.

collideConnected

Boolean

Inherited from Constraint: src/constraints/Constraint.js:52

如果你想将连接的刚体碰撞，将其设置为true

Default: true

distance

Number

Defined in src/constraints/DistanceConstraint.js:65

需要保持的距离

equations

Array

Inherited from Constraint: src/constraints/Constraint.js:30

用于求解约束的方程

localAnchorA

Array

Defined in src/constraints/DistanceConstraint.js:48

刚体A 中的目标点

localAnchorB

Array

Defined in src/constraints/DistanceConstraint.js:55

刚体B 中的目标点

lowerLimit

Number

Defined in src/constraints/DistanceConstraint.js:165

约束下限。

lowerLimitEnabled

Boolean

Defined in src/constraints/DistanceConstraint.js:159

是否启用约束下限

maxForce

Number

Defined in src/constraints/DistanceConstraint.js:101

施加的最大作用力

position

Number

Defined in src/constraints/DistanceConstraint.js:171

当前约束位置，等于当前目标点在世界中的距离

upperLimit

Number

Defined in src/constraints/DistanceConstraint.js:153

约束上限

upperLimitEnabled

Boolean

Defined in src/constraints/DistanceConstraint.js:147

是否启用约束上限