node-av 2.0.0 → 2.1.0

package/dist/lib/native-types.d.ts

@@ -89,6 +89,7 @@ export interface NativeFrame extends Disposable {
     copy(src: NativeFrame): number;
     fromBuffer(buffer: Buffer): number;
     hwframeTransferData(dst: NativeFrame, flags?: number): Promise<number>;
+    hwframeTransferDataSync(dst: NativeFrame, flags?: number): number;
     isHwFrame(): boolean;
     isSwFrame(): boolean;
     getSideData(type: AVFrameSideDataType): Buffer | null;
@@ -187,9 +188,13 @@ export interface NativeCodecContext extends Disposable {
     parametersFromContext(params: NativeCodecParameters): number;
     flushBuffers(): void;
     sendPacket(packet: NativePacket | null): Promise<number>;
+    sendPacketSync(packet: NativePacket | null): number;
     receiveFrame(frame: NativeFrame): Promise<number>;
+    receiveFrameSync(frame: NativeFrame): number;
     sendFrame(frame: NativeFrame | null): Promise<number>;
+    sendFrameSync(frame: NativeFrame | null): number;
     receivePacket(packet: NativePacket): Promise<number>;
+    receivePacketSync(packet: NativePacket): number;
     setHardwarePixelFormat(hwFormat: AVPixelFormat, swFormat?: AVPixelFormat): void;
     [Symbol.dispose](): void;
 }
@@ -282,13 +287,21 @@ export interface NativeIOContext extends AsyncDisposable {
     allocContextWithCallbacks(bufferSize: number, writeFlag: 0 | 1, readCallback?: (size: number) => Buffer | null | number, writeCallback?: (buffer: Buffer) => number | void, seekCallback?: (offset: bigint, whence: AVSeekWhence) => bigint | number): void;
     freeContext(): void;
     open2(url: string, flags: AVIOFlag): Promise<number>;
+    open2Sync(url: string, flags: AVIOFlag): number;
     closep(): Promise<number>;
+    closepSync(): number;
     read(size: number): Promise<Buffer | number>;
+    readSync(size: number): Buffer | number;
     write(buffer: Buffer): Promise<void>;
+    writeSync(buffer: Buffer): void;
     seek(offset: bigint, whence: AVSeekWhence): Promise<bigint>;
+    seekSync(offset: bigint, whence: AVSeekWhence): bigint;
     size(): Promise<bigint>;
+    sizeSync(): bigint;
     flush(): Promise<void>;
+    flushSync(): void;
     skip(offset: bigint): Promise<bigint>;
+    skipSync(offset: bigint): bigint;
     tell(): bigint;
     readonly eof: boolean;
     readonly error: number;
@@ -394,18 +407,30 @@ export interface NativeFormatContext extends AsyncDisposable {
     allocOutputContext2(oformat: NativeOutputFormat | null, formatName: string | null, filename: string | null): number;
     freeContext(): void;
     openInput(url: string, fmt: NativeInputFormat | null, options: NativeDictionary | null): Promise<number>;
+    openInputSync(url: string, fmt: NativeInputFormat | null, options: NativeDictionary | null): number;
     closeInput(): Promise<void>;
+    closeInputSync(): void;
     findStreamInfo(options: NativeDictionary[] | null): Promise<number>;
+    findStreamInfoSync(options: NativeDictionary | null): number;
     readFrame(pkt: NativePacket): Promise<number>;
+    readFrameSync(pkt: NativePacket): number;
     seekFrame(streamIndex: number, timestamp: bigint, flags: AVSeekFlag): Promise<number>;
+    seekFrameSync(streamIndex: number, timestamp: bigint, flags: AVSeekFlag): number;
     seekFile(streamIndex: number, minTs: bigint, ts: bigint, maxTs: bigint, flags: AVSeekFlag): Promise<number>;
     openOutput(): Promise<number>;
+    openOutputSync(): number;
     closeOutput(): Promise<void>;
+    closeOutputSync(): void;
     writeHeader(options: NativeDictionary | null): Promise<number>;
+    writeHeaderSync(options: NativeDictionary | null): number;
     writeFrame(pkt: NativePacket | null): Promise<number>;
+    writeFrameSync(pkt: NativePacket | null): number;
     interleavedWriteFrame(pkt: NativePacket | null): Promise<number>;
+    interleavedWriteFrameSync(pkt: NativePacket | null): number;
     writeTrailer(): Promise<number>;
-    flush(): void;
+    writeTrailerSync(): number;
+    flush(): Promise<void>;
+    flushSync(): void;
     newStream(c: NativeCodec | null): NativeStream;
     dumpFormat(index: number, url: string, isOutput: boolean): void;
     findBestStream(type: AVMediaType, wantedStreamNb: number, relatedStream: number, wantDecoder: boolean, flags: number): number | {
@@ -442,8 +467,11 @@ export interface NativeAudioFifo extends Disposable {
     alloc(sampleFmt: AVSampleFormat, channels: number, nbSamples: number): void;
     free(): void;
     write(data: Buffer | Buffer[], nbSamples: number): Promise<number>;
+    writeSync(data: Buffer | Buffer[], nbSamples: number): number;
     read(data: Buffer | Buffer[], nbSamples: number): Promise<number>;
+    readSync(data: Buffer | Buffer[], nbSamples: number): number;
     peek(data: Buffer | Buffer[], nbSamples: number): Promise<number>;
+    peekSync(data: Buffer | Buffer[], nbSamples: number): number;
     drain(nbSamples: number): void;
     reset(): void;
     realloc(nbSamples: number): number;
@@ -463,7 +491,9 @@ export interface NativeSoftwareScaleContext extends Disposable {
     initContext(): number;
     freeContext(): void;
     scale(srcSlice: Buffer[], srcStride: number[], srcSliceY: number, srcSliceH: number, dst: Buffer[], dstStride: number[]): Promise<number>;
+    scaleSync(srcSlice: Buffer[], srcStride: number[], srcSliceY: number, srcSliceH: number, dst: Buffer[], dstStride: number[]): number;
     scaleFrame(dst: NativeFrame, src: NativeFrame): Promise<number>;
+    scaleFrameSync(dst: NativeFrame, src: NativeFrame): number;
     [Symbol.dispose](): void;
 }
 /**
@@ -482,6 +512,7 @@ export interface NativeSoftwareResampleContext extends Disposable {
     free(): void;
     close(): void;
     convert(outBuffer: Buffer[] | null, outCount: number, inBuffer: Buffer[] | null, inCount: number): Promise<number>;
+    convertSync(outBuffer: Buffer[] | null, outCount: number, inBuffer: Buffer[] | null, inCount: number): number;
     convertFrame(outFrame: NativeFrame | null, inFrame: NativeFrame | null): number;
     configFrame(outFrame: NativeFrame | null, inFrame: NativeFrame | null): number;
     isInitialized(): boolean;
@@ -533,6 +564,7 @@ export interface NativeFilterContext extends Disposable {
     link(srcPad: number, dst: NativeFilterContext, dstPad: number): number;
     unlink(pad: number): void;
     buffersrcAddFrame(frame: NativeFrame | null): Promise<number>;
+    buffersrcAddFrameSync(frame: NativeFrame | null): number;
     buffersrcParametersSet(params: {
         width?: number;
         height?: number;
@@ -545,6 +577,7 @@ export interface NativeFilterContext extends Disposable {
         channelLayout?: bigint;
     }): number;
     buffersinkGetFrame(frame: NativeFrame): Promise<number>;
+    buffersinkGetFrameSync(frame: NativeFrame): number;
     buffersinkGetWidth(): number;
     buffersinkGetHeight(): number;
     buffersinkGetFormat(): AVPixelFormat | AVSampleFormat;
@@ -577,11 +610,13 @@ export interface NativeFilterGraph extends Disposable {
     allocFilter(filter: NativeFilter, name: string): NativeFilterContext | null;
     getFilter(name: string): NativeFilterContext | null;
     config(): Promise<number>;
+    configSync(): number;
     parse(filters: string, inputs: NativeFilterInOut | null, outputs: NativeFilterInOut | null): number;
     parse2(filters: string): number;
     parsePtr(filters: string, inputs?: NativeFilterInOut | null, outputs?: NativeFilterInOut | null): number;
     validate(): number;
     requestOldest(): Promise<number>;
+    requestOldestSync(): number;
     dump(): string | null;
     sendCommand(target: string, cmd: string, arg: string, flags?: AVFilterCmdFlag): number | {
         response: string | null;
@@ -655,6 +690,7 @@ export interface NativeHardwareFramesContext extends Disposable {
     init(): number;
     getBuffer(frame: NativeFrame, flags?: number): number;
     transferData(dst: NativeFrame, src: NativeFrame, flags?: number): Promise<number>;
+    transferDataSync(dst: NativeFrame, src: NativeFrame, flags?: number): number;
     transferGetFormats(direction: AVHWFrameTransferDirection): AVPixelFormat[] | number;
     map(dst: NativeFrame, src: NativeFrame, flags?: number): number;
     createDerived(format: AVPixelFormat, derivedDevice: NativeHardwareDeviceContext, source: NativeHardwareFramesContext, flags?: number): number;
@@ -696,7 +732,9 @@ export interface NativeBitStreamFilterContext extends Disposable {
     free(): void;
     flush(): void;
     sendPacket(packet: NativePacket | null): Promise<number>;
+    sendPacketSync(packet: NativePacket | null): number;
     receivePacket(packet: NativePacket): Promise<number>;
+    receivePacketSync(packet: NativePacket): number;
     isInitialized(): boolean;
     [Symbol.dispose](): void;
 }

package/dist/lib/option.d.ts

@@ -33,6 +33,7 @@ export declare class OptionInfo {
     private native;
     /**
      * @param native - The native option instance
+     *
      * @internal
      */
     constructor(native: NativeOption);
@@ -159,7 +160,9 @@ export declare class Option {
      * Direct mapping to av_opt_next().
      *
      * @param obj - Object with options
+     *
      * @param prev - Previous option (null to get first)
+     *
      * @returns Next option, or null if no more
      *
      * @example
@@ -179,8 +182,11 @@ export declare class Option {
      * Direct mapping to av_opt_find().
      *
      * @param obj - Object to search
+     *
      * @param name - Option name
+     *
      * @param searchFlags - Search flags
+     *
      * @returns Option info if found, null otherwise
      *
      * @example
@@ -200,8 +206,11 @@ export declare class Option {
      * Direct mapping to av_opt_find2().
      *
      * @param obj - Object to search
+     *
      * @param name - Option name
+     *
      * @param searchFlags - Search flags
+     *
      * @returns Object with option and target info
      *
      * @example
@@ -222,8 +231,11 @@ export declare class Option {
      * Direct mapping to av_opt_get().
      *
      * @param obj - Object to query
+     *
      * @param name - Option name
+     *
      * @param searchFlags - Search flags
+     *
      * @returns Option value as string, or null
      *
      * @example
@@ -240,8 +252,11 @@ export declare class Option {
      * Direct mapping to av_opt_get_int().
      *
      * @param obj - Object to query
+     *
      * @param name - Option name
+     *
      * @param searchFlags - Search flags
+     *
      * @returns Option value as integer, or null
      *
      * @example
@@ -258,8 +273,11 @@ export declare class Option {
      * Direct mapping to av_opt_get_double().
      *
      * @param obj - Object to query
+     *
      * @param name - Option name
+     *
      * @param searchFlags - Search flags
+     *
      * @returns Option value as double, or null
      *
      * @example
@@ -276,8 +294,11 @@ export declare class Option {
      * Direct mapping to av_opt_get_q().
      *
      * @param obj - Object to query
+     *
      * @param name - Option name
+     *
      * @param searchFlags - Search flags
+     *
      * @returns Option value as rational, or null
      *
      * @example
@@ -294,8 +315,11 @@ export declare class Option {
      * Direct mapping to av_opt_get_pixel_fmt().
      *
      * @param obj - Object to query
+     *
      * @param name - Option name
+     *
      * @param searchFlags - Search flags
+     *
      * @returns Pixel format value, or null
      *
      * @example
@@ -312,8 +336,11 @@ export declare class Option {
      * Direct mapping to av_opt_get_sample_fmt().
      *
      * @param obj - Object to query
+     *
      * @param name - Option name
+     *
      * @param searchFlags - Search flags
+     *
      * @returns Sample format value, or null
      *
      * @example
@@ -330,8 +357,11 @@ export declare class Option {
      * Direct mapping to av_opt_get_image_size().
      *
      * @param obj - Object to query
+     *
      * @param name - Option name
+     *
      * @param searchFlags - Search flags
+     *
      * @returns Width and height, or null
      *
      * @example
@@ -351,8 +381,11 @@ export declare class Option {
      * Direct mapping to av_opt_get_chlayout().
      *
      * @param obj - Object to query
+     *
      * @param name - Option name
+     *
      * @param searchFlags - Search flags
+     *
      * @returns Channel layout, or null
      *
      * @example
@@ -369,8 +402,11 @@ export declare class Option {
      * Direct mapping to av_opt_get_dict_val().
      *
      * @param obj - Object to query
+     *
      * @param name - Option name
+     *
      * @param searchFlags - Search flags
+     *
      * @returns Dictionary value, or null
      *
      * @example
@@ -387,9 +423,13 @@ export declare class Option {
      * Direct mapping to av_opt_set().
      *
      * @param obj - Object to modify
+     *
      * @param name - Option name
+     *
      * @param value - String value
+     *
      * @param searchFlags - Search flags
+     *
      * @returns 0 on success, negative AVERROR on error
      *
      * @example
@@ -406,9 +446,13 @@ export declare class Option {
      * Direct mapping to av_opt_set_int().
      *
      * @param obj - Object to modify
+     *
      * @param name - Option name
+     *
      * @param value - Integer value
+     *
      * @param searchFlags - Search flags
+     *
      * @returns 0 on success, negative AVERROR on error
      *
      * @example
@@ -425,9 +469,13 @@ export declare class Option {
      * Direct mapping to av_opt_set_double().
      *
      * @param obj - Object to modify
+     *
      * @param name - Option name
+     *
      * @param value - Double value
+     *
      * @param searchFlags - Search flags
+     *
      * @returns 0 on success, negative AVERROR on error
      *
      * @example
@@ -444,9 +492,13 @@ export declare class Option {
      * Direct mapping to av_opt_set_q().
      *
      * @param obj - Object to modify
+     *
      * @param name - Option name
+     *
      * @param value - Rational value
+     *
      * @param searchFlags - Search flags
+     *
      * @returns 0 on success, negative AVERROR on error
      *
      * @example
@@ -463,9 +515,13 @@ export declare class Option {
      * Direct mapping to av_opt_set_pixel_fmt().
      *
      * @param obj - Object to modify
+     *
      * @param name - Option name
+     *
      * @param value - Pixel format
+     *
      * @param searchFlags - Search flags
+     *
      * @returns 0 on success, negative AVERROR on error
      *
      * @example
@@ -482,9 +538,13 @@ export declare class Option {
      * Direct mapping to av_opt_set_sample_fmt().
      *
      * @param obj - Object to modify
+     *
      * @param name - Option name
+     *
      * @param value - Sample format
+     *
      * @param searchFlags - Search flags
+     *
      * @returns 0 on success, negative AVERROR on error
      *
      * @example
@@ -501,10 +561,15 @@ export declare class Option {
      * Direct mapping to av_opt_set_image_size().
      *
      * @param obj - Object to modify
+     *
      * @param name - Option name
+     *
      * @param width - Image width
+     *
      * @param height - Image height
+     *
      * @param searchFlags - Search flags
+     *
      * @returns 0 on success, negative AVERROR on error
      *
      * @example
@@ -521,9 +586,13 @@ export declare class Option {
      * Direct mapping to av_opt_set_chlayout().
      *
      * @param obj - Object to modify
+     *
      * @param name - Option name
+     *
      * @param value - Channel layout
+     *
      * @param searchFlags - Search flags
+     *
      * @returns 0 on success, negative AVERROR on error
      *
      * @example
@@ -540,9 +609,13 @@ export declare class Option {
      * Direct mapping to av_opt_set_dict_val().
      *
      * @param obj - Object to modify
+     *
      * @param name - Option name
+     *
      * @param value - Dictionary value
+     *
      * @param searchFlags - Search flags
+     *
      * @returns 0 on success, negative AVERROR on error
      *
      * @example
@@ -561,9 +634,13 @@ export declare class Option {
      * Direct mapping to av_opt_set_bin().
      *
      * @param obj - Object to modify
+     *
      * @param name - Option name
+     *
      * @param value - Binary data
+     *
      * @param searchFlags - Search flags
+     *
      * @returns 0 on success, negative AVERROR on error
      *
      * @example
@@ -599,7 +676,9 @@ export declare class Option {
      * Direct mapping to av_opt_copy().
      *
      * @param dest - Destination object
+     *
      * @param src - Source object
+     *
      * @returns 0 on success, negative AVERROR on error
      *
      * @example
@@ -616,8 +695,11 @@ export declare class Option {
      * Direct mapping to av_opt_is_set_to_default().
      *
      * @param obj - Object to check
+     *
      * @param name - Option name
+     *
      * @param searchFlags - Search flags
+     *
      * @returns True if default, false if modified, null if not found
      *
      * @example
@@ -634,10 +716,15 @@ export declare class Option {
      * Direct mapping to av_opt_serialize().
      *
      * @param obj - Object to serialize
+     *
      * @param optFlags - Option flags filter
+     *
      * @param flags - Serialization flags
+     *
      * @param keyValSep - Key-value separator
+     *
      * @param pairsSep - Pairs separator
+     *
      * @returns Serialized string, or null on error
      *
      * @example
@@ -668,8 +755,11 @@ export declare class Option {
      * Direct mapping to av_opt_show2().
      *
      * @param obj - Object to show options for
+     *
      * @param reqFlags - Required flags
+     *
      * @param rejFlags - Rejected flags
+     *
      * @returns 0 on success, negative AVERROR on error
      *
      * @example