FlipDots 项目使用教程

1. 项目目录结构及介绍

FlipDots 项目的目录结构如下：

FlipDots/
├── CastCanvas/
├── FlipDot/
│   ├── assets/
│   ├── gitignore
│   ├── LICENSE
│   ├── README.md
│   ├── example_3d_cube.gif
│   ├── example_blips.gif
│   ├── example_clouds.gif
│   ├── example_cluster_growth.gif
│   ├── example_squares.gif
│   └── config.pde
├── LICENSE
└── README.md

目录介绍

• CastCanvas/: 包含用于 JavaScript 版本的 FlipDot 控制代码。
• FlipDot/: 主要代码目录，包含处理 FlipDot 显示的 Processing 代码。
  • assets/: 存放项目所需的资源文件。
  • gitignore: Git 忽略文件配置。
  • LICENSE: 项目许可证文件。
  • README.md: 项目说明文件。
  • example_3d_cube.gif: 3D 立方体示例动画。
  • example_blips.gif: 点状动画示例。
  • example_clouds.gif: 云状动画示例。
  • example_cluster_growth.gif: 集群生长动画示例。
  • example_squares.gif: 方块动画示例。
  • config.pde: 项目配置文件。

2. 项目启动文件介绍

FlipDots 项目的启动文件是 FlipDot/FlipDot.pde。这个文件是 Processing 的主程序文件，负责初始化 FlipDot 显示并加载配置。

启动文件功能

• 初始化 FlipDot 显示: 设置 FlipDot 显示的参数，包括面板数量、位置等。
• 加载配置: 从 config.pde 文件中读取配置信息，包括串口设置、面板地址等。
• 绘制和动画: 通过 Processing 的绘图功能，在虚拟显示上绘制和动画，然后将图像传输到实际的 FlipDot 显示面板上。

3. 项目配置文件介绍

FlipDots 项目的配置文件是 FlipDot/config.pde。这个文件包含了项目的所有配置参数，包括串口设置、面板地址、显示设置等。

配置文件内容

• 串口设置: 配置串口通信参数，如波特率、串口地址等。
• 面板地址: 设置每个 FlipDot 面板的地址，用于区分不同的面板。
• 显示设置: 配置显示的分辨率、刷新率等参数。

配置示例

// 设置串口通信参数
serialAdapters = {
  { "COM1", 57600 },
  { "COM2", 57600 }
};

// 设置面板地址
panels[0] = new Panel(0, 1, 0, 0);
panels[1] = new Panel(1, 2, 28, 0);

// 设置显示参数
displayWidth = 56;
displayHeight = 14;
refreshRate = 20;

通过修改 config.pde 文件中的参数，可以自定义 FlipDots 项目的配置，以适应不同的硬件环境和需求。