mlangkabel/dota_factory
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

allow custom orbit rotations directions

Browse Source
This commit is contained in:
mlangkabel
2026-06-17 20:36:11 +02:00
parent 1324a320e2
commit 0cf3d64983
8 changed files with 139 additions and 56 deletions
Download Patch File Download Diff File Expand all files Collapse all files

15
src/lib/ecs/system/MovementIntentSystem.cpp
View File

@@ -9,6 +9,7 @@
#include "EntityAdmin.h"
#include "FacingComponent.h"
#include "MovementIntentComponent.h"
#include "OrbitMath.h"
#include "PositionComponent.h"
#include "tracing.h"
@@ -45,7 +46,19 @@ void MovementIntentSystem::tick(EntityAdmin& admin)
return;
}
const QVector2D delta = intent.target - pos.value;
// Resolve the steering destination. For orbit intents, pick the orbit
// sense from the ship's current velocity (so ships circling the same
// target spread to both sides) and aim at a point on the orbit circle.
QVector2D destination = intent.target;
if (intent.orbitRadius_tiles > 0.0f)
{
const float sign = OrbitMath::resolveOrbitSign(pos.value, intent.target,
body.velocity_tpt);
destination = OrbitMath::computeOrbitDestination(
pos.value, intent.target, intent.orbitRadius_tiles, sign);
}
const QVector2D delta = destination - pos.value;
const float dist = delta.length();
if (dist < 0.001f)

11
src/lib/ecs/system/ai/AttackExecutor.cpp
View File

@@ -5,7 +5,6 @@
#include "EntityAdmin.h"
#include "ModuleOwnerComponent.h"
#include "MovementIntentComponent.h"
#include "OrbitMath.h"
#include "PositionComponent.h"
#include "SelectedBehaviorComponent.h"
#include "tracing.h"
@@ -26,14 +25,14 @@ void AttackExecutor::execute(EntityAdmin& admin)
if (!attack.currentTarget) { return; }
const entt::entity t = *attack.currentTarget;
QVector2D dest = pos.value;
QVector2D center = pos.value;
float radius = 0.0f;
if (admin.isValid(t) && admin.hasAll<PositionComponent>(t))
{
const QVector2D targetPos = admin.get<PositionComponent>(t).value;
dest = OrbitMath::computeOrbitDestination(pos.value, targetPos,
attack.orbitRadius_tiles);
center = admin.get<PositionComponent>(t).value;
radius = attack.orbitRadius_tiles;
}
intent = MovementIntentComponent{true, dest};
intent = MovementIntentComponent{true, center, radius};
});
// Weapons: assign the behavior target only if it is within this weapon's range.

69
src/lib/ecs/system/ai/OrbitMath.h
View File

@@ -5,41 +5,76 @@
#include <QVector2D>
// Orbit movement helper (REQ-SHP-ORBIT). Behaviors that keep a ship circling a
// target (attack, repair, salvage, rally) feed the result of this function as the
// movement intent destination instead of the target's center.
// target (attack, repair, salvage, rally) supply an orbit center and radius via
// the movement intent; MovementIntentSystem resolves the orbit direction and
// destination using these helpers.
namespace OrbitMath
{
// Lead angle (radians) by which the radial direction is rotated to produce
// tangential motion. The fixed positive (counter-clockwise) sense makes the
// orbit direction stable for the duration of orbiting a given target.
// tangential motion. The orbit direction (sign of the rotation) is chosen
// per ship by resolveOrbitSign from the ship's current velocity, so ships
// approaching a target from different sides circle it in different senses
// instead of all bunching on one side.
constexpr float kOrbitLeadAngle_rad = 0.6f;
// Returns a destination on the orbit circle of `radius` around `target`. The
// result always lies exactly `radius` from `target`, so steering toward it
// both corrects the standoff distance and advances the ship tangentially.
// A radius of zero or less falls back to the target center (legacy "approach
// the target" behavior), e.g. when the ship has no tool range to orbit at.
inline QVector2D computeOrbitDestination(const QVector2D& shipPos,
const QVector2D& target, float radius)
// Returns the orbit sense (+1 counter-clockwise, -1 clockwise) that matches
// the ship's current movement around `center`, so steering reinforces the
// motion the ship already has. When the velocity is nearly radial or near
// zero (e.g. a head-on approach or a freshly spawned ship) the sense is
// ill-defined; this is an unstable point the ship leaves within a tick or
// two, so a deterministic fallback of +1 is returned.
inline float resolveOrbitSign(const QVector2D& shipPos, const QVector2D& center,
const QVector2D& velocity)
{
if (radius <= 0.0f) { return target; }
const QVector2D radial = shipPos - center;
const float radialLength = radial.length();
const float velocityLength = velocity.length();
if (radialLength < 1.0e-4f || velocityLength < 1.0e-4f)
{
return 1.0f;
}
QVector2D radial = shipPos - target;
// z-component of radial x velocity, normalised to sin(angle) between them.
const float cross = radial.x() * velocity.y() - radial.y() * velocity.x();
const float sinAngle = cross / (radialLength * velocityLength);
constexpr float kRadialEpsilon = 1.0e-3f;
if (std::abs(sinAngle) < kRadialEpsilon)
{
return 1.0f;
}
return (sinAngle > 0.0f) ? 1.0f : -1.0f;
}
// Returns a destination on the orbit circle of `radius` around `center`. The
// result always lies exactly `radius` from `center`, so steering toward it
// both corrects the standoff distance and advances the ship tangentially.
// `sign` selects the orbit sense (+1 counter-clockwise, -1 clockwise). A
// radius of zero or less falls back to the center (legacy "approach the
// target" behavior), e.g. when the ship has no tool range to orbit at.
inline QVector2D computeOrbitDestination(const QVector2D& shipPos,
const QVector2D& center, float radius,
float sign = 1.0f)
{
if (radius <= 0.0f) { return center; }
QVector2D radial = shipPos - center;
float length = radial.length();
if (length < 1.0e-4f)
{
// Ship sits on the target; pick an arbitrary radial direction.
// Ship sits on the center; pick an arbitrary radial direction.
radial = QVector2D(1.0f, 0.0f);
length = 1.0f;
}
const QVector2D radialDirection = radial / length;
const float cosLead = std::cos(kOrbitLeadAngle_rad);
const float sinLead = std::sin(kOrbitLeadAngle_rad);
const float leadAngle = sign * kOrbitLeadAngle_rad;
const float cosLead = std::cos(leadAngle);
const float sinLead = std::sin(leadAngle);
const QVector2D leadDirection(
radialDirection.x() * cosLead - radialDirection.y() * sinLead,
radialDirection.x() * sinLead + radialDirection.y() * cosLead);
return target + radius * leadDirection;
return center + radius * leadDirection;
}
}

11
src/lib/ecs/system/ai/RallyExecutor.cpp
View File

@@ -3,8 +3,6 @@
#include "BehaviorKind.h"
#include "EntityAdmin.h"
#include "MovementIntentComponent.h"
#include "OrbitMath.h"
#include "PositionComponent.h"
#include "RallyBehavior.h"
#include "SelectedBehaviorComponent.h"
#include "tracing.h"
@@ -12,15 +10,14 @@
void RallyExecutor::execute(EntityAdmin& admin)
{
TRACE();
admin.forEach<RallyBehavior, SelectedBehaviorComponent, PositionComponent,
admin.forEach<RallyBehavior, SelectedBehaviorComponent,
MovementIntentComponent>(
[](entt::entity /*e*/, const RallyBehavior& rally,
const SelectedBehaviorComponent& selected, const PositionComponent& pos,
const SelectedBehaviorComponent& selected,
MovementIntentComponent& intent)
{
if (selected.winner != BehaviorKind::Rally) { return; }
const QVector2D dest = OrbitMath::computeOrbitDestination(
pos.value, rally.rallyPoint, rally.orbitRadius_tiles);
intent = MovementIntentComponent{true, dest};
intent = MovementIntentComponent{true, rally.rallyPoint,
rally.orbitRadius_tiles};
});
}

11
src/lib/ecs/system/ai/RepairExecutor.cpp
View File

@@ -4,7 +4,6 @@
#include "EntityAdmin.h"
#include "ModuleOwnerComponent.h"
#include "MovementIntentComponent.h"
#include "OrbitMath.h"
#include "PositionComponent.h"
#include "RepairBehavior.h"
#include "RepairToolComponent.h"
@@ -26,14 +25,14 @@ void RepairExecutor::execute(EntityAdmin& admin)
if (!repair.currentTarget) { return; }
const entt::entity t = *repair.currentTarget;
QVector2D dest = pos.value;
QVector2D center = pos.value;
float radius = 0.0f;
if (admin.isValid(t) && admin.hasAll<PositionComponent>(t))
{
const QVector2D targetPos = admin.get<PositionComponent>(t).value;
dest = OrbitMath::computeOrbitDestination(pos.value, targetPos,
repair.orbitRadius_tiles);
center = admin.get<PositionComponent>(t).value;
radius = repair.orbitRadius_tiles;
}
intent = MovementIntentComponent{true, dest};
intent = MovementIntentComponent{true, center, radius};
});
// Repair tools: prefer the behavior target if it is within tool range.

11
src/lib/ecs/system/ai/SalvageScrapExecutor.cpp
View File

@@ -3,8 +3,6 @@
#include "BehaviorKind.h"
#include "EntityAdmin.h"
#include "MovementIntentComponent.h"
#include "OrbitMath.h"
#include "PositionComponent.h"
#include "SalvageScrapBehavior.h"
#include "SelectedBehaviorComponent.h"
#include "tracing.h"
@@ -12,16 +10,15 @@
void SalvageScrapExecutor::execute(EntityAdmin& admin)
{
TRACE();
admin.forEach<SalvageScrapBehavior, SelectedBehaviorComponent, PositionComponent,
admin.forEach<SalvageScrapBehavior, SelectedBehaviorComponent,
MovementIntentComponent>(
[](entt::entity /*e*/, const SalvageScrapBehavior& salvage,
const SelectedBehaviorComponent& selected, const PositionComponent& pos,
const SelectedBehaviorComponent& selected,
MovementIntentComponent& intent)
{
if (selected.winner != BehaviorKind::SalvageScrap) { return; }
if (!salvage.scrapTarget) { return; }
const QVector2D dest = OrbitMath::computeOrbitDestination(
pos.value, *salvage.scrapTarget, salvage.orbitRadius_tiles);
intent = MovementIntentComponent{true, dest};
intent = MovementIntentComponent{true, *salvage.scrapTarget,
salvage.orbitRadius_tiles};
});
}