Function Physics_CreateJoint

engine/gamesys/src/gamesys/scripts/script_physics.cpp:695–731

create a physics joint * * Create a physics joint between two collision object components. * * Note: Currently only supported in 2D physics. * * @name physics.create_joint * @param joint_type [type:number] the joint type * @param collisionobject_a [type:string|hash|url] first collision object * @param joint_id [type:string|hash] id of the joint * @

     *
     */
    static int Physics_CreateJoint(lua_State* L)
    {
        DM_LUA_STACK_CHECK(L, 0);

        dmPhysics::JointType type = (dmPhysics::JointType)luaL_checkinteger(L, 1);
        if (type >= dmPhysics::JOINT_TYPE_COUNT)
        {
            return DM_LUA_ERROR("unknown joint type: %d", type);
        }

        dmhash_t joint_id = dmScript::CheckHashOrString(L, 3);
        dmVMath::Point3 pos_a = dmVMath::Point3(*dmScript::CheckVector3(L, 4));
        dmVMath::Point3 pos_b = dmVMath::Point3(*dmScript::CheckVector3(L, 6));

        dmGameObject::HCollection collection = dmGameObject::GetCollection(CheckGoInstance(L));

        CollisionComponent* comp_a = 0x0;
        CollisionWorld* comp_world_a = 0x0;
        GetCollisionObject(L, 2, collection, &comp_a, &comp_world_a);
        CollisionComponent* comp_b = 0x0;
        CollisionWorld* comp_world_b = 0x0;
        GetCollisionObject(L, 5, collection, &comp_b, &comp_world_b);

        if (comp_world_a != comp_world_b) {
            return DM_LUA_ERROR("joints can only be connected to collision objects within the same physics world");
        }

        dmPhysics::ConnectJointParams params(type);
        UnpackConnectJointParams(L, type, 7, params);
        dmPhysics::JointResult r = dmGameSystem::CreateJoint(comp_world_a, comp_a, joint_id, pos_a, comp_b, pos_b, type, params);
        if (r != dmPhysics::RESULT_OK) {
            return DM_LUA_ERROR("could not create joint: %s (%d)", PhysicsResultString[r], r);
        }

        return 0;

    }

    /*# destroy a physics joint
     *