Skip to main content

Class: MeshPipeline

Constructors​

constructor​

• new MeshPipeline(): MeshPipeline

Returns​

MeshPipeline

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​

NameType
nowMsnumber
maxAgeMsnumber

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​

NameType
keystring
jobGenerationnumber

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​

NameType
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​

NameType
keystring

Returns​

boolean


hasInFlightJob​

▸ hasInFlightJob(key): boolean

Parameters​

NameType
keystring

Returns​

boolean


inFlightJobCount​

▸ inFlightJobCount(): number

Returns​

number


isDirty​

▸ isDirty(key): boolean

Whether a mesh job for this section is waiting to be dispatched.

Parameters​

NameType
keystring

Returns​

boolean


isUrgent​

▸ isUrgent(key): boolean

Parameters​

NameType
keystring

Returns​

boolean


makeKey​

▸ makeKey(cx, cz, level): string

Parameters​

NameType
cxnumber
cznumber
levelnumber

Returns​

string


markFreshFromServer​

▸ markFreshFromServer(cx, cz, level): void

Parameters​

NameType
cxnumber
cznumber
levelnumber

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​

NameType
centerCoords2
limitnumber
isReady?(cx: number, cz: number) => boolean
nowMsnumber

Returns​

string[]


needsRemesh​

▸ needsRemesh(key): boolean

Parameters​

NameType
keystring

Returns​

boolean


onJobComplete​

▸ onJobComplete(key, jobGeneration): boolean

Parameters​

NameType
keystring
jobGenerationnumber

Returns​

boolean


onVoxelChange​

▸ onVoxelChange(cx, cz, level, isUrgent?, nowMs?): void

Parameters​

NameTypeDefault value
cxnumberundefined
cznumberundefined
levelnumberundefined
isUrgentbooleanfalse
nowMsnumberundefined

Returns​

void


parseKey​

▸ parseKey(key): Object

Parameters​

NameType
keystring

Returns​

Object

NameType
cxnumber
cznumber
levelnumber

remove​

▸ remove(cx, cz): void

Parameters​

NameType
cxnumber
cznumber

Returns​

void


shouldStartJob​

▸ shouldStartJob(key): boolean

Parameters​

NameType
keystring

Returns​

boolean


startJob​

▸ startJob(key, nowMs?): number

Parameters​

NameType
keystring
nowMsnumber

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​

NameType
nowMsnumber

Returns​

number