ANSI 终端输出瞎搞指北

Author: Kurisu Amatist

前言

最早由 一篇游玩性质的 gist 文章 利用 ANSI 转义序列 玩出不一样的 stdout, 引起了对 ANSI 转义序列 之类的兴趣. 后因为需要使用 Go 实现 终端清屏 的小功能, 在尝试了使用 clear 命令后, 发现使用 \x1b[2J 也可以实现清屏终端, 故便对此深挖.

下文介绍的主要是基于 ANSI 的转义序列, 可能会和 VT102 等模式有细微不同. 目前(2019)的类 Unix 系统对于各种标准皆有实现, 可不必担心.

下文中的 ANSI 皆代表 ANSI 转义序列 , 防止与 ANSI (美国国家标准协会) 弄混.

来自 Ubuntu 的 man 手册

The Linux console implements a large subset of the VT102 and ECMA-48 or ISO 6429 or ANSI X3.64 terminal controls, plus certain private-mode sequences for changing the color palette, character-set mapping, and so on

via: http://manpages.ubuntu.com/manpages/bionic/en/man4/console_codes.4.html

#### 注释

• ECMA-48 是 ANSI 系列的第一个标准
• // 1976 通过
• AESC (美国国家标准学会, 1969 更名为 ANSI, 为防止弄混, 此处称为 AESC) 采用 ECMA-48 作为 ANSI X3.64
• // 1979
• 由 AESC X3L2(ANSI X3L2) 委员会 和 ECMA TC 1 委员会 将两份几乎一样的标准, 合并为 ISO 6429 国际标准
• // 1992
• AESC (ANSI) 取消了其标准, 以支持 ISO 6429 国际标准
• // 1994

ANSI 和 ASCII

首先介绍 ANSI 和 ASCII 的关系, 笔者此前经常将二者弄混… , 甚至有时候写出 ANSII 这样的神奇搭配..

ANSI

ANSI 转义序列 是一种 带内信号(In-band Signaling) 的 转义序列(escape sequence) 标准 , 用来控制 终端上的 光标位置, 颜色, 以及 其它选项.

在文本中嵌入 ANSI 转义序列, 终端会把这些 ANSI 转义序列 解释为相应的指令, 而不是普通的字符.

例如运行这个例子, 将会输出RGB颜色为 R:215,G:84,B:85 (大体是 粉红色) 的 Hello World 在终端中 Hello World

printf("\x1b[38;2;215;84;85m Hello World")

ANSI 和 ASCII 关系

ASNI 是为了解决 各家厂商都提出自家标准而造成市场十分混乱 的问题而提出的 (大部分沿用到现代的标准似乎都是这个理由XD).

标准制定了一种 所有终端共享的指令集,并要求采用 ASCII 的数字字符 传递所有的信息.

ANSI 转义序列

所有序列都以 ASCII 字符 ESC (OCT \033 HEX \x1b)开头,例如上面输出粉红色字的例子

除 ESC(\x1b) 之外的 C0 控制字符 在输出时也有时会产生与一些 ANSI 转义序列 相似的效果

例如 \n(\x0a) 也就是我们常看到的 LF 和 ESC E(\x1bE) 会有相似的效果

print("Hello World")
printf("\n")
printf("Hello World \n\n")
// output :
// Hello World
// Hello World

print("Hello World")
printf("\x0a")
printf("Hello World \n\n")
// output :
// Hello World
// Hello World

print("Hello World")
printf("\x1bE")
printf("Hello World \n\n")
// output :
// Hello World
// Hello World

ESC - but not CSI-sequences

那么下面简单列举一下 ESC 非控制转义序列(ESC - but not CSI-sequences)
不常用的就不列举了,可以前往参考源的第一个和第二个链接查阅

控制序列- CSI(Control Sequence Introducer)

CSI 序列 由 ESC [ 以及若干个 参数字节 和 若干个中间字节 以及 一个 最终字节 组成.

笔者注: CSI 其实也可以用 \x9d 来表示, 出处
但是 笔者在 GNOME 终端下使用 printf("\x9b38;2;215;84;85m Hello World") 始终无法得到想要的结果….
然后 切换到 tty3 之类的非图形化界面后,就可以使用 printf("\x9b38;2;215;84;85m Hello World") 输出 粉红色的 Hello world , 具体原因未知…

下面就直接 Copy wiki的表格.. 重要的是 SGR 部分, 也就是CSI n m , 不过别的也都很好玩就是了XD

更加详细的 CSI 参数列表 参见 结尾附录

SGR 参数

列举常用以及广泛支持的参数,

颜色

3/4 位色

你可以使用 \x1b[31m 设置 为红色字体,

使用 \x1b[31;102m 设置 前景色为红色,背景色为亮绿色

使用 \x1b[1;5;31;102m 设置 前景色为红色,背景色为亮绿色, 粗体,并闪烁

3/4 的颜色表如下(照搬 WIKI):

部分平台上 可能 30-37 和 90-97 显示的是同一种颜色,因平台而异

8bit (256 色)

可以使用 \x1b[38;5;51m 输出前景色为 编号 51 的 #5f00ff 的字符串 (大概是紫色)

可以使用 \x1b[48;5;51m 输出背景色为 编号 51 的 #5f00ff 的字符串

下面是一些例子(直接在 Terminal 中运行即可):

echo -e "\x1b[38;5;214m\x1b[48;5;239m ssss\x1b[0m"  # 输出 前景色为 256色 214 , 背景色为 256色 239 的样式

颜色表如下(来自 WIKI , 链接见文末)

24 bit (RGB颜色)

在 Xterm,KDE 的 Konsole, 以及所有支持 libvte 的终端 (包括 GNOME Terminal) 上支持

可以使用 \x1b[38;2;<r>;<g>;<b> … m 选择RGB前景色

可以使用 \x1b[48;2;<r>;<g>;<b> … m 选择RGB背景色

END

那么现在可以在终端里好好玩一玩了

参考代码 :

package main

import (
    "fmt"
    "strconv"
)

func main() {
    flag := 0
    str := "KURISU "
    for r := 255; r >= 0; r -= 2 {
        for g, b := 0, 255; g < 255 && b >= 1; g += 1 {
            if flag >= len(str) {
                flag = 0
            }
            a := str[flag]
            flag++
            fmt.Printf("\x1b[48;2;%s;%s;%sm\x1b[38m%s\x1b[0m", strconv.Itoa(r), strconv.Itoa(g), strconv.Itoa(b), string(a))
            b -= 1
        }
        fmt.Printf("\x1bE")
    }
}

附录

参考源

1. GNU Control Sequences
2. ubuntu manpages console_codes.4
3. 字符编解码的故事（ASCII，ANSI，Unicode，Utf-8区别）
4. 关于字符编码，你所需要知道的（ASCII,Unicode,Utf-8,GB2312…）
5. zh wikipedia ANSI转义序列
6. en wikipedia ANSI escape code
7. DukeAnt/ANSI转义码
8. C0与C1控制字符
9. console_codes (4) - Linux Man Pages
10. ISO/IEC 2022

Author: Kurisu Amatist