api/_joint2_d_8h_source.html

#pragma once

#include "../Core/Core.h"

#include "../Math.h"

#include "../Component/Component.h"

#include "../GameObject/ComponentRef.h"

#include <cstdint>


namespace Shit {

    class PhysicsSystem2D;

    class RigidBody2D;   // 前向声明（ComponentRef 模板与 setter 参数仅需不完整类型）


    enum class SHIT_ENUM(JointType) JointType : int {

        Distance   = 0,

        Revolute   = 1,

        Weld       = 2,

        Prismatic  = 3,

    };


    class SHIT_API SHIT_REFLECT(BlackList) Joint2D : public Component {

        SHIT_REFLECT_BODY(Joint2D)

    public:

        Joint2D();

        ~Joint2D() override;


        void onCreate() override;

        void onAttach() override;

        void onDetach() override;

        void onDestroy() override;


        void onFieldChanged(const std::string& fieldName) override;


        // --- 配置（可在 onAttach 前后调用） ---

        void setType(JointType type);

        JointType getType() const { return m_type; }


        void setConnectedBody(RigidBody2D* body);

        RigidBody2D* getConnectedBody() const;


        void setAnchor(const Vector2& anchor);

        const Vector2& getAnchor() const { return m_anchor; }


        // --- Distance 关节参数 ---

        void setLength(float length);

        float getLength() const { return m_length; }

        void setEnableSpring(bool enable);

        void setHertz(float hertz);

        void setDampingRatio(float ratio);


        // --- Revolute 关节参数 ---

        void setEnableMotor(bool enable);

        void setMotorSpeed(float speed);

        void setMaxMotorTorque(float torque);

        void setEnableLimit(bool enable);

        void setLowerAngle(float deg);

        void setUpperAngle(float deg);


        // --- Prismatic 关节参数 ---

        void setAxisAngle(float deg);

        void setLowerTranslation(float v);

        void setUpperTranslation(float v);

        void setMaxMotorForce(float force);


        // --- 内部 / 供 PhysicsSystem2D 使用 ---

        bool hasValidJoint() const { return m_jointValid; }

        int32_t getJointIndex() const { return m_jointIndex; }

        uint16_t getJointWorld0() const { return m_jointWorld0; }

        uint16_t getJointGeneration() const { return m_jointGeneration; }


    private:

        friend class PhysicsSystem2D;


        // b2JointId = {int32_t index1; uint16_t world0; uint16_t generation;}

        SHIT_META(Disable)

        int32_t m_jointIndex = 0;

        SHIT_META(Disable)

        uint16_t m_jointWorld0 = 0;

        SHIT_META(Disable)

        uint16_t m_jointGeneration = 0;

        SHIT_META(Disable)

        bool m_jointValid = false;


        SHIT_META(({.displayName = "Type", .tooltip = "Distance=距离, Revolute=铰链, Weld=焊接, Prismatic=滑动"}))

        JointType m_type = JointType::Distance;


        SHIT_META(({.displayName = "Connected Body", .tooltip = "另一端刚体（bodyB）；留空则暂不创建"}))

        ComponentRef<RigidBody2D> m_connectedBody;


        SHIT_META(({.displayName = "Anchor", .tooltip = "世界锚点（像素）"}))

        Vector2 m_anchor{ 0.0f, 0.0f };


        // --- Distance 参数 ---

        SHIT_META(({.displayName = "Length", .tooltip = "距离关节自然长度（像素）", .range = {0, 4096}, .step = 1}))

        float m_length = 0.0f;

        SHIT_META(({.displayName = "Spring", .tooltip = "作为弹簧（false=刚性距离）"}))

        bool m_enableSpring = false;

        SHIT_META(({.displayName = "Hertz", .tooltip = "弹簧刚度 (Hz)", .range = {0, 60}, .step = 0.1}))

        float m_hertz = 4.0f;

        SHIT_META(({.displayName = "Damping Ratio", .tooltip = "弹簧阻尼比", .range = {0, 2}, .step = 0.01}))

        float m_dampingRatio = 0.5f;


        // --- Revolute 参数 ---

        SHIT_META(({.displayName = "Motor", .tooltip = "启用电机"}))

        bool m_enableMotor = false;

        SHIT_META(({.displayName = "Motor Speed", .tooltip = "目标角速度（度/秒）", .range = {-720, 720}, .step = 1}))

        float m_motorSpeed = 0.0f;

        SHIT_META(({.displayName = "Max Motor Torque", .tooltip = "最大电机扭矩", .range = {0, 100000}, .step = 1}))

        float m_maxMotorTorque = 0.0f;

        SHIT_META(({.displayName = "Limit", .tooltip = "启用角度限制"}))

        bool m_enableLimit = false;

        SHIT_META(({.displayName = "Lower Angle", .tooltip = "角度下限（度）", .range = {-360, 360}, .step = 1}))

        float m_lowerAngle = -45.0f;

        SHIT_META(({.displayName = "Upper Angle", .tooltip = "角度上限（度）", .range = {-360, 360}, .step = 1}))

        float m_upperAngle = 45.0f;


        // --- Prismatic 参数 ---

        SHIT_META(({.displayName = "Axis Angle", .tooltip = "滑动轴方向（度，相对 bodyA 局部）", .range = {-360, 360}, .step = 1}))

        float m_axisAngle = 0.0f;

        SHIT_META(({.displayName = "Lower Translation", .tooltip = "滑动下限（像素）", .range = {-4096, 4096}, .step = 1}))

        float m_lowerTranslation = -100.0f;

        SHIT_META(({.displayName = "Upper Translation", .tooltip = "滑动上限（像素）", .range = {-4096, 4096}, .step = 1}))

        float m_upperTranslation = 100.0f;

        SHIT_META(({.displayName = "Max Motor Force", .tooltip = "最大电机力", .range = {0, 100000}, .step = 1}))

        float m_maxMotorForce = 0.0f;

    };


}

Component.h

ComponentRef.h

Core.h

SHIT_API
#define SHIT_API
定义 Core.h:14

SHIT_ENUM
#define SHIT_ENUM(Type)
定义 Macros.h:92

SHIT_REFLECT_BODY
#define SHIT_REFLECT_BODY(Type)
定义 Macros.h:89

SHIT_REFLECT
#define SHIT_REFLECT(Mode)
定义 Macros.h:86

SHIT_META
#define SHIT_META(...)
定义 Macros.h:95

Math.h

Shit::Component::Component
Component()

Shit::Joint2D::setEnableSpring
void setEnableSpring(bool enable)
是否作为弹簧（false=刚性距离）

Shit::Joint2D::setDampingRatio
void setDampingRatio(float ratio)
弹簧阻尼比

Shit::Joint2D::setLowerTranslation
void setLowerTranslation(float v)
滑动下限（像素）

Shit::Joint2D::setConnectedBody
void setConnectedBody(RigidBody2D *body)
设置另一端刚体（bodyB）。传 nullptr 清空。

Shit::Joint2D::setMaxMotorTorque
void setMaxMotorTorque(float torque)

Shit::Joint2D::Joint2D
Joint2D()

Shit::Joint2D::setUpperTranslation
void setUpperTranslation(float v)
滑动上限（像素）

Shit::Joint2D::setAxisAngle
void setAxisAngle(float deg)
滑动轴方向（度，相对 bodyA 局部）

Shit::Joint2D::getJointWorld0
uint16_t getJointWorld0() const
定义 Joint2D.h:86

Shit::Joint2D::getJointGeneration
uint16_t getJointGeneration() const
定义 Joint2D.h:87

Shit::Joint2D::getJointIndex
int32_t getJointIndex() const
定义 Joint2D.h:85

Shit::Joint2D::getLength
float getLength() const
定义 Joint2D.h:64

Shit::Joint2D::setMotorSpeed
void setMotorSpeed(float speed)
目标角速度（度/秒）

Shit::Joint2D::setHertz
void setHertz(float hertz)
弹簧刚度（Hz）

Shit::Joint2D::setEnableLimit
void setEnableLimit(bool enable)

Shit::Joint2D::getType
JointType getType() const
定义 Joint2D.h:52

Shit::Joint2D::setLowerAngle
void setLowerAngle(float deg)
角度下限（度）

Shit::Joint2D::setLength
void setLength(float length)
自然长度（像素），默认取两锚点当前距离

Shit::Joint2D::PhysicsSystem2D
friend class PhysicsSystem2D
定义 Joint2D.h:90

Shit::Joint2D::setUpperAngle
void setUpperAngle(float deg)
角度上限（度）

Shit::Joint2D::onFieldChanged
void onFieldChanged(const std::string &fieldName) override
检查器直写反射字段后回调：把运行时字段改动同步到已创建的 Box2D 关节

Shit::Joint2D::getConnectedBody
RigidBody2D * getConnectedBody() const

Shit::Joint2D::getAnchor
const Vector2 & getAnchor() const
定义 Joint2D.h:60

Shit::Joint2D::setEnableMotor
void setEnableMotor(bool enable)

Shit::Joint2D::hasValidJoint
bool hasValidJoint() const
定义 Joint2D.h:84

Shit::Joint2D::setType
void setType(JointType type)

Shit::Joint2D::setAnchor
void setAnchor(const Vector2 &anchor)
世界锚点（像素）。默认取本刚体位置；revolute/weld/distance 共用心智模型。

Shit::Joint2D::onCreate
void onCreate() override

Shit::Joint2D::onAttach
void onAttach() override

Shit::Joint2D::setMaxMotorForce
void setMaxMotorForce(float force)

Shit::Joint2D::onDetach
void onDetach() override

Shit::Joint2D::onDestroy
void onDestroy() override

Shit::Joint2D::~Joint2D
~Joint2D() override

Shit::PhysicsSystem2D
2D 物理系统
定义 PhysicsSystem2D.h:30

Shit::RigidBody2D
刚体组件
定义 RigidBody2D.h:24

Shit
定义 AnimationClip.h:12

Shit::Weld
enum JointType Weld
焊接关节：把两刚体刚性连在一起（可做软体）
定义 Joint2D.h:16

Shit::JointType
enum JointType JointType
关节类型（决定 Box2D 约束行为）
定义 Joint2D.h:13

Shit::Revolute
enum JointType Revolute
旋转/铰链关节：两刚体绕锚点相对旋转
定义 Joint2D.h:15

Shit::Prismatic
enum JointType Prismatic
棱柱关节：沿局部轴相对滑动（活塞/滑轨）
定义 Joint2D.h:17

Shit::Vector2
glm::vec2 Vector2
定义 Math.h:7