• Stars
    star
    1,058
  • Rank 43,617 (Top 0.9 %)
  • Language
    Rust
  • License
    Apache License 2.0
  • Created about 4 years ago
  • Updated 5 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

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

rend3

GitHub Workflow Status Crates.io Documentation License Matrix Matrix Discord

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.

scifi-base example bistro emerald-square

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-anim: Skeletal animation playback utilities. Currently tied to rend3-gltf.
  • 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-egui: Integration with the egui immediate mode gui.
  • rend3-imgui: Integration with the imgui immediate mode gui.

Features and Platform Support

rend3 supports two different rendering profiles one for speed and one for compatibility.

Profile Features

The modern profile not only offloads a lot more work to the gpu, it can do more aggressive performance optimizations including only drawing exactly the triangles that are needed

Profile Texture Access Object Culling Triangle Culling Draw Calls
GpuDriven Bindless On GPU On GPU Merged Indirect
CpuDriven Bound On CPU Instanced Direct

Profile Support

The following table shows support of various profiles on various apis/platforms. This will hopefully help you judge what your target demographic supports.

OS API GPU GpuDriven CpuDriven
Windows 7+ Vulkan AMD / NVIDIA
Vulkan Intel 6XXX+
Dx11 Intel 2XXX+ 🚧
Windows 10+ Dx12 Intel 6XXX+ / AMD GCN 2+ / NVIDIA 6XX+ 🚧
MacOS 10.13+ iOS 11+ Metal Intel / Apple A13+ / M1+
Apple A9+
Linux Vulkan Intel 6XXX+ / AMD GCN 2+ / NVIDIA 6XX+
Intel 4XXX+
Android Vulkan All

Footnotes:

  • Supported
  • 🚧 In Progress
  • Unsupported
  • — Modern Profile Used
  • Intel 6XXX = Skylake
  • Intel 4XXX = Haswell
  • Intel 2XXX = Sandy Bridge
  • AMD GCN 2 = Rx 200+, RX 5000+
  • Apple A9 = iPhone 6S, iPad 5th Gen
  • Apple A13 = iPhone 11, iPad 9th Gen

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 canhelp

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:

Matrix Matrix

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

Discord

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

More Repositories

1

switchyard

Real-time compute-focused async executor with job pools, thread-local data, and priorities.
Rust
64
star
2

bve-reborn

Remaking OpenBVE using a modern architecture, using Rust.
Rust
51
star
3

ktx2

ktx2 parsing library
Rust
12
star
4

wgpu-conveyor

Buffer belt abstraction for wgpu supporting UMA optimization, automatic resizing, and a bind group cache.
Rust
10
star
5

ctct

Compressed Texture Container Tool: A tool and library for dealing with containers of compressed textures (dds, ktx, etc).
Rust
8
star
6

pacy

Rust frame pacing and frame timing lib
Rust
7
star
7

shader-types

DO NOT USE THIS CRATE - Vector and Matrix types that are properly aligned for use in std140 uniforms.
Rust
5
star
8

bve-reborn-archive

Mirror of https://gitlab.bvereborn.com/bve-reborn/bve-reborn-archive. Remake of OpenBVE to a Modern Architecture
C++
4
star
9

repo-procedures

Checklists for repo management
3
star
10

bvestl

Mirror of Mirror of https://gitlab.bvereborn.com/bve-reborn/bvestl. Extention to EASTL with various useful vocabulary types including polymorphic allocators and non-exception error handling.
Python
2
star
11

profiling-futures

profiling-like infrastructure for profiling futures
Rust
2
star
12

pretzel

GPU compressor for GPU compressed textures. Rust/wgpu port of https://github.com/darksylinc/betsy.
GLSL
2
star
13

repo-template

cargo-generate template for a single or multi-crate project with automatic releases
1
star
14

basis-rs

UNMAINTAINED. Use https://github.com/aclysma/basis-universal-rs
Rust
1
star
15

rend3.rs

HTML
1
star
16

logo

Logo Source Assets
Shell
1
star
17

dev-env

Docker container containing all the tools needed to run ci on bve-reborn
Shell
1
star
18

texcrunch

Abstraction layer and rust bindings for BC1 (DXT1), BC3 (DXT5), BC4 (RGTC1), BC5 (RGTC2), BC6H (BPTC float), BC7 (BPTC unorm), ETC1, and ASTC encoders.
Rust
1
star
19

bvereborn.com

BVE-Reborn's homepage.
Rust
1
star