LED 矩阵
| 库： | 输入/输出 |
| 引入版本： | 2.2.0 |
| 外观： |
|
行为
显示由像素组成的网格，每个像素的点亮状态由输入决定。该网格最多可包含 32 行、32 列。
引脚
该组件的引脚接口会随 输入格式
属性而变化。它有三种可能的取值。
- 按列输入
- 输入端排列在组件的南侧边缘：点阵的每一列对应一个多位输入端。每个输入端的位数等于点阵的行数，其中低位（最低有效位）对应该列最下方（最南端）的像素点。位值为 1 表示点亮对应像素，位值为 0 表示保持熄灭。若某一列的任意位出现悬空或错误值，则该列所有像素都会点亮。
- 按行输入
- 输入端排列在组件的西侧边缘：点阵的每一行对应一个多位输入端。每个输入端的位数等于点阵的列数，其中低位（最低有效位）对应该行最右侧的像素点。与“按列输入”类似，位值为 1 表示点亮对应像素，位值为 0 表示保持熄灭。若某一行的任意位出现悬空或错误值，则该行所有像素都会点亮。
- 行/列选通
-
组件西侧边缘有两个输入端：上方的多位输入端位数等于点阵的列数，低位对应最右侧的列；下方的多位输入端位数等于点阵的行数，低位对应最底部的行。若任一输入端中出现悬空或错误值，则整个点阵所有像素都会点亮。
正常情况下，某个“列-行”位置的像素点亮，当且仅当：上方输入端中对应列的那一位为 1，并且下方输入端中对应行的那一位也为 1。
例如：对于一个 5×7 点阵（5列7行），若第一个输入（列）为 01010、第二个输入（行）为 0111010，那么第 2、4 列会在第 2、3、4、6 行点亮；整体看起来像是一对感叹号。 （这种输入格式可能看起来不直观，但市面上销售的 LED 点阵模块正是采用这种接口。例如 Lite-On 就有类似器件。）
属性
- 输入格式
- 选择引脚与像素之间的对应方式，如上所述。
- 列数
- 设置矩阵的列数，范围为 1 到 32。
- 行数
- 设置矩阵的行数，范围为 1 到 32。
- 点亮颜色
-
设置像素点在
点亮
时的颜色。 - 熄灭颜色
-
设置像素点在
变暗
时的颜色。 - 持续发光时间
- 当该值不为 0 时，如果输入从“应点亮”变为“应熄灭”，像素仍会在随后指定的时钟 tick 数内保持点亮。
- 像素形状
-
方形
表示每个像素绘制为 10×10 的方块，像素之间无间隙，填满整个组件；圆形
表示每个像素绘制为直径为 8 的圆点，各圆点之间留有间隙；带间距方形
表示每个像素绘制为 6×6 的方块，但方块之间留有间隙。 圆形模式更不易辨认，但更接近市售 LED 点阵器件的外观。
手形工具行为
无。
文本工具行为
无。