Rust图形绘制库box_drawing使用指南

简介

box_drawing是一个轻量级的Rust库，专门用于在终端中创建ASCII图表和框线图形。它提供了一系列工具和预定义的字符，可以方便地绘制各种框线、表格和简单的图形界面。

主要特性

• 提供完整的Box Drawing Unicode字符集支持
• 轻量级，无额外依赖
• 支持组合不同线条样式创建复杂图形
• 适用于终端UI、图表展示等场景

安装

在Cargo.toml中添加依赖：

[dependencies]
box_drawing = "0.1"

基本用法

1. 使用预定义字符

use box_drawing::light;

fn main() {
    println!("{}", light::DOWN_RIGHT);  // ┌
    println!("{}", light::HORIZONTAL);  // ─
    println!("{}", light::DOWN_LEFT);   // ┐
    println!("{}", light::VERTICAL);    // │
    println!("{}", light::UP_RIGHT);    // └
    println!("{}", light::UP_LEFT);     // ┘
}

2. 绘制简单方框

use box_drawing::light;

fn draw_box(width: usize, height: usize) {
    // 上边框
    println!("{}{}{}", 
        light::DOWN_RIGHT,
        light::HORIZONTAL.to_string().repeat(width - 2),
        light::DOWN_LEFT);
    
    // 中间部分
    for _ in 0..height - 2 {
        println!("{}{}{}",
            light::VERTICAL,
            " ".repeat(width - 2),
            light::VERTICAL);
    }
    
    // 下边框
    println!("{}{}{}",
        light::UP_RIGHT,
        light::HORIZONTAL.to_string().repeat(width - 2),
        light::UP_LEFT);
}

fn main() {
    draw_box(20, 10);
}

3. 绘制表格

use box_drawing::light;

fn draw_table(rows: usize, cols: usize, cell_width: usize) {
    // 绘制顶部边框
    print!("{}", light::DOWN_RIGHT);
    for c in 0..cols {
        print!("{}", light::HORIZONTAL.to_string().repeat(cell_width));
        if c < cols - 1 {
            print!("{}", light::DOWN_HORIZONTAL);
        }
    }
    println!("{}", light::DOWN_LEFT);
    
    // 绘制行
    for r in 0..rows {
        // 内容行
        print!("{}", light::VERTICAL);
        for _ in 0..cols {
            print!("{:^width$}", "Content", width = cell_width);
            print!("{}", light::VERTICAL);
        }
        println!();
        
        // 分隔行（非最后一行）
        if r < rows - 1 {
            print!("{}", light::VERTICAL_RIGHT);
            for c in 0..cols {
                print!("{}", light::HORIZONTAL.to_string().repeat(cell_width));
                if c < cols - 1 {
                    print!("{}", light::VERTICAL_HORIZONTAL);
                }
            }
            println!("{}", light::VERTICAL_LEFT);
        }
    }
    
    // 绘制底部边框
    print!("{}", light::UP_RIGHT);
    for c in 0..cols {
        print!("{}", light::HORIZONTAL.to_string().repeat(cell_width));
        if c < cols - 1 {
            print!("{}", light::UP_HORIZONTAL);
        }
    }
    println!("{}", light::UP_LEFT);
}

fn main() {
    draw_table(3, 4, 10);
}

高级用法

1. 混合不同线条样式

use box_drawing::{light, double};

fn mixed_box() {
    // 顶部使用双线，侧面使用单线
    println!("{}{}{}", 
        double::DOWN_RIGHT,
        double::HORIZONTAL.to_string().repeat(10),
        double::DOWN_LEFT);
    
    for _ in 0..5 {
        println!("{}{}{}",
            light::VERTICAL,
            " ".repeat(10),
            light::VERTICAL);
    }
    
    println!("{}{}{}",
        light::UP_RIGHT,
        light::HORIZONTAL.to_string().repeat(10),
        light::UP_LEFT);
}

2. 创建连接点

use box_drawing::light;

fn draw_intersection() {
    let horizontal = light::HORIZONTAL.to_string().repeat(5);
    let vertical = format!("\n{}     {}\n", light::VERTICAL, light::VERTICAL);
    
    println!("   {}", horizontal);
    println!("   {}", light::VERTICAL);
    println!("{}{}{}{}", 
        horizontal, 
        light::VERTICAL_HORIZONTAL, 
        horizontal, 
        light::VERTICAL);
    println!("   {}", light::VERTICAL);
    println!("   {}", horizontal);
}

完整示例

下面是一个完整的终端菜单界面示例，结合了方框、表格和连接点：

use box_drawing::{light, double};

fn main() {
    // 绘制主标题框
    draw_title_box("Rust终端菜单系统", 40);
    
    // 绘制主菜单选项
    draw_menu_options();
    
    // 绘制底部状态栏
    draw_status_bar("按q退出 | 按↑↓选择选项");
}

fn draw_title_box(title: &str, width: usize) {
    // 使用双线绘制标题框
    println!("{}", double::DOWN_RIGHT);
    println!("{}", double::HORIZONTAL.to_string().repeat(width));
    println!("{}", double::DOWN_LEFT);
    
    // 标题居中显示
    println!("{}{:^width$}{}", 
        double::VERTICAL, 
        title, 
        double::VERTICAL,
        width = width - 2);
    
    // 底部边框
    println!("{}", double::UP_RIGHT);
    println!("{}", double::HORIZONTAL.to_string().repeat(width));
    println!("{}", double::UP_LEFT);
}

fn draw_menu_options() {
    // 菜单选项
    let options = vec![
        "1. 用户管理",
        "2. 系统设置",
        "3. 数据统计",
        "4. 帮助文档"
    ];
    
    // 绘制菜单表格
    println!();
    println!("{}", light::DOWN_RIGHT);
    println!("{}", light::HORIZONTAL.to_string().repeat(30));
    println!("{}", light::DOWN_LEFT);
    
    for (i, option) in options.iter().enumerate() {
        println!("{} {:2} {}", light::VERTICAL, i+1, option);
        if i < options.len() - 1 {
            // 绘制分隔线
            println!("{}", light::VERTICAL_RIGHT);
            println!("{}", light::HORIZONTAL.to_string().repeat(30));
            println!("{}", light::VERTICAL_LEFT);
        }
    }
    
    println!("{}", light::UP_RIGHT);
    println!("{}", light::HORIZONTAL.to_string().repeat(30));
    println!("{}", light::UP_LEFT);
}

fn draw_status_bar(message: &str) {
    // 绘制底部状态栏
    println!();
    println!("{}", light::DOWN_RIGHT);
    println!("{}", light::HORIZONTAL.to_string().repeat(message.len() + 4));
    println!("{}", light::DOWN_LEFT);
    
    println!("{} {} {}", 
        light::VERTICAL, 
        message, 
        light::VERTICAL);
    
    println!("{}", light::UP_RIGHT);
    println!("{}", light::HORIZONTAL.to_string().repeat(message.len() + 4));
    println!("{}", light::UP_LEFT);
}

注意事项

1. 确保终端使用的字体支持Box Drawing字符
2. 不同终端可能对Unicode字符的渲染有细微差异
3. 对于复杂图形，建议先规划好布局再编码

box_drawing库虽然简单，但结合适当的算法可以创建出各种有用的终端图形界面。