tawasuyu/llimphi

1//! # llimphi-3d — pase 3D base de Llimphi (M0 del motor 3D)
2//!
3//! Lo mínimo para tener **3D real dentro de un `View` de Llimphi**: una
4//! [`Camera3d`] (matrices view/proj con `glam`), un depth buffer propio y un
5//! [`Renderer3d`] que dibuja geometría indexada con test de profundidad sobre
6//! la textura intermedia del frame.
7//!
8//! ## Cómo encaja con el bucle Elm + vello + wgpu
9//!
10//! Llimphi ya rasteriza la UI con vello sobre una textura intermedia y expone
11//! [`View::gpu_paint_with`] para inyectar una pasada GPU directa *después* de
12//! vello (con `LoadOp::Load`, preservando la UI). [`Renderer3d::render`] tiene
13//! **exactamente** la firma que esa closure necesita
14//! (`device, queue, encoder, target_view, (w, h), &camera`), así que un nodo 3D
15//! es:
16//!
17//! ```ignore
18//! let r3d = Arc::new(Mutex::new(Renderer3d::new(&device, fmt)));
19//! View::empty().gpu_paint_with(move |dev, q, enc, view, rect, vp| {
20//!     r3d.lock().unwrap().render(dev, q, enc, view, vp, &camera);
21//! })
22//! ```
23//!
24//! No es un segundo motor: corre sobre el **mismo wgpu** que ya usa Llimphi,
25//! que a su vez traduce a Vulkan/Metal/DX12/GL/WebGPU. Ver
26//! `01_yachay/dominium/MOTOR-VOXEL.md` §11 para la ruta completa (M0..M4,
27//! ray-march de voxels sparse en los hitos siguientes).
28//!
29//! [`View::gpu_paint_with`]: https://docs/llimphi-compositor
30
31pub use glam;
32pub use wgpu;
33
34mod billboard;
35mod camera;
36mod cinema;
37mod dimensions;
38mod hud;
39mod mesh;
40mod postfx;
41mod reflection;
42mod renderer;
43mod scene;
44mod sky;
45mod voxel;
46mod voxel_renderer;
47
48pub use billboard::{Billboard, Billboards};
49pub use camera::Camera3d;
50pub use cinema::{CamKey, CameraTrack};
51pub use sky::{SkyBackdrop, SkyParams};
52pub use dimensions::{Dimension, Multiverse};
53pub use hud::{Hud, HudQuad};
54pub use mesh::{cube, push_cube, Vertex3d, CUBE_INDICES};
55pub use postfx::{PostFx, PostFxConfig};
56pub use reflection::{PlanarReflection, ReflectionPlane, SurfaceParams};
57pub use renderer::{Renderer3d, MESH_MAX_LIGHTS};
58pub use scene::Scene3d;
59pub use voxel::{DirtyBox, VoxelGrid};
60pub use voxel_renderer::{
61    Atmosphere, Entity3d, PointLight, VoxelRenderer, VOXEL_BRICK, VOXEL_MAX_LIGHTS,
62};