@remotion/effects 4.0.467 → 4.0.469

package/dist/esm/speckle.mjs

@@ -0,0 +1,360 @@
+// src/speckle.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/speckle.ts
+var { createEffect, createWebGL2ContextError } = Internals;
+var DEFAULT_DENSITY = 0.08;
+var DEFAULT_SIZE = 4;
+var DEFAULT_RANDOMNESS = 1;
+var speckleSchema = {
+  density: {
+    type: "number",
+    min: 0,
+    max: 1,
+    step: 0.01,
+    default: DEFAULT_DENSITY,
+    description: "Density"
+  },
+  size: {
+    type: "number",
+    min: 0,
+    max: 50,
+    step: 0.1,
+    default: DEFAULT_SIZE,
+    description: "Size"
+  },
+  randomness: {
+    type: "number",
+    min: 0,
+    max: 1,
+    step: 0.01,
+    default: DEFAULT_RANDOMNESS,
+    description: "Randomness"
+  }
+};
+var resolve = (p) => ({
+  density: p.density ?? DEFAULT_DENSITY,
+  size: p.size ?? DEFAULT_SIZE,
+  randomness: p.randomness ?? DEFAULT_RANDOMNESS
+});
+var validateSpeckleParams = (params) => {
+  assertEffectParamsObject(params, "Speckle");
+  assertOptionalFiniteNumber(params.density, "density");
+  assertOptionalFiniteNumber(params.size, "size");
+  assertOptionalFiniteNumber(params.randomness, "randomness");
+  const r = resolve(params);
+  validateUnitInterval(r.density, "density");
+  validateNonNegative(r.size, "size");
+  validateUnitInterval(r.randomness, "randomness");
+};
+var SPECKLE_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 SPECKLE_FS = `#version 300 es
+precision highp float;
+
+in vec2 vUv;
+out vec4 fragColor;
+
+uniform sampler2D uSource;
+uniform vec2 uResolution;
+uniform float uDensity;
+uniform float uSize;
+uniform float uRandomness;
+
+float hash21(vec2 p) {
+	vec3 p3 = fract(vec3(p.xyx) * vec3(443.8975, 397.2973, 491.1871));
+	p3 += dot(p3, p3.yzx + 19.19);
+	return fract((p3.x + p3.y) * p3.z);
+}
+
+vec2 hash22(vec2 p) {
+	return vec2(hash21(p + 17.13), hash21(p + 83.71));
+}
+
+void main() {
+	vec4 color = texture(uSource, vUv);
+
+	if (uDensity <= 0.0 || uSize <= 0.0) {
+		fragColor = color;
+		return;
+	}
+
+	vec2 fragPos = vUv * uResolution;
+	float cellSize = max(uSize * 2.5, 1.0);
+	vec2 baseCell = floor(fragPos / cellSize);
+	float hole = 0.0;
+
+	for (int y = -1; y <= 1; y++) {
+		for (int x = -1; x <= 1; x++) {
+			vec2 cell = baseCell + vec2(float(x), float(y));
+			float chance = hash21(cell);
+
+			if (chance <= uDensity) {
+				vec2 randomOffset = (hash22(cell + 11.7) - 0.5) * uRandomness;
+				vec2 center = (cell + 0.5 + randomOffset) * cellSize;
+				float sizeVariation = mix(1.0, 0.35 + hash21(cell + 29.43) * 0.65, uRandomness);
+				float radius = uSize * 0.5 * sizeVariation;
+				float edge = min(1.0, max(radius * 0.5, 0.35));
+				float coverage = 1.0 - smoothstep(radius - edge, radius + edge, length(fragPos - center));
+				hole = max(hole, coverage);
+			}
+		}
+	}
+
+	fragColor = color * (1.0 - clamp(hole, 0.0, 1.0));
+}
+`;
+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(`Speckle 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(`Speckle program link failed: ${log ?? "(no log)"}`);
+  }
+  return program;
+};
+var speckle = createEffect({
+  type: "remotion/speckle",
+  label: "speckle()",
+  documentationLink: "https://www.remotion.dev/docs/effects/speckle",
+  backend: "webgl2",
+  calculateKey: (params) => {
+    const r = resolve(params);
+    return `speckle-${r.density}-${r.size}-${r.randomness}`;
+  },
+  setup: (target) => {
+    const gl = target.getContext("webgl2", {
+      premultipliedAlpha: true,
+      alpha: true,
+      preserveDrawingBuffer: true
+    });
+    if (!gl) {
+      throw createWebGL2ContextError("speckle effect");
+    }
+    gl.pixelStorei(gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL, true);
+    const vs = compileShader(gl, gl.VERTEX_SHADER, SPECKLE_VS);
+    const fs = compileShader(gl, gl.FRAGMENT_SHADER, SPECKLE_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_WRAP_S, gl.CLAMP_TO_EDGE);
+    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE);
+    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.LINEAR);
+    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.LINEAR);
+    gl.bindTexture(gl.TEXTURE_2D, null);
+    return {
+      gl,
+      program,
+      vao,
+      vbo,
+      texture,
+      uSource: gl.getUniformLocation(program, "uSource"),
+      uResolution: gl.getUniformLocation(program, "uResolution"),
+      uDensity: gl.getUniformLocation(program, "uDensity"),
+      uSize: gl.getUniformLocation(program, "uSize"),
+      uRandomness: gl.getUniformLocation(program, "uRandomness")
+    };
+  },
+  apply: ({ source, width, height, params, state, flipSourceY }) => {
+    const r = resolve(params);
+    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.useProgram(program);
+    gl.bindVertexArray(vao);
+    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);
+    if (state.uSource)
+      gl.uniform1i(state.uSource, 0);
+    if (state.uResolution)
+      gl.uniform2f(state.uResolution, width, height);
+    if (state.uDensity)
+      gl.uniform1f(state.uDensity, r.density);
+    if (state.uSize)
+      gl.uniform1f(state.uSize, r.size);
+    if (state.uRandomness)
+      gl.uniform1f(state.uRandomness, r.randomness);
+    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.deleteBuffer(vbo);
+    gl.deleteProgram(program);
+    gl.deleteVertexArray(vao);
+    gl.deleteTexture(texture);
+  },
+  schema: speckleSchema,
+  validateParams: validateSpeckleParams
+});
+export {
+  speckle
+};

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) => {