concinnity-device 0.19.119

GPU backends (Metal, Vulkan, DirectX) behind a device facade for Concinnity
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

//! The device backends. The proprietary, hardware-facing renderers - Metal
//! (macOS), DirectX 12 (Windows), Vulkan (Windows/Linux) - plus the shared native
//! Win32 window/input layer. At most one backend compiles per build, resolved by
//! build.rs from the backend features into a single backend_* cfg; a build that
//! names none compiles no GPU code at all. Depends on concinnity-core, whose
//! `render` module holds the RenderBackend/SceneControl trait seam these
//! implement plus the render-prep feeding it; owns no gameplay, ECS-runtime,
//! audio, or physics. The client drives these through a
//! `Box<dyn RenderBackend>` obtained from `init_backend`, never naming a concrete
//! context type.

#[cfg(backend_dx)]
pub(crate) mod directx;
// The forwarding macro the three backends write their RenderBackend family
// impls with.
#[cfg(any(backend_metal, backend_dx, backend_vk))]
pub(crate) mod forward;
// The CPU's blocked-on-GPU time, shared by the three backends so
// `RenderStats::gpu_wait_us` means the same thing on each.
#[cfg(any(backend_metal, backend_dx, backend_vk))]
pub(crate) mod gpu_wait;
#[cfg(backend_metal)]
pub mod metal;
// The `objects` / `skinned_visible` render stats, shared so they mean the same
// thing on every backend.
#[cfg(any(backend_metal, backend_dx, backend_vk))]
pub(crate) mod object_counts;
#[cfg(any(backend_metal, backend_dx, backend_vk))]
pub(crate) mod png_encode;
// Consuming a temporal upscaler's history reset, the same on every backend.
#[cfg(any(backend_metal, backend_dx, backend_vk))]
pub(crate) mod upscale_reset;
// How the reflection-probe bake is logged, the same on every backend.
#[cfg(any(backend_metal, backend_dx, backend_vk))]
pub(crate) mod probe_report;
// The API-independent half of the vendor temporal upscalers (FSR, DLSS, XeSS)
// the DirectX and Vulkan backends drive.
#[cfg(any(backend_dx, backend_vk))]
pub(crate) mod upscale_sdk;
#[cfg(backend_vk)]
pub(crate) mod vulkan;
// Native Win32 window/input/display-mode layer shared by the HWND-rendering
// backends (DirectX always; Vulkan on Windows instead of GLFW).
#[cfg(all(target_os = "windows", any(backend_dx, backend_vk)))]
pub(crate) mod win32;
// Native AppKit window/input/display-mode layer shared by the NSView-rendering
// backends (Metal always; Vulkan on macOS instead of GLFW).
#[cfg(all(target_os = "macos", any(backend_metal, backend_vk)))]
pub(crate) mod appkit;

// Shader source assembly, compile and pipeline caches, and export-time
// precompilation shared by the backends.
pub mod shader;

// Reflection-driven layout guard for the `#[repr(C)]` structs the CPU uploads
// into the single-source shaders: the expected offsets come from the compiler,
// per target, rather than from a hand-written number. Reads the source
// assembly a backend brings with it, so a build with none has nothing to check.
#[cfg(all(test, any(backend_metal, backend_dx, backend_vk)))]
mod shader_layout;

// Source-scanning guards over the explicit backends' resource barriers.
#[cfg(test)]
mod audit;

// How a failed ray-tracing BVH update is logged, the same on every backend.
#[cfg(any(backend_metal, backend_dx, backend_vk))]
pub(crate) mod rt_report;
// Device-memory placement policy shared by the backends' allocators.
#[cfg(any(backend_metal, backend_dx, backend_vk))]
pub(crate) mod suballoc;

mod factory;
pub use factory::{init_backend, probe_gpu_profile};