@remotion/effects 4.0.481 → 4.0.483

package/dist/esm/radial-progressive-blur.mjs

@@ -0,0 +1,604 @@
+// src/radial-progressive-blur/index.ts
+import { Internals as Internals2 } 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/radial-progressive-blur/radial-progressive-blur-runtime.ts
+import { Internals } from "remotion";
+
+// src/radial-progressive-blur/radial-progressive-blur-shaders.ts
+var RADIAL_PROGRESSIVE_BLUR_VS = `#version 300 es
+layout(location = 0) in vec2 aPos;
+layout(location = 1) in vec2 aUv;
+out vec2 vUv;
+void main() {
+	vUv = aUv;
+	gl_Position = vec4(aPos, 0.0, 1.0);
+}
+`;
+var buildRadialProgressiveBlurFs = (direction) => {
+  const dirVec = direction === "horizontal" ? "vec2(1.0, 0.0)" : "vec2(0.0, 1.0)";
+  return `#version 300 es
+precision highp float;
+
+in vec2 vUv;
+out vec4 fragColor;
+
+uniform sampler2D uSource;
+uniform vec2 uTexelSize;
+uniform vec2 uCenter;
+uniform float uWidth;
+uniform float uHeight;
+uniform float uRotation;
+uniform float uStart;
+uniform float uStartBlur;
+uniform float uEndBlur;
+
+const int MIN_KERNEL_HALF = 4;
+const int MAX_KERNEL_HALF = 32;
+const float TARGET_SAMPLE_DISTANCE_PX = 2.0;
+const vec2 DIRECTION = ${dirVec};
+
+float progressiveRadius(vec2 uv) {
+	vec2 radii = vec2(uWidth / uTexelSize.x, uHeight / uTexelSize.y) * 0.5;
+
+	if (radii.x <= 0.0000001 || radii.y <= 0.0000001) {
+		return max(0.0, uStartBlur);
+	}
+
+	vec2 delta = (uv - uCenter) / uTexelSize;
+	float angle = radians(uRotation);
+	float c = cos(angle);
+	float s = sin(angle);
+	vec2 local = vec2(
+		c * delta.x + s * delta.y,
+		-s * delta.x + c * delta.y
+	);
+	float ellipseProgress = clamp(length(local / radii), 0.0, 1.0);
+	float distance = 1.0 - uStart;
+	float progress = abs(distance) <= 0.0000001
+		? step(uStart, ellipseProgress)
+		: clamp((ellipseProgress - uStart) / distance, 0.0, 1.0);
+	return max(0.0, mix(uStartBlur, uEndBlur, progress));
+}
+
+void main() {
+	// Public UV coordinates use top-left origin, matching canvas/CSS coordinates.
+	float radius = progressiveRadius(vec2(vUv.x, 1.0 - vUv.y));
+	if (radius <= 0.0) {
+		fragColor = texture(uSource, vUv);
+		return;
+	}
+
+	int kernelHalf = int(
+		min(
+			float(MAX_KERNEL_HALF),
+			max(float(MIN_KERNEL_HALF), ceil(radius / TARGET_SAMPLE_DISTANCE_PX))
+		)
+	);
+	float pixelStride = radius / float(kernelHalf);
+	float sigma = max(radius / 3.0, 0.0001);
+	float twoSigmaSq = 2.0 * sigma * sigma;
+
+	vec4 sum = vec4(0.0);
+	float weightSum = 0.0;
+
+	for (int i = -MAX_KERNEL_HALF; i <= MAX_KERNEL_HALF; ++i) {
+		if (abs(i) > kernelHalf) {
+			continue;
+		}
+
+		float offsetPx = float(i) * pixelStride;
+		float w = exp(-(offsetPx * offsetPx) / twoSigmaSq);
+		vec2 uv = vUv + DIRECTION * uTexelSize * offsetPx;
+		sum += texture(uSource, uv) * w;
+		weightSum += w;
+	}
+
+	fragColor = sum / weightSum;
+}
+`;
+};
+
+// src/radial-progressive-blur/radial-progressive-blur-runtime.ts
+var { createWebGL2ContextError } = Internals;
+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(`Radial progressive blur 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(`Radial progressive blur program link failed: ${log ?? "(no log)"}`);
+  }
+  return program;
+};
+var createProgram = (gl, vertexSource, fragmentSource) => {
+  const vs = compileShader(gl, gl.VERTEX_SHADER, vertexSource);
+  const fs = compileShader(gl, gl.FRAGMENT_SHADER, fragmentSource);
+  const program = linkProgram(gl, vs, fs);
+  gl.deleteShader(vs);
+  gl.deleteShader(fs);
+  return program;
+};
+var getUniforms = (gl, program) => ({
+  uSource: gl.getUniformLocation(program, "uSource"),
+  uTexelSize: gl.getUniformLocation(program, "uTexelSize"),
+  uCenter: gl.getUniformLocation(program, "uCenter"),
+  uWidth: gl.getUniformLocation(program, "uWidth"),
+  uHeight: gl.getUniformLocation(program, "uHeight"),
+  uRotation: gl.getUniformLocation(program, "uRotation"),
+  uStart: gl.getUniformLocation(program, "uStart"),
+  uStartBlur: gl.getUniformLocation(program, "uStartBlur"),
+  uEndBlur: gl.getUniformLocation(program, "uEndBlur")
+});
+var createRgbaTexture = (gl) => {
+  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 texture;
+};
+var setupRadialProgressiveBlur = (target) => {
+  const gl = target.getContext("webgl2", {
+    premultipliedAlpha: true,
+    alpha: true,
+    preserveDrawingBuffer: true
+  });
+  if (!gl) {
+    throw createWebGL2ContextError("radial progressive blur effect");
+  }
+  gl.pixelStorei(gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL, true);
+  const programHorizontal = createProgram(gl, RADIAL_PROGRESSIVE_BLUR_VS, buildRadialProgressiveBlurFs("horizontal"));
+  const programVertical = createProgram(gl, RADIAL_PROGRESSIVE_BLUR_VS, buildRadialProgressiveBlurFs("vertical"));
+  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);
+  gl.enableVertexAttribArray(0);
+  gl.vertexAttribPointer(0, 2, gl.FLOAT, false, 16, 0);
+  gl.enableVertexAttribArray(1);
+  gl.vertexAttribPointer(1, 2, gl.FLOAT, false, 16, 8);
+  gl.bindVertexArray(null);
+  const textureSource = createRgbaTexture(gl);
+  const textureIntermediate = createRgbaTexture(gl);
+  const framebuffer = gl.createFramebuffer();
+  if (!framebuffer) {
+    throw new Error("Failed to create WebGL framebuffer");
+  }
+  const w = Math.max(1, target.width);
+  const h = Math.max(1, target.height);
+  gl.bindTexture(gl.TEXTURE_2D, textureIntermediate);
+  gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, w, h, 0, gl.RGBA, gl.UNSIGNED_BYTE, null);
+  gl.bindTexture(gl.TEXTURE_2D, null);
+  gl.bindFramebuffer(gl.FRAMEBUFFER, framebuffer);
+  gl.framebufferTexture2D(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0, gl.TEXTURE_2D, textureIntermediate, 0);
+  const status = gl.checkFramebufferStatus(gl.FRAMEBUFFER);
+  gl.bindFramebuffer(gl.FRAMEBUFFER, null);
+  if (status !== gl.FRAMEBUFFER_COMPLETE) {
+    throw new Error(`Radial progressive blur framebuffer incomplete: 0x${status.toString(16)}`);
+  }
+  return {
+    gl,
+    programHorizontal,
+    programVertical,
+    vao,
+    vbo,
+    textureSource,
+    textureIntermediate,
+    framebuffer,
+    horizontal: getUniforms(gl, programHorizontal),
+    vertical: getUniforms(gl, programVertical)
+  };
+};
+var cleanupRadialProgressiveBlur = (state) => {
+  const {
+    gl,
+    programHorizontal,
+    programVertical,
+    vao,
+    vbo,
+    textureSource,
+    textureIntermediate,
+    framebuffer
+  } = state;
+  gl.deleteFramebuffer(framebuffer);
+  gl.deleteTexture(textureSource);
+  gl.deleteTexture(textureIntermediate);
+  gl.deleteBuffer(vbo);
+  gl.deleteProgram(programHorizontal);
+  gl.deleteProgram(programVertical);
+  gl.deleteVertexArray(vao);
+};
+var uploadSource = ({
+  gl,
+  textureSource,
+  textureIntermediate,
+  source,
+  width,
+  height,
+  flipSourceY
+}) => {
+  gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, flipSourceY);
+  gl.bindTexture(gl.TEXTURE_2D, textureSource);
+  gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, gl.RGBA, gl.UNSIGNED_BYTE, source);
+  gl.bindTexture(gl.TEXTURE_2D, textureIntermediate);
+  gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, width, height, 0, gl.RGBA, gl.UNSIGNED_BYTE, null);
+  gl.bindTexture(gl.TEXTURE_2D, null);
+};
+var setUniforms = ({
+  gl,
+  uniforms,
+  width,
+  height,
+  params
+}) => {
+  if (uniforms.uSource)
+    gl.uniform1i(uniforms.uSource, 0);
+  if (uniforms.uTexelSize)
+    gl.uniform2f(uniforms.uTexelSize, 1 / width, 1 / height);
+  if (uniforms.uCenter)
+    gl.uniform2f(uniforms.uCenter, params.center[0], params.center[1]);
+  if (uniforms.uWidth)
+    gl.uniform1f(uniforms.uWidth, params.width);
+  if (uniforms.uHeight)
+    gl.uniform1f(uniforms.uHeight, params.height);
+  if (uniforms.uRotation)
+    gl.uniform1f(uniforms.uRotation, params.rotation);
+  if (uniforms.uStart)
+    gl.uniform1f(uniforms.uStart, params.start);
+  if (uniforms.uStartBlur)
+    gl.uniform1f(uniforms.uStartBlur, params.startBlur);
+  if (uniforms.uEndBlur)
+    gl.uniform1f(uniforms.uEndBlur, params.endBlur);
+};
+var drawFullscreenQuad = (state) => {
+  const { gl, vao } = state;
+  gl.bindVertexArray(vao);
+  gl.drawArrays(gl.TRIANGLE_STRIP, 0, 4);
+  gl.bindVertexArray(null);
+};
+var applyRadialProgressiveBlur = ({
+  state,
+  source,
+  width,
+  height,
+  params,
+  flipSourceY
+}) => {
+  const {
+    gl,
+    programHorizontal,
+    programVertical,
+    textureSource,
+    textureIntermediate,
+    framebuffer
+  } = state;
+  gl.viewport(0, 0, width, height);
+  uploadSource({
+    gl,
+    textureSource,
+    textureIntermediate,
+    source,
+    width,
+    height,
+    flipSourceY
+  });
+  gl.clearColor(0, 0, 0, 0);
+  gl.bindFramebuffer(gl.FRAMEBUFFER, framebuffer);
+  gl.clear(gl.COLOR_BUFFER_BIT);
+  gl.activeTexture(gl.TEXTURE0);
+  gl.bindTexture(gl.TEXTURE_2D, textureSource);
+  gl.useProgram(programHorizontal);
+  setUniforms({
+    gl,
+    uniforms: state.horizontal,
+    width,
+    height,
+    params
+  });
+  drawFullscreenQuad(state);
+  gl.bindFramebuffer(gl.FRAMEBUFFER, null);
+  gl.clear(gl.COLOR_BUFFER_BIT);
+  gl.bindTexture(gl.TEXTURE_2D, textureIntermediate);
+  gl.useProgram(programVertical);
+  setUniforms({
+    gl,
+    uniforms: state.vertical,
+    width,
+    height,
+    params
+  });
+  drawFullscreenQuad(state);
+  gl.bindTexture(gl.TEXTURE_2D, null);
+  gl.useProgram(null);
+};
+
+// src/radial-progressive-blur/index.ts
+var { createEffect } = Internals2;
+var DEFAULT_CENTER = [0.5, 0.5];
+var DEFAULT_WIDTH = 1;
+var DEFAULT_HEIGHT = 1;
+var DEFAULT_ROTATION = 0;
+var DEFAULT_START = 0;
+var DEFAULT_START_BLUR = 0;
+var DEFAULT_END_BLUR = 50;
+var radialProgressiveBlurSchema = {
+  center: {
+    type: "uv-coordinate",
+    min: -1,
+    max: 2,
+    step: 0.01,
+    default: DEFAULT_CENTER,
+    description: "Center",
+    visual: {
+      type: "ellipse",
+      width: "width",
+      height: "height",
+      rotation: "rotation",
+      innerScale: "start"
+    }
+  },
+  width: {
+    type: "number",
+    min: 0,
+    step: 0.01,
+    default: DEFAULT_WIDTH,
+    description: "Width",
+    hiddenFromList: false
+  },
+  height: {
+    type: "number",
+    min: 0,
+    step: 0.01,
+    default: DEFAULT_HEIGHT,
+    description: "Height",
+    hiddenFromList: false
+  },
+  rotation: {
+    type: "rotation-degrees",
+    step: 1,
+    default: DEFAULT_ROTATION,
+    description: "Rotation"
+  },
+  start: {
+    type: "number",
+    min: 0,
+    max: 1,
+    step: 0.01,
+    default: DEFAULT_START,
+    description: "Start",
+    hiddenFromList: false
+  },
+  startBlur: {
+    type: "number",
+    min: 0,
+    max: 200,
+    step: 1,
+    default: DEFAULT_START_BLUR,
+    description: "Start blur",
+    hiddenFromList: false
+  },
+  endBlur: {
+    type: "number",
+    min: 0,
+    max: 200,
+    step: 1,
+    default: DEFAULT_END_BLUR,
+    description: "End blur",
+    hiddenFromList: false
+  }
+};
+var clampBlur = (value) => Math.max(0, value);
+var resolveRadialProgressiveBlurParams = (params) => ({
+  center: [
+    ...params.center ?? DEFAULT_CENTER
+  ],
+  width: params.width ?? DEFAULT_WIDTH,
+  height: params.height ?? DEFAULT_HEIGHT,
+  rotation: params.rotation ?? DEFAULT_ROTATION,
+  start: params.start ?? DEFAULT_START,
+  startBlur: clampBlur(params.startBlur ?? DEFAULT_START_BLUR),
+  endBlur: clampBlur(params.endBlur ?? DEFAULT_END_BLUR)
+});
+var assertOptionalUvCoordinate = (value, name) => {
+  if (value === undefined) {
+    return;
+  }
+  if (!Array.isArray(value) || value.length !== 2 || value.some((item) => typeof item !== "number" || !Number.isFinite(item))) {
+    throw new TypeError(`"${name}" must be a [number, number] tuple`);
+  }
+};
+var validateRadialProgressiveBlurParams = (params) => {
+  assertEffectParamsObject(params, "Radial progressive blur");
+  assertOptionalUvCoordinate(params.center, "center");
+  assertOptionalFiniteNumber(params.width, "width");
+  assertOptionalFiniteNumber(params.height, "height");
+  assertOptionalFiniteNumber(params.rotation, "rotation");
+  validateNonNegative(params.width ?? DEFAULT_WIDTH, "width");
+  validateNonNegative(params.height ?? DEFAULT_HEIGHT, "height");
+  assertOptionalFiniteNumber(params.start, "start");
+  validateUnitInterval(params.start ?? DEFAULT_START, "start");
+  assertOptionalFiniteNumber(params.startBlur, "startBlur");
+  assertOptionalFiniteNumber(params.endBlur, "endBlur");
+};
+var radialProgressiveBlur = createEffect({
+  type: "dev.remotion.effects.radialProgressiveBlur",
+  label: "radialProgressiveBlur()",
+  documentationLink: "https://www.remotion.dev/docs/effects/radial-progressive-blur",
+  backend: "webgl2",
+  calculateKey: (params) => {
+    const r = resolveRadialProgressiveBlurParams(params);
+    return `radial-progressive-blur-${r.center.join(":")}-${r.width}-${r.height}-${r.rotation}-${r.start}-${r.startBlur}-${r.endBlur}`;
+  },
+  setup: (target) => setupRadialProgressiveBlur(target),
+  apply: ({ source, width, height, params, state, flipSourceY }) => {
+    const r = resolveRadialProgressiveBlurParams(params);
+    applyRadialProgressiveBlur({
+      state,
+      source,
+      width,
+      height,
+      params: r,
+      flipSourceY
+    });
+  },
+  cleanup: (state) => cleanupRadialProgressiveBlur(state),
+  schema: radialProgressiveBlurSchema,
+  validateParams: validateRadialProgressiveBlurParams
+});
+export {
+  radialProgressiveBlur
+};

package/dist/gridlines.d.ts

@@ -39,7 +39,7 @@ export declare const gridlinesSchema: {
         readonly type: "rotation-degrees";
         readonly min: -180;
         readonly max: 180;
-        readonly step: 1;
+        readonly step: 0.1;
         readonly default: 0;
         readonly description: "Rotation X";
     };
@@ -47,7 +47,7 @@ export declare const gridlinesSchema: {
         readonly type: "rotation-degrees";
         readonly min: -180;
         readonly max: 180;
-        readonly step: 1;
+        readonly step: 0.1;
         readonly default: 0;
         readonly description: "Rotation Y";
     };

package/dist/halftone-linear-gradient.d.ts

@@ -25,7 +25,10 @@ export declare const halftoneLinearGradientSchema: {
         readonly step: 0.01;
         readonly default: readonly [0, 0.5];
         readonly description: "First stop position";
-        readonly lineTo: "secondStopPosition";
+        readonly visual: {
+            readonly type: "line";
+            readonly to: "secondStopPosition";
+        };
     };
     readonly secondStopPosition: {
         readonly type: "uv-coordinate";

package/dist/index.d.ts

@@ -3,3 +3,4 @@ export { pattern, type PatternOrigin, type PatternParams } from './pattern.js';
 export { rings, type RingsCenter, type RingsParams } from './rings.js';
 export { gridlines, type GridlinesParams } from './gridlines.js';
 export { zigzag, type ZigzagDirection, type ZigzagParams } from './zigzag.js';
+export { cornerPin, type CornerPinParams, type CornerPinUvCoordinate, } from './corner-pin/index.js';

package/dist/light-trail/index.d.ts

@@ -0,0 +1,19 @@
+export type LightTrailParams = {
+    /** Direction in which the trail extends, in degrees. Defaults to `180`. */
+    readonly direction?: number;
+    /** Length of the trail in pixels. Defaults to `80`. */
+    readonly distance?: number;
+    /** Brightness multiplier for the trail. Defaults to `1`. */
+    readonly intensity?: number;
+    /** Falloff from one sample to the next. Defaults to `0.9`. */
+    readonly decay?: number;
+    /** Luminance or alpha threshold from `0` to `1`. Defaults to `0`. */
+    readonly threshold?: number;
+    /** Number of samples used for the trail. Defaults to `32`. */
+    readonly samples?: number;
+    /** Color of the trail. Defaults to white. */
+    readonly color?: string;
+};
+export declare const lightTrail: (params?: (LightTrailParams & {
+    readonly disabled?: boolean | undefined;
+}) | undefined) => import("remotion").EffectDescriptor<unknown>;

package/dist/light-trail/light-trail-runtime.d.ts

@@ -0,0 +1,38 @@
+import type { ParsedColorRgba } from '../color-utils.js';
+export type LightTrailState = {
+    readonly gl: WebGL2RenderingContext;
+    readonly program: WebGLProgram;
+    readonly vao: WebGLVertexArrayObject;
+    readonly vbo: WebGLBuffer;
+    readonly textureSource: WebGLTexture;
+    readonly uniforms: {
+        readonly uSource: WebGLUniformLocation | null;
+        readonly uDirection: WebGLUniformLocation | null;
+        readonly uTexelSize: WebGLUniformLocation | null;
+        readonly uColor: WebGLUniformLocation | null;
+        readonly uDistance: WebGLUniformLocation | null;
+        readonly uIntensity: WebGLUniformLocation | null;
+        readonly uDecay: WebGLUniformLocation | null;
+        readonly uThreshold: WebGLUniformLocation | null;
+        readonly uSamples: WebGLUniformLocation | null;
+    };
+    readonly colorCtx: CanvasRenderingContext2D;
+    cachedColorStr: string;
+    cachedColorRgba: ParsedColorRgba;
+};
+export declare const setupLightTrail: (target: HTMLCanvasElement) => LightTrailState;
+export declare const cleanupLightTrail: (state: LightTrailState) => void;
+export declare const applyLightTrail: ({ state, source, width, height, direction, distance, intensity, decay, threshold, samples, color, flipSourceY, }: {
+    readonly state: LightTrailState;
+    readonly source: CanvasImageSource;
+    readonly width: number;
+    readonly height: number;
+    readonly direction: number;
+    readonly distance: number;
+    readonly intensity: number;
+    readonly decay: number;
+    readonly threshold: number;
+    readonly samples: number;
+    readonly color: ParsedColorRgba;
+    readonly flipSourceY: boolean;
+}) => void;

package/dist/light-trail/light-trail-shaders.d.ts

@@ -0,0 +1,2 @@
+export declare const LIGHT_TRAIL_VS = "#version 300 es\nlayout(location = 0) in vec2 aPos;\nlayout(location = 1) in vec2 aUv;\nout vec2 vUv;\n\nvoid main() {\n\tvUv = aUv;\n\tgl_Position = vec4(aPos, 0.0, 1.0);\n}\n";
+export declare const LIGHT_TRAIL_FS = "#version 300 es\nprecision highp float;\n\nin vec2 vUv;\nout vec4 fragColor;\n\nuniform sampler2D uSource;\nuniform vec2 uDirection;\nuniform vec2 uTexelSize;\nuniform vec4 uColor;\nuniform float uDistance;\nuniform float uIntensity;\nuniform float uDecay;\nuniform float uThreshold;\nuniform int uSamples;\n\nconst int MAX_SAMPLES = 64;\n\nfloat getContribution(vec4 color) {\n\tif (color.a <= 0.001) {\n\t\treturn 0.0;\n\t}\n\n\tvec3 rgb = color.rgb / color.a;\n\tfloat luminance = dot(rgb, vec3(0.299, 0.587, 0.114));\n\tfloat source = max(color.a, luminance);\n\tfloat threshold = clamp(uThreshold, 0.0, 1.0);\n\n\tif (threshold >= 1.0) {\n\t\treturn step(1.0, source);\n\t}\n\n\treturn clamp((source - threshold) / max(1.0 - threshold, 0.0001), 0.0, 1.0);\n}\n\nvoid main() {\n\tvec4 source = texture(uSource, vUv);\n\tvec4 trail = vec4(0.0);\n\tfloat sampleCount = float(max(uSamples, 1));\n\n\tfor (int i = 1; i <= MAX_SAMPLES; i++) {\n\t\tif (i > uSamples) {\n\t\t\tbreak;\n\t\t}\n\n\t\tfloat progress = float(i) / sampleCount;\n\t\tvec2 offset = uDirection * uTexelSize * uDistance * progress;\n\t\tvec4 sampleColor = texture(uSource, vUv - offset);\n\t\tfloat contribution = getContribution(sampleColor);\n\t\tfloat weight = pow(clamp(uDecay, 0.0, 1.0), float(i - 1)) * contribution;\n\t\tfloat alpha = sampleColor.a * uColor.a * weight;\n\n\t\ttrail += vec4(uColor.rgb * alpha, alpha);\n\t}\n\n\ttrail *= max(uIntensity, 0.0) / sampleCount;\n\n\tvec4 outColor = source + trail;\n\tfragColor = vec4(min(outColor.rgb, vec3(1.0)), min(outColor.a, 1.0));\n}\n";

package/dist/light-trail.d.ts

@@ -0,0 +1 @@
+export { lightTrail, type LightTrailParams } from './light-trail/index.js';