Exmpeg.Native (exmpeg v0.4.0)

Low-level Rustler bindings to the rsmpeg Rust crate.

This module is private to the library. Use Exmpeg for the public API. Stub names must match the Rust NIF symbols verbatim (Rustler verifies arity at module load time); friendlier wrappers live below them.

Summary

Types

input_source()

Input source as seen by the NIF: a filesystem path string, {:memory, binary}, or a loaded buffer resource reference.

Functions

concat(inputs, output, opts)

Stream-copy concatenation of multiple inputs into a single output.

extract_audio(input, output, opts)

Decodes the best audio stream and writes it as a 16-bit PCM WAV.

extract_frame(input, output, opts)

Decodes a single video frame at a timestamp and writes it as an image.

load_buffer(binary)

Copies a binary into a refcounted resource and returns its reference.

probe(source)

Probes a media file and returns format + per-stream metadata.

remux(input, output, opts)

Stream-copies an input container to an output container.

transcode(input, output, opts)

Per-stream re-encode with codec / bitrate / scale / fps selection.

version()

Reports the FFmpeg version + configure flags this NIF is linked against.

Types

input_source()

@type input_source() :: String.t() | {:memory, binary()} | reference()

Input source as seen by the NIF: a filesystem path string, {:memory, binary}, or a loaded buffer resource reference.

Functions

concat(inputs, output, opts)

@spec concat([input_source()], String.t(), map()) :: {:ok, map()} | {:error, map()}

Stream-copy concatenation of multiple inputs into a single output.

extract_audio(input, output, opts)

@spec extract_audio(input_source(), String.t(), map()) ::
  {:ok, map()} | {:error, map()}

Decodes the best audio stream and writes it as a 16-bit PCM WAV.

extract_frame(input, output, opts)

@spec extract_frame(input_source(), String.t(), map()) ::
  {:ok, map()} | {:error, map()}

Decodes a single video frame at a timestamp and writes it as an image.

load_buffer(binary)

@spec load_buffer(binary()) :: {:ok, reference()} | {:error, map()}

Copies a binary into a refcounted resource and returns its reference.

probe(source)

@spec probe(input_source()) :: {:ok, map()} | {:error, map()}

Probes a media file and returns format + per-stream metadata.

remux(input, output, opts)

@spec remux(input_source(), String.t(), map()) :: {:ok, map()} | {:error, map()}

Stream-copies an input container to an output container.

transcode(input, output, opts)

@spec transcode(input_source(), String.t(), map()) :: {:ok, map()} | {:error, map()}

Per-stream re-encode with codec / bitrate / scale / fps selection.

version()

@spec version() :: {:ok, map()} | {:error, map()}

Reports the FFmpeg version + configure flags this NIF is linked against.