FixedConstraint.hpp

Go to the documentation of this file.

/**************************************************************************
 * EngineSquared v0.1.1
 *
 * EngineSquared is a software package, part of the Engine² organization.
 *
 * This file is part of the EngineSquared project that is under MIT License.
 * Copyright © 2025-present by @EngineSquared, All rights reserved.
 *
 * EngineSquared is a free software: you can redistribute it and/or modify
 * it under the terms of the MIT License. See the project's LICENSE file for
 * the full license text and details.
 *
 * @file FixedConstraint.hpp
 * @brief Fixed constraint component (0 DOF) - welds two bodies together
 *
 * A fixed constraint removes all degrees of freedom between two bodies,
 * effectively welding them into a single rigid structure. This is useful
 * for compound objects, breakable structures, and rigid attachments.
 *
 * @author @EngineSquared
 * @version 0.1.1
 * @date 2025-12-04
 **************************************************************************/
 
#pragma once
 
#include "ConstraintSettings.hpp"
#include <Engine.hpp>
#include <glm/glm.hpp>
 
namespace Physics::Component {

struct FixedConstraint {
    //========================================================================
    // Constraint Bodies
    //========================================================================

    Engine::EntityId bodyA = Engine::EntityId::Null();

    Engine::EntityId bodyB = Engine::EntityId::Null();
 
    //========================================================================
    // Attachment Points
    //========================================================================

    glm::vec3 localPointA = glm::vec3(0.0f);

    glm::vec3 localPointB = glm::vec3(0.0f);
 
    //========================================================================
    // Settings
    //========================================================================

    ConstraintSettings settings;
 
    //========================================================================
    // Runtime State
    //========================================================================

    bool broken = false;
 
    //========================================================================
    // Factory Methods
    //========================================================================

    [[nodiscard]] static FixedConstraint
    Create(Engine::EntityId a, Engine::EntityId b, const glm::vec3 &pointA = glm::vec3(0.0f),
           const glm::vec3 &pointB = glm::vec3(0.0f),
           const ConstraintSettings &constraintSettings = ConstraintSettings::Rigid())
    {
        FixedConstraint constraint;
        constraint.bodyA = a;
        constraint.bodyB = b;
        constraint.localPointA = pointA;
        constraint.localPointB = pointB;
        constraint.settings = constraintSettings;
        constraint.broken = false;
        return constraint;
    }

    [[nodiscard]] static FixedConstraint
    CreateToWorld(Engine::EntityId body, const glm::vec3 &worldPoint,
                  const ConstraintSettings &constraintSettings = ConstraintSettings::Rigid())
    {
        FixedConstraint constraint;
        constraint.bodyA = body;
        constraint.bodyB = Engine::EntityId::Null(); // P Invalid entity = world
        constraint.localPointA = glm::vec3(0.0f);
        constraint.localPointB = worldPoint; // Used as world position
        constraint.settings = constraintSettings;
        constraint.broken = false;
        return constraint;
    }

    [[nodiscard]] bool IsWorldConstraint() const { return bodyB.IsNull(); }
};
 
} // namespace Physics::Component