rend3 0.3.0

Easy to use, customizable, efficient 3D renderer library built on wgpu.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90

use crate::{
    graph::GraphTextureStore,
    instruction::InstructionStreamPair,
    managers::{
        CameraManager, DirectionalLightManager, MaterialManager, MeshManager, ObjectManager, SkeletonManager,
        TextureManager,
    },
    renderer::RendererDataCore,
    util::mipmap::MipmapGenerator,
    InstanceAdapterDevice, Renderer, RendererInitializationError,
};
use parking_lot::Mutex;
use rend3_types::{Camera, Handedness, TextureFormat};
use std::sync::{atomic::AtomicUsize, Arc};
use wgpu::TextureViewDimension;

pub fn create_renderer(
    iad: InstanceAdapterDevice,
    handedness: Handedness,
    aspect_ratio: Option<f32>,
) -> Result<Arc<Renderer>, RendererInitializationError> {
    profiling::scope!("Renderer::new");

    let features = iad.device.features();
    let limits = iad.device.limits();
    let downlevel = iad.adapter.get_downlevel_properties();

    let camera_manager = CameraManager::new(Camera::default(), handedness, aspect_ratio);

    let d2_texture_manager = TextureManager::new(
        &iad.device,
        iad.profile,
        limits.max_sampled_textures_per_shader_stage,
        TextureViewDimension::D2,
    );
    let d2c_texture_manager = TextureManager::new(
        &iad.device,
        iad.profile,
        limits.max_sampled_textures_per_shader_stage,
        TextureViewDimension::Cube,
    );
    let mesh_manager = MeshManager::new(&iad.device);
    let material_manager = MaterialManager::new(&iad.device, iad.profile);
    let object_manager = ObjectManager::new();
    let directional_light_manager = DirectionalLightManager::new(&iad.device);
    let skeleton_manager = SkeletonManager::new();

    let mipmap_generator = MipmapGenerator::new(
        &iad.device,
        &[
            TextureFormat::Rgba8Unorm,
            TextureFormat::Rgba8UnormSrgb,
            TextureFormat::Bgra8Unorm,
            TextureFormat::Bgra8UnormSrgb,
            TextureFormat::Rgba16Float,
        ],
    );
    let mut profiler = wgpu_profiler::GpuProfiler::new(4, iad.queue.get_timestamp_period());
    profiler.enable_timer = features.contains(wgpu_profiler::GpuProfiler::REQUIRED_WGPU_FEATURES);

    Ok(Arc::new(Renderer {
        instructions: InstructionStreamPair::new(),

        profile: iad.profile,
        adapter_info: iad.info,
        queue: iad.queue,
        device: iad.device,

        features,
        limits,
        downlevel,
        handedness,

        current_ident: AtomicUsize::new(0),
        data_core: Mutex::new(RendererDataCore {
            camera_manager,
            mesh_manager,
            d2_texture_manager,
            d2c_texture_manager,
            material_manager,
            object_manager,
            directional_light_manager,
            skeleton_manager,
            profiler,
            graph_texture_store: GraphTextureStore::new(),
        }),

        mipmap_generator,
    }))
}