rust-av/opus-rs

libopus bindings

libopus bindings

It is a simple binding and safe abstraction over libopus.

Building

To build the code, always have a look at CI to install the necessary dependencies on all supported operating systems.

Building with vcpkg for Windows x64

To build with vcpkg, you need to follow these steps:

1. Install pkg-config through chocolatey

   choco install pkgconfiglite
   

2. Install opus

   vcpkg install opus:x64-windows
   

3. Add to the PKG_CONFIG_PATH environment variable the path $VCPKG_INSTALLATION_ROOT\installed\x64-windows\lib\pkgconfig

4. Build code

   cargo build --workspace
   

To speed up the computation, you can build your packages only in Release mode adding the set(VCPKG_BUILD_TYPE release) line to the $VCPKG_INSTALLATION_ROOT\triplets\x64-windows.cmake file.

Building for Windows x86 is the same, just replace x64 with x86 in the steps above.

TODO

• Simple bindings
• Safe abstraction
• Examples

opus-rs's Issues

Update to use dyn when needed

High level abstraction

It provides a av-codec-compatible interface built upon the intermediate abstraction.

• Decoding side
  • Basic support (i16-format stereo only)
  • Extended support (f32-format, proper channel mapping)
• Encoding side
  • Basic support (i16-format stereo only)
  • Extended support (f32-format, proper channel mapping)

Document the low level wrapper

• Document Decoder
• Document Encoder

Write Examples

• simple decoder
• simple encoder

opus_demo is a good reference.

Intermediate abstraction

The intermediate abstraction provide a safe layer over the unsafe rust-bindgen bindings.

• Decoding side
  • Allocation
  • Setup
  • Decoding
  • Query
  • Testing
• Encoding side
  • Allocation
  • Setup
  • Encoding
  • Query
  • Testing

Add travis support

Similar to speexdsp-rs's requirements

• run the autotools autoreconfig
• setup the pkg-config paths
• use cargo