Kivy - 散点图控件

Kivy 中的 Scatter 控件对于多点触控设备特别有用，它用于旋转和缩放应用程序窗口的内容。

Scatter 控件通过在绘制子控件之前更改模型视图矩阵来执行矩阵变换，并在绘制完成后恢复之前的矩阵，以便可以在整个子控件树上执行旋转、缩放和平移，而无需更改任何控件属性。

默认情况下，Scatter 控件没有图形表示：它只是一个容器。其他控件添加到 scatter 对象中。但是，需要注意的是，Scatter 控件不是布局。您必须自己管理子控件的大小。它们相对于 scatter 定位，类似于 RelativeLayout。这就是为什么拖动 scatter 不会改变子控件的位置，只有 scatter 的位置才会改变。scatter 的大小不会影响其子控件的大小。

Scatter 类定义在“kivy.uix.scatter”模块中。Scatter 控件的基本用法如下：

from kivy.uix.scatter import Scatter
scatter=Scatter.add_widget(Image(source='logo.jpg'))

Scatter 对象创建时默认启用所有交互。但是，您可能希望自定义交互，为此需要相应地定义 Scatter 对象的属性。

• auto_bring_to_front - 如果为 True，则该控件将在绘制时自动推到父控件列表的顶部。

• do_rotation - 允许旋转。默认情况下，此属性为 True。

• do_scale - 允许缩放。默认为 True。

• do_translation - 允许在 X 或 Y 轴上平移。

• scale - scatter 的缩放值。scale 是一个 AliasProperty，默认为 1.0。

• scale_max - 允许的最大缩放因子。允许的最大缩放因子的默认值为 1e20。

• scale_min - 允许的最小缩放因子，默认值为 0.01

示例 1

这是一个关于 Scatter 控件如何工作的简单示例。我们只是在 Kivy 应用中的 Scatter 控件中添加了一个标签。应用程序启动时，标签文本出现在应用程序窗口的左下角。使用鼠标将其拖动到窗口表面的任何位置。

要在普通桌面上模拟多点触控操作，请通过鼠标右键单击在标签区域创建两个标记，然后您可以通过拖动这两个标记来放大或旋转标签。

如果您正在使用多点触控设备，则可以通过双指触控执行缩放和旋转。

from kivy.app import App
from kivy.uix.label import Label
from kivy.uix.scatter import Scatter
from kivy.uix.boxlayout import BoxLayout
from kivy.uix.textinput import TextInput
from kivy.core.window import Window

Window.size = (720,350)

class scatterdemoapp(App):
   def build(self):
      box=BoxLayout(orientation='vertical')
      scatr=Scatter()
      lbl=Label(text="Hello", font_size=60)
      scatr.add_widget(lbl)
      box.add_widget(scatr)
      return box

scatterdemoapp().run()

输出

让我们检查一下输出是什么样的：

示例 2

或者，也可以使用“kv”语言脚本构建相同的界面。

BoxLayout:
   orientation:'vertical'
   Scatter:
      Label:
         text:"Hello"
         font_size:60

让我们为上面的示例添加更多交互性。在这里，我们在 Scatter 控件上方的垂直箱式布局中添加了一个文本输入框。

“text”属性绑定到标签的 text 属性。因此，当您在文本框中添加/删除字母时，标签文本会更新。仍然可以执行所有 scatter 操作，例如旋转和缩放。

from kivy.app import App
from kivy.uix.label import Label
from kivy.uix.scatter import Scatter
from kivy.uix.boxlayout import BoxLayout
from kivy.uix.textinput import TextInput
from kivy.core.window import Window

Window.size = (720,300)

class scatterdemoapp(App):
   def build(self):
      box = BoxLayout(orientation='vertical')
      text1 = TextInput(
         text='Hello World', height=100,
         size_hint=(Window.width, None)
      )
      box.add_widget(text1)
      scatr = Scatter()
      self.lbl = Label(text="Hello", font_size=60)
   
      text1.bind(text=self.lbl.setter('text'))
      scatr.add_widget(self.lbl)
      box.add_widget(scatr)
      return box
   
scatterdemoapp().run()

输出

现在让我们检查一下输出窗口是什么样的：