ComputerCraft-Utf8/UTF-8 print for CC/README.md

English 中文

Introduction

A pixel-based UTF-8 printing program

\color{red} \bf Note:
The CC compiler reads UTF-8 characters as '?',
print("Hello World") has the same effect as print("????").
To fix this, read files in "rb" mode for proper input handling.

How to Create Fonts

• Font files should return a table where keys are UTF-8 code points, and values are corresponding character bitmaps.
• Each bitmap is a table of equal-length strings representing a 2x3 pixel grid defined by Computer Craft. To use the bottom-right pixel, subtract 128 from the char code to invert backgroundColor and textColor.
• A single font file may contain bitmaps of different sizes, but it must include a bitmap for 'H' (ASCII:72) to indicate the maximum height of the font.
• The final output uses the maximum bitmap height in the FontFamily as the baseline for bottom-aligned text.
• The FontFamily must include a '-' (ASCII:45) bitmap for potential word splitting during auto-wrapping.

Technical Details

• require a fusion-pixel-12px font consumes approximately 10.5MB of memory.
• require a fusion-pixel-8px font consumes approximately 6MB of memory.
• 8px characters occupy 3 rows vertically, while 12px characters occupy 4 rows.
• Fonts are sourced from fusion-pixel-font.

介绍

一个基于像素打印的utf8打印程序

\color{red} \bf 注意: CC 编译器会把utf8字符读作 '?', print("你好世界") 与 print("????") 的效果相同, 可以"rb"模式读取文件以设置输入

如何制作Font

• 字体文件返回一个table，键值为utf8编码，值为和对应字体的bitmap。
• bitmap为一个包含等长string的table，string中的char属于computer craft定义的2*3像素点阵（如需使用右下角像素，将char的码值减128表示反转backgroundColor 和 textColor）
• 单个字体文件中可以有不同尺寸的bitmap，且需要有'H'(ascII:72)的bitmap表示该文件中最大bitmap高度
• 会以FontFamily出现的最大bitmap高度为基准，最终输出下对齐的文本
• FontFamily中需要'-'(ascII:45)的bitmap以供自动换行时可能的切断单词使用

技术细节

• require一个fusion-pixel-12px字体，大约消耗10.5MB内存
• require一个fusion-pixel-8px字体，大约消耗6MB内存
• 8px字符实际占用3格高的字符数, 12px字符实际占用4格高
• 字体来自 fusion-pixel-font