node-av 0.0.1

package/dist/lib/codec-parameters.js

@@ -0,0 +1,460 @@
+import { bindings } from './binding.js';
+import { Rational } from './rational.js';
+/**
+ * Codec parameters for stream configuration.
+ *
+ * Describes the properties of an encoded media stream.
+ * Used to transfer codec parameters between contexts and streams.
+ * Contains essential information like codec type, dimensions, and format.
+ *
+ * Direct mapping to FFmpeg's AVCodecParameters.
+ *
+ * @example
+ * ```typescript
+ * import { CodecParameters, FFmpegError } from 'node-av';
+ * import { AVMEDIA_TYPE_VIDEO, AV_CODEC_ID_H264, AV_PIX_FMT_YUV420P } from 'node-av/constants';
+ *
+ * // Create and allocate codec parameters
+ * const params = new CodecParameters();
+ * params.alloc();
+ *
+ * // Copy parameters from a codec context
+ * const ret = params.fromContext(codecContext);
+ * FFmpegError.throwIfError(ret, 'fromContext');
+ *
+ * // Set video parameters manually
+ * params.codecType = AVMEDIA_TYPE_VIDEO;
+ * params.codecId = AV_CODEC_ID_H264;
+ * params.width = 1920;
+ * params.height = 1080;
+ * params.format = AV_PIX_FMT_YUV420P;
+ *
+ * // Apply parameters to another codec context
+ * const ret2 = params.toContext(otherCodecContext);
+ * FFmpegError.throwIfError(ret2, 'toContext');
+ *
+ * // Copy to another parameters struct
+ * const params2 = new CodecParameters();
+ * params2.alloc();
+ * const copyRet = params.copy(params2);
+ * FFmpegError.throwIfError(copyRet, 'copy');
+ *
+ * // Clean up
+ * params.free();
+ * params2.free();
+ * ```
+ */
+export class CodecParameters {
+    native;
+    /**
+     * Create new codec parameters.
+     *
+     * The parameters are uninitialized - you must call alloc() before use.
+     * No FFmpeg resources are allocated until alloc() is called.
+     *
+     * Direct wrapper around AVCodecParameters.
+     *
+     * @example
+     * ```typescript
+     * import { CodecParameters } from 'node-av';
+     *
+     * const params = new CodecParameters();
+     * params.alloc();
+     * // Parameters are now ready for use
+     * ```
+     */
+    constructor() {
+        this.native = new bindings.CodecParameters();
+    }
+    /**
+     * General type of the encoded data.
+     *
+     * Identifies the media type (video, audio, subtitle, etc.).
+     *
+     * Direct mapping to AVCodecParameters->codec_type
+     */
+    get codecType() {
+        return this.native.codecType;
+    }
+    set codecType(value) {
+        this.native.codecType = value;
+    }
+    /**
+     * Specific type of the encoded data.
+     *
+     * Identifies the exact codec (H.264, AAC, etc.).
+     *
+     * Direct mapping to AVCodecParameters->codec_id
+     */
+    get codecId() {
+        return this.native.codecId;
+    }
+    set codecId(value) {
+        this.native.codecId = value;
+    }
+    /**
+     * Codec tag.
+     *
+     * Direct mapping to AVCodecParameters->codec_tag
+     * Additional information about the codec (corresponds to the AVI FOURCC).
+     */
+    get codecTag() {
+        return this.native.codecTag;
+    }
+    set codecTag(value) {
+        this.native.codecTag = value;
+    }
+    /**
+     * Extra binary data needed for initializing the decoder.
+     *
+     * Direct mapping to AVCodecParameters->extradata
+     * The allocated memory should be AV_INPUT_BUFFER_PADDING_SIZE bytes larger
+     * than extradata_size to avoid problems if it is read with the bitstream reader.
+     * The bytewise contents of extradata must not depend on the architecture or CPU endianness.
+     * Must be allocated with the av_malloc() family of functions.
+     */
+    get extradata() {
+        return this.native.extradata;
+    }
+    set extradata(value) {
+        this.native.extradata = value;
+    }
+    /**
+     * Size of the extradata content in bytes.
+     *
+     * Direct mapping to AVCodecParameters->extradata_size
+     */
+    get extradataSize() {
+        return this.native.extradataSize;
+    }
+    /**
+     * Format of the encoded data.
+     * - video: the pixel format (AVPixelFormat)
+     * - audio: the sample format (AVSampleFormat)
+     */
+    get format() {
+        return this.native.format;
+    }
+    set format(value) {
+        this.native.format = value;
+    }
+    /**
+     * The average bitrate of the encoded data (in bits per second).
+     */
+    get bitRate() {
+        return this.native.bitRate;
+    }
+    set bitRate(value) {
+        this.native.bitRate = value;
+    }
+    /**
+     * Codec-specific bitstream restrictions that the stream conforms to.
+     * FF_PROFILE_H264_BASELINE, FF_PROFILE_H264_MAIN, etc.
+     */
+    get profile() {
+        return this.native.profile;
+    }
+    set profile(value) {
+        this.native.profile = value;
+    }
+    /**
+     * Level of the bitstream.
+     * FF_LEVEL_UNKNOWN or codec-specific values.
+     */
+    get level() {
+        return this.native.level;
+    }
+    set level(value) {
+        this.native.level = value;
+    }
+    /**
+     * Video frame width in pixels.
+     *
+     * Direct mapping to AVCodecParameters->width
+     */
+    get width() {
+        return this.native.width;
+    }
+    set width(value) {
+        this.native.width = value;
+    }
+    /**
+     * Video frame height in pixels.
+     *
+     * Direct mapping to AVCodecParameters->height
+     */
+    get height() {
+        return this.native.height;
+    }
+    set height(value) {
+        this.native.height = value;
+    }
+    /**
+     * The pixel aspect ratio (width / height) which a single pixel should have when displayed.
+     *
+     * When the aspect ratio is unknown / undefined, the numerator should be set to 0
+     * (the denominator may have any value).
+     */
+    get sampleAspectRatio() {
+        const sar = this.native.sampleAspectRatio;
+        return new Rational(sar.num, sar.den);
+    }
+    set sampleAspectRatio(value) {
+        this.native.sampleAspectRatio = { num: value.num, den: value.den };
+    }
+    /**
+     * Video only. The framerate of the video.
+     * This is the fundamental unit of time (in seconds) in terms
+     * of which frame timestamps are represented.
+     */
+    get frameRate() {
+        const fr = this.native.frameRate;
+        return new Rational(fr.num, fr.den);
+    }
+    set frameRate(value) {
+        this.native.frameRate = { num: value.num, den: value.den };
+    }
+    /**
+     * Video only. Additional colorspace characteristics.
+     * AVCOL_RANGE_MPEG, AVCOL_RANGE_JPEG, etc.
+     */
+    get colorRange() {
+        return this.native.colorRange;
+    }
+    set colorRange(value) {
+        this.native.colorRange = value;
+    }
+    /**
+     * Chromaticity coordinates of the source primaries.
+     * AVCOL_PRI_BT709, AVCOL_PRI_BT2020, etc.
+     */
+    get colorPrimaries() {
+        return this.native.colorPrimaries;
+    }
+    set colorPrimaries(value) {
+        this.native.colorPrimaries = value;
+    }
+    /**
+     * Color Transfer Characteristic.
+     * AVCOL_TRC_BT709, AVCOL_TRC_SMPTE2084, etc.
+     */
+    get colorTrc() {
+        return this.native.colorTrc;
+    }
+    set colorTrc(value) {
+        this.native.colorTrc = value;
+    }
+    /**
+     * YUV colorspace type.
+     * AVCOL_SPC_BT709, AVCOL_SPC_BT2020_NCL, etc.
+     */
+    get colorSpace() {
+        return this.native.colorSpace;
+    }
+    set colorSpace(value) {
+        this.native.colorSpace = value;
+    }
+    /**
+     * Location of chroma samples.
+     * AVCHROMA_LOC_LEFT, AVCHROMA_LOC_CENTER, etc.
+     */
+    get chromaLocation() {
+        return this.native.chromaLocation;
+    }
+    set chromaLocation(value) {
+        this.native.chromaLocation = value;
+    }
+    /**
+     * Audio channel layout.
+     * @deprecated use ch_layout
+     */
+    get channelLayout() {
+        return this.native.channelLayout;
+    }
+    set channelLayout(value) {
+        this.native.channelLayout = value;
+    }
+    /**
+     * Audio only. The number of audio channels.
+     * @deprecated use ch_layout.nb_channels
+     */
+    get channels() {
+        return this.native.channels;
+    }
+    set channels(value) {
+        this.native.channels = value;
+    }
+    /**
+     * Audio sample rate.
+     *
+     * Direct mapping to AVCodecParameters->sample_rate
+     * The number of audio samples per second.
+     */
+    get sampleRate() {
+        return this.native.sampleRate;
+    }
+    set sampleRate(value) {
+        this.native.sampleRate = value;
+    }
+    /**
+     * Allocate a new AVCodecParameters and set its fields to default values.
+     *
+     * Allocates the parameters structure and initializes with defaults.
+     * Must be called before using the parameters.
+     *
+     * Direct mapping to avcodec_parameters_alloc()
+     *
+     * @throws {Error} Memory allocation failure (ENOMEM)
+     *
+     * @example
+     * ```typescript
+     * import { CodecParameters } from 'node-av';
+     *
+     * const params = new CodecParameters();
+     * params.alloc();
+     * // Parameters are now allocated with default values
+     * ```
+     *
+     * @see {@link free} To free the parameters
+     */
+    alloc() {
+        this.native.alloc();
+    }
+    /**
+     * Free the codec parameters and everything associated with it.
+     *
+     * Releases all resources associated with the parameters.
+     * The parameters become invalid after this call.
+     *
+     * Direct mapping to avcodec_parameters_free()
+     *
+     * @example
+     * ```typescript
+     * params.free();
+     * // params is now invalid and should not be used
+     * ```
+     */
+    free() {
+        this.native.free();
+    }
+    /**
+     * Copy the contents of this CodecParameters to dst.
+     *
+     * Copies all parameter values to the destination.
+     * Any allocated fields in dst are freed and replaced with newly allocated duplicates.
+     *
+     * Direct mapping to avcodec_parameters_copy()
+     *
+     * @param dst - Destination CodecParameters. Must be allocated.
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - 0: Success
+     *   - AVERROR(ENOMEM): Memory allocation failure
+     *
+     * @example
+     * ```typescript
+     * import { CodecParameters, FFmpegError } from 'node-av';
+     *
+     * const src = new CodecParameters();
+     * src.alloc();
+     * // ... set up src parameters ...
+     *
+     * const dst = new CodecParameters();
+     * dst.alloc();
+     * const ret = src.copy(dst);
+     * FFmpegError.throwIfError(ret, 'copy');
+     * ```
+     *
+     * @see {@link fromContext} To copy from codec context
+     * @see {@link toContext} To copy to codec context
+     */
+    copy(dst) {
+        return this.native.copy(dst.getNative());
+    }
+    /**
+     * Fill this parameters struct based on the values from the supplied codec context.
+     *
+     * Copies codec parameters from a codec context to this parameters struct.
+     * Any allocated fields are freed and replaced with duplicates.
+     *
+     * Direct mapping to avcodec_parameters_from_context()
+     *
+     * @param codecContext - Source CodecContext to copy from
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - 0: Success
+     *   - AVERROR(EINVAL): Invalid codec context
+     *   - AVERROR(ENOMEM): Memory allocation failure
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     *
+     * // Copy encoder parameters to stream
+     * const ret = outputStream.codecpar.fromContext(encoderContext);
+     * FFmpegError.throwIfError(ret, 'fromContext');
+     * ```
+     *
+     * @see {@link toContext} To copy in the opposite direction
+     */
+    fromContext(codecContext) {
+        return this.native.fromContext(codecContext.getNative());
+    }
+    /**
+     * Fill the codec context based on the values from this codec parameters.
+     *
+     * Copies parameters from this struct to a codec context.
+     * Any allocated fields in the codec context are freed and replaced with duplicates.
+     *
+     * Direct mapping to avcodec_parameters_to_context()
+     *
+     * @param codecContext - Destination CodecContext to copy to
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - 0: Success
+     *   - AVERROR(EINVAL): Invalid codec context
+     *   - AVERROR(ENOMEM): Memory allocation failure
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     *
+     * // Copy stream parameters to decoder
+     * const ret = inputStream.codecpar.toContext(decoderContext);
+     * FFmpegError.throwIfError(ret, 'toContext');
+     * ```
+     *
+     * @see {@link fromContext} To copy in the opposite direction
+     */
+    toContext(codecContext) {
+        return this.native.toContext(codecContext.getNative());
+    }
+    /**
+     * Get the native FFmpeg AVCodecParameters pointer.
+     *
+     * @internal For use by other wrapper classes
+     * @returns The underlying native codec parameters object
+     */
+    getNative() {
+        return this.native;
+    }
+    /**
+     * Dispose of the codec parameters.
+     *
+     * Implements the Disposable interface for automatic cleanup.
+     * Equivalent to calling free().
+     *
+     * @example
+     * ```typescript
+     * {
+     *   using params = new CodecParameters();
+     *   params.alloc();
+     *   // ... use parameters
+     * } // Automatically freed when leaving scope
+     * ```
+     */
+    [Symbol.dispose]() {
+        this.native[Symbol.dispose]();
+    }
+}
+//# sourceMappingURL=codec-parameters.js.map

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,185 @@
+import type { CodecContext } from './codec-context.js';
+import type { AVCodecID } from './constants.js';
+import type { NativeCodecParser, NativeWrapper } from './native-types.js';
+import type { Packet } from './packet.js';
+/**
+ * Codec parser for splitting elementary streams into frames.
+ *
+ * Parsers split raw byte streams (currently only video) into coded frames.
+ * Many decoders require that coded video frames are preceded by a start code,
+ * and this parser splits the stream at these boundaries. Parsers are essential
+ * for handling raw elementary streams from sources like network streams or
+ * raw video files without container format.
+ *
+ * Direct wrapper around AVCodecParserContext.
+ *
+ * @example
+ * ```typescript
+ * import { CodecParser, CodecContext, Packet, FFmpegError } from 'node-av';
+ * import { AV_CODEC_ID_H264, AV_NOPTS_VALUE } from 'node-av/constants';
+ *
+ * const parser = new CodecParser();
+ * parser.init(AV_CODEC_ID_H264);
+ *
+ * // Parse raw H.264 stream
+ * const packet = new Packet();
+ * packet.alloc();
+ *
+ * const bytesConsumed = parser.parse2(
+ *   codecContext,
+ *   packet,
+ *   inputBuffer,
+ *   AV_NOPTS_VALUE,
+ *   AV_NOPTS_VALUE,
+ *   0
+ * );
+ *
+ * if (packet.size > 0) {
+ *   // We have a complete frame in packet
+ *   const ret = await codecContext.sendPacket(packet);
+ *   FFmpegError.throwIfError(ret, 'sendPacket');
+ * }
+ *
+ * parser.close();
+ * ```
+ *
+ * @see {@link CodecContext} For decoding parsed packets
+ * @see {@link Packet} For storing parsed frame data
+ */
+export declare class CodecParser implements NativeWrapper<NativeCodecParser> {
+    private native;
+    /**
+     * Create a new CodecParser instance.
+     *
+     * The parser is uninitialized - you must call init() before use.
+     * No FFmpeg resources are allocated until init() is called.
+     *
+     * Direct wrapper around AVCodecParserContext allocation.
+     *
+     * @example
+     * ```typescript
+     * import { CodecParser } from 'node-av';
+     * import { AV_CODEC_ID_MPEG1VIDEO } from 'node-av/constants';
+     *
+     * const parser = new CodecParser();
+     * parser.init(AV_CODEC_ID_MPEG1VIDEO);
+     * // parser is now ready for use
+     * ```
+     */
+    constructor();
+    /**
+     * Initialize the parser with a specific codec ID.
+     *
+     * Allocates and initializes the AVCodecParserContext for the specified codec.
+     * Must be called before parse2() can be used.
+     *
+     * Direct mapping to av_parser_init()
+     *
+     * @param codecId - AVCodecID of the codec to parse
+     *
+     * @throws {Error} Parser for codec ID not found
+     *
+     * @example
+     * ```typescript
+     * import { CodecParser } from 'node-av';
+     * import { AV_CODEC_ID_H264, AV_CODEC_ID_HEVC } from 'node-av/constants';
+     *
+     * const parser = new CodecParser();
+     *
+     * // Initialize for H.264
+     * parser.init(AV_CODEC_ID_H264);
+     * // Parser is now ready to parse H.264 streams
+     *
+     * // For HEVC/H.265
+     * const hevcParser = new CodecParser();
+     * hevcParser.init(AV_CODEC_ID_HEVC);
+     * ```
+     *
+     * @see {@link parse2} For parsing data after initialization
+     */
+    init(codecId: AVCodecID): void;
+    /**
+     * Parse a buffer and extract packets from elementary stream.
+     *
+     * Parses the input buffer and extracts complete coded frames. The parser
+     * maintains internal state to handle partial frames across multiple calls.
+     * The parser may combine multiple frames into one packet or split one frame
+     * into multiple packets, depending on the codec and stream format.
+     *
+     * Direct mapping to av_parser_parse2()
+     *
+     * @param codecContext - Codec context (used for stream parameters)
+     * @param packet - Packet to fill with parsed data
+     * @param data - Input buffer containing elementary stream data
+     * @param pts - Presentation timestamp of the first byte in data
+     * @param dts - Decoding timestamp of the first byte in data
+     * @param pos - Byte position of the first byte in data in the stream
+     *
+     * @returns Number of bytes consumed from the input buffer:
+     *   - >0: Number of bytes consumed from input
+     *   - 0: More data needed to complete a frame
+     *
+     * @example
+     * ```typescript
+     * import { CodecParser, CodecContext, Packet, FFmpegError } from 'node-av';
+     * import { AV_NOPTS_VALUE } from 'node-av/constants';
+     * import * as fs from 'fs';
+     *
+     * const inbuf = Buffer.alloc(4096);
+     * const bytesRead = fs.readSync(fd, inbuf, 0, 4096, null);
+     *
+     * let offset = 0;
+     * while (offset < bytesRead) {
+     *   const consumed = parser.parse2(
+     *     codecContext,
+     *     packet,
+     *     inbuf.subarray(offset),
+     *     AV_NOPTS_VALUE,
+     *     AV_NOPTS_VALUE,
+     *     0
+     *   );
+     *
+     *   offset += consumed;
+     *
+     *   if (packet.size > 0) {
+     *     // Complete packet ready for decoding
+     *     const ret = await codecContext.sendPacket(packet);
+     *     FFmpegError.throwIfError(ret, 'sendPacket');
+     *   }
+     * }
+     * ```
+     *
+     * @see {@link init} Must be called before parse2
+     * @see {@link close} Should be called when done parsing
+     */
+    parse2(codecContext: CodecContext, packet: Packet, data: Buffer, pts: bigint, dts: bigint, pos: number): number;
+    /**
+     * Close the parser and free all resources.
+     *
+     * Releases all resources associated with the parser context.
+     * After calling close(), the parser instance should not be used anymore.
+     *
+     * Direct mapping to av_parser_close()
+     *
+     * @example
+     * ```typescript
+     * import { CodecParser } from 'node-av';
+     *
+     * const parser = new CodecParser();
+     * // ... use parser ...
+     *
+     * parser.close();
+     * // Parser resources are now freed
+     * // Do not use parser after this point
+     * ```
+     */
+    close(): void;
+    /**
+     * @internal
+     * Get the underlying native codec parser object.
+     * This method is for internal use by other FFmpeg classes.
+     *
+     * @returns The underlying native codec parser object
+     */
+    getNative(): NativeCodecParser;
+}