Class: MeshPipeline
Constructors
constructor
• new MeshPipeline(): MeshPipeline
Returns
Accessors
dirtyCount
• get dirtyCount(): number
Returns
number
hasCoolingRebuilds
• get hasCoolingRebuilds(): boolean
Whether the last nearestDirtyKeys pass left out a rebuild only
because it was started too recently: nothing else will announce the
end of its wait, so the caller looks again next frame.
Returns
boolean
Methods
expireStuckJobs
▸ expireStuckJobs(nowMs, maxAgeMs): string[]
The leak watchdog: release any in-flight generation older than
maxAgeMs and re-queue its key. Single-flight dispatch turns one
unsettled job into a chunk level that never re-meshes again for the
whole session, and every historical instance of that (a shed queue, a
dispatch path missing its release, a worker that died) has looked like
this exact symptom: a walkable chunk that stopped rendering hours into
a long session and stayed gone until reload. Expiry converts whichever
such path still exists — or gets written next — from a permanent hole
into a logged self-heal. Returns the expired keys for the caller to
report.
Parameters
| Name | Type |
|---|---|
nowMs | number |
maxAgeMs | number |
Returns
string[]
failJob
▸ failJob(key, jobGeneration): void
Release an in-flight generation that produced no mesh (worker bail-out). Re-queues the key so remesh can retry instead of leaving a permanent ghost mesh when voxel data already changed but geometry never applied.
Parameters
| Name | Type |
|---|---|
key | string |
jobGeneration | number |
Returns
void
getDirtyKeys
▸ getDirtyKeys(center?): string[]
Dirty keys ready for dispatch: the urgent lane first in insertion order
(player edits stay latency-ordered), then regular keys nearest-first
around center so remesh work reaches the camera before the horizon.
Without a center the regular lane keeps insertion order.
Parameters
| Name | Type |
|---|---|
center? | Coords2 |
Returns
string[]
hasAnyInFlightJobs
▸ hasAnyInFlightJobs(): boolean
Returns
boolean
hasDirtyChunks
▸ hasDirtyChunks(): boolean
Returns
boolean
hasDisplayed
▸ hasDisplayed(key): boolean
Whether some mesh of this section, current or not, has been applied.
Parameters
| Name | Type |
|---|---|
key | string |
Returns
boolean
hasInFlightJob
▸ hasInFlightJob(key): boolean
Parameters
| Name | Type |
|---|---|
key | string |
Returns
boolean
inFlightJobCount
▸ inFlightJobCount(): number
Returns
number
isDirty
▸ isDirty(key): boolean
Whether a mesh job for this section is waiting to be dispatched.
Parameters
| Name | Type |
|---|---|
key | string |
Returns
boolean
isUrgent
▸ isUrgent(key): boolean
Parameters
| Name | Type |
|---|---|
key | string |
Returns
boolean
makeKey
▸ makeKey(cx, cz, level): string
Parameters
| Name | Type |
|---|---|
cx | number |
cz | number |
level | number |
Returns
string
markFreshFromServer
▸ markFreshFromServer(cx, cz, level): void
Parameters
| Name | Type |
|---|---|
cx | number |
cz | number |
level | number |
Returns
void
nearestDirtyKeys
▸ nearestDirtyKeys(center, limit, isReady?, nowMs?): string[]
The keys to dispatch next: the urgent lane whole, then at most limit
regular keys, nearest first but sections with nothing on screen ahead
of rebuilds of ones already drawn (REBUILD_QUOTA). Found in one pass
instead of a sort: a
flight keeps thousands of sections dirty, and sorting them all for
every dispatch cost more than the dispatches did. A regular key
isReady turns down is left out (and stays dirty) for this pass, and so
is a rebuild started under REBUILD_COOLDOWN_MS ago
(hasCoolingRebuilds then says a later pass has work).
Parameters
| Name | Type |
|---|---|
center | Coords2 |
limit | number |
isReady? | (cx: number, cz: number) => boolean |
nowMs | number |
Returns
string[]
needsRemesh
▸ needsRemesh(key): boolean
Parameters
| Name | Type |
|---|---|
key | string |
Returns
boolean
onJobComplete
▸ onJobComplete(key, jobGeneration): boolean
Parameters
| Name | Type |
|---|---|
key | string |
jobGeneration | number |
Returns
boolean
onVoxelChange
▸ onVoxelChange(cx, cz, level, isUrgent?, nowMs?): void
Parameters
| Name | Type | Default value |
|---|---|---|
cx | number | undefined |
cz | number | undefined |
level | number | undefined |
isUrgent | boolean | false |
nowMs | number | undefined |
Returns
void
parseKey
▸ parseKey(key): Object
Parameters
| Name | Type |
|---|---|
key | string |
Returns
Object
| Name | Type |
|---|---|
cx | number |
cz | number |
level | number |
remove
▸ remove(cx, cz): void
Parameters
| Name | Type |
|---|---|
cx | number |
cz | number |
Returns
void
shouldStartJob
▸ shouldStartJob(key): boolean
Parameters
| Name | Type |
|---|---|
key | string |
Returns
boolean
startJob
▸ startJob(key, nowMs?): number
Parameters
| Name | Type |
|---|---|
key | string |
nowMs | number |
Returns
number
urgentDirtyKeys
▸ urgentDirtyKeys(): string[]
Urgent keys a dispatch can start now, in the order they went dirty.
Returns
string[]
urgentWaitMs
▸ urgentWaitMs(nowMs?): number
How long the urgent key that has waited longest for a dispatch has waited; 0 with none waiting.
Parameters
| Name | Type |
|---|---|
nowMs | number |
Returns
number