node-av 0.0.1

package/dist/api/utilities/audio-sample.js

@@ -0,0 +1,110 @@
+/**
+ * Audio Sample Utilities
+ *
+ * Provides utilities for working with audio sample buffers in FFmpeg.
+ * All methods are static and map directly to FFmpeg's libavutil functions.
+ *
+ * @module lib/audio-sample-utils
+ */
+import { bindings } from '../../lib/binding.js';
+import { FFmpegError } from '../../lib/error.js';
+/**
+ * Audio sample buffer utilities.
+ *
+ * Provides static methods for allocating and managing audio sample buffers.
+ * These utilities handle the memory layout for various sample formats,
+ * including planar formats where each channel has its own buffer.
+ *
+ * @example
+ * ```typescript
+ * import { AudioSampleUtils } from 'node-av';
+ * import { AV_SAMPLE_FMT_FLTP, AV_SAMPLE_FMT_S16 } from 'node-av/constants';
+ *
+ * // Allocate audio buffers for stereo float planar
+ * const audio = AudioSampleUtils.alloc(2, 1024, AV_SAMPLE_FMT_FLTP, 0);
+ * console.log(`Allocated ${audio.size} bytes`);
+ * console.log(`${audio.data.length} buffers (one per channel)`);
+ *
+ * // Get buffer size for packed format
+ * const size = AudioSampleUtils.getBufferSize(2, 1024, AV_SAMPLE_FMT_S16, 0);
+ * console.log(`S16 stereo needs ${size.size} bytes`);
+ * ```
+ */
+export class AudioSampleUtils {
+    // Private constructor to prevent instantiation
+    constructor() { }
+    /**
+     * Allocate audio sample buffers.
+     *
+     * Allocates buffers for audio samples. For planar formats, allocates
+     * separate buffers for each channel. For packed formats, allocates
+     * a single interleaved buffer.
+     * Direct mapping to av_samples_alloc()
+     *
+     * @param nbChannels - Number of audio channels
+     * @param nbSamples - Number of samples per channel
+     * @param sampleFmt - Audio sample format
+     * @param align - Buffer alignment (0 for default)
+     * @returns Allocation result with buffers and size information
+     * @throws {FFmpegError} On allocation failure
+     *
+     * @example
+     * ```typescript
+     * import { AudioSampleUtils } from 'node-av';
+     * import { AV_SAMPLE_FMT_FLTP, AV_SAMPLE_FMT_S16 } from 'node-av/constants';
+     *
+     * // Allocate for planar format (separate buffer per channel)
+     * const planar = AudioSampleUtils.alloc(2, 1024, AV_SAMPLE_FMT_FLTP, 0);
+     * console.log(`Planar: ${planar.data.length} buffers`); // 2 buffers
+     *
+     * // Allocate for packed format (single interleaved buffer)
+     * const packed = AudioSampleUtils.alloc(2, 1024, AV_SAMPLE_FMT_S16, 0);
+     * console.log(`Packed: ${packed.data.length} buffer`);  // 1 buffer
+     * ```
+     */
+    static alloc(nbChannels, nbSamples, sampleFmt, align) {
+        const result = bindings.avSamplesAlloc(nbChannels, nbSamples, sampleFmt, align);
+        if (typeof result === 'number') {
+            FFmpegError.throwIfError(result, 'Failed to allocate audio samples');
+        }
+        return result;
+    }
+    /**
+     * Get required buffer size for audio samples.
+     *
+     * Calculates the buffer size needed to store audio samples with the
+     * given parameters. Does not allocate any memory.
+     * Direct mapping to av_samples_get_buffer_size()
+     *
+     * @param nbChannels - Number of audio channels
+     * @param nbSamples - Number of samples per channel
+     * @param sampleFmt - Audio sample format
+     * @param align - Buffer alignment (0 for default)
+     * @returns Buffer size and line size information
+     * @throws {FFmpegError} On invalid parameters
+     *
+     * @example
+     * ```typescript
+     * import { AudioSampleUtils } from 'node-av';
+     * import { AV_SAMPLE_FMT_FLT, AV_SAMPLE_FMT_S16P } from 'node-av/constants';
+     *
+     * // Calculate size for packed float (32-bit) stereo
+     * const floatSize = AudioSampleUtils.getBufferSize(2, 1024, AV_SAMPLE_FMT_FLT, 0);
+     * console.log(`Float stereo: ${floatSize.size} bytes total`);
+     * console.log(`Line size: ${floatSize.linesize} bytes`);
+     *
+     * // Calculate size for planar 16-bit stereo
+     * const planarSize = AudioSampleUtils.getBufferSize(2, 1024, AV_SAMPLE_FMT_S16P, 0);
+     * console.log(`S16 planar: ${planarSize.size} bytes total`);
+     * console.log(`Per channel: ${planarSize.linesize} bytes`);
+     * ```
+     */
+    static getBufferSize(nbChannels, nbSamples, sampleFmt, align) {
+        const result = bindings.avSamplesGetBufferSize(nbChannels, nbSamples, sampleFmt, align);
+        if (typeof result === 'number') {
+            FFmpegError.throwIfError(result, 'Failed to get audio buffer size');
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=audio-sample.js.map

package/dist/api/utilities/audio-sample.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-sample.js","sourceRoot":"","sources":["../../../src/api/utilities/audio-sample.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA0BjD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,gBAAgB;IAC3B,+CAA+C;IAC/C,gBAAuB,CAAC;IAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,MAAM,CAAC,KAAK,CAAC,UAAkB,EAAE,SAAiB,EAAE,SAAyB,EAAE,KAAa;QAC1F,MAAM,MAAM,GAAG,QAAQ,CAAC,cAAc,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QAChF,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,WAAW,CAAC,YAAY,CAAC,MAAM,EAAE,kCAAkC,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,MAA+B,CAAC;IACzC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,MAAM,CAAC,aAAa,CAAC,UAAkB,EAAE,SAAiB,EAAE,SAAyB,EAAE,KAAa;QAClG,MAAM,MAAM,GAAG,QAAQ,CAAC,sBAAsB,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QACxF,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,WAAW,CAAC,YAAY,CAAC,MAAM,EAAE,iCAAiC,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,MAA+B,CAAC;IACzC,CAAC;CACF"}

package/dist/api/utilities/channel-layout.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Channel Layout Utilities
+ *
+ * Provides utilities for working with audio channel layouts in FFmpeg.
+ * All methods are static and map directly to FFmpeg's libavutil functions.
+ *
+ * @module lib/channel-layout-utils
+ */
+import type { ChannelLayout } from '../../lib/types.js';
+/**
+ * Audio channel layout utilities.
+ *
+ * Provides static methods for describing and working with audio channel layouts.
+ * Channel layouts define the arrangement and meaning of audio channels in
+ * multi-channel audio.
+ *
+ * @example
+ * ```typescript
+ * import { ChannelLayoutUtils } from 'node-av';
+ * import { AV_CHANNEL_ORDER_NATIVE } from 'node-av/constants';
+ *
+ * // Describe a stereo layout
+ * const stereo: ChannelLayout = {
+ *   order: AV_CHANNEL_ORDER_NATIVE,
+ *   nb_channels: 2,
+ *   u: { mask: 0x3n } // FL | FR
+ * };
+ *
+ * const description = ChannelLayoutUtils.describe(stereo);
+ * console.log(description); // "stereo"
+ *
+ * // Describe a 5.1 layout
+ * const surround: ChannelLayout = {
+ *   order: AV_CHANNEL_ORDER_NATIVE,
+ *   nb_channels: 6,
+ *   u: { mask: 0x3Fn } // FL | FR | FC | LFE | BL | BR
+ * };
+ *
+ * console.log(ChannelLayoutUtils.describe(surround)); // "5.1"
+ * ```
+ */
+export declare class ChannelLayoutUtils {
+    private constructor();
+    /**
+     * Get string description of channel layout.
+     *
+     * Returns a human-readable string describing the channel layout.
+     * Direct mapping to av_channel_layout_describe()
+     *
+     * @param channelLayout - Channel layout to describe
+     * @returns String description, or null on error
+     *
+     * @example
+     * ```typescript
+     * import { ChannelLayoutUtils } from 'node-av';
+     * import { AV_CHANNEL_ORDER_NATIVE, AV_CHANNEL_ORDER_CUSTOM } from 'node-av/constants';
+     *
+     * // Standard layouts
+     * const mono: ChannelLayout = {
+     *   order: AV_CHANNEL_ORDER_NATIVE,
+     *   nb_channels: 1,
+     *   u: { mask: 0x4n } // FC
+     * };
+     * console.log(ChannelLayoutUtils.describe(mono)); // "mono"
+     *
+     * const stereo: ChannelLayout = {
+     *   order: AV_CHANNEL_ORDER_NATIVE,
+     *   nb_channels: 2,
+     *   u: { mask: 0x3n } // FL | FR
+     * };
+     * console.log(ChannelLayoutUtils.describe(stereo)); // "stereo"
+     *
+     * // Custom layout
+     * const custom: ChannelLayout = {
+     *   order: AV_CHANNEL_ORDER_CUSTOM,
+     *   nb_channels: 3,
+     *   u: { map: null }
+     * };
+     * console.log(ChannelLayoutUtils.describe(custom)); // "3 channels"
+     * ```
+     */
+    static describe(channelLayout: Partial<ChannelLayout>): string | null;
+}

package/dist/api/utilities/channel-layout.js

@@ -0,0 +1,87 @@
+/**
+ * Channel Layout Utilities
+ *
+ * Provides utilities for working with audio channel layouts in FFmpeg.
+ * All methods are static and map directly to FFmpeg's libavutil functions.
+ *
+ * @module lib/channel-layout-utils
+ */
+import { bindings } from '../../lib/binding.js';
+/**
+ * Audio channel layout utilities.
+ *
+ * Provides static methods for describing and working with audio channel layouts.
+ * Channel layouts define the arrangement and meaning of audio channels in
+ * multi-channel audio.
+ *
+ * @example
+ * ```typescript
+ * import { ChannelLayoutUtils } from 'node-av';
+ * import { AV_CHANNEL_ORDER_NATIVE } from 'node-av/constants';
+ *
+ * // Describe a stereo layout
+ * const stereo: ChannelLayout = {
+ *   order: AV_CHANNEL_ORDER_NATIVE,
+ *   nb_channels: 2,
+ *   u: { mask: 0x3n } // FL | FR
+ * };
+ *
+ * const description = ChannelLayoutUtils.describe(stereo);
+ * console.log(description); // "stereo"
+ *
+ * // Describe a 5.1 layout
+ * const surround: ChannelLayout = {
+ *   order: AV_CHANNEL_ORDER_NATIVE,
+ *   nb_channels: 6,
+ *   u: { mask: 0x3Fn } // FL | FR | FC | LFE | BL | BR
+ * };
+ *
+ * console.log(ChannelLayoutUtils.describe(surround)); // "5.1"
+ * ```
+ */
+export class ChannelLayoutUtils {
+    // Private constructor to prevent instantiation
+    constructor() { }
+    /**
+     * Get string description of channel layout.
+     *
+     * Returns a human-readable string describing the channel layout.
+     * Direct mapping to av_channel_layout_describe()
+     *
+     * @param channelLayout - Channel layout to describe
+     * @returns String description, or null on error
+     *
+     * @example
+     * ```typescript
+     * import { ChannelLayoutUtils } from 'node-av';
+     * import { AV_CHANNEL_ORDER_NATIVE, AV_CHANNEL_ORDER_CUSTOM } from 'node-av/constants';
+     *
+     * // Standard layouts
+     * const mono: ChannelLayout = {
+     *   order: AV_CHANNEL_ORDER_NATIVE,
+     *   nb_channels: 1,
+     *   u: { mask: 0x4n } // FC
+     * };
+     * console.log(ChannelLayoutUtils.describe(mono)); // "mono"
+     *
+     * const stereo: ChannelLayout = {
+     *   order: AV_CHANNEL_ORDER_NATIVE,
+     *   nb_channels: 2,
+     *   u: { mask: 0x3n } // FL | FR
+     * };
+     * console.log(ChannelLayoutUtils.describe(stereo)); // "stereo"
+     *
+     * // Custom layout
+     * const custom: ChannelLayout = {
+     *   order: AV_CHANNEL_ORDER_CUSTOM,
+     *   nb_channels: 3,
+     *   u: { map: null }
+     * };
+     * console.log(ChannelLayoutUtils.describe(custom)); // "3 channels"
+     * ```
+     */
+    static describe(channelLayout) {
+        return bindings.avChannelLayoutDescribe(channelLayout);
+    }
+}
+//# sourceMappingURL=channel-layout.js.map

package/dist/api/utilities/channel-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-layout.js","sourceRoot":"","sources":["../../../src/api/utilities/channel-layout.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAIhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,OAAO,kBAAkB;IAC7B,+CAA+C;IAC/C,gBAAuB,CAAC;IAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IACH,MAAM,CAAC,QAAQ,CAAC,aAAqC;QACnD,OAAO,QAAQ,CAAC,uBAAuB,CAAC,aAAa,CAAC,CAAC;IACzD,CAAC;CACF"}

package/dist/api/utilities/image.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Image Utilities
+ *
+ * Provides utilities for working with image buffers in FFmpeg.
+ * All methods are static and map directly to FFmpeg's libavutil functions.
+ *
+ * @module lib/image-utils
+ */
+import type { AVPixelFormat } from '../../lib/constants.js';
+/**
+ * Image buffer allocation result.
+ */
+export interface ImageAllocation {
+    /** Allocated buffer containing the image data */
+    buffer: Buffer;
+    /** Total size in bytes */
+    size: number;
+    /** Line sizes for each plane */
+    linesizes: number[];
+}
+/**
+ * Image buffer utilities.
+ *
+ * Provides static methods for allocating, copying, and managing image buffers.
+ * These utilities handle the low-level memory layout for various pixel formats,
+ * including planar formats with multiple buffers.
+ *
+ * @example
+ * ```typescript
+ * import { ImageUtils } from 'node-av';
+ * import { AV_PIX_FMT_YUV420P, AV_PIX_FMT_RGB24 } from 'node-av/constants';
+ *
+ * // Allocate image buffer
+ * const image = ImageUtils.alloc(1920, 1080, AV_PIX_FMT_YUV420P, 32);
+ * console.log(`Allocated ${image.size} bytes`);
+ *
+ * // Get buffer size without allocating
+ * const size = ImageUtils.getBufferSize(AV_PIX_FMT_RGB24, 1920, 1080, 1);
+ * console.log(`RGB24 1080p needs ${size} bytes`);
+ * ```
+ */
+export declare class ImageUtils {
+    private constructor();
+    /**
+     * Allocate an image buffer.
+     *
+     * Allocates a buffer large enough to hold an image with the specified dimensions
+     * and pixel format. Returns the buffer along with line sizes for each plane.
+     * 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, 16, or 32)
+     * @returns Allocation result with buffer, size, and line sizes
+     * @throws {FFmpegError} On allocation failure
+     *
+     * @example
+     * ```typescript
+     * import { ImageUtils } from 'node-av';
+     * import { AV_PIX_FMT_YUV420P } from 'node-av/constants';
+     *
+     * // Allocate aligned buffer for YUV420P image
+     * const image = ImageUtils.alloc(1920, 1080, AV_PIX_FMT_YUV420P, 32);
+     * console.log(`Buffer size: ${image.size} bytes`);
+     * console.log(`Y plane line size: ${image.linesizes[0]}`);
+     * console.log(`U plane line size: ${image.linesizes[1]}`);
+     * console.log(`V plane line size: ${image.linesizes[2]}`);
+     * ```
+     */
+    static alloc(width: number, height: number, pixFmt: AVPixelFormat, align: number): ImageAllocation;
+    /**
+     * Allocate image buffer arrays (alternative interface).
+     *
+     * Similar to alloc() but with a different return format.
+     * This is an alias for compatibility.
+     *
+     * @param width - Image width in pixels
+     * @param height - Image height in pixels
+     * @param pixFmt - Pixel format
+     * @param align - Buffer alignment
+     * @returns Allocation result
+     * @throws {FFmpegError} On allocation failure
+     */
+    static allocArrays(width: number, height: number, pixFmt: AVPixelFormat, align: number): ImageAllocation;
+    /**
+     * Copy image data between buffers.
+     *
+     * Copies image data from source buffers to destination buffers.
+     * Direct mapping to av_image_copy2()
+     *
+     * @param dstData - Destination data buffers (one per plane)
+     * @param dstLinesizes - Destination line sizes
+     * @param srcData - Source data buffers (one per plane)
+     * @param srcLinesizes - Source line sizes
+     * @param pixFmt - Pixel format
+     * @param width - Image width
+     * @param height - Image height
+     *
+     * @example
+     * ```typescript
+     * import { ImageUtils } from 'node-av';
+     * import { AV_PIX_FMT_YUV420P } from 'node-av/constants';
+     *
+     * // Copy between two image buffers
+     * ImageUtils.copy(
+     *   dstBuffers, dstLinesizes,
+     *   srcBuffers, srcLinesizes,
+     *   AV_PIX_FMT_YUV420P, 1920, 1080
+     * );
+     * ```
+     */
+    static copy(dstData: Buffer[], dstLinesizes: number[], srcData: Buffer[], srcLinesizes: number[], pixFmt: AVPixelFormat, width: number, height: number): void;
+    /**
+     * Get required buffer size for an image.
+     *
+     * Calculates the buffer size needed to store an image with the given parameters.
+     * 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
+     * ```typescript
+     * import { ImageUtils } from 'node-av';
+     * import { AV_PIX_FMT_RGB24, AV_PIX_FMT_YUV420P } from 'node-av/constants';
+     *
+     * // Calculate buffer sizes for different formats
+     * const rgbSize = ImageUtils.getBufferSize(AV_PIX_FMT_RGB24, 1920, 1080, 1);
+     * const yuvSize = ImageUtils.getBufferSize(AV_PIX_FMT_YUV420P, 1920, 1080, 1);
+     *
+     * console.log(`RGB24: ${rgbSize} bytes`);   // 1920*1080*3
+     * console.log(`YUV420P: ${yuvSize} bytes`); // 1920*1080*1.5
+     * ```
+     */
+    static getBufferSize(pixFmt: AVPixelFormat, width: number, height: number, align: number): number;
+    /**
+     * Copy image to a single buffer.
+     *
+     * Copies image data from multiple plane buffers to a single contiguous buffer.
+     * Useful for serialization or when a single buffer is required.
+     * Direct mapping to av_image_copy_to_buffer()
+     *
+     * @param dst - Destination buffer
+     * @param dstSize - Destination buffer size
+     * @param srcData - Source data buffers (one per plane), or null
+     * @param srcLinesize - Source line sizes, or null
+     * @param pixFmt - Pixel format
+     * @param width - Image width
+     * @param height - Image height
+     * @param align - Buffer alignment
+     * @returns Bytes written, or negative error code
+     *
+     * @example
+     * ```typescript
+     * import { ImageUtils, FFmpegError } from 'node-av';
+     * import { AV_PIX_FMT_YUV420P } from 'node-av/constants';
+     *
+     * // Copy planar data to single buffer
+     * const dstSize = ImageUtils.getBufferSize(AV_PIX_FMT_YUV420P, 1920, 1080, 1);
+     * const dst = Buffer.alloc(dstSize);
+     *
+     * const written = ImageUtils.copyToBuffer(
+     *   dst, dstSize,
+     *   srcBuffers, srcLinesizes,
+     *   AV_PIX_FMT_YUV420P, 1920, 1080, 1
+     * );
+     *
+     * FFmpegError.throwIfError(written, 'Failed to copy image to buffer');
+     * console.log(`Wrote ${written} bytes`);
+     * ```
+     */
+    static copyToBuffer(dst: Buffer, dstSize: number, srcData: Buffer[] | null, srcLinesize: number[] | null, pixFmt: AVPixelFormat, width: number, height: number, align: number): number;
+}

package/dist/api/utilities/image.js

@@ -0,0 +1,183 @@
+/**
+ * Image Utilities
+ *
+ * Provides utilities for working with image buffers in FFmpeg.
+ * All methods are static and map directly to FFmpeg's libavutil functions.
+ *
+ * @module lib/image-utils
+ */
+import { bindings } from '../../lib/binding.js';
+import { FFmpegError } from '../../lib/error.js';
+/**
+ * Image buffer utilities.
+ *
+ * Provides static methods for allocating, copying, and managing image buffers.
+ * These utilities handle the low-level memory layout for various pixel formats,
+ * including planar formats with multiple buffers.
+ *
+ * @example
+ * ```typescript
+ * import { ImageUtils } from 'node-av';
+ * import { AV_PIX_FMT_YUV420P, AV_PIX_FMT_RGB24 } from 'node-av/constants';
+ *
+ * // Allocate image buffer
+ * const image = ImageUtils.alloc(1920, 1080, AV_PIX_FMT_YUV420P, 32);
+ * console.log(`Allocated ${image.size} bytes`);
+ *
+ * // Get buffer size without allocating
+ * const size = ImageUtils.getBufferSize(AV_PIX_FMT_RGB24, 1920, 1080, 1);
+ * console.log(`RGB24 1080p needs ${size} bytes`);
+ * ```
+ */
+export class ImageUtils {
+    // Private constructor to prevent instantiation
+    constructor() { }
+    /**
+     * Allocate an image buffer.
+     *
+     * Allocates a buffer large enough to hold an image with the specified dimensions
+     * and pixel format. Returns the buffer along with line sizes for each plane.
+     * 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, 16, or 32)
+     * @returns Allocation result with buffer, size, and line sizes
+     * @throws {FFmpegError} On allocation failure
+     *
+     * @example
+     * ```typescript
+     * import { ImageUtils } from 'node-av';
+     * import { AV_PIX_FMT_YUV420P } from 'node-av/constants';
+     *
+     * // Allocate aligned buffer for YUV420P image
+     * const image = ImageUtils.alloc(1920, 1080, AV_PIX_FMT_YUV420P, 32);
+     * console.log(`Buffer size: ${image.size} bytes`);
+     * console.log(`Y plane line size: ${image.linesizes[0]}`);
+     * console.log(`U plane line size: ${image.linesizes[1]}`);
+     * console.log(`V plane line size: ${image.linesizes[2]}`);
+     * ```
+     */
+    static alloc(width, height, pixFmt, align) {
+        const result = bindings.avImageAlloc(width, height, pixFmt, align);
+        if (typeof result === 'number') {
+            FFmpegError.throwIfError(result, 'Failed to allocate image');
+        }
+        return result;
+    }
+    /**
+     * Allocate image buffer arrays (alternative interface).
+     *
+     * Similar to alloc() but with a different return format.
+     * This is an alias for compatibility.
+     *
+     * @param width - Image width in pixels
+     * @param height - Image height in pixels
+     * @param pixFmt - Pixel format
+     * @param align - Buffer alignment
+     * @returns Allocation result
+     * @throws {FFmpegError} On allocation failure
+     */
+    static allocArrays(width, height, pixFmt, align) {
+        return ImageUtils.alloc(width, height, pixFmt, align);
+    }
+    /**
+     * Copy image data between buffers.
+     *
+     * Copies image data from source buffers to destination buffers.
+     * Direct mapping to av_image_copy2()
+     *
+     * @param dstData - Destination data buffers (one per plane)
+     * @param dstLinesizes - Destination line sizes
+     * @param srcData - Source data buffers (one per plane)
+     * @param srcLinesizes - Source line sizes
+     * @param pixFmt - Pixel format
+     * @param width - Image width
+     * @param height - Image height
+     *
+     * @example
+     * ```typescript
+     * import { ImageUtils } from 'node-av';
+     * import { AV_PIX_FMT_YUV420P } from 'node-av/constants';
+     *
+     * // Copy between two image buffers
+     * ImageUtils.copy(
+     *   dstBuffers, dstLinesizes,
+     *   srcBuffers, srcLinesizes,
+     *   AV_PIX_FMT_YUV420P, 1920, 1080
+     * );
+     * ```
+     */
+    static copy(dstData, dstLinesizes, srcData, srcLinesizes, pixFmt, width, height) {
+        bindings.avImageCopy2(dstData, dstLinesizes, srcData, srcLinesizes, pixFmt, width, height);
+    }
+    /**
+     * Get required buffer size for an image.
+     *
+     * Calculates the buffer size needed to store an image with the given parameters.
+     * 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
+     * ```typescript
+     * import { ImageUtils } from 'node-av';
+     * import { AV_PIX_FMT_RGB24, AV_PIX_FMT_YUV420P } from 'node-av/constants';
+     *
+     * // Calculate buffer sizes for different formats
+     * const rgbSize = ImageUtils.getBufferSize(AV_PIX_FMT_RGB24, 1920, 1080, 1);
+     * const yuvSize = ImageUtils.getBufferSize(AV_PIX_FMT_YUV420P, 1920, 1080, 1);
+     *
+     * console.log(`RGB24: ${rgbSize} bytes`);   // 1920*1080*3
+     * console.log(`YUV420P: ${yuvSize} bytes`); // 1920*1080*1.5
+     * ```
+     */
+    static getBufferSize(pixFmt, width, height, align) {
+        return bindings.avImageGetBufferSize(pixFmt, width, height, align);
+    }
+    /**
+     * Copy image to a single buffer.
+     *
+     * Copies image data from multiple plane buffers to a single contiguous buffer.
+     * Useful for serialization or when a single buffer is required.
+     * Direct mapping to av_image_copy_to_buffer()
+     *
+     * @param dst - Destination buffer
+     * @param dstSize - Destination buffer size
+     * @param srcData - Source data buffers (one per plane), or null
+     * @param srcLinesize - Source line sizes, or null
+     * @param pixFmt - Pixel format
+     * @param width - Image width
+     * @param height - Image height
+     * @param align - Buffer alignment
+     * @returns Bytes written, or negative error code
+     *
+     * @example
+     * ```typescript
+     * import { ImageUtils, FFmpegError } from 'node-av';
+     * import { AV_PIX_FMT_YUV420P } from 'node-av/constants';
+     *
+     * // Copy planar data to single buffer
+     * const dstSize = ImageUtils.getBufferSize(AV_PIX_FMT_YUV420P, 1920, 1080, 1);
+     * const dst = Buffer.alloc(dstSize);
+     *
+     * const written = ImageUtils.copyToBuffer(
+     *   dst, dstSize,
+     *   srcBuffers, srcLinesizes,
+     *   AV_PIX_FMT_YUV420P, 1920, 1080, 1
+     * );
+     *
+     * FFmpegError.throwIfError(written, 'Failed to copy image to buffer');
+     * console.log(`Wrote ${written} bytes`);
+     * ```
+     */
+    static copyToBuffer(dst, dstSize, srcData, srcLinesize, pixFmt, width, height, align) {
+        return bindings.avImageCopyToBuffer(dst, dstSize, srcData, srcLinesize, pixFmt, width, height, align);
+    }
+}
+//# sourceMappingURL=image.js.map

package/dist/api/utilities/image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.js","sourceRoot":"","sources":["../../../src/api/utilities/image.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAgBjD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,UAAU;IACrB,+CAA+C;IAC/C,gBAAuB,CAAC;IAExB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,MAAM,CAAC,KAAK,CAAC,KAAa,EAAE,MAAc,EAAE,MAAqB,EAAE,KAAa;QAC9E,MAAM,MAAM,GAAG,QAAQ,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QACnE,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,WAAW,CAAC,YAAY,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,MAAyB,CAAC;IACnC,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,WAAW,CAAC,KAAa,EAAE,MAAc,EAAE,MAAqB,EAAE,KAAa;QACpF,OAAO,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACxD,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,MAAM,CAAC,IAAI,CAAC,OAAiB,EAAE,YAAsB,EAAE,OAAiB,EAAE,YAAsB,EAAE,MAAqB,EAAE,KAAa,EAAE,MAAc;QACpJ,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAC7F,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,MAAM,CAAC,aAAa,CAAC,MAAqB,EAAE,KAAa,EAAE,MAAc,EAAE,KAAa;QACtF,OAAO,QAAQ,CAAC,oBAAoB,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,MAAM,CAAC,YAAY,CACjB,GAAW,EACX,OAAe,EACf,OAAwB,EACxB,WAA4B,EAC5B,MAAqB,EACrB,KAAa,EACb,MAAc,EACd,KAAa;QAEb,OAAO,QAAQ,CAAC,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACxG,CAAC;CACF"}

package/dist/api/utilities/index.d.ts

@@ -0,0 +1,8 @@
+export { AudioSampleUtils, type AudioSampleAllocation, type AudioSampleBufferSize } from './audio-sample.js';
+export { ChannelLayoutUtils } from './channel-layout.js';
+export { ImageUtils, type ImageAllocation } from './image.js';
+export { MediaType } from './media-type.js';
+export { PixelFormat } from './pixel-format.js';
+export { SampleFormat } from './sample-format.js';
+export { TimestampUtils } from './timestamp.js';
+export { StreamingUtils } from './streaming.js';

package/dist/api/utilities/index.js

@@ -0,0 +1,17 @@
+// Audio
+export { AudioSampleUtils } from './audio-sample.js';
+// Channel Layouts
+export { ChannelLayoutUtils } from './channel-layout.js';
+// Image
+export { ImageUtils } from './image.js';
+// Media
+export { MediaType } from './media-type.js';
+// Pixel Format
+export { PixelFormat } from './pixel-format.js';
+// Sample Format
+export { SampleFormat } from './sample-format.js';
+// Timestamp
+export { TimestampUtils } from './timestamp.js';
+// Streaming
+export { StreamingUtils } from './streaming.js';
+//# sourceMappingURL=index.js.map

package/dist/api/utilities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/utilities/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,OAAO,EAAE,gBAAgB,EAA0D,MAAM,mBAAmB,CAAC;AAE7G,kBAAkB;AAClB,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,QAAQ;AACR,OAAO,EAAE,UAAU,EAAwB,MAAM,YAAY,CAAC;AAE9D,QAAQ;AACR,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,eAAe;AACf,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,YAAY;AACZ,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,YAAY;AACZ,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}