# 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 点阵器件的外观。

## 手形工具行为

无。

## 文本工具行为

无。

返回 库参考手册