12 releases
0.2.2 | Apr 22, 2021 |
---|---|
0.2.1 | Apr 22, 2021 |
0.1.8 | Nov 12, 2020 |
0.1.7 | Jan 16, 2020 |
0.1.1 | Mar 29, 2019 |
#615 in Audio
23,140 downloads per month
Used in 35 crates
(5 directly)
2.5MB
46K
SLoC
Contains (obscure autoconf code, 35KB) opus/configure.ac
About
audiopus_sys
is an FFI-Rust-binding to Opus
version 1.3.
Orginally, this sys-crate was made to empower the serenity
-crate to build audio features on Windows, Linux, and Mac. However, it's not limited to that.
Everyone is welcome to contribute,
check out the CONTRIBUTING.md
for further guidance.
Building
Requirements
If you want to build Opus, you will need cmake
.
If you have pkg-config
, it will attempt to use that before building.
You can also link a pre-installed Opus, see Pre-installed Opus below.
This crate provides a pre-built binding. In case you want to generate the
binding yourself, you will need Clang
,
see Pre-installed Opus below for further
instructions.
Linking
audiopus_sys
links to Opus 1.3 and supports Windows, Linux, and MacOS
By default, we statically link to Windows, MacOS, and if you use the
musl
-environment. We will link dynamically for Linux except when using
mentioned musl
.
This can be altered by compiling with the static
or dynamic
feature having
effects respective to their names. If both features are enabled,
we will pick your system's default.
Environment variables named LIBOPUS_STATIC
or OPUS_STATIC
will take
precedence over features thus overriding the behaviour. The value of these
environment variables have no influence of the result: If one of them is set,
statically linking will be picked.
Pkg-Config
By default, audiopus_sys
will use pkg-config
on Unix or GNU.
Setting the environment variable LIBOPUS_NO_PKG
or OPUS_NO_PKG
will bypass
probing for Opus via pkg-config
.
Pre-installed Opus
If you have Opus pre-installed, you can set LIBOPUS_LIB_DIR
or
OPUS_LIB_DIR
to the directory containing Opus.
Be aware that using an Opus other than version 1.3 may not work.
Generating The Binding
If you want to generate the binding yourself, you can use the
generate_binding
-feature.
Be aware, bindgen
requires Clang and its LIBCLANG_PATH
environment variable to be specified.
Installation
Add this to your Cargo.toml
:
[dependencies]
audiopus_sys = "0.2"