MotionEchoEffect.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
 
#include "stylize/MeshParticleEmitter.h"
#include "stylize/TrailEffect.h"
 
#include <glm/mat4x4.hpp>
#include <glm/vec3.hpp>
 
#include <cstddef>
#include <cstdint>
#include <vector>
 
namespace eve::stylize {
 
struct ProjectileTrailConfig {
    float sampleIntervalSeconds = 1.f / 60.f;
    float sampleLifetimeSeconds = 0.35f;
    float minimumDistance = 0.01f;
    float widthHead = 0.12f;
    float widthTail = 0.f;
    std::size_t maximumSamples = 128;
};
 
struct MotionEchoAdvanceReport {
    std::uint32_t captured = 0;
    std::uint32_t expired = 0;
    std::uint32_t distanceRejected = 0;
    std::uint32_t alive = 0;
};
 
class EVENGINE_API_WORLD ProjectileTrailEffect {
public:
    explicit ProjectileTrailEffect(ProjectileTrailConfig config = {});
 
    void reset() noexcept;
 
    [[nodiscard]] MotionEchoAdvanceReport update(float deltaSeconds,
                                                 const glm::vec3& currentPosition);
 
    [[nodiscard]] TrailMeshSnapshot build(const glm::vec3& cameraForward) const;
 
    [[nodiscard]] std::size_t size() const noexcept { return samples_.size(); }
 
private:
    struct Sample {
        glm::vec3 position{0.f};
        float age = 0.f;
    };
 
    bool append(const glm::vec3& position, float initialAge,
                MotionEchoAdvanceReport& report);
 
    ProjectileTrailConfig config_;
    std::vector<Sample> samples_;
    glm::vec3 previousInput_{0.f};
    float sampleAccumulator_ = 0.f;
    bool hasPreviousInput_ = false;
};
 
struct AfterimageEffectConfig {
    float sampleIntervalSeconds = 0.06f;
    float lifetimeSeconds = 0.3f;
    std::size_t maximumImages = 12;
    graphics::Color colorStart{0.4f, 0.8f, 1.f, 0.65f};
    graphics::Color colorEnd{0.1f, 0.2f, 1.f, 0.f};
};
 
class EVENGINE_API_WORLD AfterimageEffect {
public:
    explicit AfterimageEffect(AfterimageEffectConfig config = {});
 
    void reset() noexcept;
 
    [[nodiscard]] MotionEchoAdvanceReport update(float deltaSeconds,
                                                 const glm::mat4& currentModel);
 
    [[nodiscard]] std::vector<MeshParticleInstance> snapshot() const;
 
    [[nodiscard]] std::size_t size() const noexcept { return images_.size(); }
 
private:
    struct Image {
        std::uint64_t stableId = 0;
        glm::mat4 model{1.f};
        float age = 0.f;
    };
 
    AfterimageEffectConfig config_;
    std::vector<Image> images_;
    float sampleAccumulator_ = 0.f;
    std::uint64_t nextStableId_ = 1;
};
 
}  // namespace eve::stylize