Kivy 简明教程

Kivy - Atlas

如果你的应用预计要处理很多图像，尤其是在远程服务器上，则需要优化它们的加载时间。Kivy 框架中的 Atlas 有助于减少加载时间。使用 Kivy Atlas，该应用只需要加载一个图像文件，这不会容易出错，并且使用的资源也比加载多个图像要少。Atlas 通常在 Kivy 游戏应用中用于渲染图像。

Atlas 类可在“kivy.atlas”模块中获取。此模块可用于通过编程方式以及通过其命令行界面构建一个 Atlas 对象。

为了能够使用 Atlas，当前 Kivy 环境必须具有 pillow 包 - 一个适用于 Python 的图像库。如果不可用，请使用 - 安装它

pip3 install pillow

一个 Atlas 由两个文件组成 −

  1. 一个 json file （具有“.atlas”扩展名），其中包含图像文件名和图集的纹理位置。

  2. 一个 image files ，其中包含“.atlas”文件引用的纹理。

假设以下图像位于名为 imges 的目录中 −

目录 C:\kivyenv\images

forward.png    pause.png    play.png    previous.png

这些图像每个都为 64×64 像素大小。因此，我们指定一个 256×256 像素大小的图集文件来容纳所有这四个文件。打开你的操作系统的命令终端并运行命令 −

python -m kivy.atlas myatlas 256x256 *.png

终端显示了以下日志信息，在日志末尾，会在 images 文件夹中创建两个文件。

(kivyenv) C:\kivyenv\images>python -m kivy.atlas myatlas 256x256 *.png
[INFO  ] [Logger   ] Record log in C:\Users\mlath\.kivy\logs\kivy_23-07-20_33.txt
[INFO  ] [deps     ] Successfully imported "kivy_deps.gstreamer" 0.3.3
[INFO  ] [deps     ] Successfully imported "kivy_deps.angle" 0.3.3
[INFO  ] [deps     ] Successfully imported "kivy_deps.glew" 0.3.1
[INFO  ] [deps     ] Successfully imported "kivy_deps.sdl2" 0.6.0
[INFO  ] [Kivy     ] v2.2.0
[INFO  ] [Kivy     ] Installed at "c:\kivyenv\Lib\sitepackages\kivy\__init__.py"
[INFO  ] [Python   ] v3.11.2 (tags/v3.11.2:878ead1, Feb 7 2023, 16:38:35) [MSC v.1934 64 bit (AMD64)]
[INFO  ] [Python   ] Interpreter at "c:\kivyenv\Scripts\python.exe"
[INFO  ] [Logger   ] Purge log fired. Processing...
[INFO  ] [Logger   ] Purge finished!
[DEBUG ] STREAM b'IHDR' 16 13
[DEBUG ] STREAM b'sRGB' 41 1
[DEBUG ] STREAM b'gAMA' 54 4
[DEBUG ] STREAM b'pHYs' 70 9
[DEBUG ] STREAM b'IDAT' 91 1115
[DEBUG ] STREAM b'IHDR' 16 13
[DEBUG ] STREAM b'sRGB' 41 1
[DEBUG ] STREAM b'gAMA' 54 4
[DEBUG ] STREAM b'pHYs' 70 9
[DEBUG ] STREAM b'IDAT' 91 990
[DEBUG ] STREAM b'IHDR' 16 13
[DEBUG ] STREAM b'sRGB' 41 1
[DEBUG ] STREAM b'gAMA' 54 4
[DEBUG ] STREAM b'pHYs' 70 9
[DEBUG ] STREAM b'IDAT' 91 1230
[INFO  ] [Atlas   ] create an 256x256 rgba image
Atlas created at myatlas.atlas
1 image has been created

你可以看到创建了两个附加文件 myatlas-0.png，它是一个 256×256 的文件，包含所有图像以及一个 atlas 文件。

forward.png    myatlas-0.png    myatlas.atlas    pause.png
play.png
previous.png

“.atlas” 文件是一个 JSON 文件，其中包含组成文件的纹理位置的信息。

{"myatlas-0.png": {"forward": [2, 190, 64, 64], "pause": [68, 190, 64, 64], "play": [134, 190, 64, 64], "previous": [2, 124, 64, 64]}}

为了在 Kivy 语言中使用 Atlas，我们必须使用以下格式 −

atlas://path/to/atlas/atlas_name/id.

“id” 文件引用没有扩展名的图像文件名。

例如，如果你想将一个图像文件用作按钮在正常状态下的背景，你可以按如下方式操作 −

B1 = Button(background_normal='images/play.png')
Now, aAfter generating the Atlas, you can use the URL
'atlas://images/myatlas/play' as the value.
B1=Button(background_normal='atlas://images/myatlas/play')

请注意，在 atlas URL 中，无需添加 .atlas 扩展名。它将自动附加到文件名中。

Example

让我们从 Atlas 中获取图像 URL，为应用窗口上的四个按钮（播放、暂停、前进和后退）设置正常背景。

在运行以下代码之前，必须按上述方式创建 atlas 文件 −

from kivy.app import App
from kivy.graphics import *
from kivy.uix.floatlayout import FloatLayout
from kivy.uix.gridlayout import GridLayout
from kivy.uix.button import Button
from kivy.uix.label import Label
from kivy.core.window import Window
Window.size = (720, 400)

class AtlasApp(App):
   def build(self):
      main = GridLayout(cols=1)
      self.l1 = Label(text='Using Atlas', font_size=32)
      main.add_widget(self.l1)
      root = FloatLayout(size=(Window.width, 100))
      with root.canvas:
         Color(.2, .7, .1, 1)
         Rectangle(pos=root.pos, size=root.size)

      self.btn1 = Button(
         size_hint=(None, None),
         pos_hint={'center_x': .2, 'center_y': .2}
      )
      self.btn2 = Button(
         size_hint=(None, None),
         pos_hint={'center_x': .4, 'center_y': .2}
      )

      self.btn3 = Button(
         size_hint=(None, None),
         pos_hint={'center_x': .6, 'center_y': .2}
      )

      self.btn4 = Button(
         size_hint=(None, None),
         pos_hint={'center_x': .8, 'center_y': .2}
      )
      self.btn1.background_normal = 'atlas://images/myatlas/forward'
      self.btn2.background_normal = 'atlas://images/myatlas/play'
      self.btn3.background_normal = 'atlas://images/myatlas/pause'
      self.btn4.background_normal = 'atlas://images/myatlas/previous'

      root.add_widget(self.btn1)
      root.add_widget(self.btn2)
      root.add_widget(self.btn3)
      root.add_widget(self.btn4)

      main.add_widget(root)
      return main
AtlasApp().run()

Output

当你运行此代码时，它将生成以下输出窗口 −

kivy atlas