PlayRho  2.0.0
An interactive physics engine & library.
RopeJoint.cpp

This is the googletest based unit testing file for the interfaces to playrho::d2::RopeJointConf.

/*
* Copyright (c) 2023 Louis Langholtz https://github.com/louis-langholtz/PlayRho
*
* This software is provided 'as-is', without any express or implied
* warranty. In no event will the authors be held liable for any damages
* arising from the use of this software.
*
* Permission is granted to anyone to use this software for any purpose,
* including commercial applications, and to alter it and redistribute it
* freely, subject to the following restrictions:
*
* 1. The origin of this software must not be misrepresented; you must not
* claim that you wrote the original software. If you use this software
* in a product, an acknowledgment in the product documentation would be
* appreciated but is not required.
* 2. Altered source versions must be plainly marked as such, and must not be
* misrepresented as being the original software.
* 3. This notice may not be removed or altered from any source distribution.
*/
#include "UnitTests.hpp"
#include <cstring> // for std::memcmp
using namespace playrho;
using namespace playrho::d2;
TEST(RopeJointConf, DefaultConstruction)
{
RopeJointConf def{};
EXPECT_EQ(def.bodyA, InvalidBodyID);
EXPECT_EQ(def.bodyB, InvalidBodyID);
EXPECT_EQ(def.collideConnected, false);
EXPECT_EQ(def.localAnchorA, Length2(-1_m, 0_m));
EXPECT_EQ(def.localAnchorB, Length2(+1_m, 0_m));
EXPECT_EQ(def.maxLength, 0_m);
}
TEST(RopeJointConf, Construction)
{
World world;
const auto b0 = CreateBody(world);
const auto b1 = CreateBody(world);
auto def = RopeJointConf{b0, b1};
Joint joint{def};
EXPECT_EQ(GetType(joint), GetTypeID<RopeJointConf>());
EXPECT_EQ(GetBodyA(joint), def.bodyA);
EXPECT_EQ(GetBodyB(joint), def.bodyB);
EXPECT_EQ(GetCollideConnected(joint), def.collideConnected);
EXPECT_EQ(GetLinearReaction(joint), Momentum2{});
EXPECT_EQ(GetAngularReaction(joint), AngularMomentum{0});
const auto id = CreateJoint(world, joint);
EXPECT_EQ(GetLocalAnchorA(joint), def.localAnchorA);
EXPECT_EQ(GetLocalAnchorB(joint), def.localAnchorB);
EXPECT_EQ(GetAnchorA(world, id), Length2(-1_m, 0_m));
EXPECT_EQ(GetAnchorB(world, id), Length2(+1_m, 0_m));
const auto conf = TypeCast<RopeJointConf>(GetJoint(world, id));
EXPECT_EQ(GetMaxLength(conf), def.maxLength);
}
TEST(RopeJointConf, GetRopeJointConfThrows)
{
EXPECT_THROW(GetRopeJointConf(Joint{}), std::bad_cast);
}
TEST(RopeJointConf, GetRopeJointConf)
{
auto world = World{};
const auto bodyA = CreateBody(world);
const auto bodyB = CreateBody(world);
auto def = RopeJointConf{bodyA, bodyB};
const auto localAnchorA = Length2{-2_m, 0_m};
const auto localAnchorB = Length2{+2_m, 0_m};
def.localAnchorA = localAnchorA;
def.localAnchorB = localAnchorB;
const auto joint = Joint{def};
ASSERT_EQ(GetType(joint), GetTypeID<RopeJointConf>());
ASSERT_EQ(GetBodyA(joint), def.bodyA);
ASSERT_EQ(GetBodyB(joint), def.bodyB);
ASSERT_EQ(GetCollideConnected(joint), def.collideConnected);
ASSERT_EQ(GetLocalAnchorA(joint), def.localAnchorA);
ASSERT_EQ(GetLocalAnchorB(joint), def.localAnchorB);
const auto conf = TypeCast<RopeJointConf>(joint);
ASSERT_EQ(GetMaxLength(conf), def.maxLength);
const auto cdef = GetRopeJointConf(joint);
EXPECT_EQ(cdef.bodyA, bodyA);
EXPECT_EQ(cdef.bodyB, bodyB);
EXPECT_EQ(cdef.collideConnected, false);
EXPECT_EQ(cdef.localAnchorA, localAnchorA);
EXPECT_EQ(cdef.localAnchorB, localAnchorB);
EXPECT_EQ(cdef.maxLength, 0_m);
}
TEST(RopeJointConf, WithDynamicCircles)
{
auto world = World{};
const auto p1 = Length2{-1_m, 0_m};
const auto p2 = Length2{+1_m, 0_m};
const auto b1 = CreateBody(world, BodyConf{}.Use(BodyType::Dynamic).UseLocation(p1));
const auto b2 = CreateBody(world, BodyConf{}.Use(BodyType::Dynamic).UseLocation(p2));
const auto shapeId = CreateShape(world, DiskShapeConf{}.UseRadius(0.2_m));
Attach(world, b1, shapeId);
Attach(world, b2, shapeId);
const auto jd = RopeJointConf{b1, b2};
ASSERT_NE(CreateJoint(world, jd), InvalidJointID);
auto stepConf = StepConf{};
stepConf.doWarmStart = true;
Step(world, stepConf);
EXPECT_GT(GetX(GetLocation(world, b1)), -1_m);
EXPECT_EQ(GetY(GetLocation(world, b1)), 0_m);
EXPECT_LT(GetX(GetLocation(world, b2)), +1_m);
EXPECT_EQ(GetY(GetLocation(world, b2)), 0_m);
EXPECT_EQ(GetAngle(world, b1), 0_deg);
EXPECT_EQ(GetAngle(world, b2), 0_deg);
stepConf.doWarmStart = false;
Step(world, stepConf);
EXPECT_GT(GetX(GetLocation(world, b1)), -1_m);
EXPECT_EQ(GetY(GetLocation(world, b1)), 0_m);
EXPECT_LT(GetX(GetLocation(world, b2)), +1_m);
EXPECT_EQ(GetY(GetLocation(world, b2)), 0_m);
EXPECT_EQ(GetAngle(world, b1), 0_deg);
EXPECT_EQ(GetAngle(world, b2), 0_deg);
stepConf.doWarmStart = true;
stepConf.linearSlop = 10_m;
Step(world, stepConf);
EXPECT_GT(GetX(GetLocation(world, b1)), -1_m);
EXPECT_EQ(GetY(GetLocation(world, b1)), 0_m);
EXPECT_LT(GetX(GetLocation(world, b2)), +1_m);
EXPECT_EQ(GetY(GetLocation(world, b2)), 0_m);
EXPECT_EQ(GetAngle(world, b1), 0_deg);
EXPECT_EQ(GetAngle(world, b2), 0_deg);
}
TEST(RopeJointConf, ShiftOrigin)
{
auto jd = RopeJointConf{BodyID(0u), BodyID(1u)};
auto copy = RopeJointConf{};
// Do copy = jd without missing padding so memcmp works
std::memcpy(&copy, &jd, sizeof(RopeJointConf));
EXPECT_FALSE(ShiftOrigin(jd, Length2{0_m, 0_m}));
// Use memcmp since easier than writing full == suport pre C++20.
EXPECT_TRUE(std::memcmp(&jd, &copy, sizeof(RopeJointConf)) == 0);
}
TEST(RopeJointConf, EqualsOperator)
{
EXPECT_TRUE(RopeJointConf() == RopeJointConf());
{
auto conf = RopeJointConf{};
conf.localAnchorA = Length2{1.2_m, -3_m};
EXPECT_TRUE(conf == conf);
EXPECT_FALSE(RopeJointConf() == conf);
}
{
auto conf = RopeJointConf{};
conf.localAnchorB = Length2{1.2_m, -3_m};
EXPECT_TRUE(conf == conf);
EXPECT_FALSE(RopeJointConf() == conf);
}
{
auto conf = RopeJointConf{};
conf.maxLength = 12_m;
EXPECT_TRUE(conf == conf);
EXPECT_FALSE(RopeJointConf() == conf);
}
// TODO: test remaining fields.
}
TEST(RopeJointConf, NotEqualsOperator)
{
EXPECT_FALSE(RopeJointConf() != RopeJointConf());
{
auto conf = RopeJointConf{};
conf.mass = 13_kg;
EXPECT_FALSE(conf != conf);
EXPECT_TRUE(RopeJointConf() != conf);
}
// TODO: test remaining fields.
}
TEST(RopeJointConf, GetName)
{
EXPECT_STREQ(GetName(GetTypeID<RopeJointConf>()), "d2::RopeJointConf");
}
TEST(RopeJointConf, InitVelocity)
{
auto conf = RopeJointConf{};
std::vector<BodyConstraint> bodies;
EXPECT_NO_THROW(InitVelocity(conf, bodies, StepConf{}, ConstraintSolverConf{}));
conf.bodyA = BodyID(0);
conf.bodyB = BodyID(0);
EXPECT_THROW(InitVelocity(conf, bodies, StepConf{}, ConstraintSolverConf{}), std::out_of_range);
const auto posA = Position{Length2{-5_m, 0_m}, 0_deg};
bodies.push_back(BodyConstraint{Real(1) / 4_kg, InvRotInertia{}, Length2{}, posA, Velocity{}});
EXPECT_NO_THROW(InitVelocity(conf, bodies, StepConf{}, ConstraintSolverConf{}));
}
TEST(RopeJointConf, SolveVelocity)
{
auto conf = RopeJointConf{};
std::vector<BodyConstraint> bodies;
auto result = false;
EXPECT_NO_THROW(result = SolveVelocity(conf, bodies, StepConf{}));
EXPECT_TRUE(result);
conf.bodyA = BodyID(0);
conf.bodyB = BodyID(0);
EXPECT_THROW(SolveVelocity(conf, bodies, StepConf{}), std::out_of_range);
const auto posA = Position{Length2{-5_m, 0_m}, 0_deg};
bodies.push_back(BodyConstraint{Real(1) / 4_kg, InvRotInertia{}, Length2{}, posA, Velocity{}});
EXPECT_NO_THROW(result = SolveVelocity(conf, bodies, StepConf{}));
}
TEST(RopeJointConf, SolvePosition)
{
auto conf = RopeJointConf{};
std::vector<BodyConstraint> bodies;
auto result = false;
EXPECT_NO_THROW(result = SolvePosition(conf, bodies, ConstraintSolverConf{}));
EXPECT_TRUE(result);
conf.bodyA = BodyID(0);
conf.bodyB = BodyID(0);
EXPECT_THROW(SolvePosition(conf, bodies, ConstraintSolverConf{}), std::out_of_range);
const auto posA = Position{Length2{-5_m, 0_m}, 0_deg};
bodies.push_back(BodyConstraint{Real(1) / 4_kg, InvRotInertia{}, Length2{}, posA, Velocity{}});
EXPECT_NO_THROW(result = SolvePosition(conf, bodies, ConstraintSolverConf{}));
}
Declarations of BodyConf class & free functions associated with it.
Definition of the BodyConstraint class and closely related code.
Definition of the ConstraintSolverConf class and closely related code.
Definition of the DiskShapeConf class and closely related code.
Definition of the Joint class and closely related code.
Definition of the RopeJointConf class and closely related code.
Declarations of the StepConf class, and free functions associated with it.
Declarations of free functions of World for bodies identified by BodyID.
Declarations of free functions of World for joints identified by JointID.
Declarations of free functions of World for unidentified information.
Declarations of free functions of World for shapes identified by ShapeID.
Definitions of the World class and closely related code.
detail::angular_momentum AngularMomentum
Angular momentum quantity.
Definition: Units.hpp:390
detail::inverse_moment_of_inertia InvRotInertia
Inverse rotational inertia quantity.
Definition: Units.hpp:368
Definition: AABB.hpp:48
bool SolveVelocity(DistanceJointConf &object, const Span< BodyConstraint > &bodies, const StepConf &step)
Solves velocity constraint.
Definition: DistanceJointConf.cpp:169
constexpr auto GetY(const UnitVec &value) -> decltype(get< 1 >(value))
Gets the "Y" element of the given value - i.e. the second element.
Definition: UnitVec.hpp:499
constexpr Momentum2 GetLinearReaction(const DistanceJointConf &object) noexcept
Gets the current linear reaction for the given configuration.
Definition: DistanceJointConf.hpp:175
Length2 GetLocalAnchorB(const GearJointConf &conf)
Gets the local anchor B property of the given joint.
Definition: GearJointConf.cpp:510
Angle GetAngle(const Body &body) noexcept
Gets the body's angle.
Definition: Body.cpp:280
BodyID CreateBody(AabbTreeWorld &world, Body body=Body{})
Creates a rigid body that's a copy of the given one.
Definition: AabbTreeWorld.cpp:1019
BodyID GetBodyB(const Joint &object) noexcept
Gets the second body attached to this joint.
Definition: Joint.hpp:295
BodyType GetType(const Body &body) noexcept
Gets the type of this body.
Definition: Body.hpp:748
void ShiftOrigin(AabbTreeWorld &world, const Length2 &newOrigin)
Shifts the world origin.
Definition: AabbTreeWorld.cpp:2221
bool SolvePosition(const DistanceJointConf &object, const Span< BodyConstraint > &bodies, const ConstraintSolverConf &conf)
Solves the position constraint.
Definition: DistanceJointConf.cpp:203
RopeJointConf GetRopeJointConf(const Joint &joint)
Gets the definition data for the given joint.
Definition: RopeJointConf.cpp:46
ShapeID CreateShape(AabbTreeWorld &world, Shape def)
Creates an identifiable copy of the given shape within this world.
Definition: AabbTreeWorld.cpp:1234
const Joint & GetJoint(const AabbTreeWorld &world, JointID id)
Gets the identified joint.
Definition: AabbTreeWorld.cpp:2855
BodyID GetBodyA(const Joint &object) noexcept
Gets the first body attached to this joint.
Definition: Joint.hpp:290
void Attach(AabbTreeWorld &world, BodyID id, ShapeID shapeID)
Associates a validly identified shape with the validly identified body.
Definition: AabbTreeWorld.cpp:2896
Length2 GetLocation(const Body &body) noexcept
Gets the body's origin location.
Definition: Body.hpp:930
LimitState GetLimitState(const Joint &object)
Definition: Joint.cpp:634
Length2 GetAnchorB(const World &world, JointID id)
Definition: WorldJoint.cpp:179
JointID CreateJoint(AabbTreeWorld &world, Joint def)
Creates a joint to constrain one or more bodies.
Definition: AabbTreeWorld.cpp:1132
Length2 GetAnchorA(const World &world, JointID id)
Definition: WorldJoint.cpp:171
Length2 GetLocalAnchorA(const GearJointConf &conf)
Gets the local anchor A property of the given joint.
Definition: GearJointConf.cpp:502
constexpr auto GetMaxLength(const RopeJointConf &object) noexcept
Free function for getting the maximum length value of the given configuration.
Definition: RopeJointConf.hpp:195
bool GetCollideConnected(const Joint &object) noexcept
Gets collide connected.
Definition: Joint.hpp:300
constexpr auto GetX(const UnitVec &value)
Gets the "X" element of the given value - i.e. the first element.
Definition: UnitVec.hpp:493
StepStats Step(AabbTreeWorld &world, const StepConf &conf)
Steps the world simulation according to the given configuration.
Definition: AabbTreeWorld.cpp:2144
constexpr AngularMomentum GetAngularReaction(const DistanceJointConf &) noexcept
Gets the current angular reaction for the given configuration.
Definition: DistanceJointConf.hpp:182
void InitVelocity(DistanceJointConf &object, const Span< BodyConstraint > &bodies, const StepConf &step, const ConstraintSolverConf &conf)
Initializes velocity constraint data based on the given solver data.
Definition: DistanceJointConf.cpp:81
const char * GetName(Manifold::Type type) noexcept
Gets a unique name for the given manifold type.
Definition: Manifold.cpp:633
Definition: ArrayList.hpp:43
Vector2< Momentum > Momentum2
2-element vector of Momentum quantities.
Definition: Vector2.hpp:76
float Real
Real-number type.
Definition: Real.hpp:69
constexpr auto InvalidBodyID
Invalid body ID value.
Definition: BodyID.hpp:50
constexpr auto InvalidJointID
Invalid joint ID value.
Definition: JointID.hpp:50
Vector2< Length > Length2
2-element vector of Length quantities.
Definition: Vector2.hpp:51
@ e_inactiveLimit
Inactive limit.
detail::IndexingNamedType< BodyCounter, struct BodyIdentifier > BodyID
Body identifier.
Definition: BodyID.hpp:44