node-av 1.3.0 → 2.1.0

package/dist/lib/frame.d.ts

@@ -1,6 +1,6 @@
 import { HardwareFramesContext } from './hardware-frames-context.js';
 import { Rational } from './rational.js';
-import type { AVChromaLocation, AVColorPrimaries, AVColorRange, AVColorSpace, AVColorTransferCharacteristic, AVFrameSideDataType, AVPictureType, AVPixelFormat, AVSampleFormat } from '../constants/constants.js';
+import type { AVChromaLocation, AVColorPrimaries, AVColorRange, AVColorSpace, AVColorTransferCharacteristic, AVFrameSideDataType, AVMediaType, AVPictureType, AVPixelFormat, AVSampleFormat } from '../constants/constants.js';
 import type { NativeFrame, NativeWrapper } from './native-types.js';
 import type { ChannelLayout } from './types.js';
 /**
@@ -254,6 +254,48 @@ export declare class Frame implements Disposable, NativeWrapper<NativeFrame> {
      */
     get hwFramesCtx(): HardwareFramesContext | null;
     set hwFramesCtx(value: HardwareFramesContext | null);
+    /**
+     * Check if this is a video frame.
+     *
+     * Video frames have width and height > 0.
+     *
+     * @returns true if this is a video frame
+     *
+     * @example
+     * ```typescript
+     * if (frame.isVideo()) {
+     *   console.log(`Video frame: ${frame.width}x${frame.height}`);
+     * }
+     * ```
+     */
+    isVideo(): boolean;
+    /**
+     * Check if this is an audio frame.
+     *
+     * Audio frames have sampleRate > 0 and nbSamples > 0.
+     *
+     * @returns true if this is an audio frame
+     *
+     * @example
+     * ```typescript
+     * if (frame.isAudio()) {
+     *   console.log(`Audio frame: ${frame.sampleRate}Hz, ${frame.nbSamples} samples`);
+     * }
+     * ```
+     */
+    isAudio(): boolean;
+    /**
+     * Get the media type of this frame.
+     *
+     * @returns AVMEDIA_TYPE_VIDEO for video frames, AVMEDIA_TYPE_AUDIO for audio frames, or AVMEDIA_TYPE_UNKNOWN
+     *
+     * @example
+     * ```typescript
+     * const type = frame.getMediaType();
+     * console.log(`Frame type: ${type}`);
+     * ```
+     */
+    getMediaType(): AVMediaType;
     /**
      * Allocate a new frame.
      *
@@ -300,6 +342,7 @@ export declare class Frame implements Disposable, NativeWrapper<NativeFrame> {
      * Direct mapping to av_frame_ref().
      *
      * @param src - Source frame to reference
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_ENOMEM: Memory allocation failure
      *   - AVERROR_EINVAL: Invalid parameters
@@ -369,6 +412,7 @@ export declare class Frame implements Disposable, NativeWrapper<NativeFrame> {
      * Direct mapping to av_frame_get_buffer().
      *
      * @param align - Buffer size alignment (0 for default)
+     *
      * @returns Required buffer size in bytes, or negative AVERROR:
      *   - AVERROR_EINVAL: Invalid frame parameters
      *
@@ -443,6 +487,7 @@ export declare class Frame implements Disposable, NativeWrapper<NativeFrame> {
      * Direct mapping to av_frame_copy_props().
      *
      * @param src - Source frame to copy properties from
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_ENOMEM: Memory allocation failure
      *
@@ -467,6 +512,7 @@ export declare class Frame implements Disposable, NativeWrapper<NativeFrame> {
      * Direct mapping to av_frame_copy().
      *
      * @param src - Source frame to copy from
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Incompatible frames
      *
@@ -495,6 +541,7 @@ export declare class Frame implements Disposable, NativeWrapper<NativeFrame> {
      * Frame must have allocated buffers.
      *
      * @param buffer - Source buffer with frame data
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Invalid parameters
      *
@@ -517,7 +564,9 @@ export declare class Frame implements Disposable, NativeWrapper<NativeFrame> {
      * Direct mapping to av_hwframe_transfer_data().
      *
      * @param dst - Destination frame (software or hardware)
+     *
      * @param flags - Transfer flags (0 for default)
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Invalid parameters
      *   - AVERROR_ENOMEM: Memory allocation failure
@@ -537,6 +586,37 @@ export declare class Frame implements Disposable, NativeWrapper<NativeFrame> {
      * @see {@link isSwFrame} To check if frame is software
      */
     hwframeTransferData(dst: Frame, flags?: number): Promise<number>;
+    /**
+     * Transfer data between hardware and software frames synchronously.
+     * Synchronous version of hwframeTransferData.
+     *
+     * Copies frame data between GPU and system memory.
+     * Direction depends on source and destination frame types.
+     *
+     * Direct mapping to av_hwframe_transfer_data().
+     *
+     * @param dst - Destination frame (software or hardware)
+     *
+     * @param flags - Transfer flags (0 for default)
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EINVAL: Invalid parameters
+     *   - AVERROR_ENOMEM: Memory allocation failure
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     *
+     * // Download from GPU to CPU
+     * const swFrame = new Frame();
+     * swFrame.alloc();
+     * const ret = hwFrame.hwframeTransferData(swFrame);
+     * FFmpegError.throwIfError(ret, 'hwframeTransferData');
+     * ```
+     *
+     * @see {@link hwframeTransferData} For async version
+     */
+    hwframeTransferDataSync(dst: Frame, flags?: number): number;
     /**
      * Check if this is a hardware frame.
      *
@@ -582,6 +662,7 @@ export declare class Frame implements Disposable, NativeWrapper<NativeFrame> {
      * Direct mapping to av_frame_get_side_data().
      *
      * @param type - Type of side data to retrieve
+     *
      * @returns Side data buffer, or null if not present
      *
      * @example
@@ -607,7 +688,9 @@ export declare class Frame implements Disposable, NativeWrapper<NativeFrame> {
      * Direct mapping to av_frame_new_side_data().
      *
      * @param type - Type of side data
+     *
      * @param size - Size in bytes to allocate
+     *
      * @returns Allocated buffer for writing
      *
      * @throws {Error} If allocation fails

package/dist/lib/frame.js

@@ -1,3 +1,4 @@
+import { AVMEDIA_TYPE_AUDIO, AVMEDIA_TYPE_UNKNOWN, AVMEDIA_TYPE_VIDEO } from '../constants/constants.js';
 import { bindings } from './binding.js';
 import { HardwareFramesContext } from './hardware-frames-context.js';
 import { Rational } from './rational.js';
@@ -357,6 +358,58 @@ export class Frame {
         // Clear the cache as the underlying context has changed
         this._hwFramesCtx = undefined;
     }
+    /**
+     * Check if this is a video frame.
+     *
+     * Video frames have width and height > 0.
+     *
+     * @returns true if this is a video frame
+     *
+     * @example
+     * ```typescript
+     * if (frame.isVideo()) {
+     *   console.log(`Video frame: ${frame.width}x${frame.height}`);
+     * }
+     * ```
+     */
+    isVideo() {
+        return this.width > 0 && this.height > 0;
+    }
+    /**
+     * Check if this is an audio frame.
+     *
+     * Audio frames have sampleRate > 0 and nbSamples > 0.
+     *
+     * @returns true if this is an audio frame
+     *
+     * @example
+     * ```typescript
+     * if (frame.isAudio()) {
+     *   console.log(`Audio frame: ${frame.sampleRate}Hz, ${frame.nbSamples} samples`);
+     * }
+     * ```
+     */
+    isAudio() {
+        return this.sampleRate > 0 && this.nbSamples > 0;
+    }
+    /**
+     * Get the media type of this frame.
+     *
+     * @returns AVMEDIA_TYPE_VIDEO for video frames, AVMEDIA_TYPE_AUDIO for audio frames, or AVMEDIA_TYPE_UNKNOWN
+     *
+     * @example
+     * ```typescript
+     * const type = frame.getMediaType();
+     * console.log(`Frame type: ${type}`);
+     * ```
+     */
+    getMediaType() {
+        if (this.isVideo())
+            return AVMEDIA_TYPE_VIDEO;
+        if (this.isAudio())
+            return AVMEDIA_TYPE_AUDIO;
+        return AVMEDIA_TYPE_UNKNOWN;
+    }
     /**
      * Allocate a new frame.
      *
@@ -407,6 +460,7 @@ export class Frame {
      * Direct mapping to av_frame_ref().
      *
      * @param src - Source frame to reference
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_ENOMEM: Memory allocation failure
      *   - AVERROR_EINVAL: Invalid parameters
@@ -489,6 +543,7 @@ export class Frame {
      * Direct mapping to av_frame_get_buffer().
      *
      * @param align - Buffer size alignment (0 for default)
+     *
      * @returns Required buffer size in bytes, or negative AVERROR:
      *   - AVERROR_EINVAL: Invalid frame parameters
      *
@@ -569,6 +624,7 @@ export class Frame {
      * Direct mapping to av_frame_copy_props().
      *
      * @param src - Source frame to copy properties from
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_ENOMEM: Memory allocation failure
      *
@@ -595,6 +651,7 @@ export class Frame {
      * Direct mapping to av_frame_copy().
      *
      * @param src - Source frame to copy from
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Incompatible frames
      *
@@ -625,6 +682,7 @@ export class Frame {
      * Frame must have allocated buffers.
      *
      * @param buffer - Source buffer with frame data
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Invalid parameters
      *
@@ -649,7 +707,9 @@ export class Frame {
      * Direct mapping to av_hwframe_transfer_data().
      *
      * @param dst - Destination frame (software or hardware)
+     *
      * @param flags - Transfer flags (0 for default)
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Invalid parameters
      *   - AVERROR_ENOMEM: Memory allocation failure
@@ -671,6 +731,39 @@ export class Frame {
     async hwframeTransferData(dst, flags) {
         return await this.native.hwframeTransferData(dst.getNative(), flags ?? 0);
     }
+    /**
+     * Transfer data between hardware and software frames synchronously.
+     * Synchronous version of hwframeTransferData.
+     *
+     * Copies frame data between GPU and system memory.
+     * Direction depends on source and destination frame types.
+     *
+     * Direct mapping to av_hwframe_transfer_data().
+     *
+     * @param dst - Destination frame (software or hardware)
+     *
+     * @param flags - Transfer flags (0 for default)
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EINVAL: Invalid parameters
+     *   - AVERROR_ENOMEM: Memory allocation failure
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     *
+     * // Download from GPU to CPU
+     * const swFrame = new Frame();
+     * swFrame.alloc();
+     * const ret = hwFrame.hwframeTransferData(swFrame);
+     * FFmpegError.throwIfError(ret, 'hwframeTransferData');
+     * ```
+     *
+     * @see {@link hwframeTransferData} For async version
+     */
+    hwframeTransferDataSync(dst, flags) {
+        return this.native.hwframeTransferDataSync(dst.getNative(), flags ?? 0);
+    }
     /**
      * Check if this is a hardware frame.
      *
@@ -720,6 +813,7 @@ export class Frame {
      * Direct mapping to av_frame_get_side_data().
      *
      * @param type - Type of side data to retrieve
+     *
      * @returns Side data buffer, or null if not present
      *
      * @example
@@ -747,7 +841,9 @@ export class Frame {
      * Direct mapping to av_frame_new_side_data().
      *
      * @param type - Type of side data
+     *
      * @param size - Size in bytes to allocate
+     *
      * @returns Allocated buffer for writing
      *
      * @throws {Error} If allocation fails

package/dist/lib/frame.js.map

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

@@ -56,6 +56,7 @@ export declare class HardwareDeviceContext implements Disposable, NativeWrapper<
      * Direct mapping to av_hwdevice_get_type_name().
      *
      * @param type - Hardware device type
+     *
      * @returns Type name string, or null if invalid
      *
      * @example
@@ -98,6 +99,7 @@ export declare class HardwareDeviceContext implements Disposable, NativeWrapper<
      * Direct mapping to av_hwdevice_find_type_by_name().
      *
      * @param name - Hardware type name (e.g., 'cuda', 'vaapi', 'videotoolbox')
+     *
      * @returns Hardware device type enum, or AV_HWDEVICE_TYPE_NONE if not found
      *
      * @example
@@ -189,8 +191,11 @@ export declare class HardwareDeviceContext implements Disposable, NativeWrapper<
      * Direct mapping to av_hwdevice_ctx_create().
      *
      * @param type - Hardware device type
+     *
      * @param device - Device name/path (null for default)
+     *
      * @param options - Device-specific options
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Invalid type or parameters
      *   - AVERROR_ENOMEM: Memory allocation failure
@@ -230,7 +235,9 @@ export declare class HardwareDeviceContext implements Disposable, NativeWrapper<
      * 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:
      *   - AVERROR_EINVAL: Invalid parameters
      *   - AVERROR_ENOSYS: Derivation not supported
@@ -301,6 +308,7 @@ export declare class HardwareDeviceContext implements Disposable, NativeWrapper<
      * Direct mapping to av_hwdevice_get_hwframe_constraints().
      *
      * @param hwconfig - Optional hardware configuration
+     *
      * @returns Frame constraints, or null if not available
      *
      * @example

package/dist/lib/hardware-device-context.js

@@ -56,6 +56,7 @@ export class HardwareDeviceContext {
      * Direct mapping to av_hwdevice_get_type_name().
      *
      * @param type - Hardware device type
+     *
      * @returns Type name string, or null if invalid
      *
      * @example
@@ -102,6 +103,7 @@ export class HardwareDeviceContext {
      * Direct mapping to av_hwdevice_find_type_by_name().
      *
      * @param name - Hardware type name (e.g., 'cuda', 'vaapi', 'videotoolbox')
+     *
      * @returns Hardware device type enum, or AV_HWDEVICE_TYPE_NONE if not found
      *
      * @example
@@ -203,8 +205,11 @@ export class HardwareDeviceContext {
      * Direct mapping to av_hwdevice_ctx_create().
      *
      * @param type - Hardware device type
+     *
      * @param device - Device name/path (null for default)
+     *
      * @param options - Device-specific options
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Invalid type or parameters
      *   - AVERROR_ENOMEM: Memory allocation failure
@@ -246,7 +251,9 @@ export class HardwareDeviceContext {
      * 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:
      *   - AVERROR_EINVAL: Invalid parameters
      *   - AVERROR_ENOSYS: Derivation not supported
@@ -323,6 +330,7 @@ export class HardwareDeviceContext {
      * Direct mapping to av_hwdevice_get_hwframe_constraints().
      *
      * @param hwconfig - Optional hardware configuration
+     *
      * @returns Frame constraints, or null if not available
      *
      * @example

package/dist/lib/hardware-device-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"hardware-device-context.js","sourceRoot":"","sources":["../../src/lib/hardware-device-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAMxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,MAAM,OAAO,qBAAqB;IACxB,MAAM,CAA8B;IAE5C;QACE,IAAI,CAAC,MAAM,GAAG,IAAI,QAAQ,CAAC,qBAAqB,EAAE,CAAC;IACrD,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,WAAW,CAAC,IAAoB;QACrC,OAAO,QAAQ,CAAC,qBAAqB,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,YAAY;QACjB,OAAO,QAAQ,CAAC,qBAAqB,CAAC,YAAY,EAAE,CAAC;IACvD,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,cAAc,CAAC,IAAY;QAChC,OAAO,QAAQ,CAAC,qBAAqB,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;OAMG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IAC3B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,KAAK,CAAC,IAAoB;QACxB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;IACH,MAAM,CAAC,IAAoB,EAAE,SAAwB,IAAI,EAAE,UAA6B,IAAI;QAC1F,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC;IACxE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,aAAa,CAAC,MAA6B,EAAE,IAAoB;QAC/D,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,IAAI;QACF,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;IACrC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,qBAAqB,CAAC,QAAiB;QAQrC,OAAO,IAAI,CAAC,MAAM,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IACrD,CAAC;IAED;;;;;;OAMG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,CAAC,MAAM,CAAC,OAAO,CAAC;QACd,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;IAChC,CAAC;CACF"}
+{"version":3,"file":"hardware-device-context.js","sourceRoot":"","sources":["../../src/lib/hardware-device-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAMxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,MAAM,OAAO,qBAAqB;IACxB,MAAM,CAA8B;IAE5C;QACE,IAAI,CAAC,MAAM,GAAG,IAAI,QAAQ,CAAC,qBAAqB,EAAE,CAAC;IACrD,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,CAAC,WAAW,CAAC,IAAoB;QACrC,OAAO,QAAQ,CAAC,qBAAqB,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,YAAY;QACjB,OAAO,QAAQ,CAAC,qBAAqB,CAAC,YAAY,EAAE,CAAC;IACvD,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,CAAC,cAAc,CAAC,IAAY;QAChC,OAAO,QAAQ,CAAC,qBAAqB,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;OAMG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IAC3B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,KAAK,CAAC,IAAoB;QACxB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0CG;IACH,MAAM,CAAC,IAAoB,EAAE,SAAwB,IAAI,EAAE,UAA6B,IAAI;QAC1F,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC;IACxE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,aAAa,CAAC,MAA6B,EAAE,IAAoB;QAC/D,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,IAAI;QACF,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;IACrC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,qBAAqB,CAAC,QAAiB;QAQrC,OAAO,IAAI,CAAC,MAAM,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IACrD,CAAC;IAED;;;;;;OAMG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,CAAC,MAAM,CAAC,OAAO,CAAC;QACd,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;IAChC,CAAC;CACF"}

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

@@ -192,7 +192,9 @@ export declare class HardwareFramesContext implements Disposable, NativeWrapper<
      * Direct mapping to av_hwframe_get_buffer().
      *
      * @param frame - Frame to allocate buffer for
+     *
      * @param flags - Allocation flags (usually 0)
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_ENOMEM: No frames available in pool
      *   - AVERROR_EINVAL: Invalid parameters
@@ -219,8 +221,11 @@ export declare class HardwareFramesContext implements Disposable, NativeWrapper<
      * Direct mapping to av_hwframe_transfer_data().
      *
      * @param dst - Destination frame
+     *
      * @param src - Source frame
+     *
      * @param flags - Transfer flags (usually 0)
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Invalid parameters
      *   - AVERROR_ENOSYS: Transfer not supported
@@ -248,6 +253,48 @@ export declare class HardwareFramesContext implements Disposable, NativeWrapper<
      * @see {@link map} For zero-copy access
      */
     transferData(dst: Frame, src: Frame, flags?: number): Promise<number>;
+    /**
+     * Transfer frame between hardware and system memory synchronously.
+     * Synchronous version of transferData.
+     *
+     * Copies frame data between GPU and CPU memory.
+     * Direction depends on frame types (hardware vs software).
+     *
+     * Direct mapping to av_hwframe_transfer_data().
+     *
+     * @param dst - Destination frame
+     *
+     * @param src - Source frame
+     *
+     * @param flags - Transfer flags (currently unused, pass 0)
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EINVAL: Invalid frames
+     *   - AVERROR_ENOSYS: Operation not supported
+     *   - AVERROR_ENOMEM: Memory allocation failure
+     *
+     * @example
+     * ```typescript
+     * import { Frame, FFmpegError } from 'node-av';
+     *
+     * // Download from GPU to CPU
+     * const cpuFrame = new Frame();
+     * cpuFrame.format = frames.swFormat;
+     * cpuFrame.width = frames.width;
+     * cpuFrame.height = frames.height;
+     * cpuFrame.allocBuffer();
+     *
+     * const ret = frames.transferDataSync(cpuFrame, hwFrame);
+     * FFmpegError.throwIfError(ret, 'transferDataSync');
+     *
+     * // Upload from CPU to GPU
+     * const ret2 = frames.transferDataSync(hwFrame, cpuFrame);
+     * FFmpegError.throwIfError(ret2, 'transferDataSync');
+     * ```
+     *
+     * @see {@link transferData} For async version
+     */
+    transferDataSync(dst: Frame, src: Frame, flags?: number): number;
     /**
      * Get supported transfer formats.
      *
@@ -257,6 +304,7 @@ export declare class HardwareFramesContext implements Disposable, NativeWrapper<
      * Direct mapping to av_hwframe_transfer_get_formats().
      *
      * @param direction - Transfer direction (FROM/TO hardware)
+     *
      * @returns Array of supported formats, or error code:
      *   - AVERROR_ENOSYS: Query not supported
      *   - AVERROR_ENOMEM: Memory allocation failure
@@ -283,8 +331,11 @@ export declare class HardwareFramesContext implements Disposable, NativeWrapper<
      * Direct mapping to av_hwframe_map().
      *
      * @param dst - Destination frame for mapped data
+     *
      * @param src - Hardware frame to map
+     *
      * @param flags - Mapping flags (AV_HWFRAME_MAP_*)
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Invalid parameters
      *   - AVERROR_ENOSYS: Mapping not supported
@@ -312,9 +363,13 @@ export declare class HardwareFramesContext implements Disposable, NativeWrapper<
      * Direct mapping to av_hwframe_ctx_create_derived().
      *
      * @param format - Pixel format for derived frames
+     *
      * @param derivedDevice - Target device context
+     *
      * @param source - Source frames context
+     *
      * @param flags - Creation flags
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Invalid parameters
      *   - AVERROR_ENOSYS: Derivation not supported

package/dist/lib/hardware-frames-context.js

@@ -233,7 +233,9 @@ export class HardwareFramesContext {
      * Direct mapping to av_hwframe_get_buffer().
      *
      * @param frame - Frame to allocate buffer for
+     *
      * @param flags - Allocation flags (usually 0)
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_ENOMEM: No frames available in pool
      *   - AVERROR_EINVAL: Invalid parameters
@@ -262,8 +264,11 @@ export class HardwareFramesContext {
      * Direct mapping to av_hwframe_transfer_data().
      *
      * @param dst - Destination frame
+     *
      * @param src - Source frame
+     *
      * @param flags - Transfer flags (usually 0)
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Invalid parameters
      *   - AVERROR_ENOSYS: Transfer not supported
@@ -293,6 +298,50 @@ export class HardwareFramesContext {
     async transferData(dst, src, flags) {
         return await this.native.transferData(dst.getNative(), src.getNative(), flags ?? 0);
     }
+    /**
+     * Transfer frame between hardware and system memory synchronously.
+     * Synchronous version of transferData.
+     *
+     * Copies frame data between GPU and CPU memory.
+     * Direction depends on frame types (hardware vs software).
+     *
+     * Direct mapping to av_hwframe_transfer_data().
+     *
+     * @param dst - Destination frame
+     *
+     * @param src - Source frame
+     *
+     * @param flags - Transfer flags (currently unused, pass 0)
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EINVAL: Invalid frames
+     *   - AVERROR_ENOSYS: Operation not supported
+     *   - AVERROR_ENOMEM: Memory allocation failure
+     *
+     * @example
+     * ```typescript
+     * import { Frame, FFmpegError } from 'node-av';
+     *
+     * // Download from GPU to CPU
+     * const cpuFrame = new Frame();
+     * cpuFrame.format = frames.swFormat;
+     * cpuFrame.width = frames.width;
+     * cpuFrame.height = frames.height;
+     * cpuFrame.allocBuffer();
+     *
+     * const ret = frames.transferDataSync(cpuFrame, hwFrame);
+     * FFmpegError.throwIfError(ret, 'transferDataSync');
+     *
+     * // Upload from CPU to GPU
+     * const ret2 = frames.transferDataSync(hwFrame, cpuFrame);
+     * FFmpegError.throwIfError(ret2, 'transferDataSync');
+     * ```
+     *
+     * @see {@link transferData} For async version
+     */
+    transferDataSync(dst, src, flags) {
+        return this.native.transferDataSync(dst.getNative(), src.getNative(), flags ?? 0);
+    }
     /**
      * Get supported transfer formats.
      *
@@ -302,6 +351,7 @@ export class HardwareFramesContext {
      * Direct mapping to av_hwframe_transfer_get_formats().
      *
      * @param direction - Transfer direction (FROM/TO hardware)
+     *
      * @returns Array of supported formats, or error code:
      *   - AVERROR_ENOSYS: Query not supported
      *   - AVERROR_ENOMEM: Memory allocation failure
@@ -330,8 +380,11 @@ export class HardwareFramesContext {
      * Direct mapping to av_hwframe_map().
      *
      * @param dst - Destination frame for mapped data
+     *
      * @param src - Hardware frame to map
+     *
      * @param flags - Mapping flags (AV_HWFRAME_MAP_*)
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Invalid parameters
      *   - AVERROR_ENOSYS: Mapping not supported
@@ -361,9 +414,13 @@ export class HardwareFramesContext {
      * Direct mapping to av_hwframe_ctx_create_derived().
      *
      * @param format - Pixel format for derived frames
+     *
      * @param derivedDevice - Target device context
+     *
      * @param source - Source frames context
+     *
      * @param flags - Creation flags
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Invalid parameters
      *   - AVERROR_ENOSYS: Derivation not supported