@remotion/effects 4.0.477 → 4.0.479

package/dist/burlap.d.ts

@@ -0,0 +1,15 @@
+export type BurlapParams = {
+    /** Strength of the woven texture from `0` to `1`. Defaults to `0.55`. */
+    readonly amount?: number;
+    /** Distance between weave strands in pixels. Defaults to `5`. */
+    readonly size?: number;
+    /** Irregularity of the fibers from `0` to `1`. Defaults to `0.7`. */
+    readonly roughness?: number;
+    /** Seed for the procedural fiber pattern. Defaults to `0`. */
+    readonly seed?: number;
+    /** Color of the darker weave fibers. Defaults to black. */
+    readonly color?: string;
+};
+export declare const burlap: (params?: (BurlapParams & {
+    readonly disabled?: boolean | undefined;
+}) | undefined) => import("remotion").EffectDescriptor<unknown>;

package/dist/contour-lines.d.ts

@@ -0,0 +1,114 @@
+export declare const contourLinesSchema: {
+    readonly lineColor: {
+        readonly type: "color";
+        readonly default: "#ffffff";
+        readonly description: "Line color";
+    };
+    readonly lineWidth: {
+        readonly type: "number";
+        readonly min: 0.1;
+        readonly max: 20;
+        readonly step: 0.1;
+        readonly default: 1.5;
+        readonly description: "Line width";
+        readonly hiddenFromList: false;
+    };
+    readonly spacing: {
+        readonly type: "number";
+        readonly min: 1;
+        readonly max: 200;
+        readonly step: 1;
+        readonly default: 36;
+        readonly description: "Spacing";
+        readonly hiddenFromList: false;
+    };
+    readonly scale: {
+        readonly type: "number";
+        readonly min: 20;
+        readonly max: 1000;
+        readonly step: 1;
+        readonly default: 220;
+        readonly description: "Scale";
+        readonly hiddenFromList: false;
+    };
+    readonly complexity: {
+        readonly type: "number";
+        readonly min: 0;
+        readonly max: 1;
+        readonly step: 0.01;
+        readonly default: 0.65;
+        readonly description: "Complexity";
+        readonly hiddenFromList: false;
+    };
+    readonly smoothness: {
+        readonly type: "number";
+        readonly min: 0;
+        readonly max: 1;
+        readonly step: 0.01;
+        readonly default: 0.55;
+        readonly description: "Smoothness";
+        readonly hiddenFromList: false;
+    };
+    readonly seed: {
+        readonly type: "number";
+        readonly step: 1;
+        readonly default: 0;
+        readonly description: "Seed";
+        readonly hiddenFromList: false;
+    };
+    readonly offsetX: {
+        readonly type: "number";
+        readonly step: 0.1;
+        readonly default: 0;
+        readonly description: "Offset X";
+        readonly hiddenFromList: false;
+    };
+    readonly offsetY: {
+        readonly type: "number";
+        readonly step: 0.1;
+        readonly default: 0;
+        readonly description: "Offset Y";
+        readonly hiddenFromList: false;
+    };
+    readonly opacity: {
+        readonly type: "number";
+        readonly min: 0;
+        readonly max: 1;
+        readonly step: 0.01;
+        readonly default: 1;
+        readonly description: "Opacity";
+        readonly hiddenFromList: false;
+    };
+    readonly maskToSourceAlpha: {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly description: "Mask to source alpha";
+    };
+};
+export type ContourLinesParams = {
+    /** Color of the contour lines. Defaults to `#ffffff`. */
+    readonly lineColor?: string;
+    /** Width of each contour line in pixels. Defaults to `1.5`. */
+    readonly lineWidth?: number;
+    /** Distance between contour height levels in pixels. Defaults to `36`. */
+    readonly spacing?: number;
+    /** Size of the generated terrain features in pixels. Defaults to `220`. */
+    readonly scale?: number;
+    /** Amount of terrain detail from `0` to `1`. Defaults to `0.65`. */
+    readonly complexity?: number;
+    /** Smooths the contour curves from `0` to `1`. Defaults to `0.55`. */
+    readonly smoothness?: number;
+    /** Deterministic seed for the contour field. Defaults to `0`. */
+    readonly seed?: number;
+    /** Horizontal offset in pixels. Defaults to `0`. */
+    readonly offsetX?: number;
+    /** Vertical offset in pixels. Defaults to `0`. */
+    readonly offsetY?: number;
+    /** Multiplies the alpha channel of `lineColor`. Defaults to `1`. */
+    readonly opacity?: number;
+    /** Masks the generated contour lines to the source alpha channel. Defaults to `false`. */
+    readonly maskToSourceAlpha?: boolean;
+};
+export declare const contourLines: (params?: (ContourLinesParams & {
+    readonly disabled?: boolean | undefined;
+}) | undefined) => import("remotion").EffectDescriptor<unknown>;

package/dist/esm/barrel-distortion.mjs

@@ -325,7 +325,7 @@ var validateBarrelDistortionParams = (params) => {
   validateUnitInterval(resolved.amount, "amount");
 };
 var barrelDistortion = createEffect({
-  type: "remotion/barrel-distortion",
+  type: "dev.remotion.effects.barrelDistortion",
   label: "barrelDistortion()",
   documentationLink: "https://www.remotion.dev/docs/effects/barrel-distortion",
   backend: "webgl2",

package/dist/esm/blur.mjs

@@ -418,7 +418,7 @@ var validateBlurParams = (params) => {
   assertRequiredFiniteNumber(params.radius, "radius");
 };
 var blur = createEffect({
-  type: "remotion/blur",
+  type: "dev.remotion.effects.blur",
   label: "blur()",
   documentationLink: "https://www.remotion.dev/docs/effects/blur",
   backend: "webgl2",

package/dist/esm/brightness.mjs

@@ -121,7 +121,7 @@ var validateBrightnessParams = (params) => {
   validateSignedUnitInterval(amount, "amount");
 };
 var brightness = createEffect({
-  type: "remotion/brightness",
+  type: "dev.remotion.effects.brightness",
   label: "brightness()",
   documentationLink: "https://www.remotion.dev/docs/effects/brightness",
   backend: "2d",

package/dist/esm/burlap.mjs

@@ -0,0 +1,454 @@
+// src/burlap.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);
+};
+var assertOptionalBoolean = (value, name) => {
+  if (value === undefined) {
+    return;
+  }
+  if (typeof value !== "boolean") {
+    throw new TypeError(`"${name}" must be a boolean, but got ${JSON.stringify(value)}`);
+  }
+};
+
+// 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",
+  hiddenFromList: false
+};
+var colorMultiplierSchema = {
+  type: "number",
+  min: 0,
+  step: 0.01,
+  default: DEFAULT_AMOUNT,
+  description: "Amount",
+  hiddenFromList: false
+};
+var brightnessAmountSchema = {
+  type: "number",
+  min: -1,
+  max: 1,
+  step: 0.01,
+  default: DEFAULT_BRIGHTNESS_AMOUNT,
+  description: "Amount",
+  hiddenFromList: false
+};
+var hueDegreesSchema = {
+  type: "rotation-degrees",
+  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/burlap.ts
+var { createEffect, createWebGL2ContextError } = Internals;
+var DEFAULT_AMOUNT2 = 0.55;
+var DEFAULT_SIZE = 5;
+var DEFAULT_ROUGHNESS = 0.7;
+var DEFAULT_SEED = 0;
+var DEFAULT_COLOR = "#000000";
+var burlapSchema = {
+  amount: {
+    type: "number",
+    min: 0,
+    max: 1,
+    step: 0.01,
+    default: DEFAULT_AMOUNT2,
+    description: "Amount",
+    hiddenFromList: false
+  },
+  size: {
+    type: "number",
+    min: 0.1,
+    max: 80,
+    step: 0.1,
+    default: DEFAULT_SIZE,
+    description: "Size",
+    hiddenFromList: false
+  },
+  roughness: {
+    type: "number",
+    min: 0,
+    max: 1,
+    step: 0.01,
+    default: DEFAULT_ROUGHNESS,
+    description: "Roughness",
+    hiddenFromList: false
+  },
+  seed: {
+    type: "number",
+    step: 1,
+    default: DEFAULT_SEED,
+    description: "Seed",
+    hiddenFromList: false
+  },
+  color: {
+    type: "color",
+    default: DEFAULT_COLOR,
+    description: "Color"
+  }
+};
+var resolve = (p) => ({
+  amount: p.amount ?? DEFAULT_AMOUNT2,
+  size: p.size ?? DEFAULT_SIZE,
+  roughness: p.roughness ?? DEFAULT_ROUGHNESS,
+  seed: p.seed ?? DEFAULT_SEED,
+  color: p.color ?? DEFAULT_COLOR
+});
+var validatePositive = (value, name) => {
+  if (value <= 0) {
+    throw new TypeError(`"${name}" must be greater than 0, but got ${JSON.stringify(value)}`);
+  }
+};
+var validateBurlapParams = (params) => {
+  assertEffectParamsObject(params, "Burlap");
+  assertOptionalFiniteNumber(params.amount, "amount");
+  assertOptionalFiniteNumber(params.size, "size");
+  assertOptionalFiniteNumber(params.roughness, "roughness");
+  assertOptionalFiniteNumber(params.seed, "seed");
+  assertOptionalColor(params.color, "color");
+  const r = resolve(params);
+  validateUnitInterval(r.amount, "amount");
+  validatePositive(r.size, "size");
+  validateUnitInterval(r.roughness, "roughness");
+};
+var BURLAP_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 BURLAP_FS = `#version 300 es
+precision highp float;
+
+in vec2 vUv;
+out vec4 fragColor;
+
+uniform sampler2D uSource;
+uniform vec2 uResolution;
+uniform float uAmount;
+uniform float uSize;
+uniform float uRoughness;
+uniform float uSeed;
+uniform vec4 uColor;
+
+float hash21(vec2 p) {
+	vec3 p3 = fract(vec3(p.xyx) * vec3(443.8975, 397.2973, 491.1871));
+	p3 += dot(p3, p3.yzx + 19.19 + uSeed * 0.137);
+	return fract((p3.x + p3.y) * p3.z);
+}
+
+float valueNoise(vec2 p) {
+	vec2 i = floor(p);
+	vec2 f = fract(p);
+	f = f * f * (3.0 - 2.0 * f);
+
+	float a = hash21(i);
+	float b = hash21(i + vec2(1.0, 0.0));
+	float c = hash21(i + vec2(0.0, 1.0));
+	float d = hash21(i + vec2(1.0, 1.0));
+
+	return mix(mix(a, b, f.x), mix(c, d, f.x), f.y);
+}
+
+float strand(float value) {
+	float centered = abs(fract(value) - 0.5);
+	return 1.0 - smoothstep(0.2, 0.5, centered);
+}
+
+void main() {
+	vec4 texColor = texture(uSource, vUv);
+	float alpha = texColor.a;
+
+	if (alpha <= 0.001) {
+		fragColor = vec4(0.0);
+		return;
+	}
+
+	if (uAmount <= 0.0) {
+		fragColor = texColor;
+		return;
+	}
+
+	vec2 fragPos = vUv * uResolution;
+	float strandSize = max(uSize, 0.001);
+	vec2 weave = fragPos / strandSize;
+
+	float rowJitter = (hash21(vec2(floor(weave.y), 13.17)) - 0.5) * uRoughness * 0.28;
+	float columnJitter = (hash21(vec2(71.43, floor(weave.x))) - 0.5) * uRoughness * 0.28;
+	float vertical = strand(weave.x + rowJitter);
+	float horizontal = strand(weave.y + columnJitter);
+
+	float cellParity = mod(floor(weave.x) + floor(weave.y), 2.0);
+	float overUnder = mix(vertical, horizontal, cellParity);
+	float ridge = max(max(vertical, horizontal) * 0.45, overUnder * 0.75);
+	float gaps = (1.0 - vertical) * (1.0 - horizontal);
+
+	float coarse = valueNoise(fragPos / (strandSize * 7.0) + vec2(uSeed * 1.7, uSeed * 0.6));
+	float fine = valueNoise(fragPos / max(strandSize * 0.55, 0.5) + vec2(uSeed * 3.1, 4.7));
+	float dashH = smoothstep(0.64, 0.98, hash21(floor(vec2(weave.x * 2.0, weave.y)) + 23.9)) * horizontal;
+	float dashV = smoothstep(0.64, 0.98, hash21(floor(vec2(weave.x, weave.y * 2.0)) + 91.4)) * vertical;
+
+	float texture = 0.0;
+	texture += (ridge - 0.42) * 0.22;
+	texture -= gaps * 0.18;
+	texture += (coarse - 0.5) * 0.18 * uRoughness;
+	texture += (fine - 0.5) * 0.16 * uRoughness;
+	texture -= (dashH + dashV) * 0.08 * uRoughness;
+
+	vec3 rgb = texColor.rgb / alpha;
+	float darkFiber = clamp(-texture * 3.2 + gaps * 0.12 + (dashH + dashV) * 0.18, 0.0, 1.0);
+	vec3 shaded = mix(rgb, uColor.rgb, darkFiber * uColor.a);
+	vec3 textured = clamp(shaded * (1.0 + max(texture, 0.0) * 0.45), 0.0, 1.0);
+	rgb = mix(rgb, textured, uAmount);
+
+	fragColor = vec4(rgb * alpha, alpha);
+}
+`;
+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(`Burlap 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(`Burlap program link failed: ${log ?? "(no log)"}`);
+  }
+  return program;
+};
+var setupBurlap = (target) => {
+  const gl = target.getContext("webgl2", {
+    premultipliedAlpha: true,
+    alpha: true,
+    preserveDrawingBuffer: true
+  });
+  if (!gl) {
+    throw createWebGL2ContextError("burlap effect");
+  }
+  gl.pixelStorei(gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL, true);
+  const vs = compileShader(gl, gl.VERTEX_SHADER, BURLAP_VS);
+  const fs = compileShader(gl, gl.FRAGMENT_SHADER, BURLAP_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);
+  const colorCanvas = document.createElement("canvas");
+  colorCanvas.width = 1;
+  colorCanvas.height = 1;
+  const colorCtx = colorCanvas.getContext("2d", { willReadFrequently: true });
+  if (!colorCtx) {
+    throw new Error("Failed to acquire 2D context for color parsing");
+  }
+  return {
+    gl,
+    program,
+    vao,
+    vbo,
+    texture,
+    uSource: gl.getUniformLocation(program, "uSource"),
+    uResolution: gl.getUniformLocation(program, "uResolution"),
+    uAmount: gl.getUniformLocation(program, "uAmount"),
+    uSize: gl.getUniformLocation(program, "uSize"),
+    uRoughness: gl.getUniformLocation(program, "uRoughness"),
+    uSeed: gl.getUniformLocation(program, "uSeed"),
+    uColor: gl.getUniformLocation(program, "uColor"),
+    colorCtx,
+    cachedColor: "",
+    cachedColorRgba: [0, 0, 0, 255]
+  };
+};
+var normalizedRgba = (color) => {
+  return [color[0] / 255, color[1] / 255, color[2] / 255, color[3] / 255];
+};
+var burlap = createEffect({
+  type: "dev.remotion.effects.burlap",
+  label: "burlap()",
+  documentationLink: "https://www.remotion.dev/docs/effects/burlap",
+  backend: "webgl2",
+  calculateKey: (params) => {
+    const r = resolve(params);
+    return `burlap-${r.amount}-${r.size}-${r.roughness}-${r.seed}-${r.color}`;
+  },
+  setup: (target) => setupBurlap(target),
+  apply: ({ source, width, height, params, state, flipSourceY }) => {
+    const r = resolve(params);
+    const { gl, program, vao, texture } = state;
+    if (state.cachedColor !== r.color) {
+      state.cachedColor = r.color;
+      state.cachedColorRgba = parseColorRgba(state.colorCtx, r.color);
+    }
+    const [red, green, blue, alpha] = normalizedRgba(state.cachedColorRgba);
+    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.uAmount)
+      gl.uniform1f(state.uAmount, r.amount);
+    if (state.uSize)
+      gl.uniform1f(state.uSize, r.size);
+    if (state.uRoughness)
+      gl.uniform1f(state.uRoughness, r.roughness);
+    if (state.uSeed)
+      gl.uniform1f(state.uSeed, r.seed);
+    if (state.uColor)
+      gl.uniform4f(state.uColor, red, green, blue, alpha);
+    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: burlapSchema,
+  validateParams: validateBurlapParams
+});
+export {
+  burlap
+};

package/dist/esm/chromatic-aberration.mjs

@@ -325,7 +325,7 @@ var validateChromaticAberrationParams = (params) => {
   validateNonNegative(resolved.amount, "amount");
 };
 var chromaticAberration = createEffect({
-  type: "remotion/chromatic-aberration",
+  type: "dev.remotion.effects.chromaticAberration",
   label: "chromaticAberration()",
   documentationLink: "https://www.remotion.dev/docs/effects/chromatic-aberration",
   backend: "webgl2",

package/dist/esm/color-key.mjs

@@ -374,7 +374,7 @@ var parseKeyColor = (state, color) => {
   ];
 };
 var colorKey = createEffect({
-  type: "remotion/color-key",
+  type: "dev.remotion.effects.colorKey",
   label: "colorKey()",
   documentationLink: "https://www.remotion.dev/docs/effects/color-key",
   backend: "webgl2",