@remotion/effects 4.0.541 → 4.0.543

package/dist/esm/preview/magnify.mjs

@@ -0,0 +1,403 @@
+import {
+  setupSinglePass,
+  prepareSinglePassSource,
+  drawSinglePass,
+  cleanupSinglePass
+} from "./index-8p04sssx.mjs";
+import {
+  assertOptionalFiniteNumber,
+  validateUnitInterval,
+  validateNonNegative
+} from "./index-wxhvgv2s.mjs";
+import {
+  WEBGPU_SINGLE_PASS_VERTEX,
+  setupWebGpuSinglePass,
+  cleanupWebGpuSinglePass,
+  applyWebGpuSinglePass
+} from "./index-tvfexb7s.mjs";
+import {
+  assertEffectParamsObject,
+  assertRequiredFiniteNumber
+} from "./index-4fvp93ps.mjs";
+
+// src/magnify.ts
+import { Internals } from "remotion";
+
+// src/magnify/shader.ts
+var MAGNIFY_FRAGMENT_SHADER = `#version 300 es
+precision highp float;
+precision highp int;
+
+in vec2 vUv;
+out vec4 fragColor;
+uniform sampler2D uSource;
+uniform vec2 uResolution;
+uniform vec2 uCenter;
+uniform float uMagnification;
+uniform float uSize;
+uniform float uFeather;
+uniform float uOpacity;
+uniform bool uSquare;
+uniform int uScaling;
+uniform bool uIsolated;
+
+vec4 pixelAt(ivec2 p) {
+	if (any(lessThan(p, ivec2(0))) || any(greaterThanEqual(p, textureSize(uSource, 0)))) {
+		return vec4(0.0);
+	}
+	return texelFetch(uSource, p, 0);
+}
+
+vec4 cubicWeights(float t) {
+	float t2 = t * t;
+	float t3 = t2 * t;
+	return vec4(-0.5 * t3 + t2 - 0.5 * t,
+		1.5 * t3 - 2.5 * t2 + 1.0,
+		-1.5 * t3 + 2.0 * t2 + 0.5 * t,
+		0.5 * t3 - 0.5 * t2);
+}
+
+vec4 sampleMagnified(vec2 uv, vec2 position) {
+	vec2 dimensions = vec2(textureSize(uSource, 0));
+	vec2 p = uv * dimensions;
+	if (uScaling == 0) return pixelAt(ivec2(floor(p)));
+	if (uScaling == 2) {
+		uvec2 xy = uvec2(floor(position));
+		uvec2 h = (xy.x ^ (xy.y + uvec2(1048576u, 2097152u))) * 1664525u + 1013904223u;
+		h = (h ^ (h >> 16u)) * 2246822519u;
+		vec2 jitter = (vec2(h ^ (h >> 13u)) / 4294967295.0 - 0.5) * max(1.0 - 1.0 / uMagnification, 0.0);
+		jitter.y = -jitter.y;
+		vec2 q = floor(p) + jitter;
+		ivec2 base = ivec2(floor(q));
+		vec2 f = fract(q);
+		return mix(mix(pixelAt(base), pixelAt(base + ivec2(1, 0)), f.x),
+			mix(pixelAt(base + ivec2(0, 1)), pixelAt(base + ivec2(1, 1)), f.x), f.y);
+	}
+	vec2 q = p - 0.5;
+	ivec2 base = ivec2(floor(q));
+	vec4 wx = cubicWeights(fract(q.x));
+	vec4 wy = cubicWeights(fract(q.y));
+	vec4 color = vec4(0.0);
+	for (int y = 0; y < 4; y++) {
+		for (int x = 0; x < 4; x++) {
+			color += pixelAt(base + ivec2(x - 1, y - 1)) * wx[x] * wy[y];
+		}
+	}
+	float alpha = clamp(color.a, 0.0, 1.0);
+	return vec4(clamp(color.rgb, vec3(0.0), vec3(alpha)), alpha);
+}
+
+void main() {
+	vec4 original = texture(uSource, vUv);
+	vec2 uv = vec2(vUv.x, 1.0 - vUv.y);
+	vec2 offset = (uv - uCenter) * uResolution;
+	float distance = uSquare ? max(abs(offset.x), abs(offset.y)) : length(offset);
+	float weight = 0.0;
+	if (uSize > 0.0) {
+		weight = uFeather > 0.0
+			? 1.0 - smoothstep(uSize - uFeather, uSize, distance)
+			: clamp(uSize - distance + 0.5, 0.0, 1.0);
+	}
+	weight *= uOpacity;
+	if (weight <= 0.0) {
+		fragColor = uIsolated ? vec4(0.0) : original;
+		return;
+	}
+	vec2 sourceUv = uCenter + offset / (uResolution * uMagnification);
+	vec4 magnified = uMagnification == 1.0 ? original
+		: sampleMagnified(vec2(sourceUv.x, 1.0 - sourceUv.y), uv * uResolution);
+	fragColor = uIsolated ? magnified * weight : mix(original, magnified, weight);
+}
+`;
+
+// src/magnify/webgpu-shader.ts
+var MAGNIFY_WEBGPU_SHADER = `
+${WEBGPU_SINGLE_PASS_VERTEX}
+@group(0) @binding(0) var source: texture_2d<f32>;
+@group(0) @binding(1) var sourceSampler: sampler;
+@group(0) @binding(2) var<uniform> params: Params;
+struct Params {
+	resolutionAndCenter: vec4f,
+	lens: vec4f,
+	modes: vec4f,
+}
+
+fn pixelAt(p: vec2i) -> vec4f {
+	if (any(p < vec2i(0)) || any(p >= vec2i(textureDimensions(source)))) {
+		return vec4f(0);
+	}
+	return textureLoad(source, p, 0);
+}
+
+fn cubicWeights(t: f32) -> vec4f {
+	let t2 = t * t;
+	let t3 = t2 * t;
+	return vec4f(-0.5 * t3 + t2 - 0.5 * t,
+		1.5 * t3 - 2.5 * t2 + 1.0,
+		-1.5 * t3 + 2.0 * t2 + 0.5 * t,
+		0.5 * t3 - 0.5 * t2);
+}
+
+fn sampleMagnified(uv: vec2f, position: vec2f) -> vec4f {
+	let p = uv * vec2f(textureDimensions(source));
+	if (params.modes.y == 0) { return pixelAt(vec2i(floor(p))); }
+	if (params.modes.y == 2) {
+		let xy = vec2u(floor(position));
+		var h = (vec2u(xy.x) ^ (vec2u(xy.y) + vec2u(1048576u, 2097152u))) * 1664525u + 1013904223u;
+		h = (h ^ (h >> vec2u(16u))) * 2246822519u;
+		let jitter = (vec2f(h ^ (h >> vec2u(13u))) / 4294967295.0 - 0.5) * max(1.0 - 1.0 / params.lens.x, 0.0);
+		let q = floor(p) + jitter;
+		let base = vec2i(floor(q));
+		let f = fract(q);
+		return mix(mix(pixelAt(base), pixelAt(base + vec2i(1, 0)), f.x),
+			mix(pixelAt(base + vec2i(0, 1)), pixelAt(base + vec2i(1, 1)), f.x), f.y);
+	}
+	let q = p - 0.5;
+	let base = vec2i(floor(q));
+	let wx = cubicWeights(fract(q.x));
+	let wy = cubicWeights(fract(q.y));
+	var color = vec4f(0);
+	for (var y = 0; y < 4; y++) {
+		for (var x = 0; x < 4; x++) {
+			color += pixelAt(base + vec2i(x - 1, y - 1)) * wx[x] * wy[y];
+		}
+	}
+	let alpha = clamp(color.a, 0.0, 1.0);
+	return vec4f(clamp(color.rgb, vec3f(0), vec3f(alpha)), alpha);
+}
+
+@fragment fn fragment(input: VertexOutput) -> @location(0) vec4f {
+	let original = textureSampleLevel(source, sourceSampler, input.uv, 0);
+	let resolution = params.resolutionAndCenter.xy;
+	let center = params.resolutionAndCenter.zw;
+	let offset = (input.uv - center) * resolution;
+	let distance = select(length(offset), max(abs(offset.x), abs(offset.y)), params.modes.x == 1);
+	let size = params.lens.y;
+	let feather = params.lens.z;
+	var weight = 0.0;
+	if (size > 0) {
+		if (feather > 0) {
+			weight = 1.0 - smoothstep(size - feather, size, distance);
+		} else {
+			weight = clamp(size - distance + 0.5, 0.0, 1.0);
+		}
+	}
+	weight *= params.lens.w;
+	if (weight <= 0) {
+		return select(original, vec4f(0), params.modes.z == 1);
+	}
+	var magnified = original;
+	if (params.lens.x != 1) {
+		magnified = sampleMagnified(center + offset / (resolution * params.lens.x), input.uv * resolution);
+	}
+	return select(mix(original, magnified, weight), magnified * weight, params.modes.z == 1);
+}
+`;
+
+// src/magnify.ts
+var DEFAULT_SHAPE = "circle";
+var DEFAULT_CENTER = [0.5, 0.5];
+var DEFAULT_MAGNIFICATION = 200;
+var DEFAULT_LINK = "none";
+var DEFAULT_SIZE = 100;
+var DEFAULT_FEATHER = 0;
+var DEFAULT_OPACITY = 1;
+var DEFAULT_SCALING = "standard";
+var DEFAULT_BLENDING_MODE = "normal";
+var magnifySchema = {
+  shape: {
+    type: "enum",
+    variants: { circle: {}, square: {} },
+    default: DEFAULT_SHAPE,
+    description: "Shape"
+  },
+  center: {
+    type: "uv-coordinate",
+    min: 0,
+    max: 1,
+    step: 0.01,
+    default: DEFAULT_CENTER,
+    description: "Center"
+  },
+  magnification: {
+    type: "number",
+    min: 1,
+    max: 1e4,
+    step: 1,
+    default: DEFAULT_MAGNIFICATION,
+    description: "Magnification (%)",
+    hiddenFromList: false
+  },
+  link: {
+    type: "enum",
+    variants: { none: {}, size: {}, "size-and-feather": {} },
+    default: DEFAULT_LINK,
+    description: "Link"
+  },
+  size: {
+    type: "number",
+    min: 0,
+    max: 4000,
+    step: 1,
+    default: DEFAULT_SIZE,
+    description: "Size",
+    hiddenFromList: false
+  },
+  feather: {
+    type: "number",
+    min: 0,
+    max: 4000,
+    step: 1,
+    default: DEFAULT_FEATHER,
+    description: "Feather",
+    hiddenFromList: false
+  },
+  opacity: {
+    type: "number",
+    min: 0,
+    max: 1,
+    step: 0.01,
+    default: DEFAULT_OPACITY,
+    description: "Opacity",
+    hiddenFromList: false
+  },
+  scaling: {
+    type: "enum",
+    variants: { standard: {}, soft: {}, scatter: {} },
+    default: DEFAULT_SCALING,
+    description: "Scaling"
+  },
+  blendingMode: {
+    type: "enum",
+    variants: { normal: {}, none: {} },
+    default: DEFAULT_BLENDING_MODE,
+    description: "Blending mode"
+  }
+};
+var resolve = (params) => ({
+  shape: params.shape ?? DEFAULT_SHAPE,
+  center: params.center ?? DEFAULT_CENTER,
+  magnification: params.magnification ?? DEFAULT_MAGNIFICATION,
+  link: params.link ?? DEFAULT_LINK,
+  size: params.size ?? DEFAULT_SIZE,
+  feather: params.feather ?? DEFAULT_FEATHER,
+  opacity: params.opacity ?? DEFAULT_OPACITY,
+  scaling: params.scaling ?? DEFAULT_SCALING,
+  blendingMode: params.blendingMode ?? DEFAULT_BLENDING_MODE
+});
+var magnify = Internals.createEffect({
+  type: "dev.remotion.effects.magnify",
+  label: "magnify()",
+  documentationLink: "https://www.remotion.dev/docs/effects/magnify",
+  calculateKey: (params) => {
+    const r = resolve(params);
+    return `magnify-${r.shape}-${r.center.join(":")}-${r.magnification}-${r.link}-${r.size}-${r.feather}-${r.opacity}-${r.scaling}-${r.blendingMode}`;
+  },
+  implementations: {
+    webgl2: Internals.createEffectImplementation({
+      setup: (target) => setupSinglePass(target, MAGNIFY_FRAGMENT_SHADER, "magnify", [
+        "uResolution",
+        "uCenter",
+        "uMagnification",
+        "uSize",
+        "uFeather",
+        "uOpacity",
+        "uSquare",
+        "uScaling",
+        "uIsolated"
+      ]),
+      apply: ({ source, width, height, params, state, flipSourceY }) => {
+        const r = resolve(params);
+        const scale = r.magnification / 100;
+        const { gl, uniforms } = state;
+        prepareSinglePassSource({
+          state,
+          source,
+          width,
+          height,
+          flipSourceY
+        });
+        gl.uniform2f(uniforms.uResolution, width, height);
+        gl.uniform2f(uniforms.uCenter, r.center[0], r.center[1]);
+        gl.uniform1f(uniforms.uMagnification, scale);
+        gl.uniform1f(uniforms.uSize, r.size * (r.link === "none" ? 1 : scale));
+        gl.uniform1f(uniforms.uFeather, r.feather * (r.link === "size-and-feather" ? scale : 1));
+        gl.uniform1f(uniforms.uOpacity, r.opacity);
+        gl.uniform1i(uniforms.uSquare, r.shape === "square" ? 1 : 0);
+        gl.uniform1i(uniforms.uScaling, ["standard", "soft", "scatter"].indexOf(r.scaling));
+        gl.uniform1i(uniforms.uIsolated, r.blendingMode === "none" ? 1 : 0);
+        drawSinglePass(state);
+      },
+      cleanup: cleanupSinglePass
+    }),
+    webgpu: Internals.createEffectImplementation({
+      setup: (target) => setupWebGpuSinglePass(target, "magnify"),
+      apply: ({ source, width, height, params, state, gpuDevice }) => {
+        if (!gpuDevice) {
+          throw new Error("A WebGPU device is required for the magnify effect");
+        }
+        const r = resolve(params);
+        const scale = r.magnification / 100;
+        applyWebGpuSinglePass({
+          state,
+          source,
+          width,
+          height,
+          device: gpuDevice,
+          shader: MAGNIFY_WEBGPU_SHADER,
+          uniformData: new Float32Array([
+            width,
+            height,
+            r.center[0],
+            r.center[1],
+            scale,
+            r.size * (r.link === "none" ? 1 : scale),
+            r.feather * (r.link === "size-and-feather" ? scale : 1),
+            r.opacity,
+            r.shape === "square" ? 1 : 0,
+            ["standard", "soft", "scatter"].indexOf(r.scaling),
+            r.blendingMode === "none" ? 1 : 0,
+            0
+          ])
+        });
+      },
+      cleanup: cleanupWebGpuSinglePass
+    })
+  },
+  schema: magnifySchema,
+  validateParams: (params) => {
+    assertEffectParamsObject(params, "Magnify");
+    for (const name of [
+      "magnification",
+      "size",
+      "feather",
+      "opacity"
+    ]) {
+      assertOptionalFiniteNumber(params[name], name);
+    }
+    if (params.center !== undefined) {
+      if (!Array.isArray(params.center) || params.center.length !== 2) {
+        throw new TypeError('"center" must be a [number, number] tuple');
+      }
+      assertRequiredFiniteNumber(params.center[0], "center[0]");
+      assertRequiredFiniteNumber(params.center[1], "center[1]");
+    }
+    const r = resolve(params);
+    validateUnitInterval(r.center[0], "center[0]");
+    validateUnitInterval(r.center[1], "center[1]");
+    if (r.magnification < 1 || r.magnification > 1e4) {
+      throw new TypeError('"magnification" must be between 1 and 10000');
+    }
+    validateNonNegative(r.size, "size");
+    validateNonNegative(r.feather, "feather");
+    validateUnitInterval(r.opacity, "opacity");
+    for (const name of ["shape", "link", "scaling", "blendingMode"]) {
+      if (!Object.hasOwn(magnifySchema[name].variants, r[name])) {
+        throw new TypeError(`Invalid "${name}": ${JSON.stringify(r[name])}`);
+      }
+    }
+  }
+});
+export {
+  magnify
+};