@revizly/node-av 5.2.2-beta.1

package/dist/lib/codec-context.js

@@ -0,0 +1,1354 @@
+import { bindings } from './binding.js';
+import { HardwareDeviceContext } from './hardware-device-context.js';
+import { HardwareFramesContext } from './hardware-frames-context.js';
+import { OptionMember } from './option.js';
+import { Rational } from './rational.js';
+import { stringToFourCC } from './utilities.js';
+/**
+ * Codec context for encoding and decoding.
+ *
+ * Main structure for codec operations, containing all codec parameters and state.
+ * Handles encoding raw frames to packets and decoding packets to frames.
+ * Supports both software and hardware-accelerated codecs.
+ * Must be configured and opened before use.
+ *
+ * Direct mapping to FFmpeg's AVCodecContext.
+ *
+ * @example
+ * ```typescript
+ * import { CodecContext, Codec, FFmpegError } from 'node-av';
+ * import { AV_CODEC_ID_H264, AV_PIX_FMT_YUV420P } from 'node-av/constants';
+ *
+ * // Create decoder
+ * const decoder = new CodecContext();
+ * const codec = Codec.findDecoder(AV_CODEC_ID_H264);
+ * decoder.allocContext3(codec);
+ *
+ * // Configure from stream parameters
+ * decoder.parametersToContext(stream.codecpar);
+ *
+ * // Open decoder
+ * let ret = await decoder.open2(codec);
+ * FFmpegError.throwIfError(ret, 'open2');
+ *
+ * // Decode packets
+ * ret = await decoder.sendPacket(packet);
+ * if (ret >= 0) {
+ *   ret = await decoder.receiveFrame(frame);
+ *   if (ret >= 0) {
+ *     // Process decoded frame
+ *   }
+ * }
+ *
+ * // Cleanup
+ * decoder.freeContext();
+ * ```
+ *
+ * @see [AVCodecContext](https://ffmpeg.org/doxygen/trunk/structAVCodecContext.html) - FFmpeg Doxygen
+ * @see {@link Codec} For finding codecs
+ * @see {@link CodecParameters} For stream parameters
+ */
+export class CodecContext extends OptionMember {
+    _hwDeviceCtx; // Cache for hardware device context wrapper
+    _hwFramesCtx; // Cache for hardware frames context wrapper
+    constructor() {
+        super(new bindings.CodecContext());
+    }
+    /**
+     * Type of codec (video/audio/subtitle).
+     *
+     * Direct mapping to AVCodecContext->codec_type.
+     */
+    get codecType() {
+        return this.native.codecType;
+    }
+    set codecType(value) {
+        this.native.codecType = value;
+    }
+    /**
+     * Codec identifier.
+     *
+     * Direct mapping to AVCodecContext->codec_id.
+     */
+    get codecId() {
+        return this.native.codecId;
+    }
+    set codecId(value) {
+        this.native.codecId = value;
+    }
+    /**
+     * Codec tag.
+     *
+     * Additional codec tag used by some formats.
+     *
+     * Direct mapping to AVCodecContext->codec_tag.
+     */
+    get codecTag() {
+        return this.native.codecTag;
+    }
+    set codecTag(value) {
+        if (typeof value === 'string') {
+            if (value.length !== 4) {
+                throw new Error('FourCC string must be exactly 4 characters');
+            }
+            value = stringToFourCC(value);
+        }
+        this.native.codecTag = value;
+    }
+    /**
+     * Codec tag as string (FourCC).
+     *
+     * Human-readable string representation of the codec tag.
+     * Returns the FourCC (Four Character Code) format.
+     */
+    get codecTagString() {
+        return this.native.codecTagString;
+    }
+    /**
+     * Average bitrate.
+     *
+     * Target bitrate for encoding, detected bitrate for decoding.
+     * In bits per second.
+     *
+     * Direct mapping to AVCodecContext->bit_rate.
+     */
+    get bitRate() {
+        return this.native.bitRate;
+    }
+    set bitRate(value) {
+        this.native.bitRate = value;
+    }
+    /**
+     * Time base for timestamps.
+     *
+     * Fundamental unit of time in seconds for this context.
+     *
+     * Direct mapping to AVCodecContext->time_base.
+     */
+    get timeBase() {
+        const tb = this.native.timeBase;
+        return new Rational(tb.num, tb.den);
+    }
+    set timeBase(value) {
+        this.native.timeBase = { num: value.num, den: value.den };
+    }
+    /**
+     * Packet time base.
+     *
+     * Time base of the packets from/to the demuxer/muxer.
+     *
+     * Direct mapping to AVCodecContext->pkt_timebase.
+     */
+    get pktTimebase() {
+        const tb = this.native.pktTimebase;
+        return new Rational(tb.num, tb.den);
+    }
+    set pktTimebase(value) {
+        this.native.pktTimebase = { num: value.num, den: value.den };
+    }
+    /**
+     * Codec delay.
+     *
+     * Number of frames the decoder needs to output before first frame.
+     *
+     * Direct mapping to AVCodecContext->delay.
+     */
+    get delay() {
+        return this.native.delay;
+    }
+    /**
+     * Codec flags.
+     *
+     * Combination of AV_CODEC_FLAG_* values.
+     *
+     * Direct mapping to AVCodecContext->flags.
+     */
+    get flags() {
+        return this.native.flags;
+    }
+    set flags(value) {
+        this.native.flags = value;
+    }
+    /**
+     * Additional codec flags.
+     *
+     * Combination of AV_CODEC_FLAG2_* values.
+     *
+     * Direct mapping to AVCodecContext->flags2.
+     */
+    get flags2() {
+        return this.native.flags2;
+    }
+    set flags2(value) {
+        this.native.flags2 = value;
+    }
+    /**
+     * Extra binary data for codec.
+     *
+     * Contains codec-specific initialization data.
+     *
+     * Direct mapping to AVCodecContext->extradata.
+     */
+    get extraData() {
+        return this.native.extraData;
+    }
+    set extraData(value) {
+        this.native.extraData = value;
+    }
+    /**
+     * Codec profile.
+     *
+     * FF_PROFILE_* value indicating codec profile.
+     *
+     * Direct mapping to AVCodecContext->profile.
+     */
+    get profile() {
+        return this.native.profile;
+    }
+    set profile(value) {
+        this.native.profile = value;
+    }
+    /**
+     * Codec level.
+     *
+     * Level within the specified profile.
+     *
+     * Direct mapping to AVCodecContext->level.
+     */
+    get level() {
+        return this.native.level;
+    }
+    set level(value) {
+        this.native.level = value;
+    }
+    /**
+     * Thread count for codec.
+     *
+     * Number of threads to use for decoding/encoding.
+     * 0 for automatic selection.
+     *
+     * Direct mapping to AVCodecContext->thread_count.
+     */
+    get threadCount() {
+        return this.native.threadCount;
+    }
+    set threadCount(value) {
+        this.native.threadCount = value;
+    }
+    /**
+     * Thread type for codec.
+     *
+     * Which multithreading methods to use.
+     * - FF_THREAD_FRAME (1): Decode more than one frame at once
+     * - FF_THREAD_SLICE (2): Decode more than one part of a single frame at once
+     *
+     * Direct mapping to AVCodecContext->thread_type.
+     */
+    get threadType() {
+        return this.native.threadType;
+    }
+    set threadType(value) {
+        this.native.threadType = value;
+    }
+    /**
+     * Picture width in pixels.
+     *
+     * Direct mapping to AVCodecContext->width.
+     */
+    get width() {
+        return this.native.width;
+    }
+    set width(value) {
+        this.native.width = value;
+    }
+    /**
+     * Picture height in pixels.
+     *
+     * Direct mapping to AVCodecContext->height.
+     */
+    get height() {
+        return this.native.height;
+    }
+    set height(value) {
+        this.native.height = value;
+    }
+    /**
+     * Group of pictures size.
+     *
+     * Maximum number of frames between keyframes.
+     *
+     * Direct mapping to AVCodecContext->gop_size.
+     */
+    get gopSize() {
+        return this.native.gopSize;
+    }
+    set gopSize(value) {
+        this.native.gopSize = value;
+    }
+    /**
+     * Pixel format.
+     *
+     * Format of the video frames.
+     *
+     * Direct mapping to AVCodecContext->pix_fmt.
+     */
+    get pixelFormat() {
+        return this.native.pixelFormat;
+    }
+    set pixelFormat(value) {
+        this.native.pixelFormat = value;
+    }
+    /**
+     * Maximum number of B-frames.
+     *
+     * B-frames between non-B-frames.
+     *
+     * Direct mapping to AVCodecContext->max_b_frames.
+     */
+    get maxBFrames() {
+        return this.native.maxBFrames;
+    }
+    set maxBFrames(value) {
+        this.native.maxBFrames = value;
+    }
+    /**
+     * Macroblock decision mode.
+     *
+     * Algorithm for macroblock decision.
+     *
+     * Direct mapping to AVCodecContext->mb_decision.
+     */
+    get mbDecision() {
+        return this.native.mbDecision;
+    }
+    set mbDecision(value) {
+        this.native.mbDecision = value;
+    }
+    /**
+     * Number of frames delay in decoder.
+     *
+     * For codecs with B-frames.
+     *
+     * Direct mapping to AVCodecContext->has_b_frames.
+     */
+    get hasBFrames() {
+        return this.native.hasBFrames;
+    }
+    /**
+     * Sample aspect ratio.
+     *
+     * Pixel width/height ratio.
+     *
+     * Direct mapping to AVCodecContext->sample_aspect_ratio.
+     */
+    get sampleAspectRatio() {
+        const sar = this.native.sampleAspectRatio;
+        return new Rational(sar.num || 0, sar.den || 1);
+    }
+    set sampleAspectRatio(value) {
+        this.native.sampleAspectRatio = { num: value.num, den: value.den };
+    }
+    /**
+     * Frame rate.
+     *
+     * Frames per second for encoding.
+     *
+     * Direct mapping to AVCodecContext->framerate.
+     */
+    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 };
+    }
+    /**
+     * Color range.
+     *
+     * MPEG (limited) or JPEG (full) range.
+     *
+     * Direct mapping to AVCodecContext->color_range.
+     */
+    get colorRange() {
+        return this.native.colorRange;
+    }
+    set colorRange(value) {
+        this.native.colorRange = value;
+    }
+    /**
+     * Color primaries.
+     *
+     * Chromaticity coordinates of source primaries.
+     *
+     * Direct mapping to AVCodecContext->color_primaries.
+     */
+    get colorPrimaries() {
+        return this.native.colorPrimaries;
+    }
+    set colorPrimaries(value) {
+        this.native.colorPrimaries = value;
+    }
+    /**
+     * Color transfer characteristic.
+     *
+     * Transfer function (gamma).
+     *
+     * Direct mapping to AVCodecContext->color_trc.
+     */
+    get colorTrc() {
+        return this.native.colorTrc;
+    }
+    set colorTrc(value) {
+        this.native.colorTrc = value;
+    }
+    /**
+     * YUV color space.
+     *
+     * Color space for YUV content.
+     *
+     * Direct mapping to AVCodecContext->colorspace.
+     */
+    get colorSpace() {
+        return this.native.colorSpace;
+    }
+    set colorSpace(value) {
+        this.native.colorSpace = value;
+    }
+    /**
+     * Chroma sample location.
+     *
+     * Position of chroma samples.
+     *
+     * Direct mapping to AVCodecContext->chroma_sample_location.
+     */
+    get chromaLocation() {
+        return this.native.chromaLocation;
+    }
+    set chromaLocation(value) {
+        this.native.chromaLocation = value;
+    }
+    /**
+     * Audio sample rate.
+     *
+     * Samples per second.
+     *
+     * Direct mapping to AVCodecContext->sample_rate.
+     */
+    get sampleRate() {
+        return this.native.sampleRate;
+    }
+    set sampleRate(value) {
+        this.native.sampleRate = value;
+    }
+    /**
+     * Number of audio channels.
+     *
+     * Direct mapping to AVCodecContext->channels.
+     */
+    get channels() {
+        return this.native.channels;
+    }
+    set channels(value) {
+        this.native.channels = value;
+    }
+    /**
+     * Audio sample format.
+     *
+     * Format of audio samples.
+     *
+     * Direct mapping to AVCodecContext->sample_fmt.
+     */
+    get sampleFormat() {
+        return this.native.sampleFormat;
+    }
+    set sampleFormat(value) {
+        this.native.sampleFormat = value;
+    }
+    /**
+     * Number of samples per audio frame.
+     *
+     * Direct mapping to AVCodecContext->frame_size.
+     */
+    get frameSize() {
+        return this.native.frameSize;
+    }
+    set frameSize(value) {
+        this.native.frameSize = 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 AVCodecContext->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 AVCodecContext->bits_per_raw_sample.
+     */
+    get bitsPerRawSample() {
+        return this.native.bitsPerRawSample;
+    }
+    set bitsPerRawSample(value) {
+        this.native.bitsPerRawSample = value;
+    }
+    /**
+     * Current frame number.
+     *
+     * Frame counter for debugging.
+     *
+     * Direct mapping to AVCodecContext->frame_number.
+     */
+    get frameNumber() {
+        return this.native.frameNumber;
+    }
+    /**
+     * Audio channel layout.
+     *
+     * Describes channel configuration.
+     *
+     * Direct mapping to AVCodecContext->ch_layout.
+     */
+    get channelLayout() {
+        return this.native.channelLayout;
+    }
+    set channelLayout(value) {
+        this.native.channelLayout = value;
+    }
+    /**
+     * Minimum quantizer.
+     *
+     * Minimum quantization parameter.
+     *
+     * Direct mapping to AVCodecContext->qmin.
+     */
+    get qMin() {
+        return this.native.qMin;
+    }
+    set qMin(value) {
+        this.native.qMin = value;
+    }
+    /**
+     * Maximum quantizer.
+     *
+     * Maximum quantization parameter.
+     *
+     * Direct mapping to AVCodecContext->qmax.
+     */
+    get qMax() {
+        return this.native.qMax;
+    }
+    set qMax(value) {
+        this.native.qMax = value;
+    }
+    /**
+     * Global quality for constant quality mode.
+     *
+     * Used by encoders that support constant quality mode (e.g., -qscale in FFmpeg CLI).
+     * Set this value to enable constant quality encoding instead of constant bitrate.
+     * Valid range depends on the codec (e.g., 0-69 for MPEG-4, FF_LAMBDA_SCALE for others).
+     *
+     * Direct mapping to AVCodecContext->global_quality.
+     *
+     * @example
+     * ```typescript
+     * // MPEG-4 constant quality (lower = better quality)
+     * codecContext.globalQuality = 5 * FF_QP2LAMBDA;
+     * ```
+     */
+    get globalQuality() {
+        return this.native.globalQuality;
+    }
+    set globalQuality(value) {
+        this.native.globalQuality = value;
+    }
+    /**
+     * Rate control buffer size.
+     *
+     * Decoder bitstream buffer size.
+     *
+     * Direct mapping to AVCodecContext->rc_buffer_size.
+     */
+    get rcBufferSize() {
+        return this.native.rcBufferSize;
+    }
+    set rcBufferSize(value) {
+        this.native.rcBufferSize = value;
+    }
+    /**
+     * Maximum bitrate.
+     *
+     * Maximum bitrate in bits per second.
+     *
+     * Direct mapping to AVCodecContext->rc_max_rate.
+     */
+    get rcMaxRate() {
+        return this.native.rcMaxRate;
+    }
+    set rcMaxRate(value) {
+        this.native.rcMaxRate = value;
+    }
+    /**
+     * Minimum bitrate.
+     *
+     * Minimum bitrate in bits per second.
+     *
+     * Direct mapping to AVCodecContext->rc_min_rate.
+     */
+    get rcMinRate() {
+        return this.native.rcMinRate;
+    }
+    set rcMinRate(value) {
+        this.native.rcMinRate = value;
+    }
+    /**
+     * Hardware device context.
+     *
+     * Reference to hardware device for acceleration.
+     *
+     * Direct mapping to AVCodecContext->hw_device_ctx.
+     */
+    get hwDeviceCtx() {
+        const native = this.native.hwDeviceCtx;
+        if (!native) {
+            // Clear cache if native is null
+            this._hwDeviceCtx = undefined;
+            return null;
+        }
+        // Return cached wrapper if available and still valid
+        if (this._hwDeviceCtx && this._hwDeviceCtx.native === native) {
+            return this._hwDeviceCtx;
+        }
+        // Create and cache new wrapper
+        const device = Object.create(HardwareDeviceContext.prototype);
+        device.native = native;
+        this._hwDeviceCtx = device;
+        return device;
+    }
+    set hwDeviceCtx(value) {
+        this.native.hwDeviceCtx = value?.getNative() ?? null;
+        // Clear cache when setting new value
+        this._hwDeviceCtx = undefined;
+    }
+    /**
+     * Number of extra hardware frames to allocate.
+     *
+     * Specifies additional hardware frame buffers for decoders that need them.
+     * Useful for hardware decoders requiring frame buffering or reordering.
+     *
+     * Direct mapping to AVCodecContext->extra_hw_frames.
+     */
+    get extraHWFrames() {
+        return this.native.extraHWFrames;
+    }
+    set extraHWFrames(value) {
+        this.native.extraHWFrames = value;
+    }
+    /**
+     * Hardware frames context.
+     *
+     * Reference to hardware frames for GPU memory.
+     *
+     * Direct mapping to AVCodecContext->hw_frames_ctx.
+     */
+    get hwFramesCtx() {
+        const native = this.native.hwFramesCtx;
+        if (!native) {
+            // Clear cache if native is null
+            this._hwFramesCtx = undefined;
+            return null;
+        }
+        // Return cached wrapper if available and still valid
+        if (this._hwFramesCtx && this._hwFramesCtx.native === native) {
+            return this._hwFramesCtx;
+        }
+        // Create and cache new wrapper
+        const frames = Object.create(HardwareFramesContext.prototype);
+        frames.native = native;
+        this._hwFramesCtx = frames;
+        return frames;
+    }
+    set hwFramesCtx(value) {
+        this.native.hwFramesCtx = value?.getNative() ?? null;
+        // Clear cache when setting new value
+        this._hwFramesCtx = undefined;
+    }
+    /**
+     * Check if codec is open.
+     *
+     * True if the codec has been opened.
+     */
+    get isOpen() {
+        return this.native.isOpen;
+    }
+    /**
+     * Allocate codec context.
+     *
+     * Allocates and initializes the context for the given codec.
+     *
+     * Direct mapping to avcodec_alloc_context3().
+     *
+     * @param codec - Codec to use (null for default)
+     *
+     * @example
+     * ```typescript
+     * import { Codec } from 'node-av';
+     * import { AV_CODEC_ID_H264 } from 'node-av/constants';
+     *
+     * const codec = Codec.findDecoder(AV_CODEC_ID_H264);
+     * ctx.allocContext3(codec);
+     * ```
+     *
+     * @see {@link open2} To open the codec
+     * @see {@link freeContext} To free the context
+     */
+    allocContext3(codec = null) {
+        this.native.allocContext3(codec?.getNative() ?? null);
+    }
+    /**
+     * Free the codec context.
+     *
+     * Releases all resources. The context becomes invalid.
+     *
+     * Direct mapping to avcodec_free_context().
+     *
+     * @example
+     * ```typescript
+     * ctx.freeContext();
+     * // Context is now invalid
+     * ```
+     *
+     * @see {@link Symbol.dispose} For automatic cleanup
+     * @see {@link allocContext3} To allocate a new context
+     */
+    freeContext() {
+        this.native.freeContext();
+    }
+    /**
+     * Open the codec.
+     *
+     * Initializes the codec for encoding/decoding.
+     * Must be called before processing frames/packets.
+     *
+     * Direct mapping to avcodec_open2().
+     *
+     * @param codec - Codec to open with (null to use already set)
+     *
+     * @param options - Codec-specific options
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EINVAL: Invalid parameters
+     *   - AVERROR_ENOMEM: Memory allocation failure
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     *
+     * const ret = await ctx.open2(codec);
+     * FFmpegError.throwIfError(ret, 'open2');
+     * // Codec is now open and ready
+     * ```
+     *
+     * @see {@link allocContext3} Must be called first
+     * @see {@link isOpen} To check if open
+     */
+    async open2(codec = null, options = null) {
+        return await this.native.open2(codec?.getNative() ?? null, options?.getNative() ?? null);
+    }
+    /**
+     * Open the codec synchronously.
+     * Synchronous version of open2.
+     *
+     * Initializes the codec for encoding/decoding.
+     * Must be called before processing frames/packets.
+     *
+     * Direct mapping to avcodec_open2().
+     *
+     * @param codec - Codec to open with (null to use already set)
+     *
+     * @param options - Codec-specific options
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EINVAL: Invalid parameters
+     *   - AVERROR_ENOMEM: Memory allocation failure
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     *
+     * const ret = ctx.open2Sync(codec);
+     * FFmpegError.throwIfError(ret, 'open2Sync');
+     * // Codec is now open and ready
+     * ```
+     *
+     * @see {@link open2} For async version
+     */
+    open2Sync(codec = null, options = null) {
+        return this.native.open2Sync(codec?.getNative() ?? null, options?.getNative() ?? null);
+    }
+    /**
+     * Fill codec context from parameters.
+     *
+     * Copies codec parameters from stream to context.
+     * Used when setting up decoders.
+     *
+     * Direct mapping to avcodec_parameters_to_context().
+     *
+     * @param params - Source codec parameters
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EINVAL: Invalid parameters
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     *
+     * const ret = ctx.parametersToContext(stream.codecpar);
+     * FFmpegError.throwIfError(ret, 'parametersToContext');
+     * ```
+     *
+     * @see {@link parametersFromContext} For the reverse
+     */
+    parametersToContext(params) {
+        return this.native.parametersToContext(params.getNative());
+    }
+    /**
+     * Fill parameters from codec context.
+     *
+     * Copies codec parameters from context to stream.
+     * Used when setting up encoders.
+     *
+     * Direct mapping to avcodec_parameters_from_context().
+     *
+     * @param params - Destination codec parameters
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EINVAL: Invalid parameters
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     *
+     * const ret = ctx.parametersFromContext(stream.codecpar);
+     * FFmpegError.throwIfError(ret, 'parametersFromContext');
+     * ```
+     *
+     * @see {@link parametersToContext} For the reverse
+     */
+    parametersFromContext(params) {
+        return this.native.parametersFromContext(params.getNative());
+    }
+    /**
+     * Flush codec buffers.
+     *
+     * Resets the internal codec state.
+     * Used when seeking or switching streams.
+     *
+     * Direct mapping to avcodec_flush_buffers().
+     *
+     * @example
+     * ```typescript
+     * // Flush when seeking
+     * ctx.flushBuffers();
+     * // Codec is now ready for new data
+     * ```
+     */
+    flushBuffers() {
+        this.native.flushBuffers();
+    }
+    /**
+     * Send packet to decoder.
+     *
+     * Submits encoded data for decoding.
+     * Call receiveFrame() to get decoded frames.
+     *
+     * Direct mapping to avcodec_send_packet().
+     *
+     * @param packet - Packet to decode (null to flush)
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EAGAIN: Must receive frames first
+     *   - AVERROR_EOF: Decoder has been flushed
+     *   - AVERROR_EINVAL: Invalid decoder state
+     *   - AVERROR_ENOMEM: Memory allocation failure
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     * import { AVERROR_EAGAIN } from 'node-av';
+     *
+     * const ret = await ctx.sendPacket(packet);
+     * if (ret === AVERROR_EAGAIN) {
+     *   // Need to receive frames first
+     * } else {
+     *   FFmpegError.throwIfError(ret, 'sendPacket');
+     * }
+     * ```
+     *
+     * @see {@link receiveFrame} To get decoded frames
+     */
+    async sendPacket(packet) {
+        return await this.native.sendPacket(packet?.getNative() ?? null);
+    }
+    /**
+     * Send packet to decoder synchronously.
+     * Synchronous version of sendPacket.
+     *
+     * Submits compressed data for decoding.
+     * Call receiveFrameSync() to get decoded frames.
+     *
+     * Direct mapping to avcodec_send_packet().
+     *
+     * @param packet - Packet to decode (null to flush)
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EAGAIN: Must receive frames first
+     *   - AVERROR_EOF: Decoder has been flushed
+     *   - AVERROR_EINVAL: Invalid decoder state
+     *   - AVERROR_ENOMEM: Memory allocation failure
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     * import { AVERROR_EAGAIN } from 'node-av';
+     *
+     * const ret = ctx.sendPacketSync(packet);
+     * if (ret === AVERROR_EAGAIN) {
+     *   // Need to receive frames first
+     *   ctx.receiveFrameSync(frame);
+     * }
+     * ```
+     *
+     * @see {@link sendPacket} For async version
+     */
+    sendPacketSync(packet) {
+        return this.native.sendPacketSync(packet?.getNative() ?? null);
+    }
+    /**
+     * Receive decoded frame.
+     *
+     * Gets a decoded frame from the decoder.
+     * Call after sendPacket().
+     *
+     * Direct mapping to avcodec_receive_frame().
+     *
+     * @param frame - Frame to receive into
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EAGAIN: Need more input
+     *   - AVERROR_EOF: All frames have been output
+     *   - AVERROR_EINVAL: Invalid decoder state
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     * import { AVERROR_EAGAIN, AVERROR_EOF } from 'node-av';
+     *
+     * const ret = await ctx.receiveFrame(frame);
+     * if (ret === AVERROR_EAGAIN || ret === AVERROR_EOF) {
+     *   // No frame available
+     * } else {
+     *   FFmpegError.throwIfError(ret, 'receiveFrame');
+     *   // Process decoded frame
+     * }
+     * ```
+     *
+     * @see {@link sendPacket} To send packets for decoding
+     */
+    async receiveFrame(frame) {
+        return await this.native.receiveFrame(frame.getNative());
+    }
+    /**
+     * Receive decoded frame synchronously.
+     * Synchronous version of receiveFrame.
+     *
+     * Gets a decoded frame from the decoder.
+     * Call after sendPacketSync().
+     *
+     * Direct mapping to avcodec_receive_frame().
+     *
+     * @param frame - Frame to receive into
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EAGAIN: Need more input
+     *   - AVERROR_EOF: All frames have been output
+     *   - AVERROR_EINVAL: Invalid decoder state
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     * import { AVERROR_EAGAIN, AVERROR_EOF } from 'node-av';
+     *
+     * const ret = ctx.receiveFrameSync(frame);
+     * if (ret === AVERROR_EAGAIN || ret === AVERROR_EOF) {
+     *   // No frame available
+     * } else {
+     *   FFmpegError.throwIfError(ret, 'receiveFrameSync');
+     *   // Process frame
+     * }
+     * ```
+     *
+     * @see {@link receiveFrame} For async version
+     */
+    receiveFrameSync(frame) {
+        return this.native.receiveFrameSync(frame.getNative());
+    }
+    /**
+     * Send frame to encoder.
+     *
+     * Submits raw frame for encoding.
+     * Call receivePacket() to get encoded packets.
+     *
+     * Direct mapping to avcodec_send_frame().
+     *
+     * @param frame - Frame to encode (null to flush)
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EAGAIN: Must receive packets first
+     *   - AVERROR_EOF: Encoder has been flushed
+     *   - AVERROR_EINVAL: Invalid encoder state
+     *   - AVERROR_ENOMEM: Memory allocation failure
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     * import { AVERROR_EAGAIN } from 'node-av';
+     *
+     * const ret = await ctx.sendFrame(frame);
+     * if (ret === AVERROR_EAGAIN) {
+     *   // Need to receive packets first
+     * } else {
+     *   FFmpegError.throwIfError(ret, 'sendFrame');
+     * }
+     * ```
+     *
+     * @see {@link receivePacket} To get encoded packets
+     */
+    async sendFrame(frame) {
+        return await this.native.sendFrame(frame?.getNative() ?? null);
+    }
+    /**
+     * Send frame to encoder synchronously.
+     * Synchronous version of sendFrame.
+     *
+     * Submits raw frame for encoding.
+     * Call receivePacketSync() to get encoded packets.
+     *
+     * Direct mapping to avcodec_send_frame().
+     *
+     * @param frame - Frame to encode (null to flush)
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EAGAIN: Must receive packets first
+     *   - AVERROR_EOF: Encoder has been flushed
+     *   - AVERROR_EINVAL: Invalid encoder state
+     *   - AVERROR_ENOMEM: Memory allocation failure
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     * import { AVERROR_EAGAIN } from 'node-av';
+     *
+     * const ret = ctx.sendFrameSync(frame);
+     * if (ret === AVERROR_EAGAIN) {
+     *   // Need to receive packets first
+     *   ctx.receivePacketSync(packet);
+     * }
+     * ```
+     *
+     * @see {@link sendFrame} For async version
+     */
+    sendFrameSync(frame) {
+        return this.native.sendFrameSync(frame?.getNative() ?? null);
+    }
+    /**
+     * Receive encoded packet.
+     *
+     * Gets an encoded packet from the encoder.
+     * Call after sendFrame().
+     *
+     * Direct mapping to avcodec_receive_packet().
+     *
+     * @param packet - Packet to receive into
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EAGAIN: Need more input
+     *   - AVERROR_EOF: All packets have been output
+     *   - AVERROR_EINVAL: Invalid encoder state
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     * import { AVERROR_EAGAIN, AVERROR_EOF } from 'node-av';
+     *
+     * const ret = await ctx.receivePacket(packet);
+     * if (ret === AVERROR_EAGAIN || ret === AVERROR_EOF) {
+     *   // No packet available
+     * } else {
+     *   FFmpegError.throwIfError(ret, 'receivePacket');
+     *   // Process encoded packet
+     * }
+     * ```
+     *
+     * @see {@link sendFrame} To send frames for encoding
+     */
+    async receivePacket(packet) {
+        return await this.native.receivePacket(packet.getNative());
+    }
+    /**
+     * Receive encoded packet synchronously.
+     * Synchronous version of receivePacket.
+     *
+     * Gets an encoded packet from the encoder.
+     * Call after sendFrameSync().
+     *
+     * Direct mapping to avcodec_receive_packet().
+     *
+     * @param packet - Packet to receive into
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EAGAIN: Need more input
+     *   - AVERROR_EOF: All packets have been output
+     *   - AVERROR_EINVAL: Invalid encoder state
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     * import { AVERROR_EAGAIN, AVERROR_EOF } from 'node-av';
+     *
+     * const ret = ctx.receivePacketSync(packet);
+     * if (ret === AVERROR_EAGAIN || ret === AVERROR_EOF) {
+     *   // No packet available
+     * } else {
+     *   FFmpegError.throwIfError(ret, 'receivePacketSync');
+     *   // Process packet
+     * }
+     * ```
+     *
+     * @see {@link receivePacket} For async version
+     */
+    receivePacketSync(packet) {
+        return this.native.receivePacketSync(packet.getNative());
+    }
+    /**
+     * Set hardware pixel format.
+     *
+     * Configures hardware acceleration pixel formats.
+     * Used in get_format callback for hardware decoding.
+     *
+     * @param hwFormat - Hardware pixel format
+     *
+     * @param swFormat - Software pixel format (optional)
+     *
+     * @example
+     * ```typescript
+     * import { AV_PIX_FMT_CUDA, AV_PIX_FMT_NV12 } from 'node-av/constants';
+     *
+     * ctx.setHardwarePixelFormat(AV_PIX_FMT_CUDA, AV_PIX_FMT_NV12);
+     * ```
+     */
+    setHardwarePixelFormat(hwFormat, swFormat) {
+        this.native.setHardwarePixelFormat(hwFormat, swFormat);
+    }
+    /**
+     * Set codec flags.
+     *
+     * Sets one or more flags using bitwise OR. Allows setting multiple flags
+     * without manually performing bitwise operations.
+     *
+     * @param flags - One or more flag values to set
+     *
+     * @example
+     * ```typescript
+     * import { AV_CODEC_FLAG_QSCALE, AV_CODEC_FLAG_PSNR } from 'node-av/constants';
+     *
+     * // Set multiple flags at once
+     * codecContext.setFlags(AV_CODEC_FLAG_QSCALE, AV_CODEC_FLAG_PSNR);
+     * ```
+     *
+     * @see {@link clearFlags} To unset flags
+     * @see {@link hasFlags} To check flags
+     * @see {@link flags} For direct flag access
+     */
+    setFlags(...flags) {
+        for (const flag of flags) {
+            this.native.flags = (this.native.flags | flag);
+        }
+    }
+    /**
+     * Clear codec flags.
+     *
+     * Clears one or more flags using bitwise AND NOT. Allows clearing multiple
+     * flags without manually performing bitwise operations.
+     *
+     * @param flags - One or more flag values to clear
+     *
+     * @example
+     * ```typescript
+     * import { AV_CODEC_FLAG_PSNR } from 'node-av/constants';
+     *
+     * // Clear specific flag
+     * codecContext.clearFlags(AV_CODEC_FLAG_PSNR);
+     * ```
+     *
+     * @see {@link setFlags} To set flags
+     * @see {@link hasFlags} To check flags
+     * @see {@link flags} For direct flag access
+     */
+    clearFlags(...flags) {
+        for (const flag of flags) {
+            this.native.flags = (this.native.flags & ~flag);
+        }
+    }
+    /**
+     * Check if codec has specific flags.
+     *
+     * Tests whether all specified flags are set using bitwise AND.
+     *
+     * @param flags - One or more flag values to check
+     *
+     * @returns true if all specified flags are set, false otherwise
+     *
+     * @example
+     * ```typescript
+     * import { AV_CODEC_FLAG_QSCALE } from 'node-av/constants';
+     *
+     * if (codecContext.hasFlags(AV_CODEC_FLAG_QSCALE)) {
+     *   console.log('QSCALE flag is set');
+     * }
+     * ```
+     *
+     * @see {@link setFlags} To set flags
+     * @see {@link clearFlags} To unset flags
+     * @see {@link flags} For direct flag access
+     */
+    hasFlags(...flags) {
+        for (const flag of flags) {
+            if ((this.native.flags & flag) !== flag) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Set codec flags2.
+     *
+     * Sets one or more flags2 values using bitwise OR. Allows setting multiple flags
+     * without manually performing bitwise operations.
+     *
+     * @param flags - One or more flag2 values to set
+     *
+     * @example
+     * ```typescript
+     * import { AV_CODEC_FLAG2_FAST } from 'node-av/constants';
+     *
+     * // Set multiple flags2 at once
+     * codecContext.setFlags2(AV_CODEC_FLAG2_FAST);
+     * ```
+     *
+     * @see {@link clearFlags2} To unset flags2
+     * @see {@link hasFlags2} To check flags2
+     * @see {@link flags2} For direct flag2 access
+     */
+    setFlags2(...flags) {
+        for (const flag of flags) {
+            this.native.flags2 = (this.native.flags2 | flag);
+        }
+    }
+    /**
+     * Clear codec flags2.
+     *
+     * Clears one or more flags2 values using bitwise AND NOT. Allows clearing multiple
+     * flags without manually performing bitwise operations.
+     *
+     * @param flags - One or more flag2 values to clear
+     *
+     * @example
+     * ```typescript
+     * import { AV_CODEC_FLAG2_FAST } from 'node-av/constants';
+     *
+     * // Clear specific flag2
+     * codecContext.clearFlags2(AV_CODEC_FLAG2_FAST);
+     * ```
+     *
+     * @see {@link setFlags2} To set flags2
+     * @see {@link hasFlags2} To check flags2
+     * @see {@link flags2} For direct flag2 access
+     */
+    clearFlags2(...flags) {
+        for (const flag of flags) {
+            this.native.flags2 = (this.native.flags2 & ~flag);
+        }
+    }
+    /**
+     * Check if codec has specific flags2.
+     *
+     * Tests whether all specified flags2 are set using bitwise AND.
+     *
+     * @param flags - One or more flag2 values to check
+     *
+     * @returns true if all specified flags2 are set, false otherwise
+     *
+     * @example
+     * ```typescript
+     * import { AV_CODEC_FLAG2_FAST } from 'node-av/constants';
+     *
+     * if (codecContext.hasFlags2(AV_CODEC_FLAG2_FAST)) {
+     *   console.log('FAST flag2 is set');
+     * }
+     * ```
+     *
+     * @see {@link setFlags2} To set flags2
+     * @see {@link clearFlags2} To unset flags2
+     * @see {@link flags2} For direct flag2 access
+     */
+    hasFlags2(...flags) {
+        for (const flag of flags) {
+            if ((this.native.flags2 & flag) !== flag) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Get the underlying native CodecContext object.
+     *
+     * @returns The native CodecContext binding object
+     *
+     * @internal
+     */
+    getNative() {
+        return this.native;
+    }
+    /**
+     * Dispose of the codec context.
+     *
+     * Implements the Disposable interface for automatic cleanup.
+     * Equivalent to calling freeContext().
+     *
+     * @example
+     * ```typescript
+     * {
+     *   using ctx = new CodecContext();
+     *   ctx.allocContext3(codec);
+     *   await ctx.open2();
+     *   // Use context...
+     * } // Automatically freed when leaving scope
+     * ```
+     */
+    [Symbol.dispose]() {
+        this.native[Symbol.dispose]();
+    }
+}
+//# sourceMappingURL=codec-context.js.map