ispc-rs
A small library meant to be used as a build dependency with Cargo for easily integrating ISPC code into Rust projects.
Documentation
Rust doc can be found here, ISPC documentation can be found here.
Using ispc-rs
You'll want to add a build script to your crate (build.rs
), tell Cargo about it and add this crate
as a build dependency and optionally as a runtime dependency if you plan to use the ispc_module
macro
or ISPC tasks.
# Cargo.toml
[]
# ...
= "build.rs"
[]
= "0.3.7"
[]
= "0.3.7"
Now you can use ispc
to compile your code into a static library:
extern crate ispc;
Running cargo build
should now build your ISPC files into a library and link your Rust
application with it. For extra convenience the ispc_module
macro is provided to import
bindings to the library generated with rust-bindgen
into a module of the same name. Note that all the functions imported will be unsafe as they're
the raw C bindings to your lib.
extern crate ispc;
// Functions exported from simple will be callable under simple::*
ispc_module!;
Some more complete examples can be found in the examples/ folder.
Compile-time Requirements
Both the ISPC compiler and libclang (for rust-bindgen) must be available in your path.
Windows Users
You'll need Visual Studio and will have to use the MSVC ABI version of Rust since ISPC
and Clang link with MSVC on Windows. For bindgen to find libclang you'll need to copy
libclang.lib
to clang.lib
and place it in your path.
Multiple ISPC Files: Unfortunately with multiple ISPC files when building with debug symbols some of the debug symbols for each compiled object will conflict, resulting in link errors and your program failing to compile. The workaround for this on Windows is to not build the ISPC code with debugging info if you're using multiple ISPC files, see the multi file example.