webcodecs-node 0.7.2 → 0.8.5

package/dist/backends/node-av/video/encoder/options.js

@@ -0,0 +1,195 @@
+/**
+ * Encoder options building utilities
+ *
+ * Builds codec-specific encoder options for x264/x265, VP8/VP9, and SVT-AV1
+ */
+import { Rational } from 'node-av/lib';
+import { DEFAULT_FRAMERATE, DEFAULT_VP_BITRATE, CRF_DEFAULTS, } from '../../../types.js';
+import { getQualityConfig } from '../../../../config/webcodecs-config.js';
+/**
+ * Configure VP8/VP9 encoder options
+ */
+export function configureVpxOptions(options, config) {
+    if (config.latencyMode === 'realtime') {
+        options.deadline = 'realtime';
+        options['cpu-used'] = '8';
+        options['lag-in-frames'] = '0';
+    }
+    else {
+        options.deadline = 'good';
+        options['cpu-used'] = '4';
+    }
+    // Apply contentHint to optimize for content type
+    if (config.contentHint === 'text' || config.contentHint === 'detail') {
+        // Text/detail: lower cpu-used for higher quality (slower encoding)
+        const currentCpuUsed = Number(options['cpu-used'] ?? '4');
+        options['cpu-used'] = String(Math.max(0, currentCpuUsed - 2));
+    }
+    // 'motion' uses default settings optimized for video content
+}
+/**
+ * Configure SVT-AV1 encoder options
+ */
+export function configureSvtAv1Options(options, config) {
+    if (config.latencyMode === 'realtime') {
+        options.preset = '10';
+    }
+    else {
+        options.preset = '6';
+    }
+    // Apply AV1-specific options from config
+    if (config.av1?.forceScreenContentTools) {
+        // Enable screen content tools for better compression of screen content
+        // This enables palette mode and intra block copy which are useful for screen sharing
+        options['enable-screen-content-mode'] = '1';
+    }
+    // Apply contentHint to optimize encoder for content type
+    if (config.contentHint === 'text') {
+        // Text/graphics content: enable screen content tools for better compression
+        options['enable-screen-content-mode'] = '1';
+    }
+    else if (config.contentHint === 'detail') {
+        // Detail mode: prioritize quality over speed
+        const currentPreset = Number(options.preset ?? '6');
+        options.preset = String(Math.max(0, currentPreset - 2)); // Lower preset = higher quality
+    }
+    // 'motion' uses default settings optimized for video content
+}
+/**
+ * Configure x264/x265 encoder options (software and hardware variants)
+ */
+export function configureX26xOptions(options, config, hwType) {
+    if (config.latencyMode === 'realtime') {
+        if (hwType === 'cuda') {
+            // NVENC presets: p1 (fastest) to p7 (slowest), or 'fast'/'medium'/'slow'
+            options.preset = 'p1';
+        }
+        else if (hwType === 'qsv') {
+            options.preset = 'veryfast';
+        }
+        else if (hwType === 'vaapi') {
+            // VAAPI: lower quality = faster encoding, low QP for better quality
+            options.quality = '0';
+        }
+        else if (!hwType) {
+            // Software x264/x265
+            options.preset = 'ultrafast';
+        }
+    }
+    else {
+        if (hwType === 'cuda') {
+            // NVENC: p4 is a good balance
+            options.preset = 'p4';
+        }
+        else if (hwType === 'qsv') {
+            options.preset = 'medium';
+        }
+        else if (hwType === 'vaapi') {
+            // VAAPI: higher quality setting
+            options.quality = '4';
+        }
+        else if (!hwType) {
+            // Software x264/x265
+            options.preset = 'medium';
+        }
+    }
+    // Configure rate control based on hardware type and bitrate mode
+    const bitrate = config.bitrate;
+    if (bitrate && config.bitrateMode !== 'quantizer') {
+        if (hwType === 'vaapi') {
+            // VAAPI: Use CQP mode with low QP for high quality
+            // Note: node-av doesn't properly pass bitrate to VAAPI, so we use quality-based encoding
+            // QP 20 gives good quality (lower = higher quality, range 0-51)
+            options.qp = 20;
+        }
+        else if (hwType === 'cuda') {
+            // NVENC: Use VBR mode
+            options.rc = 'vbr';
+        }
+        else if (hwType === 'qsv') {
+            // QSV: Use VBR mode
+            options.preset = options.preset ?? 'medium';
+        }
+        else {
+            // Software x264/x265: Set VBV maxrate and bufsize for proper bitrate control
+            // bufsize = 2x bitrate gives ~2 second buffer, good for streaming
+            options.maxrate = String(bitrate);
+            options.bufsize = String(bitrate * 2);
+        }
+    }
+    // Apply contentHint for software x264/x265 (tune parameter)
+    if (!hwType && config.contentHint) {
+        if (config.contentHint === 'text') {
+            // Text/graphics: use stillimage tune for sharp edges
+            options.tune = 'stillimage';
+        }
+        else if (config.contentHint === 'detail') {
+            // Detail mode: use ssim tune for quality preservation
+            options.tune = 'ssim';
+        }
+        else if (config.contentHint === 'motion') {
+            // Motion content: use film tune (default video optimization)
+            options.tune = 'film';
+        }
+    }
+}
+/**
+ * Build complete encoder options for a given codec
+ */
+export function buildEncoderOptions(config, codecName, inputPixelFormat, timeBase, hardware) {
+    const framerate = config.framerate ?? DEFAULT_FRAMERATE;
+    const gopSize = Math.max(1, framerate);
+    const options = {};
+    const isVpCodec = codecName === 'vp8' || codecName === 'vp9';
+    const isAv1 = codecName === 'av1';
+    const hwType = hardware?.deviceTypeName;
+    const qualityOverrides = getQualityConfig(codecName);
+    // Codec-specific options
+    if (isVpCodec) {
+        configureVpxOptions(options, config);
+    }
+    else if (isAv1) {
+        configureSvtAv1Options(options, config);
+    }
+    else {
+        configureX26xOptions(options, config, hwType);
+    }
+    // Quality mode
+    if (qualityOverrides.crf !== undefined) {
+        options.crf = String(qualityOverrides.crf);
+    }
+    else if (config.bitrateMode === 'quantizer') {
+        const crf = CRF_DEFAULTS[codecName];
+        if (crf) {
+            options.crf = String(crf);
+        }
+    }
+    // Explicit preset overrides codec defaults when supported
+    // Note: Different encoders use different preset names:
+    // - x264/x265: ultrafast, superfast, veryfast, faster, fast, medium, slow, slower, veryslow
+    // - NVENC: p1-p7 (or fast, medium, slow)
+    // - QSV: veryfast, faster, fast, medium, slow, slower, veryslow
+    // We only apply user preset if no hardware (software encoder) to avoid compatibility issues
+    if (qualityOverrides.preset && !hwType) {
+        options.preset = qualityOverrides.preset;
+    }
+    // Bitrate (required for VP/AV1)
+    let bitrate = config.bitrate;
+    if (!bitrate && (isVpCodec || isAv1)) {
+        bitrate = DEFAULT_VP_BITRATE;
+    }
+    return {
+        type: 'video',
+        width: config.width,
+        height: config.height,
+        pixelFormat: inputPixelFormat,
+        timeBase,
+        frameRate: new Rational(framerate, 1),
+        bitrate,
+        gopSize,
+        maxBFrames: config.latencyMode === 'realtime' ? 0 : undefined,
+        hardware: hardware ?? undefined,
+        options,
+    };
+}
+//# sourceMappingURL=options.js.map

package/dist/backends/node-av/video/encoder/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../../../src/backends/node-av/video/encoder/options.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAKvC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,GACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAgB1E;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAwC,EACxC,MAAiC;IAEjC,IAAI,MAAM,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;QACtC,OAAO,CAAC,QAAQ,GAAG,UAAU,CAAC;QAC9B,OAAO,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC;QAC1B,OAAO,CAAC,eAAe,CAAC,GAAG,GAAG,CAAC;IACjC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC;QAC1B,OAAO,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC;IAC5B,CAAC;IAED,iDAAiD;IACjD,IAAI,MAAM,CAAC,WAAW,KAAK,MAAM,IAAI,MAAM,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;QACrE,mEAAmE;QACnE,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC;QAC1D,OAAO,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC;IAChE,CAAC;IACD,6DAA6D;AAC/D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAwC,EACxC,MAAiC;IAEjC,IAAI,MAAM,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;QACtC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IACxB,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC;IACvB,CAAC;IAED,yCAAyC;IACzC,IAAI,MAAM,CAAC,GAAG,EAAE,uBAAuB,EAAE,CAAC;QACxC,uEAAuE;QACvE,qFAAqF;QACrF,OAAO,CAAC,4BAA4B,CAAC,GAAG,GAAG,CAAC;IAC9C,CAAC;IAED,yDAAyD;IACzD,IAAI,MAAM,CAAC,WAAW,KAAK,MAAM,EAAE,CAAC;QAClC,4EAA4E;QAC5E,OAAO,CAAC,4BAA4B,CAAC,GAAG,GAAG,CAAC;IAC9C,CAAC;SAAM,IAAI,MAAM,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;QAC3C,6CAA6C;QAC7C,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC;QACpD,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,gCAAgC;IAC3F,CAAC;IACD,6DAA6D;AAC/D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAwC,EACxC,MAAiC,EACjC,MAAe;IAEf,IAAI,MAAM,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;QACtC,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YACtB,yEAAyE;YACzE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;QACxB,CAAC;aAAM,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;YAC5B,OAAO,CAAC,MAAM,GAAG,UAAU,CAAC;QAC9B,CAAC;aAAM,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YAC9B,oEAAoE;YACpE,OAAO,CAAC,OAAO,GAAG,GAAG,CAAC;QACxB,CAAC;aAAM,IAAI,CAAC,MAAM,EAAE,CAAC;YACnB,qBAAqB;YACrB,OAAO,CAAC,MAAM,GAAG,WAAW,CAAC;QAC/B,CAAC;IACH,CAAC;SAAM,CAAC;QACN,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YACtB,8BAA8B;YAC9B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;QACxB,CAAC;aAAM,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;YAC5B,OAAO,CAAC,MAAM,GAAG,QAAQ,CAAC;QAC5B,CAAC;aAAM,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YAC9B,gCAAgC;YAChC,OAAO,CAAC,OAAO,GAAG,GAAG,CAAC;QACxB,CAAC;aAAM,IAAI,CAAC,MAAM,EAAE,CAAC;YACnB,qBAAqB;YACrB,OAAO,CAAC,MAAM,GAAG,QAAQ,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,iEAAiE;IACjE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,IAAI,OAAO,IAAI,MAAM,CAAC,WAAW,KAAK,WAAW,EAAE,CAAC;QAClD,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,mDAAmD;YACnD,yFAAyF;YACzF,gEAAgE;YAChE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;QAClB,CAAC;aAAM,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YAC7B,sBAAsB;YACtB,OAAO,CAAC,EAAE,GAAG,KAAK,CAAC;QACrB,CAAC;aAAM,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;YAC5B,oBAAoB;YACpB,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,QAAQ,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,6EAA6E;YAC7E,kEAAkE;YAClE,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;YAClC,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,4DAA4D;IAC5D,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QAClC,IAAI,MAAM,CAAC,WAAW,KAAK,MAAM,EAAE,CAAC;YAClC,qDAAqD;YACrD,OAAO,CAAC,IAAI,GAAG,YAAY,CAAC;QAC9B,CAAC;aAAM,IAAI,MAAM,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;YAC3C,sDAAsD;YACtD,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC;QACxB,CAAC;aAAM,IAAI,MAAM,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;YAC3C,6DAA6D;YAC7D,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC;QACxB,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAiC,EACjC,SAAiB,EACjB,gBAA+B,EAC/B,QAAkB,EAClB,QAAgC;IAEhC,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,iBAAiB,CAAC;IACxD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IACvC,MAAM,OAAO,GAAoC,EAAE,CAAC;IACpD,MAAM,SAAS,GAAG,SAAS,KAAK,KAAK,IAAI,SAAS,KAAK,KAAK,CAAC;IAC7D,MAAM,KAAK,GAAG,SAAS,KAAK,KAAK,CAAC;IAClC,MAAM,MAAM,GAAG,QAAQ,EAAE,cAAc,CAAC;IACxC,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAErD,yBAAyB;IACzB,IAAI,SAAS,EAAE,CAAC;QACd,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;SAAM,IAAI,KAAK,EAAE,CAAC;QACjB,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;SAAM,CAAC;QACN,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IAED,eAAe;IACf,IAAI,gBAAgB,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QACvC,OAAO,CAAC,GAAG,GAAG,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC;SAAM,IAAI,MAAM,CAAC,WAAW,KAAK,WAAW,EAAE,CAAC;QAC9C,MAAM,GAAG,GAAG,YAAY,CAAC,SAAsC,CAAC,CAAC;QACjE,IAAI,GAAG,EAAE,CAAC;YACR,OAAO,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,0DAA0D;IAC1D,uDAAuD;IACvD,4FAA4F;IAC5F,yCAAyC;IACzC,gEAAgE;IAChE,4FAA4F;IAC5F,IAAI,gBAAgB,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QACvC,OAAO,CAAC,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC;IAC3C,CAAC;IAED,gCAAgC;IAChC,IAAI,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC7B,IAAI,CAAC,OAAO,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC,EAAE,CAAC;QACrC,OAAO,GAAG,kBAAkB,CAAC;IAC/B,CAAC;IAED,OAAO;QACL,IAAI,EAAE,OAAgB;QACtB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,WAAW,EAAE,gBAAgB;QAC7B,QAAQ;QACR,SAAS,EAAE,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC;QACrC,OAAO;QACP,OAAO;QACP,UAAU,EAAE,MAAM,CAAC,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;QAC7D,QAAQ,EAAE,QAAQ,IAAI,SAAS;QAC/B,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/backends/node-av/video/encoder/pixel-format-config.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Pixel format configuration for encoding
+ *
+ * Determines the optimal encoder pixel format based on:
+ * - Input pixel format (8-bit, 10-bit, alpha)
+ * - Codec capabilities (VP9 alpha, HEVC 10-bit, etc.)
+ * - Hardware vs software encoding
+ */
+import { type AVPixelFormat } from 'node-av/constants';
+export interface PixelFormatConfig {
+    /** The pixel format the encoder should use */
+    encoderPixelFormat: AVPixelFormat;
+    /** Whether format conversion is needed */
+    needsFormatConversion: boolean;
+    /** Target format name for filter chain (e.g., 'nv12', 'yuv420p') */
+    targetFormatName: string;
+}
+/**
+ * Check if pixel format has alpha channel
+ */
+export declare function hasAlphaChannel(pixelFormat: AVPixelFormat): boolean;
+/**
+ * Check if pixel format is 10-bit
+ */
+export declare function is10BitFormat(pixelFormat: AVPixelFormat): boolean;
+/**
+ * Check if codec supports alpha channel encoding
+ * Only VP9 software supports alpha (via YUVA420P)
+ */
+export declare function codecSupportsAlpha(codecName: string, isHardware: boolean): boolean;
+/**
+ * Check if codec supports 10-bit encoding
+ */
+export declare function codecSupports10Bit(codecName: string): boolean;
+/**
+ * Configure the optimal encoder pixel format
+ *
+ * Determines the best pixel format based on input format, codec capabilities,
+ * and hardware/software mode. Logs warnings for format conversions that lose quality.
+ */
+export declare function configureEncoderPixelFormat(inputPixelFormat: AVPixelFormat, codecName: string, isHardware: boolean, keepAlpha: boolean): PixelFormatConfig;
+//# sourceMappingURL=pixel-format-config.d.ts.map

package/dist/backends/node-av/video/encoder/pixel-format-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixel-format-config.d.ts","sourceRoot":"","sources":["../../../../../src/backends/node-av/video/encoder/pixel-format-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAUL,KAAK,aAAa,EACnB,MAAM,mBAAmB,CAAC;AAM3B,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,kBAAkB,EAAE,aAAa,CAAC;IAClC,0CAA0C;IAC1C,qBAAqB,EAAE,OAAO,CAAC;IAC/B,oEAAoE;IACpE,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,aAAa,GAAG,OAAO,CAMnE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,aAAa,GAAG,OAAO,CAOjE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,OAAO,CAElF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE7D;AAoBD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,gBAAgB,EAAE,aAAa,EAC/B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,OAAO,EACnB,SAAS,EAAE,OAAO,GACjB,iBAAiB,CA4DnB"}

package/dist/backends/node-av/video/encoder/pixel-format-config.js

@@ -0,0 +1,122 @@
+/**
+ * Pixel format configuration for encoding
+ *
+ * Determines the optimal encoder pixel format based on:
+ * - Input pixel format (8-bit, 10-bit, alpha)
+ * - Codec capabilities (VP9 alpha, HEVC 10-bit, etc.)
+ * - Hardware vs software encoding
+ */
+import { AV_PIX_FMT_NV12, AV_PIX_FMT_RGBA, AV_PIX_FMT_BGRA, AV_PIX_FMT_YUV420P, AV_PIX_FMT_YUVA420P, AV_PIX_FMT_YUV420P10LE, AV_PIX_FMT_YUV422P10LE, AV_PIX_FMT_YUV444P10LE, AV_PIX_FMT_P010LE, } from 'node-av/constants';
+import { createLogger } from '../../../../utils/logger.js';
+const logger = createLogger('pixel-format-config');
+/**
+ * Check if pixel format has alpha channel
+ */
+export function hasAlphaChannel(pixelFormat) {
+    return (pixelFormat === AV_PIX_FMT_YUVA420P ||
+        pixelFormat === AV_PIX_FMT_RGBA ||
+        pixelFormat === AV_PIX_FMT_BGRA);
+}
+/**
+ * Check if pixel format is 10-bit
+ */
+export function is10BitFormat(pixelFormat) {
+    return (pixelFormat === AV_PIX_FMT_YUV420P10LE ||
+        pixelFormat === AV_PIX_FMT_YUV422P10LE ||
+        pixelFormat === AV_PIX_FMT_YUV444P10LE ||
+        pixelFormat === AV_PIX_FMT_P010LE);
+}
+/**
+ * Check if codec supports alpha channel encoding
+ * Only VP9 software supports alpha (via YUVA420P)
+ */
+export function codecSupportsAlpha(codecName, isHardware) {
+    return codecName === 'vp9' && !isHardware;
+}
+/**
+ * Check if codec supports 10-bit encoding
+ */
+export function codecSupports10Bit(codecName) {
+    return codecName === 'hevc' || codecName === 'vp9' || codecName === 'av1';
+}
+/**
+ * Get the format name string for filter chains
+ */
+function getFormatName(pixelFormat) {
+    switch (pixelFormat) {
+        case AV_PIX_FMT_NV12:
+            return 'nv12';
+        case AV_PIX_FMT_YUVA420P:
+            return 'yuva420p';
+        case AV_PIX_FMT_YUV420P10LE:
+            return 'yuv420p10le';
+        case AV_PIX_FMT_P010LE:
+            return 'p010le';
+        default:
+            return 'yuv420p';
+    }
+}
+/**
+ * Configure the optimal encoder pixel format
+ *
+ * Determines the best pixel format based on input format, codec capabilities,
+ * and hardware/software mode. Logs warnings for format conversions that lose quality.
+ */
+export function configureEncoderPixelFormat(inputPixelFormat, codecName, isHardware, keepAlpha) {
+    const inputHasAlpha = hasAlphaChannel(inputPixelFormat);
+    const inputIs10Bit = is10BitFormat(inputPixelFormat);
+    const canEncodeAlpha = codecSupportsAlpha(codecName, isHardware);
+    const canEncode10Bit = codecSupports10Bit(codecName);
+    let encoderPixelFormat;
+    if (keepAlpha && inputHasAlpha && canEncodeAlpha) {
+        // VP9 software with alpha
+        encoderPixelFormat = AV_PIX_FMT_YUVA420P;
+        logger.debug(`Alpha channel will be preserved (codec: ${codecName})`);
+    }
+    else if (inputIs10Bit && canEncode10Bit && !isHardware) {
+        // 10-bit software encoding
+        encoderPixelFormat = AV_PIX_FMT_YUV420P10LE;
+        logger.debug(`10-bit encoding enabled (codec: ${codecName})`);
+        // Warn about chroma subsampling changes
+        if (inputPixelFormat === AV_PIX_FMT_YUV422P10LE) {
+            logger.warn(`10-bit 4:2:2 (I422P10) input will be downconverted to 4:2:0 (I420P10) - chroma resolution reduced`);
+        }
+        else if (inputPixelFormat === AV_PIX_FMT_YUV444P10LE) {
+            logger.warn(`10-bit 4:4:4 (I444P10) input will be downconverted to 4:2:0 (I420P10) - chroma resolution reduced`);
+        }
+        if (keepAlpha && inputHasAlpha) {
+            logger.warn(`Alpha requested with 10-bit input but 10-bit alpha not supported - discarding alpha`);
+        }
+    }
+    else if (inputIs10Bit && isHardware) {
+        // Hardware 10-bit: use P010 (semi-planar 10-bit)
+        encoderPixelFormat = AV_PIX_FMT_P010LE;
+        logger.debug(`Hardware 10-bit encoding using P010`);
+        if (keepAlpha && inputHasAlpha) {
+            logger.warn(`Alpha requested but hardware encoders don't support alpha - discarding`);
+        }
+    }
+    else if (isHardware) {
+        // Hardware 8-bit: NV12
+        encoderPixelFormat = AV_PIX_FMT_NV12;
+        if (keepAlpha && inputHasAlpha) {
+            logger.warn(`Alpha requested but hardware encoders don't support alpha - discarding`);
+        }
+    }
+    else {
+        // Software 8-bit: YUV420P
+        encoderPixelFormat = AV_PIX_FMT_YUV420P;
+        if (keepAlpha && inputHasAlpha) {
+            logger.warn(`Alpha requested but ${codecName} doesn't support alpha - discarding`);
+        }
+        if (inputIs10Bit) {
+            logger.warn(`10-bit input but ${codecName} doesn't support 10-bit - downconverting to 8-bit`);
+        }
+    }
+    return {
+        encoderPixelFormat,
+        needsFormatConversion: inputPixelFormat !== encoderPixelFormat,
+        targetFormatName: getFormatName(encoderPixelFormat),
+    };
+}
+//# sourceMappingURL=pixel-format-config.js.map

package/dist/backends/node-av/video/encoder/pixel-format-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixel-format-config.js","sourceRoot":"","sources":["../../../../../src/backends/node-av/video/encoder/pixel-format-config.ts"],"names":[],"mappings":"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"}

package/dist/backends/node-av/video/encoder/pixel-format.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Pixel format mapping utilities for video encoding
+ */
+import { type AVPixelFormat } from 'node-av/constants';
+/**
+ * Get human-readable name for AVPixelFormat
+ */
+export declare function pixelFormatName(fmt: AVPixelFormat): string;
+/**
+ * Map WebCodecs pixel format string to AVPixelFormat
+ */
+export declare function mapPixelFormat(format: string): AVPixelFormat;
+//# sourceMappingURL=pixel-format.d.ts.map

package/dist/backends/node-av/video/encoder/pixel-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixel-format.d.ts","sourceRoot":"","sources":["../../../../../src/backends/node-av/video/encoder/pixel-format.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAYL,KAAK,aAAa,EACnB,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAe1D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAwC5D"}

package/dist/backends/node-av/video/encoder/pixel-format.js

@@ -0,0 +1,68 @@
+/**
+ * Pixel format mapping utilities for video encoding
+ */
+import { AV_PIX_FMT_BGRA, AV_PIX_FMT_NV12, AV_PIX_FMT_RGBA, AV_PIX_FMT_YUV420P, AV_PIX_FMT_YUV422P, AV_PIX_FMT_YUV444P, AV_PIX_FMT_YUVA420P, AV_PIX_FMT_YUV420P10LE, AV_PIX_FMT_YUV422P10LE, AV_PIX_FMT_YUV444P10LE, AV_PIX_FMT_P010LE, } from 'node-av/constants';
+/**
+ * Get human-readable name for AVPixelFormat
+ */
+export function pixelFormatName(fmt) {
+    switch (fmt) {
+        case AV_PIX_FMT_YUV420P: return 'yuv420p';
+        case AV_PIX_FMT_YUVA420P: return 'yuva420p';
+        case AV_PIX_FMT_YUV422P: return 'yuv422p';
+        case AV_PIX_FMT_YUV444P: return 'yuv444p';
+        case AV_PIX_FMT_NV12: return 'nv12';
+        case AV_PIX_FMT_RGBA: return 'rgba';
+        case AV_PIX_FMT_BGRA: return 'bgra';
+        case AV_PIX_FMT_YUV420P10LE: return 'yuv420p10le';
+        case AV_PIX_FMT_YUV422P10LE: return 'yuv422p10le';
+        case AV_PIX_FMT_YUV444P10LE: return 'yuv444p10le';
+        case AV_PIX_FMT_P010LE: return 'p010le';
+        default: return 'unknown';
+    }
+}
+/**
+ * Map WebCodecs pixel format string to AVPixelFormat
+ */
+export function mapPixelFormat(format) {
+    const fmt = format.toUpperCase();
+    switch (fmt) {
+        case 'I420':
+        case 'YUV420P':
+            return AV_PIX_FMT_YUV420P;
+        case 'I420A':
+        case 'YUVA420P':
+            return AV_PIX_FMT_YUVA420P;
+        case 'I422':
+        case 'YUV422P':
+            return AV_PIX_FMT_YUV422P;
+        case 'I444':
+        case 'YUV444P':
+            return AV_PIX_FMT_YUV444P;
+        case 'NV12':
+            return AV_PIX_FMT_NV12;
+        case 'BGRA':
+            return AV_PIX_FMT_BGRA;
+        case 'RGBA':
+            return AV_PIX_FMT_RGBA;
+        // 10-bit formats
+        case 'I420P10':
+        case 'YUV420P10LE':
+        case 'YUV420P10':
+            return AV_PIX_FMT_YUV420P10LE;
+        case 'I422P10':
+        case 'YUV422P10LE':
+        case 'YUV422P10':
+            return AV_PIX_FMT_YUV422P10LE;
+        case 'I444P10':
+        case 'YUV444P10LE':
+        case 'YUV444P10':
+            return AV_PIX_FMT_YUV444P10LE;
+        case 'P010':
+        case 'P010LE':
+            return AV_PIX_FMT_P010LE;
+        default:
+            return AV_PIX_FMT_YUV420P;
+    }
+}
+//# sourceMappingURL=pixel-format.js.map

package/dist/backends/node-av/video/encoder/pixel-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixel-format.js","sourceRoot":"","sources":["../../../../../src/backends/node-av/video/encoder/pixel-format.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,eAAe,EACf,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,GAElB,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,GAAkB;IAChD,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,kBAAkB,CAAC,CAAC,OAAO,SAAS,CAAC;QAC1C,KAAK,mBAAmB,CAAC,CAAC,OAAO,UAAU,CAAC;QAC5C,KAAK,kBAAkB,CAAC,CAAC,OAAO,SAAS,CAAC;QAC1C,KAAK,kBAAkB,CAAC,CAAC,OAAO,SAAS,CAAC;QAC1C,KAAK,eAAe,CAAC,CAAC,OAAO,MAAM,CAAC;QACpC,KAAK,eAAe,CAAC,CAAC,OAAO,MAAM,CAAC;QACpC,KAAK,eAAe,CAAC,CAAC,OAAO,MAAM,CAAC;QACpC,KAAK,sBAAsB,CAAC,CAAC,OAAO,aAAa,CAAC;QAClD,KAAK,sBAAsB,CAAC,CAAC,OAAO,aAAa,CAAC;QAClD,KAAK,sBAAsB,CAAC,CAAC,OAAO,aAAa,CAAC;QAClD,KAAK,iBAAiB,CAAC,CAAC,OAAO,QAAQ,CAAC;QACxC,OAAO,CAAC,CAAC,OAAO,SAAS,CAAC;IAC5B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACjC,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,MAAM,CAAC;QACZ,KAAK,SAAS;YACZ,OAAO,kBAAkB,CAAC;QAC5B,KAAK,OAAO,CAAC;QACb,KAAK,UAAU;YACb,OAAO,mBAAmB,CAAC;QAC7B,KAAK,MAAM,CAAC;QACZ,KAAK,SAAS;YACZ,OAAO,kBAAkB,CAAC;QAC5B,KAAK,MAAM,CAAC;QACZ,KAAK,SAAS;YACZ,OAAO,kBAAkB,CAAC;QAC5B,KAAK,MAAM;YACT,OAAO,eAAe,CAAC;QACzB,KAAK,MAAM;YACT,OAAO,eAAe,CAAC;QACzB,KAAK,MAAM;YACT,OAAO,eAAe,CAAC;QACzB,iBAAiB;QACjB,KAAK,SAAS,CAAC;QACf,KAAK,aAAa,CAAC;QACnB,KAAK,WAAW;YACd,OAAO,sBAAsB,CAAC;QAChC,KAAK,SAAS,CAAC;QACf,KAAK,aAAa,CAAC;QACnB,KAAK,WAAW;YACd,OAAO,sBAAsB,CAAC;QAChC,KAAK,SAAS,CAAC;QACf,KAAK,aAAa,CAAC;QACnB,KAAK,WAAW;YACd,OAAO,sBAAsB,CAAC;QAChC,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ;YACX,OAAO,iBAAiB,CAAC;QAC3B;YACE,OAAO,kBAAkB,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/dist/backends/node-av/video/encoder/setup.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Encoder setup utilities
+ *
+ * Handles encoder codec selection (hardware vs software)
+ * and hardware context management.
+ */
+import type { HardwareContext } from 'node-av/api';
+import type { FFEncoderCodec } from 'node-av/constants';
+/** Encoder codec type - FFEncoderCodec string or any hardware codec object */
+export type EncoderCodec = FFEncoderCodec | any;
+export interface EncoderSelection {
+    /** The FFmpeg encoder codec to use */
+    encoderCodec: EncoderCodec;
+    /** Whether this is a hardware encoder */
+    isHardware: boolean;
+    /** Hardware context if using hardware acceleration */
+    hardware: HardwareContext | null;
+}
+/**
+ * Select the best encoder codec based on configuration
+ *
+ * Tries hardware encoder first if available and resolution meets minimum requirements,
+ * falls back to software encoder otherwise.
+ */
+export declare function selectEncoderCodec(codecName: string, width: number, height: number, hardwarePreference?: 'no-preference' | 'prefer-hardware' | 'prefer-software'): Promise<EncoderSelection>;
+/**
+ * Handle hardware encoder failure by falling back to software
+ */
+export declare function fallbackToSoftware(codecName: string, hardware: HardwareContext | null): {
+    encoderCodec: FFEncoderCodec;
+    hardware: null;
+};
+//# sourceMappingURL=setup.d.ts.map

package/dist/backends/node-av/video/encoder/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../../../src/backends/node-av/video/encoder/setup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAUxD,8EAA8E;AAE9E,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG,GAAG,CAAC;AAEhD,MAAM,WAAW,gBAAgB;IAC/B,sCAAsC;IACtC,YAAY,EAAE,YAAY,CAAC;IAC3B,yCAAyC;IACzC,UAAU,EAAE,OAAO,CAAC;IACpB,sDAAsD;IACtD,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;CAClC;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,kBAAkB,CAAC,EAAE,eAAe,GAAG,iBAAiB,GAAG,iBAAiB,GAC3E,OAAO,CAAC,gBAAgB,CAAC,CAiC3B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,eAAe,GAAG,IAAI,GAC/B;IAAE,YAAY,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,IAAI,CAAA;CAAE,CAOlD"}

package/dist/backends/node-av/video/encoder/setup.js

@@ -0,0 +1,62 @@
+/**
+ * Encoder setup utilities
+ *
+ * Handles encoder codec selection (hardware vs software)
+ * and hardware context management.
+ */
+import { getBestEncoderSync } from '../../../../hardware/index.js';
+import { acquireHardwareContext, releaseHardwareContext } from '../../../../utils/hardware-pool.js';
+import { createLogger } from '../../../../utils/logger.js';
+import { getSoftwareEncoder } from './software-encoders.js';
+import { getHardwareMinResolution } from './hardware-constraints.js';
+const logger = createLogger('encoder-setup');
+/**
+ * Select the best encoder codec based on configuration
+ *
+ * Tries hardware encoder first if available and resolution meets minimum requirements,
+ * falls back to software encoder otherwise.
+ */
+export async function selectEncoderCodec(codecName, width, height, hardwarePreference) {
+    // Use the unified hardware detection system which respects webcodecs-config.js
+    const bestEncoder = getBestEncoderSync(codecName, hardwarePreference);
+    if (bestEncoder.isHardware && bestEncoder.hwaccel) {
+        // Check if resolution meets hardware encoder minimum requirements
+        // VAAPI/QSV have known minimum constraints that vary by codec
+        const minSize = getHardwareMinResolution(bestEncoder.hwaccel, codecName);
+        if (width < minSize.width || height < minSize.height) {
+            logger.info(`Resolution ${width}x${height} below hardware minimum ${minSize.width}x${minSize.height}, using software encoder`);
+        }
+        else {
+            try {
+                // Use pooled hardware context
+                const hardware = acquireHardwareContext(bestEncoder.hwaccel);
+                if (hardware) {
+                    const hwCodec = hardware.getEncoderCodec(codecName);
+                    if (hwCodec) {
+                        logger.info(`Using hardware encoder: ${bestEncoder.encoder} (${hardware.deviceTypeName})`);
+                        return { encoderCodec: hwCodec, isHardware: true, hardware };
+                    }
+                }
+            }
+            catch {
+                // Fall through to software if hardware failed
+            }
+            logger.warn(`Hardware encoder ${bestEncoder.encoder} failed, falling back to software`);
+        }
+    }
+    const softwareCodec = getSoftwareEncoder(codecName);
+    logger.info(`Using software encoder: ${softwareCodec}`);
+    return { encoderCodec: softwareCodec, isHardware: false, hardware: null };
+}
+/**
+ * Handle hardware encoder failure by falling back to software
+ */
+export function fallbackToSoftware(codecName, hardware) {
+    if (hardware) {
+        releaseHardwareContext(hardware);
+    }
+    const softwareCodec = getSoftwareEncoder(codecName);
+    logger.info(`Falling back to software encoder: ${softwareCodec}`);
+    return { encoderCodec: softwareCodec, hardware: null };
+}
+//# sourceMappingURL=setup.js.map

package/dist/backends/node-av/video/encoder/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../../../../src/backends/node-av/video/encoder/setup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACpG,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAErE,MAAM,MAAM,GAAG,YAAY,CAAC,eAAe,CAAC,CAAC;AAe7C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,SAAiB,EACjB,KAAa,EACb,MAAc,EACd,kBAA4E;IAE5E,+EAA+E;IAC/E,MAAM,WAAW,GAAG,kBAAkB,CAAC,SAAgB,EAAE,kBAAkB,CAAC,CAAC;IAE7E,IAAI,WAAW,CAAC,UAAU,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;QAClD,kEAAkE;QAClE,8DAA8D;QAC9D,MAAM,OAAO,GAAG,wBAAwB,CAAC,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACzE,IAAI,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YACrD,MAAM,CAAC,IAAI,CACT,cAAc,KAAK,IAAI,MAAM,2BAA2B,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,0BAA0B,CAClH,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,IAAI,CAAC;gBACH,8BAA8B;gBAC9B,MAAM,QAAQ,GAAG,sBAAsB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;gBAC7D,IAAI,QAAQ,EAAE,CAAC;oBACb,MAAM,OAAO,GAAG,QAAQ,CAAC,eAAe,CAAC,SAAgB,CAAC,CAAC;oBAC3D,IAAI,OAAO,EAAE,CAAC;wBACZ,MAAM,CAAC,IAAI,CAAC,2BAA2B,WAAW,CAAC,OAAO,KAAK,QAAQ,CAAC,cAAc,GAAG,CAAC,CAAC;wBAC3F,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;oBAC/D,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,8CAA8C;YAChD,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,oBAAoB,WAAW,CAAC,OAAO,mCAAmC,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;IAED,MAAM,aAAa,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACpD,MAAM,CAAC,IAAI,CAAC,2BAA2B,aAAa,EAAE,CAAC,CAAC;IACxD,OAAO,EAAE,YAAY,EAAE,aAA+B,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC9F,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAAiB,EACjB,QAAgC;IAEhC,IAAI,QAAQ,EAAE,CAAC;QACb,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;IACD,MAAM,aAAa,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACpD,MAAM,CAAC,IAAI,CAAC,qCAAqC,aAAa,EAAE,CAAC,CAAC;IAClE,OAAO,EAAE,YAAY,EAAE,aAA+B,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC3E,CAAC"}

package/dist/backends/node-av/video/encoder/software-encoders.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Software encoder name mappings
+ */
+/**
+ * Get software encoder name for a codec
+ */
+export declare function getSoftwareEncoder(codecName: string): string;
+//# sourceMappingURL=software-encoders.d.ts.map

package/dist/backends/node-av/video/encoder/software-encoders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"software-encoders.d.ts","sourceRoot":"","sources":["../../../../../src/backends/node-av/video/encoder/software-encoders.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAS5D"}

package/dist/backends/node-av/video/encoder/software-encoders.js

@@ -0,0 +1,17 @@
+/**
+ * Software encoder name mappings
+ */
+/**
+ * Get software encoder name for a codec
+ */
+export function getSoftwareEncoder(codecName) {
+    switch (codecName) {
+        case 'h264': return 'libx264';
+        case 'hevc': return 'libx265';
+        case 'vp8': return 'libvpx';
+        case 'vp9': return 'libvpx-vp9';
+        case 'av1': return 'libsvtav1';
+        default: return codecName;
+    }
+}
+//# sourceMappingURL=software-encoders.js.map

package/dist/backends/node-av/video/encoder/software-encoders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"software-encoders.js","sourceRoot":"","sources":["../../../../../src/backends/node-av/video/encoder/software-encoders.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,MAAM,CAAC,CAAC,OAAO,SAAS,CAAC;QAC9B,KAAK,MAAM,CAAC,CAAC,OAAO,SAAS,CAAC;QAC9B,KAAK,KAAK,CAAC,CAAC,OAAO,QAAQ,CAAC;QAC5B,KAAK,KAAK,CAAC,CAAC,OAAO,YAAY,CAAC;QAChC,KAAK,KAAK,CAAC,CAAC,OAAO,WAAW,CAAC;QAC/B,OAAO,CAAC,CAAC,OAAO,SAAS,CAAC;IAC5B,CAAC;AACH,CAAC"}

package/dist/backends/node-av/video/encoder/timestamp.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Timestamp conversion utilities for video encoding
+ *
+ * Handles conversion between WebCodecs microsecond timestamps
+ * and FFmpeg encoder timebases.
+ */
+/**
+ * Rational-like interface compatible with both Rational class and IRational
+ */
+export interface RationalLike {
+    num: number;
+    den: number;
+}
+/**
+ * Convert input timestamp (microseconds) to encoder PTS
+ *
+ * For most codecs, timebase is 1/1000000 so pts = timestamp
+ * For AV1/SVT-AV1, timebase is 1/framerate so pts = timestamp * framerate / 1000000
+ */
+export declare function microsecondsToPts(timestampUs: number, timeBase: RationalLike): bigint;
+/**
+ * Convert packet PTS to microseconds
+ *
+ * timestamp_us = pts * (timeBase.num / timeBase.den) * 1_000_000
+ */
+export declare function ptsToMicroseconds(pts: bigint, timeBase: RationalLike): number;
+/**
+ * Get the appropriate timebase for a codec
+ *
+ * Most codecs use microsecond timebase (1/1000000)
+ * SVT-AV1 requires framerate-based timebase to avoid "maximum 240 fps" error
+ */
+export declare function getCodecTimeBase<T extends RationalLike>(codecName: string, framerate: number, RationalClass: new (num: number, den: number) => T): T;
+//# sourceMappingURL=timestamp.d.ts.map