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

package/dist/api/utilities/pixel-format.d.ts

@@ -0,0 +1,89 @@
+import type { AVPixelFormat } from '../../constants/index.js';
+/**
+ * Video pixel format utilities.
+ *
+ * Provides static methods for querying pixel format properties, converting
+ * between format names and values, and checking hardware acceleration support.
+ *
+ * @example
+ * ```typescript
+ * import { PixelFormat } from 'node-av';
+ * import { AV_PIX_FMT_YUV420P, AV_PIX_FMT_CUDA } from 'node-av/constants';
+ *
+ * // Get format information
+ * console.log(PixelFormat.getName(AV_PIX_FMT_YUV420P));    // "yuv420p"
+ * console.log(PixelFormat.isHardware(AV_PIX_FMT_CUDA));    // true
+ *
+ * // Convert between names and values
+ * const format = PixelFormat.fromName("yuv420p");
+ * console.log(format === AV_PIX_FMT_YUV420P);              // true
+ * ```
+ */
+export declare class PixelFormatUtils {
+    private constructor();
+    /**
+     * Get the name of a pixel format.
+     *
+     * Returns a string describing the pixel format.
+     * Direct mapping to av_get_pix_fmt_name()
+     *
+     * @param format - Video pixel format
+     *
+     * @returns Format name string, or null for invalid format
+     *
+     * @example
+     * ```typescript
+     * import { PixelFormat } from 'node-av';
+     * import { AV_PIX_FMT_YUV420P, AV_PIX_FMT_RGB24 } from 'node-av/constants';
+     *
+     * console.log(PixelFormat.getName(AV_PIX_FMT_YUV420P)); // "yuv420p"
+     * console.log(PixelFormat.getName(AV_PIX_FMT_RGB24));   // "rgb24"
+     * ```
+     */
+    static getName(format: AVPixelFormat): string | null;
+    /**
+     * Get pixel format from name.
+     *
+     * Converts a pixel format name string to its enum value.
+     * Direct mapping to av_get_pix_fmt()
+     *
+     * @param name - Pixel format name string
+     *
+     * @returns Pixel format enum value, or AV_PIX_FMT_NONE for unknown formats
+     *
+     * @example
+     * ```typescript
+     * import { PixelFormat } from 'node-av';
+     * import { AV_PIX_FMT_YUV420P } from 'node-av/constants';
+     *
+     * const format = PixelFormat.fromName("yuv420p");
+     * console.log(format === AV_PIX_FMT_YUV420P); // true
+     *
+     * const invalid = PixelFormat.fromName("invalid");
+     * console.log(invalid === AV_PIX_FMT_NONE);   // true
+     * ```
+     */
+    static fromName(name: string): AVPixelFormat;
+    /**
+     * Check if pixel format is hardware accelerated.
+     *
+     * Returns true if the pixel format represents frames in GPU/hardware memory
+     * rather than system memory.
+     * Direct mapping to av_pix_fmt_desc_get() and checking for AV_PIX_FMT_FLAG_HWACCEL
+     *
+     * @param format - Video pixel format
+     *
+     * @returns True if format is hardware accelerated
+     *
+     * @example
+     * ```typescript
+     * import { PixelFormat } from 'node-av';
+     * import { AV_PIX_FMT_YUV420P, AV_PIX_FMT_CUDA, AV_PIX_FMT_VAAPI } from 'node-av/constants';
+     *
+     * console.log(PixelFormat.isHardware(AV_PIX_FMT_YUV420P)); // false
+     * console.log(PixelFormat.isHardware(AV_PIX_FMT_CUDA));    // true
+     * console.log(PixelFormat.isHardware(AV_PIX_FMT_VAAPI));   // true
+     * ```
+     */
+    static isHardware(format: AVPixelFormat): boolean;
+}

package/dist/api/utilities/pixel-format.js

@@ -0,0 +1,97 @@
+import { bindings } from '../../lib/binding.js';
+/**
+ * Video pixel format utilities.
+ *
+ * Provides static methods for querying pixel format properties, converting
+ * between format names and values, and checking hardware acceleration support.
+ *
+ * @example
+ * ```typescript
+ * import { PixelFormat } from 'node-av';
+ * import { AV_PIX_FMT_YUV420P, AV_PIX_FMT_CUDA } from 'node-av/constants';
+ *
+ * // Get format information
+ * console.log(PixelFormat.getName(AV_PIX_FMT_YUV420P));    // "yuv420p"
+ * console.log(PixelFormat.isHardware(AV_PIX_FMT_CUDA));    // true
+ *
+ * // Convert between names and values
+ * const format = PixelFormat.fromName("yuv420p");
+ * console.log(format === AV_PIX_FMT_YUV420P);              // true
+ * ```
+ */
+export class PixelFormatUtils {
+    // Private constructor to prevent instantiation
+    constructor() { }
+    /**
+     * Get the name of a pixel format.
+     *
+     * Returns a string describing the pixel format.
+     * Direct mapping to av_get_pix_fmt_name()
+     *
+     * @param format - Video pixel format
+     *
+     * @returns Format name string, or null for invalid format
+     *
+     * @example
+     * ```typescript
+     * import { PixelFormat } from 'node-av';
+     * import { AV_PIX_FMT_YUV420P, AV_PIX_FMT_RGB24 } from 'node-av/constants';
+     *
+     * console.log(PixelFormat.getName(AV_PIX_FMT_YUV420P)); // "yuv420p"
+     * console.log(PixelFormat.getName(AV_PIX_FMT_RGB24));   // "rgb24"
+     * ```
+     */
+    static getName(format) {
+        return bindings.avGetPixFmtName(format);
+    }
+    /**
+     * Get pixel format from name.
+     *
+     * Converts a pixel format name string to its enum value.
+     * Direct mapping to av_get_pix_fmt()
+     *
+     * @param name - Pixel format name string
+     *
+     * @returns Pixel format enum value, or AV_PIX_FMT_NONE for unknown formats
+     *
+     * @example
+     * ```typescript
+     * import { PixelFormat } from 'node-av';
+     * import { AV_PIX_FMT_YUV420P } from 'node-av/constants';
+     *
+     * const format = PixelFormat.fromName("yuv420p");
+     * console.log(format === AV_PIX_FMT_YUV420P); // true
+     *
+     * const invalid = PixelFormat.fromName("invalid");
+     * console.log(invalid === AV_PIX_FMT_NONE);   // true
+     * ```
+     */
+    static fromName(name) {
+        return bindings.avGetPixFmtFromName(name);
+    }
+    /**
+     * Check if pixel format is hardware accelerated.
+     *
+     * Returns true if the pixel format represents frames in GPU/hardware memory
+     * rather than system memory.
+     * Direct mapping to av_pix_fmt_desc_get() and checking for AV_PIX_FMT_FLAG_HWACCEL
+     *
+     * @param format - Video pixel format
+     *
+     * @returns True if format is hardware accelerated
+     *
+     * @example
+     * ```typescript
+     * import { PixelFormat } from 'node-av';
+     * import { AV_PIX_FMT_YUV420P, AV_PIX_FMT_CUDA, AV_PIX_FMT_VAAPI } from 'node-av/constants';
+     *
+     * console.log(PixelFormat.isHardware(AV_PIX_FMT_YUV420P)); // false
+     * console.log(PixelFormat.isHardware(AV_PIX_FMT_CUDA));    // true
+     * console.log(PixelFormat.isHardware(AV_PIX_FMT_VAAPI));   // true
+     * ```
+     */
+    static isHardware(format) {
+        return bindings.avIsHardwarePixelFormat(format);
+    }
+}
+//# sourceMappingURL=pixel-format.js.map

package/dist/api/utilities/pixel-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixel-format.js","sourceRoot":"","sources":["../../../src/api/utilities/pixel-format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAIhD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,gBAAgB;IAC3B,+CAA+C;IAC/C,gBAAuB,CAAC;IAExB;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,OAAO,CAAC,MAAqB;QAClC,OAAO,QAAQ,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAY;QAC1B,OAAO,QAAQ,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,CAAC,UAAU,CAAC,MAAqB;QACrC,OAAO,QAAQ,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC;CACF"}

package/dist/api/utilities/sample-format.d.ts

@@ -0,0 +1,129 @@
+import type { AVSampleFormat } from '../../constants/index.js';
+/**
+ * Audio sample format utilities.
+ *
+ * Provides static methods for querying and converting between audio sample formats.
+ * These utilities help with format introspection, conversion between packed/planar
+ * layouts, and getting human-readable format information.
+ *
+ * @example
+ * ```typescript
+ * import { SampleFormat } from 'node-av';
+ * import { AV_SAMPLE_FMT_S16, AV_SAMPLE_FMT_FLTP } from 'node-av/constants';
+ *
+ * // Get format information
+ * console.log(SampleFormat.getName(AV_SAMPLE_FMT_S16));        // "s16"
+ * console.log(SampleFormat.getBytesPerSample(AV_SAMPLE_FMT_S16)); // 2
+ * console.log(SampleFormat.isPlanar(AV_SAMPLE_FMT_FLTP));      // true
+ *
+ * // Convert between packed and planar formats
+ * const packed = SampleFormat.getPackedFormat(AV_SAMPLE_FMT_FLTP);
+ * const planar = SampleFormat.getPlanarFormat(AV_SAMPLE_FMT_FLT);
+ * ```
+ */
+export declare class SampleFormatUtils {
+    private constructor();
+    /**
+     * Get bytes per sample for a sample format.
+     *
+     * Returns the number of bytes required to store one sample in the given format.
+     * Direct mapping to av_get_bytes_per_sample()
+     *
+     * @param format - Audio sample format
+     *
+     * @returns Number of bytes per sample, or 0 for invalid format
+     *
+     * @example
+     * ```typescript
+     * import { SampleFormat } from 'node-av';
+     * import { AV_SAMPLE_FMT_S16, AV_SAMPLE_FMT_FLT } from 'node-av/constants';
+     *
+     * console.log(SampleFormat.getBytesPerSample(AV_SAMPLE_FMT_S16)); // 2
+     * console.log(SampleFormat.getBytesPerSample(AV_SAMPLE_FMT_FLT)); // 4
+     * ```
+     */
+    static getBytesPerSample(format: AVSampleFormat): number;
+    /**
+     * Get the name of a sample format.
+     *
+     * Returns a string describing the sample format.
+     * Direct mapping to av_get_sample_fmt_name()
+     *
+     * @param format - Audio sample format
+     *
+     * @returns Format name string, or null for invalid format
+     *
+     * @example
+     * ```typescript
+     * import { SampleFormat } from 'node-av';
+     * import { AV_SAMPLE_FMT_S16, AV_SAMPLE_FMT_FLTP } from 'node-av/constants';
+     *
+     * console.log(SampleFormat.getName(AV_SAMPLE_FMT_S16));  // "s16"
+     * console.log(SampleFormat.getName(AV_SAMPLE_FMT_FLTP)); // "fltp"
+     * ```
+     */
+    static getName(format: AVSampleFormat): string | null;
+    /**
+     * Get packed sample format.
+     *
+     * Returns the packed variant of the given sample format.
+     * If the format is already packed, returns it unchanged.
+     * Direct mapping to av_get_packed_sample_fmt()
+     *
+     * @param format - Audio sample format
+     *
+     * @returns Packed sample format
+     *
+     * @example
+     * ```typescript
+     * import { SampleFormat } from 'node-av';
+     * import { AV_SAMPLE_FMT_FLTP, AV_SAMPLE_FMT_FLT } from 'node-av/constants';
+     *
+     * const packed = SampleFormat.getPackedFormat(AV_SAMPLE_FMT_FLTP);
+     * console.log(packed === AV_SAMPLE_FMT_FLT); // true
+     * ```
+     */
+    static getPackedFormat(format: AVSampleFormat): AVSampleFormat;
+    /**
+     * Get planar sample format.
+     *
+     * Returns the planar variant of the given sample format.
+     * If the format is already planar, returns it unchanged.
+     * Direct mapping to av_get_planar_sample_fmt()
+     *
+     * @param format - Audio sample format
+     *
+     * @returns Planar sample format
+     *
+     * @example
+     * ```typescript
+     * import { SampleFormat } from 'node-av';
+     * import { AV_SAMPLE_FMT_FLT, AV_SAMPLE_FMT_FLTP } from 'node-av/constants';
+     *
+     * const planar = SampleFormat.getPlanarFormat(AV_SAMPLE_FMT_FLT);
+     * console.log(planar === AV_SAMPLE_FMT_FLTP); // true
+     * ```
+     */
+    static getPlanarFormat(format: AVSampleFormat): AVSampleFormat;
+    /**
+     * Check if sample format is planar.
+     *
+     * Returns true if the sample format stores each channel in a separate buffer.
+     * Returns false if all channels are interleaved in a single buffer.
+     * Direct mapping to av_sample_fmt_is_planar()
+     *
+     * @param format - Audio sample format
+     *
+     * @returns True if format is planar, false if packed/interleaved
+     *
+     * @example
+     * ```typescript
+     * import { SampleFormat } from 'node-av';
+     * import { AV_SAMPLE_FMT_S16, AV_SAMPLE_FMT_S16P } from 'node-av/constants';
+     *
+     * console.log(SampleFormat.isPlanar(AV_SAMPLE_FMT_S16));  // false (packed)
+     * console.log(SampleFormat.isPlanar(AV_SAMPLE_FMT_S16P)); // true (planar)
+     * ```
+     */
+    static isPlanar(format: AVSampleFormat): boolean;
+}

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

@@ -0,0 +1,141 @@
+import { bindings } from '../../lib/binding.js';
+/**
+ * Audio sample format utilities.
+ *
+ * Provides static methods for querying and converting between audio sample formats.
+ * These utilities help with format introspection, conversion between packed/planar
+ * layouts, and getting human-readable format information.
+ *
+ * @example
+ * ```typescript
+ * import { SampleFormat } from 'node-av';
+ * import { AV_SAMPLE_FMT_S16, AV_SAMPLE_FMT_FLTP } from 'node-av/constants';
+ *
+ * // Get format information
+ * console.log(SampleFormat.getName(AV_SAMPLE_FMT_S16));        // "s16"
+ * console.log(SampleFormat.getBytesPerSample(AV_SAMPLE_FMT_S16)); // 2
+ * console.log(SampleFormat.isPlanar(AV_SAMPLE_FMT_FLTP));      // true
+ *
+ * // Convert between packed and planar formats
+ * const packed = SampleFormat.getPackedFormat(AV_SAMPLE_FMT_FLTP);
+ * const planar = SampleFormat.getPlanarFormat(AV_SAMPLE_FMT_FLT);
+ * ```
+ */
+export class SampleFormatUtils {
+    // Private constructor to prevent instantiation
+    constructor() { }
+    /**
+     * Get bytes per sample for a sample format.
+     *
+     * Returns the number of bytes required to store one sample in the given format.
+     * Direct mapping to av_get_bytes_per_sample()
+     *
+     * @param format - Audio sample format
+     *
+     * @returns Number of bytes per sample, or 0 for invalid format
+     *
+     * @example
+     * ```typescript
+     * import { SampleFormat } from 'node-av';
+     * import { AV_SAMPLE_FMT_S16, AV_SAMPLE_FMT_FLT } from 'node-av/constants';
+     *
+     * console.log(SampleFormat.getBytesPerSample(AV_SAMPLE_FMT_S16)); // 2
+     * console.log(SampleFormat.getBytesPerSample(AV_SAMPLE_FMT_FLT)); // 4
+     * ```
+     */
+    static getBytesPerSample(format) {
+        return bindings.avGetBytesPerSample(format);
+    }
+    /**
+     * Get the name of a sample format.
+     *
+     * Returns a string describing the sample format.
+     * Direct mapping to av_get_sample_fmt_name()
+     *
+     * @param format - Audio sample format
+     *
+     * @returns Format name string, or null for invalid format
+     *
+     * @example
+     * ```typescript
+     * import { SampleFormat } from 'node-av';
+     * import { AV_SAMPLE_FMT_S16, AV_SAMPLE_FMT_FLTP } from 'node-av/constants';
+     *
+     * console.log(SampleFormat.getName(AV_SAMPLE_FMT_S16));  // "s16"
+     * console.log(SampleFormat.getName(AV_SAMPLE_FMT_FLTP)); // "fltp"
+     * ```
+     */
+    static getName(format) {
+        return bindings.avGetSampleFmtName(format);
+    }
+    /**
+     * Get packed sample format.
+     *
+     * Returns the packed variant of the given sample format.
+     * If the format is already packed, returns it unchanged.
+     * Direct mapping to av_get_packed_sample_fmt()
+     *
+     * @param format - Audio sample format
+     *
+     * @returns Packed sample format
+     *
+     * @example
+     * ```typescript
+     * import { SampleFormat } from 'node-av';
+     * import { AV_SAMPLE_FMT_FLTP, AV_SAMPLE_FMT_FLT } from 'node-av/constants';
+     *
+     * const packed = SampleFormat.getPackedFormat(AV_SAMPLE_FMT_FLTP);
+     * console.log(packed === AV_SAMPLE_FMT_FLT); // true
+     * ```
+     */
+    static getPackedFormat(format) {
+        return bindings.avGetPackedSampleFmt(format);
+    }
+    /**
+     * Get planar sample format.
+     *
+     * Returns the planar variant of the given sample format.
+     * If the format is already planar, returns it unchanged.
+     * Direct mapping to av_get_planar_sample_fmt()
+     *
+     * @param format - Audio sample format
+     *
+     * @returns Planar sample format
+     *
+     * @example
+     * ```typescript
+     * import { SampleFormat } from 'node-av';
+     * import { AV_SAMPLE_FMT_FLT, AV_SAMPLE_FMT_FLTP } from 'node-av/constants';
+     *
+     * const planar = SampleFormat.getPlanarFormat(AV_SAMPLE_FMT_FLT);
+     * console.log(planar === AV_SAMPLE_FMT_FLTP); // true
+     * ```
+     */
+    static getPlanarFormat(format) {
+        return bindings.avGetPlanarSampleFmt(format);
+    }
+    /**
+     * Check if sample format is planar.
+     *
+     * Returns true if the sample format stores each channel in a separate buffer.
+     * Returns false if all channels are interleaved in a single buffer.
+     * Direct mapping to av_sample_fmt_is_planar()
+     *
+     * @param format - Audio sample format
+     *
+     * @returns True if format is planar, false if packed/interleaved
+     *
+     * @example
+     * ```typescript
+     * import { SampleFormat } from 'node-av';
+     * import { AV_SAMPLE_FMT_S16, AV_SAMPLE_FMT_S16P } from 'node-av/constants';
+     *
+     * console.log(SampleFormat.isPlanar(AV_SAMPLE_FMT_S16));  // false (packed)
+     * console.log(SampleFormat.isPlanar(AV_SAMPLE_FMT_S16P)); // true (planar)
+     * ```
+     */
+    static isPlanar(format) {
+        return bindings.avSampleFmtIsPlanar(format);
+    }
+}
+//# sourceMappingURL=sample-format.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sample-format.js","sourceRoot":"","sources":["../../../src/api/utilities/sample-format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAIhD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,iBAAiB;IAC5B,+CAA+C;IAC/C,gBAAuB,CAAC;IAExB;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,iBAAiB,CAAC,MAAsB;QAC7C,OAAO,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,OAAO,CAAC,MAAsB;QACnC,OAAO,QAAQ,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,eAAe,CAAC,MAAsB;QAC3C,OAAO,QAAQ,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,eAAe,CAAC,MAAsB;QAC3C,OAAO,QAAQ,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAsB;QACpC,OAAO,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;CACF"}

package/dist/api/utilities/scale-size.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Resolve a scale target where -1 keeps the source aspect ratio.
+ *
+ * Like the scale filter's -2: the derived side is rounded to an even number so
+ * 4:2:0 encoders accept it. Both sides -1 keeps the source size.
+ *
+ * @param srcWidth - Source width
+ *
+ * @param srcHeight - Source height
+ *
+ * @param width - Target width, or -1 to derive it from the height
+ *
+ * @param height - Target height, or -1 to derive it from the width
+ *
+ * @returns The target size
+ *
+ * @internal
+ */
+export declare function resolveScaleSize(srcWidth: number, srcHeight: number, width: number, height: number): {
+    width: number;
+    height: number;
+};
+/**
+ * Scale target and output size of a transcode, never larger than the source.
+ *
+ * A requested width or height above the source keeps the source size, since a
+ * bigger picture only raises the bitrate.
+ *
+ * @param srcWidth - Source width, 0 when unknown before the first frame
+ *
+ * @param srcHeight - Source height, 0 when unknown before the first frame
+ *
+ * @param width - Requested width, or -1 to derive it from the height
+ *
+ * @param height - Requested height, or -1 to derive it from the width
+ *
+ * @returns The target for the scale filter (-1 follows the source) and the
+ * resolved output size, undefined while the source size is unknown
+ *
+ * @internal
+ */
+export declare function transcodeScale(srcWidth: number, srcHeight: number, width?: number, height?: number): {
+    target: {
+        width: number;
+        height: number;
+    };
+    output?: {
+        width: number;
+        height: number;
+    };
+};

package/dist/api/utilities/scale-size.js

@@ -0,0 +1,55 @@
+/**
+ * Resolve a scale target where -1 keeps the source aspect ratio.
+ *
+ * Like the scale filter's -2: the derived side is rounded to an even number so
+ * 4:2:0 encoders accept it. Both sides -1 keeps the source size.
+ *
+ * @param srcWidth - Source width
+ *
+ * @param srcHeight - Source height
+ *
+ * @param width - Target width, or -1 to derive it from the height
+ *
+ * @param height - Target height, or -1 to derive it from the width
+ *
+ * @returns The target size
+ *
+ * @internal
+ */
+export function resolveScaleSize(srcWidth, srcHeight, width, height) {
+    if (width < 0 && height < 0) {
+        return { width: srcWidth, height: srcHeight };
+    }
+    if (width < 0) {
+        return { width: Math.max(2, Math.round((height * srcWidth) / srcHeight / 2) * 2), height };
+    }
+    if (height < 0) {
+        return { width, height: Math.max(2, Math.round((width * srcHeight) / srcWidth / 2) * 2) };
+    }
+    return { width, height };
+}
+/**
+ * Scale target and output size of a transcode, never larger than the source.
+ *
+ * A requested width or height above the source keeps the source size, since a
+ * bigger picture only raises the bitrate.
+ *
+ * @param srcWidth - Source width, 0 when unknown before the first frame
+ *
+ * @param srcHeight - Source height, 0 when unknown before the first frame
+ *
+ * @param width - Requested width, or -1 to derive it from the height
+ *
+ * @param height - Requested height, or -1 to derive it from the width
+ *
+ * @returns The target for the scale filter (-1 follows the source) and the
+ * resolved output size, undefined while the source size is unknown
+ *
+ * @internal
+ */
+export function transcodeScale(srcWidth, srcHeight, width = -1, height = -1) {
+    const known = srcWidth > 0 && srcHeight > 0;
+    const target = known && (width > srcWidth || height > srcHeight) ? { width: -1, height: -1 } : { width, height };
+    return { target, output: known ? resolveScaleSize(srcWidth, srcHeight, target.width, target.height) : undefined };
+}
+//# sourceMappingURL=scale-size.js.map

package/dist/api/utilities/scale-size.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scale-size.js","sourceRoot":"","sources":["../../../src/api/utilities/scale-size.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,SAAiB,EAAE,KAAa,EAAE,MAAc;IACjG,IAAI,KAAK,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAChD,CAAC;IACD,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,QAAQ,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7F,CAAC;IACD,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACf,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,SAAS,CAAC,GAAG,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;IAC5F,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAgB,EAChB,SAAiB,EACjB,KAAK,GAAG,CAAC,CAAC,EACV,MAAM,GAAG,CAAC,CAAC;IAEX,MAAM,KAAK,GAAG,QAAQ,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,KAAK,IAAI,CAAC,KAAK,GAAG,QAAQ,IAAI,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IACjH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;AACpH,CAAC"}