bare-ffmpeg 1.0.0-26 → 1.0.0-28

package/README.md

@@ -407,6 +407,20 @@ Gets or sets the frame height for video codecs.
 
 **Returns**: `number`
 
+##### `CodecContext.frameSize`
+
+Gets the number of samples per channel in an audio frame.
+
+**Returns**: `number`
+
+##### `CodecContext.frameNum`
+
+When encoding this gets the total number of frames passed to the encoder so far.
+
+When decoding this gets the total number of frames returned from the decoder so far.
+
+**Returns**: `number`
+
 #### Methods
 
 ##### `CodecContext.open([options])`
@@ -459,6 +473,52 @@ Parameters:
 
 **Returns**: `boolean` indicating if a packet was received
 
+##### `CodecContext.getSupportedConfig(config)`
+
+Gets the supported values for a codec configuration option.
+
+Parameters:
+
+- `config` (`number`): The configuration type from `ffmpeg.constants.codecConfig`
+
+**Returns**:
+
+- For `PIX_FORMAT`, `SAMPLE_FORMAT`, `COLOR_RANGE`, `COLOR_SPACE`: `Int32Array` of supported values (all valid values are included if the codec has no restrictions)
+- For `SAMPLE_RATE`: `Int32Array` of supported sample rates or `null` if the codec accepts any valid sample rate
+- For `FRAME_RATE`: Array of `Rational` instances or `null` if the codec accepts any valid frame rate
+- For `CHANNEL_LAYOUT`: Array of `ChannelLayout` instances or `null` if the codec accepts any valid channel layout
+
+**Throws**: Error if the config type is not applicable to this codec (e.g., asking for pixel formats from an audio codec)
+
+Examples:
+
+```js
+const codecCtx = new ffmpeg.CodecContext(ffmpeg.Codec.AV1.encoder)
+
+const pixelFormats = codecCtx.getSupportedConfig(
+  ffmpeg.constants.codecConfig.PIX_FORMAT
+)
+if (pixelFormats) {
+  console.log('Supported pixel formats:', pixelFormats)
+}
+
+const frameRates = codecCtx.getSupportedConfig(
+  ffmpeg.constants.codecConfig.FRAME_RATE
+)
+if (frameRates) {
+  frameRates.forEach((rate) => {
+    console.log(`${rate.toNumber()} fps`)
+  })
+}
+
+const layouts = codecCtx.getSupportedConfig(
+  ffmpeg.constants.codecConfig.CHANNEL_LAYOUT
+)
+if (layouts) {
+  console.log('Supported channel layouts:', layouts)
+}
+```
+
 ##### `CodecContext.destroy()`
 
 Destroys the `CodecContext` and frees all associated resources. Automatically called when the object is managed by a `using` declaration.
@@ -638,6 +698,28 @@ Parameters:
 
 **Returns**: A new `InputFormat` instance
 
+#### Properties
+
+##### `InputFormat.extensions`
+
+Gets the file extensions associated with this input format.
+
+**Returns**: `string` - Comma-separated list of file extensions (e.g., `'mkv,mk3d,mka,mks,webm'`)
+
+##### `InputFormat.mimeType`
+
+Gets the MIME type for this input format.
+
+**Returns**: `string` - The MIME type (e.g., `'audio/webm,audio/x-matroska,video/webm,video/x-matroska'`)
+
+#### Example
+
+```js
+const format = new ffmpeg.InputFormat('webm')
+console.log(format.extensions) // 'mkv,mk3d,mka,mks,webm'
+console.log(format.mimeType) // 'audio/webm,audio/x-matroska,video/webm,video/x-matroska'
+```
+
 #### Methods
 
 ##### `InputFormat.destroy()`
@@ -660,6 +742,28 @@ Parameters:
 
 **Returns**: A new `OutputFormat` instance
 
+#### Properties
+
+##### `OutputFormat.extensions`
+
+Gets the file extensions associated with this output format.
+
+**Returns**: `string` - Comma-separated list of file extensions (e.g., `'webm'`, `'mp4,m4a,m4v'`)
+
+##### `OutputFormat.mimeType`
+
+Gets the MIME type for this output format.
+
+**Returns**: `string` - The MIME type (e.g., `'video/webm'`, `'video/mp4'`)
+
+#### Example
+
+```js
+const format = new ffmpeg.OutputFormat('webm')
+console.log(format.extensions) // 'webm'
+console.log(format.mimeType) // 'video/webm'
+```
+
 #### Methods
 
 ##### `OutputFormat.destroy()`
@@ -724,6 +828,25 @@ Destroys the `Frame` and frees all associated resources. Automatically called wh
 
 **Returns**: `void`
 
+##### `Frame.copyProperties(otherFrame)`
+
+Copies all metadata properties such as timestamps, timebase and width/height for videoframes and
+sampleRate channelLayout for audioFrames.
+
+see `av_frame_copy_props()` for details.
+
+```js
+const src = new ffmpeg.Frame()
+const dst = new ffmpeg.Frame()
+
+decoder.receiveFrame(src)
+rescaler.convert(src, dst)
+
+dst.copyProperties(src) // transfer all meta-data
+```
+
+**Returns**: `void`
+
 ### `Packet`
 
 This structure stores compressed data. It is typically exported by demuxers and then passed as input to decoders, or received as output from encoders and then passed to muxers.
@@ -1200,6 +1323,94 @@ Destroys the `Scaler` and frees all associated resources. Automatically called w
 
 **Returns**: `void`
 
+### `Filter`
+
+The `Filter` API provides access to FFmpeg filters by name.
+
+```js
+const filter = new ffmpeg.Filter(name)
+```
+
+Parameters:
+
+- `name` (`string`): The filter name (e.g., `'scale'`, `'buffer'`, `'overlay'`)
+
+**Returns**: A new `Filter` instance
+
+#### Example
+
+```js
+const filter = new ffmpeg.Filter('buffer')
+```
+
+### `FilterGraph`
+
+The `FilterGraph` API provides functionality to create and manage complex filter chains for audio and video processing.
+
+```js
+const graph = new ffmpeg.FilterGraph()
+```
+
+**Returns**: A new `FilterGraph` instance
+
+#### Methods
+
+##### `FilterGraph.createFilter(context, filter, name, args)`
+
+Creates a filter within the filter graph with the specified parameters.
+
+Parameters:
+
+- `context` (`FilterContext`): The filter context to associate with this filter
+- `filter` (`Filter`): The filter to create (e.g., `new ffmpeg.Filter('buffer')`)
+- `name` (`string`): A unique name for this filter instance
+- `args` (`object` | `undefined`): Filter-specific arguments
+  - `width` (`number`): Video width in pixels
+  - `height` (`number`): Video height in pixels
+  - `pixelFormat` (`number`): Pixel format constant
+  - `timeBase` (`Rational`): Time base for the filter
+  - `aspectRatio` (`Rational`): Pixel aspect ratio
+
+**Returns**: `void`
+
+```js
+using graph = new ffmpeg.FilterGraph()
+const context = new ffmpeg.FilterContext()
+const filter = new ffmpeg.Filter('buffer')
+
+graph.createFilter(context, filter, 'in', {
+  width: 1920,
+  height: 1080,
+  pixelFormat: ffmpeg.constants.pixelFormats.RGB24,
+  timeBase: new ffmpeg.Rational(1, 30),
+  aspectRatio: new ffmpeg.Rational(1, 1)
+})
+```
+
+##### `FilterGraph.parse(filterDescription, inputs, outputs)`
+
+Parses a filter description string and applies it to the filter graph.
+
+Parameters:
+
+- `filterDescription` (`string`): The filter description (e.g., `'negate'`, `'scale=640:480'`)
+- `inputs` (`FilterInOut`): Input filter endpoints
+- `outputs` (`FilterInOut`): Output filter endpoints
+
+**Returns**: `void`
+
+##### `FilterGraph.configure()`
+
+Configures the filter graph and validates all connections.
+
+**Returns**: `void`
+
+##### `FilterGraph.destroy()`
+
+Destroys the `FilterGraph` and frees all associated resources including any created filters. Automatically called when the object is managed by a `using` declaration.
+
+**Returns**: `void`
+
 ### `AudioFIFO`
 
 The `AudioFIFO` API provides a first in first out buffer for audio samples. This is useful for buffering audio data between different processing stages.
@@ -1292,6 +1503,84 @@ Destroys the `AudioFIFO` and frees all associated resources. Automatically calle
 
 **Returns**: `void`
 
+### `FilterInOut`
+
+The `FilterInOut` API provides functionality to represent input and output pads for FFmpeg filter graphs.
+
+```js
+const filterInOut = new ffmpeg.FilterInOut()
+```
+
+**Returns**: A new `FilterInOut` instance
+
+> **Note**: FilterInOut objects form a linked list structure in FFmpeg. When destroying a FilterInOut that has a `next` reference, the entire chain is automatically freed. Only destroy the head of the chain to avoid double-free errors.
+
+#### Properties
+
+##### `FilterInOut.name`
+
+Gets or sets the name identifier for this input/output pad.
+
+**Returns**: `string` or `undefined` if not set
+
+```js
+const filterInOut = new ffmpeg.FilterInOut()
+filterInOut.name = 'input'
+console.log(filterInOut.name) // 'input'
+```
+
+##### `FilterInOut.padIdx`
+
+Gets or sets the pad index within the filter context.
+
+**Returns**: `number`
+
+```js
+filterInOut.padIdx = 0
+console.log(filterInOut.padIdx) // 0
+```
+
+##### `FilterInOut.filterContext`
+
+Gets or sets the filter context associated with this input/output pad.
+
+**Returns**: `FilterContext` instance or `null` if not set
+
+> **Note**: FilterContext must be created through FilterGraph operations before it can be used effectively.
+
+##### `FilterInOut.next`
+
+Gets or sets the next FilterInOut in the linked list chain.
+
+**Returns**: `FilterInOut` instance or `null` if this is the last in the chain
+
+```js
+const input = new ffmpeg.FilterInOut()
+const output = new ffmpeg.FilterInOut()
+output.name = 'output'
+
+input.next = output
+console.log(input.next.name) // 'output'
+```
+
+#### Methods
+
+##### `FilterInOut.destroy()`
+
+Destroys the `FilterInOut` and frees all associated resources. **Important**: This automatically frees the entire linked list chain via FFmpeg's `avfilter_inout_free()`.
+
+**Returns**: `void`
+
+```js
+const head = new ffmpeg.FilterInOut()
+const next = new ffmpeg.FilterInOut()
+head.next = next
+
+// Only destroy the head - 'next' is automatically freed
+head.destroy()
+// DO NOT call next.destroy() - causes double-free error
+```
+
 ## License
 
 Apache-2.0