函数说明

核心概念

1.灯珠对象（LED）

代表矩阵中的单个 LED，可以单独控制颜色、闪烁、移动（光标）等。

• 获取灯珠：matrix.loc(x, y) 返回一个 LED 对象。

• 点亮： led.on(color)使用预定义颜色。

• 熄灭：led.off()。

• 设置颜色：led.setColor(color)。

• 闪烁：led.blink(times, interval)或 led.blink(color, times, interval)。

• 获取颜色：Color led.getColor() 返回预定义颜色枚举。

• 移动：led.fd(steps, color) ，移动后灯珠坐标会自动更新。

2. 行对象（Row）

代表矩阵的一整行，可快速设置该行所有灯珠的颜色。

• 获取行：matrix.setRow(row) 返回一个 Row 对象。

• 设置整行颜色：row.setColor(color)。

• 清空整行：row.clear()。

• 获取行内某个灯珠：row.loc(col) 返回 LED 对象。

3. 列对象（Column）

代表矩阵的一整列，功能类似 Row。

• 获取列：matrix.setColumn(col) 返回一个 Column 对象。

• 设置整列颜色：col.setColor(color)。

• 清空整列：col.clear()。

• 获取列内某个灯珠：col.loc(row) 返回 LED 对象。

4. 矩阵对象（MatrixLED）

代表整个矩阵，管理全局状态（如光标位置、亮度）和整体操作。

• 初始化：begin()。

• 清空：clear()。

• 显示：show()。

• 光标移动：fd(), bk(), rt(), lt(), moveTo()。

• 延时：delayMs(ms)。