@remotion/effects 4.0.467 → 4.0.468

package/dist/esm/hue.mjs

@@ -17,6 +17,12 @@ var assertRequiredColor = (value, name) => {
     throw new TypeError(`"${name}" must be a non-empty string, but got ${JSON.stringify(value)}`);
   }
 };
+var assertOptionalColor = (value, name) => {
+  if (value === undefined) {
+    return;
+  }
+  assertRequiredColor(value, name);
+};
 
 // src/color-utils.ts
 var DEFAULT_AMOUNT = 1;
@@ -81,6 +87,13 @@ var validateSignedUnitInterval = (value, name) => {
 var clampColorChannel = (value) => {
   return Math.max(0, Math.min(255, value));
 };
+var parseColorRgba = (ctx, color) => {
+  ctx.clearRect(0, 0, 1, 1);
+  ctx.fillStyle = color;
+  ctx.fillRect(0, 0, 1, 1);
+  const { data } = ctx.getImageData(0, 0, 1, 1);
+  return [data[0], data[1], data[2], data[3]];
+};
 
 // src/hue.ts
 var { createEffect } = Internals;
@@ -96,7 +109,7 @@ var validateHueParams = (params) => {
 };
 var hue = createEffect({
   type: "remotion/hue",
-  label: "Hue",
+  label: "hue()",
   documentationLink: "https://www.remotion.dev/docs/effects/hue",
   backend: "2d",
   calculateKey: (params) => {

package/dist/esm/invert.mjs

@@ -17,6 +17,12 @@ var assertRequiredColor = (value, name) => {
     throw new TypeError(`"${name}" must be a non-empty string, but got ${JSON.stringify(value)}`);
   }
 };
+var assertOptionalColor = (value, name) => {
+  if (value === undefined) {
+    return;
+  }
+  assertRequiredColor(value, name);
+};
 
 // src/color-utils.ts
 var DEFAULT_AMOUNT = 1;
@@ -81,6 +87,13 @@ var validateSignedUnitInterval = (value, name) => {
 var clampColorChannel = (value) => {
   return Math.max(0, Math.min(255, value));
 };
+var parseColorRgba = (ctx, color) => {
+  ctx.clearRect(0, 0, 1, 1);
+  ctx.fillStyle = color;
+  ctx.fillRect(0, 0, 1, 1);
+  const { data } = ctx.getImageData(0, 0, 1, 1);
+  return [data[0], data[1], data[2], data[3]];
+};
 
 // src/invert.ts
 var { createEffect } = Internals;
@@ -98,7 +111,7 @@ var validateInvertParams = (params) => {
 };
 var invert = createEffect({
   type: "remotion/invert",
-  label: "Invert",
+  label: "invert()",
   documentationLink: "https://www.remotion.dev/docs/effects/invert",
   backend: "2d",
   calculateKey: (params) => {

package/dist/esm/mirror.mjs

@@ -17,6 +17,12 @@ var assertRequiredColor = (value, name) => {
     throw new TypeError(`"${name}" must be a non-empty string, but got ${JSON.stringify(value)}`);
   }
 };
+var assertOptionalColor = (value, name) => {
+  if (value === undefined) {
+    return;
+  }
+  assertRequiredColor(value, name);
+};
 
 // src/color-utils.ts
 var DEFAULT_AMOUNT = 1;
@@ -81,6 +87,13 @@ var validateSignedUnitInterval = (value, name) => {
 var clampColorChannel = (value) => {
   return Math.max(0, Math.min(255, value));
 };
+var parseColorRgba = (ctx, color) => {
+  ctx.clearRect(0, 0, 1, 1);
+  ctx.fillStyle = color;
+  ctx.fillRect(0, 0, 1, 1);
+  const { data } = ctx.getImageData(0, 0, 1, 1);
+  return [data[0], data[1], data[2], data[3]];
+};
 
 // src/mirror/mirror-runtime.ts
 import { Internals } from "remotion";
@@ -328,7 +341,7 @@ var validateMirrorParams = (params) => {
 };
 var mirror = createEffect({
   type: "remotion/mirror",
-  label: "Mirror",
+  label: "mirror()",
   documentationLink: "https://www.remotion.dev/docs/effects/mirror",
   backend: "webgl2",
   calculateKey: (params) => {

package/dist/esm/saturation.mjs

@@ -17,6 +17,12 @@ var assertRequiredColor = (value, name) => {
     throw new TypeError(`"${name}" must be a non-empty string, but got ${JSON.stringify(value)}`);
   }
 };
+var assertOptionalColor = (value, name) => {
+  if (value === undefined) {
+    return;
+  }
+  assertRequiredColor(value, name);
+};
 
 // src/color-utils.ts
 var DEFAULT_AMOUNT = 1;
@@ -81,6 +87,13 @@ var validateSignedUnitInterval = (value, name) => {
 var clampColorChannel = (value) => {
   return Math.max(0, Math.min(255, value));
 };
+var parseColorRgba = (ctx, color) => {
+  ctx.clearRect(0, 0, 1, 1);
+  ctx.fillStyle = color;
+  ctx.fillRect(0, 0, 1, 1);
+  const { data } = ctx.getImageData(0, 0, 1, 1);
+  return [data[0], data[1], data[2], data[3]];
+};
 
 // src/saturation.ts
 var { createEffect } = Internals;
@@ -98,7 +111,7 @@ var validateSaturationParams = (params) => {
 };
 var saturation = createEffect({
   type: "remotion/saturation",
-  label: "Saturation",
+  label: "saturation()",
   documentationLink: "https://www.remotion.dev/docs/effects/saturation",
   backend: "2d",
   calculateKey: (params) => {

package/dist/esm/scale.mjs

@@ -17,6 +17,12 @@ var assertRequiredColor = (value, name) => {
     throw new TypeError(`"${name}" must be a non-empty string, but got ${JSON.stringify(value)}`);
   }
 };
+var assertOptionalColor = (value, name) => {
+  if (value === undefined) {
+    return;
+  }
+  assertRequiredColor(value, name);
+};
 
 // src/scale/index.ts
 var { createEffect } = Internals;
@@ -61,7 +67,7 @@ var validateScaleParams = (params) => {
 };
 var scale = createEffect({
   type: "remotion/scale",
-  label: "Scale",
+  label: "scale()",
   documentationLink: "https://www.remotion.dev/docs/effects/scale",
   backend: "2d",
   calculateKey: (params) => {

package/dist/esm/shine.mjs

@@ -0,0 +1,389 @@
+// src/shine.ts
+import { Internals } from "remotion";
+
+// src/validate-effect-param.ts
+var assertEffectParamsObject = (params, effectLabel) => {
+  if (params === null || typeof params !== "object") {
+    throw new TypeError(`${effectLabel} effect requires a parameters object, but got ${JSON.stringify(params)}`);
+  }
+};
+var assertRequiredFiniteNumber = (value, name) => {
+  if (typeof value !== "number" || !Number.isFinite(value)) {
+    throw new TypeError(`"${name}" must be a finite number, but got ${JSON.stringify(value)}`);
+  }
+};
+var assertRequiredColor = (value, name) => {
+  if (typeof value !== "string" || value.length === 0) {
+    throw new TypeError(`"${name}" must be a non-empty string, but got ${JSON.stringify(value)}`);
+  }
+};
+var assertOptionalColor = (value, name) => {
+  if (value === undefined) {
+    return;
+  }
+  assertRequiredColor(value, name);
+};
+
+// src/color-utils.ts
+var DEFAULT_AMOUNT = 1;
+var DEFAULT_BRIGHTNESS_AMOUNT = 0;
+var DEFAULT_HUE_DEGREES = 0;
+var colorAmountSchema = {
+  type: "number",
+  min: 0,
+  max: 1,
+  step: 0.01,
+  default: DEFAULT_AMOUNT,
+  description: "Amount"
+};
+var colorMultiplierSchema = {
+  type: "number",
+  min: 0,
+  step: 0.01,
+  default: DEFAULT_AMOUNT,
+  description: "Amount"
+};
+var brightnessAmountSchema = {
+  type: "number",
+  min: -1,
+  max: 1,
+  step: 0.01,
+  default: DEFAULT_BRIGHTNESS_AMOUNT,
+  description: "Amount"
+};
+var hueDegreesSchema = {
+  type: "number",
+  step: 1,
+  default: DEFAULT_HUE_DEGREES,
+  description: "Degrees"
+};
+var assertOptionalFiniteNumber = (value, name) => {
+  if (value === undefined) {
+    return;
+  }
+  assertRequiredFiniteNumber(value, name);
+};
+var validateUnitInterval = (value, name) => {
+  if (value < 0) {
+    throw new TypeError(`"${name}" must be >= 0, but got ${JSON.stringify(value)}`);
+  }
+  if (value > 1) {
+    throw new TypeError(`"${name}" must be <= 1, but got ${JSON.stringify(value)}`);
+  }
+};
+var validateNonNegative = (value, name) => {
+  if (value < 0) {
+    throw new TypeError(`"${name}" must be >= 0, but got ${JSON.stringify(value)}`);
+  }
+};
+var validateSignedUnitInterval = (value, name) => {
+  if (value < -1) {
+    throw new TypeError(`"${name}" must be >= -1, but got ${JSON.stringify(value)}`);
+  }
+  if (value > 1) {
+    throw new TypeError(`"${name}" must be <= 1, but got ${JSON.stringify(value)}`);
+  }
+};
+var clampColorChannel = (value) => {
+  return Math.max(0, Math.min(255, value));
+};
+var parseColorRgba = (ctx, color) => {
+  ctx.clearRect(0, 0, 1, 1);
+  ctx.fillStyle = color;
+  ctx.fillRect(0, 0, 1, 1);
+  const { data } = ctx.getImageData(0, 0, 1, 1);
+  return [data[0], data[1], data[2], data[3]];
+};
+
+// src/shine.ts
+var { createEffect, createWebGL2ContextError } = Internals;
+var DEFAULT_PROGRESS = 0.5;
+var DEFAULT_ANGLE = 30;
+var DEFAULT_HALO_SIGMA = 200;
+var DEFAULT_CORE_SIGMA = 65;
+var DEFAULT_HALO_INTENSITY = 0.3;
+var DEFAULT_CORE_INTENSITY = 0.4;
+var shineSchema = {
+  progress: {
+    type: "number",
+    min: 0,
+    max: 1,
+    step: 0.01,
+    default: DEFAULT_PROGRESS,
+    description: "Progress"
+  },
+  angle: {
+    type: "number",
+    min: -180,
+    max: 180,
+    step: 1,
+    default: DEFAULT_ANGLE,
+    description: "Angle"
+  },
+  haloSigma: {
+    type: "number",
+    min: 1,
+    max: 500,
+    step: 1,
+    default: DEFAULT_HALO_SIGMA,
+    description: "Halo sigma"
+  },
+  coreSigma: {
+    type: "number",
+    min: 1,
+    max: 500,
+    step: 1,
+    default: DEFAULT_CORE_SIGMA,
+    description: "Core sigma"
+  },
+  haloIntensity: {
+    type: "number",
+    min: 0,
+    max: 1,
+    step: 0.01,
+    default: DEFAULT_HALO_INTENSITY,
+    description: "Halo intensity"
+  },
+  coreIntensity: {
+    type: "number",
+    min: 0,
+    max: 1,
+    step: 0.01,
+    default: DEFAULT_CORE_INTENSITY,
+    description: "Core intensity"
+  }
+};
+var resolve = (p) => ({
+  progress: p.progress ?? DEFAULT_PROGRESS,
+  angle: p.angle ?? DEFAULT_ANGLE,
+  haloSigma: p.haloSigma ?? DEFAULT_HALO_SIGMA,
+  coreSigma: p.coreSigma ?? DEFAULT_CORE_SIGMA,
+  haloIntensity: p.haloIntensity ?? DEFAULT_HALO_INTENSITY,
+  coreIntensity: p.coreIntensity ?? DEFAULT_CORE_INTENSITY
+});
+var validatePositive = (value, name) => {
+  if (value <= 0) {
+    throw new TypeError(`"${name}" must be greater than 0, but got ${JSON.stringify(value)}`);
+  }
+};
+var validateShineParams = (params) => {
+  assertEffectParamsObject(params, "Shine");
+  assertOptionalFiniteNumber(params.progress, "progress");
+  assertOptionalFiniteNumber(params.angle, "angle");
+  assertOptionalFiniteNumber(params.haloSigma, "haloSigma");
+  assertOptionalFiniteNumber(params.coreSigma, "coreSigma");
+  assertOptionalFiniteNumber(params.haloIntensity, "haloIntensity");
+  assertOptionalFiniteNumber(params.coreIntensity, "coreIntensity");
+  const r = resolve(params);
+  validateUnitInterval(r.progress, "progress");
+  validatePositive(r.haloSigma, "haloSigma");
+  validatePositive(r.coreSigma, "coreSigma");
+  validateUnitInterval(r.haloIntensity, "haloIntensity");
+  validateUnitInterval(r.coreIntensity, "coreIntensity");
+};
+var SHINE_VS = `#version 300 es
+in vec2 aPos;
+in vec2 aUv;
+out vec2 vUv;
+
+void main() {
+	vUv = aUv;
+	gl_Position = vec4(aPos, 0.0, 1.0);
+}
+`;
+var SHINE_FS = `#version 300 es
+precision highp float;
+
+in vec2 vUv;
+out vec4 fragColor;
+
+uniform sampler2D uSource;
+uniform vec2 uResolution;
+uniform vec2 uBandNormal;
+uniform float uBandT;
+uniform float uHaloSigma;
+uniform float uCoreSigma;
+uniform float uHaloIntensity;
+uniform float uCoreIntensity;
+
+void main() {
+	vec4 source = texture(uSource, vUv);
+	vec2 px = vec2(vUv.x * uResolution.x, (1.0 - vUv.y) * uResolution.y);
+	vec2 center = uResolution * 0.5;
+
+	float dist = dot(px - center, uBandNormal) - uBandT;
+	float halo = exp(-(dist * dist) / (uHaloSigma * uHaloSigma)) * uHaloIntensity;
+	float core = exp(-(dist * dist) / (uCoreSigma * uCoreSigma)) * uCoreIntensity;
+	float intensity = clamp(halo + core, 0.0, 1.0);
+
+	vec3 finalPremult = source.rgb * (1.0 - intensity) + intensity * source.a;
+	fragColor = vec4(finalPremult, source.a);
+}
+`;
+var compileShader = (gl, type, source) => {
+  const shader = gl.createShader(type);
+  if (!shader) {
+    throw new Error("Failed to create WebGL shader");
+  }
+  gl.shaderSource(shader, source);
+  gl.compileShader(shader);
+  if (!gl.getShaderParameter(shader, gl.COMPILE_STATUS)) {
+    const log = gl.getShaderInfoLog(shader);
+    gl.deleteShader(shader);
+    throw new Error(`Shine shader compile failed: ${log ?? "(no log)"}`);
+  }
+  return shader;
+};
+var linkProgram = (gl, vs, fs) => {
+  const program = gl.createProgram();
+  if (!program) {
+    throw new Error("Failed to create WebGL program");
+  }
+  gl.attachShader(program, vs);
+  gl.attachShader(program, fs);
+  gl.linkProgram(program);
+  if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {
+    const log = gl.getProgramInfoLog(program);
+    gl.deleteProgram(program);
+    throw new Error(`Shine program link failed: ${log ?? "(no log)"}`);
+  }
+  return program;
+};
+var shine = createEffect({
+  type: "remotion/shine",
+  label: "shine()",
+  documentationLink: "https://www.remotion.dev/docs/effects/shine",
+  backend: "webgl2",
+  calculateKey: (params) => {
+    const r = resolve(params);
+    return `shine-${r.progress}-${r.angle}-${r.haloSigma}-${r.coreSigma}-${r.haloIntensity}-${r.coreIntensity}`;
+  },
+  setup: (target) => {
+    const gl = target.getContext("webgl2", {
+      premultipliedAlpha: true,
+      alpha: true,
+      preserveDrawingBuffer: true
+    });
+    if (!gl) {
+      throw createWebGL2ContextError("shine effect");
+    }
+    gl.pixelStorei(gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL, true);
+    const vs = compileShader(gl, gl.VERTEX_SHADER, SHINE_VS);
+    const fs = compileShader(gl, gl.FRAGMENT_SHADER, SHINE_FS);
+    const program = linkProgram(gl, vs, fs);
+    gl.deleteShader(vs);
+    gl.deleteShader(fs);
+    const vao = gl.createVertexArray();
+    if (!vao) {
+      throw new Error("Failed to create WebGL vertex array");
+    }
+    gl.bindVertexArray(vao);
+    const data = new Float32Array([
+      -1,
+      -1,
+      0,
+      0,
+      1,
+      -1,
+      1,
+      0,
+      -1,
+      1,
+      0,
+      1,
+      1,
+      1,
+      1,
+      1
+    ]);
+    const vbo = gl.createBuffer();
+    if (!vbo) {
+      throw new Error("Failed to create WebGL buffer");
+    }
+    gl.bindBuffer(gl.ARRAY_BUFFER, vbo);
+    gl.bufferData(gl.ARRAY_BUFFER, data, gl.STATIC_DRAW);
+    const aPos = gl.getAttribLocation(program, "aPos");
+    const aUv = gl.getAttribLocation(program, "aUv");
+    gl.enableVertexAttribArray(aPos);
+    gl.vertexAttribPointer(aPos, 2, gl.FLOAT, false, 16, 0);
+    gl.enableVertexAttribArray(aUv);
+    gl.vertexAttribPointer(aUv, 2, gl.FLOAT, false, 16, 8);
+    gl.bindVertexArray(null);
+    const texture = gl.createTexture();
+    if (!texture) {
+      throw new Error("Failed to create WebGL texture");
+    }
+    gl.bindTexture(gl.TEXTURE_2D, texture);
+    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.LINEAR);
+    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.LINEAR);
+    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, gl.CLAMP_TO_EDGE);
+    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE);
+    gl.bindTexture(gl.TEXTURE_2D, null);
+    return {
+      gl,
+      program,
+      vao,
+      vbo,
+      texture,
+      uSource: gl.getUniformLocation(program, "uSource"),
+      uResolution: gl.getUniformLocation(program, "uResolution"),
+      uBandNormal: gl.getUniformLocation(program, "uBandNormal"),
+      uBandT: gl.getUniformLocation(program, "uBandT"),
+      uHaloSigma: gl.getUniformLocation(program, "uHaloSigma"),
+      uCoreSigma: gl.getUniformLocation(program, "uCoreSigma"),
+      uHaloIntensity: gl.getUniformLocation(program, "uHaloIntensity"),
+      uCoreIntensity: gl.getUniformLocation(program, "uCoreIntensity")
+    };
+  },
+  apply: ({ source, width, height, params, state, flipSourceY }) => {
+    const r = resolve(params);
+    const angleRad = r.angle * Math.PI / 180;
+    const bandNormalX = Math.cos(angleRad);
+    const bandNormalY = -Math.sin(angleRad);
+    const bboxProjection = Math.abs(bandNormalX) * width + Math.abs(bandNormalY) * height;
+    const sweepHalfRange = bboxProjection / 2 + 3 * r.haloSigma;
+    const bandT = -sweepHalfRange + r.progress * sweepHalfRange * 2;
+    const { gl, program, vao, texture } = state;
+    gl.viewport(0, 0, width, height);
+    gl.bindFramebuffer(gl.FRAMEBUFFER, null);
+    gl.clearColor(0, 0, 0, 0);
+    gl.clear(gl.COLOR_BUFFER_BIT);
+    gl.activeTexture(gl.TEXTURE0);
+    gl.bindTexture(gl.TEXTURE_2D, texture);
+    gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, flipSourceY);
+    gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, gl.RGBA, gl.UNSIGNED_BYTE, source);
+    gl.useProgram(program);
+    if (state.uSource)
+      gl.uniform1i(state.uSource, 0);
+    if (state.uResolution)
+      gl.uniform2f(state.uResolution, width, height);
+    if (state.uBandNormal)
+      gl.uniform2f(state.uBandNormal, bandNormalX, bandNormalY);
+    if (state.uBandT)
+      gl.uniform1f(state.uBandT, bandT);
+    if (state.uHaloSigma)
+      gl.uniform1f(state.uHaloSigma, r.haloSigma);
+    if (state.uCoreSigma)
+      gl.uniform1f(state.uCoreSigma, r.coreSigma);
+    if (state.uHaloIntensity)
+      gl.uniform1f(state.uHaloIntensity, r.haloIntensity);
+    if (state.uCoreIntensity)
+      gl.uniform1f(state.uCoreIntensity, r.coreIntensity);
+    gl.bindVertexArray(vao);
+    gl.drawArrays(gl.TRIANGLE_STRIP, 0, 4);
+    gl.bindVertexArray(null);
+    gl.bindTexture(gl.TEXTURE_2D, null);
+    gl.useProgram(null);
+  },
+  cleanup: ({ gl, program, vao, vbo, texture }) => {
+    gl.deleteTexture(texture);
+    gl.deleteBuffer(vbo);
+    gl.deleteProgram(program);
+    gl.deleteVertexArray(vao);
+  },
+  schema: shineSchema,
+  validateParams: validateShineParams
+});
+export {
+  shine
+};

package/dist/esm/tint.mjs

@@ -17,6 +17,12 @@ var assertRequiredColor = (value, name) => {
     throw new TypeError(`"${name}" must be a non-empty string, but got ${JSON.stringify(value)}`);
   }
 };
+var assertOptionalColor = (value, name) => {
+  if (value === undefined) {
+    return;
+  }
+  assertRequiredColor(value, name);
+};
 
 // src/color-utils.ts
 var DEFAULT_AMOUNT = 1;
@@ -81,6 +87,13 @@ var validateSignedUnitInterval = (value, name) => {
 var clampColorChannel = (value) => {
   return Math.max(0, Math.min(255, value));
 };
+var parseColorRgba = (ctx, color) => {
+  ctx.clearRect(0, 0, 1, 1);
+  ctx.fillStyle = color;
+  ctx.fillRect(0, 0, 1, 1);
+  const { data } = ctx.getImageData(0, 0, 1, 1);
+  return [data[0], data[1], data[2], data[3]];
+};
 
 // src/tint.ts
 var { createEffect } = Internals;
@@ -114,7 +127,7 @@ var validateTintParams = (params) => {
 };
 var tint = createEffect({
   type: "remotion/tint",
-  label: "Tint",
+  label: "tint()",
   documentationLink: "https://www.remotion.dev/docs/effects/tint",
   backend: "2d",
   calculateKey: (params) => {

package/dist/esm/translate.mjs

@@ -17,6 +17,12 @@ var assertRequiredColor = (value, name) => {
     throw new TypeError(`"${name}" must be a non-empty string, but got ${JSON.stringify(value)}`);
   }
 };
+var assertOptionalColor = (value, name) => {
+  if (value === undefined) {
+    return;
+  }
+  assertRequiredColor(value, name);
+};
 
 // src/color-utils.ts
 var DEFAULT_AMOUNT = 1;
@@ -81,6 +87,13 @@ var validateSignedUnitInterval = (value, name) => {
 var clampColorChannel = (value) => {
   return Math.max(0, Math.min(255, value));
 };
+var parseColorRgba = (ctx, color) => {
+  ctx.clearRect(0, 0, 1, 1);
+  ctx.fillStyle = color;
+  ctx.fillRect(0, 0, 1, 1);
+  const { data } = ctx.getImageData(0, 0, 1, 1);
+  return [data[0], data[1], data[2], data[3]];
+};
 
 // src/translate/index.ts
 var { createEffect } = Internals;
@@ -147,7 +160,7 @@ var applyTranslate = ({
 };
 var xyTranslate = createEffect({
   type: "remotion/xy-translate",
-  label: "XY Translate",
+  label: "xyTranslate()",
   documentationLink: "https://www.remotion.dev/docs/effects/xy-translate",
   backend: "2d",
   calculateKey: (params) => {
@@ -174,7 +187,7 @@ var xyTranslate = createEffect({
 });
 var uvTranslate = createEffect({
   type: "remotion/uv-translate",
-  label: "UV Translate",
+  label: "uvTranslate()",
   documentationLink: "https://www.remotion.dev/docs/effects/uv-translate",
   backend: "2d",
   calculateKey: (params) => {