From e2eb2a387bf214fc83c3abce4d691e7173f46dbb Mon Sep 17 00:00:00 2001 From: HfSr <96952179+HfSrJun@users.noreply.github.com> Date: Fri, 3 May 2024 22:22:22 +0800 Subject: [PATCH] add zh_CN manual (#23) --- .../computronics/zh_CN/block/audio_cable.md | 7 +++ .../computronics/zh_CN/block/camera.md | 5 ++ .../computronics/zh_CN/block/chatbox.md | 7 +++ .../computronics/zh_CN/block/cipher.md | 5 ++ .../zh_CN/block/cipher_advanced.md | 6 +++ .../computronics/zh_CN/block/colorful_lamp.md | 5 ++ .../zh_CN/block/computercraft/sound_board.md | 5 ++ .../computronics/zh_CN/block/index.md | 31 +++++++++++ .../zh_CN/block/iron_noteblock.md | 5 ++ .../computronics/zh_CN/block/radar.md | 7 +++ .../block/railcraft/digital_controller_box.md | 7 +++ .../zh_CN/block/railcraft/digital_detector.md | 11 ++++ .../block/railcraft/digital_receiver_box.md | 7 +++ .../zh_CN/block/railcraft/locomotive_relay.md | 5 ++ .../zh_CN/block/railcraft/ticket_machine.md | 7 +++ .../computronics/zh_CN/block/speaker.md | 5 ++ .../computronics/zh_CN/block/speech_box.md | 9 ++++ .../computronics/zh_CN/block/tape_drive.md | 13 +++++ .../computronics/zh_CN/item/beep_card.md | 9 ++++ .../zh_CN/item/buildcraft/docking_upgrade.md | 5 ++ .../zh_CN/item/buildcraft/drone_station.md | 5 ++ .../computronics/zh_CN/item/camera_upgrade.md | 5 ++ .../computronics/zh_CN/item/chat_upgrade.md | 7 +++ .../zh_CN/item/colorful_upgrade.md | 5 ++ .../computronics/zh_CN/item/index.md | 53 +++++++++++++++++++ .../computronics/zh_CN/item/light_board.md | 7 +++ .../computronics/zh_CN/item/magical_memory.md | 5 ++ .../computronics/zh_CN/item/noise_card.md | 21 ++++++++ .../computronics/zh_CN/item/particle_card.md | 5 ++ .../zh_CN/item/portable_tape_drive.md | 13 +++++ .../computronics/zh_CN/item/rack_capacitor.md | 7 +++ .../computronics/zh_CN/item/radar_upgrade.md | 5 ++ .../zh_CN/item/railcraft/relay_sensor.md | 5 ++ .../zh_CN/item/self_destructing_card.md | 7 +++ .../zh_CN/item/server_self_destructor.md | 7 +++ .../computronics/zh_CN/item/sound_card.md | 37 +++++++++++++ .../computronics/zh_CN/item/speech_upgrade.md | 5 ++ .../computronics/zh_CN/item/spoofing_card.md | 5 ++ .../computronics/zh_CN/item/switch_board.md | 9 ++++ .../computronics/zh_CN/item/tape.md | 5 ++ .../zh_CN/item/colorful_module.md | 7 +++ .../tis3d/computronics/zh_CN/item/index.md | 8 +++ .../zh_CN/item/self_destructing_module.md | 7 +++ .../zh_CN/item/tape_reader_module.md | 26 +++++++++ .../zh_CN/protocols/computronics/flamingo.md | 5 ++ 45 files changed, 432 insertions(+) create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/audio_cable.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/camera.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/chatbox.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/cipher.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/cipher_advanced.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/colorful_lamp.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/computercraft/sound_board.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/index.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/iron_noteblock.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/radar.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/railcraft/digital_controller_box.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/railcraft/digital_detector.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/railcraft/digital_receiver_box.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/railcraft/locomotive_relay.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/railcraft/ticket_machine.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/speaker.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/speech_box.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/tape_drive.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/beep_card.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/buildcraft/docking_upgrade.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/buildcraft/drone_station.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/camera_upgrade.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/chat_upgrade.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/colorful_upgrade.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/index.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/light_board.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/magical_memory.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/noise_card.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/particle_card.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/portable_tape_drive.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/rack_capacitor.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/radar_upgrade.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/railcraft/relay_sensor.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/self_destructing_card.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/server_self_destructor.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/sound_card.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/speech_upgrade.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/spoofing_card.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/switch_board.md create mode 100644 src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/tape.md create mode 100644 src/main/resources/assets/computronics/doc/tis3d/computronics/zh_CN/item/colorful_module.md create mode 100644 src/main/resources/assets/computronics/doc/tis3d/computronics/zh_CN/item/index.md create mode 100644 src/main/resources/assets/computronics/doc/tis3d/computronics/zh_CN/item/self_destructing_module.md create mode 100644 src/main/resources/assets/computronics/doc/tis3d/computronics/zh_CN/item/tape_reader_module.md create mode 100644 src/main/resources/assets/computronics/doc/tis3d/zh_CN/protocols/computronics/flamingo.md diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/audio_cable.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/audio_cable.md new file mode 100644 index 00000000..d2799daa --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/audio_cable.md @@ -0,0 +1,7 @@ +# 音频线缆 + +![雅乐原应扬远音。](block:computronics:audio_cable) + +音频线缆可用于连接发送音频信号的设备和接收音频信号并发出声音的设备。使用例之一是将[磁带驱动器](tape_drive.md)与一或多个[扬声器](speaker.md)相连。 + +与大多数设备相同，音频线缆也可用染料或颜料刷等工具染色。染色后，音频线缆不会连接到与之相邻但颜色不同的音频线缆或音频设备上。未染色的设备任何情况下都可被连接，未染色的线缆也可以连接到任意线缆或设备。 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/camera.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/camera.md new file mode 100644 index 00000000..c6b41a1f --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/camera.md @@ -0,0 +1,5 @@ +# 摄像头 + +![拍不出照片。](block:computronics:camera) + +摄像头方块为电脑添加了进行光线投射的功能。`'distance()`函数会计算给定射线方向上离摄像头最近的方块距离有多少，射线由角度`x`与`y`定义；若不指定，则角度值默认为0。两个角度值均在摄像头前方的锥形区域内，其中`x`指射线在平行于地面的水平面上投影的角度，`y`为射线在垂直于地面的垂直面上投影的角度。若射线路径上不存在方块，则会返回`-1`。 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/chatbox.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/chatbox.md new file mode 100644 index 00000000..ae2b294a --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/chatbox.md @@ -0,0 +1,7 @@ +# 聊天盒 + +![快和我说！](block:computronics:chat_box) + +聊天盒可以让电脑向游戏的聊天框输出/从游戏的聊天框读取内容。在读取或发送消息时，可以指定侦听距离（默认为40格）。电脑上的程序可被聊天盒触发，方法是读取`chat_message`事件中所包含的聊天消息。 + +在收到消息后，聊天盒会发出4 tick长的红石信号脉冲。此功能可与各种红石控制配合使用。 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/cipher.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/cipher.md new file mode 100644 index 00000000..c4a38b29 --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/cipher.md @@ -0,0 +1,5 @@ +# 加密机 + +![理解不能。](block:computronics:cipher) + +加密机的作用为加密与解密信息。将物品放入加密机中即可利用其物品堆信息生成加密密钥。密文可利用带有完全相同加密密钥的加密机来解密。例如，你可以利用网络将密文发送给另一台电脑；接收方的电脑需要有一台放入完全一样的物品的加密机才能解密这条密文。加密机可通过其组件API锁定，以禁止对其GUI的访问（并隐藏加密密钥）。 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/cipher_advanced.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/cipher_advanced.md new file mode 100644 index 00000000..1922f485 --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/cipher_advanced.md @@ -0,0 +1,6 @@ +# 高级加密机 + +![信息安全了，暂时。](block:computronics:cipher_advanced) + +高级加密机使用了RSA加密法，它会创建一对公钥与私钥。密钥对可使用一对质数生成，也可随机生成。生成完毕后，返回值中将会同时包含公钥和私钥。（生成过程会耗费数秒） +公钥用于加密信息，而私钥用于解密信息。只有拥有私钥的电脑才能解密信息。 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/colorful_lamp.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/colorful_lamp.md new file mode 100644 index 00000000..771940b6 --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/colorful_lamp.md @@ -0,0 +1,5 @@ +# 变色灯 + +![好漂亮啊。](block:computronics:colorful_lamp) + +变色灯是一种特殊的发光方块，支持至多32768种颜色组合。变色灯的颜色由一个15位二进制数定义。其低5位定义了蓝色叠加量，中间5位定义了绿色叠加量，高5位定义了红色叠加量。例如，二进制数`000000000011111`（使用时需转换为十进制）代表纯蓝色。变色灯可被用于多种用途，例如状态指示方块——也就是用不同颜色来代表电脑上程序的不同状态。 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/computercraft/sound_board.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/computercraft/sound_board.md new file mode 100644 index 00000000..249cc338 --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/computercraft/sound_board.md @@ -0,0 +1,5 @@ +# 外置声卡 + +![空间不足。](block:computronics:sound_board) + +此方块与[声卡](../../item/sound_card.md)等效，但适用于ComputerCraft模组。 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/index.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/index.md new file mode 100644 index 00000000..86b960eb --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/index.md @@ -0,0 +1,31 @@ +# 计算电子学手册 + +此索引列出了计算电子学模组中所有方块的档案。如果你要找物品，请查看[物品索引](../item/index.md)。 + +请注意，根据所使用的配方不同以及是否在配置文件中启用，一部分方块可能不可用。 + +# 方块 + +* [摄像头](camera.md) +* [聊天盒](chatbox.md) +* [加密机](cipher.md) +* [高级加密机](cipher_advanced.md) +* [变色灯](colorful_lamp.md) +* [铁音符盒](iron_noteblock.md) +* [雷达](radar.md) +* [语音盒](speech_box.md) +* [磁带机](tape_drive.md) +* [音频线缆](audio_cable.md) +* [扬声器](speaker.md) + +# 适用于其他模组的方块 + +下列方块由计算电子学模组添加，以与其他模组联动。在当前整合包中不一定存在。 + +## Railcraft + +* [数字化机车中继器](railcraft/locomotive_relay.md) +* [数字化矿车探测器](railcraft/digital_detector.md) +* [数字化信号控制盒](railcraft/digital_controller_box.md) +* [数字化信号接收盒](railcraft/digital_receiver_box.md) +* [火车票打印机](railcraft/ticket_machine.md) diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/iron_noteblock.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/iron_noteblock.md new file mode 100644 index 00000000..5f96a9bb --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/iron_noteblock.md @@ -0,0 +1,5 @@ +# 铁音符盒 + +![比音符盒好。](block:computronics:iron_note_block) + +铁音符盒可用不同乐器的音色演奏各种音符。其中的乐器（例如钢琴或底鼓）与Minecraft原版音符盒的乐器相同。铁音符盒可用每种乐器演奏24种音符，还能可选的指定一个0到1之间的数字作为音量参数。 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/radar.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/radar.md new file mode 100644 index 00000000..a51b30a3 --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/radar.md @@ -0,0 +1,7 @@ +# 雷达 + +![无线电索敌与测距](block:computronics:radar) + +雷达方块的功能类似于开放式电脑模组中的运动探测器，能用于探测玩家、动物或掉落物等实体。其内置的API函数会返回一张表，表中列出了指定范围内实体的名称和相对距离。 + +雷达方块在扫描时需耗能，范围越大，耗能越多（配合开放式电脑模组使用时），或者在两次扫描间需等待一段时间（配合ComputerCraft模组使用时）。 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/railcraft/digital_controller_box.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/railcraft/digital_controller_box.md new file mode 100644 index 00000000..13b15f53 --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/railcraft/digital_controller_box.md @@ -0,0 +1,7 @@ +# 数字化信号控制盒 + +![一切都在我掌控之下，我发誓！](block:computronics:digital_box@1) + +数字化信号控制盒可以向所连接的接收盒发送信号状态，线缆需要连接到控制盒的上或下面。信号状态由Railcraft模组的[信号](http://railcraft.info/wiki/guide:signalling)文档定义（信号状态包含绿灯、闪烁黄灯、黄灯、闪烁红灯以及红灯）。 + +控制盒可连接到至多32个不同的接收盒。接收盒通过名称区分，名称可由信号标签指定。 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/railcraft/digital_detector.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/railcraft/digital_detector.md new file mode 100644 index 00000000..a57ce84d --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/railcraft/digital_detector.md @@ -0,0 +1,11 @@ +# 数字化矿车传感器 + +![数字化探测。](block:computronics:digital_detector) + +数字化矿车传感器会在矿车紧贴其通过时作出响应，并发出一个`minecart`Lua事件，此事件可被电脑检测到。数字化传感器只有特定面才能与电脑连接。 + +`minecart`事件的格式如下所示。如果你不理解信号格式，可参考[这篇指南](http://ocdoc.cil.li/component:signals:zh)。 + +`minecart(detectorAddress:string, minecartType:string, minecartName:string [, primaryColor:number, secondaryColor:number, destination:string, ownerName:string])` + +若矿车未被命名，`minecartName`参数可能为空字符串。若矿车为机车，信号中还会提供机车的颜色、目的地（若不存在目的地则返回空字符串）以及所有者姓名（若不存在所有者则返回空字符串）。 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/railcraft/digital_receiver_box.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/railcraft/digital_receiver_box.md new file mode 100644 index 00000000..dfe0d509 --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/railcraft/digital_receiver_box.md @@ -0,0 +1,7 @@ +# 数字化信号接收盒 + +![数字化接收。](block:computronics:digital_box@0) + +数字化信号接收盒可用于探测信号状态变化，线缆需要连接到控制盒的上或下面。信号状态由Railcraft模组的[信号](http://railcraft.info/wiki/guide:signalling)文档定义（信号状态包含绿灯、闪烁黄灯、黄灯、闪烁红灯以及红灯）。 + +接收盒可连接到至多32个不同的控制盒。控制盒通过名称区分，名称可由信号标签指定。 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/railcraft/locomotive_relay.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/railcraft/locomotive_relay.md new file mode 100644 index 00000000..8049bbae --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/railcraft/locomotive_relay.md @@ -0,0 +1,5 @@ +# 数字化机车中继器 + +![欢迎来到未来。](block:computronics:locomotive_relay) + +数字化机车中继器可令电脑与Railcraft模组的电力机车交互。你需要用到[数字化中继器传感器](../../item/railcraft/relay_sensor.md)来进行配对：潜行右键单击以将[中继器传感器](../../item/railcraft/relay_sensor.md)绑定到机车中继器，然后潜行左键单击一台电力机车以将[传感器](../../item/railcraft/relay_sensor.md)附到机车上。连接后，电力机车可通过`locomotive_relay`组件API进行控制。 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/railcraft/ticket_machine.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/railcraft/ticket_machine.md new file mode 100644 index 00000000..d5e2a8f5 --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/railcraft/ticket_machine.md @@ -0,0 +1,7 @@ +# 火车票打印机 + +![滋...滋...滋...](block:computronics:ticket_machine) + +火车票打印机可让玩家以黄金车票为模板打印火车票。黄金车票可通过`ticket_machine`组件API配置，也可使用维护模式界面（空手潜行右键单击打印机）配置。配置后，可使用打印机的GUI打印火车票（选定黄金车票再按打印键）。也可使用组件API打印（指定所需的黄金车票槽位）。打印火车票需要耗费一定能量，还需耗费Minecraft原版的纸（可在维护模式下放入纸槽位，也可自动化放入）。 + +你也可以用组件API禁止手动（通过打印机的GUI）打印火车票，这样只能通过组件API函数进行打印。若有需要，维护模式也可以被限定为只有机器所有者和管理员可以访问。 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/speaker.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/speaker.md new file mode 100644 index 00000000..f7739ad0 --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/speaker.md @@ -0,0 +1,5 @@ +# 扬声器 + +![已获Audiophile认证。](block:computronics:speaker) + +这种电子原声音乐转换器可被连接到[音频线缆](audio_cable.md)上。此设备会接收通过线缆传输的任何音频信号，然后将其转换为声音，让其可被收听。 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/speech_box.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/speech_box.md new file mode 100644 index 00000000..022f6724 --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/speech_box.md @@ -0,0 +1,9 @@ +# 语音盒 + +![只花了两年。](block:computronics:speech_box) + +语音盒可以说话！此设备使用了一套叫做[MaryTTS](http://mary.dfki.de/)的文字转语音系统，可用所提供的信息合成语音。只需为其提供一条句子或短语，然后经过短暂处理，它就可以产生对应语音。最好恰当使用标点以提升语音的质量。 + +受限于模组大小，语音盒默认情况下不提供任何功能;你需要在游戏实例目录中额外安装MaryTTS才能使用此功能。安装过程详见[wiki](http://wiki.vex.tty.sh/wiki:computronics:mary)。 + +若语音盒连接到了[音频线缆](audio_cable.md)，则它会将生成的音频信号通过线缆发送，而不是自身播放声音。 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/tape_drive.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/tape_drive.md new file mode 100644 index 00000000..601106ec --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/block/tape_drive.md @@ -0,0 +1,13 @@ +# 磁带驱动器 + +![放磁带，别放胶带。](block:computronics:tape_reader) + +磁带驱动器是用于回放和录制音频数据的方块。[盒式磁带](../item/tape.md)可被装入磁带驱动器中，且有容量从2到128分钟不等的多种型号。请注意，磁带驱动器并不仅限于读写音频数据，其它类型的数据也可以被写入[盒式磁带](../item/tape.md)中。 + +鉴于文件尺寸较小，音频会被保存为DFPWM格式。要将MP3或其他常见音频格式转换为此格式很麻烦；但是，可以用[LionRay](http://wiki.vex.tty.sh/wiki:computronics:tape#lionray)程序将WAV文件转换成DFPWM格式。转换好的音频文件可以被逐字节写入盒式磁带中。可在[wiki](http://wiki.vex.tty.sh/dfpwm)中找到有关DFPWM的更详细信息。 + +磁带驱动器还提供了一个`seek()`函数，此函数可以将[盒式磁带](../item/tape.md)快进到某个特定位置。向`seek()`函数传递负数值即可将[盒式磁带](../item/tape.md)倒带至先前的某个位置。 + +你可以创建一个名为`tape`的软盘，其中装有名称相同的程序。这样可实现更便利的读取、写入以及播放磁带功能。 + +若磁带驱动器连接到了[音频线缆](audio_cable.md)，则它会将生成的音频信号通过线缆发送，而不是自身播放声音。 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/beep_card.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/beep_card.md new file mode 100644 index 00000000..c577f2fc --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/beep_card.md @@ -0,0 +1,9 @@ +# 蜂鸣卡 + +![滴...滴...滴...](item:computronics:oc_parts@5) + +此扩展卡提供了`beep()`函数，此函数接收一个包含若干频率-时长组合的表作为输入，表中最多可有八个组合。扩展卡会同时播放各个频率的蜂鸣声，其各自的长度为输入中对应的时长。当其中一个一个频率播放完毕后即可给蜂鸣卡提供下一个频率-时长组合。你无法同时播放多于8种频率。 + +示例代码： +` local card = component.beep` +` card.beep({[440]=4, [880]=2})` diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/buildcraft/docking_upgrade.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/buildcraft/docking_upgrade.md new file mode 100644 index 00000000..e678d2f2 --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/buildcraft/docking_upgrade.md @@ -0,0 +1,5 @@ +# 无人机停靠升级 + +![上半部分。](item:computronics:docking_upgrade) + +无人机停靠升级可令无人机停泊到附有[无人机停靠站](drone_station.md)的Buildcraft模组管道上。此升级可被安装进带有1级或更高级扩展槽位的无人机中。 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/buildcraft/drone_station.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/buildcraft/drone_station.md new file mode 100644 index 00000000..0da78abc --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/buildcraft/drone_station.md @@ -0,0 +1,5 @@ +# 无人机停靠站 + +![下半部分。](item:computronics:drone_station) + +无人机停靠站可安装到Buildcraft模组的管道上，以供装有[无人机停靠升级](docking_upgrade.md)的无人机停靠。无人机停靠后可将自身装载的物品输入进Buildcraft的管道网络中，若管道为能量管道，停靠站还可为无人机充电。 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/camera_upgrade.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/camera_upgrade.md new file mode 100644 index 00000000..e5454f3a --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/camera_upgrade.md @@ -0,0 +1,5 @@ +# 摄像头升级 + +![还是拍不出照片。](item:computronics:oc_parts@0) + +摄像头升级可被安装于带有2级或更高级升级槽位的机器人和无人机中，并为其提供与[摄像头](../block/camera.md)方块相同的功能。但是摄像头升级有更多功能，具体而言，有两个新的函数：`distanceUp()`和`distanceDown()`。上述两个函数的功能分别相当于使用朝向正上和正下方的摄像头。这两个函数可被机器人和无人机用于绘制高程图等用途。两个函数都接收同样的`x`和`y`参数，并且和摄像头方块一样，分别定义处于上或下方圆锥区域内的射线。 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/chat_upgrade.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/chat_upgrade.md new file mode 100644 index 00000000..ecc87197 --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/chat_upgrade.md @@ -0,0 +1,7 @@ +# 聊天升级 + +![只是和我的机器人聊天而已。](item:computronics:oc_parts@1) + +聊天升级可被安装于带有2级或更高级升级槽位的机器人和无人机中。此升级的功能与[聊天盒](../block/chatbox.md)类似，可用于与游戏的聊天栏互动。与[聊天盒](../block/chatbox.md)相同，侦听距离可在上限内进行指定（上限可在配置文件中定义）。 + +此升级的常见用法可以是通过在聊天框内输入指令来触发机器人或无人机的某段程序，只需将机器人或无人机设定为检测特定的聊天消息即可。 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/colorful_upgrade.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/colorful_upgrade.md new file mode 100644 index 00000000..87d04842 --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/colorful_upgrade.md @@ -0,0 +1,5 @@ +# 变色升级 + +![漂亮的很呐。](item:computronics:oc_parts@7) + +此升级只能安装到机器人中。它提供了一个名为`colors`的组件，可用于修改机器人外壳的颜色。调用`robot.setLightColor`函数即可修改颜色，让你的机器人变得俊上加俊。 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/index.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/index.md new file mode 100644 index 00000000..683044d3 --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/index.md @@ -0,0 +1,53 @@ +# 计算电子学手册 + +此索引列出了计算电子学模组中所有物品的档案。如果你要找方块，请查看[方块索引](../block/index.md)。 + +请注意，根据所使用的配方不同以及是否在配置文件中启用，一部分物品可能不可用。 + +# 物品 + +* [盒式磁带](tape.md) +* [便携式磁带驱动器](portable_tape_drive.md) + +## 组件 + +### 升级 + +* [摄像头升级](camera_upgrade.md) +* [聊天升级](chat_upgrade.md) +* [雷达升级](radar_upgrade.md) +* [变色升级](colorful_upgrade.md) +* [语音升级](speech_upgrade.md) + +### 扩展卡 + +* [粒子效果卡](particle_card.md) +* [欺诈攻击卡](spoofing_card.md) +* [蜂鸣卡](beep_card.md) +* [噪音卡](noise_card.md) +* [声卡](sound_card.md) +* [自毁卡](self_destructing_card.md) + +### 机架式设备 + +* [指示灯面板](light_board.md) +* [开关面板](switch_board.md) +* [服务器自毁装置](server_self_destructor.md) +* [机架式电容器](rack_capacitor.md) + +### 其他 + +* [魔法内存条](magical_memory.md) + +# 适用于其他模组的物品 + +下列物品由计算电子学模组添加，以与其他模组联动。在当前整合包中不一定存在。 + +## Buildcraft + +* [无人机停靠站](buildcraft/drone_station.md) +* [无人机停靠升级](buildcraft/docking_upgrade.md) + +## Railcraft + +* [数字化中继器传感器](railcraft/relay_sensor.md) diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/light_board.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/light_board.md new file mode 100644 index 00000000..8392c6e9 --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/light_board.md @@ -0,0 +1,7 @@ +# 指示灯面板 + +![Notch说，要有光。](item:computronics:oc_parts@10) + +此面板可安装于机架中。它为用户提供了四个视觉指示灯，与其相连接的电脑可通过其提供的`light_board`组件对指示灯进行控制。 + +使用任意种类的[扳手](/%LANGUAGE%/item/wrench.md)与此面板交互即可改变其布局。请注意改变布局时其颜色设定会重置。 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/magical_memory.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/magical_memory.md new file mode 100644 index 00000000..a5c8b5f0 --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/magical_memory.md @@ -0,0 +1,5 @@ +# 魔法内存条 + +![助记符领域大神](item:computronics:oc_special_parts@0) + +这种神奇的设备是一类[内存条](/%LANGUAGE%/item/ram1.md)。它似乎可以将接收的数据存储到从周围环境、宇宙辐射、Scumm™和位翻转错误中收集到的字节中，这使其成为了一种及其强大的物品。幸运的是，这一神器既不能被拾到，也不能被合成。尽管专家倾向于声称此物品不会吸收宇宙，只会向电脑提供大量内存。但因为预算不足，我们尚未测试其对宇宙的影响，它也不是不可能导致世界崩溃。 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/noise_card.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/noise_card.md new file mode 100644 index 00000000..bbdbdcb5 --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/noise_card.md @@ -0,0 +1,21 @@ +# 噪音卡 + +![哔...滴...滋...](item:computronics:oc_parts@8) + +噪音卡类似于[蜂鸣卡](beep_card.md)也提供了`play()`函数。此外，它还可以分别设定其八个通道的发声模式，以发出方波、正弦波、三角波或锯齿波音频。 + +另外，此扩展卡还带有一个小型的内部缓存，可为每个通道分别存储至多八个频率-时长组合，以及一个可选的初始延时。调用`process()`函数后会一次性处理播放缓存内的全部内容。 + +示例代码： +` local card = require("component").noise` +` card.setMode(1, card.modes.sawtooth)` +` card.play({{440, 4}, {880, 2}})` +这段代码会播放4秒的440Hz锯齿波，同时播放2秒的880Hz方波。 + +使用了缓存的示例代码： +` local card = component.noise` +` card.setMode(1, card.modes.sawtooth)` +` card.add(1, 440, 4)` +` card.add(2, 880, 1, 2)` +` card.add(2, 220, 1)` +` card.process()` diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/particle_card.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/particle_card.md new file mode 100644 index 00000000..eb384466 --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/particle_card.md @@ -0,0 +1,5 @@ +# 粒子效果卡 + +![谁不喜欢漂亮的粒子效果呢？](item:computronics:oc_parts@3) + +粒子效果卡可以让电脑、机器人和无人机（需带有2级或以上的升级槽位）在指定位置创建粒子效果，位置为以设备为原点的相对坐标。只能将有效的Minecraft粒子效果名称提供给组件API函数。 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/portable_tape_drive.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/portable_tape_drive.md new file mode 100644 index 00000000..0a431de7 --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/portable_tape_drive.md @@ -0,0 +1,13 @@ +# 便携式磁带驱动器 + +![音乐常伴你身边](item:computronics:portable_tape_drive@0) + +便携式磁带驱动器是……[磁带驱动器](../block/tape_drive.md)的便携版本！你可以在其中插入磁带，并在你离开家门的时候播放音乐。此设备适合在长时间挖矿工作中提供娱乐，或是与你的朋友分享音乐。 + +### 控制键位： + + * `Shift + Right Click:` 打开操作界面 + + * `Right Click:` 切换播放或暂停状态 + + * `Shift-Scrolling:` 快进或倒带 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/rack_capacitor.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/rack_capacitor.md new file mode 100644 index 00000000..4e75a88b --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/rack_capacitor.md @@ -0,0 +1,7 @@ +# 机架式电容器 + +![能量尽在我掌控！](item:computronics:oc_parts@12) + +机架式电容器是一种可以装入[服务器机架](/%LANGUAGE%/block/rack.md)中的[电容器](/%LANGUAGE%/block/capacitor.md)。其作用与普通[电容器](/%LANGUAGE%/block/capacitor.md)相同，但机架式电容器无法获得相邻增益。 + +这种电容器会提供一个名为`rack_capacitor`的组件，通过此组件可随时查询电容器中的能量存量。这一功能有助于检测网络中是否存在供能问题。 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/radar_upgrade.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/radar_upgrade.md new file mode 100644 index 00000000..1a1d18dd --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/radar_upgrade.md @@ -0,0 +1,5 @@ +# 雷达升级 + +![警觉。](item:computronics:oc_parts@2) + +雷达升级提供了与[雷达](../block/radar.md)方块相同的功能，可被安装于带有3级升级槽位的机器人或无人机中。此升级能够让机器人和无人机探测周围的实体，例如玩家、动物或掉落物。 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/railcraft/relay_sensor.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/railcraft/relay_sensor.md new file mode 100644 index 00000000..1e747f33 --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/railcraft/relay_sensor.md @@ -0,0 +1,5 @@ +# 数字化中继器传感器 + +![单次使用。](item:computronics:relay_sensor) + +数字化中继器传感器的用途是将[数字化机车中继器](../../block/railcraft/locomotive_relay.md)与Railcraft模组的电力机车进行配对。配对过程为：先手持中继器传感器潜行右键单击[数字化机车中继器](../../block/railcraft/locomotive_relay.md)，然后潜行左键单击电力机车，以将中继器传感器附于其上。 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/self_destructing_card.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/self_destructing_card.md new file mode 100644 index 00000000..9d84fa18 --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/self_destructing_card.md @@ -0,0 +1,7 @@ +# 自毁卡 + +![方便易用。](item:computronics:oc_parts@6) + +自毁卡可令电脑或机器人在指定时间（默认为5秒）后自毁。设备会完全且不可逆的损毁。 + +你可以创建一张名为`explode`的软盘，其中须有一份名称与软盘相同的程序。这样能对自毁过程进行便利且可自定义的控制。 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/server_self_destructor.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/server_self_destructor.md new file mode 100644 index 00000000..949c2355 --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/server_self_destructor.md @@ -0,0 +1,7 @@ +# 服务器自毁装置 + +![艺术就是爆炸](item:computronics:oc_parts@11) + +你是否想过，机架在长期使用后会变得多么混乱和肮脏？自抱怪物工业公司的最新发明可解决此问题！这个发明就叫：SSD（Server Self-Destructor）！接收命令后，这台神奇的设备会先延时指定的时长，然后会清空其所在的和与其连接的所有[服务器机架](/%LANGUAGE%/block/rack.md)！实际上，机架甚至干净到你想象不出其中曾存在过其他机架式设备，但机架本身毫发无伤！多巧妙啊。 + +与[自毁卡](self_destructing_card.md)类似，此设备也可配合`explode`软盘使用，以实现便捷且可自定义的自毁过程。 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/sound_card.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/sound_card.md new file mode 100644 index 00000000..899d555b --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/sound_card.md @@ -0,0 +1,37 @@ +# 声卡 + +![♩♫♩♫♩♫♫♫♩♫♩♫♩♫♫♩♩♪♩♩♪♩♪♩♩♪♩♪♩♩♪♩♪♩♩♪♩♫♩♫♩♫♫♫♩♫♩♫♩♫♫♫♩](item:computronics:oc_parts@9) + +声卡是一个复杂的设备，可用于合成高解析度音频。与[噪音卡](noise_card.md)类似，它也能发出多种类型的声波。 + +声卡提供了八个通道，每个通道都可独立产生一个波形。但是，用户也可以指定任意通道去调节其他通道的频率和振幅。在此状态下，这一通道不会由自身产生音频，而是会改变所负载通道的波形。 + +声卡工作于一套基于指令的系统上。通过调用声卡提供的各种函数，用户可以向内部队列中添加指令。指令可以修改某通道波形的种类或频率，也可以指定一条通道调节另一条通道，还可以将[ADSR](https://en.wikipedia.org/wiki/Synthesizer#Attack_Decay_Sustain_Release_.28ADSR.29_envelope)应用于某条通道上，又或者改变通道的音量。 + +默认情况下所有通道均为关闭状态，用户需要使用响应指令将其开启。在关闭状态下，通道通常而言不会产生音频（除非应用了ADSR，这种情况下通道会启用释音阶段）。 + +为了能实际发出储蓄一段时长的音频，需使用delay（延时）指令，这条指令会让先前所有指令作出的更改生效。用户提供的时长数值应为毫秒，这是为了能够进行高解析度的合成。在所需的一切指令都加入队列后，可调用`process()`函数来处理所有指令，并生成音频。 + +样例： + +` local sound = require("component").sound` + +` sound.setWave(1, sound.modes.sine)` +` sound.setFrequency(1, 440)` +` sound.open(1)` +` sound.delay(1000)` +` sound.close(1)` +` sound.process()` + +此样例开启了第一通道，此时第一通道可在延时期间发声。样例中产生了440Hz的正弦波（相当于A4音符），持续到通道被关闭为止。 + +` sound.setWave(2, sound.modes.noise)` +` sound.setFrequency(2, 440)` +` sound.setVolume(2, 0.6)` +` sound.setADSR(2, 0, 250, 0, 0)` +` sound.open(2)` +` sound.delay(1500)` +` sound.close(2)` +` sound.process()` + +此样例开启了第二通道，令其发出440Hz的白噪音。其音量被设定为不全满，且使用了ADSR，令其音量在250ms内从设定值衰减到0. diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/speech_upgrade.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/speech_upgrade.md new file mode 100644 index 00000000..8af12a66 --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/speech_upgrade.md @@ -0,0 +1,5 @@ +# 语音升级 + +![世 界 毁 灭 计 划 执 行 中](item:computronics:oc_parts@14) + +语音升级可被装入带有2级或更高级升级槽位的机器人与无人机中。此升级的功能与[语音盒](../block/speech_box.md)相似，可令安装升级的设备输出人类语音。 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/spoofing_card.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/spoofing_card.md new file mode 100644 index 00000000..6563c4f3 --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/spoofing_card.md @@ -0,0 +1,5 @@ +# 欺骗攻击卡 + +![当你给网卡来一板砖后……](item:computronics:oc_parts@4) + +欺骗攻击卡与开放式电脑模组中的[网卡](/%LANGUAGE%/item/lanCard.md)功能相同，但这张扩展卡可以手动修改源地址信息，能轻易掩盖发送网络报文的真实设备。欺骗攻击卡需要T2或更高等级的扩展卡槽位才能安装。 diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/switch_board.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/switch_board.md new file mode 100644 index 00000000..a1d47d9a --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/switch_board.md @@ -0,0 +1,9 @@ +# 开关面板 + +![咔哒咔哒。](item:computronics:oc_parts@13) + +此面板可被装入服务器机架内。面板正前方有四个可点击的开关，开关可通过`switch_board`组件检查状态或激活。此外，当开关手动或自动改变状态时，面板会触发一个`switch_flipped`事件。 + +`switch_flipped`事件的格式如下所示。如果你不理解信号格式，可参考[这篇指南](http://ocdoc.cil.li/component:signals:zh)。 + +`switch_flipped(boardAddress:string, index:number, newState:boolean)` diff --git a/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/tape.md b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/tape.md new file mode 100644 index 00000000..8301a68f --- /dev/null +++ b/src/main/resources/assets/computronics/doc/opencomputers/computronics/zh_CN/item/tape.md @@ -0,0 +1,5 @@ +# 盒式磁带 + +![里面可能有音乐。](item:computronics:tape@0) + +盒式磁带可配合[磁带机](../block/tape_drive.md)使用，以录制和回放音频。磁带有不同型号，可容纳音频长度从2到128分钟不等，且能存储其他种类的信息（存储空间约等于磁带分钟数除以4，单位为MB）。录音格式为DFPWM，详见[磁带机](../block/tape_drive.md)文档。 diff --git a/src/main/resources/assets/computronics/doc/tis3d/computronics/zh_CN/item/colorful_module.md b/src/main/resources/assets/computronics/doc/tis3d/computronics/zh_CN/item/colorful_module.md new file mode 100644 index 00000000..e09d0bc0 --- /dev/null +++ b/src/main/resources/assets/computronics/doc/tis3d/computronics/zh_CN/item/colorful_module.md @@ -0,0 +1,7 @@ +# 变色模块 + +![过于漂亮了。](item:computronics:modules.tis3d@0) + +激活后，变色模块会持续从其全部四个端口读取数值。读取后，此模块会将自身颜色设定为读取到的值。 + +颜色由一个15位二进制数定义。其低5位定义了蓝色叠加量，中间5位定义了绿色叠加量，高5位定义了红色叠加量。例如，二进制数`000000000011111`（使用时需转换为十进制）代表纯蓝色。 diff --git a/src/main/resources/assets/computronics/doc/tis3d/computronics/zh_CN/item/index.md b/src/main/resources/assets/computronics/doc/tis3d/computronics/zh_CN/item/index.md new file mode 100644 index 00000000..55c01191 --- /dev/null +++ b/src/main/resources/assets/computronics/doc/tis3d/computronics/zh_CN/item/index.md @@ -0,0 +1,8 @@ +# Computronics Manual + +This index lists all of the documented TIS-3D modules in Computronics. + +## Modules +* [Colorful Module](colorful_module.md) +* [Tape Reader Module](tape_reader_module.md) +* [Self-Destructing Module](self_destructing_module.md) diff --git a/src/main/resources/assets/computronics/doc/tis3d/computronics/zh_CN/item/self_destructing_module.md b/src/main/resources/assets/computronics/doc/tis3d/computronics/zh_CN/item/self_destructing_module.md new file mode 100644 index 00000000..5f60f63d --- /dev/null +++ b/src/main/resources/assets/computronics/doc/tis3d/computronics/zh_CN/item/self_destructing_module.md @@ -0,0 +1,7 @@ +# 自毁模块 + +![极其便利。](item:computronics:modules.tis3d@2) + +此模块可以很方便地爆破销毁[外壳](/%LANGUAGE%/block/casing.md)及其周围的物品。激活后，此模块会持续从其全部四个端口读取数值。若模块读取到了一个大于等于0的数字，则它会将自身的定时器设定为这个值，并开始倒数。模块倒计时的速度取决于[控制器](/%LANGUAGE%/block/controller.md)的运行速度。如果模块在倒计时中接收到了一个新的数值，且这个数值比当前剩余时长更小，则定时器会被更改为新数值。 + +定时器归零后，模块和[外壳](/%LANGUAGE%/block/casing.md)都会自毁。设备会被彻底且不可逆地摧毁。 diff --git a/src/main/resources/assets/computronics/doc/tis3d/computronics/zh_CN/item/tape_reader_module.md b/src/main/resources/assets/computronics/doc/tis3d/computronics/zh_CN/item/tape_reader_module.md new file mode 100644 index 00000000..001864fc --- /dev/null +++ b/src/main/resources/assets/computronics/doc/tis3d/computronics/zh_CN/item/tape_reader_module.md @@ -0,0 +1,26 @@ +# 磁带驱动器模块 + +![向存储的烦恼说拜拜。](item:computronics:modules.tis3d@1) + +磁带驱动器模块可与共面放置的磁带驱动器交互，以向其内部的盒式磁带写入数据，或从中读取数据。如果磁带内的数据编码为[DFPWM](http://wiki.vex.tty.sh/dfpwm)格式，此模块还能播放磁带内的音乐。 + +磁带有不同型号，可容纳音频长度从2到128分钟不等，且能存储其他种类的信息（存储空间约等于DFPWM编码音频分钟数除以4，单位为MB）。 + +模块接收指令的方式如下所述：模块会持续从其全部四个端口读取数值。当模块接收到一个数值后，它会检查数值是否为有效的指令编号。若是，模块会继续执行该指令的下一阶段，可能为等待后续从某端口输入（一个参数），也可能为开始向全部四个端口写出返回值。指令执行完毕后，模块会继续从所有端口进行读取，等待输入指令。 + +可用指令如下： + +* `0`: isEnd - 若磁带驱动器未装入磁带或磁带到达末尾则返回1，否则返回0。Returns 1 if the tape drive is empty or the inserted tape has reached its end, 0 otherwise. +* `1`: isReady - 若磁带驱动器中已装入磁带则返回1，否则返回0。 +* `2`: getState - 返回磁带驱动器的当前状态，形式为数字。若磁带驱动器停止播放则返回`0`，若磁带驱动器正在播放则返回`1`，若磁带驱动器正在倒带则返回`2`，若磁带驱动器正在快进则返回`3`。 +* `3`: getSize - 返回磁带的容量，单位为字节，对1024取模。 +* `4`: getSize（KiB版本） - 返回磁带的容量，单位为KiB，向下取整。 +* `5`: setSpeed - 将磁带驱动器的播放速度设定为模块读取的下一个值，单位为百分比。输入值的有效范围为25到200。 +* `6`: setVolume - 将磁带驱动器的音量设定为模块读取的下一个值，单位为百分比。输入值的有效范围为0到100。 +* `7`: seek - 将磁带快进，数量为模块读取的下一个数值（单位为字节）。若输入负值则会反向快进（即倒带）。 +* `8`: seek（KiB版本） - 将磁带快进，数量为模块读取的下一个数值（单位为KiB）。若输入负值则会反向快进（即倒带）。 +* `9`: read - 从磁带读取一个字节，并返回。 +* `10`: read（多字节版） - 模块读取的下一个数值为读取量，单位为字节。模块会从磁带中读取指定数量的字节，并逐个返回。例如：传参`4`会令模块从磁带读取四次，并将结果输出到全部端口上，每读取磁带一次，返回一字节。 +* `11`: write - 将模块接收的下一个数值写入到磁带中。 +* `12`: write（多字节版） - 模块读取的下一个值会被认为是要写入磁带的字节数。后续成功读取的字节都会被写入到磁带中，直到数量达到设定值。 +* `13`: switchState - 将磁带驱动器的状态设定为模块读取的下一个值。请参见指令2（getState）以获取合法的传入值。 diff --git a/src/main/resources/assets/computronics/doc/tis3d/zh_CN/protocols/computronics/flamingo.md b/src/main/resources/assets/computronics/doc/tis3d/zh_CN/protocols/computronics/flamingo.md new file mode 100644 index 00000000..db8fb17b --- /dev/null +++ b/src/main/resources/assets/computronics/doc/tis3d/zh_CN/protocols/computronics/flamingo.md @@ -0,0 +1,5 @@ +# 粉红色火烈鸟 + +![对，这是真的。](block:Flamingo:flamingo.flamingo) + +我们可以利用串口模块未被记载的戳东西能力来让火烈鸟摆动。向串口模块写入任意数据即可令火烈鸟摆动，就像有人类戳了它一样。