Difference between revisions of "B2.RevoluteJoint"

From GiderosMobile
Line 2: Line 2:
 
'''Supported platforms:''' android, ios, mac, pc<br/>
 
'''Supported platforms:''' android, ios, mac, pc<br/>
 
'''Available since:''' Gideros 2011.6<br/>
 
'''Available since:''' Gideros 2011.6<br/>
=== Description ===
+
=== <translate>Description</translate> ===
 
<translate><br />
 
<translate><br />
 
A revolute joint constrains two bodies to share a common point while they are free to rotate about the point. The relative rotation about the shared point is the joint angle. You can limit the relative rotation with a joint limit that specifies a lower and upper angle. You can use a motor to drive the relative rotation about the shared point. A maximum motor torque is provided so that infinite forces are not generated. <br />
 
A revolute joint constrains two bodies to share a common point while they are free to rotate about the point. The relative rotation about the shared point is the joint angle. You can limit the relative rotation with a joint limit that specifies a lower and upper angle. You can use a motor to drive the relative rotation about the shared point. A maximum motor torque is provided so that infinite forces are not generated. <br />
 
<br /></translate>
 
<br /></translate>
=== Examples ===
+
=== <translate>Examples</translate> ===
 
'''Revolute joint'''<br/>
 
'''Revolute joint'''<br/>
 
<source lang="lua">--create empty box2d body for joint
 
<source lang="lua">--create empty box2d body for joint
Line 19: Line 19:
 
{|-
 
{|-
 
| style="width: 50%; vertical-align:top;"|
 
| style="width: 50%; vertical-align:top;"|
=== Methods ===
+
=== <translate>Methods</translate> ===
 
[[Special:MyLanguage/b2.RevoluteJoint:enableLimit|b2.RevoluteJoint:enableLimit]] ''<translate>enables or disables the joint limit</translate>''<br/>
 
[[Special:MyLanguage/b2.RevoluteJoint:enableLimit|b2.RevoluteJoint:enableLimit]] ''<translate>enables or disables the joint limit</translate>''<br/>
 
[[Special:MyLanguage/b2.RevoluteJoint:enableMotor|b2.RevoluteJoint:enableMotor]] ''<translate>enables or disables the joint motor</translate>''<br/>
 
[[Special:MyLanguage/b2.RevoluteJoint:enableMotor|b2.RevoluteJoint:enableMotor]] ''<translate>enables or disables the joint motor</translate>''<br/>
Line 33: Line 33:
 
[[Special:MyLanguage/b2.RevoluteJoint:setMotorSpeed|b2.RevoluteJoint:setMotorSpeed]] ''<translate>sets the motor speed in radians per second</translate>''<br/>
 
[[Special:MyLanguage/b2.RevoluteJoint:setMotorSpeed|b2.RevoluteJoint:setMotorSpeed]] ''<translate>sets the motor speed in radians per second</translate>''<br/>
 
| style="width: 50%; vertical-align:top;"|
 
| style="width: 50%; vertical-align:top;"|
=== Events ===
+
=== <translate>Events</translate> ===
=== Constants ===
+
=== <translate>Constants</translate> ===
 
|}
 
|}

Revision as of 08:28, 24 August 2018

Supported platforms: android, ios, mac, pc
Available since: Gideros 2011.6

Description


A revolute joint constrains two bodies to share a common point while they are free to rotate about the point. The relative rotation about the shared point is the joint angle. You can limit the relative rotation with a joint limit that specifies a lower and upper angle. You can use a motor to drive the relative rotation about the shared point. A maximum motor torque is provided so that infinite forces are not generated.

Examples

Revolute joint

--create empty box2d body for joint
local ground = world:createBody({})
ground:setPosition(300, 480)

local jointDef = b2.createRevoluteJointDef(body, ground, 300, 300)
local revoluteJoint = world:createJoint(jointDef)
--will not let ball spin for ever
revoluteJoint:setMaxMotorTorque(1)
revoluteJoint:enableMotor(true)

Methods

b2.RevoluteJoint:enableLimit enables or disables the joint limit
b2.RevoluteJoint:enableMotor enables or disables the joint motor
b2.RevoluteJoint:getJointAngle returns the current joint angle in radians
b2.RevoluteJoint:getJointSpeed returns the current joint angle speed in radians per second
b2.RevoluteJoint:getLimits returns the lower and upper joint limit in radians
b2.RevoluteJoint:getMotorSpeed returns the motor speed in radians per second
b2.RevoluteJoint:getMotorTorque returns the current motor torque given the inverse time step
b2.RevoluteJoint:isLimitEnabled is the joint limit enabled?
b2.RevoluteJoint:isMotorEnabled is the joint motor enabled?
b2.RevoluteJoint:setLimits sets the joint limits in radians
b2.RevoluteJoint:setMaxMotorTorque sets the maximum motor torque in N*m
b2.RevoluteJoint:setMotorSpeed sets the motor speed in radians per second

Events

Constants