https://github.com/jkvargas/russimp

Assimp bindings for Rust
https://github.com/jkvargas/russimp

Last synced: 3 months ago
JSON representation

Assimp bindings for Rust

• Host: GitHub
• URL: https://github.com/jkvargas/russimp
• Owner: jkvargas
• License: other
• Created: 2020-11-14T15:07:20.000Z (almost 4 years ago)
• Default Branch: master
• Last Pushed: 2024-02-04T05:27:54.000Z (9 months ago)
• Last Synced: 2024-07-11T04:34:08.942Z (4 months ago)
• Language: Rust
• Size: 10.1 MB
• Stars: 79
• Watchers: 5
• Forks: 26
• Open Issues: 8
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# russimp ![russimp](https://github.com/jkvargas/russimp/workflows/russimp/badge.svg?branch=master) [![Crates.io](https://img.shields.io/crates/v/russimp.svg)](https://crates.io/crates/russimp)

Rust bindings for Assimp (https://github.com/assimp/assimp)

# Overview

Russimp is a library for talking to the assimp library which enables you to read 3d models in different formats to a common structure.

By default, russimp looks for the `assimp` library on your computer.  To install it:

* OSX: You will need to update brew and install assimp with it.

* Linux: You will need to install assimp through your package manager of choice.

* Windows: You can use the prebuilt version ```russimp = { version = "1.0.5", features = ["prebuilt"] }```

Alternately, you may prefer to use prebuilt assimp binaries or compile it yourself; in either case russimp will statically link assimp into your binary.  Russimp exposes the following Cargo features to manage the assimp dependency (this documentation is reproduced from [russimp-sys](https://github.com/jkvargas/russimp-sys)):

## `prebuilt`

Download prebuilt `Assimp` static library binaries from github and skip building from source.

Because `Assimp` build is slow and have build environment requirements. We provide prebuilt binaries for common platforms and features.

When a new version is released, github action automatically runs pre-build tasks, and all prebuilt binaries are saved in [github releases](https://github.com/jkvargas/russimp-sys/releases).

The `russimp-sys` build script will try to download the prebuilt binaries from github first, and skip the full source build.

## `static-link`

Enabling `static-link` feature without `prebuilt` feature will build `assimp` from source.

Builds from source need the following dependencies:

* cmake

* clang

* Ninja for Linux and MacOS, Visual Studio 2019 for Windows

### `nozlib`

By default `russimp-sys` will statically link zlibstatic, you can disable this feature if it conflicts with other dependencies.

# Helping

You are very welcome to help with development, adding a feature, fixing a problem or just refactoring.

Try to do it with tests =)

Make sure to run cargo fmt before creating a pull request.

# How to use it?

Use `Scene::from_file` to load a scene from a given file or `Scene::from_buffer` to load the scene directly from memory. If you want, you can give `PostProcess` flags to change the scene structure according to your needs. From the scene, you will have access to the underlying structs.

```rust        

let scene = Scene::from_file("myfile.blend",

vec![PostProcess::CalculateTangentSpace,

     PostProcess::Triangulate,

     PostProcess::JoinIdenticalVertices,

     PostProcess::SortByPrimitiveType]).unwrap();

// Progress The Scene...

```

### Changelog

The Changelog can be found [Here](CHANGELOG.md)