TIC-80中文文档.

TIC-80是一款小巧的电脑，可用于制作，播放和分享小游戏。 有内置的开发工具：代码，精灵，地图，声音编辑器和命令行，这足以创建一个迷你复古游戏。 完成后，您可以导出一个盒式文件，该文件可以存储并上传到网站。 此外，游戏可以打包到适用于所有流行平台的游戏机中，您可以根据需要进行分发。 为了制作复古风格的游戏，整个创作过程在一些技术限制下进行：240x136像素显示，16色调色板，256个8x8色彩精灵，4个声道声音等。

-----------------------

规范
控制台
代码编辑器
精灵编辑器
地图编辑器
SFX编辑器
音乐编辑
热键
命令行参数
支持的平台
MODS

积分

-----------------

规范
显示240x136像素，16色调色板
输入4个游戏手柄，带8个按钮/鼠标/键盘
精灵256 8x8前景精灵和256 8x8背景拼贴
映射240x136个单元格，1920x1088像素（240 * 8 x 136 * 8）
声音4通道（带可编辑的波形包络）
代码64KB（或PRO bankwitching中的512KB）

Bankswitching购物车中最多8家银行（仅限PRO版）

-----------------------

+ ----------------------------------- +
| 80K RAM布局|
+ ------- + ------------------- ------- + +
| ADDR |信息| SIZE |
+ ------- + ------------------- ------- + +
| 00000 |屏幕| 16320 | 240x136 4位屏幕
| 03FC0 | PALETTE | 48 | 16种24位RGB颜色
| 03FF0 | PALETTE MAP | 8 | 16位4位颜色分配
| 03FF8 |边界| 1 | 4位边框颜色
| 03FF9 |屏幕偏移| 2 |水平和垂直偏移
| 03FFB | MOUSE CURSOR | 1 |设置鼠标光标的模式
| 03FFC | ...... | 4 |
| 04000 | TILES | 8192 | 256个8x8 BG瓷砖
| 06000 | SPRITES | 8192 | 256个8x8 FG瓷砖
| 08000 | MAP | 32640 |来自BG瓷砖的240x136世界
| 0FF80 | GAMEPADS | 4 | 4个游戏手柄x 8个按钮（上下左右A B X Y）
| 0FF84 | MOUSE | 4 |鼠标光标X / Y和鼠标按钮
| 0FF88 |键盘| 4 | 4个同步键盘索引
| 0FF8C | ...... | 16 |
| 0FF9C |声音寄存器| 72 | 18字节x 4通道
| 0FFE4 | WAVEFORMS | 256 | 16个32x4位波形
| 100E4 | SFX | 4224 | 64 x 30个样本
| 11164 |音乐模式| 11520 | 60 x 64行
| 13E64 |音乐曲目| 408 | 8 x 16个图案x 4个通道
| 13FFC | MUSIC POS | 4 |
| 14000 | ...... | 0 |

+ ------- + ------------------- ------- + +

Console

----------------------

可用命令
help - 显示可用命令
ram - 显示80K RAM布局
exit - 退出应用程序
edit - 显示编辑器
new[lua |moon| js | wren |fennel] - 创建新的Hello World墨盒
load <cart> [sprites |地图|封面|代码| sfx |音乐|调色板] - 从本地文件系统加载盒式磁带（您可以键入不带.tic扩展名的购物车名称），也可以只从其他购物车加载数据部分（精灵，地图......）
save<cart> - 将墨盒保存到本地文件系统，使用.lua / .js / .moon购物车扩展名以文本格式保存[专业版]
run - 运行当前项目
resume - 恢复上次加载的项目
dir - 显示本地文件列表
cd - 更改目录
mkdir - 制作目录
folder - 在OS中打开工作目录（Windows，Linux，MacOSX）
add - 显示文件打开对话框以将文件添加到TIC
del <file> - 从文件系统中删除
get <file> - 显示文件保存对话框以下载文件
export [html |本地的|精灵|封面| map] - 导出HTML，NATIVE版本的游戏或精灵，覆盖为.gif
import [sprites |封面| map] - 从.gif导入精灵或封面
cls - 清除屏幕
demo - 安装演示
version - 显示当前版本（0.60.3）
config [保存|默认] - 显示config.tic文件编辑器，使用save param保存当前配置，使用默认编辑默认购物车模板
keymap - 配置键盘按钮映射（在以后的版本中删除）

surf - 打开浏览器

--------------------

墨盒元数据

dofile("example.lua") -- Can be used for saving a standalone Lua file in the TIC executable's directory.
-- title:  game title                        -- Briefly shows the name of the cart.
-- author: game developer                    -- Briefly shows who made the cart.
-- desc:   short description                 -- Optional description of game, isn't necessary.
-- script: lua (or moon/wren/js/fennel)      -- Selects language. The default and most popular is Lua.
-- input:  gamepad (or mouse or keyboard)    -- Selects either gamepad or mouse or keyboard input usage. All the input types enabled by default.
-- saveid: MyAwesomeGame                     -- Allows save data to be shared within multiple games on a copy of TIC.

警告：


上传到官方网站需要标题和作者标签以及封面图片。
dofile必须放在游戏源代码的第一行。
在源代码之上声明所有这些标记是一种很好的做法。
如果要启用Moonscript支持add - script：moon tag
如果要启用Javascript支持，请添加// script：js标记
如果要启用Fennel支持添加;; 脚本：茴香标签
如果你想启用Wren支持添加//脚本：wren标签
要仅启用鼠标输入（并禁用游戏手柄/键盘），请添加 - 输入：鼠标标记


为游戏使用独特的saveid将保持pmem而不是依赖于MD5哈希。

特殊功能

Functions

• 功能
  print - 使用系统字体打印字符串
  font - 使用前景精灵中定义的字体打印字符串
  clip - 设置屏幕剪辑区域
  cls - 清除屏幕
  pix - 在屏幕上设置/获取像素颜色
  line - 画线
  rect - 绘制填充的矩形
  rectb - 绘制矩形边框
  circ-画圆圈
  circb - 画圆圈边框
  spr - 按ID绘制精灵，可以旋转或翻转
  btn - 在当前帧中获取游戏手柄按钮状态
  btnp - 根据前一帧获取游戏手柄按钮状态
  sfx - 在特定频道上按ID播放SFX
  key - 在当前帧中获取keybaord按钮状态
  keyp - 根据前一帧获取键盘按钮状态
  map - 在屏幕上绘制地图区域
  mget - 获取地图图块索引
  mset - 设置地图图块索引
  music - 按ID播放音乐曲目
  peek - 从RAM中读取一个字节值
  poke - 将一个字节值写入RAM
  peek4 - 从RAM读取半字节值
  poke4 - 将半字节值写入RAM
  重置 - 将游戏重置为初始状态（0.60）
  memcpy - 复制RAM中的字节
  memset - 在RAM中设置字节值
  pmem - 将整数值保存到持久内存中
  trace - 跟踪控制台的字符串
  time - 返回游戏开始传递的滴答数
  mouse - 获取XY并按下鼠标/触摸状态
  sync - 将修改后的精灵/地图复制到墨盒
  tri - 绘制填充三角形
  textri - 绘制三角形填充纹理
  exit - 中断程序并返回控制台

使用外部代码编辑器
您可以使用两种方法在外部编辑器中编辑代码：


将dofile（'game.lua'）添加到第一行，并将game.lua放在当前工作目录中。
Windows：与可执行文件位于同一文件夹中。
Unix / Linux：在你启动tic二进制文件的当前工作目录中。

或使用tic cart.tic -code game.lua命令行参数将代码注入盒式磁带

您可以在游戏中定义两个128x128精灵表。一个用于前景对象，另一个用于背景。


在右上角，您将看到一个滑块，用于编辑精灵表的8x8,16x16,32x32或64x64段。还有两个用于选择前景（FG）或背景（BG）表的选项卡。新购物车将在后台精灵集中初始化2帧Ticsy的动画。


左边是精灵绘图部分，右边是精选精灵表的视图。


左上角的数字显示所选的精灵索引。下面是一个用于编辑所选精灵索引的空间。最左边是画笔大小选择器，范围从1像素到4像素平方。在tile编辑器的底部是一个基本的绘图工具集。


画笔绘制选定的图块。
拾色器根据单击的像素选择颜色。
选择允许您在区块的某个部分移动并移动它。
填充是一种基本的油漆桶工具。它允许您用颜色填充瓷砖的单色形状。
Flip Horz和Flip Vert允许在任一轴上翻转图块。
旋转允许您顺时针旋转瓷砖90度。
擦除清除整个图块。

工具集下方是一个16色的颜色选择器。系统和新购物车将调色板初始化为默认DB16。右侧是调色板颜色的RGB编辑器按钮。

您可以定义64种音效，也可以在音乐编辑器中用作乐器。


一旦进入编辑器，您将看到两个输入顶部，索引（IDX）和速度（SPD）。索引控制您正在编辑的声音效果（从00到63）和速度控制声音效果的播放速度（从-4到03）。接下来，左侧有四种影响乐器声音的方法。这些是：


波形用于更改仪器使用的波形类型。选项是在编辑器的“波形”选项卡中定义的一组波形。一个新的墨盒已经有波形设置为方形，三角形，锯波或噪声（主要用于打击和爆炸）
音量您的乐器有多大声。如果您希望SFX淡入或淡出，这就是这样做的方法。
琶音改变音符，相对于播放的基调音符。这可以用来演奏和弦。
音高改变基音。
底部的八度音（OCT）选项会改变键盘弹奏的八度音程。您可以使用Z S X D C V G B H N J M键演奏音符。键被映射为好像标准qwerty键盘上的底行是钢琴的一个八度音阶，上面的行上有锐利和平面。按SPACE将播放上次播放的键。


循环功能可让您重复部分SFX。第一个数字控制循环的长度（从0到15），第二个数字控制它的位置（也是0-15）。这将循环左侧所选选项的当前模式。您可以分别控制所有选项的循环，它们不会相互影响。

调用sfx（id）来运行你的音效

您最多可以存储8首曲目（0到7），这些曲目就像单独的音乐片段。 节奏是音乐在BPM（Beats Per Minute）中的速度。 行控制轨道中有多少节拍。

要输入注释，请单击一个单元格（或使用箭头键移动到该单元格）并按下键盘底行上的一个键，方法与在SFX编辑器中相同。 您还可以从下一个八度音阶输入音符。 一旦您输入了注释，只要没有不同的注释或中断，它就会继续。 按A或空格可以中断。 轨道上的注释有四个组成部分。

第一个组成部分是从A到G的字母，它是一个音符（它也可以有一个#after表示音符很清晰）。 旁边的数字是将要播放音符的八度音程。旁边有一个从00到63的橙色数字。这是音符将使用的SFX音色的索引。 最后有一个蓝色的十六进制数字。 这是该笔记的数量。 F为100％体积，0为0％。 音符和钢琴模式的效果正在开发中。


您可以按SPACE预览当前所在的音符，然后按ENTER播放当前帧。