concinnity-render 0.18.67

GPU-free render preparation for the Concinnity engine
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
91
92
93
94
95
96
97
98

//! The backend-agnostic, GPU-free render-prep layer. Holds the
//! `RenderBackend`/`SceneControl` trait seam the device backends implement, plus
//! the record builders, render graph, and CPU-side math that turn asset
//! components into GPU-ready data. Depends on the vocabulary and the CPU compute
//! over it (concinnity-core); owns no device or window handle. The device
//! backends (concinnity-device) and the runtime driver (concinnity-engine) both
//! build on top of this crate.
//!
//! The `vulkan` feature forwards a backend cfg and pulls in no dependency, so it
//! does not move the crate off that tier.

#![no_std]

extern crate alloc;
// The test harness is a std program.
#[cfg(test)]
extern crate std;

// GPU-layout + render-math vocabulary and the mesh payload codec, re-exported
// at the crate root so the render-prep modules reach them as `crate::<type>`.
pub use concinnity_core::gfx::{
    auto_exposure, chunk_coord, font, frustum, mesh_payload, profile, render_types, rt_reflections,
    ssao, ssgi, ssr,
};

// The rest of what the render-prep modules reach by their `crate::` paths:
// asset data types (`Decal`, `ParticleEmitter`, `InputKey`, ...), the stable
// `AssetId` newtype, the environment-map bake the reflection-probe payload
// builder calls, and the glass-quad generator.
pub(crate) use concinnity_core::{build, components, ecs, geometry};

pub mod area_light;
pub mod backend;
pub mod backend_init;
pub mod bvh;
pub mod call_buffer;
pub mod chunk_window;
pub mod csm;
pub mod cursor;
pub mod decal;
pub mod display_mode;
pub mod draw_slot;
pub mod error;
pub mod feedback;
pub mod fullscreen;
pub mod hdr_output;
pub mod input;
pub mod keymap;
pub mod lights;
pub mod ltc;
pub mod mat;
pub mod mipmap;
pub mod ops;
pub mod overlay_maps;
pub mod parallel_ctx;
pub mod particles;
pub mod pass_timing;
pub mod planar_reflection;
pub mod reflection_probe;
pub mod render_graph;
pub mod rt_geom;
pub mod rt_refit;
pub mod rt_topology;
pub mod scene_flow;
pub mod scene_residency;
pub mod shaders;
pub mod shadow_schedule;
pub mod skinned_pool;
pub mod slang_programs;
pub mod slang_source;
pub mod slot_rewrites;
pub mod snapshot;
pub mod spot_shadow;
pub mod sprite;
pub mod streaming;
pub mod text;
pub mod transparent;

/// The `#[repr(C)]` blocks the CPU uploads into the single-source `.slang`
/// shaders, declared once for every backend (see `uniforms/mod.rs`).
pub mod uniforms;

pub mod volumetric_fog;

/// GPU-free host-side layout contract for the Metal backend's shader structs
/// (uniform structs, math, shader-layout asserts). Metal-specific but device-free,
/// so it is compiled unconditionally and its layout tests run on every platform's
/// CI. The Metal backend (concinnity-device) re-exports it under its own `metal`.
pub mod metal;

/// The same for the DirectX and Vulkan backends: their repr(C) uniform / probe
/// structs + GPU-timing slot arithmetic (mirrored in the HLSL / GLSL shaders).
/// Backend-specific but device-free (plain repr(C), no windows/ash types), so
/// they compile unconditionally and their layout tests count toward coverage.
/// The DirectX / Vulkan backends (concinnity-device) re-export them under their
/// own `directx` / `vulkan`.
pub mod directx;
pub mod vulkan;