CPU-side backing buffer used to populate this texture.
The concrete type depends on the implementation (e.g., Uint32Array,
Float32Array, or a view over an ArrayBuffer). This buffer is
uploaded to the GPU when updated.
The ArrayBufferView class used for the CPU-side buffer.
Size in bytes of a single texel in the data texture.
Enables internal event emission for this data texture.
Human-readable description of the data stored in this texture.
Intended for debugging UIs and diagnostics (e.g., displayed above inspectors). Subclasses or owners should populate this with a concise explanation of the layout and semantic meaning (e.g., “mesh matrices (Mat4, row-major), indexed by meshId”).
Number of individual elements (e.g., floats, uint32s) stored per logical item in this data texture.
Number of individual elements (e.g., floats, uint32s) stored per texel in the data texture.
Texture format (e.g., gl.RGBA, gl.RGBA_INTEGER).
The WebGL2 rendering context.
Texture height in texels.
Texture internal format (e.g., gl.RGBA8, gl.RGBA32UI, gl.RGBA32F).
Size in bytes of a single logical item stored in the data texture.
Duration (in milliseconds) of the last upload to GPU.
This value is 0 until the first upload occurs.
Maximum number of logical items that can be stored in this texture.
The value of numItems never exceeds this limit.
Emitted when the CPU-side buffer for this texture has changed and been uploaded to the GPU.
This event is intended for debugging tools and monitoring UIs; it is only emitted when debugging is enabled.
Number of texels occupied by a single logical item in the data texture.
InternaltextureThe underlying WebGL texture object.
This is the GPU resource that is bound and sampled/loaded by shaders.
Texture data type (e.g., gl.UNSIGNED_BYTE, gl.UNSIGNED_INT, gl.FLOAT).
Whether to use a CPU-side buffer for staging data before uploading to the GPU.
Texture width in texels.
Static ReadonlyitemGets the number of logical items currently stored in this texture.
Cancels all pending uploads by clearing the dirty set.
InternalFrees GPU resources associated with this data texture.
Gets the total capacity in bytes of the data texture.
Gets the item at the given index within its portion.
Retrieves all logical items currently stored in this texture.
An array of decoded items.
Gets the used capacity in bytes of the data texture.
ProtectednotifyInternalNotifies listeners that the data texture has been updated.
ProtectedsetMarks an item as dirty, so it will be uploaded on the next update.
Index of the item to mark as dirty.
Uploads all dirty items to the GPU as efficiently as possible.
Internal algorithm:
texSubImage2D calls by uploading as large a block as possible per call.True if any uploads occurred, false otherwise.
Stores per-mesh attributes shared across views — tile + geometry indices, Cook-Torrance material parameters, and one UV transform per PBR-map type.
Three texels per mesh, twelve u32 slots total (linearised —
baseisitemIndex * elementsPerItem):base + 0tileIndexbase + 1geometryIndexbase + 2PBR material + hatch slot — bits 0-7 areroughness(u8), bits 8-15 aremetallic(u8), bits 16-31 arehatchPatternSlot(0= no hatch,> 0= index into the per-batch "./HatchPatternTexture".HatchPatternTexture)base + 3alpha + line-pattern slot — bits 0-7 arealphaMode(0 = OPAQUE,1 = MASK,2 = BLEND), bits 8-15 arealphaCutoff(u8 normalised to[0, 255]), and bits 16-31 arelinePatternSlot(0= no per-mesh pattern, fall back to the View'slinesMaterial.linePattern;> 0= index into the per-batch "./LinePatternTexture".LinePatternTexture where the material's pattern entries are written)base + 4packed albedo(uOffset, vOffset)— two u16s, R = lobase + 5packed albedo(uScale, vScale)— two u16s, R = lobase + 6packed metallic-roughness(uOffset, vOffset)base + 7packed metallic-roughness(uScale, vScale)base + 8packed normal-map(uOffset, vOffset)base + 9packed normal-map(uScale, vScale)base + 10triplanar repeat distance — Float32 bit pattern reinterpret (read in the shader viauintBitsToFloat). Consumed only by the triplanar shader variant; UV-bearing batches ignore it.base + 11per-mesh line thickness in screen pixels — Float32 bit pattern reinterpret. Consumed by the thick-line draw technique;0falls back to the View'slinesMaterial.lineWidth.Each UV transform takes per-vertex
vUV ∈ [0, 1]to atlas-space:atlasUV = vUV * (uScale, vScale) + (uOffset, vOffset). Different PBR maps live in separate per-batch atlases (different formats — sRGB for albedo, linear for MR / normals), so each map gets its own transform — artists can pack their textures independently. Untextured meshes write the relevant atlas's sentinel transform (scale = 0) so they collapse to a single sentinel texel without branching in the shader.Per-material line-pattern entries live in a separate "./LinePatternTexture".LinePatternTexture indexed by
linePatternSlot. Splitting them out keeps triangle / point batches from paying any storage for line-only data — a slot of0here means "no per-mesh pattern", so the renderer skips the pattern-table lookup entirely.