class

FPointCloudEphemeral

Points that landed on something that can move. They are kept apart from the persistent cloud because they are wrong the moment the body moves — and because that wrongness is the game: scan, see a silhouette standing in the dark, scan again, and it is somewhere else.

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

A ring buffer rather than a growing set. A monster walking through a beam produces points forever, so the only safe capacity policy is a fixed one where the oldest point is the one that dies.

Public functions

ReturnsNameDescription
voidConfigure
uint32_tAddHits
voidDecayRebuilds the drawable set for tick, dropping the expired points and grouping the survivors by chunk: a record's position is relative to its chunk's corner, so each chunk the ring touches is one draw range with its own origin.
const std::vector<PointCloudPoint>&GetVisiblePoints
const std::vector<PointCloudDrawRange>&GetVisibleRangesRanges into GetVisiblePoints(), firstPoint relative to its start.
uint32_tGetVisibleCount
uint32_tGetCapacity
uint32_tGetLifetimeTicks
uint32_tGetLiveCountEntries the ring currently holds, expired ones included — Decay has not necessarily run since the last AddHits.
uint64_tGetEvictedCountPoints a later point overwrote because the ring was full.
floatLifeOfThe remaining life the shader computes for a visible record at tick: 1 at spawn, 0 at expiry, linear.
Vec3VisibleWorldPositionWorld position of the visible record at index.
uint64_tMeasureBytes
voidClear

Function details

Configure

C++
void Configure(uint32_t capacity, uint32_t lifetimeTicks)

AddHits

C++
uint32_t AddHits(const FLidarHit* hits, uint32_t count, uint64_t tick)

Decay

C++
void Decay(uint64_t tick)

Rebuilds the drawable set for tick, dropping the expired points and grouping the survivors by chunk: a record's position is relative to its chunk's corner, so each chunk the ring touches is one draw range with its own origin. Each record's birth stamp is its spawn tick; the life curve applied to it is the shader's, so it can be retuned without touching the CPU side or re-uploading anything.

GetVisiblePoints

C++
const std::vector<PointCloudPoint>& GetVisiblePoints() const

GetVisibleRanges

C++
const std::vector<PointCloudDrawRange>& GetVisibleRanges() const

Ranges into GetVisiblePoints(), firstPoint relative to its start.

GetVisibleCount

C++
uint32_t GetVisibleCount() const

GetCapacity

C++
uint32_t GetCapacity() const

GetLifetimeTicks

C++
uint32_t GetLifetimeTicks() const

GetLiveCount

C++
uint32_t GetLiveCount() const

Entries the ring currently holds, expired ones included — Decay has not necessarily run since the last AddHits.

GetEvictedCount

C++
uint64_t GetEvictedCount() const

Points a later point overwrote because the ring was full. Non-zero means the cap is doing work: the scanner is producing faster than the lifetime retires, and the oldest silhouette is being cut short rather than the newest being dropped.

LifeOf

C++
float LifeOf(const PointCloudPoint& point, uint64_t tick) const

The remaining life the shader computes for a visible record at tick: 1 at spawn, 0 at expiry, linear.

VisibleWorldPosition

C++
Vec3 VisibleWorldPosition(uint32_t index) const

World position of the visible record at index.

MeasureBytes

C++
uint64_t MeasureBytes() const

Clear

C++
void Clear()
Generated from PointCloud/PointCloudEphemeral.h via game.json · Nov 5, 2026Version 1.0.0