c96239a794
Eigenstaendige Crate wie render2d (render/window-Stufung, serde-only Mesh- schicht headless testbar). Wand-Extrusion (Band via Links-Normale, Quader mit nach aussen zeigenden Normalen), handgerechnete Mat4 (perspektiv+ortho, wgpu- Clip-Z [0,1], 5 Kamera-Presets), Directional-Light + Tiefenpuffer + Backface- Culling. Orbit-Spike (cargo run --features window --bin spike3d). Plus Port- Briefing mit M2..M9-Milestones (three.js-Viewport-Bestandsaufnahme).
302 lines
11 KiB
Rust
302 lines
11 KiB
Rust
// wgpu-Pipeline des nativen 3D-Renderers (nur mit Feature "render").
|
|
//
|
|
// Eine Pipeline: extrudierte Wand-Meshes mit Tiefenpuffer, View-Projektions-
|
|
// Matrix-Uniform und einem Directional-Light im Fragment-Shader. Backface-Culling
|
|
// ist aktiv (die Extrusion liefert konsistent nach aussen zeigende Flaechen, siehe
|
|
// mesh.rs) — das haelt das Innere der Waende korrekt verdeckt.
|
|
//
|
|
// Der Renderer ist fenster-/surface-agnostisch: er bekommt `Device`, `Queue` und
|
|
// ein `TextureView` (Surface- oder Offscreen-Textur) plus die aktuelle Kamera und
|
|
// zeichnet dort hinein. Die Fenster-Anbindung (winit) liegt separat im Spike-Bin.
|
|
|
|
use bytemuck::{Pod, Zeroable};
|
|
use wgpu::util::DeviceExt;
|
|
|
|
use crate::math::{view_projection, Mat4};
|
|
use crate::mesh::build_walls_mesh;
|
|
use crate::shaders::MESH_WGSL;
|
|
use crate::types::{Camera, WallInput, FLOATS_PER_VERTEX};
|
|
|
|
/// Tiefenformat des Z-Puffers (32 Bit Float, ueberall verfuegbar).
|
|
pub const DEPTH_FORMAT: wgpu::TextureFormat = wgpu::TextureFormat::Depth32Float;
|
|
|
|
/// Uniform-Block, 1:1 zum WGSL-`Globals`-Struct. std140-kompatibel (mat4/vec4 auf
|
|
/// 16 Byte ausgerichtet).
|
|
#[repr(C)]
|
|
#[derive(Clone, Copy, Pod, Zeroable)]
|
|
struct Globals {
|
|
view_proj: [f32; 16],
|
|
light_dir: [f32; 4],
|
|
ambient: [f32; 4],
|
|
}
|
|
|
|
impl Default for Globals {
|
|
fn default() -> Self {
|
|
Self {
|
|
view_proj: crate::math::identity(),
|
|
// Richtung ZUM Licht (world), normiert. Entspricht der three.js-Sonne
|
|
// bei (6,12,4): das Licht kommt aus dieser Richtung.
|
|
light_dir: normalize4([6.0, 12.0, 4.0]),
|
|
// Ambienter Sockel 0.6 (wie three.js-AmbientLight(0.6)).
|
|
ambient: [0.6, 0.6, 0.6, 1.0],
|
|
}
|
|
}
|
|
}
|
|
|
|
fn normalize4(v: [f32; 3]) -> [f32; 4] {
|
|
let l = (v[0] * v[0] + v[1] * v[1] + v[2] * v[2]).sqrt().max(1e-9);
|
|
[v[0] / l, v[1] / l, v[2] / l, 0.0]
|
|
}
|
|
|
|
/// GPU-seitige Puffer eines hochgeladenen Meshes.
|
|
struct MeshBuffers {
|
|
vbo: wgpu::Buffer,
|
|
ibo: wgpu::Buffer,
|
|
index_count: u32,
|
|
}
|
|
|
|
/// Der native 3D-Renderer: haelt die Pipeline, das Uniform (View-Projektion +
|
|
/// Licht) und das aktuell hochgeladene Mesh. Ein Tiefenpuffer wird passend zur
|
|
/// Ziel-Groesse (neu) angelegt.
|
|
pub struct Renderer {
|
|
pipeline: wgpu::RenderPipeline,
|
|
bind_group: wgpu::BindGroup,
|
|
uniform: wgpu::Buffer,
|
|
mesh: Option<MeshBuffers>,
|
|
depth: Option<DepthTarget>,
|
|
globals: Globals,
|
|
/// Loeschfarbe (Hintergrund). Default heller Grauton wie die three.js-Sicht.
|
|
pub clear_color: wgpu::Color,
|
|
}
|
|
|
|
/// Tiefen-Textur samt View, an eine bestimmte Groesse gebunden.
|
|
struct DepthTarget {
|
|
view: wgpu::TextureView,
|
|
width: u32,
|
|
height: u32,
|
|
}
|
|
|
|
impl Renderer {
|
|
/// Erzeugt Pipeline + Layout fuer ein gegebenes Farbformat (Surface).
|
|
pub fn new(device: &wgpu::Device, color_format: wgpu::TextureFormat) -> Self {
|
|
let module = device.create_shader_module(wgpu::ShaderModuleDescriptor {
|
|
label: Some("mesh.wgsl"),
|
|
source: wgpu::ShaderSource::Wgsl(MESH_WGSL.into()),
|
|
});
|
|
|
|
let bind_group_layout =
|
|
device.create_bind_group_layout(&wgpu::BindGroupLayoutDescriptor {
|
|
label: Some("globals.layout"),
|
|
entries: &[wgpu::BindGroupLayoutEntry {
|
|
binding: 0,
|
|
visibility: wgpu::ShaderStages::VERTEX_FRAGMENT,
|
|
ty: wgpu::BindingType::Buffer {
|
|
ty: wgpu::BufferBindingType::Uniform,
|
|
has_dynamic_offset: false,
|
|
min_binding_size: wgpu::BufferSize::new(
|
|
std::mem::size_of::<Globals>() as u64
|
|
),
|
|
},
|
|
count: None,
|
|
}],
|
|
});
|
|
|
|
let pipeline_layout = device.create_pipeline_layout(&wgpu::PipelineLayoutDescriptor {
|
|
label: Some("3d.layout"),
|
|
bind_group_layouts: &[&bind_group_layout],
|
|
push_constant_ranges: &[],
|
|
});
|
|
|
|
// Vertex-Layout: [pos vec3, normal vec3, color vec3], stride 9*4.
|
|
let vertex_layout = wgpu::VertexBufferLayout {
|
|
array_stride: (FLOATS_PER_VERTEX * 4) as u64,
|
|
step_mode: wgpu::VertexStepMode::Vertex,
|
|
attributes: &wgpu::vertex_attr_array![0 => Float32x3, 1 => Float32x3, 2 => Float32x3],
|
|
};
|
|
|
|
let pipeline = device.create_render_pipeline(&wgpu::RenderPipelineDescriptor {
|
|
label: Some("mesh.pipeline"),
|
|
layout: Some(&pipeline_layout),
|
|
vertex: wgpu::VertexState {
|
|
module: &module,
|
|
entry_point: "vs_main",
|
|
buffers: &[vertex_layout],
|
|
compilation_options: Default::default(),
|
|
},
|
|
fragment: Some(wgpu::FragmentState {
|
|
module: &module,
|
|
entry_point: "fs_main",
|
|
targets: &[Some(wgpu::ColorTargetState {
|
|
format: color_format,
|
|
blend: Some(wgpu::BlendState::REPLACE),
|
|
write_mask: wgpu::ColorWrites::ALL,
|
|
})],
|
|
compilation_options: Default::default(),
|
|
}),
|
|
primitive: wgpu::PrimitiveState {
|
|
topology: wgpu::PrimitiveTopology::TriangleList,
|
|
// Aussen zeigende Flaechen sind CCW (mesh.rs) -> Rueckseiten cullen.
|
|
front_face: wgpu::FrontFace::Ccw,
|
|
cull_mode: Some(wgpu::Face::Back),
|
|
..Default::default()
|
|
},
|
|
depth_stencil: Some(wgpu::DepthStencilState {
|
|
format: DEPTH_FORMAT,
|
|
depth_write_enabled: true,
|
|
depth_compare: wgpu::CompareFunction::Less,
|
|
stencil: wgpu::StencilState::default(),
|
|
bias: wgpu::DepthBiasState::default(),
|
|
}),
|
|
multisample: wgpu::MultisampleState::default(),
|
|
multiview: None,
|
|
cache: None,
|
|
});
|
|
|
|
let uniform = device.create_buffer(&wgpu::BufferDescriptor {
|
|
label: Some("globals.buffer"),
|
|
size: std::mem::size_of::<Globals>() as u64,
|
|
usage: wgpu::BufferUsages::UNIFORM | wgpu::BufferUsages::COPY_DST,
|
|
mapped_at_creation: false,
|
|
});
|
|
let bind_group = device.create_bind_group(&wgpu::BindGroupDescriptor {
|
|
label: Some("globals.bind"),
|
|
layout: &bind_group_layout,
|
|
entries: &[wgpu::BindGroupEntry {
|
|
binding: 0,
|
|
resource: uniform.as_entire_binding(),
|
|
}],
|
|
});
|
|
|
|
Self {
|
|
pipeline,
|
|
bind_group,
|
|
uniform,
|
|
mesh: None,
|
|
depth: None,
|
|
globals: Globals::default(),
|
|
// #e9e9e9 heller Hintergrund (wie die three.js-Modellsicht).
|
|
clear_color: wgpu::Color {
|
|
r: 0.914,
|
|
g: 0.914,
|
|
b: 0.914,
|
|
a: 1.0,
|
|
},
|
|
}
|
|
}
|
|
|
|
/// Erzeugt das Mesh aus geflachten Waenden und laedt die Puffer hoch.
|
|
pub fn upload_walls(&mut self, device: &wgpu::Device, walls: &[WallInput]) {
|
|
let mesh = build_walls_mesh(walls);
|
|
if mesh.indices.is_empty() {
|
|
self.mesh = None;
|
|
return;
|
|
}
|
|
let vbo = device.create_buffer_init(&wgpu::util::BufferInitDescriptor {
|
|
label: Some("mesh.vbo"),
|
|
contents: bytemuck::cast_slice(&mesh.verts),
|
|
usage: wgpu::BufferUsages::VERTEX,
|
|
});
|
|
let ibo = device.create_buffer_init(&wgpu::util::BufferInitDescriptor {
|
|
label: Some("mesh.ibo"),
|
|
contents: bytemuck::cast_slice(&mesh.indices),
|
|
usage: wgpu::BufferUsages::INDEX,
|
|
});
|
|
self.mesh = Some(MeshBuffers {
|
|
vbo,
|
|
ibo,
|
|
index_count: mesh.indices.len() as u32,
|
|
});
|
|
}
|
|
|
|
/// Setzt die Lichtrichtung (Richtung ZUM Licht, world) und den ambienten Sockel.
|
|
pub fn set_light(&mut self, dir_to_light: [f32; 3], ambient: f32) {
|
|
self.globals.light_dir = normalize4(dir_to_light);
|
|
self.globals.ambient = [ambient, ambient, ambient, 1.0];
|
|
}
|
|
|
|
/// Stellt sicher, dass ein Tiefenpuffer passend zur Ziel-Groesse existiert.
|
|
fn ensure_depth(&mut self, device: &wgpu::Device, w: u32, h: u32) {
|
|
let ok = matches!(&self.depth, Some(d) if d.width == w && d.height == h);
|
|
if ok {
|
|
return;
|
|
}
|
|
let texture = device.create_texture(&wgpu::TextureDescriptor {
|
|
label: Some("depth"),
|
|
size: wgpu::Extent3d {
|
|
width: w.max(1),
|
|
height: h.max(1),
|
|
depth_or_array_layers: 1,
|
|
},
|
|
mip_level_count: 1,
|
|
sample_count: 1,
|
|
dimension: wgpu::TextureDimension::D2,
|
|
format: DEPTH_FORMAT,
|
|
usage: wgpu::TextureUsages::RENDER_ATTACHMENT,
|
|
view_formats: &[],
|
|
});
|
|
let view = texture.create_view(&wgpu::TextureViewDescriptor::default());
|
|
self.depth = Some(DepthTarget {
|
|
view,
|
|
width: w.max(1),
|
|
height: h.max(1),
|
|
});
|
|
}
|
|
|
|
/// Zeichnet einen Frame in `view` (Surface- oder Offscreen-Textur). Die Kamera
|
|
/// liefert die View-Projektions-Matrix; `viewport` bestimmt das Seitenverhaeltnis
|
|
/// und die Tiefenpuffer-Groesse.
|
|
pub fn render(
|
|
&mut self,
|
|
device: &wgpu::Device,
|
|
queue: &wgpu::Queue,
|
|
view: &wgpu::TextureView,
|
|
camera: &Camera,
|
|
viewport: (u32, u32),
|
|
) {
|
|
let (w, h) = viewport;
|
|
let aspect = if h > 0 { w as f32 / h as f32 } else { 1.0 };
|
|
let vp: Mat4 = view_projection(camera, aspect);
|
|
self.globals.view_proj = vp;
|
|
queue.write_buffer(&self.uniform, 0, bytemuck::bytes_of(&self.globals));
|
|
|
|
self.ensure_depth(device, w, h);
|
|
let depth_view = &self.depth.as_ref().unwrap().view;
|
|
|
|
let mut encoder = device.create_command_encoder(&wgpu::CommandEncoderDescriptor {
|
|
label: Some("3d.encoder"),
|
|
});
|
|
{
|
|
let mut pass = encoder.begin_render_pass(&wgpu::RenderPassDescriptor {
|
|
label: Some("3d.pass"),
|
|
color_attachments: &[Some(wgpu::RenderPassColorAttachment {
|
|
view,
|
|
resolve_target: None,
|
|
ops: wgpu::Operations {
|
|
load: wgpu::LoadOp::Clear(self.clear_color),
|
|
store: wgpu::StoreOp::Store,
|
|
},
|
|
})],
|
|
depth_stencil_attachment: Some(wgpu::RenderPassDepthStencilAttachment {
|
|
view: depth_view,
|
|
depth_ops: Some(wgpu::Operations {
|
|
load: wgpu::LoadOp::Clear(1.0),
|
|
store: wgpu::StoreOp::Store,
|
|
}),
|
|
stencil_ops: None,
|
|
}),
|
|
timestamp_writes: None,
|
|
occlusion_query_set: None,
|
|
});
|
|
|
|
if let Some(m) = &self.mesh {
|
|
pass.set_pipeline(&self.pipeline);
|
|
pass.set_bind_group(0, &self.bind_group, &[]);
|
|
pass.set_vertex_buffer(0, m.vbo.slice(..));
|
|
pass.set_index_buffer(m.ibo.slice(..), wgpu::IndexFormat::Uint32);
|
|
pass.draw_indexed(0..m.index_count, 0, 0..1);
|
|
}
|
|
}
|
|
queue.submit(std::iter::once(encoder.finish()));
|
|
}
|
|
}
|