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 - 每帧上传的图像数量。默认情况下,我们每帧只上传 2 张图像到 GPU。

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

输出

执行后,将产生以下输出:

Kivy Data Loader
广告