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

package/dist/lib/option.js

@@ -0,0 +1,1607 @@
+import { AV_OPT_SEARCH_CHILDREN, AV_OPT_TYPE_BINARY, AV_OPT_TYPE_BINARY_INT_ARRAY, AV_OPT_TYPE_BOOL, AV_OPT_TYPE_CHLAYOUT, AV_OPT_TYPE_COLOR, AV_OPT_TYPE_CONST, AV_OPT_TYPE_DICT, AV_OPT_TYPE_DOUBLE, AV_OPT_TYPE_DURATION, AV_OPT_TYPE_FLAGS, AV_OPT_TYPE_FLOAT, AV_OPT_TYPE_IMAGE_SIZE, AV_OPT_TYPE_INT, AV_OPT_TYPE_INT64, AV_OPT_TYPE_PIXEL_FMT, AV_OPT_TYPE_RATIONAL, AV_OPT_TYPE_SAMPLE_FMT, AV_OPT_TYPE_STRING, AV_OPT_TYPE_UINT, AV_OPT_TYPE_UINT64, AV_OPT_TYPE_VIDEO_RATE, AVFLAG_NONE, } from '../constants/constants.js';
+import { bindings } from './binding.js';
+import { Dictionary } from './dictionary.js';
+import { FFmpegError, PosixError } from './error.js';
+import { Rational } from './rational.js';
+import { avGetPixFmtFromName, avGetSampleFmtFromName } from './utilities.js';
+/**
+ * Option information descriptor.
+ *
+ * Describes a single option available on an FFmpeg object.
+ * Contains metadata about the option including name, type, default value,
+ * valid range, and documentation. Used to discover and validate options.
+ *
+ * Direct mapping to FFmpeg's AVOption.
+ *
+ * @example
+ * ```typescript
+ * import { Option } from 'node-av';
+ *
+ * // Get option info
+ * const optInfo = Option.find(obj, 'bitrate');
+ * if (optInfo) {
+ *   console.log(`Option: ${optInfo.name}`);
+ *   console.log(`Help: ${optInfo.help}`);
+ *   console.log(`Type: ${optInfo.type}`);
+ *   console.log(`Default: ${optInfo.defaultValue}`);
+ *   console.log(`Range: ${optInfo.min} - ${optInfo.max}`);
+ * }
+ * ```
+ *
+ * @see [AVOption](https://ffmpeg.org/doxygen/trunk/structAVOption.html) - FFmpeg Doxygen
+ */
+export class OptionInfo {
+    native;
+    /**
+     * @param native - The native option instance
+     *
+     * @internal
+     */
+    constructor(native) {
+        this.native = native;
+    }
+    /**
+     * Option name.
+     *
+     * The name used to get/set this option.
+     *
+     * Direct mapping to AVOption->name.
+     */
+    get name() {
+        return this.native.name;
+    }
+    /**
+     * Option help text.
+     *
+     * Human-readable description of the option's purpose.
+     *
+     * Direct mapping to AVOption->help.
+     */
+    get help() {
+        return this.native.help;
+    }
+    /**
+     * Option type.
+     *
+     * Data type of the option value (AV_OPT_TYPE_*).
+     *
+     * Direct mapping to AVOption->type.
+     */
+    get type() {
+        return this.native.type;
+    }
+    /**
+     * Default value.
+     *
+     * The default value for this option.
+     * Type depends on the option type.
+     *
+     * Direct mapping to AVOption->default_val.
+     */
+    get defaultValue() {
+        return this.native.defaultValue;
+    }
+    /**
+     * Minimum value.
+     *
+     * Minimum valid value for numeric options.
+     *
+     * Direct mapping to AVOption->min.
+     */
+    get min() {
+        return this.native.min;
+    }
+    /**
+     * Maximum value.
+     *
+     * Maximum valid value for numeric options.
+     *
+     * Direct mapping to AVOption->max.
+     */
+    get max() {
+        return this.native.max;
+    }
+    /**
+     * Option flags.
+     *
+     * Combination of AV_OPT_FLAG_* indicating option properties.
+     *
+     * Direct mapping to AVOption->flags.
+     */
+    get flags() {
+        return this.native.flags;
+    }
+    /**
+     * Check if option has specific flags.
+     *
+     * Tests whether all specified flags are set using bitwise AND.
+     *
+     * @param flags - One or more flag values to check
+     *
+     * @returns true if all specified flags are set, false otherwise
+     *
+     * @example
+     * ```typescript
+     * import { AV_OPT_FLAG_ENCODING_PARAM } from 'node-av/constants';
+     *
+     * if (option.hasFlags(AV_OPT_FLAG_ENCODING_PARAM)) {
+     *   console.log('This option is used for encoding');
+     * }
+     * ```
+     *
+     * @see {@link flags} For direct flags access
+     */
+    hasFlags(...flags) {
+        for (const flag of flags) {
+            if ((this.native.flags & flag) !== flag) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Option unit.
+     *
+     * Unit string for grouping related options.
+     *
+     * Direct mapping to AVOption->unit.
+     */
+    get unit() {
+        return this.native.unit;
+    }
+    /**
+     * Get the underlying native Option object.
+     *
+     * @returns The native Option binding object
+     *
+     * @internal
+     */
+    getNative() {
+        return this.native;
+    }
+}
+/**
+ * FFmpeg option management utilities.
+ *
+ * Provides static methods for getting, setting, and querying options
+ * on FFmpeg objects that support the AVOption API. Handles type conversion
+ * and validation for various option types including strings, numbers,
+ * rationals, pixel formats, and more.
+ *
+ * Direct mapping to FFmpeg's AVOption API.
+ *
+ * @example
+ * ```typescript
+ * import { Option, FFmpegError } from 'node-av';
+ * import { AV_OPT_SEARCH_CHILDREN, AV_PIX_FMT_YUV420P } from 'node-av/constants';
+ *
+ * // Set various option types
+ * let ret = Option.set(obj, 'preset', 'fast');
+ * FFmpegError.throwIfError(ret, 'set preset');
+ *
+ * ret = Option.setInt(obj, 'bitrate', 2000000);
+ * FFmpegError.throwIfError(ret, 'set bitrate');
+ *
+ * ret = Option.setRational(obj, 'framerate', { num: 30, den: 1 });
+ * FFmpegError.throwIfError(ret, 'set framerate');
+ *
+ * // Get option values
+ * const preset = Option.get(obj, 'preset');
+ * const bitrate = Option.getInt(obj, 'bitrate');
+ * const framerate = Option.getRational(obj, 'framerate');
+ *
+ * // List all options
+ * let opt = null;
+ * while ((opt = Option.next(obj, opt))) {
+ *   console.log(`${opt.name}: ${opt.help}`);
+ * }
+ * ```
+ *
+ * @see [AVOption API](https://ffmpeg.org/doxygen/trunk/group__avoptions.html) - FFmpeg Doxygen
+ * @see {@link OptionMember} For inherited option support
+ */
+export class Option {
+    /**
+     * Iterate to next option.
+     *
+     * Iterates through available options on an object.
+     *
+     * 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
+     * ```typescript
+     * let opt = null;
+     * while ((opt = Option.next(obj, opt))) {
+     *   console.log(`Option: ${opt.name}`);
+     * }
+     * ```
+     */
+    static next(obj, prev = null) {
+        const result = bindings.Option.next(obj, prev?.getNative());
+        return result ? new OptionInfo(result) : null;
+    }
+    /**
+     * Find option by name.
+     *
+     * Searches for an option with the specified name.
+     *
+     * 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
+     * ```typescript
+     * const opt = Option.find(obj, 'bitrate');
+     * if (opt) {
+     *   console.log(`Found: ${opt.name}, Type: ${opt.type}`);
+     * }
+     * ```
+     */
+    static find(obj, name, searchFlags = AVFLAG_NONE) {
+        const result = bindings.Option.find(obj, name, searchFlags);
+        return result ? new OptionInfo(result) : null;
+    }
+    /**
+     * Find option with target info.
+     *
+     * Like find() but also indicates if option was found on different target.
+     *
+     * 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
+     * ```typescript
+     * const result = Option.find2(obj, 'bitrate', AV_OPT_SEARCH_CHILDREN);
+     * if (result?.option) {
+     *   console.log(`Found on ${result.isDifferentTarget ? 'child' : 'object'}`);
+     * }
+     * ```
+     */
+    static find2(obj, name, searchFlags = AVFLAG_NONE) {
+        const result = bindings.Option.find2(obj, name, searchFlags);
+        if (!result)
+            return null;
+        return {
+            option: result.option ? new OptionInfo(result.option) : null,
+            isDifferentTarget: result.isDifferentTarget,
+        };
+    }
+    /**
+     * Get string option value.
+     *
+     * 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
+     * ```typescript
+     * // Get codec preset option
+     * const preset = Option.get(codecContext, 'preset', AV_OPT_SEARCH_CHILDREN);
+     * console.log('Codec preset:', preset); // 'medium', 'fast', etc.
+     * ```
+     */
+    static get(obj, name, searchFlags = AVFLAG_NONE) {
+        return bindings.Option.get(obj, name, searchFlags);
+    }
+    /**
+     * Get integer option value.
+     *
+     * 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
+     * ```typescript
+     * // Get codec GOP size
+     * const gopSize = Option.getInt(codecContext, 'g', AV_OPT_SEARCH_CHILDREN);
+     * console.log('GOP size:', gopSize); // 60, 120, etc.
+     * ```
+     */
+    static getInt(obj, name, searchFlags = AVFLAG_NONE) {
+        return bindings.Option.getInt(obj, name, searchFlags);
+    }
+    /**
+     * Get 64-bit integer option value.
+     *
+     * Returns a bigint to keep full int64 precision - getInt goes through a
+     * double and truncates values above 2^53.
+     *
+     * Direct mapping to av_opt_get_int().
+     *
+     * @param obj - Object to query
+     *
+     * @param name - Option name
+     *
+     * @param searchFlags - Search flags
+     *
+     * @returns Option value as bigint, or null
+     *
+     * @example
+     * ```typescript
+     * // Get maximum interleave delta
+     * const delta = Option.getInt64(formatContext, 'max_interleave_delta', AV_OPT_SEARCH_CHILDREN);
+     * console.log('Max interleave delta:', delta); // 10000000n
+     * ```
+     *
+     * @see {@link getInt} For 32-bit safe integer options
+     */
+    static getInt64(obj, name, searchFlags = AVFLAG_NONE) {
+        return bindings.Option.getInt64(obj, name, searchFlags);
+    }
+    /**
+     * Get double option value.
+     *
+     * 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
+     * ```typescript
+     * // Get codec quality scale
+     * const crf = Option.getDouble(codecContext, 'crf', AV_OPT_SEARCH_CHILDREN);
+     * console.log('CRF value:', crf); // 23.0, 18.0, etc.
+     * ```
+     */
+    static getDouble(obj, name, searchFlags = AVFLAG_NONE) {
+        return bindings.Option.getDouble(obj, name, searchFlags);
+    }
+    /**
+     * Get rational option value.
+     *
+     * 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
+     * ```typescript
+     * // Get codec time base
+     * const timeBase = Option.getRational(codecContext, 'time_base', AV_OPT_SEARCH_CHILDREN);
+     * console.log('Time base:', timeBase); // { num: 1, den: 30 }
+     * ```
+     */
+    static getRational(obj, name, searchFlags = AVFLAG_NONE) {
+        return bindings.Option.getRational(obj, name, searchFlags);
+    }
+    /**
+     * Get pixel format option value.
+     *
+     * 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
+     * ```typescript
+     * // Get filter pixel format
+     * const pixFmt = Option.getPixelFormat(filterContext, 'pix_fmt', AV_OPT_SEARCH_CHILDREN);
+     * console.log('Pixel format:', pixFmt); // AV_PIX_FMT_YUV420P, etc.
+     * ```
+     */
+    static getPixelFormat(obj, name, searchFlags = AVFLAG_NONE) {
+        return bindings.Option.getPixelFormat(obj, name, searchFlags);
+    }
+    /**
+     * Get sample format option value.
+     *
+     * 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
+     * ```typescript
+     * // Get audio codec sample format
+     * const sampleFmt = Option.getSampleFormat(codecContext, 'sample_fmt', AV_OPT_SEARCH_CHILDREN);
+     * console.log('Sample format:', sampleFmt); // AV_SAMPLE_FMT_FLTP, etc.
+     * ```
+     */
+    static getSampleFormat(obj, name, searchFlags = AVFLAG_NONE) {
+        return bindings.Option.getSampleFormat(obj, name, searchFlags);
+    }
+    /**
+     * Get image size option value.
+     *
+     * 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
+     * ```typescript
+     * // Get filter output size
+     * const size = Option.getImageSize(filterContext, 'size', AV_OPT_SEARCH_CHILDREN);
+     * console.log('Output size:', size); // { width: 1920, height: 1080 }
+     * ```
+     */
+    static getImageSize(obj, name, searchFlags = AVFLAG_NONE) {
+        return bindings.Option.getImageSize(obj, name, searchFlags);
+    }
+    /**
+     * Get channel layout option value.
+     *
+     * 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
+     * ```typescript
+     * // Get audio channel layout
+     * const layout = Option.getChannelLayout(codecContext, 'channel_layout', AV_OPT_SEARCH_CHILDREN);
+     * console.log('Channel layout:', layout); // stereo, 5.1, etc.
+     * ```
+     */
+    static getChannelLayout(obj, name, searchFlags = AVFLAG_NONE) {
+        return bindings.Option.getChannelLayout(obj, name, searchFlags);
+    }
+    /**
+     * Get dictionary option value.
+     *
+     * 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
+     * ```typescript
+     * // Get metadata dictionary
+     * const metadata = Option.getDict(formatContext, 'metadata', AV_OPT_SEARCH_CHILDREN);
+     * console.log('Metadata:', metadata?.get('title'));
+     * ```
+     */
+    static getDict(obj, name, searchFlags = AVFLAG_NONE) {
+        const native = bindings.Option.getDict(obj, name, searchFlags);
+        return native ? Dictionary.fromNative(native) : null;
+    }
+    /**
+     * Set string option value.
+     *
+     * 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
+     * ```typescript
+     * // Set codec preset
+     * const ret = Option.set(codecContext, 'preset', 'fast', AV_OPT_SEARCH_CHILDREN);
+     * FFmpegError.throwIfError(ret, 'Failed to set preset');
+     * ```
+     */
+    static set(obj, name, value, searchFlags = AVFLAG_NONE) {
+        return bindings.Option.set(obj, name, value, searchFlags);
+    }
+    /**
+     * Set integer option value.
+     *
+     * 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
+     * ```typescript
+     * // Set codec bitrate
+     * const ret = Option.setInt(codecContext, 'b', 2000000, AV_OPT_SEARCH_CHILDREN);
+     * FFmpegError.throwIfError(ret, 'Failed to set bitrate');
+     * ```
+     */
+    static setInt(obj, name, value, searchFlags = AVFLAG_NONE) {
+        return bindings.Option.setInt(obj, name, value, searchFlags);
+    }
+    /**
+     * Set double option value.
+     *
+     * 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
+     * ```typescript
+     * // Set codec CRF value
+     * const ret = Option.setDouble(codecContext, 'crf', 23.0, AV_OPT_SEARCH_CHILDREN);
+     * FFmpegError.throwIfError(ret, 'Failed to set CRF');
+     * ```
+     */
+    static setDouble(obj, name, value, searchFlags = AVFLAG_NONE) {
+        return bindings.Option.setDouble(obj, name, value, searchFlags);
+    }
+    /**
+     * Set rational option value.
+     *
+     * 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
+     * ```typescript
+     * // Set codec frame rate
+     * const ret = Option.setRational(codecContext, 'framerate', { num: 30, den: 1 }, AV_OPT_SEARCH_CHILDREN);
+     * FFmpegError.throwIfError(ret, 'Failed to set framerate');
+     * ```
+     */
+    static setRational(obj, name, value, searchFlags = AVFLAG_NONE) {
+        return bindings.Option.setRational(obj, name, value, searchFlags);
+    }
+    /**
+     * Set pixel format option value.
+     *
+     * 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
+     * ```typescript
+     * // Set filter pixel format
+     * const ret = Option.setPixelFormat(filterContext, 'pix_fmt', AV_PIX_FMT_YUV420P, AV_OPT_SEARCH_CHILDREN);
+     * FFmpegError.throwIfError(ret, 'Failed to set pixel format');
+     * ```
+     */
+    static setPixelFormat(obj, name, value, searchFlags = AVFLAG_NONE) {
+        return bindings.Option.setPixelFormat(obj, name, value, searchFlags);
+    }
+    /**
+     * Set sample format option value.
+     *
+     * 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
+     * ```typescript
+     * // Set audio codec sample format
+     * const ret = Option.setSampleFormat(codecContext, 'sample_fmt', AV_SAMPLE_FMT_FLTP, AV_OPT_SEARCH_CHILDREN);
+     * FFmpegError.throwIfError(ret, 'Failed to set sample format');
+     * ```
+     */
+    static setSampleFormat(obj, name, value, searchFlags = AVFLAG_NONE) {
+        return bindings.Option.setSampleFormat(obj, name, value, searchFlags);
+    }
+    /**
+     * Set image size option value.
+     *
+     * 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
+     * ```typescript
+     * // Set filter output size
+     * const ret = Option.setImageSize(filterContext, 'size', 1920, 1080, AV_OPT_SEARCH_CHILDREN);
+     * FFmpegError.throwIfError(ret, 'Failed to set image size');
+     * ```
+     */
+    static setImageSize(obj, name, width, height, searchFlags = AVFLAG_NONE) {
+        return bindings.Option.setImageSize(obj, name, width, height, searchFlags);
+    }
+    /**
+     * Set channel layout option value.
+     *
+     * 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
+     * ```typescript
+     * // Set audio channel layout to stereo
+     * const ret = Option.setChannelLayout(codecContext, 'channel_layout', AV_CHANNEL_LAYOUT_STEREO, AV_OPT_SEARCH_CHILDREN);
+     * FFmpegError.throwIfError(ret, 'Failed to set channel layout');
+     * ```
+     */
+    static setChannelLayout(obj, name, value, searchFlags = AVFLAG_NONE) {
+        return bindings.Option.setChannelLayout(obj, name, value, searchFlags);
+    }
+    /**
+     * Set dictionary option value.
+     *
+     * 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
+     * ```typescript
+     * // Set metadata dictionary
+     * const dict = new Dictionary();
+     * dict.set('title', 'My Video');
+     * const ret = Option.setDict(formatContext, 'metadata', dict, AV_OPT_SEARCH_CHILDREN);
+     * FFmpegError.throwIfError(ret, 'Failed to set metadata');
+     * ```
+     */
+    static setDict(obj, name, value, searchFlags = AVFLAG_NONE) {
+        return bindings.Option.setDict(obj, name, value.getNative(), searchFlags);
+    }
+    /**
+     * Set binary option value.
+     *
+     * 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
+     * ```typescript
+     * // Set binary extradata
+     * const extradata = Buffer.from([0x00, 0x01, 0x02, 0x03]);
+     * const ret = Option.setBin(codecContext, 'extradata', extradata, AV_OPT_SEARCH_CHILDREN);
+     * FFmpegError.throwIfError(ret, 'Failed to set extradata');
+     * ```
+     */
+    static setBin(obj, name, value, searchFlags = AVFLAG_NONE) {
+        return bindings.Option.setBin(obj, name, value, searchFlags);
+    }
+    /**
+     * Set defaults on object.
+     *
+     * Sets all options to their default values.
+     *
+     * Direct mapping to av_opt_set_defaults().
+     *
+     * @param obj - Object to reset
+     *
+     * @example
+     * ```typescript
+     * // Reset all codec options to defaults
+     * Option.setDefaults(codecContext);
+     * ```
+     */
+    static setDefaults(obj) {
+        bindings.Option.setDefaults(obj);
+    }
+    /**
+     * Copy options between objects.
+     *
+     * Copies option values from source to destination.
+     *
+     * Direct mapping to av_opt_copy().
+     *
+     * @param dest - Destination object
+     *
+     * @param src - Source object
+     *
+     * @returns 0 on success, negative AVERROR on error
+     *
+     * @example
+     * ```typescript
+     * // Copy options from one codec context to another
+     * const ret = Option.copy(destCodecContext, srcCodecContext);
+     * FFmpegError.throwIfError(ret, 'Failed to copy options');
+     * ```
+     */
+    static copy(dest, src) {
+        return bindings.Option.copy(dest, src);
+    }
+    /**
+     * Check if option is set to default.
+     *
+     * 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
+     * ```typescript
+     * // Check if bitrate is at default value
+     * const isDefault = Option.isSetToDefault(codecContext, 'b', AV_OPT_SEARCH_CHILDREN);
+     * console.log('Bitrate is default:', isDefault);
+     * ```
+     */
+    static isSetToDefault(obj, name, searchFlags = AVFLAG_NONE) {
+        return bindings.Option.isSetToDefault(obj, name, searchFlags);
+    }
+    /**
+     * Serialize options to string.
+     *
+     * 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
+     * ```typescript
+     * // Serialize codec options to string
+     * const serialized = Option.serialize(codecContext, 0, 0, '=', ':');
+     * console.log('Options:', serialized); // 'bitrate=2000000:preset=fast'
+     * ```
+     */
+    static serialize(obj, optFlags = 0, flags = 0, keyValSep = '=', pairsSep = ',') {
+        return bindings.Option.serialize(obj, optFlags, flags, keyValSep, pairsSep);
+    }
+    /**
+     * Free option resources.
+     *
+     * Direct mapping to av_opt_free().
+     *
+     * @param obj - Object to free options from
+     *
+     * @example
+     * ```typescript
+     * // Free codec context options
+     * Option.free(codecContext);
+     * ```
+     */
+    static free(obj) {
+        bindings.Option.free(obj);
+    }
+    /**
+     * Show options for debugging.
+     *
+     * 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
+     * ```typescript
+     * // Show all codec options for debugging
+     * const ret = Option.show(codecContext, 0, 0);
+     * FFmpegError.throwIfError(ret, 'Failed to show options');
+     * ```
+     */
+    static show(obj, reqFlags = 0, rejFlags = 0) {
+        return bindings.Option.show(obj, reqFlags, rejFlags);
+    }
+}
+/**
+ * Base class for FFmpeg objects that support AVOptions.
+ *
+ * Provides a common interface for getting, setting, and listing options
+ * on FFmpeg objects that have an AVClass structure. This includes codecs,
+ * formats, filters, and various processing contexts.
+ *
+ * Classes that support AVOptions should extend this class to inherit
+ * the option management functionality.
+ *
+ * @template T - The native FFmpeg object type that supports AVOptions
+ *
+ * @example
+ * ```typescript
+ * import { OptionMember, FFmpegError } from 'node-av';
+ * import { AV_OPT_TYPE_INT, AV_OPT_TYPE_STRING, AV_OPT_TYPE_RATIONAL } from 'node-av/constants';
+ *
+ * class CodecContext extends OptionMember<NativeCodecContext> {
+ *   constructor(native: NativeCodecContext) {
+ *     super(native);
+ *   }
+ * }
+ *
+ * // Use inherited methods
+ * const codec = new CodecContext(native);
+ *
+ * // Set options with automatic type handling
+ * let ret = codec.setOption('preset', 'fast');
+ * FFmpegError.throwIfError(ret, 'set preset');
+ *
+ * ret = codec.setOption('bitrate', 2000000, AV_OPT_TYPE_INT);
+ * FFmpegError.throwIfError(ret, 'set bitrate');
+ *
+ * ret = codec.setOption('framerate', { num: 30, den: 1 }, AV_OPT_TYPE_RATIONAL);
+ * FFmpegError.throwIfError(ret, 'set framerate');
+ *
+ * // Get typed options
+ * const preset = codec.getOption('preset');
+ * const bitrate = codec.getOption('bitrate', AV_OPT_TYPE_INT);
+ * const framerate = codec.getOption('framerate', AV_OPT_TYPE_RATIONAL);
+ *
+ * // List all available options
+ * const options = codec.listOptions();
+ * for (const opt of options) {
+ *   console.log(`${opt.name}: ${opt.help}`);
+ * }
+ * ```
+ *
+ * @see {@link Option} For static option methods
+ * @see {@link OptionInfo} For option metadata
+ */
+export class OptionMember {
+    native;
+    constructor(native) {
+        this.native = native;
+    }
+    /**
+     * Set an option on this object.
+     *
+     * Uses the AVOption API to set options.
+     * Available options depend on the specific object type.
+     *
+     * Direct mapping to av_opt_set* functions.
+     *
+     * @param name - Option name
+     *
+     * @param value - Option value
+     *
+     * @param type - Option type; when omitted, the option's declared type is
+     *   looked up via av_opt_find and the value converted accordingly
+     *
+     * @param searchFlags - Search flags (default: AV_OPT_SEARCH_CHILDREN)
+     *
+     * @returns 0 on success, negative AVERROR on error:
+     *   - AVERROR_ENOENT: Option not found
+     *   - AVERROR_ERANGE: Value out of range
+     *   - AVERROR_EINVAL: Invalid value
+     *
+     * @example
+     * ```typescript
+     * import { FFmpegError } from 'node-av';
+     * import { AV_OPT_TYPE_STRING, AV_OPT_TYPE_INT64, AV_OPT_TYPE_RATIONAL, AV_OPT_TYPE_PIXEL_FMT } from 'node-av/constants';
+     *
+     * // Untyped - the option's declared type is inferred
+     * let ret = obj.setOption('preset', 'fast');
+     * FFmpegError.throwIfError(ret, 'set preset');
+     *
+     * ret = obj.setOption('codec', 'h264', AV_OPT_TYPE_STRING);
+     * FFmpegError.throwIfError(ret, 'set codec');
+     *
+     * // Integer options
+     * ret = obj.setOption('bitrate', 2000000, AV_OPT_TYPE_INT64);
+     * FFmpegError.throwIfError(ret, 'set bitrate');
+     *
+     * ret = obj.setOption('threads', 4, AV_OPT_TYPE_INT);
+     * FFmpegError.throwIfError(ret, 'set threads');
+     *
+     * // Complex types with proper types
+     * ret = obj.setOption('framerate', {num: 30, den: 1}, AV_OPT_TYPE_RATIONAL);
+     * FFmpegError.throwIfError(ret, 'set framerate');
+     *
+     * ret = obj.setOption('pix_fmt', AV_PIX_FMT_YUV420P, AV_OPT_TYPE_PIXEL_FMT);
+     * FFmpegError.throwIfError(ret, 'set pixel format');
+     * ```
+     */
+    setOption(name, value, type, searchFlags = AV_OPT_SEARCH_CHILDREN) {
+        if (value === undefined || value === null) {
+            return 0;
+        }
+        // No explicit type: look up the option's declared type and convert the value
+        // (a default of AV_OPT_TYPE_STRING here would make this branch unreachable)
+        if (type === undefined) {
+            return this.setUnknownOption(name, value);
+        }
+        switch (type) {
+            case AV_OPT_TYPE_STRING:
+            case AV_OPT_TYPE_COLOR: // Colors are set as strings
+                return Option.set(this.native, name, String(value), searchFlags);
+            case AV_OPT_TYPE_INT:
+                const intVal = Number(value);
+                if (!Number.isInteger(intVal)) {
+                    throw new TypeError(`Option '${name}': Expected integer value, got ${value}`);
+                }
+                return Option.setInt(this.native, name, intVal, searchFlags);
+            case AV_OPT_TYPE_UINT:
+                const uintVal = Number(value);
+                if (!Number.isInteger(uintVal) || uintVal < 0) {
+                    throw new RangeError(`Option '${name}': Expected non-negative integer value, got ${value}`);
+                }
+                return Option.setInt(this.native, name, uintVal, searchFlags);
+            case AV_OPT_TYPE_FLAGS:
+            case AV_OPT_TYPE_DURATION:
+            case AV_OPT_TYPE_CONST:
+                return Option.setInt(this.native, name, Number(value), searchFlags);
+            case AV_OPT_TYPE_BOOL:
+                // Convert to 0 or 1 for FFmpeg
+                return Option.setInt(this.native, name, value ? 1 : 0, searchFlags);
+            case AV_OPT_TYPE_INT64:
+                // Accept both bigint and number
+                if (typeof value === 'bigint') {
+                    return Option.setInt(this.native, name, value, searchFlags);
+                }
+                else if (typeof value === 'number') {
+                    if (!Number.isInteger(value)) {
+                        throw new TypeError(`Option '${name}': Expected integer value for INT64, got ${value}`);
+                    }
+                    return Option.setInt(this.native, name, value, searchFlags);
+                }
+                else {
+                    throw new TypeError(`Option '${name}': Expected bigint or number for INT64, got ${typeof value}`);
+                }
+            case AV_OPT_TYPE_UINT64:
+                // Accept both bigint and number, but must be non-negative
+                if (typeof value === 'bigint') {
+                    if (value < 0n) {
+                        throw new RangeError(`Option '${name}': Expected non-negative value for UINT64, got ${value}`);
+                    }
+                    return Option.setInt(this.native, name, value, searchFlags);
+                }
+                else if (typeof value === 'number') {
+                    if (!Number.isInteger(value) || value < 0) {
+                        throw new RangeError(`Option '${name}': Expected non-negative integer for UINT64, got ${value}`);
+                    }
+                    return Option.setInt(this.native, name, value, searchFlags);
+                }
+                else {
+                    throw new TypeError(`Option '${name}': Expected bigint or number for UINT64, got ${typeof value}`);
+                }
+            case AV_OPT_TYPE_DOUBLE:
+            case AV_OPT_TYPE_FLOAT:
+                return Option.setDouble(this.native, name, Number(value), searchFlags);
+            case AV_OPT_TYPE_RATIONAL:
+            case AV_OPT_TYPE_VIDEO_RATE:
+                if (typeof value !== 'object' || !('num' in value) || !('den' in value)) {
+                    throw new TypeError(`Option '${name}': Expected Rational object with {num, den}, got ${JSON.stringify(value)}`);
+                }
+                if (value.den === 0) {
+                    throw new RangeError(`Option '${name}': Rational denominator cannot be zero`);
+                }
+                return Option.setRational(this.native, name, value, searchFlags);
+            case AV_OPT_TYPE_PIXEL_FMT:
+                const pixFmt = Number(value);
+                if (!Number.isInteger(pixFmt)) {
+                    throw new TypeError(`Option '${name}': Expected integer pixel format value, got ${value}`);
+                }
+                return Option.setPixelFormat(this.native, name, pixFmt, searchFlags);
+            case AV_OPT_TYPE_SAMPLE_FMT:
+                const sampleFmt = Number(value);
+                if (!Number.isInteger(sampleFmt)) {
+                    throw new TypeError(`Option '${name}': Expected integer sample format value, got ${value}`);
+                }
+                return Option.setSampleFormat(this.native, name, sampleFmt, searchFlags);
+            case AV_OPT_TYPE_IMAGE_SIZE:
+                // Expect value as {width, height}
+                if (typeof value === 'object' && 'width' in value && 'height' in value) {
+                    const width = Number(value.width);
+                    const height = Number(value.height);
+                    if (!Number.isInteger(width) || width <= 0) {
+                        throw new RangeError(`Option '${name}': Width must be a positive integer, got ${value.width}`);
+                    }
+                    if (!Number.isInteger(height) || height <= 0) {
+                        throw new RangeError(`Option '${name}': Height must be a positive integer, got ${value.height}`);
+                    }
+                    return Option.setImageSize(this.native, name, width, height, searchFlags);
+                }
+                throw new TypeError(`Option '${name}': Expected object with {width, height}, got ${JSON.stringify(value)}`);
+            case AV_OPT_TYPE_CHLAYOUT:
+                return Option.setChannelLayout(this.native, name, Number(value), searchFlags);
+            case AV_OPT_TYPE_BINARY:
+                if (Buffer.isBuffer(value)) {
+                    return Option.setBin(this.native, name, value, searchFlags);
+                }
+                throw new Error('Invalid value for BINARY option: expected Buffer');
+            case AV_OPT_TYPE_BINARY_INT_ARRAY:
+                if (Array.isArray(value)) {
+                    // Convert array of integers to buffer
+                    const buffer = Buffer.allocUnsafe(value.length * 4);
+                    for (let i = 0; i < value.length; i++) {
+                        buffer.writeInt32LE(value[i], i * 4);
+                    }
+                    return Option.setBin(this.native, name, buffer, searchFlags);
+                }
+                throw new Error('Invalid value for BINARY_INT_ARRAY option: expected number[]');
+            case AV_OPT_TYPE_DICT:
+                if (value instanceof Dictionary) {
+                    return Option.setDict(this.native, name, value, searchFlags);
+                }
+                throw new Error('Invalid value for DICT option: expected Dictionary');
+            default:
+                // Fallback to string
+                return Option.set(this.native, name, String(value), searchFlags);
+        }
+    }
+    /**
+     * Get an option value from this object.
+     *
+     * Uses the AVOption API to retrieve options.
+     *
+     * Direct mapping to av_opt_get* functions.
+     *
+     * @param name - Option name
+     *
+     * @param type - Option type (defaults to AV_OPT_TYPE_STRING)
+     *
+     * @param searchFlags - Search flags (default: AV_OPT_SEARCH_CHILDREN)
+     *
+     * @returns Option value (type depends on type parameter), or null if not found
+     *
+     * @example
+     * ```typescript
+     * import { AV_OPT_TYPE_STRING, AV_OPT_TYPE_RATIONAL, AV_OPT_TYPE_PIXEL_FMT, AV_OPT_TYPE_INT64 } from 'node-av/constants';
+     *
+     * // String options (default)
+     * const preset = obj.getOption('preset');
+     * const codec = obj.getOption('codec', AV_OPT_TYPE_STRING);
+     *
+     * // Typed options
+     * const framerate = obj.getOption('framerate', AV_OPT_TYPE_RATIONAL); // Returns {num, den}
+     * const pixFmt = obj.getOption('pix_fmt', AV_OPT_TYPE_PIXEL_FMT); // Returns AVPixelFormat
+     * const bitrate = obj.getOption('bitrate', AV_OPT_TYPE_INT64); // Returns bigint
+     * ```
+     */
+    getOption(name, type = AV_OPT_TYPE_STRING, searchFlags = AV_OPT_SEARCH_CHILDREN) {
+        // Use specific getter based on type
+        switch (type) {
+            case AV_OPT_TYPE_STRING:
+            case AV_OPT_TYPE_COLOR:
+                return Option.get(this.native, name, searchFlags);
+            case AV_OPT_TYPE_INT:
+            case AV_OPT_TYPE_UINT:
+            case AV_OPT_TYPE_FLAGS:
+            case AV_OPT_TYPE_DURATION:
+            case AV_OPT_TYPE_CONST:
+                return Option.getInt(this.native, name, searchFlags);
+            case AV_OPT_TYPE_INT64:
+            case AV_OPT_TYPE_UINT64:
+                // getInt64 returns bigint natively - getInt would truncate above 2^53
+                return Option.getInt64(this.native, name, searchFlags);
+            case AV_OPT_TYPE_BOOL:
+                const val = Option.getInt(this.native, name, searchFlags);
+                return val !== null ? Boolean(val) : null;
+            case AV_OPT_TYPE_DOUBLE:
+            case AV_OPT_TYPE_FLOAT:
+                return Option.getDouble(this.native, name, searchFlags);
+            case AV_OPT_TYPE_RATIONAL:
+            case AV_OPT_TYPE_VIDEO_RATE:
+                const rational = Option.getRational(this.native, name, searchFlags);
+                return rational ? new Rational(rational.num, rational.den) : null;
+            case AV_OPT_TYPE_PIXEL_FMT:
+                return Option.getPixelFormat(this.native, name, searchFlags);
+            case AV_OPT_TYPE_SAMPLE_FMT:
+                return Option.getSampleFormat(this.native, name, searchFlags);
+            case AV_OPT_TYPE_IMAGE_SIZE:
+                return Option.getImageSize(this.native, name, searchFlags);
+            case AV_OPT_TYPE_CHLAYOUT:
+                return Option.getChannelLayout(this.native, name, searchFlags);
+            case AV_OPT_TYPE_DICT:
+                return Option.getDict(this.native, name, searchFlags);
+            case AV_OPT_TYPE_BINARY:
+                // Binary data can only be retrieved as string
+                return Option.get(this.native, name, searchFlags);
+            case AV_OPT_TYPE_BINARY_INT_ARRAY:
+                // Getting binary int arrays is not supported (requires av_opt_get_bin())
+                // These are typically write-only options like 'pix_fmts' in buffersink
+                throw new Error('Getting BINARY_INT_ARRAY options is not supported. These are typically write-only options.');
+            default:
+                // Fallback to string
+                return Option.get(this.native, name, searchFlags);
+        }
+    }
+    /**
+     * List all available options for this object.
+     *
+     * Uses the AVOption API to enumerate all options.
+     * Useful for discovering available settings and their types.
+     *
+     * Direct mapping to av_opt_next() iteration.
+     *
+     * @returns Array of option information objects
+     *
+     * @example
+     * ```typescript
+     * const options = obj.listOptions();
+     * for (const opt of options) {
+     *   console.log(`${opt.name}: ${opt.help}`);
+     *   console.log(`  Type: ${opt.type}, Default: ${opt.defaultValue}`);
+     *   console.log(`  Range: ${opt.min} - ${opt.max}`);
+     * }
+     * ```
+     *
+     * @see {@link OptionInfo} For option metadata structure
+     */
+    listOptions() {
+        const options = [];
+        let opt = null;
+        while ((opt = Option.next(this.native, opt))) {
+            options.push(opt);
+        }
+        return options;
+    }
+    /**
+     * Intelligently set a format option based on its FFmpeg type.
+     *
+     * Queries the option type using av_opt_find() and calls the appropriate
+     * typed setOption() overload. Handles automatic type conversion from
+     * JavaScript types to FFmpeg option types.
+     *
+     * @param name - Option name
+     *
+     * @param value - Option value (null/undefined are skipped)
+     *
+     * @returns 0 on success, negative on error
+     *
+     * @internal
+     */
+    setUnknownOption(name, value) {
+        if (value === undefined || value === null) {
+            return 0;
+        }
+        // Strings always go through av_opt_set: FFmpeg parses them for every option
+        // type (flag names like '+frag_keyframe', named constants, rationals) -
+        // per-type conversion like parseInt would silently mangle them
+        if (typeof value === 'string') {
+            return this.setOption(name, value, AV_OPT_TYPE_STRING);
+        }
+        // Try to find the option to get its type
+        const optInfo = Option.find(this.native, name, AV_OPT_SEARCH_CHILDREN);
+        if (optInfo) {
+            const optType = optInfo.type;
+            // Handle based on FFmpeg option type
+            switch (optType) {
+                case AV_OPT_TYPE_INT:
+                    if (typeof value === 'number') {
+                        return this.setOption(name, value, AV_OPT_TYPE_INT);
+                    }
+                    else if (typeof value === 'boolean') {
+                        return this.setOption(name, value ? 1 : 0, AV_OPT_TYPE_INT);
+                    }
+                    else if (typeof value === 'bigint') {
+                        return this.setOption(name, Number(value), AV_OPT_TYPE_INT);
+                    }
+                    else if (typeof value === 'string') {
+                        return this.setOption(name, parseInt(value, 10), AV_OPT_TYPE_INT);
+                    }
+                    else {
+                        return FFmpegError.AVERROR(PosixError.EINVAL);
+                    }
+                case AV_OPT_TYPE_UINT:
+                    if (typeof value === 'number') {
+                        return this.setOption(name, value, AV_OPT_TYPE_UINT);
+                    }
+                    else if (typeof value === 'boolean') {
+                        return this.setOption(name, value ? 1 : 0, AV_OPT_TYPE_UINT);
+                    }
+                    else if (typeof value === 'bigint') {
+                        return this.setOption(name, Number(value), AV_OPT_TYPE_UINT);
+                    }
+                    else if (typeof value === 'string') {
+                        return this.setOption(name, parseInt(value, 10), AV_OPT_TYPE_UINT);
+                    }
+                    else {
+                        return FFmpegError.AVERROR(PosixError.EINVAL);
+                    }
+                case AV_OPT_TYPE_FLAGS:
+                    if (typeof value === 'number') {
+                        return this.setOption(name, value, AV_OPT_TYPE_FLAGS);
+                    }
+                    else if (typeof value === 'boolean') {
+                        return this.setOption(name, value ? 1 : 0, AV_OPT_TYPE_FLAGS);
+                    }
+                    else if (typeof value === 'bigint') {
+                        return this.setOption(name, Number(value), AV_OPT_TYPE_FLAGS);
+                    }
+                    else if (typeof value === 'string') {
+                        return this.setOption(name, parseInt(value, 10), AV_OPT_TYPE_FLAGS);
+                    }
+                    else {
+                        return FFmpegError.AVERROR(PosixError.EINVAL);
+                    }
+                case AV_OPT_TYPE_CONST:
+                    if (typeof value === 'number') {
+                        return this.setOption(name, value, AV_OPT_TYPE_CONST);
+                    }
+                    else if (typeof value === 'boolean') {
+                        return this.setOption(name, value ? 1 : 0, AV_OPT_TYPE_CONST);
+                    }
+                    else if (typeof value === 'bigint') {
+                        return this.setOption(name, Number(value), AV_OPT_TYPE_CONST);
+                    }
+                    else if (typeof value === 'string') {
+                        return this.setOption(name, parseInt(value, 10), AV_OPT_TYPE_CONST);
+                    }
+                    else {
+                        return FFmpegError.AVERROR(PosixError.EINVAL);
+                    }
+                case AV_OPT_TYPE_DURATION:
+                    if (typeof value === 'number') {
+                        return this.setOption(name, value, AV_OPT_TYPE_DURATION);
+                    }
+                    else if (typeof value === 'boolean') {
+                        return this.setOption(name, value ? 1 : 0, AV_OPT_TYPE_DURATION);
+                    }
+                    else if (typeof value === 'bigint') {
+                        return this.setOption(name, Number(value), AV_OPT_TYPE_DURATION);
+                    }
+                    else if (typeof value === 'string') {
+                        return this.setOption(name, parseInt(value, 10), AV_OPT_TYPE_DURATION);
+                    }
+                    else {
+                        return FFmpegError.AVERROR(PosixError.EINVAL);
+                    }
+                case AV_OPT_TYPE_INT64:
+                    if (typeof value === 'bigint') {
+                        return this.setOption(name, value, AV_OPT_TYPE_INT64);
+                    }
+                    else if (typeof value === 'number') {
+                        return this.setOption(name, BigInt(value), AV_OPT_TYPE_INT64);
+                    }
+                    else if (typeof value === 'boolean') {
+                        return this.setOption(name, value ? 1n : 0n, AV_OPT_TYPE_INT64);
+                    }
+                    else if (typeof value === 'string') {
+                        return this.setOption(name, BigInt(value), AV_OPT_TYPE_INT64);
+                    }
+                    else {
+                        return FFmpegError.AVERROR(PosixError.EINVAL);
+                    }
+                case AV_OPT_TYPE_UINT64:
+                    if (typeof value === 'bigint') {
+                        return this.setOption(name, value, AV_OPT_TYPE_UINT64);
+                    }
+                    else if (typeof value === 'number') {
+                        return this.setOption(name, BigInt(value), AV_OPT_TYPE_UINT64);
+                    }
+                    else if (typeof value === 'boolean') {
+                        return this.setOption(name, value ? 1n : 0n, AV_OPT_TYPE_UINT64);
+                    }
+                    else if (typeof value === 'string') {
+                        return this.setOption(name, BigInt(value), AV_OPT_TYPE_UINT64);
+                    }
+                    else {
+                        return FFmpegError.AVERROR(PosixError.EINVAL);
+                    }
+                case AV_OPT_TYPE_CHLAYOUT:
+                    if (typeof value === 'bigint') {
+                        return this.setOption(name, value, AV_OPT_TYPE_CHLAYOUT);
+                    }
+                    else if (typeof value === 'number') {
+                        return this.setOption(name, BigInt(value), AV_OPT_TYPE_CHLAYOUT);
+                    }
+                    else if (typeof value === 'boolean') {
+                        return this.setOption(name, value ? 1n : 0n, AV_OPT_TYPE_CHLAYOUT);
+                    }
+                    else if (typeof value === 'string') {
+                        return this.setOption(name, BigInt(value), AV_OPT_TYPE_CHLAYOUT);
+                    }
+                    else {
+                        return FFmpegError.AVERROR(PosixError.EINVAL);
+                    }
+                case AV_OPT_TYPE_FLOAT:
+                    if (typeof value === 'number') {
+                        return this.setOption(name, value, AV_OPT_TYPE_FLOAT);
+                    }
+                    else if (typeof value === 'boolean') {
+                        return this.setOption(name, value ? 1.0 : 0.0, AV_OPT_TYPE_FLOAT);
+                    }
+                    else if (typeof value === 'bigint') {
+                        return this.setOption(name, Number(value), AV_OPT_TYPE_FLOAT);
+                    }
+                    else if (typeof value === 'string') {
+                        return this.setOption(name, parseFloat(value), AV_OPT_TYPE_FLOAT);
+                    }
+                    else {
+                        return FFmpegError.AVERROR(PosixError.EINVAL);
+                    }
+                case AV_OPT_TYPE_DOUBLE:
+                    if (typeof value === 'number') {
+                        return this.setOption(name, value, AV_OPT_TYPE_DOUBLE);
+                    }
+                    else if (typeof value === 'boolean') {
+                        return this.setOption(name, value ? 1.0 : 0.0, AV_OPT_TYPE_DOUBLE);
+                    }
+                    else if (typeof value === 'bigint') {
+                        return this.setOption(name, Number(value), AV_OPT_TYPE_DOUBLE);
+                    }
+                    else if (typeof value === 'string') {
+                        return this.setOption(name, parseFloat(value), AV_OPT_TYPE_DOUBLE);
+                    }
+                    else {
+                        return FFmpegError.AVERROR(PosixError.EINVAL);
+                    }
+                case AV_OPT_TYPE_BOOL:
+                    if (typeof value === 'boolean') {
+                        return this.setOption(name, value, AV_OPT_TYPE_BOOL);
+                    }
+                    else if (typeof value === 'number') {
+                        return this.setOption(name, value !== 0, AV_OPT_TYPE_BOOL);
+                    }
+                    else if (typeof value === 'bigint') {
+                        return this.setOption(name, value !== 0n, AV_OPT_TYPE_BOOL);
+                    }
+                    else {
+                        return FFmpegError.AVERROR(PosixError.EINVAL);
+                    }
+                case AV_OPT_TYPE_STRING:
+                    if (typeof value === 'string') {
+                        return this.setOption(name, value, AV_OPT_TYPE_STRING);
+                    }
+                    else if (typeof value === 'object') {
+                        return this.setOption(name, JSON.stringify(value), AV_OPT_TYPE_STRING);
+                    }
+                    else {
+                        return this.setOption(name, String(value), AV_OPT_TYPE_STRING);
+                    }
+                case AV_OPT_TYPE_COLOR:
+                    if (typeof value === 'string') {
+                        return this.setOption(name, value, AV_OPT_TYPE_COLOR);
+                    }
+                    else if (typeof value === 'object') {
+                        return this.setOption(name, JSON.stringify(value), AV_OPT_TYPE_COLOR);
+                    }
+                    else {
+                        return this.setOption(name, String(value), AV_OPT_TYPE_COLOR);
+                    }
+                case AV_OPT_TYPE_RATIONAL:
+                case AV_OPT_TYPE_VIDEO_RATE:
+                    if (typeof value === 'object' && 'num' in value && 'den' in value) {
+                        return this.setOption(name, value, AV_OPT_TYPE_RATIONAL);
+                    }
+                    else if (typeof value === 'string') {
+                        // Try to parse "30/1" or "30:1" format
+                        const match = /^(\d+)[/:](\d+)$/.exec(value);
+                        if (match) {
+                            return this.setOption(name, { num: parseInt(match[1], 10), den: parseInt(match[2], 10) }, AV_OPT_TYPE_RATIONAL);
+                        }
+                        // Fallback to string (let FFmpeg parse it)
+                        return this.setOption(name, value, AV_OPT_TYPE_STRING);
+                    }
+                    else {
+                        return FFmpegError.AVERROR(PosixError.EINVAL);
+                    }
+                // Image size type - handle all input types
+                case AV_OPT_TYPE_IMAGE_SIZE:
+                    if (typeof value === 'object' && 'width' in value && 'height' in value) {
+                        return this.setOption(name, value, AV_OPT_TYPE_IMAGE_SIZE);
+                    }
+                    else if (typeof value === 'string') {
+                        // Try to parse "1920x1080" format
+                        const match = /^(\d+)x(\d+)$/.exec(value);
+                        if (match) {
+                            return this.setOption(name, { width: parseInt(match[1], 10), height: parseInt(match[2], 10) }, AV_OPT_TYPE_IMAGE_SIZE);
+                        }
+                        // Fallback to string (let FFmpeg parse it)
+                        return this.setOption(name, value, AV_OPT_TYPE_STRING);
+                    }
+                    else {
+                        return FFmpegError.AVERROR(PosixError.EINVAL);
+                    }
+                // Pixel/Sample format types - handle all input types
+                case AV_OPT_TYPE_PIXEL_FMT:
+                    if (typeof value === 'number') {
+                        return this.setOption(name, value, AV_OPT_TYPE_PIXEL_FMT);
+                    }
+                    else if (typeof value === 'bigint') {
+                        return this.setOption(name, Number(value), AV_OPT_TYPE_PIXEL_FMT);
+                    }
+                    else if (typeof value === 'string') {
+                        return this.setOption(name, avGetPixFmtFromName(value), AV_OPT_TYPE_PIXEL_FMT);
+                    }
+                    else {
+                        return FFmpegError.AVERROR(PosixError.EINVAL);
+                    }
+                case AV_OPT_TYPE_SAMPLE_FMT:
+                    if (typeof value === 'number') {
+                        return this.setOption(name, value, AV_OPT_TYPE_SAMPLE_FMT);
+                    }
+                    else if (typeof value === 'bigint') {
+                        return this.setOption(name, Number(value), AV_OPT_TYPE_SAMPLE_FMT);
+                    }
+                    else if (typeof value === 'string') {
+                        return this.setOption(name, avGetSampleFmtFromName(value), AV_OPT_TYPE_SAMPLE_FMT);
+                    }
+                    else {
+                        return FFmpegError.AVERROR(PosixError.EINVAL);
+                    }
+                // Binary type - handle all input types
+                case AV_OPT_TYPE_BINARY:
+                    if (Buffer.isBuffer(value)) {
+                        return this.setOption(name, value, AV_OPT_TYPE_BINARY);
+                    }
+                    else if (typeof value === 'string') {
+                        return this.setOption(name, Buffer.from(value), AV_OPT_TYPE_BINARY);
+                    }
+                    else {
+                        return FFmpegError.AVERROR(PosixError.EINVAL);
+                    }
+                // Binary int array type - handle all input types
+                case AV_OPT_TYPE_BINARY_INT_ARRAY:
+                    if (Array.isArray(value)) {
+                        // Convert all elements to numbers
+                        return this.setOption(name, value.map((v) => (typeof v === 'number' ? v : Number(v))), AV_OPT_TYPE_BINARY_INT_ARRAY);
+                    }
+                    else if (typeof value === 'number') {
+                        // Single number → single-element array
+                        return this.setOption(name, [value], AV_OPT_TYPE_BINARY_INT_ARRAY);
+                    }
+                    else if (typeof value === 'bigint') {
+                        // Single bigint → single-element array
+                        return this.setOption(name, [Number(value)], AV_OPT_TYPE_BINARY_INT_ARRAY);
+                    }
+                    else if (typeof value === 'boolean') {
+                        // Boolean → single-element array
+                        return this.setOption(name, [value ? 1 : 0], AV_OPT_TYPE_BINARY_INT_ARRAY);
+                    }
+                    else {
+                        return FFmpegError.AVERROR(PosixError.EINVAL);
+                    }
+                // Dictionary type - handle all input types
+                case AV_OPT_TYPE_DICT:
+                    if (value instanceof Dictionary) {
+                        return this.setOption(name, value, AV_OPT_TYPE_DICT);
+                    }
+                    else if (typeof value === 'object' && !Array.isArray(value)) {
+                        // Convert plain object to Dictionary
+                        const dict = Dictionary.fromObject(value);
+                        return this.setOption(name, dict, AV_OPT_TYPE_DICT);
+                    }
+                    else {
+                        return FFmpegError.AVERROR(PosixError.EINVAL);
+                    }
+                // Unknown type - fallback to string
+                default:
+                    if (typeof value === 'string') {
+                        return this.setOption(name, value, AV_OPT_TYPE_STRING);
+                    }
+                    else if (typeof value === 'object') {
+                        return this.setOption(name, JSON.stringify(value), AV_OPT_TYPE_STRING);
+                    }
+                    else {
+                        return this.setOption(name, String(value), AV_OPT_TYPE_STRING);
+                    }
+            }
+        }
+        else {
+            // Option not found - fallback to string (for private/undocumented options)
+            if (typeof value === 'string') {
+                return this.setOption(name, value, AV_OPT_TYPE_STRING);
+            }
+            else if (typeof value === 'object') {
+                return this.setOption(name, JSON.stringify(value), AV_OPT_TYPE_STRING);
+            }
+            else {
+                return this.setOption(name, String(value), AV_OPT_TYPE_STRING);
+            }
+        }
+    }
+}
+//# sourceMappingURL=option.js.map