class

IScanTraceBackend

A trace the LiDAR scanner can cast shots against instead of the Jolt colliders. The Embree scan hierarchy is one, and it lives in an opt-in plugin (ScanHierarchy) so a game that does not enable it ships no Embree; with none registered the scanner stays on the Jolt batch path.

Module
Game
Header
#include "PointCloud/ScanTraceBackend.h"
Namespace
Mowo

Constructors

SignatureNameDescription
virtual ~IScanTraceBackend() = default~IScanTraceBackend

Public functions

ReturnsNameDescription
voidBuildBakes the level's static geometry.
voidSyncRe-poses moving bodies and bone capsules.
voidPrewarmBuild in three steps for a caller that must not stall a frame on it: Prewarm (any thread, touches no world) stands up what the build needs, BuildDeferred (game thread) gathers the level, FinishBuild (any thread) builds the hierarchy over what was gathered.
voidBuildDeferred
voidFinishBuild
boolIsAvailableFalse when the backend could not build anything to trace against; the scanner then falls back to Jolt.
uint32_tTrace
std::shared_ptr<IAcousticGeometry>CreateAcousticGeometryThe same geometry as something sound can be traced against, or null when the backend cannot offer it.

Function details

~IScanTraceBackend

C++
virtual ~IScanTraceBackend() = default

Build

C++
virtual void Build(World& world) = 0

Bakes the level's static geometry. Game thread, before the first shot.

Sync

C++
virtual void Sync(World& world) = 0

Re-poses moving bodies and bone capsules. Game thread, before a frame's shots.

Prewarm

C++
virtual void Prewarm()

Build in three steps for a caller that must not stall a frame on it: Prewarm (any thread, touches no world) stands up what the build needs, BuildDeferred (game thread) gathers the level, FinishBuild (any thread) builds the hierarchy over what was gathered. Nothing may trace the backend before FinishBuild returns. A backend that cannot split its build does all of it in BuildDeferred.

BuildDeferred

C++
virtual void BuildDeferred(World& world)

FinishBuild

C++
virtual void FinishBuild()

IsAvailable

C++
virtual bool IsAvailable() const = 0

False when the backend could not build anything to trace against; the scanner then falls back to Jolt.

Trace

C++
virtual uint32_t Trace(const FLidarShot& shot, std::vector<FLidarHit>& outHits) = 0

CreateAcousticGeometry

C++
virtual std::shared_ptr<IAcousticGeometry> CreateAcousticGeometry()

The same geometry as something sound can be traced against, or null when the backend cannot offer it. It reads the backend's current build: a later Build() replaces what it points at, so ask again after one.

Generated from PointCloud/ScanTraceBackend.h via game.json · Nov 5, 2026Version 1.0.0