node-av 1.3.0 → 2.1.0

package/dist/lib/software-scale-context.d.ts

@@ -76,11 +76,17 @@ export declare class SoftwareScaleContext extends OptionMember<NativeSoftwareSca
      * Direct mapping to sws_getContext().
      *
      * @param srcW - Source width in pixels
+     *
      * @param srcH - Source height in pixels
+     *
      * @param srcFormat - Source pixel format
+     *
      * @param dstW - Destination width in pixels
+     *
      * @param dstH - Destination height in pixels
+     *
      * @param dstFormat - Destination pixel format
+     *
      * @param flags - Scaling algorithm flags (SWS_*)
      *
      * @example
@@ -155,11 +161,17 @@ export declare class SoftwareScaleContext extends OptionMember<NativeSoftwareSca
      * Direct mapping to sws_scale().
      *
      * @param srcSlice - Source data planes (one buffer per plane)
+     *
      * @param srcStride - Bytes per line for each plane
+     *
      * @param srcSliceY - Starting Y position in source
+     *
      * @param srcSliceH - Height of source slice to process
+     *
      * @param dst - Destination data planes
+     *
      * @param dstStride - Destination bytes per line
+     *
      * @returns Output height in pixels, negative AVERROR on error:
      *   - AVERROR_EINVAL: Invalid parameters
      *
@@ -181,6 +193,52 @@ export declare class SoftwareScaleContext extends OptionMember<NativeSoftwareSca
      * @see {@link scaleFrame} For frame-based scaling
      */
     scale(srcSlice: Buffer[], srcStride: number[], srcSliceY: number, srcSliceH: number, dst: Buffer[], dstStride: number[]): Promise<number>;
+    /**
+     * Scale video synchronously.
+     * Synchronous version of scale.
+     *
+     * Scales raw video data from source to destination format.
+     * Can scale a slice or entire image.
+     *
+     * Direct mapping to sws_scale().
+     *
+     * @param srcSlice - Array of source buffers (one per plane)
+     *
+     * @param srcStride - Array of source strides (bytes per row)
+     *
+     * @param srcSliceY - Y position of slice (0 for full image)
+     *
+     * @param srcSliceH - Height of slice (full height for entire image)
+     *
+     * @param dst - Array of destination buffers (one per plane)
+     *
+     * @param dstStride - Array of destination strides
+     *
+     * @returns Height of output image, or negative AVERROR:
+     *   - AVERROR_EINVAL: Invalid parameters
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     *
+     * // Scale YUV420P image
+     * const srcBufs = [yPlane, uPlane, vPlane];
+     * const srcStrides = [srcWidth, srcWidth/2, srcWidth/2];
+     * const dstBufs = [dstY, dstU, dstV];
+     * const dstStrides = [dstWidth, dstWidth/2, dstWidth/2];
+     *
+     * const height = scaler.scaleSync(
+     *   srcBufs, srcStrides,
+     *   0, srcHeight,  // Full image
+     *   dstBufs, dstStrides
+     * );
+     * FFmpegError.throwIfError(height, 'scaleSync');
+     * console.log(`Scaled ${height} lines`);
+     * ```
+     *
+     * @see {@link scale} For async version
+     */
+    scaleSync(srcSlice: Buffer[], srcStride: number[], srcSliceY: number, srcSliceH: number, dst: Buffer[], dstStride: number[]): number;
     /**
      * Scale video frame.
      *
@@ -190,7 +248,9 @@ export declare class SoftwareScaleContext extends OptionMember<NativeSoftwareSca
      * Direct mapping to sws_scale_frame().
      *
      * @param dst - Destination frame (must be allocated)
+     *
      * @param src - Source frame
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Invalid parameters
      *   - AVERROR_ENOMEM: Memory allocation failure
@@ -218,6 +278,44 @@ export declare class SoftwareScaleContext extends OptionMember<NativeSoftwareSca
      * @see {@link scale} For buffer-based scaling
      */
     scaleFrame(dst: Frame, src: Frame): Promise<number>;
+    /**
+     * Scale video frame synchronously.
+     * Synchronous version of scaleFrame.
+     *
+     * Scales an entire video frame to the destination format.
+     * Simpler interface than scaleSync() for frame-based processing.
+     *
+     * Direct mapping to sws_scale_frame().
+     *
+     * @param dst - Destination frame (must be allocated)
+     *
+     * @param src - Source frame
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EINVAL: Invalid parameters
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     * import { AV_PIX_FMT_YUV420P, AV_PIX_FMT_RGB24 } from 'node-av/constants';
+     *
+     * // Convert YUV to RGB
+     * const srcFrame = new Frame();
+     * srcFrame.allocBuffer(AV_PIX_FMT_YUV420P, 1920, 1080);
+     * // ... fill with YUV data ...
+     *
+     * const dstFrame = new Frame();
+     * dstFrame.allocBuffer(AV_PIX_FMT_RGB24, 1920, 1080);
+     *
+     * const ret = scaler.scaleFrameSync(dstFrame, srcFrame);
+     * FFmpegError.throwIfError(ret, 'scaleFrameSync');
+     *
+     * // dstFrame now contains scaled image
+     * ```
+     *
+     * @see {@link scaleFrame} For async version
+     */
+    scaleFrameSync(dst: Frame, src: Frame): number;
     /**
      * Get the underlying native SoftwareScaleContext object.
      *

package/dist/lib/software-scale-context.js

@@ -79,11 +79,17 @@ export class SoftwareScaleContext extends OptionMember {
      * Direct mapping to sws_getContext().
      *
      * @param srcW - Source width in pixels
+     *
      * @param srcH - Source height in pixels
+     *
      * @param srcFormat - Source pixel format
+     *
      * @param dstW - Destination width in pixels
+     *
      * @param dstH - Destination height in pixels
+     *
      * @param dstFormat - Destination pixel format
+     *
      * @param flags - Scaling algorithm flags (SWS_*)
      *
      * @example
@@ -164,11 +170,17 @@ export class SoftwareScaleContext extends OptionMember {
      * Direct mapping to sws_scale().
      *
      * @param srcSlice - Source data planes (one buffer per plane)
+     *
      * @param srcStride - Bytes per line for each plane
+     *
      * @param srcSliceY - Starting Y position in source
+     *
      * @param srcSliceH - Height of source slice to process
+     *
      * @param dst - Destination data planes
+     *
      * @param dstStride - Destination bytes per line
+     *
      * @returns Output height in pixels, negative AVERROR on error:
      *   - AVERROR_EINVAL: Invalid parameters
      *
@@ -192,6 +204,54 @@ export class SoftwareScaleContext extends OptionMember {
     async scale(srcSlice, srcStride, srcSliceY, srcSliceH, dst, dstStride) {
         return await this.native.scale(srcSlice, srcStride, srcSliceY, srcSliceH, dst, dstStride);
     }
+    /**
+     * Scale video synchronously.
+     * Synchronous version of scale.
+     *
+     * Scales raw video data from source to destination format.
+     * Can scale a slice or entire image.
+     *
+     * Direct mapping to sws_scale().
+     *
+     * @param srcSlice - Array of source buffers (one per plane)
+     *
+     * @param srcStride - Array of source strides (bytes per row)
+     *
+     * @param srcSliceY - Y position of slice (0 for full image)
+     *
+     * @param srcSliceH - Height of slice (full height for entire image)
+     *
+     * @param dst - Array of destination buffers (one per plane)
+     *
+     * @param dstStride - Array of destination strides
+     *
+     * @returns Height of output image, or negative AVERROR:
+     *   - AVERROR_EINVAL: Invalid parameters
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     *
+     * // Scale YUV420P image
+     * const srcBufs = [yPlane, uPlane, vPlane];
+     * const srcStrides = [srcWidth, srcWidth/2, srcWidth/2];
+     * const dstBufs = [dstY, dstU, dstV];
+     * const dstStrides = [dstWidth, dstWidth/2, dstWidth/2];
+     *
+     * const height = scaler.scaleSync(
+     *   srcBufs, srcStrides,
+     *   0, srcHeight,  // Full image
+     *   dstBufs, dstStrides
+     * );
+     * FFmpegError.throwIfError(height, 'scaleSync');
+     * console.log(`Scaled ${height} lines`);
+     * ```
+     *
+     * @see {@link scale} For async version
+     */
+    scaleSync(srcSlice, srcStride, srcSliceY, srcSliceH, dst, dstStride) {
+        return this.native.scaleSync(srcSlice, srcStride, srcSliceY, srcSliceH, dst, dstStride);
+    }
     /**
      * Scale video frame.
      *
@@ -201,7 +261,9 @@ export class SoftwareScaleContext extends OptionMember {
      * Direct mapping to sws_scale_frame().
      *
      * @param dst - Destination frame (must be allocated)
+     *
      * @param src - Source frame
+     *
      * @returns 0 on success, negative AVERROR on error:
      *   - AVERROR_EINVAL: Invalid parameters
      *   - AVERROR_ENOMEM: Memory allocation failure
@@ -231,6 +293,46 @@ export class SoftwareScaleContext extends OptionMember {
     async scaleFrame(dst, src) {
         return await this.native.scaleFrame(dst.getNative(), src.getNative());
     }
+    /**
+     * Scale video frame synchronously.
+     * Synchronous version of scaleFrame.
+     *
+     * Scales an entire video frame to the destination format.
+     * Simpler interface than scaleSync() for frame-based processing.
+     *
+     * Direct mapping to sws_scale_frame().
+     *
+     * @param dst - Destination frame (must be allocated)
+     *
+     * @param src - Source frame
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_EINVAL: Invalid parameters
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     * import { AV_PIX_FMT_YUV420P, AV_PIX_FMT_RGB24 } from 'node-av/constants';
+     *
+     * // Convert YUV to RGB
+     * const srcFrame = new Frame();
+     * srcFrame.allocBuffer(AV_PIX_FMT_YUV420P, 1920, 1080);
+     * // ... fill with YUV data ...
+     *
+     * const dstFrame = new Frame();
+     * dstFrame.allocBuffer(AV_PIX_FMT_RGB24, 1920, 1080);
+     *
+     * const ret = scaler.scaleFrameSync(dstFrame, srcFrame);
+     * FFmpegError.throwIfError(ret, 'scaleFrameSync');
+     *
+     * // dstFrame now contains scaled image
+     * ```
+     *
+     * @see {@link scaleFrame} For async version
+     */
+    scaleFrameSync(dst, src) {
+        return this.native.scaleFrameSync(dst.getNative(), src.getNative());
+    }
     /**
      * Get the underlying native SoftwareScaleContext object.
      *

package/dist/lib/software-scale-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"software-scale-context.js","sourceRoot":"","sources":["../../src/lib/software-scale-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAM3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,OAAO,oBAAqB,SAAQ,YAAwC;IAChF;QACE,KAAK,CAAC,IAAI,QAAQ,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,YAAY;QACV,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;IAC7B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IACH,UAAU,CAAC,IAAY,EAAE,IAAY,EAAE,SAAwB,EAAE,IAAY,EAAE,IAAY,EAAE,SAAwB,EAAE,QAAiB,YAAY;QAClJ,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;IACnC,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,WAAW;QACT,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;IAC5B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,KAAK,CAAC,KAAK,CAAC,QAAkB,EAAE,SAAmB,EAAE,SAAiB,EAAE,SAAiB,EAAE,GAAa,EAAE,SAAmB;QAC3H,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;IAC5F,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,KAAK,CAAC,UAAU,CAAC,GAAU,EAAE,GAAU;QACrC,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;IACxE,CAAC;IAED;;;;;;OAMG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,CAAC,MAAM,CAAC,OAAO,CAAC;QACd,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;IAChC,CAAC;CACF"}
+{"version":3,"file":"software-scale-context.js","sourceRoot":"","sources":["../../src/lib/software-scale-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAM3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,OAAO,oBAAqB,SAAQ,YAAwC;IAChF;QACE,KAAK,CAAC,IAAI,QAAQ,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,YAAY;QACV,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;IAC7B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2CG;IACH,UAAU,CAAC,IAAY,EAAE,IAAY,EAAE,SAAwB,EAAE,IAAY,EAAE,IAAY,EAAE,SAAwB,EAAE,QAAiB,YAAY;QAClJ,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;IACnC,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,WAAW;QACT,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;IAC5B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;IACH,KAAK,CAAC,KAAK,CAAC,QAAkB,EAAE,SAAmB,EAAE,SAAiB,EAAE,SAAiB,EAAE,GAAa,EAAE,SAAmB;QAC3H,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;IAC5F,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4CG;IACH,SAAS,CAAC,QAAkB,EAAE,SAAmB,EAAE,SAAiB,EAAE,SAAiB,EAAE,GAAa,EAAE,SAAmB;QACzH,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;IAC1F,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IACH,KAAK,CAAC,UAAU,CAAC,GAAU,EAAE,GAAU;QACrC,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;IACxE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACH,cAAc,CAAC,GAAU,EAAE,GAAU;QACnC,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;IACtE,CAAC;IAED;;;;;;OAMG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,CAAC,MAAM,CAAC,OAAO,CAAC;QACd,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;IAChC,CAAC;CACF"}

package/dist/lib/stream.d.ts

@@ -50,6 +50,7 @@ export declare class Stream implements NativeWrapper<NativeStream> {
     private _codecpar?;
     /**
      * @param native - The native stream instance
+     *
      * @internal
      */
     constructor(native: NativeStream);

package/dist/lib/stream.js

@@ -47,6 +47,7 @@ export class Stream {
     _codecpar; // Cache the wrapped codecpar
     /**
      * @param native - The native stream instance
+     *
      * @internal
      */
     constructor(native) {

package/dist/lib/stream.js.map

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

package/dist/lib/utilities.d.ts

@@ -10,6 +10,7 @@ import type { ChannelLayout, IRational } from './types.js';
  * Direct mapping to av_get_bytes_per_sample().
  *
  * @param sampleFmt - Audio sample format
+ *
  * @returns Number of bytes per sample, or 0 if unknown format
  *
  * @example
@@ -31,6 +32,7 @@ export declare function avGetBytesPerSample(sampleFmt: AVSampleFormat): number;
  * Direct mapping to av_get_sample_fmt_name().
  *
  * @param sampleFmt - Audio sample format
+ *
  * @returns Format name, or null if unknown
  *
  * @example
@@ -53,6 +55,7 @@ export declare function avGetSampleFmtName(sampleFmt: AVSampleFormat): string |
  * Direct mapping to av_get_packed_sample_fmt().
  *
  * @param sampleFmt - Audio sample format
+ *
  * @returns Packed version of the format
  *
  * @example
@@ -76,6 +79,7 @@ export declare function avGetPackedSampleFmt(sampleFmt: AVSampleFormat): AVSampl
  * Direct mapping to av_get_planar_sample_fmt().
  *
  * @param sampleFmt - Audio sample format
+ *
  * @returns Planar version of the format
  *
  * @example
@@ -99,6 +103,7 @@ export declare function avGetPlanarSampleFmt(sampleFmt: AVSampleFormat): AVSampl
  * Direct mapping to av_sample_fmt_is_planar().
  *
  * @param sampleFmt - Audio sample format to check
+ *
  * @returns True if planar, false if packed/interleaved
  *
  * @example
@@ -120,6 +125,7 @@ export declare function avSampleFmtIsPlanar(sampleFmt: AVSampleFormat): boolean;
  * Direct mapping to avcodec_get_name().
  *
  * @param codecId - Codec ID from AVCodecID enum
+ *
  * @returns Codec name string or null
  *
  * @example
@@ -143,6 +149,7 @@ export declare function avGetCodecName(codecId: AVCodecID): string | null;
  * Direct mapping to av_get_pix_fmt_name().
  *
  * @param pixFmt - Pixel format
+ *
  * @returns Format name, or null if unknown
  *
  * @example
@@ -164,6 +171,7 @@ export declare function avGetPixFmtName(pixFmt: AVPixelFormat): string | null;
  * Direct mapping to av_get_pix_fmt().
  *
  * @param name - Pixel format name
+ *
  * @returns Pixel format enum, or AV_PIX_FMT_NONE if unknown
  *
  * @example
@@ -185,6 +193,7 @@ export declare function avGetPixFmtFromName(name: string): AVPixelFormat;
  * Direct mapping to av_pix_fmt_desc_get() with hwaccel check.
  *
  * @param pixFmt - Pixel format to check
+ *
  * @returns True if hardware format, false if software format
  *
  * @example
@@ -206,6 +215,7 @@ export declare function avIsHardwarePixelFormat(pixFmt: AVPixelFormat): boolean;
  * Direct mapping to av_get_media_type_string().
  *
  * @param mediaType - Media type enum
+ *
  * @returns Media type name, or null if unknown
  *
  * @example
@@ -228,9 +238,13 @@ export declare function avGetMediaTypeString(mediaType: AVMediaType): string | n
  * Direct mapping to av_image_alloc().
  *
  * @param width - Image width in pixels
+ *
  * @param height - Image height in pixels
+ *
  * @param pixFmt - Pixel format
+ *
  * @param align - Buffer alignment (typically 1 or 32)
+ *
  * @returns Object with buffer, size, and line sizes
  *
  * @throws {FFmpegError} If allocation fails
@@ -262,11 +276,17 @@ export declare function avImageAlloc(width: number, height: number, pixFmt: AVPi
  * Direct mapping to av_image_copy2().
  *
  * @param dstData - Destination data planes
+ *
  * @param dstLinesizes - Destination bytes per line
+ *
  * @param srcData - Source data planes
+ *
  * @param srcLinesizes - Source bytes per line
+ *
  * @param pixFmt - Pixel format
+ *
  * @param width - Image width
+ *
  * @param height - Image height
  *
  * @example
@@ -289,9 +309,13 @@ export declare function avImageCopy2(dstData: Buffer[], dstLinesizes: number[],
  * Direct mapping to av_image_get_buffer_size().
  *
  * @param pixFmt - Pixel format
+ *
  * @param width - Image width
+ *
  * @param height - Image height
+ *
  * @param align - Buffer alignment
+ *
  * @returns Required buffer size in bytes
  *
  * @example
@@ -314,13 +338,21 @@ export declare function avImageGetBufferSize(pixFmt: AVPixelFormat, width: numbe
  * Direct mapping to av_image_copy_to_buffer().
  *
  * @param dst - Destination buffer
+ *
  * @param dstSize - Destination buffer size
+ *
  * @param srcData - Source data planes
+ *
  * @param srcLinesize - Source bytes per line
+ *
  * @param pixFmt - Pixel format
+ *
  * @param width - Image width
+ *
  * @param height - Image height
+ *
  * @param align - Buffer alignment
+ *
  * @returns Bytes written, or negative AVERROR
  *
  * @example
@@ -344,6 +376,7 @@ export declare function avImageCopyToBuffer(dst: Buffer, dstSize: number, srcDat
  * Direct mapping to av_ts2str().
  *
  * @param ts - Timestamp value
+ *
  * @returns String representation
  *
  * @example
@@ -363,7 +396,9 @@ export declare function avTs2Str(ts: bigint | number | null): string;
  * Direct mapping to av_ts2timestr().
  *
  * @param ts - Timestamp value
+ *
  * @param timeBase - Time base for conversion
+ *
  * @returns Time string representation
  *
  * @example
@@ -381,9 +416,13 @@ export declare function avTs2TimeStr(ts: bigint | number | null, timeBase: IRati
  * Allocates image data as separate plane arrays.
  *
  * @param width - Image width
+ *
  * @param height - Image height
+ *
  * @param pixFmt - Pixel format
+ *
  * @param align - Buffer alignment
+ *
  * @returns Object with data planes, line sizes, and total size
  *
  * @example
@@ -407,9 +446,13 @@ export declare function avImageAllocArrays(width: number, height: number, pixFmt
  * Direct mapping to av_compare_ts().
  *
  * @param tsA - First timestamp
+ *
  * @param tbA - First time base
+ *
  * @param tsB - Second timestamp
+ *
  * @param tbB - Second time base
+ *
  * @returns -1 if A < B, 0 if A == B, 1 if A > B
  *
  * @example
@@ -432,8 +475,11 @@ export declare function avCompareTs(tsA: bigint | number | null, tbA: IRational,
  * Direct mapping to av_rescale_q().
  *
  * @param a - Timestamp to rescale
+ *
  * @param bq - Source time base
+ *
  * @param cq - Destination time base
+ *
  * @returns Rescaled timestamp
  *
  * @example
@@ -476,9 +522,13 @@ export declare function avUsleep(usec: number): void;
  * Direct mapping to av_rescale_rnd().
  *
  * @param a - Value to rescale
+ *
  * @param b - Multiplier
+ *
  * @param c - Divisor
+ *
  * @param rnd - Rounding mode (AV_ROUND_*)
+ *
  * @returns Rescaled value
  *
  * @example
@@ -500,9 +550,13 @@ export declare function avRescaleRnd(a: bigint | number, b: bigint | number, c:
  * Direct mapping to av_samples_alloc().
  *
  * @param nbChannels - Number of audio channels
+ *
  * @param nbSamples - Number of samples per channel
+ *
  * @param sampleFmt - Sample format
+ *
  * @param align - Buffer alignment
+ *
  * @returns Object with data buffers, line size, and total size
  *
  * @throws {FFmpegError} If allocation fails
@@ -533,9 +587,13 @@ export declare function avSamplesAlloc(nbChannels: number, nbSamples: number, sa
  * Direct mapping to av_samples_get_buffer_size().
  *
  * @param nbChannels - Number of channels
+ *
  * @param nbSamples - Number of samples per channel
+ *
  * @param sampleFmt - Sample format
+ *
  * @param align - Buffer alignment
+ *
  * @returns Object with size and line size
  *
  * @throws {FFmpegError} If parameters are invalid
@@ -565,6 +623,7 @@ export declare function avSamplesGetBufferSize(nbChannels: number, nbSamples: nu
  * Direct mapping to av_channel_layout_describe().
  *
  * @param channelLayout - Channel layout to describe
+ *
  * @returns Layout description string, or null
  *
  * @example
@@ -585,6 +644,7 @@ export declare function avChannelLayoutDescribe(channelLayout: Partial<ChannelLa
  * Direct mapping to av_sdp_create().
  *
  * @param contexts - Array of format contexts
+ *
  * @returns SDP string, or null on error
  *
  * @example