@remotion/effects 4.0.468 → 4.0.469

package/dist/esm/halftone-linear-gradient.mjs

@@ -0,0 +1,480 @@
+// src/halftone-linear-gradient.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/halftone-linear-gradient.ts
+var { createEffect, createWebGL2ContextError } = Internals;
+var HALFTONE_LINEAR_GRADIENT_COLOR_MODES = ["solid", "source"];
+var DEFAULT_FIRST_STOP_DOT_SIZE = 0;
+var DEFAULT_SECOND_STOP_DOT_SIZE = 40;
+var DEFAULT_FIRST_STOP_POSITION = [0, 0.5];
+var DEFAULT_SECOND_STOP_POSITION = [1, 0.5];
+var DEFAULT_GRID_SIZE = 24;
+var DEFAULT_DOT_COLOR = "black";
+var halftoneLinearGradientSchema = {
+  firstStopDotSize: {
+    type: "number",
+    min: 0,
+    max: 400,
+    step: 1,
+    default: DEFAULT_FIRST_STOP_DOT_SIZE,
+    description: "First stop dot size"
+  },
+  secondStopDotSize: {
+    type: "number",
+    min: 0,
+    max: 400,
+    step: 1,
+    default: DEFAULT_SECOND_STOP_DOT_SIZE,
+    description: "Second stop dot size"
+  },
+  firstStopPosition: {
+    type: "uv-coordinate",
+    min: -1,
+    max: 2,
+    step: 0.01,
+    default: DEFAULT_FIRST_STOP_POSITION,
+    description: "First stop position"
+  },
+  secondStopPosition: {
+    type: "uv-coordinate",
+    min: -1,
+    max: 2,
+    step: 0.01,
+    default: DEFAULT_SECOND_STOP_POSITION,
+    description: "Second stop position"
+  },
+  gridSize: {
+    type: "number",
+    min: 1,
+    max: 400,
+    step: 1,
+    default: DEFAULT_GRID_SIZE,
+    description: "Grid size"
+  },
+  colorMode: {
+    type: "enum",
+    default: "solid",
+    description: "Color mode",
+    variants: {
+      solid: {
+        dotColor: {
+          type: "color",
+          default: DEFAULT_DOT_COLOR,
+          description: "Dot color"
+        }
+      },
+      source: {}
+    }
+  }
+};
+var formatEnum = (variants) => {
+  if (variants.length === 2) {
+    return `"${variants[0]}" or "${variants[1]}"`;
+  }
+  return `${variants.slice(0, -1).map((variant) => `"${variant}"`).join(", ")} or "${variants[variants.length - 1]}"`;
+};
+var assertOptionalEnum = (value, name, variants) => {
+  if (value === undefined) {
+    return;
+  }
+  if (typeof value !== "string" || !variants.includes(value)) {
+    throw new TypeError(`"${name}" must be ${formatEnum(variants)}`);
+  }
+};
+var resolve = (p) => ({
+  firstStopDotSize: p.firstStopDotSize ?? DEFAULT_FIRST_STOP_DOT_SIZE,
+  secondStopDotSize: p.secondStopDotSize ?? DEFAULT_SECOND_STOP_DOT_SIZE,
+  firstStopPosition: [
+    ...p.firstStopPosition ?? DEFAULT_FIRST_STOP_POSITION
+  ],
+  secondStopPosition: [
+    ...p.secondStopPosition ?? DEFAULT_SECOND_STOP_POSITION
+  ],
+  gridSize: p.gridSize ?? DEFAULT_GRID_SIZE,
+  colorMode: p.colorMode ?? "solid",
+  dotColor: "dotColor" in p ? p.dotColor ?? DEFAULT_DOT_COLOR : DEFAULT_DOT_COLOR
+});
+var validateNonNegative2 = (value, name) => {
+  if (value < 0) {
+    throw new TypeError(`"${name}" must be >= 0, but got ${JSON.stringify(value)}`);
+  }
+};
+var validatePositive = (value, name) => {
+  if (value <= 0) {
+    throw new TypeError(`"${name}" must be greater than 0, but got ${JSON.stringify(value)}`);
+  }
+};
+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 validateHalftoneLinearGradientParams = (params) => {
+  assertEffectParamsObject(params, "Halftone linear gradient");
+  assertOptionalFiniteNumber(params.firstStopDotSize, "firstStopDotSize");
+  assertOptionalFiniteNumber(params.secondStopDotSize, "secondStopDotSize");
+  assertOptionalUvCoordinate(params.firstStopPosition, "firstStopPosition");
+  assertOptionalUvCoordinate(params.secondStopPosition, "secondStopPosition");
+  assertOptionalFiniteNumber(params.gridSize, "gridSize");
+  assertOptionalEnum(params.colorMode, "colorMode", HALFTONE_LINEAR_GRADIENT_COLOR_MODES);
+  if (params.colorMode === "source" && "dotColor" in params) {
+    throw new TypeError('"dotColor" can only be set when "colorMode" is "solid"');
+  }
+  assertOptionalColor("dotColor" in params ? params.dotColor : undefined, "dotColor");
+  if (params.firstStopDotSize !== undefined) {
+    validateNonNegative2(params.firstStopDotSize, "firstStopDotSize");
+  }
+  if (params.secondStopDotSize !== undefined) {
+    validateNonNegative2(params.secondStopDotSize, "secondStopDotSize");
+  }
+  if (params.gridSize !== undefined) {
+    validatePositive(params.gridSize, "gridSize");
+  }
+};
+var HALFTONE_LINEAR_GRADIENT_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 HALFTONE_LINEAR_GRADIENT_FS = `#version 300 es
+precision highp float;
+
+in vec2 vUv;
+out vec4 fragColor;
+
+uniform sampler2D uSource;
+uniform vec2 uResolution;
+uniform float uFirstStopDotSize;
+uniform float uSecondStopDotSize;
+uniform vec2 uFirstStopPosition;
+uniform vec2 uSecondStopPosition;
+uniform float uGridSize;
+uniform vec4 uColor;
+uniform bool uUseSourceColor;
+
+float gradientProgress(vec2 uv) {
+	vec2 stopVector = uSecondStopPosition - uFirstStopPosition;
+	float stopDistance = dot(stopVector, stopVector);
+	if (stopDistance <= 0.0) {
+		return 0.0;
+	}
+
+	return clamp(dot(uv - uFirstStopPosition, stopVector) / stopDistance, 0.0, 1.0);
+}
+
+vec4 sourceOver(vec4 backdrop, vec4 overlay) {
+	return overlay + backdrop * (1.0 - overlay.a);
+}
+
+void main() {
+	vec2 fragPos = vUv * uResolution;
+	vec2 center = uResolution * 0.5;
+	vec2 gridPos = fragPos - center;
+
+	float gridSize = max(uGridSize, 0.001);
+	vec2 cellIndex = floor(gridPos / gridSize + 0.5);
+	vec2 gridCenter = cellIndex * gridSize;
+	vec2 canvasCenter = center + gridCenter;
+
+	vec2 centerUv = canvasCenter / uResolution;
+	// Flip Y so that (0,0) is top-left, matching CSS/canvas coordinate conventions.
+	vec2 gradientUv = vec2(centerUv.x, 1.0 - centerUv.y);
+	float progress = gradientProgress(gradientUv);
+	float dotSize = mix(uFirstStopDotSize, uSecondStopDotSize, progress);
+
+	if (dotSize <= 0.01) {
+		fragColor = vec4(0.0);
+		return;
+	}
+
+	vec2 diff = gridPos - gridCenter;
+	float radius = dotSize * 0.5;
+	float coverage = 1.0 - smoothstep(radius - 0.75, radius + 0.75, length(diff));
+
+	vec2 sampleUv = clamp(centerUv, vec2(0.0), vec2(1.0));
+	vec4 texColor = texture(uSource, sampleUv);
+	vec4 dotColor = (uUseSourceColor ? texColor : uColor) * coverage;
+	fragColor = uUseSourceColor ? dotColor : sourceOver(texColor, dotColor);
+}
+`;
+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(`Halftone linear gradient 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(`Halftone linear gradient program link failed: ${log ?? "(no log)"}`);
+  }
+  return program;
+};
+var halftoneLinearGradient = createEffect({
+  type: "remotion/halftone-linear-gradient",
+  label: "halftoneLinearGradient()",
+  documentationLink: "https://www.remotion.dev/docs/effects/halftone-linear-gradient",
+  backend: "webgl2",
+  calculateKey: (params) => {
+    const r = resolve(params);
+    return `halftone-linear-gradient-${r.firstStopDotSize}-${r.secondStopDotSize}-${r.firstStopPosition.join(":")}-${r.secondStopPosition.join(":")}-${r.gridSize}-${r.colorMode}-${r.dotColor}`;
+  },
+  setup: (target) => {
+    const gl = target.getContext("webgl2", {
+      premultipliedAlpha: true,
+      alpha: true,
+      preserveDrawingBuffer: true
+    });
+    if (!gl) {
+      throw createWebGL2ContextError("halftone linear gradient effect");
+    }
+    gl.pixelStorei(gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL, true);
+    const vs = compileShader(gl, gl.VERTEX_SHADER, HALFTONE_LINEAR_GRADIENT_VS);
+    const fs = compileShader(gl, gl.FRAGMENT_SHADER, HALFTONE_LINEAR_GRADIENT_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"),
+      uFirstStopDotSize: gl.getUniformLocation(program, "uFirstStopDotSize"),
+      uSecondStopDotSize: gl.getUniformLocation(program, "uSecondStopDotSize"),
+      uFirstStopPosition: gl.getUniformLocation(program, "uFirstStopPosition"),
+      uSecondStopPosition: gl.getUniformLocation(program, "uSecondStopPosition"),
+      uGridSize: gl.getUniformLocation(program, "uGridSize"),
+      uColor: gl.getUniformLocation(program, "uColor"),
+      uUseSourceColor: gl.getUniformLocation(program, "uUseSourceColor"),
+      colorCtx,
+      cachedColorStr: "",
+      cachedColorRgba: [0, 0, 0, 255]
+    };
+  },
+  apply: ({ source, width, height, params, state, flipSourceY }) => {
+    const r = resolve(params);
+    const { gl, program, vao, texture } = state;
+    if (state.cachedColorStr !== r.dotColor) {
+      state.cachedColorStr = r.dotColor;
+      state.cachedColorRgba = parseColorRgba(state.colorCtx, r.dotColor);
+    }
+    const [cr, cg, cb, ca] = state.cachedColorRgba;
+    const caNormalized = ca / 255;
+    gl.viewport(0, 0, width, height);
+    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.uFirstStopDotSize)
+      gl.uniform1f(state.uFirstStopDotSize, r.firstStopDotSize);
+    if (state.uSecondStopDotSize)
+      gl.uniform1f(state.uSecondStopDotSize, r.secondStopDotSize);
+    if (state.uFirstStopPosition)
+      gl.uniform2f(state.uFirstStopPosition, r.firstStopPosition[0], r.firstStopPosition[1]);
+    if (state.uSecondStopPosition)
+      gl.uniform2f(state.uSecondStopPosition, r.secondStopPosition[0], r.secondStopPosition[1]);
+    if (state.uGridSize)
+      gl.uniform1f(state.uGridSize, r.gridSize);
+    if (state.uColor)
+      gl.uniform4f(state.uColor, cr / 255 * caNormalized, cg / 255 * caNormalized, cb / 255 * caNormalized, caNormalized);
+    if (state.uUseSourceColor)
+      gl.uniform1i(state.uUseSourceColor, r.colorMode === "source" ? 1 : 0);
+    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: halftoneLinearGradientSchema,
+  validateParams: validateHalftoneLinearGradientParams
+});
+export {
+  halftoneLinearGradientSchema,
+  halftoneLinearGradient
+};