跳到主要内容
版本：最新版 🚧

UI4pxNumber

概述​

UI4pxNumber 组件使用4像素高的字体在LED矩阵上显示数字。它非常适合以紧凑格式显示数值、分数、计时器和其他定量信息。

UI4pxNumber 组件实现位于 Applications/Python/PikaPython/MatrixOS_UI4pxNumber.py，类型提示位于 Applications/Python/PikaPython/_MatrixOS_UI4pxNumber.pyi。

构造函数​

MatrixOS.UI4pxNumber()​

class UI4pxNumber(UIComponent):
    def __init__(self) -> None

创建一个新的4像素数字显示组件。

示例：

number_display = UI4pxNumber()

配置方法​

SetName​

def SetName(self, name: str) -> bool

设置数字显示的名称或标签。

参数：

  • name (str)：显示名称或标签

返回值：

  • bool：成功时返回True

SetColor​

def SetColor(self, color: Color) -> bool

设置数字显示的主颜色。

参数：

  • color (Color)：主显示颜色

返回值：

  • bool：成功时返回True

SetAlternativeColor​

def SetAlternativeColor(self, alternativeColor: Color) -> bool

为特殊状态或高亮显示设置替代颜色。

参数：

  • alternativeColor (Color)：替代颜色

返回值：

  • bool：成功时返回True

SetDigits​

def SetDigits(self, digits: int) -> bool

设置要显示的数字位数。

参数：

  • digits (int)：数字位数（通常为1-4）

返回值：

  • bool：成功时返回True

SetSpacing​

def SetSpacing(self, spacing: int) -> bool

设置数字间的间距。

参数：

  • spacing (int)：数字间的像素间距

返回值：

  • bool：成功时返回True

值和颜色函数​

SetValueFunc​

def SetValueFunc(self, getValueFunc: any) -> bool

设置一个函数来动态获取当前要显示的值。

参数：

  • getValueFunc (function)：返回当前值的函数

返回值：

  • bool：成功时返回True

SetColorFunc​

def SetColorFunc(self, colorFunc: any) -> bool

设置一个函数来动态确定显示颜色。

参数：

  • colorFunc (function)：返回当前颜色的函数

返回值：

  • bool：成功时返回True

使用示例​

基本分数显示​

def create_score_display():
    """创建一个简单的分数显示"""

    score = 0
    score_display = UI4pxNumber()

    # 配置显示
    score_display.SetName("分数")
    score_display.SetColor(Color(0, 255, 0))  # 绿色
    score_display.SetDigits(4)
    score_display.SetSpacing(1)

    # 设置值函数
    def get_score():
        return score

    score_display.SetValueFunc(get_score)

    # 添加到UI
    ui = UI()
    ui.AddUIComponent(score_display, Point(2, 2))

    return ui, score_display

# 游戏循环示例
ui, score_display = create_score_display()
score = 0

while True:
    # 这里是游戏逻辑
    score += 10  # 示例分数增加

    # UI会自动更新显示
    MatrixOS.SYS.DelayMs(1000)

动态颜色计时器​

def create_countdown_timer():
    """创建一个带有颜色编码紧急度的倒计时计时器"""

    timer_seconds = 60
    timer_display = UI4pxNumber()

    timer_display.SetName("计时器")
    timer_display.SetDigits(2)
    timer_display.SetSpacing(1)

    # 动态值函数
    def get_timer_value():
        return max(0, timer_seconds)

    # 动态颜色函数
    def get_timer_color():
        if timer_seconds > 30:
            return Color(0, 255, 0)    # 绿色 - 时间充足
        elif timer_seconds > 10:
            return Color(255, 255, 0)  # 黄色 - 时间不多
        else:
            return Color(255, 0, 0)    # 红色 - 紧急

    timer_display.SetValueFunc(get_timer_value)
    timer_display.SetColorFunc(get_timer_color)

    ui = UI()
    ui.AddUIComponent(timer_display, Point(3, 2))

    # Timer countdown loop
    def run_timer():
        nonlocal timer_seconds
        while timer_seconds > 0:
            MatrixOS.SYS.DelayMs(1000)
            timer_seconds -= 1

        print("Timer finished!")

    return ui, run_timer

ui, timer_func = create_countdown_timer()
ui.Start()
timer_func()

Multi-Parameter Dashboard​

def create_system_dashboard():
    """Create a dashboard with multiple numeric displays"""

    # System values
    system_values = {
        "temperature": 25,
        "battery": 85,
        "memory": 67,
        "cpu": 45
    }

    displays = {}
    ui = UI()

    # Temperature display (top-left)
    temp_display = UI4pxNumber()
    temp_display.SetName("Temp")
    temp_display.SetDigits(2)
    temp_display.SetValueFunc(lambda: system_values["temperature"])
    temp_display.SetColorFunc(lambda: Color(255, 0, 0) if system_values["temperature"] > 30
                                   else Color(0, 255, 0))
    ui.AddUIComponent(temp_display, Point(0, 0))
    displays["temperature"] = temp_display

    # Battery display (top-right)
    battery_display = UI4pxNumber()
    battery_display.SetName("Batt")
    battery_display.SetDigits(2)
    battery_display.SetValueFunc(lambda: system_values["battery"])
    battery_display.SetColorFunc(lambda: Color(255, 0, 0) if system_values["battery"] < 20
                                      else Color(255, 255, 0) if system_values["battery"] < 50
                                      else Color(0, 255, 0))
    ui.AddUIComponent(battery_display, Point(4, 0))
    displays["battery"] = battery_display

    # Memory display (bottom-left)
    memory_display = UI4pxNumber()
    memory_display.SetName("Mem")
    memory_display.SetDigits(2)
    memory_display.SetColor(Color(0, 255, 255))
    memory_display.SetValueFunc(lambda: system_values["memory"])
    ui.AddUIComponent(memory_display, Point(0, 4))
    displays["memory"] = memory_display

    # CPU display (bottom-right)
    cpu_display = UI4pxNumber()
    cpu_display.SetName("CPU")
    cpu_display.SetDigits(2)
    cpu_display.SetColor(Color(255, 0, 255))
    cpu_display.SetValueFunc(lambda: system_values["cpu"])
    ui.AddUIComponent(cpu_display, Point(4, 4))
    displays["cpu"] = cpu_display

    return ui, system_values, displays

# Simulation of changing values
def simulate_system_monitoring():
    ui, values, displays = create_system_dashboard()
    ui.Start()

    import random

    for _ in range(100):  # Run for 100 cycles
        # Simulate changing system values
        values["temperature"] = random.randint(20, 35)
        values["battery"] = max(0, values["battery"] - random.randint(0, 2))
        values["memory"] = random.randint(50, 90)
        values["cpu"] = random.randint(30, 80)

        MatrixOS.SYS.DelayMs(2000)  # Update every 2 seconds

simulate_system_monitoring()

Music BPM Display​

def create_bpm_display():
    """Create a BPM display for music applications"""

    current_bpm = 120
    bpm_display = UI4pxNumber()

    bpm_display.SetName("BPM")
    bpm_display.SetDigits(3)
    bpm_display.SetSpacing(1)

    # BPM value function
    def get_bpm():
        return current_bpm

    # Color based on BPM range
    def get_bpm_color():
        if current_bpm < 80:
            return Color(0, 0, 255)    # Blue - slow
        elif current_bpm < 120:
            return Color(0, 255, 0)    # Green - moderate
        elif current_bpm < 160:
            return Color(255, 255, 0)  # Yellow - fast
        else:
            return Color(255, 0, 0)    # Red - very fast

    bpm_display.SetValueFunc(get_bpm)
    bpm_display.SetColorFunc(get_bpm_color)

    ui = UI()
    ui.AddUIComponent(bpm_display, Point(2, 2))

    # BPM control functions
    def increase_bpm():
        nonlocal current_bpm
        current_bpm = min(200, current_bpm + 5)

    def decrease_bpm():
        nonlocal current_bpm
        current_bpm = max(60, current_bpm - 5)

    return ui, increase_bpm, decrease_bpm

ui, inc_bpm, dec_bpm = create_bpm_display()

Game Health/Lives Display​

def create_game_hud():
    """Create a game HUD with health and lives"""

    game_state = {
        "health": 100,
        "lives": 3,
        "level": 1,
        "score": 0
    }

    ui = UI()

    # Health display
    health_display = UI4pxNumber()
    health_display.SetName("HP")
    health_display.SetDigits(3)
    health_display.SetValueFunc(lambda: game_state["health"])
    health_display.SetColorFunc(lambda: Color(255, 0, 0) if game_state["health"] < 25
                                     else Color(255, 255, 0) if game_state["health"] < 50
                                     else Color(0, 255, 0))
    ui.AddUIComponent(health_display, Point(0, 0))

    # Lives display
    lives_display = UI4pxNumber()
    lives_display.SetName("Lives")
    lives_display.SetDigits(1)
    lives_display.SetColor(Color(255, 100, 0))
    lives_display.SetValueFunc(lambda: game_state["lives"])
    ui.AddUIComponent(lives_display, Point(6, 0))

    # Level display
    level_display = UI4pxNumber()
    level_display.SetName("Lv")
    level_display.SetDigits(2)
    level_display.SetColor(Color(0, 255, 255))
    level_display.SetValueFunc(lambda: game_state["level"])
    ui.AddUIComponent(level_display, Point(0, 6))

    # Score display
    score_display = UI4pxNumber()
    score_display.SetName("Score")
    score_display.SetDigits(4)
    score_display.SetColor(Color(255, 255, 255))
    score_display.SetValueFunc(lambda: game_state["score"])
    ui.AddUIComponent(score_display, Point(3, 6))

    return ui, game_state

ui, game_data = create_game_hud()
ui.Start()

# Game simulation
while game_data["lives"] > 0:
    # Game logic simulation
    game_data["score"] += 50
    game_data["health"] = max(0, game_data["health"] - 5)

    if game_data["health"] == 0:
        game_data["lives"] -= 1
        game_data["health"] = 100

    MatrixOS.SYS.DelayMs(1000)

Comments