BulletSim/ScriptFunctions

From OpenSimulator

Jump to: navigation, search

OpenSimulator => BulletSim => Script Functions

BulletSim Script Functions

Contents

Physics engines have an extension interface enabling extended functions. BulletSim adds script functions which call the extension interface and add control of physics parameters and new functionality.

This feature requires the mod_invoke feature to be enabled on the region the script is running on.

Information

string physGetEngineType()

string physGetPhysicsParameter(string parameterName)

void physSetPhysicsParameter(string parameterName, string value)

Physics Parameters

void physSetLinksetType(integer linksetTypeCode)

Value Constant Description
0 PHYS_LINKSET_TYPE_CONSTRAINT Links are created with physics constraint objects. Used for flexible objects. Not a good default as it uses more CPU.
1 PHYS_LINKSET_TYPE_COMPOUND Linkset is constructed as a compound object made up of the shapes of all the children. The most efficient linkset implementation and the default.
2 PHYS_LINKSET_TYPE_MANUAL NOT IMPLEMENTED. Linkset is implemented by CPU code that moves each of the object in the linkset independently.

void physSetCenterOfMass(vector centerOfMassDisplacement)

Value Constant Description
1234 PHYS_LINK_TYPE_FIXED Link is fixed and unmovable. Default. Implemented as a 6 degree-of-freedom constraint with no motion in either the linear or angular directions.
4 PHYS_LINK_TYPE_HINGE
9 PHYS_LINK_TYPE_SPRING
6 PHYS_LINK_TYPE_6DOF
7 PHYS_LINK_TYPE_SLIDER


Extended Linksets

void physChangeLinkParams(integer linkNum, list parms)

Flag Description Usage
PHYS_PARAM_LINK_TYPE
PHYS_PARAM_FRAMEINA_LOC
PHYS_PARAM_FRAMEINA_ROT
PHYS_PARAM_FRAMEINB_LOC
PHYS_PARAM_FRAMEINA_ROT
PHYS_PARAM_LINEAR_LIMIT_LOW
PHYS_PARAM_LINEAR_LIMIT_HIGH
PHYS_PARAM_ANGULAR_LIMIT_LOW
PHYS_PARAM_ANGULAR_LIMIT_HIGH
PHYS_PARAM_USE_FRAME_OFFSET
PHYS_PARAM_ENABLE_TRANSMOTOR
PHYS_PARAM_TRANSMOTOR_MAXVEL
PHYS_PARAM_USE_LINEAR_FRAMEA
PHYS_PARAM_TRANSMOTOR_MAXFORCE
PHYS_PARAM_CFM
PHYS_PARAM_ERP
PHYS_PARAM_SOLVER_ITERATIONS
PHYS_PARAM_SPRING_AXIS_ENABLE [PHYS_PARAM_SPRING_AXIS_ENABLE, int axisCode, bool flag]
PHYS_PARAM_SPRING_DAMPING [PHYS_PARAM_SPRING_DAMPING, int axisCode, float damping]
PHYS_PARAM_SPRING_STIFFNESS [PHYS_PARAM_SPRING_STIFFNESS, int axisCode, float stiffness]

Axis Specification

Some of the parameters specify a constraint axis. The axis values mean:

axisCode constant meaning
0 PHYS_AXIS_LINEAR_X X linear axis
1 PHYS_AXIS_LINEAR_Y Y linear axis
2 PHYS_AXIS_LINEAR_Z Z linear axis
3 PHYS_AXIS_ANGULAR_X X angular axis
4 PHYS_AXIS_ANGULAR_Y Y angular axis
5 PHYS_AXIS_ANGULAR_Z Z angular axis
-1 PHYS_AXIS_ALL (-1) make changes to all axis
-2 PHYS_AXIS_LINEAR_ALL all linear axis (X, Y, Z)
-3 PHYS_AXIS_ANGULAR_ALL all angular axis (X, Y, Z)
Personal tools
General
About This Wiki