Marsyas 开源项目教程

1. 项目目录结构及介绍

Marsyas 项目的目录结构如下：

marsyas/
├── apps/
├── cmake/
├── doc/
├── ext/
├── include/
├── lib/
├── scripts/
├── src/
├── tests/
├── CMakeLists.txt
├── LICENSE
├── README.md
└── ...

目录介绍

• apps/：包含 Marsyas 的应用程序代码。
• cmake/：包含 CMake 构建系统的配置文件。
• doc/：包含项目的文档文件。
• ext/：包含外部依赖库的代码。
• include/：包含 Marsyas 的头文件。
• lib/：包含 Marsyas 的库文件。
• scripts/：包含一些脚本文件，用于项目的构建和测试。
• src/：包含 Marsyas 的核心源代码。
• tests/：包含项目的测试代码。
• CMakeLists.txt：CMake 构建系统的根配置文件。
• LICENSE：项目的许可证文件。
• README.md：项目的介绍和使用说明。

2. 项目启动文件介绍

Marsyas 项目的启动文件通常位于 apps/ 目录下。每个应用程序都有一个对应的启动文件，例如 apps/myapps/myapp.cpp。

示例启动文件

// apps/myapps/myapp.cpp

#include <marsyas/system/MarSystemManager.h>

int main(int argc, char* argv[]) {
    // 创建 MarSystemManager
    Marsyas::MarSystemManager mng;

    // 创建一个 MarSystem 网络
    Marsyas::MarSystem* net = mng.create("Series", "net");

    // 添加一些 MarSystem 到网络中
    net->addMarSystem(mng.create("SoundFileSource", "src"));
    net->addMarSystem(mng.create("Gain", "gain"));
    net->addMarSystem(mng.create("AudioSink", "dest"));

    // 配置网络
    net->updControl("SoundFileSource/src/mrs_string/filename", Marsyas::MarControlPtr("example.wav"));
    net->updControl("Gain/gain/mrs_real/gain", Marsyas::MarControlPtr(1.0));

    // 运行网络
    while (net->getControl("SoundFileSource/src/mrs_bool/hasData")->to<Marsyas::mrs_bool>()) {
        net->tick();
    }

    // 清理资源
    delete net;

    return 0;
}

启动文件说明

• MarSystemManager：用于创建和管理 MarSystem 网络。
• MarSystem：Marsyas 的核心组件，用于处理音频数据。
• updControl：用于更新 MarSystem 的控制参数。
• tick：用于运行 MarSystem 网络的单个处理步骤。

3. 项目配置文件介绍

Marsyas 项目的配置文件通常位于 cmake/ 目录下，用于配置 CMake 构建系统。

示例配置文件

# cmake/MarsyasConfig.cmake

# 设置项目名称
project(Marsyas)

# 设置 C++ 标准
set(CMAKE_CXX_STANDARD 11)

# 添加源文件
add_executable(myapp apps/myapps/myapp.cpp)

# 链接库
target_link_libraries(myapp Marsyas)

配置文件说明

• project：定义项目名称。
• set(CMAKE_CXX_STANDARD 11)：设置 C++ 标准为 C++11。
• add_executable：添加可执行文件的源文件。
• target_link_libraries：链接 Marsyas 库。

通过以上配置文件，可以构建和运行 Marsyas 项目中的应用程序。