rend3

Easy to use, customizable, efficient 3D renderer library built on wgpu.

Library is under active development. While internals are might change in the future, the external api remains stable, with only minor changes occuring as features are added.

Examples

Take a look at the examples for getting started with the api. The examples will show how the core library and helper crates can be used.

Screenshots

These screenshots are from the scene_viewer example.

Crates

The rend3 ecosystem is composed of a couple core crates which provide most of the functionality and exensibility to the library, extension crates, and integration crates

Core

• rend3: The core crate. Performs all handling of world data, provides the Renderer and RenderGraph and defines vocabulary types.
• rend3-routine: Implementation of various "Render Routines" on top of the RenderGraph. Also provides for re-usable graphics work. Provides PBR rendering, Skyboxes, Shadow Rendering, and Tonemapping.

Extensions

There are extension crates that are not required, but provide pre-made bits of useful code that I would recommend using.

• rend3-framework: Vastly simplifies correct handling of the window and surface across platforms.
• rend3-gltf: Modular gltf file and scene loader.

Integration

Integration with other external libraries are also offered. Due to external dependencies, the versions of these may increase at a much higher rate than the rest of the ecosystem.

• rend3-anim: Skeletal animation playback utilities. Currently tied to rend3-gltf.
• rend3-egui: Integration with the egui immediate mode gui.

Purpose

rend3 tries to fulfill the following usecases:

1. Games and visualizations that need a customizable, and efficient renderer.
2. Projects that just want to put objects on screen, but want lighting and effects.
3. A small cog in a big machine: a renderer that doesn't interfere with the rest of the program.

rend3 is not:

1. A framework or engine. It does not include all the parts needed to make an advanced game or simulation nor care how you structure your program. If you want a very basic framework to deal with windowing and event loop management, rend3-framework can help you. This will always be optional and is just there to help with the limited set of cases it can help.

Future Plans

I have grand plans for this library. An overview can be found in the issue tracker under the enhancement label.

Matrix Chatroom

We have a matrix chatroom that you can come and join if you want to chat about using rend3 or developing it:

If discord is more your style, our meta project has a channel which mirrors the matrix rooms:

Helping Out

We welcome all contributions and ideas. If you want to participate or have ideas for this library, we'd love to hear them!

License: MIT OR Apache-2.0 OR Zlib

lib.rs:

Utility library to play gltf animations.

This library is meant to be used together with rend3 and rend3-gltf and allows posing meshes according to the animation data stored in a gltf file.

In order to play animations, you need to:

• Create an AnimationData once when spawning your scene and store it.
• Each simulation frame, use pose_animation_frame to set the mesh's joints to a specific animation at a specific time.

For now, this library aims to be a simple utility abstraction. Updating the current state of the animation by changing the currently played animation or increasing the playback time should be handled in user code.