Struct BvhBackend 

pub struct BvhBackend { /* private fields */ }

BVH spatial backend wrapping BvhStore.

Implementations

impl BvhBackend

pub fn new(config: BvhStoreConfig) -> Self

Create from store config (no chain sink yet).

pub fn with_defaults() -> Self

Defaults (1M leaves).

pub fn with_sink(config: BvhStoreConfig, sink: Arc<dyn ChainSink>) -> Self

Create with a chain sink attached before first mutation.

pub fn set_chain_sink(&self, sink: Arc<dyn ChainSink>)

Attach / replace the chain sink after construction (boot order).

pub fn with_store<R>(&self, f: impl FnOnce(&mut BvhStore) -> R) -> R

Run f with the store locked (branch-scoped insert / remove / query for the daemon’s ecc.spatial.* RPCs). Mutations still go through the store’s chain sink.

pub fn events(&self) -> (Vec<BvhChainKind>, bool)

Mutation events recorded so far, and whether old ones were dropped.

pub fn verify_replay(&self) -> ReplayReport

Rebuild a replica from the mutation log and compare it with the live store (branches and leaf ids per branch). The live store is not replaced.

pub fn snapshot_main(&self) -> Vec<(LeafId, Leaf)>

Snapshot leaves on the main branch (restart equality tests).

pub fn restore_main(&self, leaves: &[(LeafId, Leaf)]) -> SpatialResult<()>

Restore leaves on the main branch (restart helper).

pub fn branch_count(&self) -> usize

Number of branches.

pub fn rebalance_seal(&self) -> SpatialResult<()>

Seal / rebalance witness for the active branch.

Trait Implementations

impl SpatialBackend for BvhBackend

fn insert(&self, leaf: Leaf) -> SpatialResult<LeafId>

Insert a leaf; returns the assigned id.

fn remove(&self, id: LeafId) -> bool

Remove a leaf by id. Returns true if it was present.

fn get(&self, id: LeafId) -> Option<Leaf>

Fetch a leaf by id.

fn query_point(&self, p: Vec3) -> Vec<LeafId>

Leaves whose AABB contains p.

fn query_aabb(&self, bb: Aabb) -> Vec<LeafId>

Leaves intersecting bb.

fn query_sphere(&self, center: Vec3, radius: f32) -> Vec<LeafId>

Leaves intersecting sphere.

fn query_ray(&self, ray: Ray, max_t: f32) -> Vec<RayHit>

Leaves hit by ray (sorted by enter t).

fn query_frustum(&self, frustum: &Frustum) -> Vec<LeafId>

Leaves intersecting a frustum.

fn query_knn(&self, p: Vec3, k: usize) -> Vec<LeafId>

k nearest leaves by AABB-center distance.

fn derive_branch(&self, meta: BranchMeta) -> SpatialResult<BranchId>

Derive a child branch (COW in Phase D; full clone in Phase C).

fn branch_diff(&self, a: BranchId, b: BranchId, region: Aabb) -> Vec<DiffEntry>

Presence-only branch diff inside region.

fn epoch(&self) -> u64

Monotonic epoch (bumped on every mutation).

fn len(&self) -> usize

Number of leaves on the active branch.

fn backend_name(&self) -> &str

Human-readable backend name (e.g. "bvh").

fn max_leaves(&self) -> Option<usize>

Optional capacity limit.

fn is_empty(&self) -> bool

True when the active branch has no leaves.

fn insert_with_epoch( &self, leaf: Leaf, parent_epoch: u64, ) -> SpatialResult<LeafId>

Insert only if store epoch matches parent_epoch.