Kivy 简明教程

Kivy - Data Loader

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 类配有以下属性 −

  1. error_image − 用于错误的图像。例如 −

Loader.error_image = 'error.png'

  1. image(filename) − 使用 Loader 加载图像。将返回带有加载图像的 ProxyImage。

  2. loading_image − 用于加载的图像。例如 −

Loader.loading_image = 'loading.png'

  1. max_upload_per_frame − 每个帧要上传的图像数。默认情况下，我们每帧只上传 2 个图像到 GPU。

  2. num_workers − 加载时要使用的工作进程数。此设置仅在初始化时影响加载器。一旦加载器启动，该设置将不再产生影响。

from kivy.loader import Loader
Loader.num_workers = 4

默认值为 “2”，旨在提供流畅的用户体验。

  1. ProxyImage() - 由 Loader.image() 函数返回的图像

proxyImage = Loader.image("test.jpg")

  1. pause() - 暂停加载器

  2. resume() - 暂停后，恢复加载器

  3. run() - 加载器的主循环

  4. start() - 启动加载器线程/进程

  5. stop() - 停止加载器线程/进程

当图像被加载或改变时，将触发 "on_load" 事件。类似地，当图像无法加载时，将触发 "on_error" 事件。"error: 发生的异常数据"。

Example

在以下给定的代码中，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()

Output

在执行时，它会产生以下输出 −

kivy data loader