node-av-light 0.0.0 → 7.1.0-beta.1

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

@@ -0,0 +1,202 @@
+import { FilterContext } from './filter-context.js';
+import type { NativeFilterInOut, NativeWrapper } from './native-types.js';
+/**
+ * Filter input/output linked list structure for filter graph parsing.
+ *
+ * Represents a linked list of labeled filter pads used during filter graph
+ * configuration. Each node contains a filter context, pad index, and optional
+ * label for connecting filters together. Used internally by avfilter_graph_parse()
+ * to track unlinked filter pads during graph construction.
+ *
+ * The head of a list owns all of its nodes, including lists appended through
+ * `next`. Once the head is freed, the other nodes read their defaults (e.g. name
+ * null) and ignore writes.
+ *
+ * Direct mapping to FFmpeg's AVFilterInOut.
+ *
+ * @example
+ * ```typescript
+ * import { FilterInOut, FilterContext, FFmpegError } from 'node-av';
+ *
+ * // Create a linked list of filter inputs/outputs
+ * const inputs = FilterInOut.createList([
+ *   { name: 'in', filterCtx: bufferSrc, padIdx: 0 },
+ *   { name: 'overlay', filterCtx: overlay, padIdx: 1 }
+ * ]);
+ *
+ * // Parse filter graph with labeled connections
+ * const ret = graph.parse(filterString, inputs, outputs);
+ * FFmpegError.throwIfError(ret, 'parse');
+ *
+ * // Manual creation and linking
+ * const inout = new FilterInOut();
+ * inout.alloc();
+ * inout.name = 'input';
+ * inout.filterCtx = sourceFilter;
+ * inout.padIdx = 0;
+ * ```
+ *
+ * @see [AVFilterInOut](https://ffmpeg.org/doxygen/trunk/structAVFilterInOut.html) - FFmpeg Doxygen
+ * @see {@link FilterGraph} For parsing filter descriptions
+ * @see {@link FilterContext} For filter instances
+ */
+export declare class FilterInOut implements Disposable, NativeWrapper<NativeFilterInOut> {
+    private native;
+    constructor();
+    /**
+     * Create a linked list of filter inputs/outputs.
+     *
+     * Convenience method to build a linked list structure from an array
+     * of filter specifications. Each item becomes a node in the list.
+     *
+     * @param items - Array of filter input/output specifications
+     *
+     * @returns Head of the linked list, or null if items is empty
+     *
+     * @example
+     * ```typescript
+     * // Create inputs for a filter graph
+     * const inputs = FilterInOut.createList([
+     *   { name: 'video_in', filterCtx: videoBuffer, padIdx: 0 },
+     *   { name: 'audio_in', filterCtx: audioBuffer, padIdx: 0 }
+     * ]);
+     *
+     * // Create outputs
+     * const outputs = FilterInOut.createList([
+     *   { name: 'video_out', filterCtx: videoSink, padIdx: 0 },
+     *   { name: 'audio_out', filterCtx: audioSink, padIdx: 0 }
+     * ]);
+     * ```
+     *
+     * @see {@link alloc} For manual node creation
+     */
+    static createList(items: {
+        name: string;
+        filterCtx: FilterContext;
+        padIdx: number;
+    }[]): FilterInOut | null;
+    /**
+     * Label name for this filter pad.
+     *
+     * Used to reference this connection point in filter graph strings.
+     * For example, "[in]" or "[video_out]".
+     *
+     * Direct mapping to AVFilterInOut->name.
+     */
+    get name(): string | null;
+    set name(value: string | null);
+    /**
+     * Filter context this pad belongs to.
+     *
+     * Reference to the filter instance containing this pad.
+     *
+     * Direct mapping to AVFilterInOut->filter_ctx.
+     */
+    get filterCtx(): FilterContext | null;
+    set filterCtx(value: FilterContext | null);
+    /**
+     * Pad index within the filter.
+     *
+     * Index of the input or output pad in the filter context.
+     * 0 for the first pad, 1 for the second, etc.
+     *
+     * Direct mapping to AVFilterInOut->pad_idx.
+     */
+    get padIdx(): number;
+    set padIdx(value: number);
+    /**
+     * Next node in the linked list.
+     *
+     * Reference to the next FilterInOut in the chain, or null for the last node.
+     *
+     * Direct mapping to AVFilterInOut->next.
+     */
+    get next(): FilterInOut | null;
+    set next(value: FilterInOut | null);
+    /**
+     * Allocate a FilterInOut structure.
+     *
+     * Allocates memory for the structure. Must be called before using
+     * a manually created instance.
+     *
+     * Direct mapping to avfilter_inout_alloc().
+     *
+     * @throws {Error} If allocation fails (ENOMEM)
+     *
+     * @example
+     * ```typescript
+     * const inout = new FilterInOut();
+     * inout.alloc();
+     * inout.name = 'input';
+     * inout.filterCtx = bufferSource;
+     * inout.padIdx = 0;
+     * ```
+     *
+     * @see {@link free} To deallocate
+     * @see {@link createList} For automatic allocation
+     */
+    alloc(): void;
+    /**
+     * Free the FilterInOut structure.
+     *
+     * Deallocates the structure and breaks the chain if part of a linked list.
+     * Only frees this node, not the entire list.
+     *
+     * Direct mapping to avfilter_inout_free().
+     *
+     * @example
+     * ```typescript
+     * inout.free();
+     * // Structure is now invalid
+     * ```
+     *
+     * @see {@link alloc} To allocate
+     * @see {@link Symbol.dispose} For automatic cleanup
+     */
+    free(): void;
+    /**
+     * Count nodes in the linked list.
+     *
+     * Counts the total number of nodes starting from this node
+     * and following the next pointers.
+     *
+     * @returns Number of nodes in the list (including this one)
+     *
+     * @example
+     * ```typescript
+     * const list = FilterInOut.createList([
+     *   { name: 'in1', filterCtx: filter1, padIdx: 0 },
+     *   { name: 'in2', filterCtx: filter2, padIdx: 0 },
+     *   { name: 'in3', filterCtx: filter3, padIdx: 0 }
+     * ]);
+     *
+     * console.log(`List has ${list.count()} nodes`); // 3
+     * ```
+     */
+    count(): number;
+    /**
+     * Get the underlying native FilterInOut object.
+     *
+     * @returns The native FilterInOut binding object
+     *
+     * @internal
+     */
+    getNative(): NativeFilterInOut;
+    /**
+     * Dispose of the FilterInOut structure.
+     *
+     * Implements the Disposable interface for automatic cleanup.
+     * Equivalent to calling free().
+     *
+     * @example
+     * ```typescript
+     * {
+     *   using inout = new FilterInOut();
+     *   inout.alloc();
+     *   inout.name = 'test';
+     *   // Use inout...
+     * } // Automatically freed when leaving scope
+     * ```
+     */
+    [Symbol.dispose](): void;
+}

package/dist/lib/filter-inout.js

@@ -0,0 +1,261 @@
+import { bindings } from './binding.js';
+import { FilterContext } from './filter-context.js';
+/**
+ * Filter input/output linked list structure for filter graph parsing.
+ *
+ * Represents a linked list of labeled filter pads used during filter graph
+ * configuration. Each node contains a filter context, pad index, and optional
+ * label for connecting filters together. Used internally by avfilter_graph_parse()
+ * to track unlinked filter pads during graph construction.
+ *
+ * The head of a list owns all of its nodes, including lists appended through
+ * `next`. Once the head is freed, the other nodes read their defaults (e.g. name
+ * null) and ignore writes.
+ *
+ * Direct mapping to FFmpeg's AVFilterInOut.
+ *
+ * @example
+ * ```typescript
+ * import { FilterInOut, FilterContext, FFmpegError } from 'node-av';
+ *
+ * // Create a linked list of filter inputs/outputs
+ * const inputs = FilterInOut.createList([
+ *   { name: 'in', filterCtx: bufferSrc, padIdx: 0 },
+ *   { name: 'overlay', filterCtx: overlay, padIdx: 1 }
+ * ]);
+ *
+ * // Parse filter graph with labeled connections
+ * const ret = graph.parse(filterString, inputs, outputs);
+ * FFmpegError.throwIfError(ret, 'parse');
+ *
+ * // Manual creation and linking
+ * const inout = new FilterInOut();
+ * inout.alloc();
+ * inout.name = 'input';
+ * inout.filterCtx = sourceFilter;
+ * inout.padIdx = 0;
+ * ```
+ *
+ * @see [AVFilterInOut](https://ffmpeg.org/doxygen/trunk/structAVFilterInOut.html) - FFmpeg Doxygen
+ * @see {@link FilterGraph} For parsing filter descriptions
+ * @see {@link FilterContext} For filter instances
+ */
+export class FilterInOut {
+    native;
+    constructor() {
+        this.native = new bindings.FilterInOut();
+    }
+    /**
+     * Create a linked list of filter inputs/outputs.
+     *
+     * Convenience method to build a linked list structure from an array
+     * of filter specifications. Each item becomes a node in the list.
+     *
+     * @param items - Array of filter input/output specifications
+     *
+     * @returns Head of the linked list, or null if items is empty
+     *
+     * @example
+     * ```typescript
+     * // Create inputs for a filter graph
+     * const inputs = FilterInOut.createList([
+     *   { name: 'video_in', filterCtx: videoBuffer, padIdx: 0 },
+     *   { name: 'audio_in', filterCtx: audioBuffer, padIdx: 0 }
+     * ]);
+     *
+     * // Create outputs
+     * const outputs = FilterInOut.createList([
+     *   { name: 'video_out', filterCtx: videoSink, padIdx: 0 },
+     *   { name: 'audio_out', filterCtx: audioSink, padIdx: 0 }
+     * ]);
+     * ```
+     *
+     * @see {@link alloc} For manual node creation
+     */
+    static createList(items) {
+        if (items.length === 0)
+            return null;
+        let head = null;
+        let current = null;
+        for (const item of items) {
+            const inout = new FilterInOut();
+            inout.alloc();
+            inout.name = item.name;
+            inout.filterCtx = item.filterCtx;
+            inout.padIdx = item.padIdx;
+            if (!head) {
+                head = inout;
+                current = inout;
+            }
+            else if (current) {
+                current.next = inout;
+                current = inout;
+            }
+        }
+        return head;
+    }
+    /**
+     * Label name for this filter pad.
+     *
+     * Used to reference this connection point in filter graph strings.
+     * For example, "[in]" or "[video_out]".
+     *
+     * Direct mapping to AVFilterInOut->name.
+     */
+    get name() {
+        return this.native.name;
+    }
+    set name(value) {
+        this.native.name = value;
+    }
+    /**
+     * Filter context this pad belongs to.
+     *
+     * Reference to the filter instance containing this pad.
+     *
+     * Direct mapping to AVFilterInOut->filter_ctx.
+     */
+    get filterCtx() {
+        const native = this.native.filterCtx;
+        return native ? new FilterContext(native) : null;
+    }
+    set filterCtx(value) {
+        this.native.filterCtx = value ? value.getNative() : null;
+    }
+    /**
+     * Pad index within the filter.
+     *
+     * Index of the input or output pad in the filter context.
+     * 0 for the first pad, 1 for the second, etc.
+     *
+     * Direct mapping to AVFilterInOut->pad_idx.
+     */
+    get padIdx() {
+        return this.native.padIdx;
+    }
+    set padIdx(value) {
+        this.native.padIdx = value;
+    }
+    /**
+     * Next node in the linked list.
+     *
+     * Reference to the next FilterInOut in the chain, or null for the last node.
+     *
+     * Direct mapping to AVFilterInOut->next.
+     */
+    get next() {
+        const native = this.native.next;
+        if (!native) {
+            return null;
+        }
+        const filterInOut = Object.create(FilterInOut.prototype);
+        filterInOut.native = native;
+        return filterInOut;
+    }
+    set next(value) {
+        this.native.next = value ? value.getNative() : null;
+    }
+    /**
+     * Allocate a FilterInOut structure.
+     *
+     * Allocates memory for the structure. Must be called before using
+     * a manually created instance.
+     *
+     * Direct mapping to avfilter_inout_alloc().
+     *
+     * @throws {Error} If allocation fails (ENOMEM)
+     *
+     * @example
+     * ```typescript
+     * const inout = new FilterInOut();
+     * inout.alloc();
+     * inout.name = 'input';
+     * inout.filterCtx = bufferSource;
+     * inout.padIdx = 0;
+     * ```
+     *
+     * @see {@link free} To deallocate
+     * @see {@link createList} For automatic allocation
+     */
+    alloc() {
+        this.native.alloc();
+    }
+    /**
+     * Free the FilterInOut structure.
+     *
+     * Deallocates the structure and breaks the chain if part of a linked list.
+     * Only frees this node, not the entire list.
+     *
+     * Direct mapping to avfilter_inout_free().
+     *
+     * @example
+     * ```typescript
+     * inout.free();
+     * // Structure is now invalid
+     * ```
+     *
+     * @see {@link alloc} To allocate
+     * @see {@link Symbol.dispose} For automatic cleanup
+     */
+    free() {
+        this.native.free();
+    }
+    /**
+     * Count nodes in the linked list.
+     *
+     * Counts the total number of nodes starting from this node
+     * and following the next pointers.
+     *
+     * @returns Number of nodes in the list (including this one)
+     *
+     * @example
+     * ```typescript
+     * const list = FilterInOut.createList([
+     *   { name: 'in1', filterCtx: filter1, padIdx: 0 },
+     *   { name: 'in2', filterCtx: filter2, padIdx: 0 },
+     *   { name: 'in3', filterCtx: filter3, padIdx: 0 }
+     * ]);
+     *
+     * console.log(`List has ${list.count()} nodes`); // 3
+     * ```
+     */
+    count() {
+        let count = 1;
+        let current = this.next;
+        while (current) {
+            count++;
+            current = current.next;
+        }
+        return count;
+    }
+    /**
+     * Get the underlying native FilterInOut object.
+     *
+     * @returns The native FilterInOut binding object
+     *
+     * @internal
+     */
+    getNative() {
+        return this.native;
+    }
+    /**
+     * Dispose of the FilterInOut structure.
+     *
+     * Implements the Disposable interface for automatic cleanup.
+     * Equivalent to calling free().
+     *
+     * @example
+     * ```typescript
+     * {
+     *   using inout = new FilterInOut();
+     *   inout.alloc();
+     *   inout.name = 'test';
+     *   // Use inout...
+     * } // Automatically freed when leaving scope
+     * ```
+     */
+    [Symbol.dispose]() {
+        this.native[Symbol.dispose]();
+    }
+}
+//# sourceMappingURL=filter-inout.js.map

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

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

package/dist/lib/filter.d.ts

@@ -0,0 +1,243 @@
+import { type AVMediaType } from '../constants/constants.js';
+import type { NativeFilter, NativeWrapper } from './native-types.js';
+/**
+ * Filter pad information
+ */
+export interface FilterPad {
+    name: string | null;
+    type: AVMediaType;
+}
+/**
+ * Filter descriptor for video/audio processing.
+ *
+ * Represents a filter that can be used in filter graphs for processing
+ * audio and video frames. Filters can be sources (no inputs), sinks (no outputs),
+ * or processors (with both inputs and outputs). Each filter has specific
+ * capabilities and pad configurations.
+ *
+ * Direct mapping to FFmpeg's AVFilter.
+ *
+ * @example
+ * ```typescript
+ * import { Filter } from 'node-av';
+ *
+ * // Get a specific filter
+ * const scaleFilter = Filter.getByName('scale');
+ * if (scaleFilter) {
+ *   console.log(`Filter: ${scaleFilter.name}`);
+ *   console.log(`Description: ${scaleFilter.description}`);
+ *   console.log(`Inputs: ${scaleFilter.inputs.length}`);
+ *   console.log(`Outputs: ${scaleFilter.outputs.length}`);
+ * }
+ *
+ * // List all video filters
+ * const filters = Filter.getList();
+ * const videoFilters = filters.filter(f => f.isVideo());
+ * console.log(`Found ${videoFilters.length} video filters`);
+ * ```
+ *
+ * @see [AVFilter](https://ffmpeg.org/doxygen/trunk/structAVFilter.html) - FFmpeg Doxygen
+ * @see {@link FilterContext} For using filters in graphs
+ * @see {@link FilterGraph} For building filter pipelines
+ */
+export declare class Filter implements NativeWrapper<NativeFilter> {
+    private native;
+    /**
+     * @param native - The native filter instance
+     *
+     * @internal
+     */
+    constructor(native: NativeFilter);
+    /**
+     * Get a filter by name.
+     *
+     * Retrieves a specific filter descriptor by its name.
+     * Common filter names include 'scale', 'crop', 'overlay', 'aformat', etc.
+     *
+     * Direct mapping to avfilter_get_by_name().
+     *
+     * @param name - Name of the filter
+     *
+     * @returns Filter instance if found, null otherwise
+     *
+     * @example
+     * ```typescript
+     * // Get video scaling filter
+     * const scale = Filter.getByName('scale');
+     * if (!scale) {
+     *   throw new Error('Scale filter not available');
+     * }
+     *
+     * // Get audio format filter
+     * const aformat = Filter.getByName('aformat');
+     * ```
+     *
+     * @see {@link getList} To list all available filters
+     */
+    static getByName(name: string): Filter | null;
+    /**
+     * Get list of all available filters.
+     *
+     * Returns an array of all registered filters in FFmpeg.
+     * Useful for discovering available filters or building filter lists.
+     *
+     * @returns Array of all available filters
+     *
+     * @example
+     * ```typescript
+     * // List all filters
+     * const filters = Filter.getList();
+     * console.log(`Total filters: ${filters.length}`);
+     *
+     * // Find all source filters (generators)
+     * const sources = filters.filter(f => f.isSource());
+     * console.log(`Source filters: ${sources.length}`);
+     *
+     * // Find all sink filters (outputs)
+     * const sinks = filters.filter(f => f.isSink());
+     * console.log(`Sink filters: ${sinks.length}`);
+     * ```
+     *
+     * @see {@link getByName} To get a specific filter
+     */
+    static getList(): Filter[];
+    /**
+     * Filter name.
+     *
+     * Unique identifier for the filter (e.g., 'scale', 'overlay').
+     *
+     * Direct mapping to AVFilter->name.
+     */
+    get name(): string | null;
+    /**
+     * Filter description.
+     *
+     * Human-readable description of what the filter does.
+     *
+     * Direct mapping to AVFilter->description.
+     */
+    get description(): string | null;
+    /**
+     * Input pads.
+     *
+     * Array of input pad descriptors.
+     * Empty array for source filters.
+     *
+     * Direct mapping to AVFilter->inputs.
+     */
+    get inputs(): FilterPad[];
+    /**
+     * Output pads.
+     *
+     * Array of output pad descriptors.
+     * Empty array for sink filters.
+     *
+     * Direct mapping to AVFilter->outputs.
+     */
+    get outputs(): FilterPad[];
+    /**
+     * Filter flags.
+     *
+     * Combination of AVFILTER_FLAG_* values indicating filter capabilities.
+     *
+     * Direct mapping to AVFilter->flags.
+     */
+    get flags(): number;
+    /**
+     * Check if filter 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 { AVFILTER_FLAG_DYNAMIC_INPUTS } from 'node-av/constants';
+     *
+     * if (filter.hasFlags(AVFILTER_FLAG_DYNAMIC_INPUTS)) {
+     *   console.log('This filter supports dynamic inputs');
+     * }
+     * ```
+     *
+     * @see {@link flags} For direct flags access
+     */
+    hasFlags(...flags: number[]): boolean;
+    /**
+     * Check if filter is a source.
+     *
+     * Source filters generate frames without input
+     * (e.g., 'testsrc', 'color', 'anullsrc').
+     *
+     * @returns True if filter has no inputs
+     *
+     * @example
+     * ```typescript
+     * const filter = Filter.getByName('testsrc');
+     * if (filter?.isSource()) {
+     *   console.log('This is a source filter');
+     * }
+     * ```
+     *
+     * @see {@link isSink} To check for sink filters
+     */
+    isSource(): boolean;
+    /**
+     * Check if filter is a sink.
+     *
+     * Sink filters consume frames without output
+     * (e.g., 'nullsink', 'buffersink').
+     *
+     * @returns True if filter has no outputs
+     *
+     * @example
+     * ```typescript
+     * const filter = Filter.getByName('nullsink');
+     * if (filter?.isSink()) {
+     *   console.log('This is a sink filter');
+     * }
+     * ```
+     *
+     * @see {@link isSource} To check for source filters
+     */
+    isSink(): boolean;
+    /**
+     * Check if filter processes video.
+     *
+     * @returns True if filter has video inputs or outputs
+     *
+     * @example
+     * ```typescript
+     * const filters = Filter.getList();
+     * const videoFilters = filters.filter(f => f.isVideo());
+     * console.log(`Video filters: ${videoFilters.length}`);
+     * ```
+     *
+     * @see {@link isAudio} To check for audio filters
+     */
+    isVideo(): boolean;
+    /**
+     * Check if filter processes audio.
+     *
+     * @returns True if filter has audio inputs or outputs
+     *
+     * @example
+     * ```typescript
+     * const filters = Filter.getList();
+     * const audioFilters = filters.filter(f => f.isAudio());
+     * console.log(`Audio filters: ${audioFilters.length}`);
+     * ```
+     *
+     * @see {@link isVideo} To check for video filters
+     */
+    isAudio(): boolean;
+    /**
+     * Get the underlying native Filter object.
+     *
+     * @returns The native Filter binding object
+     *
+     * @internal
+     */
+    getNative(): NativeFilter;
+}