warp.bvh_query_ray#

warp.bvh_query_ray(
id: uint64,
start: vec3f,
dir: vec3f,
root: int32,
) → BvhQuery#

  • Kernel

Construct a ray query against a BVH object.

This query can be used to iterate over all bounds that intersect the ray. To start a query from a specific node, set root to the index of the node. The root can be obtained using the bvh_get_group_root() function when creating a grouped BVH. When root is a valid (>=0) value, the traversal will be confined to the subtree starting from the root. If root is -1 (default), traversal starts at the BVH’s global root. The query will only traverse down from that node, limiting traversal to that subtree.

Parameters:

  • id – The BVH identifier

  • start – The start of the ray in BVH space

  • dir – The direction of the ray in BVH space (should be normalized)

  • root – The root to begin the query from (optional, default: -1)