@remotion/effects 4.0.507 → 4.0.508

package/dist/esm/white-balance.mjs

@@ -0,0 +1,333 @@
+// src/white-balance.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/white-balance.ts
+var { createEffect, createWebGL2ContextError } = Internals;
+var DEFAULT_TEMPERATURE = 0;
+var DEFAULT_TINT = 0;
+var whiteBalanceSchema = {
+  temperature: {
+    type: "number",
+    min: -1,
+    max: 1,
+    step: 0.01,
+    default: DEFAULT_TEMPERATURE,
+    description: "Temperature",
+    hiddenFromList: false
+  },
+  tint: {
+    type: "number",
+    min: -1,
+    max: 1,
+    step: 0.01,
+    default: DEFAULT_TINT,
+    description: "Tint",
+    hiddenFromList: false
+  }
+};
+var resolve = (params) => ({
+  temperature: params.temperature ?? DEFAULT_TEMPERATURE,
+  tint: params.tint ?? DEFAULT_TINT
+});
+var validateWhiteBalanceParams = (params) => {
+  assertEffectParamsObject(params, "White balance");
+  assertOptionalFiniteNumber(params.temperature, "temperature");
+  assertOptionalFiniteNumber(params.tint, "tint");
+  const { temperature, tint } = resolve(params);
+  validateSignedUnitInterval(temperature, "temperature");
+  validateSignedUnitInterval(tint, "tint");
+};
+var VERTEX_SHADER = `#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 FRAGMENT_SHADER = `#version 300 es
+precision highp float;
+
+in vec2 vUv;
+out vec4 fragColor;
+
+uniform sampler2D uSource;
+uniform float uTemperature;
+uniform float uTint;
+
+vec3 srgbToLinear(vec3 color) {
+	vec3 lower = color / 12.92;
+	vec3 upper = pow((color + 0.055) / 1.055, vec3(2.4));
+	return mix(lower, upper, step(vec3(0.04045), color));
+}
+
+vec3 linearToSrgb(vec3 color) {
+	vec3 nonNegative = max(color, vec3(0.0));
+	vec3 lower = nonNegative * 12.92;
+	vec3 upper = 1.055 * pow(nonNegative, vec3(1.0 / 2.4)) - 0.055;
+	return mix(lower, upper, step(vec3(0.0031308), nonNegative));
+}
+
+void main() {
+	vec4 sourceColor = texture(uSource, vUv);
+	float alpha = sourceColor.a;
+
+	if (alpha <= 0.0) {
+		fragColor = vec4(0.0);
+		return;
+	}
+
+	vec3 unpremultiplied = sourceColor.rgb / alpha;
+	vec3 linear = srgbToLinear(unpremultiplied);
+	vec3 temperatureOffset = vec3(0.3, 0.0, -0.3) * uTemperature;
+	vec3 tintOffset = vec3(0.15, -0.3, 0.15) * uTint;
+	vec3 gains = exp2(temperatureOffset + tintOffset);
+	float luminanceGain = dot(gains, vec3(0.2126, 0.7152, 0.0722));
+	vec3 balanced = linear * gains / luminanceGain;
+	vec3 corrected = linearToSrgb(balanced);
+
+	fragColor = vec4(corrected * alpha, alpha);
+}
+`;
+var compileShader = (gl, type, source) => {
+  const shader = gl.createShader(type);
+  if (!shader) {
+    throw new Error("Failed to create white balance 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(`White balance shader compile failed: ${log ?? "(no log)"}`);
+  }
+  return shader;
+};
+var createProgram = (gl) => {
+  const vertexShader = compileShader(gl, gl.VERTEX_SHADER, VERTEX_SHADER);
+  const fragmentShader = compileShader(gl, gl.FRAGMENT_SHADER, FRAGMENT_SHADER);
+  const program = gl.createProgram();
+  if (!program) {
+    throw new Error("Failed to create white balance shader program");
+  }
+  gl.attachShader(program, vertexShader);
+  gl.attachShader(program, fragmentShader);
+  gl.linkProgram(program);
+  gl.deleteShader(vertexShader);
+  gl.deleteShader(fragmentShader);
+  if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {
+    const log = gl.getProgramInfoLog(program);
+    gl.deleteProgram(program);
+    throw new Error(`White balance shader link failed: ${log ?? "(no log)"}`);
+  }
+  return program;
+};
+var createTexture = (gl) => {
+  const texture = gl.createTexture();
+  if (!texture) {
+    throw new Error("Failed to create white balance 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 setupWhiteBalance = (target) => {
+  const gl = target.getContext("webgl2", {
+    premultipliedAlpha: true,
+    alpha: true,
+    preserveDrawingBuffer: true
+  });
+  if (!gl) {
+    throw createWebGL2ContextError("white balance effect");
+  }
+  gl.pixelStorei(gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL, true);
+  const program = createProgram(gl);
+  const vao = gl.createVertexArray();
+  if (!vao) {
+    throw new Error("Failed to create white balance vertex array");
+  }
+  const vbo = gl.createBuffer();
+  if (!vbo) {
+    throw new Error("Failed to create white balance vertex buffer");
+  }
+  gl.bindVertexArray(vao);
+  gl.bindBuffer(gl.ARRAY_BUFFER, vbo);
+  gl.bufferData(gl.ARRAY_BUFFER, new Float32Array([-1, -1, 0, 0, 1, -1, 1, 0, -1, 1, 0, 1, 1, 1, 1, 1]), 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);
+  return {
+    gl,
+    program,
+    vao,
+    vbo,
+    textureSource: createTexture(gl),
+    uniforms: {
+      uSource: gl.getUniformLocation(program, "uSource"),
+      uTemperature: gl.getUniformLocation(program, "uTemperature"),
+      uTint: gl.getUniformLocation(program, "uTint")
+    }
+  };
+};
+var whiteBalance = createEffect({
+  type: "remotion/white-balance",
+  label: "whiteBalance()",
+  documentationLink: "https://www.remotion.dev/docs/effects/white-balance",
+  backend: "webgl2",
+  calculateKey: (params) => {
+    const { temperature, tint } = resolve(params);
+    return `white-balance-${temperature}-${tint}`;
+  },
+  setup: setupWhiteBalance,
+  apply: ({ source, width, height, params, state, flipSourceY }) => {
+    const { temperature, tint } = resolve(params);
+    const { gl, program, textureSource, uniforms, vao } = state;
+    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, textureSource);
+    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.uTemperature) {
+      gl.uniform1f(uniforms.uTemperature, temperature);
+    }
+    if (uniforms.uTint)
+      gl.uniform1f(uniforms.uTint, tint);
+    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, textureSource }) => {
+    gl.deleteTexture(textureSource);
+    gl.deleteBuffer(vbo);
+    gl.deleteProgram(program);
+    gl.deleteVertexArray(vao);
+  },
+  schema: whiteBalanceSchema,
+  validateParams: validateWhiteBalanceParams
+});
+export {
+  whiteBalance
+};

package/dist/exposure.d.ts

@@ -0,0 +1,7 @@
+export type ExposureParams = {
+    /** Exposure adjustment in stops, from `-5` to `5`. Defaults to `0`. */
+    readonly stops?: number;
+};
+export declare const exposure: (params?: (ExposureParams & {
+    readonly disabled?: boolean | undefined;
+}) | undefined) => import("remotion").EffectDescriptor<unknown>;

package/dist/levels.d.ts

@@ -0,0 +1,11 @@
+export type LevelsParams = {
+    /** Input value mapped to black, from `0` to `1`. Defaults to `0`. */
+    readonly blackPoint?: number;
+    /** Input value mapped to white, from `0` to `1`. Defaults to `1`. */
+    readonly whitePoint?: number;
+    /** Midtone gamma from `0.01` to `10`. Defaults to `1`. */
+    readonly gamma?: number;
+};
+export declare const levels: (params?: (LevelsParams & {
+    readonly disabled?: boolean | undefined;
+}) | undefined) => import("remotion").EffectDescriptor<unknown>;

package/dist/shadows-highlights.d.ts

@@ -0,0 +1,9 @@
+export type ShadowsHighlightsParams = {
+    /** Shadow adjustment from `-1` to `1`. Defaults to `0`. */
+    readonly shadows?: number;
+    /** Highlight adjustment from `-1` to `1`. Defaults to `0`. */
+    readonly highlights?: number;
+};
+export declare const shadowsHighlights: (params?: (ShadowsHighlightsParams & {
+    readonly disabled?: boolean | undefined;
+}) | undefined) => import("remotion").EffectDescriptor<unknown>;

package/dist/vibrance.d.ts

@@ -0,0 +1,7 @@
+export type VibranceParams = {
+    /** Vibrance adjustment from `-1` to `1`. Defaults to `0`. */
+    readonly amount?: number;
+};
+export declare const vibrance: (params?: (VibranceParams & {
+    readonly disabled?: boolean | undefined;
+}) | undefined) => import("remotion").EffectDescriptor<unknown>;

package/dist/white-balance.d.ts

@@ -0,0 +1,9 @@
+export type WhiteBalanceParams = {
+    /** Blue-to-amber temperature adjustment from `-1` to `1`. Defaults to `0`. */
+    readonly temperature?: number;
+    /** Green-to-magenta tint adjustment from `-1` to `1`. Defaults to `0`. */
+    readonly tint?: number;
+};
+export declare const whiteBalance: (params?: (WhiteBalanceParams & {
+    readonly disabled?: boolean | undefined;
+}) | undefined) => import("remotion").EffectDescriptor<unknown>;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@remotion/effects",
-	"version": "4.0.507",
+	"version": "4.0.508",
 	"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.507"
+		"remotion": "4.0.508"
 	},
 	"exports": {
 		".": {
@@ -104,6 +104,11 @@
 			"module": "./dist/esm/evolve.mjs",
 			"import": "./dist/esm/evolve.mjs"
 		},
+		"./exposure": {
+			"types": "./dist/exposure.d.ts",
+			"module": "./dist/esm/exposure.mjs",
+			"import": "./dist/esm/exposure.mjs"
+		},
 		"./fisheye": {
 			"types": "./dist/fisheye.d.ts",
 			"module": "./dist/esm/fisheye.mjs",
@@ -189,6 +194,11 @@
 			"module": "./dist/esm/linear-progressive-pixelate.mjs",
 			"import": "./dist/esm/linear-progressive-pixelate.mjs"
 		},
+		"./levels": {
+			"types": "./dist/levels.d.ts",
+			"module": "./dist/esm/levels.mjs",
+			"import": "./dist/esm/levels.mjs"
+		},
 		"./light-leak": {
 			"types": "./dist/light-leak.d.ts",
 			"module": "./dist/esm/light-leak.mjs",
@@ -269,6 +279,11 @@
 			"module": "./dist/esm/scale.mjs",
 			"import": "./dist/esm/scale.mjs"
 		},
+		"./shadows-highlights": {
+			"types": "./dist/shadows-highlights.d.ts",
+			"module": "./dist/esm/shadows-highlights.mjs",
+			"import": "./dist/esm/shadows-highlights.mjs"
+		},
 		"./shine": {
 			"types": "./dist/shine.d.ts",
 			"module": "./dist/esm/shine.mjs",
@@ -319,6 +334,11 @@
 			"module": "./dist/esm/venetian-blinds.mjs",
 			"import": "./dist/esm/venetian-blinds.mjs"
 		},
+		"./vibrance": {
+			"types": "./dist/vibrance.d.ts",
+			"module": "./dist/esm/vibrance.mjs",
+			"import": "./dist/esm/vibrance.mjs"
+		},
 		"./vignette": {
 			"types": "./dist/vignette.d.ts",
 			"module": "./dist/esm/vignette.mjs",
@@ -334,6 +354,11 @@
 			"module": "./dist/esm/waves.mjs",
 			"import": "./dist/esm/waves.mjs"
 		},
+		"./white-balance": {
+			"types": "./dist/white-balance.d.ts",
+			"module": "./dist/esm/white-balance.mjs",
+			"import": "./dist/esm/white-balance.mjs"
+		},
 		"./white-noise": {
 			"types": "./dist/white-noise.d.ts",
 			"module": "./dist/esm/white-noise.mjs",
@@ -395,6 +420,9 @@
 			"evolve": [
 				"dist/evolve.d.ts"
 			],
+			"exposure": [
+				"dist/exposure.d.ts"
+			],
 			"fisheye": [
 				"dist/fisheye.d.ts"
 			],
@@ -446,6 +474,9 @@
 			"linear-progressive-pixelate": [
 				"dist/linear-progressive-pixelate.d.ts"
 			],
+			"levels": [
+				"dist/levels.d.ts"
+			],
 			"light-leak": [
 				"dist/light-leak.d.ts"
 			],
@@ -494,6 +525,9 @@
 			"scale": [
 				"dist/scale.d.ts"
 			],
+			"shadows-highlights": [
+				"dist/shadows-highlights.d.ts"
+			],
 			"shine": [
 				"dist/shine.d.ts"
 			],
@@ -524,6 +558,9 @@
 			"venetian-blinds": [
 				"dist/venetian-blinds.d.ts"
 			],
+			"vibrance": [
+				"dist/vibrance.d.ts"
+			],
 			"vignette": [
 				"dist/vignette.d.ts"
 			],
@@ -536,6 +573,9 @@
 			"zigzag": [
 				"dist/zigzag.d.ts"
 			],
+			"white-balance": [
+				"dist/white-balance.d.ts"
+			],
 			"white-noise": [
 				"dist/white-noise.d.ts"
 			],
@@ -546,7 +586,7 @@
 	},
 	"homepage": "https://www.remotion.dev/docs/effects/api",
 	"devDependencies": {
-		"@remotion/eslint-config-internal": "4.0.507",
+		"@remotion/eslint-config-internal": "4.0.508",
 		"@vitest/browser-playwright": "4.0.9",
 		"eslint": "9.19.0",
 		"vitest": "4.0.9",