MotionSequence.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
#include "animation/MotionBuilder.h"
#include "animation/MotionRuntime.h"
#include "animation/MotionTypes.h"
#include "common/Result.h"
 
#include <cstdint>
#include <vector>
 
namespace eve::animation {
 
class EVENGINE_API_WORLD MotionSequenceHandle {
public:
    MotionSequenceHandle() = default;
    MotionSequenceHandle(MotionRuntime *runtime, std::vector<MotionHandle> children);
 
    [[nodiscard]] bool isActive() const noexcept;
    [[nodiscard]] int childCount() const noexcept { return static_cast<int>(children_.size()); }
    [[nodiscard]] MotionHandle child(int index) const;
 
    [[nodiscard]] eve::Result<void> complete();
    [[nodiscard]] eve::Result<void> cancel();
 
private:
    MotionRuntime             *runtime_ = nullptr;
    std::vector<MotionHandle>  children_;
};
 
class EVENGINE_API_WORLD MotionSequence {
public:
    explicit MotionSequence(MotionRuntime &runtime);
 
    [[nodiscard]] eve::Result<void> append(MotionBuilder &&builder);
    [[nodiscard]] eve::Result<void> append(MotionVec2Builder &&builder);
    [[nodiscard]] eve::Result<void> append(MotionVec3Builder &&builder);
 
    [[nodiscard]] eve::Result<void> join(MotionBuilder &&builder);
    [[nodiscard]] eve::Result<void> join(MotionVec2Builder &&builder);
    [[nodiscard]] eve::Result<void> join(MotionVec3Builder &&builder);
 
    [[nodiscard]] eve::Result<void> insert(float atSeconds, MotionBuilder &&builder);
    [[nodiscard]] eve::Result<void> insert(float atSeconds, MotionVec2Builder &&builder);
    [[nodiscard]] eve::Result<void> insert(float atSeconds, MotionVec3Builder &&builder);
 
    [[nodiscard]] eve::Result<void> appendInterval(float seconds);
 
    [[nodiscard]] float cursor() const noexcept { return cursor_; }
    [[nodiscard]] float duration() const noexcept { return duration_; }
    [[nodiscard]] int itemCount() const noexcept { return static_cast<int>(items_.size()); }
 
    [[nodiscard]] eve::Result<MotionSequenceHandle> run();
 
private:
    enum class Kind : std::uint8_t { Float, Vec2, Vec3 };
 
    struct Item {
        Kind                      kind = Kind::Float;
        float                     start = 0.f;
        MotionRuntime::FloatDesc  floatDesc{};
        MotionRuntime::Vec2Desc   vec2Desc{};
        MotionRuntime::Vec3Desc   vec3Desc{};
    };
 
    [[nodiscard]] static eve::Result<float> spanOf(float delay, float duration, int loops);
    [[nodiscard]] eve::Result<void> schedule(float start, float span, Item item);
    [[nodiscard]] eve::Result<void> appendAtCursor(Item item, float delay, float duration, int loops);
    [[nodiscard]] eve::Result<void> joinAtLast(Item item, float delay, float duration, int loops);
    [[nodiscard]] eve::Result<void> insertAt(float at, Item item, float delay, float duration, int loops);
 
    MotionRuntime        &runtime_;
    std::vector<Item>     items_;
    float                 cursor_          = 0.f;
    float                 duration_        = 0.f;
    float                 lastAppendStart_ = 0.f;
    bool                  hasAppend_       = false;
};
 
}  // namespace eve::animation