Difference between revisions of "B2.RevoluteJoint"

From GiderosMobile
m (Text replacement - "</source" to "</syntaxhighlight")
 
(16 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
'''Supported platforms:''' android, ios, mac, pc<br/>
+
<languages />
'''Available since:''' Gideros 2011.6<br/>
+
<!-- GIDEROSOBJ:b2.RevoluteJoint -->
=== Description ===
+
'''<translate>Supported platforms</translate>:''' [[File:Platform android.png]][[File:Platform ios.png]][[File:Platform mac.png]][[File:Platform pc.png]][[File:Platform html5.png]][[File:Platform winrt.png]][[File:Platform win32.png]]<br/>
<br />
+
'''<translate>Available since</translate>:''' Gideros 2011.6<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 />
+
'''<translate>Inherits from</translate>:''' [[Special:MyLanguage/b2.Joint|b2.Joint]]<br/>
<br />{|-
+
 
| style="width: 50%;"|
+
=== <translate>Description</translate> ===
=== Methods ===
+
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.
[[b2.RevoluteJoint:enableLimit]] - enables or disables the joint limit<br/>
+
 
[[b2.RevoluteJoint:enableMotor]] - enables or disables the joint motor<br/>
+
=== <translate>Examples</translate> ===
[[b2.RevoluteJoint:getJointAngle]] - returns the current joint angle in radians<br/>
+
'''Revolute joint'''
[[b2.RevoluteJoint:getJointSpeed]] - returns the current joint angle speed in radians per second<br/>
+
<syntaxhighlight lang="lua">
[[b2.RevoluteJoint:getLimits]] - returns the lower and upper joint limit in radians<br/>
+
--create empty box2d body for joint
[[b2.RevoluteJoint:getMotorSpeed]] - returns the motor speed in radians per second<br/>
+
local ground = world:createBody({})
[[b2.RevoluteJoint:getMotorTorque]] - returns the current motor torque given the inverse time step<br/>
+
ground:setPosition(300, 480)
[[b2.RevoluteJoint:isLimitEnabled]] - is the joint limit enabled?<br/>
+
 
[[b2.RevoluteJoint:isMotorEnabled]] - is the joint motor enabled?<br/>
+
local jointDef = b2.createRevoluteJointDef(body, ground, 300, 300)
[[b2.RevoluteJoint:setLimits]] - sets the joint limits in radians<br/>
+
local revoluteJoint = world:createJoint(jointDef)
[[b2.RevoluteJoint:setMaxMotorTorque]] - sets the maximum motor torque in N*m<br/>
+
--will not let ball spin for ever
[[b2.RevoluteJoint:setMotorSpeed]] - sets the motor speed in radians per second<br/>
+
revoluteJoint:setMaxMotorTorque(1)
| style="width: 50%;"|
+
revoluteJoint:enableMotor(true)
=== Events ===
+
</syntaxhighlight>
=== Constants ===
+
 
 +
{|-
 +
| style="width: 50%; vertical-align:top;"|
 +
=== <translate>Methods</translate> ===
 +
[[Special:MyLanguage/b2.RevoluteJoint:enableLimit|b2.RevoluteJoint:enableLimit]] ''<translate>enables or disables the joint limit</translate>''<br/><!-- GIDEROSMTD:b2.RevoluteJoint:enableLimit(flag) enables or disables the joint limit -->
 +
[[Special:MyLanguage/b2.RevoluteJoint:enableMotor|b2.RevoluteJoint:enableMotor]] ''<translate>enables or disables the joint motor</translate>''<br/><!-- GIDEROSMTD:b2.RevoluteJoint:enableMotor(flag) enables or disables the joint motor -->
 +
[[Special:MyLanguage/b2.RevoluteJoint:getJointAngle|b2.RevoluteJoint:getJointAngle]] ''<translate>returns the current joint angle in radians</translate>''<br/><!-- GIDEROSMTD:b2.RevoluteJoint:getJointAngle() returns the current joint angle in radians -->
 +
[[Special:MyLanguage/b2.RevoluteJoint:getJointSpeed|b2.RevoluteJoint:getJointSpeed]] ''<translate>returns the current joint angle speed in radians per second</translate>''<br/><!-- GIDEROSMTD:b2.RevoluteJoint:getJointSpeed() returns the current joint angle speed in radians per second -->
 +
[[Special:MyLanguage/b2.RevoluteJoint:getLimits|b2.RevoluteJoint:getLimits]] ''<translate>returns the lower and upper joint limit in radians</translate>''<br/><!-- GIDEROSMTD:b2.RevoluteJoint:getLimits() returns the lower and upper joint limit in radians -->
 +
[[Special:MyLanguage/b2.RevoluteJoint:getMotorSpeed|b2.RevoluteJoint:getMotorSpeed]] ''<translate>returns the motor speed in radians per second</translate>''<br/><!-- GIDEROSMTD:b2.RevoluteJoint:getMotorSpeed() returns the motor speed in radians per second -->
 +
[[Special:MyLanguage/b2.RevoluteJoint:getMotorTorque|b2.RevoluteJoint:getMotorTorque]] ''<translate>returns the current motor torque given the inverse time step</translate>''<br/><!-- GIDEROSMTD:b2.RevoluteJoint:getMotorTorque(inv_dt) returns the current motor torque given the inverse time step -->
 +
[[Special:MyLanguage/b2.RevoluteJoint:isLimitEnabled|b2.RevoluteJoint:isLimitEnabled]] ''<translate>is the joint limit enabled?</translate>''<br/><!-- GIDEROSMTD:b2.RevoluteJoint:isLimitEnabled() is the joint limit enabled? -->
 +
[[Special:MyLanguage/b2.RevoluteJoint:isMotorEnabled|b2.RevoluteJoint:isMotorEnabled]] ''<translate>is the joint motor enabled?</translate>''<br/><!-- GIDEROSMTD:b2.RevoluteJoint:isMotorEnabled() is the joint motor enabled? -->
 +
[[Special:MyLanguage/b2.RevoluteJoint:setLimits|b2.RevoluteJoint:setLimits]] ''<translate>sets the joint limits in radians</translate>''<br/><!-- GIDEROSMTD:b2.RevoluteJoint:setLimits(lower,upper) sets the joint limits in radians -->
 +
[[Special:MyLanguage/b2.RevoluteJoint:setMaxMotorTorque|b2.RevoluteJoint:setMaxMotorTorque]] ''<translate>sets the maximum motor torque in N*m</translate>''<br/><!-- GIDEROSMTD:b2.RevoluteJoint:setMaxMotorTorque(torque) sets the maximum motor torque in N*m -->
 +
[[Special:MyLanguage/b2.RevoluteJoint:setMotorSpeed|b2.RevoluteJoint:setMotorSpeed]] ''<translate>sets the motor speed in radians per second</translate>''<br/><!-- GIDEROSMTD:b2.RevoluteJoint:setMotorSpeed(speed) sets the motor speed in radians per second -->
 +
 
 +
| style="width: 50%; vertical-align:top;"|
 +
=== <translate>Events</translate> ===
 +
=== <translate>Constants</translate> ===
 
|}
 
|}
 +
 +
----
 +
*'''[[B2.Joint]]'''
 +
*'''[[LiquidFun]]'''

Latest revision as of 16:51, 12 July 2023


Supported platforms: Platform android.pngPlatform ios.pngPlatform mac.pngPlatform pc.pngPlatform html5.pngPlatform winrt.pngPlatform win32.png
Available since: Gideros 2011.6
Inherits from: b2.Joint

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