@revizly/node-av 5.2.2-beta.1

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

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

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

@@ -0,0 +1,201 @@
+import type { AVCodecID } from '../constants/constants.js';
+import type { CodecContext } from './codec-context.js';
+import type { NativeCodecParser, NativeWrapper } from './native-types.js';
+import type { Packet } from './packet.js';
+/**
+ * Parser for extracting codec frames from raw bitstream data.
+ *
+ * Analyzes and splits raw bitstream data into individual codec frames.
+ * Essential for processing elementary streams, extracting NAL units,
+ * and handling frame boundaries in raw codec data. Commonly used for
+ * parsing H.264/H.265 streams, AAC ADTS streams, and other raw formats.
+ *
+ * Direct mapping to FFmpeg's AVCodecParserContext.
+ *
+ * @example
+ * ```typescript
+ * import { CodecParser, CodecContext, Packet, FFmpegError } from 'node-av';
+ * import { AV_CODEC_ID_H264 } from 'node-av/constants';
+ *
+ * // Create and initialize parser
+ * const parser = new CodecParser();
+ * parser.init(AV_CODEC_ID_H264);
+ *
+ * // Parse raw data into packets
+ * const packet = new Packet();
+ * packet.alloc();
+ *
+ * const rawData = Buffer.from([...]); // Raw H.264 stream
+ * const ret = parser.parse2(
+ *   codecContext,
+ *   packet,
+ *   rawData,
+ *   0n,  // pts
+ *   0n,  // dts
+ *   0    // position
+ * );
+ *
+ * if (ret > 0) {
+ *   // Got complete packet, ret is consumed bytes
+ *   console.log(`Parsed ${ret} bytes into packet`);
+ * }
+ *
+ * // Cleanup
+ * parser.close();
+ * ```
+ *
+ * @see [AVCodecParserContext](https://ffmpeg.org/doxygen/trunk/structAVCodecParserContext.html) - FFmpeg Doxygen
+ * @see {@link CodecContext} For decoding parsed packets
+ */
+export declare class CodecParser implements Disposable, NativeWrapper<NativeCodecParser> {
+    private native;
+    constructor();
+    /**
+     * Initialize parser for specific codec.
+     *
+     * Sets up the parser to handle a specific codec format.
+     * Must be called before parsing data.
+     *
+     * Direct mapping to av_parser_init().
+     *
+     * @param codecId - Codec ID to parse
+     *
+     * @throws {Error} If codec parser not available
+     *
+     * @example
+     * ```typescript
+     * import { AV_CODEC_ID_AAC } from 'node-av/constants';
+     *
+     * const parser = new CodecParser();
+     * parser.init(AV_CODEC_ID_AAC);
+     * // Parser ready for AAC ADTS streams
+     * ```
+     *
+     * @see {@link parse2} To parse data
+     * @see {@link close} To cleanup
+     */
+    init(codecId: AVCodecID): void;
+    /**
+     * Parse bitstream data into packets.
+     *
+     * Analyzes raw bitstream data and extracts complete codec frames.
+     * May require multiple calls to accumulate enough data for a complete frame.
+     * Returns the number of bytes consumed from the input buffer.
+     *
+     * Direct mapping to av_parser_parse2().
+     *
+     * @param codecContext - Codec context for parser state
+     *
+     * @param packet - Packet to receive parsed frame
+     *
+     * @param data - Raw bitstream data to parse
+     *
+     * @param pts - Presentation timestamp for data
+     *
+     * @param dts - Decoding timestamp for data
+     *
+     * @param pos - Byte position in stream
+     *
+     * @returns Number of bytes consumed from data, negative on error:
+     *   - AVERROR_EINVAL: Invalid parameters
+     *   - AVERROR_ENOMEM: Memory allocation failure
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     *
+     * let offset = 0;
+     * while (offset < rawData.length) {
+     *   const remaining = rawData.subarray(offset);
+     *   const ret = parser.parse2(
+     *     codecContext,
+     *     packet,
+     *     remaining,
+     *     pts,
+     *     dts,
+     *     offset
+     *   );
+     *
+     *   if (ret < 0) {
+     *     FFmpegError.throwIfError(ret, 'parse2');
+     *   }
+     *
+     *   offset += ret;
+     *
+     *   if (packet.size > 0) {
+     *     // Got complete packet
+     *     await processPacket(packet);
+     *     packet.unref();
+     *   }
+     * }
+     * ```
+     *
+     * @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.
+     *
+     * Releases all resources associated with the parser.
+     * The parser becomes invalid after calling this.
+     *
+     * Direct mapping to av_parser_close().
+     *
+     * @example
+     * ```typescript
+     * parser.close();
+     * // Parser is now invalid
+     * ```
+     *
+     * @see {@link init} To initialize
+     * @see {@link Symbol.dispose} For automatic cleanup
+     */
+    close(): void;
+    /**
+     * Get the underlying native CodecParser object.
+     *
+     * @returns The native CodecParser binding object
+     *
+     * @internal
+     */
+    getNative(): NativeCodecParser;
+    /**
+     * Dispose of the codec parser.
+     *
+     * Implements the Disposable interface for automatic cleanup.
+     * Equivalent to calling close().
+     *
+     * @example
+     * ```typescript
+     * {
+     *   using parser = new CodecParser();
+     *   parser.init(AV_CODEC_ID_H264);
+     *   // Use parser...
+     * } // Automatically closed when leaving scope
+     * ```
+     */
+    [Symbol.dispose](): void;
+}

package/dist/lib/codec-parser.js

@@ -0,0 +1,213 @@
+import { bindings } from './binding.js';
+/**
+ * Parser for extracting codec frames from raw bitstream data.
+ *
+ * Analyzes and splits raw bitstream data into individual codec frames.
+ * Essential for processing elementary streams, extracting NAL units,
+ * and handling frame boundaries in raw codec data. Commonly used for
+ * parsing H.264/H.265 streams, AAC ADTS streams, and other raw formats.
+ *
+ * Direct mapping to FFmpeg's AVCodecParserContext.
+ *
+ * @example
+ * ```typescript
+ * import { CodecParser, CodecContext, Packet, FFmpegError } from 'node-av';
+ * import { AV_CODEC_ID_H264 } from 'node-av/constants';
+ *
+ * // Create and initialize parser
+ * const parser = new CodecParser();
+ * parser.init(AV_CODEC_ID_H264);
+ *
+ * // Parse raw data into packets
+ * const packet = new Packet();
+ * packet.alloc();
+ *
+ * const rawData = Buffer.from([...]); // Raw H.264 stream
+ * const ret = parser.parse2(
+ *   codecContext,
+ *   packet,
+ *   rawData,
+ *   0n,  // pts
+ *   0n,  // dts
+ *   0    // position
+ * );
+ *
+ * if (ret > 0) {
+ *   // Got complete packet, ret is consumed bytes
+ *   console.log(`Parsed ${ret} bytes into packet`);
+ * }
+ *
+ * // Cleanup
+ * parser.close();
+ * ```
+ *
+ * @see [AVCodecParserContext](https://ffmpeg.org/doxygen/trunk/structAVCodecParserContext.html) - FFmpeg Doxygen
+ * @see {@link CodecContext} For decoding parsed packets
+ */
+export class CodecParser {
+    native;
+    constructor() {
+        this.native = new bindings.CodecParser();
+    }
+    /**
+     * Initialize parser for specific codec.
+     *
+     * Sets up the parser to handle a specific codec format.
+     * Must be called before parsing data.
+     *
+     * Direct mapping to av_parser_init().
+     *
+     * @param codecId - Codec ID to parse
+     *
+     * @throws {Error} If codec parser not available
+     *
+     * @example
+     * ```typescript
+     * import { AV_CODEC_ID_AAC } from 'node-av/constants';
+     *
+     * const parser = new CodecParser();
+     * parser.init(AV_CODEC_ID_AAC);
+     * // Parser ready for AAC ADTS streams
+     * ```
+     *
+     * @see {@link parse2} To parse data
+     * @see {@link close} To cleanup
+     */
+    init(codecId) {
+        this.native.init(codecId);
+    }
+    /**
+     * Parse bitstream data into packets.
+     *
+     * Analyzes raw bitstream data and extracts complete codec frames.
+     * May require multiple calls to accumulate enough data for a complete frame.
+     * Returns the number of bytes consumed from the input buffer.
+     *
+     * Direct mapping to av_parser_parse2().
+     *
+     * @param codecContext - Codec context for parser state
+     *
+     * @param packet - Packet to receive parsed frame
+     *
+     * @param data - Raw bitstream data to parse
+     *
+     * @param pts - Presentation timestamp for data
+     *
+     * @param dts - Decoding timestamp for data
+     *
+     * @param pos - Byte position in stream
+     *
+     * @returns Number of bytes consumed from data, negative on error:
+     *   - AVERROR_EINVAL: Invalid parameters
+     *   - AVERROR_ENOMEM: Memory allocation failure
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     *
+     * let offset = 0;
+     * while (offset < rawData.length) {
+     *   const remaining = rawData.subarray(offset);
+     *   const ret = parser.parse2(
+     *     codecContext,
+     *     packet,
+     *     remaining,
+     *     pts,
+     *     dts,
+     *     offset
+     *   );
+     *
+     *   if (ret < 0) {
+     *     FFmpegError.throwIfError(ret, 'parse2');
+     *   }
+     *
+     *   offset += ret;
+     *
+     *   if (packet.size > 0) {
+     *     // Got complete packet
+     *     await processPacket(packet);
+     *     packet.unref();
+     *   }
+     * }
+     * ```
+     *
+     * @see {@link init} To initialize parser
+     */
+    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.
+     *
+     * Releases all resources associated with the parser.
+     * The parser becomes invalid after calling this.
+     *
+     * Direct mapping to av_parser_close().
+     *
+     * @example
+     * ```typescript
+     * parser.close();
+     * // Parser is now invalid
+     * ```
+     *
+     * @see {@link init} To initialize
+     * @see {@link Symbol.dispose} For automatic cleanup
+     */
+    close() {
+        this.native.close();
+    }
+    /**
+     * Get the underlying native CodecParser object.
+     *
+     * @returns The native CodecParser binding object
+     *
+     * @internal
+     */
+    getNative() {
+        return this.native;
+    }
+    /**
+     * Dispose of the codec parser.
+     *
+     * Implements the Disposable interface for automatic cleanup.
+     * Equivalent to calling close().
+     *
+     * @example
+     * ```typescript
+     * {
+     *   using parser = new CodecParser();
+     *   parser.init(AV_CODEC_ID_H264);
+     *   // Use parser...
+     * } // Automatically closed when leaving scope
+     * ```
+     */
+    [Symbol.dispose]() {
+        this.close();
+    }
+}
+//# sourceMappingURL=codec-parser.js.map

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

@@ -0,0 +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;;;;;;;;;;;;;;;;;;;;;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"}