Kivy - 数据加载器
Kivy 框架中的 Loader 类是一个异步数据加载器,即使数据尚未可用,也可以加载图像。当您想要从互联网 URL 加载图像时,此功能特别有用。
Loader 类在 kivy.loader 模块中定义。 Loader 类的典型用法如下 −
from kivy.loader import Loader image = Loader.image('http://mysite.com/test.png')
使用 loading_image 属性指定默认图像。
Loader.loading_image = Image(default.png')
Loader 类配备以下属性 −
error_image − 用于错误的图像。例如 −
Loader.error_image = 'error.png'
image(filename) − 使用 Loader 加载图像。ProxyImage 会返回一个正在加载的图像。
loading_image − 用于加载的图像。例如 −
Loader.loading_image = 'loading.png'
max_upload_per_frame − 每帧要上传的图像数量。默认情况下,我们每帧只向 GPU 上传 2 张图像。
num_workers − 加载时要使用的 worker 数量。此设置仅在初始化时影响加载器。加载器启动后,此设置将不再产生影响。
from kivy.loader import Loader Loader.num_workers = 4
默认值为"2",可提供流畅的用户体验。
ProxyImage() − Loader.image() 函数返回的图像。
proxyImage = Loader.image("test.jpg")
pause() − 暂停加载器。
resume() − 在 pause() 之后恢复加载器。
run() − 加载器的主循环。
start() −启动加载器线程/进程。
stop() − 停止加载器线程/进程。
当图像加载或更改时,将触发"on_load"事件。同样,当无法加载图像时,将触发"on_error"。"error: 发生的异常数据"。
示例
在下面给出的代码中,Loader 对象从互联网 URL 加载图像。Loader 返回的 ProxyImage 对象绑定到其 on_load 事件上的方法。回调方法将其纹理用作 Image 对象的纹理 属性。
from kivy.app import App from kivy.uix.image import Image from kivy.loader import Loader from kivy.core.window import Window Window.size = (720,400) class MyApp(App): title='Loader' def _image_loaded(self, proxyImage): if proxyImage.image.texture: self.image.texture = proxyImage.image.texture def build(self): proxyImage = Loader.image('https://source.unsplash.com/user/c_v_r/640x480') proxyImage.bind(on_load=self._image_loaded) self.image = Image() return self.image MyApp().run()
输出
执行时,它将产生以下输出 −