@mui/x-charts-premium 9.6.0 → 9.8.0

package/utils/webgl/utils.js

@@ -3,11 +3,13 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.attachShader = attachShader;
 exports.bindQuadBuffer = bindQuadBuffer;
 exports.compileShader = compileShader;
 exports.createGrowableBuffer = createGrowableBuffer;
+exports.ensurePool = ensurePool;
+exports.linkProgram = linkProgram;
 exports.logWebGLErrors = logWebGLErrors;
+exports.setupStandardBlending = setupStandardBlending;
 exports.uploadGrowableBuffer = uploadGrowableBuffer;
 exports.uploadQuadBuffer = uploadQuadBuffer;
 function compileShader(gl, shaderSource, shaderType) {
@@ -29,13 +31,6 @@ function bindQuadBuffer(gl, program, quadBuffer) {
   gl.enableVertexAttribArray(aPosition);
   gl.vertexAttribPointer(aPosition, 2, gl.FLOAT, false, 0, 0);
 }
-function attachShader(gl, program, shaderSource, shaderType) {
-  const shader = gl.createShader(shaderType);
-  gl.shaderSource(shader, shaderSource);
-  gl.compileShader(shader);
-  gl.attachShader(program, shader);
-  return shader;
-}
 function createGrowableBuffer(gl) {
   return {
     buffer: gl.createBuffer(),
@@ -77,4 +72,45 @@ function logWebGLErrors(gl) {
       error = gl.getError();
     }
   }
+}
+
+/** Enables the standard non-premultiplied src-alpha blending used by all premium WebGL renderers. */
+function setupStandardBlending(gl) {
+  gl.enable(gl.BLEND);
+  gl.blendFunc(gl.SRC_ALPHA, gl.ONE_MINUS_SRC_ALPHA);
+}
+
+/**
+ * Returns `existing` when it's large enough to hold `length` elements, otherwise
+ * allocates a fresh typed array via `Ctor`. Lets consumers keep one ref per
+ * pool and short-circuit growth checks inline.
+ */
+function ensurePool(existing, length, Ctor) {
+  if (existing != null && existing.length >= length) {
+    return existing;
+  }
+  return new Ctor(length);
+}
+/**
+ * Compiles vertex + fragment shaders, attaches them, links the program, and returns
+ * both the program and its shaders. Logs link/compile diagnostics in dev when linking fails.
+ */
+function linkProgram(gl, vertexShaderSource, fragmentShaderSource) {
+  const program = gl.createProgram();
+  const vertexShader = compileShader(gl, vertexShaderSource, gl.VERTEX_SHADER);
+  const fragmentShader = compileShader(gl, fragmentShaderSource, gl.FRAGMENT_SHADER);
+  gl.attachShader(program, vertexShader);
+  gl.attachShader(program, fragmentShader);
+  gl.linkProgram(program);
+  if (process.env.NODE_ENV !== 'production' && !gl.getProgramParameter(program, gl.LINK_STATUS)) {
+    // WebGL best-practices: consult compile/link status only in dev mode
+    // https://developer.mozilla.org/en-US/docs/Web/API/WebGL_API/WebGL_best_practices#dont_check_shader_compile_status_unless_linking_fails
+    console.error(`Program linking failed: ${gl.getProgramInfoLog(program)}`);
+    console.error(`Vertex shader info-log: ${gl.getShaderInfoLog(vertexShader)}`);
+    console.error(`Fragment shader info-log: ${gl.getShaderInfoLog(fragmentShader)}`);
+  }
+  return {
+    program,
+    shaders: [vertexShader, fragmentShader]
+  };
 }

package/utils/webgl/utils.mjs

@@ -17,13 +17,6 @@ export function bindQuadBuffer(gl, program, quadBuffer) {
   gl.enableVertexAttribArray(aPosition);
   gl.vertexAttribPointer(aPosition, 2, gl.FLOAT, false, 0, 0);
 }
-export function attachShader(gl, program, shaderSource, shaderType) {
-  const shader = gl.createShader(shaderType);
-  gl.shaderSource(shader, shaderSource);
-  gl.compileShader(shader);
-  gl.attachShader(program, shader);
-  return shader;
-}
 export function createGrowableBuffer(gl) {
   return {
     buffer: gl.createBuffer(),
@@ -65,4 +58,45 @@ export function logWebGLErrors(gl) {
       error = gl.getError();
     }
   }
+}
+
+/** Enables the standard non-premultiplied src-alpha blending used by all premium WebGL renderers. */
+export function setupStandardBlending(gl) {
+  gl.enable(gl.BLEND);
+  gl.blendFunc(gl.SRC_ALPHA, gl.ONE_MINUS_SRC_ALPHA);
+}
+
+/**
+ * Returns `existing` when it's large enough to hold `length` elements, otherwise
+ * allocates a fresh typed array via `Ctor`. Lets consumers keep one ref per
+ * pool and short-circuit growth checks inline.
+ */
+export function ensurePool(existing, length, Ctor) {
+  if (existing != null && existing.length >= length) {
+    return existing;
+  }
+  return new Ctor(length);
+}
+/**
+ * Compiles vertex + fragment shaders, attaches them, links the program, and returns
+ * both the program and its shaders. Logs link/compile diagnostics in dev when linking fails.
+ */
+export function linkProgram(gl, vertexShaderSource, fragmentShaderSource) {
+  const program = gl.createProgram();
+  const vertexShader = compileShader(gl, vertexShaderSource, gl.VERTEX_SHADER);
+  const fragmentShader = compileShader(gl, fragmentShaderSource, gl.FRAGMENT_SHADER);
+  gl.attachShader(program, vertexShader);
+  gl.attachShader(program, fragmentShader);
+  gl.linkProgram(program);
+  if (process.env.NODE_ENV !== 'production' && !gl.getProgramParameter(program, gl.LINK_STATUS)) {
+    // WebGL best-practices: consult compile/link status only in dev mode
+    // https://developer.mozilla.org/en-US/docs/Web/API/WebGL_API/WebGL_best_practices#dont_check_shader_compile_status_unless_linking_fails
+    console.error(`Program linking failed: ${gl.getProgramInfoLog(program)}`);
+    console.error(`Vertex shader info-log: ${gl.getShaderInfoLog(vertexShader)}`);
+    console.error(`Fragment shader info-log: ${gl.getShaderInfoLog(fragmentShader)}`);
+  }
+  return {
+    program,
+    shaders: [vertexShader, fragmentShader]
+  };
 }