This commit is contained in:
1 parent
0e7aed40f1
commit
0ce43fc399
19 files changed
+1180
-127
No files matched your search
@@ -84,10 +84,12 @@ Immutable-style log of significant decisions. Add a new numbered ADR when changi
|
||||
| [editor/native-dialogs.md](editor/native-dialogs.md) | Non-blocking native dialog acquisition and main-thread result application |
|
||||
| [editor/terrain.md](editor/terrain.md) | Terrain schema, inspector workflow, chunk hydration, collision, and follow-on boundaries |
|
||||
| [editor/physics-placement.md](editor/physics-placement.md) | Transactional gravity placement, diagnostics, isolation, and undo workflow |
|
||||
| [editor/collider-authoring.md](editor/collider-authoring.md) | Collider shape authoring, hydration diagnostics, semantic overlays, and placement prerequisites |
|
||||
| [editor/evaluations/material-renderer-foundation/](editor/evaluations/material-renderer-foundation/) | Live screenshots and acceptance results for the renderer/material/component foundation |
|
||||
| [editor/evaluations/terrain-sculpt-tools/](editor/evaluations/terrain-sculpt-tools/) | Live screenshot and acceptance results for modal terrain sculpt tools |
|
||||
| [editor/evaluations/terrain-material-layers/](editor/evaluations/terrain-material-layers/) | Live screenshot and acceptance results for terrain material assignment, blending, painting, and history |
|
||||
| [editor/evaluations/physics-placement/](editor/evaluations/physics-placement/) | Live screenshot and acceptance results for physics settling, cancel, commit, undo, and redo |
|
||||
| [editor/evaluations/collider-diagnostics/](editor/evaluations/collider-diagnostics/) | Live screenshot and acceptance results for collider overlays, diagnostics, shape history, and placement preflight |
|
||||
| [editor/evaluations/navigation-authoring/](editor/evaluations/navigation-authoring/) | Live screenshots and acceptance results for navigation authoring and runtime parity |
|
||||
| [editor/evaluations/production-readiness/](editor/evaluations/production-readiness/) | Current versioned production gate, evidence matrix, candidate commands, soak protocol, and independent sign-off requirements |
|
||||
|
||||
|
||||
@@ -27,6 +27,7 @@ Docs for the in-process egui editor (`crates/editor/`). Update this index when a
|
||||
| [native-dialogs.md](native-dialogs.md) | Non-blocking file/folder/confirmation acquisition and main-thread result application |
|
||||
| [terrain.md](terrain.md) | Inline height-grid terrain, chunk hydration, collision, inspector workflow, and fixtures |
|
||||
| [physics-placement.md](physics-placement.md) | Transactional gravity placement, prerequisites, isolation, commit/cancel, and undo |
|
||||
| [collider-authoring.md](collider-authoring.md) | Collider shape editing, shared health diagnostics, overlays, hydration status, and placement reuse |
|
||||
| [evaluations/](evaluations/) | Acceptance evidence records and native Gitea attachment publishing policy |
|
||||
| [evaluations/material-renderer-foundation/](evaluations/material-renderer-foundation/) | Live screenshots and verification record for the renderer/material/component foundation |
|
||||
| [evaluations/material-library-targeted-drop/](evaluations/material-library-targeted-drop/) | Live screenshot and verification record for the docked Material Library and exact reversible surface drops |
|
||||
@@ -36,6 +37,7 @@ Docs for the in-process egui editor (`crates/editor/`). Update this index when a
|
||||
| [evaluations/terrain-sculpt-tools/](evaluations/terrain-sculpt-tools/) | Live screenshot and verification record for modal sculpt controls, footprint, and stroke history |
|
||||
| [evaluations/terrain-material-layers/](evaluations/terrain-material-layers/) | Live screenshot and verification record for blended layers, assignment, painting, and history |
|
||||
| [evaluations/physics-placement/](evaluations/physics-placement/) | Live screenshot and verification record for multi-prop settling, cancel, commit, undo, and redo |
|
||||
| [evaluations/collider-diagnostics/](evaluations/collider-diagnostics/) | Live screenshot and verification record for semantic collider overlays, health linking, shape switching, and placement reuse |
|
||||
| [evaluations/navigation-authoring/](evaluations/navigation-authoring/) | Live screenshots and verification record for navigation authoring and runtime parity |
|
||||
| [evaluations/production-readiness/](evaluations/production-readiness/) | Current #50 release-candidate matrix and required clean-checkout, soak, performance, limitation, and independent-signoff evidence |
|
||||
|
||||
@@ -47,6 +49,7 @@ Docs for the in-process egui editor (`crates/editor/`). Update this index when a
|
||||
| `shared::components::BrushDesc` / `shared::hydration::brushes` | Persisted brush authoring data and generated runtime mesh hydration | brushes.md, ADR 0021 |
|
||||
| `shared::components::TerrainDesc` / `shared::hydration::terrain` / `blacksite_surface` | Persisted height/layer grids, generated chunks, and raster blending | terrain.md, ADR 0039, ADR 0040 |
|
||||
| `viewport/physics_placement.rs` / `play/state.rs` | Paused Edit physics and transactional gravity placement | physics-placement.md, ADR 0041 |
|
||||
| `viewport/collider_diagnostics.rs` / `viewport/visualizers.rs` / `ui/inspector.rs` | Shared collider health, semantic overlays, and undoable shape authoring | collider-authoring.md |
|
||||
| `scene/` | Level I/O, tabs, composition materialization, schema, viewport render-target setup | architecture.md, multi-scene-composition.md, ADR 0026 |
|
||||
| `viewport/` | Camera, selection, gizmos, render views | architecture.md |
|
||||
| `play/` | PIE session, editor mode state | architecture.md |
|
||||
@@ -89,7 +92,7 @@ Docs for the in-process egui editor (`crates/editor/`). Update this index when a
|
||||
- **Brush authoring** — `ActorKind::Brush + BrushDesc` stores persisted convex blockout faces, validates authored geometry in the inspector and Window → Brush Diagnostics, and hydrates active valid brushes into generated mesh children. See [brushes.md](brushes.md).
|
||||
- **Draw Brush** — `B`, toolbar pencil, or command `brush.draw` enters a floor-polygon draw mode. LMB places snapped points, Backspace removes the last point, Enter locks the outline for height editing, mouse up/down adjusts height, and Enter/LMB creates additive prism brushes through history. Esc/right-click cancels. Simple concave outlines decompose into convex brush parts; self-intersections remain blocked.
|
||||
- **Brush edit modes** — with a brush selected, `1`/`2`/`3`/`4` enter vertex, edge, face, and clip element modes. Element modes show brush handles in the viewport, own LMB picking, support Shift multi-select, show a mode badge, and Esc returns to object mode. Vertex/edge/face selections use the standard `W`/`E`/`R` gizmo at the element pivot and commit undoable `SetBrush` edits. Clip previews a bounds-based half-brush and commits with Enter; command-palette intersect, convex merge, and subtract operations use the same preview/commit lifecycle for conservative cuboid/prism blockout.
|
||||
- **Collider split** — imported mesh collision lives in a separate `ColliderDesc::StaticMesh` plus optional `RigidBodyDesc`; renderer slots own only render visibility, shadows, mesh, and material references.
|
||||
- **Collider split and health** — imported mesh collision lives in a separate `ColliderDesc::StaticMesh` plus optional `RigidBodyDesc`; renderer slots own only render visibility, shadows, mesh, and material references. Inspector, viewport, Diagnostics, and physics placement share one authored/runtime health result; see [collider-authoring.md](collider-authoring.md).
|
||||
- **Material assets and renderer slots** — Material and direct-base Material Instance documents are shared assets. `StaticMeshRenderer` and `SkinnedMeshRenderer` each own stable material slots with imported source defaults and explicit shared assignments; Clear returns to the source default, while reimported missing slots retain overrides as orphans instead of matching by name. Runtime-only property blocks never mutate or persist into the shared asset. Custom Surface evaluators use the same constrained ABI for raster and Solari-eligible non-deformed geometry; skinned/morph geometry is deliberately excluded from Solari until deformed BLAS updates exist. See [material-system.md](material-system.md), [ADR 0035](../adr/0035-shared-material-assets-and-renderer-slots.md), and [ADR 0036](../adr/0036-surface-abi-and-solari-parity.md).
|
||||
- **Prefab authoring** — shared `PrefabOverrides` targets generated actors by nested anchor chain plus stable `ActorId`, and applies reflected property/component plus same-layer structural operations in editor and game hydration. The editor supports scoped Revert and transactional **Apply to source** with three-way conflict checks, exact-file undo guards, and recoverable changed/broken/conflict states. `HydratedPrefabMember` keeps generated content out of owner serialization; linked-root saves retain local structure as variants. **Unpack Layer** preserves nested links, while **Convert to Local** recursively removes them. See [prefab-authoring.md](prefab-authoring.md) and [ADR 0027](../adr/0027-stable-prefab-ownership-and-variants.md).
|
||||
- **Visual language** uses a near-black industrial shell, a compact Blacksite identity mark, restrained amber actions/primary selection, cyan secondary selection, semantic status colors, stable grouped controls, and shared elevated viewport chips. Primary/secondary selection roles remain consistent across hierarchy rows, viewport x-ray shells/corner brackets, the selection HUD, and transform interactions. See [visual-language.md](visual-language.md).
|
||||
|
||||
@@ -0,0 +1,55 @@
|
||||
# Collider Authoring And Diagnostics
|
||||
|
||||
`ColliderDesc` is the saved collision shape. `RigidBodyDesc` independently controls authored body
|
||||
motion, while Avian `Collider` and `RigidBody` components are hydrated runtime state. Collider
|
||||
health compares both sides of that boundary so editor tools do not treat authored-but-unavailable
|
||||
collision as ready.
|
||||
|
||||
## Inspector Workflow
|
||||
|
||||
The Collider component card reports its shape, health, and hydration state. Box, sphere, capsule,
|
||||
and static mesh shapes can be switched from the Shape menu. Primitive conversions retain the
|
||||
previous shape's useful extents; each completed switch uses `SetCollider` history and is one undo
|
||||
operation. Invalid shapes expose a reset action. Static mesh sources can be selected or replaced
|
||||
with the actor's renderer meshes.
|
||||
|
||||
Dimensions are clamped to positive values in normal inspector editing. Project validation still
|
||||
rejects hand-edited or migrated non-finite/zero dimensions and empty mesh source lists.
|
||||
|
||||
## Viewport Contract
|
||||
|
||||
Collider view hides render meshes and emphasizes authored collision using semantic status colors:
|
||||
|
||||
| Color | State |
|
||||
|-------|-------|
|
||||
| Green | Valid hydrated solid collider |
|
||||
| Cyan | Valid hydrated trigger |
|
||||
| Gray | Disabled or inactive collider |
|
||||
| Amber | Stale hydration or oversized collider |
|
||||
| Red | Missing or invalid collider |
|
||||
|
||||
Box, sphere/ellipsoid, and capsule wireframes include actor world scale. Static mesh collision uses
|
||||
the cooked runtime collider bounds when available. A rigid body with no collider receives a red
|
||||
spatial marker, so missing collision remains discoverable with meshes hidden. The lower-left HUD
|
||||
summarizes scene health and identifies the selected collider's shape and hydration state.
|
||||
|
||||
## Diagnostics
|
||||
|
||||
The shared health service reports:
|
||||
|
||||
- missing/inactive/disabled collider authoring;
|
||||
- non-positive or non-finite primitive dimensions;
|
||||
- empty, unresolved, or registry-stale static mesh references;
|
||||
- valid authoring that has not produced a runtime collider;
|
||||
- primitive colliders exceeding 1,000 meters on any world-space axis.
|
||||
|
||||
The 1,000-meter warning is conservative rather than a save blocker. Large worlds should split
|
||||
collision into spatially bounded actors to keep broad-phase behavior predictable. Diagnostics can
|
||||
select the affected actor; static mesh fields retain their asset-browser locate action.
|
||||
|
||||
Physics Placement consumes the same errors plus its stricter non-trigger and hydrated rigid-body
|
||||
requirements. See [physics-placement.md](physics-placement.md).
|
||||
|
||||
`assets/levels/collider_diagnostics_showcase.scn.ron` contains valid box, scaled sphere, capsule,
|
||||
trigger, disabled, and missing-collider states for visual acceptance. Invalid, oversized, and stale
|
||||
asset cases live in unit fixtures so the committed project remains release-valid.
|
||||
@@ -0,0 +1,24 @@
|
||||
# Collider Diagnostics Acceptance
|
||||
|
||||
Issue: Gitea #26 (`BS-JD-305`)
|
||||
|
||||
## Evidence
|
||||
|
||||

|
||||
|
||||
The native Wayland editor loaded `assets/levels/collider_diagnostics_showcase.scn.ron` and entered
|
||||
Collider view. The captured frame shows shape overlays with meshes hidden, the scene health HUD,
|
||||
the selectable Diagnostics window, and the selected trigger's hydrated status in the inspector.
|
||||
|
||||
## Live Results
|
||||
|
||||
- Box, scaled sphere/ellipsoid, and capsule overlays matched authored transforms and dimensions.
|
||||
- Green ready, cyan trigger, gray disabled, and red missing states were visually distinct.
|
||||
- The HUD reported `4 ready / 1 disabled / 0 warning / 1 invalid` and followed selection.
|
||||
- The Diagnostics panel linked the missing finding back to its actor.
|
||||
- Switching the valid box to sphere preserved useful extents and produced `Undo: Set Collider`;
|
||||
undo restored the box.
|
||||
- Physics Placement rejected the missing-collider actor with the shared collider-health messages.
|
||||
- Scene switching and editor shutdown completed without a panic or runtime validation error.
|
||||
|
||||
Packaged verification remains deferred by current project instruction.
|
||||
Binary file not shown.
@@ -59,6 +59,7 @@ another commit, a dirty worktree, or an older package do not transfer to the can
|
||||
| Material catalog and assignment | Material Library and exact targeted drops accepted; `#51` open only on deformed Solari geometry | Not rerun as one candidate |
|
||||
| Terrain authoring | `#22`-`#24` open | Blocked |
|
||||
| Physics placement | `#25` source/live acceptance complete | Pass; packaged-runtime acceptance owner-deferred |
|
||||
| Collider authoring and diagnostics | `#26` source/live acceptance complete | Pass; packaged-runtime acceptance owner-deferred |
|
||||
| Animation | Implemented | Not rerun |
|
||||
| Audio | Implemented | Not rerun |
|
||||
| Navigation | Implemented | Not rerun |
|
||||
|
||||
@@ -24,9 +24,10 @@ history. During placement, every non-selected dynamic or kinematic body is tempo
|
||||
a static collision surface. The tool restores those bodies exactly when the preview ends. Entering
|
||||
Play mode cancels an active placement preview.
|
||||
|
||||
The start action is non-destructive when prerequisites are missing. The viewport and status strip
|
||||
identify locked/linked selections, missing or disabled rigid bodies, missing/trigger colliders, and
|
||||
colliders that are still cooking. A ten-second simulated-time limit stops unstable previews while
|
||||
The start action is non-destructive when prerequisites are missing. It consumes the shared
|
||||
[collider health service](collider-authoring.md), so the viewport, inspector, Diagnostics panel,
|
||||
and placement status agree about missing, invalid, stale, disabled, or trigger collision. A
|
||||
ten-second simulated-time limit stops unstable previews while
|
||||
leaving explicit commit and cancel available.
|
||||
|
||||
`assets/levels/physics_placement_showcase.scn.ron` is the committed acceptance fixture. Select
|
||||
|
||||
@@ -58,6 +58,7 @@ Phased work for the in-process editor (`crates/editor`). Status reflects the cur
|
||||
| Tab cycle overlapping picks | Done | `ViewportPickStack` + Tab in viewport |
|
||||
| Multi-viewport | Scaffolded | Primary viewport state is separated from render ownership; secondary viewports remain future work |
|
||||
| Physics placement | Done | Existing horizontal toolbar action; real Avian settling, prerequisite diagnostics, exact cancel, grouped undo, and isolated non-selected bodies |
|
||||
| Collider authoring diagnostics | Done | World-scale shape overlays, semantic health colors, stale/missing/invalid/oversized findings, undoable shape switching, and shared placement preflight |
|
||||
|
||||
## Phase 2b — Advanced rendering
|
||||
|
||||
|
||||
Reference in new issue
Block a user