#assimp #3d #gltf #blend #3ds #assets

bin+lib russimp-sys

Raw Assimp bindings for Rust

23 releases (6 stable)

2.0.2 Jan 27, 2024
2.0.1 Oct 31, 2023
2.0.0 Jan 29, 2023
1.0.3 Oct 12, 2022
0.1.6 Dec 17, 2020

#142 in Rendering

Download history 167/week @ 2023-12-18 112/week @ 2023-12-25 106/week @ 2024-01-01 89/week @ 2024-01-08 131/week @ 2024-01-15 56/week @ 2024-01-22 61/week @ 2024-01-29 40/week @ 2024-02-05 44/week @ 2024-02-12 94/week @ 2024-02-19 129/week @ 2024-02-26 194/week @ 2024-03-04 96/week @ 2024-03-11 67/week @ 2024-03-18 28/week @ 2024-03-25 180/week @ 2024-04-01

382 downloads per month
Used in 2 crates (via russimp)

Custom license

165KB
279 lines

russimp-sys russimp-sys Crates.io

Unsafe Rust bindings for the Open Asset Import Library (assimp).
See: Our safe assimp Rust library

Raw bindings for the C API of assimp.

Platform Support

We build, test, and provide prebuilt packages for the following targets:

  • x86_64-pc-windows-msvc
  • x86_64-apple-darwin
  • x86_64-unknown-linux-gnu

Additional targets that work when building from source:

  • aarch64-apple-darwin (M1 Macs, cross-compiled on x86_64.)
  • aarch64-unknown-linux-gnu (Raspberry Pi 4b, built on the machine itself.)

Platforms that are not supported and won't build:

Installation

By default russimp-sys is looking for the assimp library in the system.
However there are many ways for the crate to install the library for you by specifying these crate features:

prebuilt

This features will download a prebuilt package from this repo's release page, these packages are built and published automatically every time we release a new version.

In addition, you can specify a local package by setting the RUSSIMP_PACKAGE_DIR environment variable to the path of the package. You can run the provided package binary to generate a package for your platform.

cargo run --bin package --features <INSERT-LINK-TYPE>

The build-assimp feature will build the library from source and link it dynamically.
The static-link feature will build the library from source and link it statically.

Building from source requires the following dependencies:

  • CMake
  • libclang (for bindgen)
  • A C/C++ compiler
  • RECOMMENDED: Ninja (For Windows users the buildscript automatically uses Ninja if it finds it in the PATH)

Additional Features:

nozlib

By default russimp-sys will statically link zlibstatic. Enabling this feature will link to the system's zlib library.

Changelog

2.0.2

  • Window build fix

2.0.0

  • Complete overhaul of the build process.

  • Expose all assimp headers.

  • Rework CI pipeline.

  • Support for local assimp packaging and local package usage. (See: prebuilt feature)

  • Remove vcpkg support.

  • Remove nolibcxx feature.

1.0.3

  • Builds based on 5.2.5 release

1.0.0

Dependencies

~2–15MB
~185K SLoC