TIC-80 tiny computer 微型计算机说明文档

1.1.2837 (be42d6f)
https://tic80.com © 2017-2023

仅做搬运和翻译(机翻+人工润色)
来源：https://tic80.com/learn

Welcome 欢迎

TIC-80是一款用于制作、玩和共享小游戏的梦幻电脑。
它有内置的开发工具：代码、精灵、地图、声音编辑器和命令行，这足以创建一个迷你复古游戏。
最后，你会得到一个盒式磁带文件，可以在网站上存储和播放。
此外，游戏可以打包到一个在所有流行平台上运行的播放器中，并根据您的意愿进行分发。
要制作一款复古风格的游戏，整个创作过程都受到一些技术限制：240x136像素的显示屏、16个调色板、256个8x8颜色的精灵、4声道的声音等。

Specification 规格

显示器: 240x136像素，16色调色板。
输入: 4个游戏板，带有8个按钮/鼠标/键盘。
SPRITES: 256 8x8瓷砖和256 8x8精灵。
地图: 240x136单元格，1920x1088像素。
声音: 4通道，波形可配置。
代码: lua、ruby、js、moon、fennel、scheme、squirrel、wren、wasm、janet或python的代码共64KB。

|-----------------------------------|
|96KB RAM布局|
|-------|-------------------|-------|

ADDR	INFO	BYTES
00000	VRAM	16384
04000	瓷砖	8192
06000	精灵图	8192
08000	地图	32640
0f80	游戏手柄	4
0f84	鼠标	4
0f88	键盘	4
0f8c	SFX状态	16
0f9c	声音寄存器	72
0FFE4	波形	256
100E4	SFX	4224
11164	音乐模式	11520
13E64	音乐曲目	408
13FFC	音乐状态	4
14000	立体声音量	4
14004	持久内存	1024
14404	精灵标志	512
14604	FONT	1016
149FC	FONT PARAMS	8
14A04	ALT字体	1016
14DFC	ALT字体参数	8
14E04	按钮映射	32
14E24	保留	12764

|-----------------------------------|
| 16KB VRAM LAYOUT |
|-------|-------------------|-------|

ADDR	INFO	BYTES
00000	SCREEN	16320
03FC0	PALETTE	48
03FF0	PALETTE MAP	8
03FF8	BORDER COLOR	1
03FF9	SCREEN OFFSET	2
03FFB	MOUSE CURSOR	1
03FFC	BLIT SEGMENT	1
03FFD	… (reserved)	3

Console commands 控制台命令

cd 更改目录

更改目录
用法:
cd <路径> cd / cd ..

cls 清屏

清除控制台屏幕。
用法：cls

config 配置

编辑系统配置盒带，
使用reset参数重置当前配置，
使用default编辑默认卡带模板。
用法：config[reset|default]

del 删除

从文件系统中删除。
用法：del<file|folder>

demo 演示

将演示卡带安装到当前目录。
用法：demo

dir 目录

显示本地文件的列表。
用法：dir

edit 编辑

打开卡带编辑器。
用法：edit

eval

运行代码提供的代码。
用法：eval

exit 退出

退出应用程序。
用法：exit

export 导出

将卡带导出为HTML，
原生构建(win-linux-rpi-mac)，
导出精灵/地图/。。。作为.png图像或将sfx和音乐导出到.wav文件。
用法
export[win|winxp|linux|rpi|mac|html|binary|tiles|sprites|map|mapimg|sfx|music|screen|help|…]<file>[bank=0 vbank=0 id=0…]

folder 文件

打开操作系统中的工作目录。
用法：folder

help 帮助

显示有关命令/api/的帮助信息。。。
用法：
help[<text>|version|welcome|spec|ram|vram|commands|api|keys|buttons|startup|terms|license]

import 导入

从外部文件导入代码/spites/map/…
用法
import[binary|tiles|sprites|map|code|screen|…]<file>[bank=0 x=0 y=0 w=0 h=0 vbank=0…]

load 加载

从本地文件系统加载卡带(不需要键入.tic扩展名)。
您也可以从另一个卡带中只加载部分(精灵、地图等)。
用法：load<cart>[code|tiles|sprites|map|sfx|music|palette | flags|screen]

menu 菜单

显示游戏菜单，您可以在其中设置视频、声音和输入选项。
用法：menu

mkdir 创建目录

创建一个目录。
用法：mkdir<name>

new 新建

创建一个新的“Hello World”卡带文件。
用法：
new<lua|rube|js|moon|fennel|scheme|squirrel|wren|wasm|janet|python>

resume 恢复

恢复上次运行的卡带文件/项目。
用法：resume

run 运行

运行当前卡带文件/项目。
用法：run

save 保存

将卡带文件保存到本地文件系统，使用.loa.rb.js.moon.fnl.scm.nut.wren.wamp.janet.py cart扩展名以文本格式保存(PRO功能)。
用法：save<cart>

surf 网上冲浪

打开卡带文件浏览器。
用法：surf

注

以下内容实际上位于说明文档的末尾，但考虑到再开始学习API前应该先了解这些内容，所以提前放在了这里

按钮ID

动作	P1	P2	P3	P4
向上	0	8	16	24
向下	1	9	17	25
向左	2	10	18	26
向右	3	11	19	27
A	4	12	20	28
B	5	13	21	29
X	6	14	22	30
Y	7	15	23	31

Key IDs

CODE	KEY	-	CODE	KEY
1	A		48	SPACE
2	B		49	TAB
3	C		50	RETURN
4	D		51	BACKSPACE
5	E		52	DELETE
6	F		53	INSERT
7	G		54	PAGEUP
8	H		55	PAGEDOWN
9	I		56	HOME
10	J		57	END
11	K		58	UP
12	L		59	DOWN
13	M		60	LEFT
14	N		61	RIGHT
15	O		62	CAPSLOCK
16	P		63	CTRL
17	Q		64	SHIFT
18	R		65	ALT
19	S		66	ESC
20	T		67	F1
21	U		68	F2
22	V		69	F3
23	W		70	F4
24	X		71	F5
25	Y		72	F6
26	Z		73	F7
27	0		74	F8
28	1		75	F9
29	2		76	F10
30	3		77	F11
31	4		78	F12
32	5		79	NUM0
33	6		80	NUM1
34	7		81	NUM2
35	8		82	NUM3
36	9		83	NUM4
37	MINUS		84	NUM5
38	EQUALS		85	NUM6
39	LEFTBRACKET		86	NUM7
40	RIGHTBRACKT		87	NUM8
41	BACKSLASH		88	NUM9
42	SEMICOLON		89	NUMPLUS
43	APOSTROPHE		90	NUMMINUS
44	GRAVE		91	NUMMULTIPLY
45	COMMA		92	NUMDIVIDE
46	PERIOD		93	NUMENTER
47	SLASH		94	NUMPERIOD

CODE	KEY		CODE	KEY
1	A		48	空格
2	B		49	选项卡
3	C		50	返回
4	D		51	退格
5	E		52	删除
6	F		53	插入
7	G		54	向上翻页
8	H		55	向下翻页
9	I		56	家
10	J		57	END
11	K		58	上
12	L		59	下
13	M		60	左
14	N		61	右
15	O		62	大写锁定
16	P		63	CTRL
17	Q		64	SHIFT
18	R		65	ALT
19	S		66	ESC
20	T		67	F1
21	U		68	F2
22	V		69	F3
23	W		70	F4
24	X		71	F5
25	Y		72	F6
26	Z		73	F7
27	0		74	F8
28	1		75	F9
29	2		76	F10
30	3		77	F11
31	4		78	F12
32	5		79	NUM0
33	6		80	NUM1
34	7		81	NUM2
35	8		82	NUM3
36	9		83	NUM4
37	MINUS		84	NUM5
38	等于		85	NUM6
39	左括号		86	NUM7
40	右括号		87	NUM8
41	反斜杠		88	NUM9
42	分号		89	NUMPLUS
43	撇号		90	NUMMINUS
44	GRAVE		91	NUMMULTIPLY
45	COMMA		92	numdiver
46	PERIOD		93	NUMENTER
47	SLASH		94	NUMPERIOD

Startup options 启动选项

--skip skip startup animation
--volume=<int> global volume value [0-15]
--cli console only output
--fullscreen enable fullscreen mode
--vsync enable VSYNC
--soft use software rendering
--fs=<str> path to the file system folder
--scale=<int> main window scale
--cmd=<str> run commands in the console
--keepcmd re-execute commands on every run
--version print program version
--crt enable CRT monitor effect

--跳过跳过启动动画
--volume=＜int＞全局卷值[0-15]
--cli仅控制台输出
--fullscreen 启用全屏模式
--vsync使能vsync
--soft 软件渲染
--fs=<str>文件系统文件夹的路径
--scale=<int>主窗口比例
--cmd=<str>在控制台中运行命令
--keepcmd在每次运行时重新执行命令
--version 打印程序版本
--crt启用crt监视器效果

使用条款

-官网上的所有卡带文件(https://tic80.com网站)是作者的财产。
-未经作者直接许可，请勿重新分发卡带文件。
-通过将卡带文件上传到网站，您授予Nesbox自由使用和分发墨盒的权利。默认情况下，所有其他权利归作者所有。
-不要发布违反版权、淫秽或任何其他法律的材料。
-Nesbox保留移除或过滤任何材料的权利，恕不另行通知。