UiTween.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
#include "common/Result.h"
#include "ui/UIHost.h"
 
#include <cstdint>
#include <string>
#include <vector>
 
namespace eve::ui {
 
[[nodiscard]] EVENGINE_API_WORLD float evaluateUiEase(float t, const char *kind);
 
enum class UiHostTweenTarget : std::uint8_t {
    Pos          = 0,  
    Size         = 1,  
    OverlayAlpha = 2,  
};
 
enum class UiItemTweenTarget : std::uint8_t {
    Opacity = 0,  
    Pos     = 1,  
};
 
struct UiHostTween {
    UIHostHandle      host{};
    UiHostTweenTarget target     = UiHostTweenTarget::Pos;
    float             fromX      = 0.f;
    float             fromY      = 0.f;
    float             toX        = 0.f;
    float             toY        = 0.f;
    double            startMs    = 0.0;
    double            durationMs = 0.0;
    double            delayMs    = 0.0;
    std::string       ease       = "smoothstep";
};
 
struct UiItemTween {
    UIHostHandle      host{};
    std::string       nodeId;
    UiItemTweenTarget target     = UiItemTweenTarget::Opacity;
    float             fromX      = 0.f;
    float             fromY      = 0.f;
    float             toX        = 0.f;
    float             toY        = 0.f;
    double            startMs    = 0.0;
    double            durationMs = 0.0;
    double            delayMs    = 0.0;
    std::string       ease       = "smoothstep";
};
 
class EVENGINE_API_WORLD UiTweenDriver {
public:
    void animateHostPos(UIHostHandle host, float x, float y, float durationMs, const std::string &ease, float delayMs,
                        double nowMs);
 
    void animateHostSize(UIHostHandle host, float w, float h, float durationMs, const std::string &ease, float delayMs,
                         double nowMs);
 
    void animateHostOverlayAlpha(UIHostHandle host, float alpha, float durationMs, const std::string &ease,
                                 float delayMs, double nowMs);
 
    [[nodiscard]] eve::Result<void> animateItemOpacity(UIHostHandle host, const std::string &id, float opacity,
                                                       float durationMs, const std::string &ease, float delayMs,
                                                       double nowMs);
 
    [[nodiscard]] eve::Result<void> animateItemPos(UIHostHandle host, const std::string &id, float x, float y,
                                                   float durationMs, const std::string &ease, float delayMs,
                                                   double nowMs);
 
    void cancelHost(UIHostHandle host);
 
    void cancelItem(UIHostHandle host, const std::string &id = {});
 
    void cancelAll(UIHostHandle host);
 
    void tick(double nowMs);
 
    [[nodiscard]] std::size_t hostTweenCount() const noexcept { return hostTweens_.size(); }
 
    [[nodiscard]] std::size_t itemTweenCount() const noexcept { return itemTweens_.size(); }
 
private:
    void        replaceHost(UIHostHandle host, UiHostTweenTarget target);
    void        replaceItem(UIHostHandle host, const std::string &id, UiItemTweenTarget target);
    void        applyHost(UiHostTween &t, float k);
    void        applyItem(UiItemTween &t, float k);
    static bool sameHost(UIHostHandle a, UIHostHandle b) noexcept;
 
    std::vector<UiHostTween> hostTweens_;
    std::vector<UiItemTween> itemTweens_;
};
 
[[nodiscard]] EVENGINE_API_WORLD double uiTweenWallClockMs();
 
}  // namespace eve::ui