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
相关产品推荐
相关产品推荐

