FollowCamera.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2026 Valentin Eloy
// SPDX-License-Identifier: GPL-3.0-or-later
 
#pragma once
 
#include "Core/Math/Rect.h"
#include "Core/Math/Vector2.h"

 
namespace hmi {

inline constexpr float FOLLOW_DEAD_ZONE_HALF_WIDTH_UNITS = 1.5f;
inline constexpr float FOLLOW_DEAD_ZONE_HALF_HEIGHT_UNITS = 1.5f;
inline constexpr float FOLLOW_ANTICIPATION_DISTANCE_UNITS = 2.5f;
inline constexpr float FOLLOW_SMOOTHING_TIME_CONSTANT_SECONDS = 0.15f;
inline constexpr float FOLLOW_ANTICIPATION_TIME_CONSTANT_SECONDS = 0.25f;

struct FollowCameraState {
    core::Vector2 anchor{};
    core::Vector2 anticipation{};
    core::Vector2 center{};
    bool initialized = false;
};

[[nodiscard]] FollowCameraState advanceFollowCamera(
    const FollowCameraState& previous, core::Vector2 characterPosition, core::Vector2 facing,
    const core::Rect& levelBounds, core::Vector2 viewHalfExtent, float fixedDelta) noexcept;
 
}  // namespace hmi