5 - 基础控件

|- 5.1-文字 draw_text

语法：控件对象名 = GUI对象.draw_text(x, y, w, text, color, origin, onclick, font_family,font_size,angle)

• 返回值：文字对象
• 输入参数：
  • x : 横坐标
  • y : 纵坐标
  • w : 长度，如果超出长度则自动换行，此参数可省略。
  • text ： 要显示的文字
  • color : 文字颜色
  • origin : 对齐位置，默认左上角
  • onclick : 当被点击时触发的回调函数
  • font_family : 指定字体
  • font_size : 文字大小
  • angle :文字旋转角度

• 用法举例（代码）：

import time
from unihiker import GUI   #导入包
gui=GUI()  #实例化GUI类
def info_text_on_click():
    print("文字被点击")

info_text = gui.draw_text(x=120, y=320, text='你好',origin='bottom' ,onclick=info_text_on_click)

info_text2 = gui.draw_text(x=0, y=100, text='1234567890')
info_text3 = gui.draw_text(x=0, y=150, w=50, text='1234567890')#换行演示

# 加载自己下载的字库文件,输入参数为本地字库文件所在路径
# 字库下载参考网站：https://www.fontspace.com/category/led
#font_family = gui.load_font('Segment7-4Gml.otf') 
#gui.draw_text(x=20, y=80, text='13:11', font_size=40, font_family=font_family) #使用字库显示

while True:
    #增加等待，防止程序退出和卡住
    time.sleep(1)

• 用法举例（图形化）：

unihiker库的画图控件均使用对象方式更新，因此需要给每个控件定一个对象名字，后续使用对象名调整功能。

• 效果截图：

|- 5.2-数码管字体 draw_digit

语法：控件对象名 = GUI对象.draw_digit(x, y, text, color, origin, onclick, font_size)

• 返回值：数码管对象

• 输入参数：

  • x : 横坐标
  • y : 纵坐标
  • text ： 要显示的文字
  • color : 文字颜色
  • origin : 对齐位置，默认左上角
  • onclick : 当被点击时触发的回调函数
  • font_size : 文字大小

• 用法举例：

from unihiker import GUI   #导入包
gui=GUI()  #实例化GUI类

gui.draw_digit(x=120, y=160, text='2022-02-01', origin = "center",color="red",font_size=25)#数码管字体显示

import time
while True:
    #增加等待，防止程序退出和卡住
    time.sleep(1)

自定义字体的方法：[教程]如何使用第三方字库显示点阵风格文字？

|- 5.3-图片 draw_image

语法：控件对象名 = GUI对象.draw_image(x, y, w, h, image,origin,onclick)

• 返回值：图片对象
• 输入参数：
  • x : 横坐标
  • y : 纵坐标
  • w : 图片的宽度。按照长宽最小边等比例缩放，可省略，宽高参数都省略则保持原图分辨率。
  • h : 图片的高度。按照长宽最小边等比例缩放，可省略，宽高参数都省略则保持原图分辨率。
  • image : 图片源，可以传入路径或image对象
  • origin : 对齐位置，默认左上角
  • onclick : 当被点击时触发的回调函数
• 用法举例：

#  -*- coding: UTF-8 -*-
from unihiker import GUI   #导入包
gui=GUI()  #实例化GUI类

# 传入图片文件路径的方式
## 直接传入图片，原始尺寸
img_image2 = gui.draw_image(x=0, y=0, image='logo.png')
## 修改尺寸
img_image = gui.draw_image(x=120, y=100, w=80, h=50,  image='logo.png', origin='center', onclick=lambda: print("image clicked"))

# 使用PIL库传入图片对象的方式
from PIL import Image
img_image3 = gui.draw_image(x=10, y=180, image= Image.open('logo.png'))

import time
while True:
    #增加等待，防止程序退出和卡住
    time.sleep(1)

• 用法举例（图形化）：

  注：需要将图片源拖入项目中的文件处。

|- 5.3-表情 draw_emoji

语法：控件对象名 = GUI对象.draw_emoji(x, y, w, h, emoji,duration,origin,onclick)

• 返回值：表情对象
• 输入参数：
  • x : 横坐标
  • y : 纵坐标
  • w : 表情的宽度。按照长宽最小边等比例缩放，可省略，宽高参数都省略则保持原图分辨率。
  • h : 表情的高度。按照长宽最小边等比例缩放，可省略，宽高参数都省略则保持原图分辨率。
  • emoji : 表情名，可以使用内置表情（Angry,Nerve,Peace,Shock,Sleep,Smile,Sweat,Think,Wink）也可以传入路径表情图片（按照名字-序号.png格式）
  • duration : 图片切换间隔时间
  • origin : 对齐位置，默认左上角
  • onclick : 当被点击时触发的回调函数
• 用法举例：

from unihiker import GUI   #导入包
import time
gui=GUI()  #实例化GUI类

emj1 = gui.draw_emoji(x=0, y=0, w=100, h=100, emoji="Wink", duration=0.1, onclick=lambda:cb("emojis clicked"))
emj2 = gui.draw_emoji(x=120, y=200, w=100, h=100, emoji="Smile", duration=1,origin="center" ,
onclick=lambda:cb("emojis clicked"))
# 传入图片文件路径的方式，同级目录下放多帧图片文件，custom-1.png、custom-2.png、custom-3.png...
# gui.draw_emoji(x=0, y=0, w=100,  emoji="custom", duration=0.2)

while True:
    time.sleep(1) #等待防止程序退出看不到效果

|- 5.4-按钮 add_button

注：按钮控件为特殊控件，一直显示在最顶层。
注：unihiker库中图片及填充矩形也具有onclick事件，因此如需更好看的效果可以使用其他控件实现。
注：按钮的onclick默认传入的是函数名字，不带括号

语法：控件对象名 = GUI对象.add_button(x, y, w, h, text, origin, state,onclick)

• 返回值：按钮对象
• 输入参数：
  • x : 横坐标
  • y : 纵坐标
  • w : 图片的宽度
  • h : 图片的高度
  • text : 按钮上显示的文字
  • origin : 对齐位置，默认左上角
  • state : 按钮使能，设置为 disabled 时按钮无法点击，设置为 normal 则回复到正常可点击状态
  • onclick : 当被点击时触发的回调函数。注意函数中勿执行需要长时间运行的程序，否则会卡住按钮，可以启动一个新的线程来执行需要耗费较长时间的程序。
• 用法举例：

from unihiker import GUI   #导入包
gui=GUI()  #实例化GUI类
gui.add_button(x=120, y=110, w=100, h=30, text="按钮", origin='center', onclick=lambda: print("button clicked"))
gui.add_button(x=120, y=210, w=100, h=30, text="按钮", origin='center', onclick=lambda: print("button clicked"),state="disabled")

import time
while True:
    #增加等待，防止程序退出和卡住
    time.sleep(1)

#多个按钮调用同一个函数并传参示例
from unihiker import GUI   #导入包
gui=GUI()  #实例化GUI类

def btclick(data):
    print(data)
    txt.config(text=str(data))

txt=gui.draw_text(text="0",x=120,y=10,font_size=20,origin="center",color="#0000FF")

gui.add_button(x=120, y=100, w=100, h=30, text="按钮1", origin='center', onclick=lambda: btclick(1))
gui.add_button(x=120, y=150, w=100, h=30, text="按钮2", origin='center', onclick=lambda: btclick(2))
gui.add_button(x=120, y=200, w=100, h=30, text="按钮3", origin='center', onclick=lambda: btclick(3))

import time
while True:
    #增加等待，防止程序退出和卡住
    time.sleep(1)

• 用法举例（图形化）：
  
  

|- 5.5-时钟 draw_clock

语法：控件对象名 = GUI对象.draw_clock(x, y, r, h, m, s, color, onclick)

• 返回值：时钟对象
• 输入参数：
  • x : 横坐标
  • y : 纵坐标
  • r : 半径
  • h : 时
  • m : 分
  • s : 秒
  • color : 边框颜色
  • origin : 对齐位置，默认左上角
  • onclick : 当被点击时触发的回调函数
• 用法举例：

from unihiker import GUI   #导入包
gui=GUI()  #实例化GUI类
gui.draw_clock(x=120, y=160, r=80, h=10, m=8, s=0, color="#f8ad30", onclick=lambda: print("clock clicked"))

import time
while True:
    #增加等待，防止程序退出和卡住
    time.sleep(1)

|- 5.6-填充时钟 fill_clock

语法：控件对象名 = GUI对象.fill_clock(x, y, r, h, m, s, color,fill,style, onclick)

• 返回值：填充时钟对象
• 输入参数：
  • x : 横坐标，默认中心对齐
  • y : 纵坐标
  • r : 半径
  • h : 时
  • m : 分
  • s : 秒
  • color : 边框颜色
  • fill : 填充颜色
  • style : 预设模式，当前仅有两种，dark和light
  • onclick : 当被点击时触发的回调函数
• 用法举例：

from unihiker import GUI   #导入包
gui=GUI()  #实例化GUI类
gui.fill_clock(x=120, y=100, r=60, h=3, m=4, s=5, color=(255, 255, 255), fill="#57b5ff", onclick=lambda: print("clock1 clicked"))
gui.fill_clock(x=120, y=230, r=60, h=6, m=7, s=8, style='dark', onclick=lambda: print("clock2 clicked"))

import time
while True:
    #增加等待，防止程序退出和卡住
    time.sleep(1)

|- 5.7-二维码 draw_qr_code

语法：控件对象名 = GUI对象.draw_qr_code(x, y, w, text, origin, onclick)

• 返回值：二维码对象
• 输入参数：
  • x : 横坐标
  • y : 纵坐标
  • w : 二维码的边长
  • text : 二维码扫描后得到的内容
  • origin : 对齐位置，默认左上角
  • onclick : 当被点击时触发的回调函数
• 用法举例：

from unihiker import GUI   #导入包
gui=GUI()  #实例化GUI类
gui.draw_qr_code(x=100, y=200, w=100, text="https://unihiker.com", origin ="center",onclick=lambda:print("qr clicked"))

import time
while True:
    #增加等待，防止程序退出和卡住
    time.sleep(1)