node-av 0.0.1

package/dist/lib/frame.js.map

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

package/dist/lib/hardware-device-context.d.ts

@@ -0,0 +1,407 @@
+import type { AVHWDeviceType } from './constants.js';
+import type { Dictionary } from './dictionary.js';
+import type { NativeHardwareDeviceContext, NativeWrapper } from './native-types.js';
+/**
+ * Hardware device context for hardware acceleration.
+ *
+ * Manages hardware acceleration devices like CUDA, VAAPI, DXVA2, etc.
+ * Provides device creation, configuration, and constraint querying.
+ * Required for hardware-accelerated encoding, decoding, and filtering.
+ *
+ * Direct mapping to FFmpeg's AVHWDeviceContext.
+ *
+ * @example
+ * ```typescript
+ * import { HardwareDeviceContext, HardwareFramesContext, FFmpegError } from 'node-av';
+ * import { AV_HWDEVICE_TYPE_CUDA, AV_PIX_FMT_CUDA, AV_PIX_FMT_NV12 } from 'node-av/constants';
+ *
+ * // Create CUDA device context
+ * const device = new HardwareDeviceContext();
+ * const ret = device.create(AV_HWDEVICE_TYPE_CUDA, null, null);
+ * FFmpegError.throwIfError(ret, 'create device');
+ *
+ * // Get device constraints
+ * const constraints = device.getHwframeConstraints();
+ * console.log(`Max size: ${constraints.maxWidth}x${constraints.maxHeight}`);
+ *
+ * // Create frames context for this device
+ * const frames = new HardwareFramesContext();
+ * frames.alloc(device);
+ * frames.format = AV_PIX_FMT_CUDA;
+ * frames.swFormat = AV_PIX_FMT_NV12;
+ * frames.width = 1920;
+ * frames.height = 1080;
+ * const initRet = frames.init();
+ * FFmpegError.throwIfError(initRet, 'init frames');
+ *
+ * // Cleanup
+ * frames.free();
+ * device.free();
+ * ```
+ *
+ * @example
+ * ```typescript
+ * import { HardwareDeviceContext } from 'node-av';
+ * import { AV_HWDEVICE_TYPE_NONE } from 'node-av/constants';
+ *
+ * // List available hardware device types
+ * const types = HardwareDeviceContext.iterateTypes();
+ * for (const type of types) {
+ *   const name = HardwareDeviceContext.getTypeName(type);
+ *   console.log(`Available: ${name}`);
+ * }
+ *
+ * // Find specific device type
+ * const vaapi = HardwareDeviceContext.findTypeByName('vaapi');
+ * if (vaapi !== AV_HWDEVICE_TYPE_NONE) {
+ *   const device = new HardwareDeviceContext();
+ *   const ret = device.create(vaapi, '/dev/dri/renderD128', null);
+ *   FFmpegError.throwIfError(ret, 'create VAAPI device');
+ * }
+ * ```
+ *
+ * @see {@link HardwareFramesContext} For managing hardware frame pools
+ * @see {@link CodecContext} For hardware-accelerated encoding/decoding
+ */
+export declare class HardwareDeviceContext implements Disposable, NativeWrapper<NativeHardwareDeviceContext> {
+    private native;
+    /**
+     * Create a new hardware device context.
+     *
+     * The context is uninitialized - you must call alloc() or create() before use.
+     * No FFmpeg resources are allocated until initialization.
+     *
+     * Direct wrapper around AVHWDeviceContext.
+     *
+     * @example
+     * ```typescript
+     * import { HardwareDeviceContext, FFmpegError } from 'node-av';
+     * import { AV_HWDEVICE_TYPE_CUDA } from 'node-av/constants';
+     *
+     * const device = new HardwareDeviceContext();
+     * const ret = device.create(AV_HWDEVICE_TYPE_CUDA, null, null);
+     * FFmpegError.throwIfError(ret, 'create device');
+     * // Device is now ready for use
+     * ```
+     */
+    constructor();
+    /**
+     * Get the string name of an AVHWDeviceType.
+     *
+     * Returns the human-readable name for a hardware device type.
+     *
+     * Direct mapping to av_hwdevice_get_type_name()
+     *
+     * @param type - Hardware device type (AVHWDeviceType)
+     *
+     * @returns Device type name or null if unknown
+     *
+     * @example
+     * ```typescript
+     * import { HardwareDeviceContext } from 'node-av';
+     * import { AV_HWDEVICE_TYPE_CUDA } from 'node-av/constants';
+     *
+     * const name = HardwareDeviceContext.getTypeName(AV_HWDEVICE_TYPE_CUDA);
+     * console.log(name); // "cuda"
+     * ```
+     */
+    static getTypeName(type: AVHWDeviceType): string | null;
+    /**
+     * Iterate over supported device types.
+     *
+     * Returns all hardware device types supported by this FFmpeg build.
+     *
+     * Direct mapping to av_hwdevice_iterate_types()
+     *
+     * @returns Array of supported AVHWDeviceType values
+     *
+     * @example
+     * ```typescript
+     * import { HardwareDeviceContext } from 'node-av';
+     *
+     * const types = HardwareDeviceContext.iterateTypes();
+     * for (const type of types) {
+     *   const name = HardwareDeviceContext.getTypeName(type);
+     *   console.log(`Supported: ${name}`);
+     * }
+     * ```
+     */
+    static iterateTypes(): AVHWDeviceType[];
+    /**
+     * Get the AVHWDeviceType corresponding to the name.
+     *
+     * Looks up a hardware device type by its string name.
+     *
+     * Direct mapping to av_hwdevice_find_type_by_name()
+     *
+     * @param name - Device type name (e.g., "cuda", "vaapi", "dxva2")
+     *
+     * @returns AVHWDeviceType or AV_HWDEVICE_TYPE_NONE if not found
+     *
+     * @example
+     * ```typescript
+     * import { HardwareDeviceContext } from 'node-av';
+     * import { AV_HWDEVICE_TYPE_NONE } from 'node-av/constants';
+     *
+     * const type = HardwareDeviceContext.findTypeByName('cuda');
+     * if (type !== AV_HWDEVICE_TYPE_NONE) {
+     *   // CUDA is available
+     * }
+     * ```
+     */
+    static findTypeByName(name: string): AVHWDeviceType;
+    /**
+     * Hardware device type.
+     *
+     * Direct mapping to AVHWDeviceContext->type
+     *
+     * @readonly
+     */
+    get type(): AVHWDeviceType;
+    /**
+     * Hardware-specific data.
+     *
+     * Direct mapping to AVHWDeviceContext->hwctx
+     *
+     * Returns opaque pointer as BigInt for advanced users.
+     * @readonly
+     */
+    get hwctx(): bigint | null;
+    /**
+     * Allocate an AVHWDeviceContext for a given hardware type.
+     *
+     * Allocates the device context structure but doesn't open the device.
+     * Must call init() after configuration to finalize.
+     *
+     * Direct mapping to av_hwdevice_ctx_alloc()
+     *
+     * @param type - Hardware device type
+     *
+     * @throws {Error} Memory allocation failure (ENOMEM)
+     *
+     * @example
+     * ```typescript
+     * import { HardwareDeviceContext, FFmpegError } from 'node-av';
+     * import { AV_HWDEVICE_TYPE_CUDA } from 'node-av/constants';
+     *
+     * const device = new HardwareDeviceContext();
+     * device.alloc(AV_HWDEVICE_TYPE_CUDA);
+     * // Configure device properties if needed
+     * const ret = device.init();
+     * FFmpegError.throwIfError(ret, 'init device');
+     * ```
+     *
+     * @see {@link init} To finalize the device
+     * @see {@link create} For one-step device creation
+     */
+    alloc(type: AVHWDeviceType): void;
+    /**
+     * Finalize the device context before use.
+     *
+     * Completes device initialization after alloc() and configuration.
+     * Must be called before using the device context.
+     *
+     * Direct mapping to av_hwdevice_ctx_init()
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - 0: Success (device ready)
+     *   - AVERROR(EINVAL): Invalid parameters
+     *   - AVERROR(ENOMEM): Memory allocation failure
+     *   - <0: Device-specific errors
+     *
+     * @example
+     * ```typescript
+     * import { HardwareDeviceContext, FFmpegError } from 'node-av';
+     *
+     * const ret = device.init();
+     * FFmpegError.throwIfError(ret, 'init device');
+     * // Device is now ready for use
+     * ```
+     *
+     * @see {@link alloc} Must be called first
+     */
+    init(): number;
+    /**
+     * Open a device of the specified type and create an AVHWDeviceContext.
+     *
+     * One-step device creation that allocates, opens, and initializes the device.
+     * This is the preferred method for creating hardware devices.
+     *
+     * Direct mapping to av_hwdevice_ctx_create()
+     *
+     * @param type - Hardware device type
+     * @param device - Device to open (e.g., "/dev/dri/renderD128" for VAAPI), or null for default
+     * @param options - Device creation options, or null
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - 0: Success (device created and ready)
+     *   - AVERROR(EINVAL): Invalid parameters
+     *   - AVERROR(ENOMEM): Memory allocation failure
+     *   - AVERROR(ENOSYS): Device type not supported
+     *   - <0: Device-specific errors
+     *
+     * @example
+     * ```typescript
+     * import { HardwareDeviceContext, FFmpegError } from 'node-av';
+     * import { AV_HWDEVICE_TYPE_CUDA, AV_HWDEVICE_TYPE_VAAPI } from 'node-av/constants';
+     *
+     * // Create CUDA device
+     * const ret = device.create(AV_HWDEVICE_TYPE_CUDA, null, null);
+     * FFmpegError.throwIfError(ret, 'create CUDA device');
+     *
+     * // Create VAAPI device with specific device
+     * const ret2 = device.create(
+     *   AV_HWDEVICE_TYPE_VAAPI,
+     *   '/dev/dri/renderD128',
+     *   null
+     * );
+     * FFmpegError.throwIfError(ret2, 'create VAAPI device');
+     * ```
+     *
+     * @see {@link alloc} For manual device allocation
+     * @see {@link createDerived} To derive from another device
+     */
+    create(type: AVHWDeviceType, device?: string | null, options?: Dictionary | null): number;
+    /**
+     * Create a new device of the specified type from an existing device.
+     *
+     * Creates a device that shares resources with the source device.
+     * Useful for interop between different hardware APIs.
+     *
+     * Direct mapping to av_hwdevice_ctx_create_derived()
+     *
+     * @param source - Source device context to derive from
+     * @param type - Target hardware device type
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - 0: Success (derived device created)
+     *   - AVERROR(ENOSYS): Derivation not supported
+     *   - AVERROR(EINVAL): Invalid parameters
+     *   - <0: Other errors
+     *
+     * @example
+     * ```typescript
+     * import { HardwareDeviceContext, FFmpegError } from 'node-av';
+     * import { AV_HWDEVICE_TYPE_VAAPI, AV_HWDEVICE_TYPE_CUDA } from 'node-av/constants';
+     *
+     * // Create CUDA device from VAAPI device
+     * const vaapi = new HardwareDeviceContext();
+     * const vaapiRet = vaapi.create(AV_HWDEVICE_TYPE_VAAPI, null, null);
+     * FFmpegError.throwIfError(vaapiRet, 'create VAAPI');
+     *
+     * const cuda = new HardwareDeviceContext();
+     * const ret = cuda.createDerived(vaapi, AV_HWDEVICE_TYPE_CUDA);
+     * FFmpegError.throwIfError(ret, 'derive CUDA from VAAPI');
+     * ```
+     *
+     * @see {@link create} For standalone device creation
+     */
+    createDerived(source: HardwareDeviceContext, type: AVHWDeviceType): number;
+    /**
+     * Free the device context.
+     *
+     * Unreferences the AVBufferRef and releases all device resources.
+     *
+     * Direct mapping to av_buffer_unref()
+     *
+     * @example
+     * ```typescript
+     * import { HardwareDeviceContext } from 'node-av';
+     *
+     * device.free();
+     * // device is now invalid and should not be used
+     * ```
+     */
+    free(): void;
+    /**
+     * Allocate a HW-specific configuration structure.
+     *
+     * Allocates a configuration structure for querying device constraints.
+     *
+     * Direct mapping to av_hwdevice_hwconfig_alloc()
+     *
+     * @returns Opaque pointer as BigInt or null
+     *
+     * @example
+     * ```typescript
+     * import { HardwareDeviceContext } from 'node-av';
+     *
+     * const hwconfig = device.hwconfigAlloc();
+     * if (hwconfig) {
+     *   // Use with getHwframeConstraints
+     *   const constraints = device.getHwframeConstraints(hwconfig);
+     * }
+     * ```
+     *
+     * @see {@link getHwframeConstraints} To use the configuration
+     */
+    hwconfigAlloc(): bigint | null;
+    /**
+     * Get the constraints on HW frames given a device and parameters.
+     *
+     * Queries the device for supported formats, sizes, and other constraints.
+     * Essential for configuring hardware frames contexts.
+     *
+     * Direct mapping to av_hwdevice_get_hwframe_constraints()
+     *
+     * @param hwconfig - Hardware configuration from hwconfigAlloc(), or undefined
+     *
+     * @returns Constraints object or null:
+     *   - Object: Device constraints
+     *   - null: No constraints available
+     *
+     * @example
+     * ```typescript
+     * import { HardwareDeviceContext } from 'node-av';
+     *
+     * const constraints = device.getHwframeConstraints();
+     * if (constraints) {
+     *   console.log(`Size range: ${constraints.minWidth}x${constraints.minHeight} to ${constraints.maxWidth}x${constraints.maxHeight}`);
+     *
+     *   if (constraints.validSwFormats) {
+     *     console.log('Valid software formats:', constraints.validSwFormats);
+     *   }
+     * }
+     * ```
+     *
+     * @see {@link hwconfigAlloc} To create configuration
+     * @see {@link HardwareFramesContext} To use with frame pools
+     */
+    getHwframeConstraints(hwconfig?: bigint): {
+        validHwFormats?: number[];
+        validSwFormats?: number[];
+        minWidth: number;
+        minHeight: number;
+        maxWidth: number;
+        maxHeight: number;
+    } | null;
+    /**
+     * Get the native FFmpeg AVHWDeviceContext pointer.
+     *
+     * @internal For use by other wrapper classes
+     * @returns The underlying native hardware device context object
+     */
+    getNative(): NativeHardwareDeviceContext;
+    /**
+     * Dispose of the hardware device context.
+     *
+     * Implements the Disposable interface for automatic cleanup.
+     * Equivalent to calling free().
+     *
+     * @example
+     * ```typescript
+     * import { HardwareDeviceContext, FFmpegError } from 'node-av';
+     * import { AV_HWDEVICE_TYPE_CUDA } from 'node-av/constants';
+     *
+     * {
+     *   using device = new HardwareDeviceContext();
+     *   const ret = device.create(AV_HWDEVICE_TYPE_CUDA, null, null);
+     *   FFmpegError.throwIfError(ret, 'create device');
+     *   // ... use device
+     * } // Automatically freed when leaving scope
+     * ```
+     *
+     * @see {@link free} For manual cleanup
+     */
+    [Symbol.dispose](): void;
+}