@remotion/renderer 4.0.21 → 4.0.23

package/dist/options/options-map.d.ts

@@ -0,0 +1,82 @@
+export declare const optionsMap: {
+    readonly renderMedia: readonly [{
+        name: string;
+        cliFlag: "offthreadvideo-cache-size-in-bytes";
+        description: JSX.Element;
+        ssrName: "offthreadVideoCacheSizeInBytes";
+        docLink: string;
+        type: number | null;
+    }];
+    readonly renderStill: readonly [{
+        name: string;
+        cliFlag: "offthreadvideo-cache-size-in-bytes";
+        description: JSX.Element;
+        ssrName: "offthreadVideoCacheSizeInBytes";
+        docLink: string;
+        type: number | null;
+    }];
+    readonly getCompositions: readonly [{
+        name: string;
+        cliFlag: "offthreadvideo-cache-size-in-bytes";
+        description: JSX.Element;
+        ssrName: "offthreadVideoCacheSizeInBytes";
+        docLink: string;
+        type: number | null;
+    }];
+    readonly selectComposition: readonly [{
+        name: string;
+        cliFlag: "offthreadvideo-cache-size-in-bytes";
+        description: JSX.Element;
+        ssrName: "offthreadVideoCacheSizeInBytes";
+        docLink: string;
+        type: number | null;
+    }];
+    readonly renderFrames: readonly [{
+        name: string;
+        cliFlag: "offthreadvideo-cache-size-in-bytes";
+        description: JSX.Element;
+        ssrName: "offthreadVideoCacheSizeInBytes";
+        docLink: string;
+        type: number | null;
+    }];
+    readonly renderMediaOnLambda: readonly [{
+        name: string;
+        cliFlag: "offthreadvideo-cache-size-in-bytes";
+        description: JSX.Element;
+        ssrName: "offthreadVideoCacheSizeInBytes";
+        docLink: string;
+        type: number | null;
+    }];
+    readonly renderStillOnLambda: readonly [{
+        name: string;
+        cliFlag: "offthreadvideo-cache-size-in-bytes";
+        description: JSX.Element;
+        ssrName: "offthreadVideoCacheSizeInBytes";
+        docLink: string;
+        type: number | null;
+    }];
+    readonly getCompositionsOnLambda: readonly [{
+        name: string;
+        cliFlag: "offthreadvideo-cache-size-in-bytes";
+        description: JSX.Element;
+        ssrName: "offthreadVideoCacheSizeInBytes";
+        docLink: string;
+        type: number | null;
+    }];
+    readonly renderMediaOnCloudRun: readonly [{
+        name: string;
+        cliFlag: "offthreadvideo-cache-size-in-bytes";
+        description: JSX.Element;
+        ssrName: "offthreadVideoCacheSizeInBytes";
+        docLink: string;
+        type: number | null;
+    }];
+    readonly renderStillOnCloudRun: readonly [{
+        name: string;
+        cliFlag: "offthreadvideo-cache-size-in-bytes";
+        description: JSX.Element;
+        ssrName: "offthreadVideoCacheSizeInBytes";
+        docLink: string;
+        type: number | null;
+    }];
+};

package/dist/options/options-map.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.optionsMap = void 0;
+const offthreadvideo_cache_size_1 = require("./offthreadvideo-cache-size");
+exports.optionsMap = {
+    renderMedia: [offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytesOption],
+    renderStill: [offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytesOption],
+    getCompositions: [offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytesOption],
+    selectComposition: [offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytesOption],
+    renderFrames: [offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytesOption],
+    renderMediaOnLambda: [offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytesOption],
+    renderStillOnLambda: [offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytesOption],
+    getCompositionsOnLambda: [offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytesOption],
+    renderMediaOnCloudRun: [offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytesOption],
+    renderStillOnCloudRun: [offthreadvideo_cache_size_1.offthreadVideoCacheSizeInBytesOption],
+};

package/dist/options/scale.d.ts

@@ -1,2 +1,8 @@
-import type { RemotionOption } from './option';
-export declare const scaleOption: RemotionOption;
+export declare const scaleOption: {
+    name: string;
+    cliFlag: string;
+    description: JSX.Element;
+    ssrName: string;
+    docLink: string;
+    type: number;
+};

package/dist/options/scale.js

@@ -8,4 +8,5 @@ exports.scaleOption = {
     description: ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: ["Scales the output by a factor. For example, a 1280x720px frame will become a 1920x1080px frame with a scale factor of ", (0, jsx_runtime_1.jsx)("code", { children: "1.5" }), ". Vector elements like fonts and HTML markups will be rendered with extra details."] })),
     ssrName: 'scale',
     docLink: 'https://www.remotion.dev/docs/scaling',
+    type: 0,
 };

package/dist/options/video-bitrate.d.ts

@@ -1,2 +1,8 @@
-import type { RemotionOption } from './option';
-export declare const videoBitrate: RemotionOption;
+export declare const videoBitrate: {
+    name: string;
+    cliFlag: string;
+    description: JSX.Element;
+    ssrName: string;
+    docLink: string;
+    type: string;
+};

package/dist/options/video-bitrate.js

@@ -8,4 +8,5 @@ exports.videoBitrate = {
     description: ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: ["Specify the target bitrate for the generated video. The syntax for FFMPEGs", (0, jsx_runtime_1.jsx)("code", { children: "-b:v" }), " parameter should be used. FFMPEG may encode the video in a way that will not result in the exact video bitrate specified. Example values: ", (0, jsx_runtime_1.jsx)("code", { children: "512K" }), " for 512 kbps, ", (0, jsx_runtime_1.jsx)("code", { children: "1M" }), " for 1 Mbps."] })),
     ssrName: 'videoBitrate',
     docLink: 'https://www.remotion.dev/docs/renderer/render-media#videobitrate-',
+    type: '',
 };

package/dist/options/video-codec.d.ts

@@ -1,2 +1,8 @@
-import type { RemotionOption } from './option';
-export declare const videoCodecOption: RemotionOption;
+export declare const videoCodecOption: {
+    name: string;
+    cliFlag: string;
+    description: JSX.Element;
+    ssrName: string;
+    docLink: string;
+    type: string;
+};

package/dist/options/video-codec.js

@@ -8,4 +8,5 @@ exports.videoCodecOption = {
     description: ((0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: "H264 works well in most cases, but sometimes it's worth going for a different codec. WebM achieves higher compression but is slower to render. WebM and ProRes support transparency." })),
     ssrName: 'codec',
     docLink: 'https://www.remotion.dev/docs/encoding/#choosing-a-codec',
+    type: '',
 };

package/dist/pixel-format.d.ts

@@ -1,5 +1,5 @@
 import type { Codec } from './codec';
 export declare const validPixelFormats: readonly ["yuv420p", "yuva420p", "yuv422p", "yuv444p", "yuv420p10le", "yuv422p10le", "yuv444p10le", "yuva444p10le"];
-export type PixelFormat = typeof validPixelFormats[number];
+export type PixelFormat = (typeof validPixelFormats)[number];
 export declare const DEFAULT_PIXEL_FORMAT: PixelFormat;
 export declare const validateSelectedPixelFormatAndCodecCombination: (pixelFormat: PixelFormat | undefined, codec: Codec) => undefined;

package/dist/prepare-server.d.ts

@@ -18,8 +18,9 @@ type PrepareServerOptions = {
     concurrency: number;
     logLevel: LogLevel;
     indent: boolean;
+    offthreadVideoCacheSizeInBytes: number | null;
 };
-export declare const prepareServer: ({ webpackConfigOrServeUrl, port, remotionRoot, concurrency, logLevel, indent, }: PrepareServerOptions) => Promise<RemotionServer>;
+export declare const prepareServer: ({ webpackConfigOrServeUrl, port, remotionRoot, concurrency, logLevel, indent, offthreadVideoCacheSizeInBytes, }: PrepareServerOptions) => Promise<RemotionServer>;
 export declare const makeOrReuseServer: (server: RemotionServer | undefined, config: PrepareServerOptions, { onDownload, onError, }: {
     onError: (err: Error) => void;
     onDownload: RenderMediaOnDownload | null;

package/dist/prepare-server.js

@@ -15,7 +15,7 @@ const logger_1 = require("./logger");
 const serve_static_1 = require("./serve-static");
 const symbolicate_stacktrace_1 = require("./symbolicate-stacktrace");
 const wait_for_symbolication_error_to_be_done_1 = require("./wait-for-symbolication-error-to-be-done");
-const prepareServer = async ({ webpackConfigOrServeUrl, port, remotionRoot, concurrency, logLevel, indent, }) => {
+const prepareServer = async ({ webpackConfigOrServeUrl, port, remotionRoot, concurrency, logLevel, indent, offthreadVideoCacheSizeInBytes, }) => {
     const downloadMap = (0, download_map_1.makeDownloadMap)();
     logger_1.Log.verboseAdvanced({ indent, logLevel }, 'Created directory for temporary files', downloadMap.assetDir);
     if ((0, is_serve_url_1.isServeUrl)(webpackConfigOrServeUrl)) {
@@ -26,6 +26,7 @@ const prepareServer = async ({ webpackConfigOrServeUrl, port, remotionRoot, conc
             concurrency,
             logLevel,
             indent,
+            offthreadVideoCacheSizeInBytes,
         });
         return Promise.resolve({
             serveUrl: webpackConfigOrServeUrl,
@@ -56,6 +57,7 @@ const prepareServer = async ({ webpackConfigOrServeUrl, port, remotionRoot, conc
         concurrency,
         logLevel,
         indent,
+        offthreadVideoCacheSizeInBytes,
     });
     return Promise.resolve({
         closeServer: async (force) => {

package/dist/prores-profile.d.ts

@@ -1,6 +1,6 @@
 import type { Codec } from './codec';
 export declare const proResProfileOptions: readonly ["4444-xq", "4444", "hq", "standard", "light", "proxy"];
-export type ProResProfile = typeof proResProfileOptions[number];
+export type ProResProfile = (typeof proResProfileOptions)[number];
 export declare const validateSelectedCodecAndProResCombination: ({ codec, proResProfile, }: {
     codec: Codec;
     proResProfile: ProResProfile | undefined;

package/dist/provide-screenshot.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 import type { ClipRegion } from 'remotion';
 import type { Page } from './browser/BrowserPage';
 import type { StillImageFormat } from './image-format';

package/dist/puppeteer-screenshot.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 import type { ClipRegion } from 'remotion';
 import type { Page } from './browser/BrowserPage';
 import type { StillImageFormat } from './image-format';

package/dist/quality.d.ts

@@ -0,0 +1 @@
+export declare const validateQuality: (q: number | undefined) => void;

package/dist/quality.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateQuality = void 0;
+const validateQuality = (q) => {
+    if (typeof q !== 'undefined' && typeof q !== 'number') {
+        throw new Error(`Quality option must be a number or undefined. Got ${typeof q} (${JSON.stringify(q)})`);
+    }
+    if (typeof q === 'undefined') {
+        return;
+    }
+    if (!Number.isFinite(q)) {
+        throw new RangeError(`Quality must be a finite number, but is ${q}`);
+    }
+    if (Number.isNaN(q)) {
+        throw new RangeError(`Quality is NaN, but must be a real number`);
+    }
+    if (q > 100 || q < 0) {
+        throw new RangeError('Quality option must be between 0 and 100.');
+    }
+};
+exports.validateQuality = validateQuality;

package/dist/render-frames.d.ts

@@ -9,6 +9,8 @@ import type { VideoImageFormat } from './image-format';
 import { type LogLevel } from './log-level';
 import type { CancelSignal } from './make-cancel-signal';
 import type { ChromiumOptions } from './open-browser';
+import type { ToOptions } from './options/option';
+import type { optionsMap } from './options/options-map';
 import type { RemotionServer } from './prepare-server';
 import type { OnStartData, RenderFramesOutput } from './types';
 export type InternalRenderFramesOptions = {
@@ -39,7 +41,7 @@ export type InternalRenderFramesOptions = {
     logLevel: LogLevel;
     serializedInputPropsWithCustomSchema: string;
     serializedResolvedPropsWithCustomSchema: string;
-};
+} & ToOptions<typeof optionsMap.renderFrames>;
 export type RenderFramesOptions = {
     onStart: (data: OnStartData) => void;
     onFrameUpdate: (framesRendered: number, frameIndex: number, timeToRenderInMilliseconds: number) => void;
@@ -77,8 +79,9 @@ export type RenderFramesOptions = {
     muted?: boolean;
     concurrency?: number | string | null;
     serveUrl: string;
+    offthreadVideoCacheSizeInBytes?: number | null;
 };
-export declare const internalRenderFrames: ({ browserExecutable, cancelSignal, chromiumOptions, composition, concurrency, envVariables, everyNthFrame, frameRange, imageFormat, indent, jpegQuality, muted, onBrowserLog, onDownload, onFrameBuffer, onFrameUpdate, onStart, outputDir, port, puppeteerInstance, scale, server, timeoutInMilliseconds, logLevel, webpackBundleOrServeUrl, serializedInputPropsWithCustomSchema, serializedResolvedPropsWithCustomSchema, }: InternalRenderFramesOptions) => Promise<RenderFramesOutput>;
+export declare const internalRenderFrames: ({ browserExecutable, cancelSignal, chromiumOptions, composition, concurrency, envVariables, everyNthFrame, frameRange, imageFormat, indent, jpegQuality, muted, onBrowserLog, onDownload, onFrameBuffer, onFrameUpdate, onStart, outputDir, port, puppeteerInstance, scale, server, timeoutInMilliseconds, logLevel, webpackBundleOrServeUrl, serializedInputPropsWithCustomSchema, serializedResolvedPropsWithCustomSchema, offthreadVideoCacheSizeInBytes, }: InternalRenderFramesOptions) => Promise<RenderFramesOutput>;
 /**
  * @description Renders a series of images using Puppeteer and computes information for mixing audio.
  * @see [Documentation](https://www.remotion.dev/docs/renderer/render-frames)

package/dist/render-frames.js

@@ -299,7 +299,7 @@ const innerRenderFrames = async ({ onFrameUpdate, outputDir, onStart, serialized
     await Promise.all(downloadPromises);
     return result;
 };
-const internalRenderFrames = ({ browserExecutable, cancelSignal, chromiumOptions, composition, concurrency, envVariables, everyNthFrame, frameRange, imageFormat, indent, jpegQuality, muted, onBrowserLog, onDownload, onFrameBuffer, onFrameUpdate, onStart, outputDir, port, puppeteerInstance, scale, server, timeoutInMilliseconds, logLevel, webpackBundleOrServeUrl, serializedInputPropsWithCustomSchema, serializedResolvedPropsWithCustomSchema, }) => {
+const internalRenderFrames = ({ browserExecutable, cancelSignal, chromiumOptions, composition, concurrency, envVariables, everyNthFrame, frameRange, imageFormat, indent, jpegQuality, muted, onBrowserLog, onDownload, onFrameBuffer, onFrameUpdate, onStart, outputDir, port, puppeteerInstance, scale, server, timeoutInMilliseconds, logLevel, webpackBundleOrServeUrl, serializedInputPropsWithCustomSchema, serializedResolvedPropsWithCustomSchema, offthreadVideoCacheSizeInBytes, }) => {
     remotion_1.Internals.validateDimension(composition.height, 'height', 'in the `config` object passed to `renderFrames()`');
     remotion_1.Internals.validateDimension(composition.width, 'width', 'in the `config` object passed to `renderFrames()`');
     remotion_1.Internals.validateFps(composition.fps, 'in the `config` object of `renderFrames()`', false);
@@ -340,6 +340,7 @@ const internalRenderFrames = ({ browserExecutable, cancelSignal, chromiumOptions
                     concurrency: actualConcurrency,
                     logLevel,
                     indent,
+                    offthreadVideoCacheSizeInBytes,
                 }, {
                     onDownload,
                     onError,
@@ -425,7 +426,7 @@ exports.internalRenderFrames = internalRenderFrames;
  * @see [Documentation](https://www.remotion.dev/docs/renderer/render-frames)
  */
 const renderFrames = (options) => {
-    const { composition, inputProps, onFrameUpdate, onStart, outputDir, serveUrl, browserExecutable, cancelSignal, chromiumOptions, concurrency, dumpBrowserLogs, envVariables, everyNthFrame, frameRange, imageFormat, jpegQuality, muted, onBrowserLog, onDownload, onFrameBuffer, port, puppeteerInstance, scale, timeoutInMilliseconds, verbose, quality, logLevel, } = options;
+    const { composition, inputProps, onFrameUpdate, onStart, outputDir, serveUrl, browserExecutable, cancelSignal, chromiumOptions, concurrency, dumpBrowserLogs, envVariables, everyNthFrame, frameRange, imageFormat, jpegQuality, muted, onBrowserLog, onDownload, onFrameBuffer, port, puppeteerInstance, scale, timeoutInMilliseconds, verbose, quality, logLevel, offthreadVideoCacheSizeInBytes, } = options;
     if (!composition) {
         throw new Error('No `composition` option has been specified for renderFrames()');
     }
@@ -471,6 +472,7 @@ const renderFrames = (options) => {
         timeoutInMilliseconds: timeoutInMilliseconds !== null && timeoutInMilliseconds !== void 0 ? timeoutInMilliseconds : TimeoutSettings_1.DEFAULT_TIMEOUT,
         webpackBundleOrServeUrl: serveUrl,
         server: undefined,
+        offthreadVideoCacheSizeInBytes: offthreadVideoCacheSizeInBytes !== null && offthreadVideoCacheSizeInBytes !== void 0 ? offthreadVideoCacheSizeInBytes : null,
     });
 };
 exports.renderFrames = renderFrames;

package/dist/render-media.d.ts

@@ -12,10 +12,13 @@ import type { VideoImageFormat } from './image-format';
 import { type LogLevel } from './log-level';
 import type { CancelSignal } from './make-cancel-signal';
 import type { ChromiumOptions } from './open-browser';
+import type { ToOptions } from './options/option';
+import type { optionsMap } from './options/options-map';
 import type { PixelFormat } from './pixel-format';
 import type { RemotionServer } from './prepare-server';
 import type { ProResProfile } from './prores-profile';
 import type { OnStartData } from './types';
+import type { X264Preset } from './x264-preset';
 export type StitchingState = 'encoding' | 'muxing';
 export type SlowFrame = {
     frame: number;
@@ -48,6 +51,7 @@ export type InternalRenderMediaOptions = {
     onProgress: RenderMediaOnProgress;
     onDownload: RenderMediaOnDownload;
     proResProfile: ProResProfile | undefined;
+    x264Preset: X264Preset | undefined;
     onBrowserLog: ((log: BrowserLog) => void) | null;
     onStart: (data: OnStartData) => void;
     timeoutInMilliseconds: number;
@@ -70,7 +74,7 @@ export type InternalRenderMediaOptions = {
     audioCodec: AudioCodec | null;
     serveUrl: string;
     concurrency: number | string | null;
-};
+} & ToOptions<typeof optionsMap.renderMedia>;
 export type RenderMediaOptions = {
     outputLocation?: string | null;
     codec: Codec;
@@ -93,6 +97,7 @@ export type RenderMediaOptions = {
     onProgress?: RenderMediaOnProgress;
     onDownload?: RenderMediaOnDownload;
     proResProfile?: ProResProfile;
+    x264Preset?: X264Preset;
     /**
      * @deprecated Use "logLevel": "verbose" instead
      */
@@ -120,16 +125,17 @@ export type RenderMediaOptions = {
     serveUrl: string;
     concurrency?: number | string | null;
     logLevel?: LogLevel;
+    offthreadVideoCacheSizeInBytes?: number | null;
 };
 type RenderMediaResult = {
     buffer: Buffer | null;
     slowestFrames: SlowFrame[];
 };
-export declare const internalRenderMedia: ({ proResProfile, crf, composition, serializedInputPropsWithCustomSchema, pixelFormat, codec, envVariables, frameRange, puppeteerInstance, outputLocation, onProgress, overwrite, onDownload, onBrowserLog, onStart, timeoutInMilliseconds, chromiumOptions, scale, browserExecutable, port, cancelSignal, muted, enforceAudioTrack, ffmpegOverride, audioBitrate, videoBitrate, audioCodec, concurrency, disallowParallelEncoding, everyNthFrame, imageFormat: provisionalImageFormat, indent, jpegQuality, numberOfGifLoops, onCtrlCExit, preferLossless, serveUrl, server: reusedServer, logLevel, serializedResolvedPropsWithCustomSchema, }: InternalRenderMediaOptions) => Promise<RenderMediaResult>;
+export declare const internalRenderMedia: ({ proResProfile, x264Preset, crf, composition, serializedInputPropsWithCustomSchema, pixelFormat, codec, envVariables, frameRange, puppeteerInstance, outputLocation, onProgress, overwrite, onDownload, onBrowserLog, onStart, timeoutInMilliseconds, chromiumOptions, scale, browserExecutable, port, cancelSignal, muted, enforceAudioTrack, ffmpegOverride, audioBitrate, videoBitrate, audioCodec, concurrency, disallowParallelEncoding, everyNthFrame, imageFormat: provisionalImageFormat, indent, jpegQuality, numberOfGifLoops, onCtrlCExit, preferLossless, serveUrl, server: reusedServer, logLevel, serializedResolvedPropsWithCustomSchema, offthreadVideoCacheSizeInBytes, }: InternalRenderMediaOptions) => Promise<RenderMediaResult>;
 /**
  *
  * @description Render a video from a composition
  * @see [Documentation](https://www.remotion.dev/docs/renderer/render-media)
  */
-export declare const renderMedia: ({ proResProfile, crf, composition, inputProps, pixelFormat, codec, envVariables, frameRange, puppeteerInstance, outputLocation, onProgress, overwrite, onDownload, onBrowserLog, onStart, timeoutInMilliseconds, chromiumOptions, scale, browserExecutable, port, cancelSignal, muted, enforceAudioTrack, ffmpegOverride, audioBitrate, videoBitrate, audioCodec, jpegQuality, concurrency, serveUrl, disallowParallelEncoding, everyNthFrame, imageFormat, numberOfGifLoops, dumpBrowserLogs, preferLossless, verbose, quality, logLevel, }: RenderMediaOptions) => Promise<RenderMediaResult>;
+export declare const renderMedia: ({ proResProfile, x264Preset, crf, composition, inputProps, pixelFormat, codec, envVariables, frameRange, puppeteerInstance, outputLocation, onProgress, overwrite, onDownload, onBrowserLog, onStart, timeoutInMilliseconds, chromiumOptions, scale, browserExecutable, port, cancelSignal, muted, enforceAudioTrack, ffmpegOverride, audioBitrate, videoBitrate, audioCodec, jpegQuality, concurrency, serveUrl, disallowParallelEncoding, everyNthFrame, imageFormat, numberOfGifLoops, dumpBrowserLogs, preferLossless, verbose, quality, logLevel, offthreadVideoCacheSizeInBytes, }: RenderMediaOptions) => Promise<RenderMediaResult>;
 export {};

package/dist/render-media.js

@@ -42,8 +42,9 @@ const validate_number_of_gif_loops_1 = require("./validate-number-of-gif-loops")
 const validate_output_filename_1 = require("./validate-output-filename");
 const validate_scale_1 = require("./validate-scale");
 const validate_videobitrate_1 = require("./validate-videobitrate");
+const x264_preset_1 = require("./x264-preset");
 const SLOWEST_FRAME_COUNT = 10;
-const internalRenderMedia = ({ proResProfile, crf, composition, serializedInputPropsWithCustomSchema, pixelFormat, codec, envVariables, frameRange, puppeteerInstance, outputLocation, onProgress, overwrite, onDownload, onBrowserLog, onStart, timeoutInMilliseconds, chromiumOptions, scale, browserExecutable, port, cancelSignal, muted, enforceAudioTrack, ffmpegOverride, audioBitrate, videoBitrate, audioCodec, concurrency, disallowParallelEncoding, everyNthFrame, imageFormat: provisionalImageFormat, indent, jpegQuality, numberOfGifLoops, onCtrlCExit, preferLossless, serveUrl, server: reusedServer, logLevel, serializedResolvedPropsWithCustomSchema, }) => {
+const internalRenderMedia = ({ proResProfile, x264Preset, crf, composition, serializedInputPropsWithCustomSchema, pixelFormat, codec, envVariables, frameRange, puppeteerInstance, outputLocation, onProgress, overwrite, onDownload, onBrowserLog, onStart, timeoutInMilliseconds, chromiumOptions, scale, browserExecutable, port, cancelSignal, muted, enforceAudioTrack, ffmpegOverride, audioBitrate, videoBitrate, audioCodec, concurrency, disallowParallelEncoding, everyNthFrame, imageFormat: provisionalImageFormat, indent, jpegQuality, numberOfGifLoops, onCtrlCExit, preferLossless, serveUrl, server: reusedServer, logLevel, serializedResolvedPropsWithCustomSchema, offthreadVideoCacheSizeInBytes, }) => {
     (0, jpeg_quality_1.validateJpegQuality)(jpegQuality);
     (0, crf_1.validateQualitySettings)({ crf, codec, videoBitrate });
     (0, validate_videobitrate_1.validateBitrate)(audioBitrate, 'audioBitrate');
@@ -52,6 +53,10 @@ const internalRenderMedia = ({ proResProfile, crf, composition, serializedInputP
         codec,
         proResProfile,
     });
+    (0, x264_preset_1.validateSelectedCodecAndPresetCombination)({
+        codec,
+        x264Preset,
+    });
     (0, pixel_format_1.validateSelectedPixelFormatAndCodecCombination)(pixelFormat, codec);
     if (outputLocation) {
         (0, validate_output_filename_1.validateOutputFilename)({
@@ -230,6 +235,7 @@ const internalRenderMedia = ({ proResProfile, crf, composition, serializedInputP
                 remotionRoot: (0, find_closest_package_json_1.findRemotionRoot)(),
                 logLevel,
                 webpackConfigOrServeUrl: serveUrl,
+                offthreadVideoCacheSizeInBytes: offthreadVideoCacheSizeInBytes !== null && offthreadVideoCacheSizeInBytes !== void 0 ? offthreadVideoCacheSizeInBytes : null,
             }, {
                 onDownload,
                 onError: (err) => reject(err),
@@ -293,6 +299,7 @@ const internalRenderMedia = ({ proResProfile, crf, composition, serializedInputP
                 indent,
                 server,
                 serializedResolvedPropsWithCustomSchema,
+                offthreadVideoCacheSizeInBytes,
             });
             return renderFramesProc;
         })
@@ -346,6 +353,7 @@ const internalRenderMedia = ({ proResProfile, crf, composition, serializedInputP
                     audioBitrate,
                     videoBitrate,
                     audioCodec,
+                    x264Preset: x264Preset !== null && x264Preset !== void 0 ? x264Preset : null,
                 }),
                 stitchStart,
             ]);
@@ -411,13 +419,14 @@ exports.internalRenderMedia = internalRenderMedia;
  * @description Render a video from a composition
  * @see [Documentation](https://www.remotion.dev/docs/renderer/render-media)
  */
-const renderMedia = ({ proResProfile, crf, composition, inputProps, pixelFormat, codec, envVariables, frameRange, puppeteerInstance, outputLocation, onProgress, overwrite, onDownload, onBrowserLog, onStart, timeoutInMilliseconds, chromiumOptions, scale, browserExecutable, port, cancelSignal, muted, enforceAudioTrack, ffmpegOverride, audioBitrate, videoBitrate, audioCodec, jpegQuality, concurrency, serveUrl, disallowParallelEncoding, everyNthFrame, imageFormat, numberOfGifLoops, dumpBrowserLogs, preferLossless, verbose, quality, logLevel, }) => {
+const renderMedia = ({ proResProfile, x264Preset, crf, composition, inputProps, pixelFormat, codec, envVariables, frameRange, puppeteerInstance, outputLocation, onProgress, overwrite, onDownload, onBrowserLog, onStart, timeoutInMilliseconds, chromiumOptions, scale, browserExecutable, port, cancelSignal, muted, enforceAudioTrack, ffmpegOverride, audioBitrate, videoBitrate, audioCodec, jpegQuality, concurrency, serveUrl, disallowParallelEncoding, everyNthFrame, imageFormat, numberOfGifLoops, dumpBrowserLogs, preferLossless, verbose, quality, logLevel, offthreadVideoCacheSizeInBytes, }) => {
     var _a, _b;
     if (quality !== undefined) {
         console.warn(`The "quality" option has been renamed. Please use "jpegQuality" instead.`);
     }
     return (0, exports.internalRenderMedia)({
         proResProfile: proResProfile !== null && proResProfile !== void 0 ? proResProfile : undefined,
+        x264Preset,
         codec,
         composition,
         serveUrl,
@@ -465,6 +474,7 @@ const renderMedia = ({ proResProfile, crf, composition, inputProps, pixelFormat,
             staticBase: null,
             data: (_b = composition.props) !== null && _b !== void 0 ? _b : {},
         }).serializedString,
+        offthreadVideoCacheSizeInBytes: offthreadVideoCacheSizeInBytes !== null && offthreadVideoCacheSizeInBytes !== void 0 ? offthreadVideoCacheSizeInBytes : null,
     });
 };
 exports.renderMedia = renderMedia;

package/dist/render-still.d.ts

@@ -8,6 +8,8 @@ import type { StillImageFormat } from './image-format';
 import type { LogLevel } from './log-level';
 import type { CancelSignal } from './make-cancel-signal';
 import type { ChromiumOptions } from './open-browser';
+import type { ToOptions } from './options/option';
+import type { optionsMap } from './options/options-map';
 import type { RemotionServer } from './prepare-server';
 type InternalRenderStillOptions = {
     composition: VideoConfig;
@@ -32,7 +34,8 @@ type InternalRenderStillOptions = {
     logLevel: LogLevel;
     serveUrl: string;
     port: number | null;
-};
+    offthreadVideoCacheSizeInBytes: number | null;
+} & ToOptions<typeof optionsMap.renderStill>;
 export type RenderStillOptions = {
     port?: number | null;
     composition: VideoConfig;
@@ -64,6 +67,7 @@ export type RenderStillOptions = {
      * @deprecated Renamed to `jpegQuality`
      */
     quality?: never;
+    offthreadVideoCacheSizeInBytes?: number | null;
 };
 type RenderStillReturnValue = {
     buffer: Buffer | null;

package/dist/render-still.js

@@ -204,6 +204,7 @@ const internalRenderStill = (options) => {
             concurrency: 1,
             logLevel: options.logLevel,
             indent: options.indent,
+            offthreadVideoCacheSizeInBytes: options.offthreadVideoCacheSizeInBytes,
         }, {
             onDownload: options.onDownload,
             onError,
@@ -247,7 +248,7 @@ exports.internalRenderStill = internalRenderStill;
  */
 const renderStill = (options) => {
     var _a, _b;
-    const { composition, serveUrl, browserExecutable, cancelSignal, chromiumOptions, dumpBrowserLogs, envVariables, frame, imageFormat, inputProps, jpegQuality, onBrowserLog, onDownload, output, overwrite, port, puppeteerInstance, scale, timeoutInMilliseconds, verbose, quality, } = options;
+    const { composition, serveUrl, browserExecutable, cancelSignal, chromiumOptions, dumpBrowserLogs, envVariables, frame, imageFormat, inputProps, jpegQuality, onBrowserLog, onDownload, output, overwrite, port, puppeteerInstance, scale, timeoutInMilliseconds, verbose, quality, offthreadVideoCacheSizeInBytes, } = options;
     if (typeof jpegQuality !== 'undefined' && imageFormat !== 'jpeg') {
         throw new Error("You can only pass the `quality` option if `imageFormat` is 'jpeg'.");
     }
@@ -285,6 +286,7 @@ const renderStill = (options) => {
             staticBase: null,
             data: (_b = composition.props) !== null && _b !== void 0 ? _b : {},
         }).serializedString,
+        offthreadVideoCacheSizeInBytes: offthreadVideoCacheSizeInBytes !== null && offthreadVideoCacheSizeInBytes !== void 0 ? offthreadVideoCacheSizeInBytes : null,
     });
 };
 exports.renderStill = renderStill;

package/dist/screenshot-dom-element.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 import type { ClipRegion } from 'remotion';
 import type { Page } from './browser/BrowserPage';
 import type { StillImageFormat } from './image-format';

package/dist/screenshot-task.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 import type { ClipRegion } from 'remotion';
 import type { Page } from './browser/BrowserPage';
 import type { StillImageFormat } from './image-format';

package/dist/select-composition.d.ts

@@ -4,6 +4,8 @@ import type { BrowserLog } from './browser-log';
 import type { HeadlessBrowser } from './browser/Browser';
 import { type LogLevel } from './log-level';
 import type { ChromiumOptions } from './open-browser';
+import type { ToOptions } from './options/option';
+import type { optionsMap } from './options/options-map';
 import type { RemotionServer } from './prepare-server';
 type InternalSelectCompositionsConfig = {
     serializedInputPropsWithCustomSchema: string;
@@ -19,7 +21,7 @@ type InternalSelectCompositionsConfig = {
     logLevel: LogLevel;
     serveUrl: string;
     id: string;
-};
+} & ToOptions<typeof optionsMap.renderStill>;
 export type SelectCompositionOptions = {
     inputProps?: Record<string, unknown> | null;
     envVariables?: Record<string, string>;
@@ -30,6 +32,7 @@ export type SelectCompositionOptions = {
     chromiumOptions?: ChromiumOptions;
     port?: number | null;
     verbose?: boolean;
+    offthreadVideoCacheSizeInBytes?: number | null;
     serveUrl: string;
     id: string;
 };

package/dist/select-composition.js

@@ -84,7 +84,7 @@ const innerSelectComposition = async ({ page, onBrowserLog, serializedInputProps
 };
 const internalSelectComposition = async (options) => {
     const cleanup = [];
-    const { puppeteerInstance, browserExecutable, chromiumOptions, serveUrl: serveUrlOrWebpackUrl, logLevel, indent, port, envVariables, id, serializedInputPropsWithCustomSchema, onBrowserLog, server, timeoutInMilliseconds, } = options;
+    const { puppeteerInstance, browserExecutable, chromiumOptions, serveUrl: serveUrlOrWebpackUrl, logLevel, indent, port, envVariables, id, serializedInputPropsWithCustomSchema, onBrowserLog, server, timeoutInMilliseconds, offthreadVideoCacheSizeInBytes, } = options;
     const { page, cleanup: cleanupPage } = await (0, get_browser_instance_1.getPageAndCleanupFn)({
         passedInInstance: puppeteerInstance,
         browserExecutable,
@@ -109,6 +109,7 @@ const internalSelectComposition = async (options) => {
             concurrency: 1,
             logLevel,
             indent,
+            offthreadVideoCacheSizeInBytes,
         }, {
             onDownload: () => undefined,
             onError,
@@ -131,6 +132,7 @@ const internalSelectComposition = async (options) => {
                 indent,
                 puppeteerInstance,
                 server,
+                offthreadVideoCacheSizeInBytes,
             });
         })
             .then((data) => {
@@ -152,6 +154,7 @@ exports.internalSelectComposition = internalSelectComposition;
  * @see [Documentation](https://www.remotion.dev/docs/renderer/select-composition)
  */
 const selectComposition = async (options) => {
+    var _a;
     const { id, serveUrl, browserExecutable, chromiumOptions, envVariables, inputProps, onBrowserLog, port, puppeteerInstance, timeoutInMilliseconds, verbose, } = options;
     const data = await (0, exports.internalSelectComposition)({
         id,
@@ -171,6 +174,7 @@ const selectComposition = async (options) => {
         logLevel: verbose ? 'verbose' : 'info',
         indent: false,
         server: undefined,
+        offthreadVideoCacheSizeInBytes: (_a = options.offthreadVideoCacheSizeInBytes) !== null && _a !== void 0 ? _a : null,
     });
     return data.metadata;
 };

package/dist/serve-static.d.ts

@@ -8,6 +8,7 @@ export declare const serveStatic: (path: string | null, options: {
     concurrency: number;
     logLevel: LogLevel;
     indent: boolean;
+    offthreadVideoCacheSizeInBytes: number | null;
 }) => Promise<{
     port: number;
     close: () => Promise<void>;

package/dist/serve-static.js

@@ -14,6 +14,7 @@ const serveStatic = async (path, options) => {
         concurrency: options.concurrency,
         logLevel: options.logLevel,
         indent: options.indent,
+        offthreadVideoCacheSizeInBytes: options.offthreadVideoCacheSizeInBytes,
     });
     const connections = {};
     const server = node_http_1.default.createServer((request, response) => {

package/dist/stitch-frames-to-video.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 import type { RenderMediaOnDownload } from './assets/download-and-map-assets-to-file';
 import type { RenderAssetInfo } from './assets/download-map';
 import type { AudioCodec } from './audio-codec';
@@ -8,6 +7,7 @@ import type { LogLevel } from './log-level';
 import type { CancelSignal } from './make-cancel-signal';
 import type { PixelFormat } from './pixel-format';
 import type { ProResProfile } from './prores-profile';
+import type { X264Preset } from './x264-preset';
 type InternalStitchFramesToVideoOptions = {
     audioBitrate: string | null;
     videoBitrate: string | null;
@@ -32,6 +32,7 @@ type InternalStitchFramesToVideoOptions = {
     preferLossless: boolean;
     indent: boolean;
     muted: boolean;
+    x264Preset: X264Preset | null;
     enforceAudioTrack: boolean;
     ffmpegOverride: null | FfmpegOverrideFn;
 };
@@ -58,11 +59,12 @@ export type StitchFramesToVideoOptions = {
     muted?: boolean;
     enforceAudioTrack?: boolean;
     ffmpegOverride?: FfmpegOverrideFn;
+    x264Preset?: X264Preset | null;
 };
 export declare const internalStitchFramesToVideo: (options: InternalStitchFramesToVideoOptions) => Promise<Buffer | null>;
 /**
  * @description Takes a series of images and audio information generated by renderFrames() and encodes it to a video.
  * @see [Documentation](https://www.remotion.dev/docs/renderer/stitch-frames-to-video)
  */
-export declare const stitchFramesToVideo: ({ assetsInfo, force, fps, height, width, audioBitrate, audioCodec, cancelSignal, codec, crf, dir, enforceAudioTrack, ffmpegOverride, muted, numberOfGifLoops, onDownload, onProgress, outputLocation, pixelFormat, proResProfile, verbose, videoBitrate, }: StitchFramesToVideoOptions) => Promise<Buffer | null>;
+export declare const stitchFramesToVideo: ({ assetsInfo, force, fps, height, width, audioBitrate, audioCodec, cancelSignal, codec, crf, dir, enforceAudioTrack, ffmpegOverride, muted, numberOfGifLoops, onDownload, onProgress, outputLocation, pixelFormat, proResProfile, verbose, videoBitrate, x264Preset, }: StitchFramesToVideoOptions) => Promise<Buffer | null>;
 export {};