node-av 1.3.0 → 2.1.0

package/dist/lib/filter-context.d.ts

@@ -2,7 +2,7 @@ import { Filter } from './filter.js';
 import { HardwareDeviceContext } from './hardware-device-context.js';
 import { OptionMember } from './option.js';
 import { Rational } from './rational.js';
-import type { AVPixelFormat, AVSampleFormat } from '../constants/constants.js';
+import type { AVColorRange, AVColorSpace, AVPixelFormat, AVSampleFormat } from '../constants/constants.js';
 import type { Frame } from './frame.js';
 import type { HardwareFramesContext } from './hardware-frames-context.js';
 import type { NativeDictionary, NativeFilterContext, NativeFilterGraph, NativeWrapper } from './native-types.js';
@@ -47,6 +47,7 @@ export declare class FilterContext extends OptionMember<NativeFilterContext> imp
     private _hwDeviceCtx?;
     /**
      * @param native - The native filter context instance
+     *
      * @internal
      */
     constructor(native: NativeFilterContext);
@@ -120,6 +121,7 @@ export declare class FilterContext extends OptionMember<NativeFilterContext> imp
      * Direct mapping to avfilter_init_dict().
      *
      * @param options - Dictionary of filter options
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Invalid parameters
      *   - AVERROR_ENOMEM: Memory allocation failure
@@ -145,6 +147,7 @@ export declare class FilterContext extends OptionMember<NativeFilterContext> imp
      * Direct mapping to avfilter_init_str().
      *
      * @param args - Filter arguments string
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Invalid arguments
      *   - AVERROR_ENOMEM: Memory allocation failure
@@ -174,8 +177,11 @@ export declare class FilterContext extends OptionMember<NativeFilterContext> imp
      * Direct mapping to avfilter_link().
      *
      * @param srcPad - Output pad index of this filter
+     *
      * @param dst - Destination filter context
+     *
      * @param dstPad - Input pad index of destination filter
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Invalid pad indices or incompatible formats
      *   - AVERROR_ENOMEM: Memory allocation failure
@@ -224,6 +230,7 @@ export declare class FilterContext extends OptionMember<NativeFilterContext> imp
      * Direct mapping to av_buffersrc_add_frame().
      *
      * @param frame - Frame to send, or null for EOF
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EAGAIN: Filter needs more output consumption
      *   - AVERROR_EOF: Filter has been closed
@@ -250,6 +257,45 @@ export declare class FilterContext extends OptionMember<NativeFilterContext> imp
      * @see {@link buffersinkGetFrame} To retrieve filtered frames
      */
     buffersrcAddFrame(frame: Frame | null): Promise<number>;
+    /**
+     * Add frame to buffer source filter synchronously.
+     * Synchronous version of buffersrcAddFrame.
+     *
+     * Sends a frame to a buffer source filter for processing.
+     * Only valid for buffer source filters (buffer, abuffer).
+     *
+     * Direct mapping to av_buffersrc_add_frame().
+     *
+     * @param frame - Frame to send (null to mark EOF)
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EAGAIN: Need to retrieve output first
+     *   - AVERROR_EOF: Graph has finished processing
+     *   - AVERROR_EINVAL: Invalid parameters
+     *   - AVERROR(ENOMEM): Memory allocation failure
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     * import { AVERROR_EAGAIN } from 'node-av/constants';
+     *
+     * // Send frame to filter
+     * const ret = bufferSrc.buffersrcAddFrameSync(frame);
+     * if (ret === AVERROR_EAGAIN) {
+     *   // Need to get output frames first
+     *   const filtered = new Frame();
+     *   bufferSink.buffersinkGetFrameSync(filtered);
+     * } else {
+     *   FFmpegError.throwIfError(ret, 'buffersrcAddFrameSync');
+     * }
+     *
+     * // Mark end of stream
+     * bufferSrc.buffersrcAddFrameSync(null);
+     * ```
+     *
+     * @see {@link buffersrcAddFrame} For async version
+     */
+    buffersrcAddFrameSync(frame: Frame | null): number;
     /**
      * Set parameters for a buffer source filter.
      *
@@ -259,15 +305,29 @@ export declare class FilterContext extends OptionMember<NativeFilterContext> imp
      * Direct mapping to av_buffersrc_parameters_set().
      *
      * @param params - Source parameters
+     *
      * @param params.width - Video frame width
+     *
      * @param params.height - Video frame height
+     *
      * @param params.format - Pixel or sample format
+     *
      * @param params.timeBase - Time base for timestamps
+     *
      * @param params.frameRate - Video frame rate
+     *
      * @param params.sampleAspectRatio - Pixel aspect ratio
+     *
      * @param params.hwFramesCtx - Hardware frames context
+     *
      * @param params.sampleRate - Audio sample rate
+     *
      * @param params.channelLayout - Audio channel layout
+     *
+     * @param params.colorRange - Color range for video
+     *
+     * @param params.colorSpace - Color space for video
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Invalid parameters
      *   - AVERROR_ENOMEM: Memory allocation failure
@@ -286,18 +346,33 @@ export declare class FilterContext extends OptionMember<NativeFilterContext> imp
      *   frameRate: { num: 25, den: 1 }
      * });
      * FFmpegError.throwIfError(ret, 'buffersrcParametersSet');
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     * import { AV_SAMPLE_FMT_FLTP } from 'node-av/constants';
+     *
+     * // Configure audio buffer source
+     * const ret = bufferSrc.buffersrcParametersSet({
+     *   format: AV_SAMPLE_FMT_FLTP,
+     *   sampleRate: 44100,
+     *   channelLayout: AV_CHANNEL_LAYOUT_STEREO
+     * });
+     * FFmpegError.throwIfError(ret, 'buffersrcParametersSet');
      * ```
      */
     buffersrcParametersSet(params: {
         width?: number;
         height?: number;
-        format?: number;
+        format?: AVPixelFormat | AVSampleFormat;
         timeBase?: IRational;
         frameRate?: IRational;
         sampleAspectRatio?: IRational;
         hwFramesCtx?: HardwareFramesContext | null;
         sampleRate?: number;
         channelLayout?: bigint;
+        colorRange?: AVColorRange;
+        colorSpace?: AVColorSpace;
     }): number;
     /**
      * Get a frame from a buffer sink filter.
@@ -308,6 +383,7 @@ export declare class FilterContext extends OptionMember<NativeFilterContext> imp
      * Direct mapping to av_buffersink_get_frame().
      *
      * @param frame - Frame to receive filtered data
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EAGAIN: No frame available yet
      *   - AVERROR_EOF: No more frames will be produced
@@ -335,6 +411,47 @@ export declare class FilterContext extends OptionMember<NativeFilterContext> imp
      * @see {@link buffersrcAddFrame} To send frames for filtering
      */
     buffersinkGetFrame(frame: Frame): Promise<number>;
+    /**
+     * Get frame from buffer sink filter synchronously.
+     * Synchronous version of buffersinkGetFrame.
+     *
+     * Retrieves a filtered frame from a buffer sink filter.
+     * Only valid for buffer sink filters (buffersink, abuffersink).
+     *
+     * Direct mapping to av_buffersink_get_frame().
+     *
+     * @param frame - Frame to receive filtered data
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EAGAIN: Need more input
+     *   - AVERROR_EOF: No more frames available
+     *   - AVERROR_EINVAL: Invalid parameters
+     *
+     * @example
+     * ```typescript
+     * import { Frame, FFmpegError } from 'node-av';
+     * import { AVERROR_EAGAIN, AVERROR_EOF } from 'node-av/constants';
+     *
+     * // Get filtered frame
+     * const filtered = new Frame();
+     * const ret = bufferSink.buffersinkGetFrameSync(filtered);
+     *
+     * if (ret === 0) {
+     *   // Process filtered frame
+     *   console.log(`Got filtered frame with ${filtered.nbSamples} samples`);
+     *   filtered.unref();
+     * } else if (ret === AVERROR_EAGAIN) {
+     *   // Need more input frames
+     * } else if (ret === AVERROR_EOF) {
+     *   // No more frames
+     * } else {
+     *   FFmpegError.throwIfError(ret, 'buffersinkGetFrameSync');
+     * }
+     * ```
+     *
+     * @see {@link buffersinkGetFrame} For async version
+     */
+    buffersinkGetFrameSync(frame: Frame): number;
     /**
      * Get time base from buffer sink.
      *

package/dist/lib/filter-context.js

@@ -42,6 +42,7 @@ export class FilterContext extends OptionMember {
     _hwDeviceCtx; // Cache for hardware device context wrapper
     /**
      * @param native - The native filter context instance
+     *
      * @internal
      */
     constructor(native) {
@@ -152,6 +153,7 @@ export class FilterContext extends OptionMember {
      * Direct mapping to avfilter_init_dict().
      *
      * @param options - Dictionary of filter options
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Invalid parameters
      *   - AVERROR_ENOMEM: Memory allocation failure
@@ -179,6 +181,7 @@ export class FilterContext extends OptionMember {
      * Direct mapping to avfilter_init_str().
      *
      * @param args - Filter arguments string
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Invalid arguments
      *   - AVERROR_ENOMEM: Memory allocation failure
@@ -210,8 +213,11 @@ export class FilterContext extends OptionMember {
      * Direct mapping to avfilter_link().
      *
      * @param srcPad - Output pad index of this filter
+     *
      * @param dst - Destination filter context
+     *
      * @param dstPad - Input pad index of destination filter
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Invalid pad indices or incompatible formats
      *   - AVERROR_ENOMEM: Memory allocation failure
@@ -264,6 +270,7 @@ export class FilterContext extends OptionMember {
      * Direct mapping to av_buffersrc_add_frame().
      *
      * @param frame - Frame to send, or null for EOF
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EAGAIN: Filter needs more output consumption
      *   - AVERROR_EOF: Filter has been closed
@@ -292,6 +299,47 @@ export class FilterContext extends OptionMember {
     async buffersrcAddFrame(frame) {
         return await this.native.buffersrcAddFrame(frame ? frame.getNative() : null);
     }
+    /**
+     * Add frame to buffer source filter synchronously.
+     * Synchronous version of buffersrcAddFrame.
+     *
+     * Sends a frame to a buffer source filter for processing.
+     * Only valid for buffer source filters (buffer, abuffer).
+     *
+     * Direct mapping to av_buffersrc_add_frame().
+     *
+     * @param frame - Frame to send (null to mark EOF)
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EAGAIN: Need to retrieve output first
+     *   - AVERROR_EOF: Graph has finished processing
+     *   - AVERROR_EINVAL: Invalid parameters
+     *   - AVERROR(ENOMEM): Memory allocation failure
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     * import { AVERROR_EAGAIN } from 'node-av/constants';
+     *
+     * // Send frame to filter
+     * const ret = bufferSrc.buffersrcAddFrameSync(frame);
+     * if (ret === AVERROR_EAGAIN) {
+     *   // Need to get output frames first
+     *   const filtered = new Frame();
+     *   bufferSink.buffersinkGetFrameSync(filtered);
+     * } else {
+     *   FFmpegError.throwIfError(ret, 'buffersrcAddFrameSync');
+     * }
+     *
+     * // Mark end of stream
+     * bufferSrc.buffersrcAddFrameSync(null);
+     * ```
+     *
+     * @see {@link buffersrcAddFrame} For async version
+     */
+    buffersrcAddFrameSync(frame) {
+        return this.native.buffersrcAddFrameSync(frame ? frame.getNative() : null);
+    }
     /**
      * Set parameters for a buffer source filter.
      *
@@ -301,15 +349,29 @@ export class FilterContext extends OptionMember {
      * Direct mapping to av_buffersrc_parameters_set().
      *
      * @param params - Source parameters
+     *
      * @param params.width - Video frame width
+     *
      * @param params.height - Video frame height
+     *
      * @param params.format - Pixel or sample format
+     *
      * @param params.timeBase - Time base for timestamps
+     *
      * @param params.frameRate - Video frame rate
+     *
      * @param params.sampleAspectRatio - Pixel aspect ratio
+     *
      * @param params.hwFramesCtx - Hardware frames context
+     *
      * @param params.sampleRate - Audio sample rate
+     *
      * @param params.channelLayout - Audio channel layout
+     *
+     * @param params.colorRange - Color range for video
+     *
+     * @param params.colorSpace - Color space for video
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Invalid parameters
      *   - AVERROR_ENOMEM: Memory allocation failure
@@ -328,6 +390,19 @@ export class FilterContext extends OptionMember {
      *   frameRate: { num: 25, den: 1 }
      * });
      * FFmpegError.throwIfError(ret, 'buffersrcParametersSet');
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     * import { AV_SAMPLE_FMT_FLTP } from 'node-av/constants';
+     *
+     * // Configure audio buffer source
+     * const ret = bufferSrc.buffersrcParametersSet({
+     *   format: AV_SAMPLE_FMT_FLTP,
+     *   sampleRate: 44100,
+     *   channelLayout: AV_CHANNEL_LAYOUT_STEREO
+     * });
+     * FFmpegError.throwIfError(ret, 'buffersrcParametersSet');
      * ```
      */
     buffersrcParametersSet(params) {
@@ -346,6 +421,7 @@ export class FilterContext extends OptionMember {
      * Direct mapping to av_buffersink_get_frame().
      *
      * @param frame - Frame to receive filtered data
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EAGAIN: No frame available yet
      *   - AVERROR_EOF: No more frames will be produced
@@ -375,6 +451,49 @@ export class FilterContext extends OptionMember {
     async buffersinkGetFrame(frame) {
         return await this.native.buffersinkGetFrame(frame.getNative());
     }
+    /**
+     * Get frame from buffer sink filter synchronously.
+     * Synchronous version of buffersinkGetFrame.
+     *
+     * Retrieves a filtered frame from a buffer sink filter.
+     * Only valid for buffer sink filters (buffersink, abuffersink).
+     *
+     * Direct mapping to av_buffersink_get_frame().
+     *
+     * @param frame - Frame to receive filtered data
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EAGAIN: Need more input
+     *   - AVERROR_EOF: No more frames available
+     *   - AVERROR_EINVAL: Invalid parameters
+     *
+     * @example
+     * ```typescript
+     * import { Frame, FFmpegError } from 'node-av';
+     * import { AVERROR_EAGAIN, AVERROR_EOF } from 'node-av/constants';
+     *
+     * // Get filtered frame
+     * const filtered = new Frame();
+     * const ret = bufferSink.buffersinkGetFrameSync(filtered);
+     *
+     * if (ret === 0) {
+     *   // Process filtered frame
+     *   console.log(`Got filtered frame with ${filtered.nbSamples} samples`);
+     *   filtered.unref();
+     * } else if (ret === AVERROR_EAGAIN) {
+     *   // Need more input frames
+     * } else if (ret === AVERROR_EOF) {
+     *   // No more frames
+     * } else {
+     *   FFmpegError.throwIfError(ret, 'buffersinkGetFrameSync');
+     * }
+     * ```
+     *
+     * @see {@link buffersinkGetFrame} For async version
+     */
+    buffersinkGetFrameSync(frame) {
+        return this.native.buffersinkGetFrameSync(frame.getNative());
+    }
     /**
      * Get time base from buffer sink.
      *

package/dist/lib/filter-context.js.map

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

package/dist/lib/filter-graph.d.ts

@@ -153,8 +153,11 @@ export declare class FilterGraph extends OptionMember<NativeFilterGraph> impleme
      * Direct mapping to avfilter_graph_create_filter().
      *
      * @param filter - Filter descriptor to instantiate
+     *
      * @param name - Name for this filter instance
+     *
      * @param args - Initialization arguments (filter-specific)
+     *
      * @returns Created filter context, or null on failure
      *
      * @example
@@ -187,7 +190,9 @@ export declare class FilterGraph extends OptionMember<NativeFilterGraph> impleme
      * Direct mapping to avfilter_graph_alloc_filter().
      *
      * @param filter - Filter descriptor to instantiate
+     *
      * @param name - Name for this filter instance
+     *
      * @returns Allocated filter context, or null on failure
      *
      * @example
@@ -216,6 +221,7 @@ export declare class FilterGraph extends OptionMember<NativeFilterGraph> impleme
      * Direct mapping to avfilter_graph_get_filter().
      *
      * @param name - Name of the filter instance
+     *
      * @returns Filter context if found, null otherwise
      *
      * @example
@@ -258,6 +264,32 @@ export declare class FilterGraph extends OptionMember<NativeFilterGraph> impleme
      * @see {@link validate} To check configuration
      */
     config(): Promise<number>;
+    /**
+     * Configure the filter graph synchronously.
+     * Synchronous version of config.
+     *
+     * Validates and finalizes the graph structure after all filters
+     * have been added and connected. Must be called before processing.
+     *
+     * Direct mapping to avfilter_graph_config().
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EINVAL: Invalid graph structure
+     *   - AVERROR_ENOMEM: Memory allocation failure
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     *
+     * // Configure graph after building
+     * const ret = graph.configSync();
+     * FFmpegError.throwIfError(ret, 'configSync');
+     * // Graph is now ready for processing
+     * ```
+     *
+     * @see {@link config} For async version
+     */
+    configSync(): number;
     /**
      * Parse a filter graph description.
      *
@@ -267,8 +299,11 @@ export declare class FilterGraph extends OptionMember<NativeFilterGraph> impleme
      * Direct mapping to avfilter_graph_parse().
      *
      * @param filters - Filter graph description string
+     *
      * @param inputs - Linked list of graph inputs
+     *
      * @param outputs - Linked list of graph outputs
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Parse error
      *   - AVERROR_ENOMEM: Memory allocation failure
@@ -305,6 +340,7 @@ export declare class FilterGraph extends OptionMember<NativeFilterGraph> impleme
      * Direct mapping to avfilter_graph_parse2().
      *
      * @param filters - Filter graph description string
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Parse error
      *   - AVERROR_ENOMEM: Memory allocation failure
@@ -331,8 +367,11 @@ export declare class FilterGraph extends OptionMember<NativeFilterGraph> impleme
      * Direct mapping to avfilter_graph_parse_ptr().
      *
      * @param filters - Filter graph description string
+     *
      * @param inputs - Optional linked list of inputs
+     *
      * @param outputs - Optional linked list of outputs
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Parse error
      *   - AVERROR_ENOMEM: Memory allocation failure
@@ -399,6 +438,38 @@ export declare class FilterGraph extends OptionMember<NativeFilterGraph> impleme
      * ```
      */
     requestOldest(): Promise<number>;
+    /**
+     * Request the oldest queued frame from filters synchronously.
+     * Synchronous version of requestOldest.
+     *
+     * Requests a frame from the oldest sink in the graph.
+     * Used for pulling frames through the filter pipeline.
+     *
+     * Direct mapping to avfilter_graph_request_oldest().
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EOF: No more frames
+     *   - AVERROR_EAGAIN: Need more input
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     * import { AVERROR_EOF, AVERROR_EAGAIN } from 'node-av/constants';
+     *
+     * // Pull frames through the graph
+     * const ret = graph.requestOldestSync();
+     * if (ret === AVERROR_EOF) {
+     *   // All frames processed
+     * } else if (ret === AVERROR_EAGAIN) {
+     *   // Need more input frames
+     * } else {
+     *   FFmpegError.throwIfError(ret, 'requestOldestSync');
+     * }
+     * ```
+     *
+     * @see {@link requestOldest} For async version
+     */
+    requestOldestSync(): number;
     /**
      * Dump the filter graph to a string.
      *
@@ -428,9 +499,13 @@ export declare class FilterGraph extends OptionMember<NativeFilterGraph> impleme
      * Direct mapping to avfilter_graph_send_command().
      *
      * @param target - Filter name or "all"
+     *
      * @param cmd - Command to send
+     *
      * @param arg - Command argument
+     *
      * @param flags - Command flags
+     *
      * @returns Error code or response object
      *
      * @example
@@ -464,10 +539,15 @@ export declare class FilterGraph extends OptionMember<NativeFilterGraph> impleme
      * Direct mapping to avfilter_graph_queue_command().
      *
      * @param target - Filter name or "all"
+     *
      * @param cmd - Command to queue
+     *
      * @param arg - Command argument
+     *
      * @param ts - Timestamp for execution
+     *
      * @param flags - Command flags
+     *
      * @returns 0 on success, negative AVERROR on error
      *
      * @example