MIDIVisualizer 项目教程

1. 项目目录结构及介绍

MIDIVisualizer 项目的目录结构如下：

MIDIVisualizer/
├── libs/
├── resources/
├── src/
├── .gitignore
├── CMakeLists.txt
├── LICENSE
├── README.md
├── help.png
├── result1.png
├── result2.png
└── result3.png

目录介绍：

• libs/: 包含项目依赖的库文件。
• resources/: 包含项目使用的资源文件，如图像和着色器。
• src/: 包含项目的源代码文件。
• .gitignore: Git 忽略文件，指定哪些文件或目录不需要被版本控制。
• CMakeLists.txt: CMake 配置文件，用于构建项目。
• LICENSE: 项目的许可证文件。
• README.md: 项目的说明文档。
• help.png: 帮助文档的图像文件。
• result1.png, result2.png, result3.png: 项目运行结果的示例图像文件。

2. 项目启动文件介绍

MIDIVisualizer 的启动文件是 src/ 目录下的主程序文件。具体文件名可能因版本不同而有所变化，但通常是 MIDIVisualizer.cpp 或类似的文件。

启动文件功能：

• 初始化窗口: 使用 OpenGL 创建一个窗口，用于显示 MIDI 文件的视觉效果。
• 加载 MIDI 文件: 从用户指定的路径加载 MIDI 文件。
• 渲染 MIDI 数据: 解析 MIDI 文件中的音符数据，并将其渲染为可视化的图形效果。
• 处理用户输入: 响应用户的键盘输入，如播放/暂停、重新开始等操作。

3. 项目的配置文件介绍

MIDIVisualizer 的配置文件通常是一个 .ini 文件，用于指定项目的各种显示参数和行为。配置文件的路径可以通过命令行参数指定。

配置文件示例：

[General]
midi_file = path/to/midi/file.mid
window_size = 1920 1080
fullscreen = 0

[Display]
color_bg = 0.0 0.0 0.0
flashes_size = 3.0
particles_count = 256
quality = HIGH
show_keyboard = 1

配置项说明：

• midi_file: 指定要加载的 MIDI 文件路径。
• window_size: 设置窗口的尺寸，格式为宽度和高度。
• fullscreen: 是否以全屏模式启动，0 表示否，1 表示是。
• color_bg: 设置背景颜色，格式为 RGB 值。
• flashes_size: 设置闪光效果的大小。
• particles_count: 设置粒子效果的数量。
• quality: 设置渲染质量，可选值为 LOW_RES, LOW, MEDIUM, HIGH, HIGH_RES。
• show_keyboard: 是否显示键盘，0 表示否，1 表示是。

通过配置文件，用户可以自定义 MIDIVisualizer 的显示效果和行为，以满足不同的需求。