Lib.rs

The libindigo-sys crate is a bindgen generated FFI for the upstream INDIGO source code in C found on GitHub.

[!CAUTION] Using libindigo-sys directly instead of the libindigo API means writing a lot of unsafe Rust code based on C-pointers.

For more information on using the INDIGO system API, please refer to INDIGO For Developers.

The NOTES document contains some raw notes on how to compile and set the development environment for libindigo-sys. At some point these raw notes should be upgraded to proper documentation.

The libindigo-sys crate will do one of the following in order of priority when building the crate

1. Attempt to build INDIGO from the path of the envar INDIGO_SOURCE, if specified.

2. Attempt to build INDIGO from the path of the git submodule externals/indigo, if it has been initialised by git.

   git submodule update --init --recursive
   

3. Use INDIGO system headers in /usr/include and libs from /usr/lib, if /usr/include/indigo/indigo_version.h exists.

4. Initialise the git externals/indigo git submodule with the command above and build it.