Asciimatics项目基础输入输出指南

Asciimatics项目基础输入输出指南

asciimatics A cross platform package to do curses-like operations, plus higher level APIs and widgets to create text UIs and ASCII art animations 项目地址: https://gitcode.com/gh_mirrors/as/asciimatics

前言

Asciimatics是一个用于创建全屏文本用户界面(TUI)和动画的Python库。本文将详细介绍该库的基础输入输出功能，帮助开发者快速掌握其核心用法。

屏幕创建与管理

基础屏幕创建

在Asciimatics中，所有程序的起点都是Screen对象。最简便的创建方式是通过wrapper静态方法：

from asciimatics.screen import Screen
from time import sleep

def demo(screen):
    screen.print_at('Hello world!', 0, 0)
    screen.refresh()
    sleep(10)

Screen.wrapper(demo)

这种方法会自动处理环境初始化，并将构建好的Screen对象传递给指定函数。

使用ManagedScreen

ManagedScreen类提供了更灵活的屏幕管理方式，可以作为函数装饰器使用：

from asciimatics.screen import ManagedScreen

@ManagedScreen
def demo(screen=None):
    screen.print_at('Hello world!', 0, 0)
    screen.refresh()
    sleep(10)

demo()

或者作为上下文管理器：

def demo():
    with ManagedScreen() as screen:
        screen.print_at('Hello world!', 0, 0)
        screen.refresh()
        sleep(10)

demo()

文本输出

基础输出

创建Screen后，通常需要先清屏：

screen.clear()

然后使用print_at方法输出文本：

screen.print_at('Hello world!', 0, 0)

坐标系统从屏幕左上角(0,0)开始，向右和向下递增。

颜色设置

Asciimatics支持最多256色的调色板。基础8色定义如下：

COLOUR_BLACK = 0
COLOUR_RED = 1
COLOUR_GREEN = 2
COLOUR_YELLOW = 3
COLOUR_BLUE = 4
COLOUR_MAGENTA = 5
COLOUR_CYAN = 6
COLOUR_WHITE = 7

使用示例：

screen.print_at('Hello world!', 0, 0, COLOUR_GREEN)

文本属性

支持以下文本属性：

A_BOLD = 1      # 加粗/高亮
A_NORMAL = 2    # 正常
A_REVERSE = 3   # 反色
A_UNDERLINE = 4 # 下划线

使用示例：

screen.print_at('Hello world!', 0, 0, COLOUR_GREEN, A_BOLD)

多色文本

对于复杂的多色文本，可以使用paint方法：

# 为每个字符指定颜色和属性
color_map = [(COLOUR_RED, A_BOLD), (COLOUR_GREEN, A_NORMAL), ...]
screen.paint("多彩文本", x, y, color_map)

Unicode支持

Asciimatics支持Unicode输入输出：

screen.print_at(u'☎ Call me!', 0, 0, COLOUR_GREEN, A_BOLD)

屏幕刷新

所有输出操作都会先写入缓冲区，需要调用refresh方法才会实际显示：

screen.refresh()

用户输入处理

获取输入事件

使用get_event方法获取用户输入：

event = screen.get_event()
if event:
    # 处理事件

键盘事件

键盘事件包含key_code属性，表示按键的ASCII码或扩展键码：

if isinstance(event, KeyboardEvent):
    if event.key_code == ord('a'):
        print("按下了a键")
    elif event.key_code == KEY_F7:
        print("按下了F7键")

鼠标事件

鼠标事件包含坐标和按钮信息：

if isinstance(event, MouseEvent):
    print(f"鼠标点击位置: ({event.x}, {event.y})")
    if event.buttons & LEFT_CLICK:
        print("左键点击")

屏幕操作

屏幕尺寸变化

检测屏幕尺寸变化：

if screen.has_resized():
    print("屏幕尺寸已改变")

屏幕抓取

获取屏幕上特定位置的字符：

char, fg, attr, bg = screen.get_from(x, y)

图形绘制

线条绘制

screen.move(0, 0)  # 移动到起点
screen.draw(10, 10)  # 绘制到终点

多边形填充

# 绘制带孔的多边形
screen.fill_polygon([
    [(60,0), (70,0), (70,10), (60,10)],  # 外框
    [(63,2), (67,2), (67,8), (63,8)]     # 内孔
])

总结

本文详细介绍了Asciimatics库的基础输入输出功能，包括屏幕创建、文本输出、颜色控制、用户输入处理和简单图形绘制等核心功能。掌握这些基础知识后，开发者可以进一步探索该库更高级的动画和特效功能。

asciimatics A cross platform package to do curses-like operations, plus higher level APIs and widgets to create text UIs and ASCII art animations 项目地址: https://gitcode.com/gh_mirrors/as/asciimatics