Kivy - 数据加载器

更新于 2024/6/13 10:47:55

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()