组件：红石
==================
此组件由[[item:redstone_card:zh|红石卡]]提供。

1级红石卡仅支持MC原版红石功能（单路模拟红石信号）。2级红石卡提供与其他模组红石系统的联动（集束红石和无线红石）。对于集束红石，在Minecraft 1.12版本我们仅支持Project Red（红石计划），在更低版本我们支持：RedLogic、Project Red（1.1版本）、MineFactory Reloaded（我的工厂重制版）。无线红石方面支持以下模组：WR-CBE、SlimeVoid's WR。

===get*与set*方法重载===

自patch release 1.7.3起，红石组件提供以下函数的重载版本：`getInput`、`getOuput`、`setInput`、`getBundledInput`、`getBundledOutput`以及`setBundledOutput`。

===get*与set*调用开销===

**get**方法为“直接”调用，且几乎无开销。实验中我每秒可以调用20000到22000次`getInput`方法。

**set**方法并非为“直接”调用，因此每tick最多只能调用一次。也就是说每秒钟可以调用约20次。除了间接成本（消耗剩余的tick）之外，调用**set**改变了输出的强度等级后机器上还会有额外的延迟。默认情况下，调用**set**每秒可以改变输出约6次。

使用这些重载变体的显著优势之一是，API调用开销为每次调用后结算，而不是每次设定数值后结算。

组件名：`redstone`。

回调函数：

- `getInput(side: number): number`  
  `getInput(): table`  

返回当前输入的（非集束）红石信号值。`getInput(side)`会返回指定[[api:sides:zh|方向]]上的红石信号等级。`getInput()`会返回包含所有方向上红石信号等级的表。  
请注意返回的表的索引从0开始。因为表的索引其实是方向的原始值，`sides.bottom`对应了0。  
还需注意此函数用到的方向是相对于电脑而言的。即`sides.south`为**电脑的前方**，而不是世界的南方。类似还有`sides.left`为电脑的左侧，也就是说如果你站在电脑面前的话，在你的右侧。  
如果使用了例如RedLogic这样的模组，输入值可能会超出MC原版的[0, 15]范围。

```lua
lua> component.redstone.getInput(sides.left)
15
lua> component.redstone.getInput(sides.right)
4
lua> component.redstone.getInput()
{[0]=7,
 0,
 0,
 0,
 4,
 15}
lua> component.redstone.getInput()[sides.bottom]
7
```

- `getOutput(side: number): number`  
  `getOutput(): table`  
获取指定方向上输出的设定值，若不含参数调用则返回所有方向上的设定值。

```lua
lua> component.redstone.getOutput(sides.left)
7
lua> component.redstone.getOutput() [sides.left]
7
```

- `setOutput(side: number, value: number): number`  
  `setOutput(values: table): table`  
设定要发出的红石信号强度。返回**旧的**值。配合支持的mod时可以为很大的值。此方法的参数为[[api:sides:zh|方向]]以及要应用到此方向的红石信号强度。`setOutput(values)`这种写法可以在一次调用内设定所有方向（或数个方向）上的红石信号强度。  
\\
- `getBundledInput(side: number, color: number): number`  
  `getBundledInput(side: number): table`  
  `getBundledInput(): table`  
和`getInput`类似，但适用于集束输入。读取指定[[api:colors:zh|颜色]]对应通道的值。  
**对OC 1.3而言：**仅可用于2级红石卡。  
  `getBundledInput(side, color)`返回指定方向上输入的指定颜色红石信号强度值。  
  `getBundledInput(side)`返回一个表（格式为Map[Int, Int]这样的表结构），整合了指定方向上红石信号值，索引值为颜色。  
  `getBundledInput()`返回所有的红石信号值，包括所有方向以及所有颜色。格式为Map[Int, Map[Int, Int]]这样的两层表结构。外层表的索引值范围是[0, 5]，值为[[api:sides:zh|方向]]（请记住`sides.bottom`为0）。每个方向对应内层表的数据结构与`getBundledInput(side)`返回值相同。  
\\
- `getBundledOutput(side: number, color: number): number`  
  `getBundledOutput(side: number): table`  
  `getBundledOutput(): table`  
类似`getOutput`，但是适用于集束输出。用于获取先前设定的输出值。  
**对OC 1.3而言：**仅可用于2级红石卡。  
\\
- `setBundledOutput(side: number, color: number, value: number): number`  
类似`setOutput`，但是适用于集束输出。用于设定指定[[api:colors:zh|颜色]]对应通道的输出值。返回之前设定的值。  
  `setBundledOutput(side, values)`设定一组红石信号值，以颜色为索引，颜色取值范围为[0, 15]，`colors.white`为0。提供的值不一定要连续，省略的值将会保持不变。  
  `setBundledOutput(values)`让你能在单次API调用中修改所有方向上所有颜色的红石信号值。  
**对OC 1.3而言：**仅可用于2级红石卡。\\

```lua
lua> component.redstone.setBundledOutput(sides.left, { [colors.white] = 15 } ) -- only sets 1 output
lua> component.redstone.setBundledOutput({ [sides.left] = { [colors.white] = 15 } } ) -- same as above
```

- `getComparatorInput(side:number):number`  
  获取指定方向上的比较器输入。  
\\
- `getWirelessInput():number`  
  获取无线红石输入值。  
**自OC 1.3起添加：**仅可用于2级红石卡。\\
\\
- `getWirelessOutput():boolean`  
  获取无线红石输出值。  
**自OC 1.3起添加：**仅可用于2级红石卡。\\
\\
- `setWirelessOutput(value:boolean):boolean`  
  设定无线红石输出值。  
**自OC 1.3起添加：**仅可用于2级红石卡。\\
\\
- `getWirelessFrequency():number`  
  获取当前设定的无线红石频率。  
**自OC 1.3起添加：**仅可用于2级红石卡。\\
\\
- `setWirelessFrequency(frequency:number):number`  
  设定要使用的无线红石频率。  
**自OC 1.3起添加：**仅可用于2级红石卡。\\
\\
- `getWakeThreshold():number`  
  获取当前唤醒阈值。  
\\
- `setWakeThreshold(threshold:number):number`  
  将唤醒阈值设定为给定数字。\\

请注意对于如ProjectRed（红石计划）这样的模组而言，较低的强度值（例如原版最高为15的强度值）可能不会像预期一样起到简单开/关信号的作用（例如用于开门）。因为这些模组的红石信号值范围更大。你可能需要指定一个更大的值，例如255。\\

使用例：
```lua
local component = require("component")
local sides = require("sides")
local colors = require("colors")
local rs = component.redstone --获取首选红石组件
print(rs.getInput(sides.back))
rs.setBundledOutput(sides.bottom, colors.green, rs.getBundledInput(sides.top, colors.red))
```
`
目录
----
{{page>component:contents:zh&noheader&noeditbutton&nouser&nofooter}}