Rust-SDL2_mixer

Rust对SDL2_mixer的绑定。

概述

Rust-SDL2_mixer是一个用于从Rust与新的SDL2_mixer库通信的库。

Rust-SDL2_mixer使用MIT许可。

要求

• Rust-SDL2
• SDL2_mixer开发库
• 最新稳定的Rust master

OSX

brew install sdl2_mixer --with-flac --with-fluid-synth --with-libmikmod --with-libmodplug --with-libvorbis --with-smpeg2

Windows

1. 从https://www.libsdl.org/projects/SDL_mixer/下载mingw开发库 (SDL2_mixer-devel-2.0.x-mingw.tar.gz)

2. 解压到您选择的文件夹（之后可以删除）。

3. 将以下lib文件从

   SDL2_mixer-2.0.x\x86_64-w64-mingw32\lib\

   复制到（对于Rust 1.6及以上版本）

   C:\Program Files\Rust\lib\rustlib\x86_64-pc-windows-gnu\lib

   或者（对于Rust版本1.5及以下）

   C:\Program Files\Rust\bin\rustlib\x86_64-pc-windows-gnu\lib

   或者您选择的库文件夹，并确保您有一个系统环境变量

   LIBRARY_PATH = C:\your\rust\library\folder

   对于Multirust用户，此文件夹将位于

   C:\Users{您的用户名}\AppData\Local.multirust\toolchains{当前工具链}\lib\rustlib\x86_64-pc-windows-gnu\lib

4. 从以下位置复制 SDL2_mixer.dll 和 smpeg2.dll

   SDL2_mixer-2.0.x\x86_64-w64-mingw32\bin\

   到您的cargo项目中，紧挨着您的 Cargo.toml 文件。

安装

将以下内容放入您项目的Cargo.toml文件中

[dependencies]
sdl2_mixer = "0.24.0"

或者，要依赖最新的rust-sdl2_mixer，请引用仓库

[dependencies.sdl2_mixer]
git = "https://github.com/andelf/rust-sdl2_mixer"

您也可以自己克隆并构建库

git clone https://github.com/andelf/rust-sdl2_mixer
cd rust-sdl2_mixer
cargo build
# TODO: OR if you are using the mac framework version
rustc --cfg mac_framework src/sdl2_mixer/lib.rs

如果您不使用Cargo，您可以手动编译库

git clone https://github.com/andelf/rust-sdl2_mixer
cd rust-sdl2_mixer
rustc src/sdl2_mixer/lib.rs

示例

包括一个简单的示例，它播放给定音乐文件的一部分。

cargo run --example demo path/to/music.(mp3|flac|ogg|wav)

许可

根据您的选择，许可为以下之一

• Apache License，版本2.0 (LICENSE-APACHE 或 https://apache.ac.cn/licenses/LICENSE-2.0)
• MIT许可 (LICENSE-MIT 或 http://opensource.org/licenses/MIT)

贡献

除非您明确声明，否则根据Apache-2.0许可证定义，您有意提交以包含在作品中的任何贡献，均应双重许可如上，不附加任何额外条款或条件。