sparcoon 0.9.3 → 0.9.4

package/README.md

@@ -8,7 +8,7 @@ build.
 
 **[Open the editor](https://jango-git.github.io/sparcoon-editor/)** -
 [Editor source](https://github.com/jango-git/sparcoon-editor) -
-[npm](https://www.npmjs.com/package/sparcoon/v/0.9.3)
+[npm](https://www.npmjs.com/package/sparcoon/v/0.9.4)
 
 > **Pre-release.** The artifact format is not frozen yet - breaking changes are possible before the
 > first stable release. The package is published under the `experimental` tag: npm's `latest` holds

package/dist/emitter/FXTransformFeedbackSimulationHolder.js

@@ -38,6 +38,7 @@ export class FXTransformFeedbackSimulationHolder {
         // class's own tests use.
         this.bufferNames = artifact.buffers.map((buffer) => meshPropertyKeyFor(buffer.name));
         this.strides = artifact.buffers.map((buffer) => buffer.stride);
+        assertFitsTransformFeedback(gl, artifact.buffers);
         const vertexShader = compileShader(gl, gl.VERTEX_SHADER, artifact.vertexSource);
         const fragmentShader = compileShader(gl, gl.FRAGMENT_SHADER, artifact.fragmentSource);
         const program = gl.createProgram();
@@ -233,6 +234,27 @@ const FIXED_UNIFORM_NAMES = [
     FX_TRANSFORM_FEEDBACK_OBJECT_VELOCITY_UNIFORM,
     FX_TRANSFORM_FEEDBACK_OBJECT_ANGULAR_VELOCITY_UNIFORM,
 ];
+/**
+ * Throws when `buffers` need more transform-feedback outputs than this GPU offers: one output per
+ * buffer (SEPARATE_ATTRIBS), each at most so many components. Checked up front because WebGL does
+ * not fail anything visible over it - `transformFeedbackVaryings` only raises a GL error, the
+ * program links without its outputs, and every pass then writes nothing, so particles never spawn.
+ * The throw instead sends the emitter to its JS kernel (see `FXEmitter.fromArtifacts`). WebGL2
+ * guarantees only 4 outputs of 4 components, the two core buffers included.
+ */
+function assertFitsTransformFeedback(gl, buffers) {
+    const maxBuffers = gl.getParameter(gl.MAX_TRANSFORM_FEEDBACK_SEPARATE_ATTRIBS);
+    if (buffers.length > maxBuffers) {
+        throw new Error(`FXTransformFeedbackSimulationHolder: the kernel writes ${String(buffers.length)} buffers; ` +
+            `this GPU's transform feedback takes at most ${String(maxBuffers)}`);
+    }
+    const maxComponents = gl.getParameter(gl.MAX_TRANSFORM_FEEDBACK_SEPARATE_COMPONENTS);
+    const wide = buffers.find((buffer) => buffer.stride > maxComponents);
+    if (wide !== undefined) {
+        throw new Error(`FXTransformFeedbackSimulationHolder: buffer "${wide.name}" has ${String(wide.stride)} ` +
+            `components; this GPU's transform feedback takes at most ${String(maxComponents)} per buffer`);
+    }
+}
 function compileShader(gl, type, source) {
     const shader = gl.createShader(type);
     if (shader === null) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sparcoon",
-  "version": "0.9.3",
+  "version": "0.9.4",
   "description": "Three.js runtime for visual effects authored in the Sparcoon Editor - precompiled artifacts, one draw call per emitter, no eval.",
   "keywords": [
     "three",