目前只处理同步图处理。不处理异步事件。

状态：MVP

用法

基本用法

1. 创建一个EventGraph eg
2. 调用eg.event(|pc| { })进行设置。
3. 在事件上下文中，使用 lunk::Prim::new() 和 lunk::List::new() 创建值。使用 lunk::link!() 创建链接以处理输入变化。
4. 当用户输入发生时，调用 eg.event 并使用相关方法修改数据值。

示例

fn main() {
    let eg = lunk::EventGraph::new();
    let (_input_a, _input_b, output, _link) = eg.event(|pc| {
        let input_a = lunk::Prim::new(pc, 0i32);
        let input_b = lunk::Prim::new(pc, 1f32);
        let output = lunk::Prim::new(pc, 0f32);
        let _link =
            lunk::link!(
                (ctx = pc),
                (input_a = input_a.clone(), input_b = input_b.clone()),
                (output = output.clone()),
                () {
                    output.set(ctx, input_a.get() as f32 * input_b.get() + 5.);
                }
            );
        input_a.set(pc, 46);
        return (input_a, input_b, output, _link);
    });
    assert_eq!(output.get(), 51.);
}

当 a 被修改时，b 将被更新为 a 的值加 5。

有关详细解释，请参阅 link! 文档。链接可以手动（无需宏）定义，但有一些样板代码。

所有权

值对依赖链接有弱引用，不对写入它们的链接有引用。这意味着在图形结构本身中没有 rc 泄漏循环。

链接必须在您希望它们触发的持续时间内保持活动状态。如果删除链接，它将在事件期间停止激活。

动画

要动画化原始值

1. 创建一个 Animator

   由于您可能希望传递它，将其创建为 Rc<RefCell<Animator>> 是一个不错的解决方案。

2. 在原始值上调用 set_ease 而不是 set。

   set_ease 需要一个缓动函数 - ezing 提供了一套相当完整的缓动函数。

   my_prim.set_ease(&mut animator, 44.3, 0.3, ezing::linear_inout);
   

   set_ease 应该为任何实现 Mult<f32> 和其自身类型的 Add 和 Sub 的 Prim 自动实现。

3. 定期（至少直到所有动画完成）在 Animator 上调用 update()。

   animator.update(&eg, delta_s);
   

   此步骤更新动画（delta_s 是上次更新以来的秒数）并返回 true 如果仍有正在进行的动画。

除了 set_ease 之外，您还可以通过实现 PrimAnimation 并调用 animator.start(MyPrimAnimation{...}) 来创建自定义动画。

网络上的惯用法

这有点棘手，但我认为在 WASM 中使用 request_animation_frame（通过 Gloo）的惯用方法是当前这样。

let eg = lunk::EventGraph::new();
let anim = Rc::new(RefCell::new(Animator::new()));
anim.as_ref().borrow_mut().set_start_cb({
    let anim = anim.clone();
    let eg = eg.clone();
    let running = Rc::new(RefCell::new(None));

    fn one_more_frame(
        running: Rc<RefCell<Option<AnimationFrame>>>,
        eg: EventGraph,
        anim: Rc<RefCell<Animator>>,
    ) {
        *running.borrow_mut() = Some(request_animation_frame({
            let running = running.clone();
            move |delta| {
                if anim.as_ref().borrow_mut().update(&eg, delta) {
                    one_more_frame(running, eg, anim);
                } else {
                    *running.borrow_mut() = None;
                }
            }
        }));
    }

    move || {
        if running.borrow().is_some() {
            return;
        }
        one_more_frame(running.clone(), eg.clone(), anim.clone());
    }
});

基本上，需要递归调用 request_animation_frame 来开始下一帧，但每个的返回值都需要存储，直到实际调用。

为此，我创建了一个共享的 Option 来存储返回值，该值由 anim 所拥有的回调保持活动状态。

故障排除

类型不匹配；预期 fn 指针