You need to enable JavaScript to run this app. pyglet.app.run()如何识别被@window.event装饰的on_draw()函数并调用?
优惠活动
大模型
产品
解决方案
定价
更多

pyglet.app.run()如何识别被@window.event装饰的on_draw()函数并调用?

pyglet自定义绘制函数的绑定与调用逻辑

装饰器的实际作用

你看到的@window.event并不是普通的函数包装类装饰器,它的核心作用是完成事件处理器的注册绑定,整个流程没有什么隐式魔法,逻辑非常清晰:

  • 当你用@window.event修饰自定义函数时,装饰器会自动读取被装饰函数的名称字符串,以这个名称为键,把函数对象存入当前window实例内部维护的事件处理器映射表(结构类似self.event_handlers = {"事件名": 对应的处理函数})
  • 装饰器最终会返回被修饰的原函数,不会修改函数本身的执行逻辑,你写的on_draw函数不会因为加了装饰器就被提前执行
  • 整个绑定操作在装饰器执行的时刻就已经完成,不需要等程序走到pyglet.app.run()才生效

主循环的调用逻辑

执行pyglet.app.run()本质上是启动了pyglet的全局主事件循环,这个循环的工作逻辑是:

  • 持续轮询操作系统发来的窗口事件(比如窗口大小变化、需要重绘、鼠标交互、键盘输入等)
  • 当收到“窗口需要重绘”的系统通知时,循环会找到对应的window实例,从它之前存的事件处理器映射表里,取出键为"on_draw"的函数,直接执行这个函数完成绘制
  • 所有事件的触发都遵循同样的逻辑:比如用户点击鼠标,循环就会去找on_mouse_press对应的处理器执行;按下键盘就找on_key_press对应的处理器执行

常见注意事项

  • 必须把事件处理函数的命名和pyglet约定的事件名完全一致,装饰器是靠函数名做绑定匹配的。如果你把函数写成@window.event def my_draw(): ...,哪怕加了装饰器,它也只会被绑定到"my_draw"事件槽位上,永远不会在窗口需要重绘的时候被调用
  • 你也可以不用装饰器,用更显式的方式完成完全一样的绑定:
    def on_draw():
        window.clear()
        image.blit(0, 0)
    
    window.event(on_draw)  # 和@window.event语法完全等价
    # 或者更灵活的手动注册
    window.push_handlers(on_draw=on_draw)
    

内容的提问来源于stack exchange,提问作者Master Viewer

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.05 14:24:04