node-av 5.2.0 → 5.2.1

package/dist/api/utilities/electron-shared-texture.js

@@ -0,0 +1,420 @@
+import { AV_HWFRAME_MAP_READ, AV_HWFRAME_MAP_WRITE, AV_PIX_FMT_BGRA, AV_PIX_FMT_NONE } from '../../constants/constants.js';
+import { FFmpegError } from '../../lib/error.js';
+import { Frame } from '../../lib/frame.js';
+import { HardwareFramesContext } from '../../lib/hardware-frames-context.js';
+import { PixelFormatUtils } from './pixel-format.js';
+/**
+ * High-level GPU texture import for Electron shared textures.
+ *
+ * Handles platform detection (macOS IOSurface, Windows D3D11,
+ * Linux DMA-BUF), HardwareFramesContext lifecycle, and format mapping automatically.
+ *
+ * @example
+ * ```typescript
+ * import { HardwareContext, SharedTexture } from 'node-av/api';
+ *
+ * const hw = HardwareContext.auto();
+ * using sharedTexture = SharedTexture.create(hw);
+ *
+ * // In Electron paint event:
+ * offscreen.webContents.on('paint', (event) => {
+ *   const texture = event.texture;
+ *   if (!texture?.textureInfo) return;
+ *
+ *   using frame = sharedTexture.importTexture(texture.textureInfo, { pts: 0n });
+ *   // frame is a hardware Frame ready for encoding/filtering
+ *
+ *   texture.release();
+ * });
+ * ```
+ *
+ * @see {@link HardwareContext} For hardware acceleration setup
+ * @see {@link Frame} For frame operations
+ */
+export class SharedTexture {
+    _hardware;
+    _framesCtx = null;
+    _currentWidth = 0;
+    _currentHeight = 0;
+    _swFormat;
+    _isDisposed = false;
+    // Mapping context cache for mapTo() helper
+    _mappingCtx = null;
+    _mappingHw = null;
+    constructor(hardware, options) {
+        this._hardware = hardware;
+        this._swFormat = options.swFormat ?? AV_PIX_FMT_BGRA;
+        if (options.width)
+            this._currentWidth = options.width;
+        if (options.height)
+            this._currentHeight = options.height;
+    }
+    /**
+     * Create a SharedTexture.
+     *
+     * @param hardware - Initialized hardware context (from HardwareContext.auto() or HardwareContext.create())
+     *
+     * @param options - Optional configuration overrides
+     *
+     * @returns SharedTexture instance
+     *
+     * @example
+     * ```typescript
+     * const hw = HardwareContext.auto();
+     * using sharedTexture = SharedTexture.create(hw);
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // With explicit software format
+     * import { AV_PIX_FMT_NV12 } from 'node-av/constants';
+     *
+     * using sharedTexture = SharedTexture.create(hw, { swFormat: AV_PIX_FMT_NV12 });
+     * ```
+     */
+    static create(hardware, options = {}) {
+        if (!hardware || hardware.isDisposed) {
+            throw new Error('SharedTexture requires a valid, non-disposed HardwareContext');
+        }
+        return new SharedTexture(hardware, options);
+    }
+    /**
+     * The hardware context used by this sharedTexture.
+     */
+    get hardware() {
+        return this._hardware;
+    }
+    /**
+     * Current width of the cached HardwareFramesContext.
+     */
+    get width() {
+        return this._currentWidth;
+    }
+    /**
+     * Current height of the cached HardwareFramesContext.
+     */
+    get height() {
+        return this._currentHeight;
+    }
+    /**
+     * Whether this sharedTexture has been disposed.
+     */
+    get isDisposed() {
+        return this._isDisposed;
+    }
+    /**
+     * Import an Electron textureInfo as a hardware Frame.
+     *
+     * Automatically detects the platform from the handle contents,
+     * manages the HardwareFramesContext, and creates a zero-copy hardware frame.
+     *
+     * @param textureInfo - Electron's textureInfo object from paint event
+     *
+     * @param options - Per-frame options (pts, timeBase)
+     *
+     * @returns Hardware Frame referencing the GPU texture
+     *
+     * @throws {Error} If disposed, no valid handle found, or import fails
+     *
+     * @example
+     * ```typescript
+     * offscreen.webContents.on('paint', (event) => {
+     *   const texture = event.texture;
+     *   if (!texture?.textureInfo) return;
+     *
+     *   using frame = sharedTexture.importTexture(texture.textureInfo, {
+     *     pts: BigInt(Date.now()) * 1000n,
+     *     timeBase: { num: 1, den: 1000000 },
+     *   });
+     *
+     *   texture.release();
+     * });
+     * ```
+     */
+    importTexture(textureInfo, options = {}) {
+        if (this._isDisposed) {
+            throw new Error('SharedTexture has been disposed');
+        }
+        const { width, height } = textureInfo.codedSize;
+        const swFormat = this.resolvePixelFormat(textureInfo.pixelFormat);
+        const handle = textureInfo.handle;
+        return this.importFromHandle(handle, width, height, swFormat, options);
+    }
+    /**
+     * Import a raw SharedTextureHandle as a hardware Frame.
+     *
+     * Use this when you have the handle directly without the full textureInfo wrapper.
+     *
+     * @param handle - Platform-specific GPU texture handle
+     *
+     * @param props - Dimensions, format, and timing options
+     *
+     * @returns Hardware Frame referencing the GPU texture
+     *
+     * @throws {Error} If disposed, no valid handle found, or import fails
+     *
+     * @example
+     * ```typescript
+     * const frame = sharedTexture.importHandle(handle, {
+     *   width: 1920,
+     *   height: 1080,
+     *   pixelFormat: 'BGRA',
+     *   pts: 0n,
+     * });
+     * ```
+     */
+    importHandle(handle, props) {
+        if (this._isDisposed) {
+            throw new Error('SharedTexture has been disposed');
+        }
+        let swFormat = this._swFormat;
+        if (props.pixelFormat !== undefined) {
+            swFormat = typeof props.pixelFormat === 'string' ? this.resolvePixelFormat(props.pixelFormat) : props.pixelFormat;
+        }
+        return this.importFromHandle(handle, props.width, props.height, swFormat, {
+            pts: props.pts,
+            timeBase: props.timeBase,
+        });
+    }
+    /**
+     * Map a frame to a different hardware format.
+     *
+     * Handles HardwareFramesContext creation and caching automatically.
+     * The mapping context is cached and reused for subsequent calls with the
+     * same target hardware and frame dimensions.
+     *
+     * @param srcFrame - Source frame (e.g., DRM PRIME from importTexture on Linux)
+     *
+     * @param targetHw - Target hardware context (e.g., VAAPI, Vulkan)
+     *
+     * @param flags - Mapping flags
+     *
+     * @returns Mapped frame in target hardware format
+     *
+     * @throws {FFmpegError} If mapping fails (e.g., unsupported mapping, invalid frames)
+     *
+     * @example
+     * ```typescript
+     * import { HardwareContext, SharedTexture } from 'node-av/api';
+     * import { AV_HWDEVICE_TYPE_VAAPI } from 'node-av/constants';
+     *
+     * // Import DRM PRIME frame from Electron shared texture
+     * const drmFrame = sharedTexture.importTexture(textureInfo, { pts: 0n });
+     *
+     * // Map to VAAPI for encoding
+     * const vaapiHw = await HardwareContext.create(AV_HWDEVICE_TYPE_VAAPI);
+     * const vaapiFrame = sharedTexture.mapTo(drmFrame, vaapiHw);
+     *
+     * // Encode with VAAPI encoder
+     * encoder.encode(vaapiFrame);
+     * ```
+     */
+    mapTo(srcFrame, targetHw, flags) {
+        if (this._isDisposed) {
+            throw new Error('SharedTexture has been disposed');
+        }
+        // Ensure mapping context exists and matches target hardware + dimensions
+        this.ensureMappingContext(srcFrame, targetHw);
+        // Create destination frame
+        const dstFrame = new Frame();
+        dstFrame.alloc();
+        // Allocate buffer from target hardware frames context
+        const allocRet = this._mappingCtx.getBuffer(dstFrame);
+        FFmpegError.throwIfError(allocRet, 'Failed to allocate target hardware frame');
+        // Copy timing properties
+        dstFrame.pts = srcFrame.pts;
+        dstFrame.timeBase = srcFrame.timeBase;
+        // Perform mapping
+        const mapFlags = flags ?? AV_HWFRAME_MAP_READ | AV_HWFRAME_MAP_WRITE;
+        const ret = this._mappingCtx.map(dstFrame, srcFrame, mapFlags);
+        FFmpegError.throwIfError(ret, 'Failed to map frame to target hardware format');
+        return dstFrame;
+    }
+    /**
+     * Ensure mapping context exists and matches the target hardware and frame dimensions.
+     *
+     * Re-creates the context if target hardware changes or dimensions change.
+     *
+     * @param srcFrame - Source frame to get dimensions from
+     *
+     * @param targetHw - Target hardware context
+     *
+     * @internal
+     */
+    ensureMappingContext(srcFrame, targetHw) {
+        // Re-create if target hardware changed or dimensions changed
+        if (this._mappingHw !== targetHw || this._mappingCtx?.width !== srcFrame.width || this._mappingCtx?.height !== srcFrame.height) {
+            // Free previous context
+            if (this._mappingCtx) {
+                this._mappingCtx.free();
+                this._mappingCtx = null;
+            }
+            // Create new mapping context for target hardware
+            const ctx = new HardwareFramesContext();
+            ctx.alloc(targetHw.deviceContext);
+            ctx.format = targetHw.devicePixelFormat;
+            ctx.swFormat = srcFrame.format; // Use source format
+            ctx.width = srcFrame.width;
+            ctx.height = srcFrame.height;
+            const ret = ctx.init();
+            FFmpegError.throwIfError(ret, 'Failed to initialize mapping HardwareFramesContext');
+            this._mappingCtx = ctx;
+            this._mappingHw = targetHw;
+        }
+    }
+    /**
+     * Release the cached HardwareFramesContext and mapping context.
+     *
+     * The HardwareContext is NOT disposed — it belongs to the caller.
+     * Safe to call multiple times.
+     *
+     * @example
+     * ```typescript
+     * sharedTexture.dispose();
+     * ```
+     */
+    dispose() {
+        if (this._isDisposed) {
+            return;
+        }
+        this._isDisposed = true;
+        if (this._framesCtx) {
+            this._framesCtx.free();
+            this._framesCtx = null;
+        }
+        if (this._mappingCtx) {
+            this._mappingCtx.free();
+            this._mappingCtx = null;
+        }
+        this._mappingHw = null;
+    }
+    /**
+     * Core import logic — dispatches to the correct Frame factory based on handle type.
+     *
+     * @param handle - Platform-specific GPU texture handle
+     *
+     * @param width - Texture width in pixels
+     *
+     * @param height - Texture height in pixels
+     *
+     * @param swFormat - Software pixel format for HardwareFramesContext
+     *
+     * @param options - Per-frame timing options
+     *
+     * @returns Hardware Frame referencing the GPU texture
+     *
+     * @internal
+     */
+    importFromHandle(handle, width, height, swFormat, options) {
+        // macOS — IOSurface
+        if (handle.ioSurface && handle.ioSurface.length > 0) {
+            const framesCtx = this.ensureFramesContext(width, height, swFormat);
+            return Frame.fromIOSurface(handle.ioSurface, {
+                hwFramesCtx: framesCtx,
+                pts: options.pts,
+                timeBase: options.timeBase,
+            });
+        }
+        // Windows — D3D11 shared texture
+        if (handle.ntHandle && handle.ntHandle.length > 0) {
+            return Frame.fromD3D11Texture(handle.ntHandle, {
+                hwDeviceCtx: this._hardware.deviceContext,
+                pts: options.pts,
+                timeBase: options.timeBase,
+            });
+        }
+        // Linux — DMA-BUF
+        if (handle.nativePixmap) {
+            const dmaBuf = {
+                planes: handle.nativePixmap.planes,
+                modifier: handle.nativePixmap.modifier,
+            };
+            return Frame.fromDmaBuf(dmaBuf, {
+                width,
+                height,
+                swFormat,
+                pts: options.pts,
+                timeBase: options.timeBase,
+            });
+        }
+        throw new Error('SharedTexture: no valid handle found (expected ioSurface, ntHandle, or nativePixmap)');
+    }
+    /**
+     * Ensure HardwareFramesContext is created and matches the requested dimensions/format.
+     *
+     * Re-creates the context only when dimensions or format change.
+     * Windows D3D11 does not use this — it passes HardwareDeviceContext directly.
+     *
+     * @param width - Frame width in pixels
+     *
+     * @param height - Frame height in pixels
+     *
+     * @param swFormat - Software pixel format
+     *
+     * @returns Initialized HardwareFramesContext matching the requested parameters
+     *
+     * @internal
+     */
+    ensureFramesContext(width, height, swFormat) {
+        if (this._framesCtx && this._currentWidth === width && this._currentHeight === height && this._swFormat === swFormat) {
+            return this._framesCtx;
+        }
+        // Free previous context if dimensions/format changed
+        if (this._framesCtx) {
+            this._framesCtx.free();
+            this._framesCtx = null;
+        }
+        const framesCtx = new HardwareFramesContext();
+        framesCtx.alloc(this._hardware.deviceContext);
+        framesCtx.format = this._hardware.devicePixelFormat;
+        framesCtx.swFormat = swFormat;
+        framesCtx.width = width;
+        framesCtx.height = height;
+        const ret = framesCtx.init();
+        FFmpegError.throwIfError(ret, 'Failed to initialize HardwareFramesContext');
+        this._framesCtx = framesCtx;
+        this._currentWidth = width;
+        this._currentHeight = height;
+        this._swFormat = swFormat;
+        return framesCtx;
+    }
+    /**
+     * Resolve a pixel format string (e.g., 'BGRA') to an AVPixelFormat enum value.
+     *
+     * Falls back to the configured swFormat if the name is not recognized.
+     *
+     * @param name - Pixel format name string from Electron
+     *
+     * @returns Resolved AVPixelFormat enum value
+     *
+     * @internal
+     */
+    resolvePixelFormat(name) {
+        // Electron reports formats in uppercase (e.g., 'BGRA'), FFmpeg uses lowercase
+        const fmt = PixelFormatUtils.fromName(name.toLowerCase());
+        if (fmt === AV_PIX_FMT_NONE) {
+            return this._swFormat;
+        }
+        return fmt;
+    }
+    /**
+     * Dispose of the SharedTexture.
+     *
+     * Implements the Disposable interface for automatic cleanup.
+     * Equivalent to calling dispose().
+     *
+     * @example
+     * ```typescript
+     * {
+     *   using sharedTexture = SharedTexture.create(hw);
+     *   // Use sharedTexture...
+     * } // Automatically disposed
+     * ```
+     *
+     * @see {@link dispose} For manual cleanup
+     */
+    [Symbol.dispose]() {
+        this.dispose();
+    }
+}
+//# sourceMappingURL=electron-shared-texture.js.map

package/dist/api/utilities/electron-shared-texture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"electron-shared-texture.js","sourceRoot":"","sources":["../../../src/api/utilities/electron-shared-texture.ts"],"names":[],"mappings":"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"}

package/dist/api/utilities/index.d.ts

@@ -6,6 +6,7 @@ export { PixelFormatUtils } from './pixel-format.js';
 export { SampleFormatUtils } from './sample-format.js';
 export { TimestampUtils } from './timestamp.js';
 export { StreamingUtils } from './streaming.js';
-export { WhisperDownloader, WHISPER_MODELS, WHISPER_VAD_MODELS, type DownloadOptions, type WhisperModelType, type WhisperModelName, type WhisperVADModelName, } from './whisper-model.js';
+export { WHISPER_MODELS, WHISPER_VAD_MODELS, WhisperDownloader, type DownloadOptions, type WhisperModelName, type WhisperModelType, type WhisperVADModelName, } from './whisper-model.js';
 export { AsyncQueue } from './async-queue.js';
 export { Scheduler, SchedulerControl, type SchedulableComponent } from './scheduler.js';
+export { SharedTexture, type ImportHandleProps, type SharedTextureHandle, type SharedTextureOptions, type TextureFrameOptions, type TextureInfo, } from './electron-shared-texture.js';

package/dist/api/utilities/index.js

@@ -15,9 +15,11 @@ export { TimestampUtils } from './timestamp.js';
 // Streaming
 export { StreamingUtils } from './streaming.js';
 // Whisper Model Downloader
-export { WhisperDownloader, WHISPER_MODELS, WHISPER_VAD_MODELS, } from './whisper-model.js';
+export { WHISPER_MODELS, WHISPER_VAD_MODELS, WhisperDownloader, } from './whisper-model.js';
 // AsyncQueue
 export { AsyncQueue } from './async-queue.js';
 // Scheduler
 export { Scheduler, SchedulerControl } from './scheduler.js';
+// SharedTexture
+export { SharedTexture, } from './electron-shared-texture.js';
 //# sourceMappingURL=index.js.map

package/dist/api/utilities/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/utilities/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,OAAO,EAAE,gBAAgB,EAA0D,MAAM,mBAAmB,CAAC;AAE7G,kBAAkB;AAClB,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,QAAQ;AACR,OAAO,EAAE,UAAU,EAAwB,MAAM,YAAY,CAAC;AAE9D,QAAQ;AACR,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,eAAe;AACf,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,gBAAgB;AAChB,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,YAAY;AACZ,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,YAAY;AACZ,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,2BAA2B;AAC3B,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,kBAAkB,GAKnB,MAAM,oBAAoB,CAAC;AAE5B,aAAa;AACb,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,YAAY;AACZ,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAA6B,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/utilities/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,OAAO,EAAE,gBAAgB,EAA0D,MAAM,mBAAmB,CAAC;AAE7G,kBAAkB;AAClB,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,QAAQ;AACR,OAAO,EAAE,UAAU,EAAwB,MAAM,YAAY,CAAC;AAE9D,QAAQ;AACR,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,eAAe;AACf,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,gBAAgB;AAChB,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,YAAY;AACZ,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,YAAY;AACZ,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,2BAA2B;AAC3B,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,iBAAiB,GAKlB,MAAM,oBAAoB,CAAC;AAE5B,aAAa;AACb,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,YAAY;AACZ,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAA6B,MAAM,gBAAgB,CAAC;AAExF,gBAAgB;AAChB,OAAO,EACL,aAAa,GAMd,MAAM,8BAA8B,CAAC"}

package/dist/constants/constants.d.ts

@@ -43,6 +43,13 @@ export declare const AV_PICTURE_STRUCTURE_UNKNOWN: AVPictureStructure;
 export declare const AV_PICTURE_STRUCTURE_TOP_FIELD: AVPictureStructure;
 export declare const AV_PICTURE_STRUCTURE_BOTTOM_FIELD: AVPictureStructure;
 export declare const AV_PICTURE_STRUCTURE_FRAME: AVPictureStructure;
+export type AVCodecHWConfigMethod = number & {
+    readonly [__ffmpeg_brand]: 'AVCodecHWConfigMethod';
+};
+export declare const AV_CODEC_HW_CONFIG_METHOD_HW_DEVICE_CTX: AVCodecHWConfigMethod;
+export declare const AV_CODEC_HW_CONFIG_METHOD_HW_FRAMES_CTX: AVCodecHWConfigMethod;
+export declare const AV_CODEC_HW_CONFIG_METHOD_INTERNAL: AVCodecHWConfigMethod;
+export declare const AV_CODEC_HW_CONFIG_METHOD_AD_HOC: AVCodecHWConfigMethod;
 export type AVCodecID = number & {
     readonly [__ffmpeg_brand]: 'AVCodecID';
 };
@@ -902,6 +909,10 @@ export declare const AV_AFD_14_9: AVActiveFormatDescription;
 export declare const AV_AFD_4_3_SP_14_9: AVActiveFormatDescription;
 export declare const AV_AFD_16_9_SP_14_9: AVActiveFormatDescription;
 export declare const AV_AFD_SP_4_3: AVActiveFormatDescription;
+export type AVFrameCropFlag = number & {
+    readonly [__ffmpeg_brand]: 'AVFrameCropFlag';
+};
+export declare const AV_FRAME_CROP_UNALIGNED: AVFrameCropFlag;
 export type AVHDRPlusOverlapProcessOption = number & {
     readonly [__ffmpeg_brand]: 'AVHDRPlusOverlapProcessOption';
 };
@@ -940,10 +951,28 @@ export type AVHWFrameTransferDirection = number & {
 };
 export declare const AV_HWFRAME_TRANSFER_DIRECTION_FROM: AVHWFrameTransferDirection;
 export declare const AV_HWFRAME_TRANSFER_DIRECTION_TO: AVHWFrameTransferDirection;
+export type AVHWFrameMapFlag = number & {
+    readonly [__ffmpeg_brand]: 'AVHWFrameMapFlag';
+};
+export declare const AV_HWFRAME_MAP_READ: AVHWFrameMapFlag;
+export declare const AV_HWFRAME_MAP_WRITE: AVHWFrameMapFlag;
+export declare const AV_HWFRAME_MAP_OVERWRITE: AVHWFrameMapFlag;
+export declare const AV_HWFRAME_MAP_DIRECT: AVHWFrameMapFlag;
 export type AVD3D12VAFrameFlags = number & {
     readonly [__ffmpeg_brand]: 'AVD3D12VAFrameFlags';
 };
 export declare const AV_D3D12VA_FRAME_FLAG_NONE: AVD3D12VAFrameFlags;
+export type AVDRMMax = number & {
+    readonly [__ffmpeg_brand]: 'AVDRMMax';
+};
+export declare const AV_DRM_MAX_PLANES: AVDRMMax;
+export type AVVaapiDriverQuirk = number & {
+    readonly [__ffmpeg_brand]: 'AVVaapiDriverQuirk';
+};
+export declare const AV_VAAPI_DRIVER_QUIRK_USER_SET: AVVaapiDriverQuirk;
+export declare const AV_VAAPI_DRIVER_QUIRK_RENDER_PARAM_BUFFERS: AVVaapiDriverQuirk;
+export declare const AV_VAAPI_DRIVER_QUIRK_ATTRIB_MEMTYPE: AVVaapiDriverQuirk;
+export declare const AV_VAAPI_DRIVER_QUIRK_SURFACE_ATTRIBUTES: AVVaapiDriverQuirk;
 export type AVIAMFAnimationType = number & {
     readonly [__ffmpeg_brand]: 'AVIAMFAnimationType';
 };
@@ -1072,6 +1101,10 @@ export declare const AV_OPT_TYPE_BOOL: AVOptionTypeBool;
 export declare const AV_OPT_TYPE_CHLAYOUT: AVOptionTypeChLayout;
 export declare const AV_OPT_TYPE_UINT: AVOptionTypeUint;
 export declare const AV_OPT_TYPE_BINARY_INT_ARRAY: AVOptionTypeBinaryIntArray;
+export type AVOptFlagImplicit = number & {
+    readonly [__ffmpeg_brand]: 'AVOptFlagImplicit';
+};
+export declare const AV_OPT_FLAG_IMPLICIT_KEY: AVOptFlagImplicit;
 export type AVPixelFormat = number & {
     readonly [__ffmpeg_brand]: 'AVPixelFormat';
 };
@@ -2241,10 +2274,6 @@ export type AVThreadType = number & {
 };
 export declare const FF_THREAD_FRAME: AVThreadType;
 export declare const FF_THREAD_SLICE: AVThreadType;
-export declare const AV_CODEC_HW_CONFIG_METHOD_HW_DEVICE_CTX = 1;
-export declare const AV_CODEC_HW_CONFIG_METHOD_HW_FRAMES_CTX = 2;
-export declare const AV_CODEC_HW_CONFIG_METHOD_INTERNAL = 4;
-export declare const AV_CODEC_HW_CONFIG_METHOD_AD_HOC = 8;
 export type AVError = number & {
     readonly [__ffmpeg_brand]: 'AVError';
 };

package/dist/constants/constants.js

@@ -31,6 +31,10 @@ export const AV_PICTURE_STRUCTURE_UNKNOWN = 0;
 export const AV_PICTURE_STRUCTURE_TOP_FIELD = 1;
 export const AV_PICTURE_STRUCTURE_BOTTOM_FIELD = 2;
 export const AV_PICTURE_STRUCTURE_FRAME = 3;
+export const AV_CODEC_HW_CONFIG_METHOD_HW_DEVICE_CTX = 1;
+export const AV_CODEC_HW_CONFIG_METHOD_HW_FRAMES_CTX = 2;
+export const AV_CODEC_HW_CONFIG_METHOD_INTERNAL = 4;
+export const AV_CODEC_HW_CONFIG_METHOD_AD_HOC = 8;
 export const AV_CODEC_ID_NONE = 0;
 export const AV_CODEC_ID_MPEG1VIDEO = 1;
 export const AV_CODEC_ID_MPEG2VIDEO = 2;
@@ -815,6 +819,7 @@ export const AV_AFD_14_9 = 11;
 export const AV_AFD_4_3_SP_14_9 = 13;
 export const AV_AFD_16_9_SP_14_9 = 14;
 export const AV_AFD_SP_4_3 = 15;
+export const AV_FRAME_CROP_UNALIGNED = 1;
 export const AV_HDR_PLUS_OVERLAP_PROCESS_WEIGHTED_AVERAGING = 0;
 export const AV_HDR_PLUS_OVERLAP_PROCESS_LAYERING = 1;
 export const AV_HMAC_MD5 = 0;
@@ -841,7 +846,16 @@ export const AV_HWDEVICE_TYPE_AMF = 14;
 export const AV_HWDEVICE_TYPE_OHCODEC = 15;
 export const AV_HWFRAME_TRANSFER_DIRECTION_FROM = 0;
 export const AV_HWFRAME_TRANSFER_DIRECTION_TO = 1;
+export const AV_HWFRAME_MAP_READ = 1;
+export const AV_HWFRAME_MAP_WRITE = 2;
+export const AV_HWFRAME_MAP_OVERWRITE = 4;
+export const AV_HWFRAME_MAP_DIRECT = 8;
 export const AV_D3D12VA_FRAME_FLAG_NONE = 0;
+export const AV_DRM_MAX_PLANES = 4;
+export const AV_VAAPI_DRIVER_QUIRK_USER_SET = 1;
+export const AV_VAAPI_DRIVER_QUIRK_RENDER_PARAM_BUFFERS = 2;
+export const AV_VAAPI_DRIVER_QUIRK_ATTRIB_MEMTYPE = 4;
+export const AV_VAAPI_DRIVER_QUIRK_SURFACE_ATTRIBUTES = 8;
 export const AV_IAMF_ANIMATION_TYPE_STEP = 0;
 export const AV_IAMF_ANIMATION_TYPE_LINEAR = 1;
 export const AV_IAMF_ANIMATION_TYPE_BEZIER = 2;
@@ -883,6 +897,7 @@ export const AV_OPT_TYPE_BOOL = 18;
 export const AV_OPT_TYPE_CHLAYOUT = 19;
 export const AV_OPT_TYPE_UINT = 20;
 export const AV_OPT_TYPE_BINARY_INT_ARRAY = 25; // For int arrays like pix_fmts
+export const AV_OPT_FLAG_IMPLICIT_KEY = 1;
 export const AV_PIX_FMT_NONE = -1;
 export const AV_PIX_FMT_YUV420P = 0;
 export const AV_PIX_FMT_YUYV422 = 1;
@@ -1812,13 +1827,6 @@ export const SWR_FLAG_RESAMPLE = 1;
 export const SWR_CH_MAX = 64;
 export const FF_THREAD_FRAME = 1;
 export const FF_THREAD_SLICE = 2;
-// ============================================================================
-// AV_CODEC_HW_CONFIG_METHOD - Hardware configuration methods
-// ============================================================================
-export const AV_CODEC_HW_CONFIG_METHOD_HW_DEVICE_CTX = 0x01;
-export const AV_CODEC_HW_CONFIG_METHOD_HW_FRAMES_CTX = 0x02;
-export const AV_CODEC_HW_CONFIG_METHOD_INTERNAL = 0x04;
-export const AV_CODEC_HW_CONFIG_METHOD_AD_HOC = 0x08;
 export const AVERROR_BSF_NOT_FOUND = -1179861752;
 export const AVERROR_BUG = -558323010;
 export const AVERROR_BUFFER_TOO_SMALL = -1397118274;