Bonzomatic 使用指南

1. 项目目录结构及介绍

Bonzomatic 是一个实时着色器编码工具，它允许用户在后台运行的情况下编辑2D片段/像素着色器。下面是对项目主要目录结构的概览：

• master：默认的主分支。
• github/workflows：包含了GitHub Actions的工作流配置。
• data: 存放数据相关文件，可能包括测试数据或示例配置。
• external：外部依赖库或者工具，可能用于构建过程。
• package：如果存在，可能是指定的软件包配置或分发相关。
• src: 主要源代码存放位置，包含应用的核心逻辑。
• .editorconfig: 确保跨编辑器的代码风格一致性。
• .gitignore: 忽略不需要纳入版本控制的文件类型。
• travis.yml: Travis CI的配置文件（尽管项目似乎已迁移至GitHub Actions）。
• CMakeLists.txt: CMake构建系统的主要配置文件。
• LICENSE: 许可证文件，说明了该项目的授权方式。
• README.md: 项目的基本介绍和快速入门指南。
• appveyor.yml: AppVeyor的CI配置文件，针对Windows平台的自动化构建。
• 其他脚本文件如cmake_all.bat, 用于辅助构建流程。

2. 项目启动文件介绍

虽然具体的启动文件名未直接提及，但基于常规的开源项目结构，Bonzomatic的执行入口很可能是在 src 目录下的某个主程序文件，例如可能是 main.cpp 或类似的启动点。为了运行项目，通常需要先编译生成可执行文件。用户可以通过提供的CMakeLists.txt来配置和构建整个项目。编译成功后，生成的可执行文件是启动Bonzoamtic的入口，通常位于构建目录下，名字类似于 bonzomatic 或 Bonzomatic.app （对于macOS）。

3. 项目的配置文件介绍

Bonzomatic支持通过创建config.json文件来进行自定义配置。这个文件可以放置在与二进制执行文件相同的目录中，或是以参数形式指定其路径。以下是配置文件的潜在结构及其各部分的意义：

• skipSetupDialog：布尔值，决定是否跳过设置对话框，直接采用配置文件中的值。
• 窗口设置 (window)：定义启动时的窗口大小和全屏状态。
• 音频设置 (audio)：控制音频输入和输出设备。
• 字体设置 (font)：指定字体文件路径和大小。
• 渲染设置 (rendering)：如FFT平滑因子和放大率，影响视觉效果。
• 纹理设置 (textures)：将特定的图片文件映射到着色器变量名上。
• GUI设置 (gui)：调整编辑器的显示特性，比如输出高度、透明度等。
• MIDI设置 (midi)：配置MIDI控制器与着色器变量的关联。
• NDI流媒体设置 (ndi)：若启用，则配置网络数字接口流的发送选项。
• 颜色主题 (theme)：自定义代码编辑界面的颜色。
• 退出命令 (postExitCmd)：退出应用时执行的命令，可用于自动备份等功能。

为了应用这些配置，需确保在启动前配置文件正确设置且可被程序识别。这允许用户依据个人偏好或不同场景定制工作环境。