ActionParameterCurve.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
 
#include "action/ActionNotifyRegistry.h"
 
#include <cstdint>
#include <optional>
#include <string>
#include <string_view>
#include <vector>
 
namespace eve::action {
 
enum class ActionParameterInterpolation : std::uint8_t { Step, Linear, Cubic };
 
enum class ActionParameterOperation : std::uint8_t { Replace, Add, Multiply };
 
struct ActionParameterKey {
    double                       time = 0.0;
    double                       value = 0.0;
    double                       inTangent = 0.0;
    double                       outTangent = 0.0;
    ActionParameterInterpolation interpolation = ActionParameterInterpolation::Linear;
 
    auto operator<=>(const ActionParameterKey&) const = default;
};
 
struct EVENGINE_API_PLATFORM ActionParameterCurveBinding {
    LogicalId                      target;
    ActionParameterOperation       operation = ActionParameterOperation::Replace;
    std::vector<ActionParameterKey> keys;
 
    auto operator<=>(const ActionParameterCurveBinding&) const = default;
 
    [[nodiscard]] static Result<ActionParameterCurveBinding> fromPayload(const Value::Object& payload);
    [[nodiscard]] Value::Object toPayload(Value::Object extensions = {}) const;
    [[nodiscard]] double sample(double progress) const noexcept;
};
 
[[nodiscard]] EVENGINE_API_PLATFORM std::string_view actionParameterInterpolationName(
    ActionParameterInterpolation value) noexcept;
[[nodiscard]] EVENGINE_API_PLATFORM std::optional<ActionParameterInterpolation> actionParameterInterpolationFromName(
    std::string_view value) noexcept;
[[nodiscard]] EVENGINE_API_PLATFORM std::string_view actionParameterOperationName(
    ActionParameterOperation value) noexcept;
 
enum class ActionParameterPhase : std::uint8_t { Begin, Update, End };
 
struct ActionParameterSample {
    ActionParameterPhase     phase = ActionParameterPhase::Update;
    ActionExecutionId        executionId;
    LogicalId                itemId;
    LogicalId                target;
    ActionParameterOperation operation = ActionParameterOperation::Replace;
    double                   value = 0.0;
    bool                     preview = false;
};
 
class IActionParameterSink {
public:
    static constexpr const char* capabilityName = "IActionParameterSink";
    virtual ~IActionParameterSink() = default;
 
    [[nodiscard]] virtual bool supports(const LogicalId& target) const noexcept = 0;
    [[nodiscard]] virtual Result<void> apply(const ActionParameterSample& sample) = 0;
};
 
}  // namespace eve::action