Kivy - Utils
Kivy 库中的"kivy.utils"模块是各种类别的通用实用函数的集合，例如数学、颜色、代数函数等。
QueryDict
QueryDict 类的对象类似于 Python 的内置 dict 类。此外，它还提供了使用点 ( . ) 运算符查询对象的功能。
要构造 QueryDict，您可以传递两个元素元组的列表，也可以传递 dict 对象本身。
# 元组列表
qd = QueryDict([('a',1), ('b',2)])
print (qd)
列表的每个元组元素都应该有两个项目。第一项是键，第二项是其值。
{'a': 1, 'b': 2}
另一方面，您可以将 dict 对象本身传递给 QueryDict 构造函数。
qd=QueryDict({'a':1, 'b':2})
虽然可以使用标准 dict 中定义的 [] 运算符获取属于某个键的值，但 QueryDict 提供了一个点运算符。因此，"qd.k"与"qd['k']"相同。请注意，dict 类的 get() 方法也可以与 QueryDict 一起使用。
您可以使用常规切片运算符赋值或点运算符来更新键的值。
qd.a=100 qd['b']=200
尝试下面的示例 −
from kivy.utils import *
# list of tuples
qd=QueryDict([('a',1), ('b',2)])
print (qd)
print (qd.a, qd['a'])
qd=QueryDict({'a':1, 'b':2})
print (qd)
print (qd.b, qd['b'])
print (qd.get('a'))
qd.a=100
qd['b']=200
print (qd)
SafeList
Kivy 中的 SafeList 类继承了内置的 list 类。除了从 list 继承的方法之外，SafeList 类中还定义了一个新方法 − clear()。它会删除列表中的所有项目。
您可以将可变序列（列表）传递给构造函数以创建 SafeList 对象。如果没有传递参数，它将创建一个空列表。调用 clear() 方法将删除所有项目。
示例
from kivy.utils import *
sl = SafeList([1,2,3,4])
print ("SafeList:",sl)
l = [1,2,3,4]
sl = SafeList(l)
print ("SafeList:",sl)
sl.clear()
print ("SafeList:",sl)
输出
SafeList: [1, 2, 3, 4] SafeList: [1, 2, 3, 4] SafeList: []
difference()
此函数返回两个列表之间的差异。更具体地说，它从第一个列表中删除在第二个列表中找到的那些项目。
示例
from kivy.utils import *
l1=[1,2,3,4]
l2=[3,4,5,6]
print (l1, l2)
print ("l1-l2:",difference(l1,l2))
print ("l2-l1:",difference(l2,l1))
输出
[1, 2, 3, 4] [3, 4, 5, 6] l1-l2: [1, 2] l2-l1: [5, 6]
escape_markup()
Kivy 应用窗口上的标签能够显示标记文本。但是，如果您希望标记符号的效果不生效，则可以转义文本中的标记字符。这旨在用于 当标签上激活标记文本时。
在下面的示例中，要在标签上显示的文本包含 [b] 和 [/b] 标记标签，这会将测试转换为粗体。但是，为了忽略此效果，文本将传递给 escape_markup() 函数。
示例
from kivy.app import App
from kivy.uix.label import Label
from kivy.utils import escape_markup
from kivy.core.window import Window
Window.size = (720,400)
class HelloApp(App):
def build(self):
text = 'This is an [b]important[/b] message'
text = '[color=ff0000]' + escape_markup(text) + '[/color]'
lbl=Label(text=text, font_size=40, markup=True)
return lbl
HelloApp().run()
输出
get_color_from_hex()
将十六进制字符串颜色转换为 kivy 颜色。颜色属性的 RGBA 值介于 0 到 1 之间。由于 RGB 值的范围是 0 到 255，因此 Kivy 颜色值将该数字除以 255。因此 RGB 值 50、100、200 分别表示为 50/255、100/255 和 200/255。
十六进制颜色值以字符串形式给出，每个 RGB 包含 2 个十六进制数字，并以"#"符号为前缀。get_color_from_hex() 函数将十六进制字符串转换为 Kivy 颜色值。
示例
from kivy.utils import *
c = get_color_from_hex("#00ff00")
print (c)
输出
[0.0, 1.0, 0.0, 1.0]
get_hex_from_color(color)
将 kivy 颜色转换为十六进制值 −
示例
from kivy.utils import * c = get_hex_from_color([0,1,0,1]) print (c)
输出
#00ff00ff
rgba()
从十六进制字符串或 0-255 值列表中返回 Kivy 颜色（0-1 范围内的 4 个值）。
示例
from kivy.utils import *
# 来自 RGBA 颜色值
c = rgba([100,150,200, 255])
print ("from RGBA:",c)
# 来自十六进制字符串
c = rgba('#3fc4e57f')
print ("from hex string:",c)
输出
from RGBA: [0.39215686274509803, 0.5882352941176471, 0.7843137254901961, 1.0] from hex string: [0.24705882352941178, 0.7686274509803922, 0.8980392156862745, 0.4980392156862745]
