@remotion/effects 4.0.477 → 4.0.478

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/contour-lines.mjs

@@ -0,0 +1,567 @@
+// src/contour-lines.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/contour-lines.ts
+var { createEffect, createWebGL2ContextError } = Internals;
+var DEFAULT_LINE_COLOR = "#ffffff";
+var DEFAULT_LINE_WIDTH = 1.5;
+var DEFAULT_SPACING = 36;
+var DEFAULT_SCALE = 220;
+var DEFAULT_COMPLEXITY = 0.65;
+var DEFAULT_SMOOTHNESS = 0.55;
+var DEFAULT_SEED = 0;
+var DEFAULT_OFFSET_X = 0;
+var DEFAULT_OFFSET_Y = 0;
+var DEFAULT_OPACITY = 1;
+var DEFAULT_MASK_TO_SOURCE_ALPHA = false;
+var contourLinesSchema = {
+  lineColor: {
+    type: "color",
+    default: DEFAULT_LINE_COLOR,
+    description: "Line color"
+  },
+  lineWidth: {
+    type: "number",
+    min: 0.1,
+    max: 20,
+    step: 0.1,
+    default: DEFAULT_LINE_WIDTH,
+    description: "Line width",
+    hiddenFromList: false
+  },
+  spacing: {
+    type: "number",
+    min: 1,
+    max: 200,
+    step: 1,
+    default: DEFAULT_SPACING,
+    description: "Spacing",
+    hiddenFromList: false
+  },
+  scale: {
+    type: "number",
+    min: 20,
+    max: 1000,
+    step: 1,
+    default: DEFAULT_SCALE,
+    description: "Scale",
+    hiddenFromList: false
+  },
+  complexity: {
+    type: "number",
+    min: 0,
+    max: 1,
+    step: 0.01,
+    default: DEFAULT_COMPLEXITY,
+    description: "Complexity",
+    hiddenFromList: false
+  },
+  smoothness: {
+    type: "number",
+    min: 0,
+    max: 1,
+    step: 0.01,
+    default: DEFAULT_SMOOTHNESS,
+    description: "Smoothness",
+    hiddenFromList: false
+  },
+  seed: {
+    type: "number",
+    step: 1,
+    default: DEFAULT_SEED,
+    description: "Seed",
+    hiddenFromList: false
+  },
+  offsetX: {
+    type: "number",
+    step: 0.1,
+    default: DEFAULT_OFFSET_X,
+    description: "Offset X",
+    hiddenFromList: false
+  },
+  offsetY: {
+    type: "number",
+    step: 0.1,
+    default: DEFAULT_OFFSET_Y,
+    description: "Offset Y",
+    hiddenFromList: false
+  },
+  opacity: {
+    type: "number",
+    min: 0,
+    max: 1,
+    step: 0.01,
+    default: DEFAULT_OPACITY,
+    description: "Opacity",
+    hiddenFromList: false
+  },
+  maskToSourceAlpha: {
+    type: "boolean",
+    default: DEFAULT_MASK_TO_SOURCE_ALPHA,
+    description: "Mask to source alpha"
+  }
+};
+var resolve = (p) => ({
+  lineColor: p.lineColor ?? DEFAULT_LINE_COLOR,
+  lineWidth: p.lineWidth ?? DEFAULT_LINE_WIDTH,
+  spacing: p.spacing ?? DEFAULT_SPACING,
+  scale: p.scale ?? DEFAULT_SCALE,
+  complexity: p.complexity ?? DEFAULT_COMPLEXITY,
+  smoothness: p.smoothness ?? DEFAULT_SMOOTHNESS,
+  seed: p.seed ?? DEFAULT_SEED,
+  offsetX: p.offsetX ?? DEFAULT_OFFSET_X,
+  offsetY: p.offsetY ?? DEFAULT_OFFSET_Y,
+  opacity: p.opacity ?? DEFAULT_OPACITY,
+  maskToSourceAlpha: p.maskToSourceAlpha ?? DEFAULT_MASK_TO_SOURCE_ALPHA
+});
+var validatePositive = (value, name) => {
+  if (value <= 0) {
+    throw new TypeError(`"${name}" must be greater than 0, but got ${JSON.stringify(value)}`);
+  }
+};
+var validateContourLinesParams = (params) => {
+  assertEffectParamsObject(params, "Contour lines");
+  assertOptionalColor(params.lineColor, "lineColor");
+  assertOptionalFiniteNumber(params.lineWidth, "lineWidth");
+  assertOptionalFiniteNumber(params.spacing, "spacing");
+  assertOptionalFiniteNumber(params.scale, "scale");
+  assertOptionalFiniteNumber(params.complexity, "complexity");
+  assertOptionalFiniteNumber(params.smoothness, "smoothness");
+  assertOptionalFiniteNumber(params.seed, "seed");
+  assertOptionalFiniteNumber(params.offsetX, "offsetX");
+  assertOptionalFiniteNumber(params.offsetY, "offsetY");
+  assertOptionalFiniteNumber(params.opacity, "opacity");
+  assertOptionalBoolean(params.maskToSourceAlpha, "maskToSourceAlpha");
+  const r = resolve(params);
+  validatePositive(r.lineWidth, "lineWidth");
+  validatePositive(r.spacing, "spacing");
+  validatePositive(r.scale, "scale");
+  validateUnitInterval(r.complexity, "complexity");
+  validateUnitInterval(r.smoothness, "smoothness");
+  validateUnitInterval(r.opacity, "opacity");
+};
+var CONTOUR_LINES_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 CONTOUR_LINES_FS = `#version 300 es
+precision highp float;
+
+in vec2 vUv;
+out vec4 fragColor;
+
+uniform sampler2D uSource;
+uniform vec2 uResolution;
+uniform vec4 uLineColor;
+uniform float uLineWidth;
+uniform float uSpacing;
+uniform float uScale;
+uniform float uComplexity;
+uniform float uSmoothness;
+uniform float uSeed;
+uniform vec2 uOffset;
+uniform float uOpacity;
+uniform bool uMaskToSourceAlpha;
+
+float hash(vec2 p) {
+	vec3 p3 = fract(vec3(p.xyx) * 0.1031);
+	p3 += dot(p3, p3.yzx + 33.33 + uSeed * 0.013);
+	return fract((p3.x + p3.y) * p3.z);
+}
+
+float valueNoise(vec2 p) {
+	vec2 i = floor(p);
+	vec2 f = fract(p);
+	vec2 u = f * f * f * (f * (f * 6.0 - 15.0) + 10.0);
+
+	float a = hash(i);
+	float b = hash(i + vec2(1.0, 0.0));
+	float c = hash(i + vec2(0.0, 1.0));
+	float d = hash(i + vec2(1.0, 1.0));
+
+	return mix(mix(a, b, u.x), mix(c, d, u.x), u.y);
+}
+
+float fbm(vec2 p) {
+	float value = 0.0;
+	float amplitude = 0.5;
+	float totalAmplitude = 0.0;
+	float persistence = mix(0.18, 0.58, clamp(uComplexity, 0.0, 1.0));
+	float smoothness = clamp(uSmoothness, 0.0, 1.0);
+	mat2 rotate = mat2(0.80, 0.60, -0.60, 0.80);
+
+	for (int i = 0; i < 5; i++) {
+		float octave = float(i) / 4.0;
+		float detailWeight = mix(
+			1.0,
+			1.0 - smoothstep(0.15, 1.0, octave),
+			smoothness
+		);
+		value += amplitude * detailWeight * valueNoise(p);
+		totalAmplitude += amplitude * detailWeight;
+		p = rotate * p * 2.04 + vec2(13.17, 7.31);
+		amplitude *= persistence;
+	}
+
+	return value / totalAmplitude;
+}
+
+void main() {
+	vec4 texColor = texture(uSource, vUv);
+	vec2 pixelPosition = vUv * uResolution + uOffset;
+	float scale = max(uScale, 0.001);
+	vec2 p = pixelPosition / scale + vec2(uSeed * 0.137, uSeed * 0.193);
+
+	float complexity = clamp(uComplexity, 0.0, 1.0);
+	float smoothness = clamp(uSmoothness, 0.0, 1.0);
+	vec2 warp = vec2(
+		fbm(p + vec2(5.2, 1.3)),
+		fbm(p + vec2(1.7, 9.2))
+	) - 0.5;
+	float terrain = fbm(p + warp * complexity * mix(2.8, 1.2, smoothness));
+
+	float levels = max(
+		max(uResolution.x, uResolution.y) / (max(uSpacing, 0.001) * 2.0),
+		1.0
+	);
+	float contourPosition = terrain * levels;
+	float contourFraction = fract(contourPosition);
+	float distanceToContour = min(contourFraction, 1.0 - contourFraction);
+	float derivative = max(fwidth(contourPosition), 0.0001);
+	float halfLineWidth = max(uLineWidth, 0.001) * 0.5 * derivative;
+	float coverage = 1.0 - smoothstep(
+		halfLineWidth,
+		halfLineWidth + derivative,
+		distanceToContour
+	);
+
+	float lineAlpha = uLineColor.a * uOpacity * coverage;
+	vec3 premultipliedLine = uLineColor.rgb * lineAlpha;
+
+	if (uMaskToSourceAlpha) {
+		fragColor = vec4(
+			premultipliedLine * texColor.a + texColor.rgb * (1.0 - lineAlpha),
+			texColor.a
+		);
+		return;
+	}
+
+	fragColor = vec4(
+		premultipliedLine + texColor.rgb * (1.0 - lineAlpha),
+		lineAlpha + texColor.a * (1.0 - lineAlpha)
+	);
+}
+`;
+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(`Contour lines 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(`Contour lines 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 createTexture = (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 setupContourLines = (target) => {
+  const gl = target.getContext("webgl2", {
+    premultipliedAlpha: true,
+    alpha: true,
+    preserveDrawingBuffer: true
+  });
+  if (!gl) {
+    throw createWebGL2ContextError("contour lines effect");
+  }
+  gl.pixelStorei(gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL, true);
+  const program = createProgram(gl, CONTOUR_LINES_VS, CONTOUR_LINES_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 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,
+    sourceTexture: createTexture(gl),
+    colorCtx,
+    uniforms: {
+      uSource: gl.getUniformLocation(program, "uSource"),
+      uResolution: gl.getUniformLocation(program, "uResolution"),
+      uLineColor: gl.getUniformLocation(program, "uLineColor"),
+      uLineWidth: gl.getUniformLocation(program, "uLineWidth"),
+      uSpacing: gl.getUniformLocation(program, "uSpacing"),
+      uScale: gl.getUniformLocation(program, "uScale"),
+      uComplexity: gl.getUniformLocation(program, "uComplexity"),
+      uSmoothness: gl.getUniformLocation(program, "uSmoothness"),
+      uSeed: gl.getUniformLocation(program, "uSeed"),
+      uOffset: gl.getUniformLocation(program, "uOffset"),
+      uOpacity: gl.getUniformLocation(program, "uOpacity"),
+      uMaskToSourceAlpha: gl.getUniformLocation(program, "uMaskToSourceAlpha")
+    },
+    cachedLineColor: "",
+    cachedLineColorRgba: [255, 255, 255, 255]
+  };
+};
+var contourLines = createEffect({
+  type: "remotion/contour-lines",
+  label: "contourLines()",
+  documentationLink: "https://www.remotion.dev/docs/effects/contour-lines",
+  backend: "webgl2",
+  calculateKey: (params) => {
+    const r = resolve(params);
+    const maskSuffix = r.maskToSourceAlpha ? "-mask-to-source-alpha" : "";
+    return `contour-lines-${r.lineColor}-${r.lineWidth}-${r.spacing}-${r.scale}-${r.complexity}-${r.smoothness}-${r.seed}-${r.offsetX}-${r.offsetY}-${r.opacity}${maskSuffix}`;
+  },
+  setup: (target) => setupContourLines(target),
+  apply: ({ source, width, height, params, state, flipSourceY }) => {
+    const r = resolve(params);
+    const { gl, program, sourceTexture, uniforms, vao } = state;
+    if (state.cachedLineColor !== r.lineColor) {
+      state.cachedLineColor = r.lineColor;
+      state.cachedLineColorRgba = parseColorRgba(state.colorCtx, r.lineColor);
+    }
+    const [cr, cg, cb, ca] = state.cachedLineColorRgba;
+    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, sourceTexture);
+    gl.pixelStorei(gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL, true);
+    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 (uniforms.uSource)
+      gl.uniform1i(uniforms.uSource, 0);
+    if (uniforms.uResolution)
+      gl.uniform2f(uniforms.uResolution, width, height);
+    if (uniforms.uLineColor) {
+      gl.uniform4f(uniforms.uLineColor, cr / 255, cg / 255, cb / 255, ca / 255);
+    }
+    if (uniforms.uLineWidth)
+      gl.uniform1f(uniforms.uLineWidth, r.lineWidth);
+    if (uniforms.uSpacing)
+      gl.uniform1f(uniforms.uSpacing, r.spacing);
+    if (uniforms.uScale)
+      gl.uniform1f(uniforms.uScale, r.scale);
+    if (uniforms.uComplexity)
+      gl.uniform1f(uniforms.uComplexity, r.complexity);
+    if (uniforms.uSmoothness)
+      gl.uniform1f(uniforms.uSmoothness, r.smoothness);
+    if (uniforms.uSeed)
+      gl.uniform1f(uniforms.uSeed, r.seed);
+    if (uniforms.uOffset)
+      gl.uniform2f(uniforms.uOffset, r.offsetX, r.offsetY);
+    if (uniforms.uOpacity)
+      gl.uniform1f(uniforms.uOpacity, r.opacity);
+    if (uniforms.uMaskToSourceAlpha)
+      gl.uniform1i(uniforms.uMaskToSourceAlpha, r.maskToSourceAlpha ? 1 : 0);
+    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, sourceTexture }) => {
+    gl.deleteTexture(sourceTexture);
+    gl.deleteBuffer(vbo);
+    gl.deleteProgram(program);
+    gl.deleteVertexArray(vao);
+  },
+  schema: contourLinesSchema,
+  validateParams: validateContourLinesParams
+});
+export {
+  contourLinesSchema,
+  contourLines
+};

package/dist/esm/index.mjs

@@ -268,11 +268,6 @@ var validateAtLeast = (value, min, name) => {
     throw new TypeError(`"${name}" must be >= ${min}, but got ${JSON.stringify(value)}`);
   }
 };
-var validateNonNegative2 = (value, name) => {
-  if (value < 0) {
-    throw new TypeError(`"${name}" must be >= 0, but got ${JSON.stringify(value)}`);
-  }
-};
 var validatePatternParams = (params) => {
   assertEffectParamsObject(params, "Pattern");
   assertOptionalFiniteNumber(params.scale, "scale");
@@ -294,8 +289,6 @@ var validatePatternParams = (params) => {
   assertOptionalInteger(params.columnOffsetEvery, "columnOffsetEvery");
   const r = resolve(params);
   validatePositive(r.scale, "scale");
-  validateNonNegative2(r.gapX, "gapX");
-  validateNonNegative2(r.gapY, "gapY");
   validateAtLeast(r.rowOffsetEvery, 0, "rowOffsetEvery");
   validateAtLeast(r.columnOffsetEvery, 0, "columnOffsetEvery");
   validateUnitInterval(r.origin[0], "origin[0]");
@@ -655,7 +648,7 @@ var validatePositive2 = (value, name) => {
     throw new TypeError(`"${name}" must be greater than 0, but got ${JSON.stringify(value)}`);
   }
 };
-var validateNonNegative3 = (value, name) => {
+var validateNonNegative2 = (value, name) => {
   if (value < 0) {
     throw new TypeError(`"${name}" must be greater than or equal to 0, but got ${JSON.stringify(value)}`);
   }
@@ -692,7 +685,7 @@ var validateRingsParams = (params) => {
   const thickness = params.thickness ?? DEFAULT_THICKNESS;
   const gap = params.gap ?? DEFAULT_GAP2;
   validatePositive2(thickness, "thickness");
-  validateNonNegative3(gap, "gap");
+  validateNonNegative2(gap, "gap");
 };
 var RINGS_VS = `#version 300 es
 in vec2 aPos;
@@ -1092,7 +1085,7 @@ var validatePositive3 = (value, name) => {
     throw new TypeError(`"${name}" must be greater than 0, but got ${JSON.stringify(value)}`);
   }
 };
-var validateNonNegative4 = (value, name) => {
+var validateNonNegative3 = (value, name) => {
   if (value < 0) {
     throw new TypeError(`"${name}" must be greater than or equal to 0, but got ${JSON.stringify(value)}`);
   }
@@ -1132,8 +1125,8 @@ var validateZigzagParams = (params) => {
   const amplitude = params.amplitude ?? DEFAULT_AMPLITUDE;
   const wavelength = params.wavelength ?? DEFAULT_WAVELENGTH;
   validatePositive3(thickness, "thickness");
-  validateNonNegative4(gap, "gap");
-  validateNonNegative4(amplitude, "amplitude");
+  validateNonNegative3(gap, "gap");
+  validateNonNegative3(amplitude, "amplitude");
   validatePositive3(wavelength, "wavelength");
 };
 var ZIGZAG_VS = `#version 300 es

package/dist/esm/pattern.mjs

@@ -268,11 +268,6 @@ var validateAtLeast = (value, min, name) => {
     throw new TypeError(`"${name}" must be >= ${min}, but got ${JSON.stringify(value)}`);
   }
 };
-var validateNonNegative2 = (value, name) => {
-  if (value < 0) {
-    throw new TypeError(`"${name}" must be >= 0, but got ${JSON.stringify(value)}`);
-  }
-};
 var validatePatternParams = (params) => {
   assertEffectParamsObject(params, "Pattern");
   assertOptionalFiniteNumber(params.scale, "scale");
@@ -294,8 +289,6 @@ var validatePatternParams = (params) => {
   assertOptionalInteger(params.columnOffsetEvery, "columnOffsetEvery");
   const r = resolve(params);
   validatePositive(r.scale, "scale");
-  validateNonNegative2(r.gapX, "gapX");
-  validateNonNegative2(r.gapY, "gapY");
   validateAtLeast(r.rowOffsetEvery, 0, "rowOffsetEvery");
   validateAtLeast(r.columnOffsetEvery, 0, "columnOffsetEvery");
   validateUnitInterval(r.origin[0], "origin[0]");

package/dist/esm/pixel-dissolve.mjs

@@ -221,13 +221,15 @@ float hash21(vec2 p) {
 	return fract((p3.x + p3.y) * p3.z);
 }
 
-float dissolveMask(float noise, float threshold, float feather) {
+float dissolveMask(float noise, float progress, float feather) {
 	float edge = max(feather, 0.0);
+	float threshold = 1.0 - clamp(progress, 0.0, 1.0) * (1.0 + edge);
+
 	if (edge <= 0.0001) {
-		return step(noise, threshold);
+		return 1.0 - step(threshold, noise);
 	}
 
-	return 1.0 - smoothstep(threshold, min(threshold + edge, 1.0), noise);
+	return 1.0 - smoothstep(threshold, threshold + edge, noise);
 }
 
 void main() {
@@ -236,9 +238,8 @@ void main() {
 	vec2 cell = floor(gridUv * divisions);
 	vec4 color = texture(uSource, vUv);
 
-	float threshold = 1.0 - clamp(uProgress, 0.0, 1.0);
 	float noise = hash21(cell + vec2(uSeed, uSeed * 1.618));
-	float mask = dissolveMask(noise, threshold, uFeather);
+	float mask = dissolveMask(noise, uProgress, uFeather);
 
 	fragColor = vec4(color.rgb * mask, color.a * mask);
 }

package/dist/visual-test/visual-utils.d.ts

@@ -6,6 +6,11 @@ export declare const testImage: ({ blob, testId, threshold, allowedMismatchedPix
     allowedMismatchedPixelRatio?: number | undefined;
 }) => Promise<void>;
 export declare const descriptorsToMemoizedEffects: (effects: EffectDescriptor<unknown>[]) => EffectDefinitionAndStack<unknown>[];
+export declare const renderEffectChainToCanvas: ({ effects, width, height, }: {
+    effects: EffectDefinitionAndStack<unknown>[];
+    width?: number | undefined;
+    height?: number | undefined;
+}) => Promise<HTMLCanvasElement>;
 export declare const renderEffectChainToBlob: ({ effects, width, height, }: {
     effects: EffectDefinitionAndStack<unknown>[];
     width?: number | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@remotion/effects",
-	"version": "4.0.477",
+	"version": "4.0.478",
 	"description": "Effects that can be applied to Remotion-based canvas components",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
@@ -26,7 +26,7 @@
 		"url": "https://github.com/remotion-dev/remotion/issues"
 	},
 	"dependencies": {
-		"remotion": "4.0.477"
+		"remotion": "4.0.478"
 	},
 	"exports": {
 		".": {
@@ -64,6 +64,11 @@
 			"module": "./dist/esm/contrast.mjs",
 			"import": "./dist/esm/contrast.mjs"
 		},
+		"./contour-lines": {
+			"types": "./dist/contour-lines.d.ts",
+			"module": "./dist/esm/contour-lines.mjs",
+			"import": "./dist/esm/contour-lines.mjs"
+		},
 		"./drop-shadow": {
 			"types": "./dist/drop-shadow.d.ts",
 			"module": "./dist/esm/drop-shadow.mjs",
@@ -246,6 +251,9 @@
 			"contrast": [
 				"dist/contrast.d.ts"
 			],
+			"contour-lines": [
+				"dist/contour-lines.d.ts"
+			],
 			"drop-shadow": [
 				"dist/drop-shadow.d.ts"
 			],
@@ -346,7 +354,7 @@
 	},
 	"homepage": "https://www.remotion.dev/docs/effects/api",
 	"devDependencies": {
-		"@remotion/eslint-config-internal": "4.0.477",
+		"@remotion/eslint-config-internal": "4.0.478",
 		"@vitest/browser-playwright": "4.0.9",
 		"eslint": "9.19.0",
 		"vitest": "4.0.9",

package/dist/effect-internals.d.ts

@@ -1,8 +0,0 @@
-export declare const EffectInternals: {
-    readonly halftone: (params?: (import("./halftone.js").HalftoneParams & {
-        readonly disabled?: boolean | undefined;
-    }) | undefined) => import("remotion").EffectDescriptor<unknown>;
-    readonly tint: (params: import("./tint.js").TintParams & {
-        readonly disabled?: boolean | undefined;
-    }) => import("remotion").EffectDescriptor<unknown>;
-};

package/dist/entrypoints/blur.d.ts

@@ -1,6 +0,0 @@
-import * as blurExports from '../blur/index.js';
-export type { BlurParams } from '../blur/index.js';
-declare const blur: (params: blurExports.BlurParams & {
-    readonly disabled?: boolean | undefined;
-}) => import("remotion").EffectDescriptor<unknown>;
-export { blur };