Struct BvhWorkspace

pub struct BvhWorkspace { /* private fields */ }

Workspace data for various operations on the BVH tree.

This structure holds temporary buffers and working memory used during BVH operations such as refitting, rebuilding, and optimization. The data inside can be freed at any time without affecting the correctness of BVH results.

Purpose

Many BVH operations require temporary allocations for intermediate results. By reusing the same BvhWorkspace across multiple operations, you can significantly reduce allocation overhead and improve performance, especially in performance-critical loops.

Usage Pattern

1. Create a workspace once (or use Default::default())
2. Pass it to BVH operations that accept a workspace parameter
3. Reuse the same workspace for subsequent operations
4. The workspace grows to accommodate the largest operation size

Memory Management

• The workspace grows as needed but never automatically shrinks
• You can drop and recreate the workspace to free memory
• All data is private and managed internally by the BVH

Example

use parry3d::partitioning::{Bvh, BvhBuildStrategy, BvhWorkspace};
use parry3d::bounding_volume::Aabb;
use nalgebra::Point3;

let aabbs = vec![
    Aabb::new(Point3::origin(), Point3::new(1.0, 1.0, 1.0)),
    Aabb::new(Point3::new(2.0, 0.0, 0.0), Point3::new(3.0, 1.0, 1.0)),
];

let mut bvh = Bvh::from_leaves(BvhBuildStrategy::default(), &aabbs);
let mut workspace = BvhWorkspace::default();

// Refit the tree after leaf movements
bvh.refit(&mut workspace);

// Reuse the same workspace for optimization
bvh.optimize_incremental(&mut workspace);

// The workspace can be reused across multiple BVH operations

See Also

• Bvh::refit - Update AABBs after leaf movement
• Bvh::optimize_incremental - Incremental tree optimization

Trait Implementations

impl Clone for BvhWorkspace

fn clone(&self) -> BvhWorkspace

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for BvhWorkspace

fn default() -> BvhWorkspace

Returns the “default value” for a type.