meshBuf.module
README.md
meshBuf
Polygon meshes kept entirely in substrate (engine) memory, for ZeroBlender documents and every algorithm that edits them. No mesh-sized Luau table is ever built: every array is a CPU substrate buffer read and written in place.
Stores
M.words(n, fill?)->W: n numbers.:get(i),:set(i,v),:add(i,v),:push(v),:resize(n,fill?),:reserve(n),:fill(v),:copy(),:free(); field.n. Indices are 0-based. Integers are exact below 2^24.M.vec3s(n)->V3: n xyz records.:get(i)->x,y,z,:set(i,x,y,z),:add(i,x,y,z),:push(x,y,z),:zero(),:copy(),:free().M.hash(arity, expected?)->Hash: integer keys (1-3, each in [0,2^24)) mapping to a number.:get(a,b?,c?),:put(v,a,b?,c?),:each(fn(v,a,b,c)),:free(); field.n.
Mesh (M.new())
Fields: P (V3 positions, nv), C (W corner vertex ids), O (W face offsets, nf+1 words), FM (W material slot per face, or nil), UV (list of {name, W}, two words per corner; uvActive/uvRender 1-based), LE (W loose edges, 2 words each), SEL + selMode, ver (bumped by every edit).
Reading: co(i), faceStart(f), faceEnd(f), faceLen(f), corner(c), faceMat(f), uv(layer,c), faceNormal(f), faceNormalRaw(f), faceCenter(f), faceArea(f), bounds(), triangleCount(), signedVolume(), looseCount(), isSel(i).
Writing: addVert(x,y,z), setCo, pushCorner(v) then closeFace(slot?), setCorner, setFaceMat, addUVLayer(name,init?), setUV, removeUVLayer, addLooseEdge(a,b), setSel, clearSel, reverseFace(f), filterFaces(keep), compactVerts(), append(src,T,remap,flip), clearFaces(), clear(), copy(), assign(src) (takes src's stores), free().
Derived data
M.edges(m)-> unique undirected edges, numbered in (low, high) vertex order:.n,:verts(e),:find(a,b),:faceCount(e),.CE(edge of corner c -> c+1). Cached untilm.verchanges.M.vertexCorners(m)->{off, vc, cf}CSR: the corners of vertex v arevc[off[v] .. off[v+1]),cf[c]is the face of corner c. Call:free().M.triangulate(m)->T(3 corner ids per triangle),TF(face per triangle). Quads and n-gons ear-clipped against the face normal.M.vertexNormals(m),M.cornerNormalsByAngle(m, angle)-> V3.M.weldIds(m, tol),M.audit(m).
Drawing and saving
M.upload(m, slot|nil, "flat"|"smooth"|"angle", normals?, name)builds GPU vertex and index buffers and a renderer mesh from them (Zero basis x, z, -y).M.release(up)frees them.M.save(m)-> blob string,M.load(blob, uvNames)-> Mesh.
local MB = require("~ZeroBlender.modules.meshBuf")
local m = MB.new()
for _, p in { {0,0,0}, {1,0,0}, {0,1,0} } do m:addVert(p[1], p[2], p[3]) end
m:pushCorner(0); m:pushCorner(1); m:pushCorner(2); m:closeFace()
local up = MB.upload(m, nil, "flat", nil, "tri")