node-av 3.1.3 → 4.0.0

package/dist/lib/codec-parameters.d.ts

@@ -1,5 +1,5 @@
 import { Rational } from './rational.js';
-import type { AVChromaLocation, AVCodecID, AVColorPrimaries, AVColorRange, AVColorSpace, AVColorTransferCharacteristic, AVMediaType, AVPixelFormat, AVProfile, AVSampleFormat } from '../constants/constants.js';
+import type { AVChromaLocation, AVCodecID, AVColorPrimaries, AVColorRange, AVColorSpace, AVColorTransferCharacteristic, AVMediaType, AVPacketSideDataType, AVPixelFormat, AVProfile, AVSampleFormat } from '../constants/constants.js';
 import type { CodecContext } from './codec-context.js';
 import type { NativeCodecParameters, NativeWrapper } from './native-types.js';
 import type { ChannelLayout } from './types.js';
@@ -112,6 +112,26 @@ export declare class CodecParameters implements NativeWrapper<NativeCodecParamet
      */
     get bitRate(): bigint;
     set bitRate(value: bigint);
+    /**
+     * Number of bits per coded sample.
+     *
+     * Bits per sample/pixel from the demuxer (needed by some codecs).
+     * For uncompressed formats, this is the bits per sample.
+     *
+     * Direct mapping to AVCodecParameters->bits_per_coded_sample.
+     */
+    get bitsPerCodedSample(): number;
+    set bitsPerCodedSample(value: number);
+    /**
+     * Number of bits per raw sample.
+     *
+     * Bits per sample before compression/encoding.
+     * Only set when different from bitsPerCodedSample.
+     *
+     * Direct mapping to AVCodecParameters->bits_per_raw_sample.
+     */
+    get bitsPerRawSample(): number;
+    set bitsPerRawSample(value: number);
     /**
      * Codec profile.
      *
@@ -238,6 +258,51 @@ export declare class CodecParameters implements NativeWrapper<NativeCodecParamet
      */
     get sampleRate(): number;
     set sampleRate(value: number);
+    /**
+     * Audio frame size in samples.
+     *
+     * Number of samples per audio frame for codecs with constant frame size.
+     * For AAC this is typically 1024, for MP3 it's 1152.
+     * For codecs with variable frame size, this may be 0.
+     *
+     * Direct mapping to AVCodecParameters->frame_size.
+     */
+    get frameSize(): number;
+    set frameSize(value: number);
+    /**
+     * Initial audio padding.
+     *
+     * Amount of padding (priming) samples at the beginning of the audio stream.
+     * For AAC encoding, this is typically 1024 samples.
+     * The muxer uses this value to correctly calculate packet timestamps.
+     *
+     * Direct mapping to AVCodecParameters->initial_padding.
+     */
+    get initialPadding(): number;
+    set initialPadding(value: number);
+    /**
+     * Video delay in frames.
+     *
+     * Number of frames the decoded output will be delayed relative to the encoded input.
+     * Used for timestamp correction in video streams.
+     *
+     * Direct mapping to AVCodecParameters->video_delay.
+     */
+    get videoDelay(): number;
+    set videoDelay(value: number);
+    /**
+     * Number of coded side data entries.
+     *
+     * Returns the count of coded side data attached to codec parameters.
+     *
+     * @returns Number of side data entries
+     *
+     * @example
+     * ```typescript
+     * console.log(`Codec has ${params.nbCodedSideData} side data entries`);
+     * ```
+     */
+    get nbCodedSideData(): number;
     /**
      * Allocate codec parameters.
      *
@@ -347,6 +412,38 @@ export declare class CodecParameters implements NativeWrapper<NativeCodecParamet
      * @see {@link fromContext} To extract from context
      */
     toContext(codecContext: CodecContext): number;
+    /**
+     * Parse extradata to extract codec parameters.
+     *
+     * Opens a decoder to parse extradata (SPS/PPS for H.264, etc.) and extract
+     * codec parameters like width/height for video or sample_rate for audio.
+     * This is used when extradata exists (e.g., from SDP sprop-parameter-sets)
+     * but dimensions are missing due to insufficient probesize.
+     *
+     * Uses FFmpeg's decoder to parse extradata, same as avformat_find_stream_info()
+     * does internally. Works for all codecs (H.264, H.265, VP9, AV1, etc.).
+     *
+     * @returns 0 on success, negative error code on failure
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     *
+     * // After opening RTSP with low probesize
+     * const input = await Demuxer.open('rtsp://...', {
+     *   options: { probesize: 32 }
+     * });
+     *
+     * const stream = input.video();
+     * if (stream.codecpar.width === 0 && stream.codecpar.extradata) {
+     *   // Parse extradata to get dimensions
+     *   const ret = stream.codecpar.parseExtradata();
+     *   FFmpegError.throwIfError(ret, 'parseExtradata');
+     *   console.log(`Dimensions: ${stream.codecpar.width}x${stream.codecpar.height}`);
+     * }
+     * ```
+     */
+    parseExtradata(): number;
     /**
      * Convert to JSON representation.
      *
@@ -362,6 +459,91 @@ export declare class CodecParameters implements NativeWrapper<NativeCodecParamet
      * ```
      */
     toJSON(): Record<string, any>;
+    /**
+     * Get coded side data.
+     *
+     * Retrieves additional data associated with the codec parameters
+     * (e.g., HDR metadata, Dolby Vision configuration, mastering display).
+     *
+     * Direct mapping to accessing AVCodecParameters.coded_side_data.
+     *
+     * @param type - Type of side data to retrieve
+     *
+     * @returns Side data buffer, or null if not present
+     *
+     * @example
+     * ```typescript
+     * import { AV_PKT_DATA_MASTERING_DISPLAY_METADATA } from 'node-av/constants';
+     *
+     * // Get HDR mastering display metadata
+     * const hdrData = params.getCodedSideData(AV_PKT_DATA_MASTERING_DISPLAY_METADATA);
+     * if (hdrData) {
+     *   console.log(`HDR metadata: ${hdrData.length} bytes`);
+     * }
+     * ```
+     *
+     * @see {@link addCodedSideData} To add side data
+     * @see {@link nbCodedSideData} For count of side data entries
+     */
+    getCodedSideData(type: AVPacketSideDataType): Buffer | null;
+    /**
+     * Get all coded side data entries.
+     *
+     * Returns all side data attached to the codec parameters.
+     * Each entry contains the type and data buffer.
+     * This allows iteration over all side data like FFmpeg CLI does.
+     *
+     * Direct mapping to accessing AVCodecParameters.coded_side_data array.
+     *
+     * @returns Array of side data entries with type and data
+     *
+     * @example
+     * ```typescript
+     * // Iterate all side data like FFmpeg does (ffmpeg_mux_init.c)
+     * const allSideData = params.getAllCodedSideData();
+     * for (const sd of allSideData) {
+     *   console.log(`Type: ${sd.type}, Size: ${sd.data.length}`);
+     *   // Copy to output stream
+     *   outParams.addCodedSideData(sd.type, sd.data);
+     * }
+     * ```
+     *
+     * @see {@link getCodedSideData} To get specific side data by type
+     * @see {@link addCodedSideData} To add side data
+     * @see {@link nbCodedSideData} For count of side data entries
+     */
+    getAllCodedSideData(): {
+        type: AVPacketSideDataType;
+        data: Buffer;
+    }[];
+    /**
+     * Add coded side data to codec parameters.
+     *
+     * Attaches additional data to the codec parameters. The data is copied.
+     * Commonly used for HDR metadata, Dolby Vision configuration, etc.
+     *
+     * Direct mapping to av_packet_side_data_add() for coded_side_data.
+     *
+     * @param type - Type of side data
+     *
+     * @param data - Side data buffer
+     *
+     * @returns 0 on success, negative AVERROR on error
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     * import { AV_PKT_DATA_DOVI_CONF } from 'node-av/constants';
+     *
+     * // Add Dolby Vision configuration
+     * const doviConf = Buffer.from([...]); // Dolby Vision config data
+     * const ret = params.addCodedSideData(AV_PKT_DATA_DOVI_CONF, doviConf);
+     * FFmpegError.throwIfError(ret, 'addCodedSideData');
+     * ```
+     *
+     * @see {@link getCodedSideData} To retrieve side data
+     */
+    addCodedSideData(type: AVPacketSideDataType, data: Buffer): number;
     /**
      * Get the underlying native CodecParameters object.
      *

package/dist/lib/codec-parameters.js

@@ -146,6 +146,34 @@ export class CodecParameters {
     set bitRate(value) {
         this.native.bitRate = value;
     }
+    /**
+     * Number of bits per coded sample.
+     *
+     * Bits per sample/pixel from the demuxer (needed by some codecs).
+     * For uncompressed formats, this is the bits per sample.
+     *
+     * Direct mapping to AVCodecParameters->bits_per_coded_sample.
+     */
+    get bitsPerCodedSample() {
+        return this.native.bitsPerCodedSample;
+    }
+    set bitsPerCodedSample(value) {
+        this.native.bitsPerCodedSample = value;
+    }
+    /**
+     * Number of bits per raw sample.
+     *
+     * Bits per sample before compression/encoding.
+     * Only set when different from bitsPerCodedSample.
+     *
+     * Direct mapping to AVCodecParameters->bits_per_raw_sample.
+     */
+    get bitsPerRawSample() {
+        return this.native.bitsPerRawSample;
+    }
+    set bitsPerRawSample(value) {
+        this.native.bitsPerRawSample = value;
+    }
     /**
      * Codec profile.
      *
@@ -330,6 +358,65 @@ export class CodecParameters {
     set sampleRate(value) {
         this.native.sampleRate = value;
     }
+    /**
+     * Audio frame size in samples.
+     *
+     * Number of samples per audio frame for codecs with constant frame size.
+     * For AAC this is typically 1024, for MP3 it's 1152.
+     * For codecs with variable frame size, this may be 0.
+     *
+     * Direct mapping to AVCodecParameters->frame_size.
+     */
+    get frameSize() {
+        return this.native.frameSize;
+    }
+    set frameSize(value) {
+        this.native.frameSize = value;
+    }
+    /**
+     * Initial audio padding.
+     *
+     * Amount of padding (priming) samples at the beginning of the audio stream.
+     * For AAC encoding, this is typically 1024 samples.
+     * The muxer uses this value to correctly calculate packet timestamps.
+     *
+     * Direct mapping to AVCodecParameters->initial_padding.
+     */
+    get initialPadding() {
+        return this.native.initialPadding;
+    }
+    set initialPadding(value) {
+        this.native.initialPadding = value;
+    }
+    /**
+     * Video delay in frames.
+     *
+     * Number of frames the decoded output will be delayed relative to the encoded input.
+     * Used for timestamp correction in video streams.
+     *
+     * Direct mapping to AVCodecParameters->video_delay.
+     */
+    get videoDelay() {
+        return this.native.videoDelay;
+    }
+    set videoDelay(value) {
+        this.native.videoDelay = value;
+    }
+    /**
+     * Number of coded side data entries.
+     *
+     * Returns the count of coded side data attached to codec parameters.
+     *
+     * @returns Number of side data entries
+     *
+     * @example
+     * ```typescript
+     * console.log(`Codec has ${params.nbCodedSideData} side data entries`);
+     * ```
+     */
+    get nbCodedSideData() {
+        return this.native.nbCodedSideData;
+    }
     /**
      * Allocate codec parameters.
      *
@@ -449,6 +536,40 @@ export class CodecParameters {
     toContext(codecContext) {
         return this.native.toContext(codecContext.getNative());
     }
+    /**
+     * Parse extradata to extract codec parameters.
+     *
+     * Opens a decoder to parse extradata (SPS/PPS for H.264, etc.) and extract
+     * codec parameters like width/height for video or sample_rate for audio.
+     * This is used when extradata exists (e.g., from SDP sprop-parameter-sets)
+     * but dimensions are missing due to insufficient probesize.
+     *
+     * Uses FFmpeg's decoder to parse extradata, same as avformat_find_stream_info()
+     * does internally. Works for all codecs (H.264, H.265, VP9, AV1, etc.).
+     *
+     * @returns 0 on success, negative error code on failure
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     *
+     * // After opening RTSP with low probesize
+     * const input = await Demuxer.open('rtsp://...', {
+     *   options: { probesize: 32 }
+     * });
+     *
+     * const stream = input.video();
+     * if (stream.codecpar.width === 0 && stream.codecpar.extradata) {
+     *   // Parse extradata to get dimensions
+     *   const ret = stream.codecpar.parseExtradata();
+     *   FFmpegError.throwIfError(ret, 'parseExtradata');
+     *   console.log(`Dimensions: ${stream.codecpar.width}x${stream.codecpar.height}`);
+     * }
+     * ```
+     */
+    parseExtradata() {
+        return this.native.parseExtradata();
+    }
     /**
      * Convert to JSON representation.
      *
@@ -466,6 +587,94 @@ export class CodecParameters {
     toJSON() {
         return this.native.toJSON();
     }
+    /**
+     * Get coded side data.
+     *
+     * Retrieves additional data associated with the codec parameters
+     * (e.g., HDR metadata, Dolby Vision configuration, mastering display).
+     *
+     * Direct mapping to accessing AVCodecParameters.coded_side_data.
+     *
+     * @param type - Type of side data to retrieve
+     *
+     * @returns Side data buffer, or null if not present
+     *
+     * @example
+     * ```typescript
+     * import { AV_PKT_DATA_MASTERING_DISPLAY_METADATA } from 'node-av/constants';
+     *
+     * // Get HDR mastering display metadata
+     * const hdrData = params.getCodedSideData(AV_PKT_DATA_MASTERING_DISPLAY_METADATA);
+     * if (hdrData) {
+     *   console.log(`HDR metadata: ${hdrData.length} bytes`);
+     * }
+     * ```
+     *
+     * @see {@link addCodedSideData} To add side data
+     * @see {@link nbCodedSideData} For count of side data entries
+     */
+    getCodedSideData(type) {
+        return this.native.getCodedSideData(type);
+    }
+    /**
+     * Get all coded side data entries.
+     *
+     * Returns all side data attached to the codec parameters.
+     * Each entry contains the type and data buffer.
+     * This allows iteration over all side data like FFmpeg CLI does.
+     *
+     * Direct mapping to accessing AVCodecParameters.coded_side_data array.
+     *
+     * @returns Array of side data entries with type and data
+     *
+     * @example
+     * ```typescript
+     * // Iterate all side data like FFmpeg does (ffmpeg_mux_init.c)
+     * const allSideData = params.getAllCodedSideData();
+     * for (const sd of allSideData) {
+     *   console.log(`Type: ${sd.type}, Size: ${sd.data.length}`);
+     *   // Copy to output stream
+     *   outParams.addCodedSideData(sd.type, sd.data);
+     * }
+     * ```
+     *
+     * @see {@link getCodedSideData} To get specific side data by type
+     * @see {@link addCodedSideData} To add side data
+     * @see {@link nbCodedSideData} For count of side data entries
+     */
+    getAllCodedSideData() {
+        return this.native.getAllCodedSideData();
+    }
+    /**
+     * Add coded side data to codec parameters.
+     *
+     * Attaches additional data to the codec parameters. The data is copied.
+     * Commonly used for HDR metadata, Dolby Vision configuration, etc.
+     *
+     * Direct mapping to av_packet_side_data_add() for coded_side_data.
+     *
+     * @param type - Type of side data
+     *
+     * @param data - Side data buffer
+     *
+     * @returns 0 on success, negative AVERROR on error
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     * import { AV_PKT_DATA_DOVI_CONF } from 'node-av/constants';
+     *
+     * // Add Dolby Vision configuration
+     * const doviConf = Buffer.from([...]); // Dolby Vision config data
+     * const ret = params.addCodedSideData(AV_PKT_DATA_DOVI_CONF, doviConf);
+     * FFmpegError.throwIfError(ret, 'addCodedSideData');
+     * ```
+     *
+     * @see {@link getCodedSideData} To retrieve side data
+     */
+    addCodedSideData(type, data) {
+        return this.native.addCodedSideData(type, data);
+    }
     /**
      * Get the underlying native CodecParameters object.
      *

package/dist/lib/codec-parameters.js.map

@@ -1 +1 @@
-{"version":3,"file":"codec-parameters.js","sourceRoot":"","sources":["../../src/lib/codec-parameters.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"codec-parameters.js","sourceRoot":"","sources":["../../src/lib/codec-parameters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAmBhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,OAAO,eAAe;IAClB,MAAM,CAAwB;IAEtC;QACE,IAAI,CAAC,MAAM,GAAG,IAAI,QAAQ,CAAC,eAAe,EAAE,CAAC;IAC/C,CAAC;IAED;;;;;;OAMG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;IAC/B,CAAC;IAED,IAAI,SAAS,CAAC,KAAkB;QAC9B,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC;IAChC,CAAC;IAED;;;;;;OAMG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;IAC7B,CAAC;IAED,IAAI,OAAO,CAAC,KAAgB;QAC1B,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;IAC9B,CAAC;IAED;;;;;;OAMG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAED,IAAI,QAAQ,CAAC,KAAsB;QACjC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;YAChE,CAAC;YAED,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC;IAC/B,CAAC;IAED;;;;;OAKG;IACH,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;IACpC,CAAC;IAED;;;;;;OAMG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;IAC/B,CAAC;IAED,IAAI,SAAS,CAAC,KAAoB;QAChC,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC;IAChC,CAAC;IAED;;;;;;OAMG;IACH,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC;IACnC,CAAC;IAED;;;;;;OAMG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED,IAAI,MAAM,CAAC,KAAqC;QAC9C,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC;IAC7B,CAAC;IAED;;;;;;OAMG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;IAC7B,CAAC;IAED,IAAI,OAAO,CAAC,KAAa;QACvB,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;IAC9B,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,kBAAkB;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC;IACxC,CAAC;IAED,IAAI,kBAAkB,CAAC,KAAa;QAClC,IAAI,CAAC,MAAM,CAAC,kBAAkB,GAAG,KAAK,CAAC;IACzC,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,gBAAgB;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC;IACtC,CAAC;IAED,IAAI,gBAAgB,CAAC,KAAa;QAChC,IAAI,CAAC,MAAM,CAAC,gBAAgB,GAAG,KAAK,CAAC;IACvC,CAAC;IAED;;;;;;OAMG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;IAC7B,CAAC;IAED,IAAI,OAAO,CAAC,KAAgB;QAC1B,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;IAC9B,CAAC;IAED;;;;;;OAMG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IAC3B,CAAC;IAED,IAAI,KAAK,CAAC,KAAa;QACrB,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;IAC5B,CAAC;IAED;;;;;;OAMG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IAC3B,CAAC;IAED,IAAI,KAAK,CAAC,KAAa;QACrB,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;IAC5B,CAAC;IAED;;;;;;OAMG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED,IAAI,MAAM,CAAC,KAAa;QACtB,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC;IAC7B,CAAC;IAED;;;;;;OAMG;IACH,IAAI,iBAAiB;QACnB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC;QAC1C,OAAO,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,iBAAiB,CAAC,KAAe;QACnC,IAAI,CAAC,MAAM,CAAC,iBAAiB,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC;IACrE,CAAC;IAED;;;;;;OAMG;IACH,IAAI,SAAS;QACX,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;QACjC,OAAO,IAAI,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,SAAS,CAAC,KAAe;QAC3B,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC;IAC7D,CAAC;IAED;;;;;;OAMG;IACH,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;IAChC,CAAC;IAED,IAAI,UAAU,CAAC,KAAmB;QAChC,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC;IACjC,CAAC;IAED;;;;;;OAMG;IACH,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;IACpC,CAAC;IAED,IAAI,cAAc,CAAC,KAAuB;QACxC,IAAI,CAAC,MAAM,CAAC,cAAc,GAAG,KAAK,CAAC;IACrC,CAAC;IAED;;;;;;OAMG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAED,IAAI,QAAQ,CAAC,KAAoC;QAC/C,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC;IAC/B,CAAC;IAED;;;;;;OAMG;IACH,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;IAChC,CAAC;IAED,IAAI,UAAU,CAAC,KAAmB;QAChC,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC;IACjC,CAAC;IAED;;;;;;OAMG;IACH,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;IACpC,CAAC;IAED,IAAI,cAAc,CAAC,KAAuB;QACxC,IAAI,CAAC,MAAM,CAAC,cAAc,GAAG,KAAK,CAAC;IACrC,CAAC;IAED;;;;;;OAMG;IACH,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC;IACnC,CAAC;IAED,IAAI,aAAa,CAAC,KAAoB;QACpC,IAAI,CAAC,MAAM,CAAC,aAAa,GAAG,KAAK,CAAC;IACpC,CAAC;IAED;;;;;;OAMG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAED,IAAI,QAAQ,CAAC,KAAa;QACxB,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC;IAC/B,CAAC;IAED;;;;;;OAMG;IACH,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;IAChC,CAAC;IAED,IAAI,UAAU,CAAC,KAAa;QAC1B,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC;IACjC,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;IAC/B,CAAC;IAED,IAAI,SAAS,CAAC,KAAa;QACzB,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC;IAChC,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;IACpC,CAAC;IAED,IAAI,cAAc,CAAC,KAAa;QAC9B,IAAI,CAAC,MAAM,CAAC,cAAc,GAAG,KAAK,CAAC;IACrC,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;IAChC,CAAC;IAED,IAAI,UAAU,CAAC,KAAa;QAC1B,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC;IACjC,CAAC;IAED;;;;;;;;;;;OAWG;IACH,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC;IACrC,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,KAAK;QACH,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,IAAI;QACF,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,IAAI,CAAC,GAAoB;QACvB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,WAAW,CAAC,YAA0B;QACpC,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,SAAS,CAAC,YAA0B;QAClC,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC;IACzD,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;IACtC,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,MAAM;QACJ,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IAC9B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,gBAAgB,CAAC,IAA0B;QACzC,OAAO,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,mBAAmB;QACjB,OAAO,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;IAC3C,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,gBAAgB,CAAC,IAA0B,EAAE,IAAY;QACvD,OAAO,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAClD,CAAC;IAED;;;;;;OAMG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,CAAC,MAAM,CAAC,OAAO,CAAC;QACd,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;IAChC,CAAC;CACF"}

package/dist/lib/codec-parser.d.ts

@@ -133,6 +133,29 @@ export declare class CodecParser implements Disposable, NativeWrapper<NativeCode
      * @see {@link init} To initialize parser
      */
     parse2(codecContext: CodecContext, packet: Packet, data: Buffer, pts: bigint, dts: bigint, pos: number): number;
+    /**
+     * Number of pictures to repeat for field-based interlaced content.
+     *
+     * Used to calculate frame duration for interlaced video:
+     * `frame_duration = (1 + repeat_pict) * time_base`
+     *
+     * Commonly used in H.264 to display telecined material.
+     * Value comes from the codec parser after parsing a frame.
+     *
+     * Direct mapping to AVCodecParserContext.repeat_pict.
+     *
+     * @returns Repeat picture count (0 for progressive, >0 for interlaced)
+     *
+     * @example
+     * ```typescript
+     * const parser = stream.parser;
+     * if (parser) {
+     *   const fields = 1 + parser.repeatPict;
+     *   console.log(`Frame uses ${fields} fields`);
+     * }
+     * ```
+     */
+    get repeatPict(): number;
     /**
      * Close the codec parser.
      *

package/dist/lib/codec-parser.js

@@ -136,6 +136,31 @@ export class CodecParser {
     parse2(codecContext, packet, data, pts, dts, pos) {
         return this.native.parse2(codecContext.getNative(), packet.getNative(), data, pts, dts, pos);
     }
+    /**
+     * Number of pictures to repeat for field-based interlaced content.
+     *
+     * Used to calculate frame duration for interlaced video:
+     * `frame_duration = (1 + repeat_pict) * time_base`
+     *
+     * Commonly used in H.264 to display telecined material.
+     * Value comes from the codec parser after parsing a frame.
+     *
+     * Direct mapping to AVCodecParserContext.repeat_pict.
+     *
+     * @returns Repeat picture count (0 for progressive, >0 for interlaced)
+     *
+     * @example
+     * ```typescript
+     * const parser = stream.parser;
+     * if (parser) {
+     *   const fields = 1 + parser.repeatPict;
+     *   console.log(`Frame uses ${fields} fields`);
+     * }
+     * ```
+     */
+    get repeatPict() {
+        return this.native.repeatPict;
+    }
     /**
      * Close the codec parser.
      *

package/dist/lib/codec-parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"codec-parser.js","sourceRoot":"","sources":["../../src/lib/codec-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAOxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,OAAO,WAAW;IACd,MAAM,CAAoB;IAElC;QACE,IAAI,CAAC,MAAM,GAAG,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC3C,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,IAAI,CAAC,OAAkB;QACrB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwDG;IACH,MAAM,CAAC,YAA0B,EAAE,MAAc,EAAE,IAAY,EAAE,GAAW,EAAE,GAAW,EAAE,GAAW;QACpG,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,EAAE,MAAM,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAC/F,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK;QACH,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;IAED;;;;;;OAMG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,CAAC,MAAM,CAAC,OAAO,CAAC;QACd,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;CACF"}
+{"version":3,"file":"codec-parser.js","sourceRoot":"","sources":["../../src/lib/codec-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAOxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,OAAO,WAAW;IACd,MAAM,CAAoB;IAElC;QACE,IAAI,CAAC,MAAM,GAAG,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC3C,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,IAAI,CAAC,OAAkB;QACrB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwDG;IACH,MAAM,CAAC,YAA0B,EAAE,MAAc,EAAE,IAAY,EAAE,GAAW,EAAE,GAAW,EAAE,GAAW;QACpG,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,EAAE,MAAM,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAC/F,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;IAChC,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK;QACH,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;IAED;;;;;;OAMG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,CAAC,MAAM,CAAC,OAAO,CAAC;QACd,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;CACF"}

package/dist/lib/codec.d.ts

@@ -2,6 +2,7 @@ import { Rational } from './rational.js';
 import type { AVCodecCap, AVCodecID, AVHWDeviceType, AVMediaType, AVPixelFormat, AVSampleFormat } from '../constants/constants.js';
 import type { FFDecoderCodec } from '../constants/decoders.js';
 import type { FFEncoderCodec } from '../constants/encoders.js';
+import type { FFHWDeviceType } from '../constants/hardware.js';
 import type { NativeCodec, NativeWrapper } from './native-types.js';
 import type { ChannelLayout, CodecProfile } from './types.js';
 /**
@@ -260,6 +261,27 @@ export declare class Codec implements NativeWrapper<NativeCodec> {
      * Direct mapping to AVCodec->capabilities.
      */
     get capabilities(): AVCodecCap;
+    /**
+     * Check if codec has specific capabilities.
+     *
+     * Tests whether all specified capabilities are present using bitwise AND.
+     *
+     * @param caps - One or more capability values to check
+     *
+     * @returns true if all specified capabilities are present, false otherwise
+     *
+     * @example
+     * ```typescript
+     * import { AV_CODEC_CAP_HARDWARE } from 'node-av/constants';
+     *
+     * if (codec.hasCapabilities(AV_CODEC_CAP_HARDWARE)) {
+     *   console.log('This codec supports hardware acceleration');
+     * }
+     * ```
+     *
+     * @see {@link capabilities} For direct capabilities access
+     */
+    hasCapabilities(...caps: AVCodecCap[]): boolean;
     /**
      * Maximum lowres value.
      *
@@ -413,7 +435,7 @@ export declare class Codec implements NativeWrapper<NativeCodec> {
      *
      * @see {@link getSupportedDeviceTypes} For all supported types
      */
-    supportsDevice(deviceType: AVHWDeviceType): boolean;
+    supportsDevice(deviceType: AVHWDeviceType | FFHWDeviceType): boolean;
     /**
      * Check if decoder supports hardware acceleration.
      *
@@ -436,7 +458,7 @@ export declare class Codec implements NativeWrapper<NativeCodec> {
      * }
      * ```
      */
-    isHardwareAcceleratedDecoder(deviceType?: AVHWDeviceType): boolean;
+    isHardwareAcceleratedDecoder(deviceType?: AVHWDeviceType | FFHWDeviceType): boolean;
     /**
      * Check if encoder supports hardware acceleration.
      *
@@ -459,7 +481,7 @@ export declare class Codec implements NativeWrapper<NativeCodec> {
      * }
      * ```
      */
-    isHardwareAcceleratedEncoder(deviceType?: AVHWDeviceType): boolean;
+    isHardwareAcceleratedEncoder(deviceType?: AVHWDeviceType | FFHWDeviceType): boolean;
     /**
      * Get supported hardware device types.
      *
@@ -503,7 +525,7 @@ export declare class Codec implements NativeWrapper<NativeCodec> {
      * }
      * ```
      */
-    getHardwareMethod(deviceType: AVHWDeviceType): number | null;
+    getHardwareMethod(deviceType: AVHWDeviceType | FFHWDeviceType): number | null;
     /**
      * Get hardware configuration at index.
      *

package/dist/lib/codec.js

@@ -1,6 +1,7 @@
 import { AV_CODEC_HW_CONFIG_METHOD_HW_DEVICE_CTX, AV_CODEC_HW_CONFIG_METHOD_HW_FRAMES_CTX } from '../constants/constants.js';
 import { bindings } from './binding.js';
 import { Rational } from './rational.js';
+import { avGetHardwareDeviceTypeFromName } from './utilities.js';
 /**
  * Codec descriptor for audio/video encoding and decoding.
  *
@@ -289,6 +290,34 @@ export class Codec {
     get capabilities() {
         return this.native.capabilities;
     }
+    /**
+     * Check if codec has specific capabilities.
+     *
+     * Tests whether all specified capabilities are present using bitwise AND.
+     *
+     * @param caps - One or more capability values to check
+     *
+     * @returns true if all specified capabilities are present, false otherwise
+     *
+     * @example
+     * ```typescript
+     * import { AV_CODEC_CAP_HARDWARE } from 'node-av/constants';
+     *
+     * if (codec.hasCapabilities(AV_CODEC_CAP_HARDWARE)) {
+     *   console.log('This codec supports hardware acceleration');
+     * }
+     * ```
+     *
+     * @see {@link capabilities} For direct capabilities access
+     */
+    hasCapabilities(...caps) {
+        for (const cap of caps) {
+            if ((this.native.capabilities & cap) !== cap) {
+                return false;
+            }
+        }
+        return true;
+    }
     /**
      * Maximum lowres value.
      *
@@ -486,6 +515,9 @@ export class Codec {
             const config = this.getHwConfig(i);
             if (!config)
                 break;
+            if (typeof deviceType === 'string') {
+                deviceType = avGetHardwareDeviceTypeFromName(deviceType);
+            }
             // Check if this config is for the requested device type
             if (config.deviceType === deviceType) {
                 // Check if it has any valid hardware method
@@ -616,6 +648,9 @@ export class Codec {
             const config = this.getHwConfig(i);
             if (!config)
                 break;
+            if (typeof deviceType === 'string') {
+                deviceType = avGetHardwareDeviceTypeFromName(deviceType);
+            }
             if (config.deviceType === deviceType) {
                 return config.methods;
             }