PixelController 使用指南

PixelController 使用指南

PixelController(LED) Matrix Control Software, supports various Hardware, Keywords: LED Matrix, OSC, Realtime, VJ, Arduino, Teensy, RPI项目地址:https://gitcode.com/gh_mirrors/pi/PixelController

一、项目目录结构及介绍

PixelController 是一个高度可定制化的LED控制软件，支持通过不同的硬件设备和协议来驱动LED矩阵显示丰富多彩的视觉效果。以下是其基本的目录结构概述：

PixelController/
├── bin                  # 可执行文件目录，包括主程序PixelController.jar
├── config               # 配置文件夹，存放所有相关配置文件如config.properties
│   ├── config.properties # 核心配置文件，定义输出设备、分辨率等
├── console              # 控制台脚本，用于不同操作系统启动PixelController的控制台版本
│   ├── PixelController.sh   # Linux/OSX 启动脚本
│   └── PixelController.cmd   # Windows 启动脚本
├── data                 # 数据文件夹，可能包含预设、图片等资源
├── doc                  # 文档资料
├── lib                  # 依赖库，包含了Java运行必要的jar包
├── src                  # 源代码，项目开发源码所在
│   ├── main             # 主要业务逻辑代码
│   └── test             # 测试代码
└── ...

二、项目的启动文件介绍

核心启动文件：PixelController.jar

• 路径：bin/PixelController.jar
• 如何启动
  • 图形界面：双击 PixelController.jar 文件即可在支持Java环境的系统中启动带GUI的版本。
  • 命令行接口：对于无GUI环境或希望以命令行操作的用户，在 console 目录下，依据操作系统选择对应的脚本。例如，在Linux或Mac上使用 ./PixelController.sh；在Windows环境下则运行 PixelController.cmd。

控制台模式

控制台模式特别适合远程管理或部署于如Raspberry Pi这样的嵌入式平台，提供了一种通过命令行与软件交互的方式，便于自动化控制。

三、项目的配置文件介绍

config.properties

• 位置：config/config.properties
• 关键参数解析
  • 输出分辨率：通过 output resolution x=8 和 output resolution y=8 设置LED矩阵的宽度和高度。
  • 连接设置：默认情况下未配置输出设备，需手动修改此文件配置连接至特定硬件的方式，如ArtNet协议的设备等。
  • 高级选项：该文件还包含了大量其他配置项，比如是否启用声音分析 (sound analyze) 来根据音乐节奏变化显示效果。

配置过程涉及编辑上述文件，确保Java runtime版本至少为1.6，以保证软件正常运行。此外，详细调整输出设备、处理模式（如是否使用pass-through模式）以及视觉更新速率等，均在此文件中进行。

以上是PixelController的基本介绍，涵盖了核心目录结构、启动方式及其核心配置文件的概览。深入探索时，还需参考源码注释和官方文档获取更详尽的信息。

PixelController(LED) Matrix Control Software, supports various Hardware, Keywords: LED Matrix, OSC, Realtime, VJ, Arduino, Teensy, RPI项目地址:https://gitcode.com/gh_mirrors/pi/PixelController