@remotion/effects 4.0.467 → 4.0.469

package/dist/esm/drop-shadow.mjs

@@ -0,0 +1,610 @@
+// src/drop-shadow/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);
+};
+
+// 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/drop-shadow/drop-shadow-runtime.ts
+import { Internals } from "remotion";
+
+// src/gaussian-blur-shader.ts
+var buildGaussianBlurFs = (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 float uRadius;
+uniform vec2 uTexelSize;
+
+const int MIN_KERNEL_HALF = 4;
+const int MAX_KERNEL_HALF = 32;
+const float TARGET_SAMPLE_DISTANCE_PX = 2.0;
+const vec2 DIRECTION = ${dirVec};
+
+void main() {
+	if (uRadius <= 0.0) {
+		fragColor = texture(uSource, vUv);
+		return;
+	}
+
+	int kernelHalf = int(
+		min(
+			float(MAX_KERNEL_HALF),
+			max(float(MIN_KERNEL_HALF), ceil(uRadius / TARGET_SAMPLE_DISTANCE_PX))
+		)
+	);
+	float pixelStride = uRadius / float(kernelHalf);
+	float sigma = uRadius / 3.0;
+	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/drop-shadow/drop-shadow-shaders.ts
+var DROP_SHADOW_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 DROP_SHADOW_EXTRACT_FS = `#version 300 es
+precision highp float;
+
+in vec2 vUv;
+out vec4 fragColor;
+
+uniform sampler2D uSource;
+uniform vec4 uColor;
+uniform float uOpacity;
+
+void main() {
+	vec4 source = texture(uSource, vUv);
+	float shadowAlpha = source.a * uColor.a * clamp(uOpacity, 0.0, 1.0);
+
+	fragColor = vec4(uColor.rgb * shadowAlpha, shadowAlpha);
+}
+`;
+var DROP_SHADOW_BLUR_FS_HORIZONTAL = buildGaussianBlurFs("horizontal");
+var DROP_SHADOW_BLUR_FS_VERTICAL = buildGaussianBlurFs("vertical");
+var DROP_SHADOW_COMPOSITE_FS = `#version 300 es
+precision highp float;
+
+in vec2 vUv;
+out vec4 fragColor;
+
+uniform sampler2D uSource;
+uniform sampler2D uShadow;
+uniform vec2 uOffset;
+uniform vec2 uTexelSize;
+
+void main() {
+	vec4 source = texture(uSource, vUv);
+	vec2 shadowUv = vUv - vec2(uOffset.x, -uOffset.y) * uTexelSize;
+	vec4 shadow = vec4(0.0);
+
+	if (
+		shadowUv.x >= 0.0 &&
+		shadowUv.x <= 1.0 &&
+		shadowUv.y >= 0.0 &&
+		shadowUv.y <= 1.0
+	) {
+		shadow = texture(uShadow, shadowUv);
+	}
+
+	fragColor = source + shadow * (1.0 - source.a);
+}
+`;
+
+// src/drop-shadow/drop-shadow-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(`Drop shadow 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(`Drop shadow 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 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 getBlurUniforms = (gl, program) => ({
+  uRadius: gl.getUniformLocation(program, "uRadius"),
+  uTexelSize: gl.getUniformLocation(program, "uTexelSize"),
+  uSource: gl.getUniformLocation(program, "uSource")
+});
+var setupDropShadow = (target) => {
+  const gl = target.getContext("webgl2", {
+    premultipliedAlpha: true,
+    alpha: true,
+    preserveDrawingBuffer: true
+  });
+  if (!gl) {
+    throw createWebGL2ContextError("drop shadow effect");
+  }
+  gl.pixelStorei(gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL, true);
+  const programExtract = createProgram(gl, DROP_SHADOW_VS, DROP_SHADOW_EXTRACT_FS);
+  const programHorizontal = createProgram(gl, DROP_SHADOW_VS, DROP_SHADOW_BLUR_FS_HORIZONTAL);
+  const programVertical = createProgram(gl, DROP_SHADOW_VS, DROP_SHADOW_BLUR_FS_VERTICAL);
+  const programComposite = createProgram(gl, DROP_SHADOW_VS, DROP_SHADOW_COMPOSITE_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);
+  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 textureShadowA = createRgbaTexture(gl);
+  const textureShadowB = createRgbaTexture(gl);
+  const framebuffer = gl.createFramebuffer();
+  if (!framebuffer) {
+    throw new Error("Failed to create WebGL framebuffer");
+  }
+  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,
+    programExtract,
+    programHorizontal,
+    programVertical,
+    programComposite,
+    vao,
+    vbo,
+    textureSource,
+    textureShadowA,
+    textureShadowB,
+    framebuffer,
+    extract: {
+      uSource: gl.getUniformLocation(programExtract, "uSource"),
+      uColor: gl.getUniformLocation(programExtract, "uColor"),
+      uOpacity: gl.getUniformLocation(programExtract, "uOpacity")
+    },
+    horizontal: getBlurUniforms(gl, programHorizontal),
+    vertical: getBlurUniforms(gl, programVertical),
+    composite: {
+      uSource: gl.getUniformLocation(programComposite, "uSource"),
+      uShadow: gl.getUniformLocation(programComposite, "uShadow"),
+      uOffset: gl.getUniformLocation(programComposite, "uOffset"),
+      uTexelSize: gl.getUniformLocation(programComposite, "uTexelSize")
+    },
+    colorCtx,
+    cachedColorStr: "",
+    cachedColorRgba: [0, 0, 0, 255]
+  };
+};
+var cleanupDropShadow = ({
+  gl,
+  programExtract,
+  programHorizontal,
+  programVertical,
+  programComposite,
+  vao,
+  vbo,
+  textureSource,
+  textureShadowA,
+  textureShadowB,
+  framebuffer
+}) => {
+  gl.deleteFramebuffer(framebuffer);
+  gl.deleteTexture(textureSource);
+  gl.deleteTexture(textureShadowA);
+  gl.deleteTexture(textureShadowB);
+  gl.deleteBuffer(vbo);
+  gl.deleteProgram(programExtract);
+  gl.deleteProgram(programHorizontal);
+  gl.deleteProgram(programVertical);
+  gl.deleteProgram(programComposite);
+  gl.deleteVertexArray(vao);
+};
+var drawFullscreenQuad = (state) => {
+  const { gl, vao } = state;
+  gl.bindVertexArray(vao);
+  gl.drawArrays(gl.TRIANGLE_STRIP, 0, 4);
+  gl.bindVertexArray(null);
+};
+var setTextureSize = (gl, texture, width, height) => {
+  gl.bindTexture(gl.TEXTURE_2D, texture);
+  gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, width, height, 0, gl.RGBA, gl.UNSIGNED_BYTE, null);
+};
+var setFramebufferTexture = (gl, framebuffer, texture) => {
+  gl.bindFramebuffer(gl.FRAMEBUFFER, framebuffer);
+  gl.framebufferTexture2D(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0, gl.TEXTURE_2D, texture, 0);
+  const status = gl.checkFramebufferStatus(gl.FRAMEBUFFER);
+  if (status !== gl.FRAMEBUFFER_COMPLETE) {
+    throw new Error(`Drop shadow framebuffer incomplete: 0x${status.toString(16)}`);
+  }
+};
+var setBlurUniforms = ({
+  gl,
+  uniforms,
+  radius,
+  width,
+  height
+}) => {
+  if (uniforms.uSource)
+    gl.uniform1i(uniforms.uSource, 0);
+  if (uniforms.uRadius)
+    gl.uniform1f(uniforms.uRadius, radius);
+  if (uniforms.uTexelSize) {
+    gl.uniform2f(uniforms.uTexelSize, 1 / width, 1 / height);
+  }
+};
+var normalizedColor = (color) => {
+  return [color[0] / 255, color[1] / 255, color[2] / 255, color[3] / 255];
+};
+var applyDropShadow = ({
+  state,
+  source,
+  width,
+  height,
+  radius,
+  offsetX,
+  offsetY,
+  opacity,
+  color,
+  flipSourceY
+}) => {
+  const {
+    gl,
+    textureSource,
+    textureShadowA,
+    textureShadowB,
+    framebuffer,
+    programExtract,
+    programHorizontal,
+    programVertical,
+    programComposite
+  } = state;
+  gl.viewport(0, 0, width, height);
+  gl.clearColor(0, 0, 0, 0);
+  gl.activeTexture(gl.TEXTURE0);
+  gl.bindTexture(gl.TEXTURE_2D, textureSource);
+  gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, flipSourceY);
+  gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, gl.RGBA, gl.UNSIGNED_BYTE, source);
+  setTextureSize(gl, textureShadowA, width, height);
+  setTextureSize(gl, textureShadowB, width, height);
+  const [r, g, b, a] = normalizedColor(color);
+  setFramebufferTexture(gl, framebuffer, textureShadowA);
+  gl.clear(gl.COLOR_BUFFER_BIT);
+  gl.useProgram(programExtract);
+  gl.activeTexture(gl.TEXTURE0);
+  gl.bindTexture(gl.TEXTURE_2D, textureSource);
+  if (state.extract.uSource)
+    gl.uniform1i(state.extract.uSource, 0);
+  if (state.extract.uColor)
+    gl.uniform4f(state.extract.uColor, r, g, b, a);
+  if (state.extract.uOpacity)
+    gl.uniform1f(state.extract.uOpacity, opacity);
+  drawFullscreenQuad(state);
+  setFramebufferTexture(gl, framebuffer, textureShadowB);
+  gl.clear(gl.COLOR_BUFFER_BIT);
+  gl.useProgram(programHorizontal);
+  gl.activeTexture(gl.TEXTURE0);
+  gl.bindTexture(gl.TEXTURE_2D, textureShadowA);
+  setBlurUniforms({
+    gl,
+    uniforms: state.horizontal,
+    radius,
+    width,
+    height
+  });
+  drawFullscreenQuad(state);
+  setFramebufferTexture(gl, framebuffer, textureShadowA);
+  gl.clear(gl.COLOR_BUFFER_BIT);
+  gl.useProgram(programVertical);
+  gl.activeTexture(gl.TEXTURE0);
+  gl.bindTexture(gl.TEXTURE_2D, textureShadowB);
+  setBlurUniforms({
+    gl,
+    uniforms: state.vertical,
+    radius,
+    width,
+    height
+  });
+  drawFullscreenQuad(state);
+  gl.bindFramebuffer(gl.FRAMEBUFFER, null);
+  gl.clear(gl.COLOR_BUFFER_BIT);
+  gl.useProgram(programComposite);
+  gl.activeTexture(gl.TEXTURE0);
+  gl.bindTexture(gl.TEXTURE_2D, textureSource);
+  gl.activeTexture(gl.TEXTURE1);
+  gl.bindTexture(gl.TEXTURE_2D, textureShadowA);
+  if (state.composite.uSource)
+    gl.uniform1i(state.composite.uSource, 0);
+  if (state.composite.uShadow)
+    gl.uniform1i(state.composite.uShadow, 1);
+  if (state.composite.uOffset) {
+    gl.uniform2f(state.composite.uOffset, offsetX, offsetY);
+  }
+  if (state.composite.uTexelSize) {
+    gl.uniform2f(state.composite.uTexelSize, 1 / width, 1 / height);
+  }
+  drawFullscreenQuad(state);
+  gl.bindTexture(gl.TEXTURE_2D, null);
+  gl.useProgram(null);
+};
+
+// src/drop-shadow/index.ts
+var { createEffect } = Internals2;
+var DEFAULT_RADIUS = 12;
+var DEFAULT_OFFSET_X = 8;
+var DEFAULT_OFFSET_Y = 8;
+var DEFAULT_OPACITY = 0.5;
+var DEFAULT_COLOR = "#000000";
+var dropShadowSchema = {
+  radius: {
+    type: "number",
+    min: 0,
+    max: 100,
+    step: 1,
+    default: DEFAULT_RADIUS,
+    description: "Radius"
+  },
+  offsetX: {
+    type: "number",
+    step: 1,
+    default: DEFAULT_OFFSET_X,
+    description: "Offset X"
+  },
+  offsetY: {
+    type: "number",
+    step: 1,
+    default: DEFAULT_OFFSET_Y,
+    description: "Offset Y"
+  },
+  opacity: {
+    type: "number",
+    min: 0,
+    max: 1,
+    step: 0.01,
+    default: DEFAULT_OPACITY,
+    description: "Opacity"
+  },
+  color: {
+    type: "color",
+    default: DEFAULT_COLOR,
+    description: "Color"
+  }
+};
+var resolve = (p) => ({
+  radius: p.radius ?? DEFAULT_RADIUS,
+  offsetX: p.offsetX ?? DEFAULT_OFFSET_X,
+  offsetY: p.offsetY ?? DEFAULT_OFFSET_Y,
+  opacity: p.opacity ?? DEFAULT_OPACITY,
+  color: p.color ?? DEFAULT_COLOR
+});
+var validateDropShadowParams = (params) => {
+  assertEffectParamsObject(params, "Drop shadow");
+  assertOptionalFiniteNumber(params.radius, "radius");
+  assertOptionalFiniteNumber(params.offsetX, "offsetX");
+  assertOptionalFiniteNumber(params.offsetY, "offsetY");
+  assertOptionalFiniteNumber(params.opacity, "opacity");
+  assertOptionalColor(params.color, "color");
+  const r = resolve(params);
+  validateNonNegative(r.radius, "radius");
+  validateUnitInterval(r.opacity, "opacity");
+};
+var dropShadow = createEffect({
+  type: "remotion/drop-shadow",
+  label: "dropShadow()",
+  documentationLink: "https://www.remotion.dev/docs/effects/drop-shadow",
+  backend: "webgl2",
+  calculateKey: (params) => {
+    const r = resolve(params);
+    return `drop-shadow-${r.radius}-${r.offsetX}-${r.offsetY}-${r.opacity}-${r.color}`;
+  },
+  setup: (target) => setupDropShadow(target),
+  apply: ({ source, width, height, params, state, flipSourceY }) => {
+    const r = resolve(params);
+    if (state.cachedColorStr !== r.color) {
+      state.cachedColorStr = r.color;
+      state.cachedColorRgba = parseColorRgba(state.colorCtx, r.color);
+    }
+    applyDropShadow({
+      state,
+      source,
+      width,
+      height,
+      radius: r.radius,
+      offsetX: r.offsetX,
+      offsetY: r.offsetY,
+      opacity: r.opacity,
+      color: state.cachedColorRgba,
+      flipSourceY
+    });
+  },
+  cleanup: (state) => cleanupDropShadow(state),
+  schema: dropShadowSchema,
+  validateParams: validateDropShadowParams
+});
+export {
+  dropShadow
+};