Struct FlacWriter 

pub struct FlacWriter { /* private fields */ }

録音チャンクを逐次 FLAC ファイルへ書き出すライター。

interleaved f32（flexaudio の AudioChunk.data と同じ形）を write_chunk に流し、終わったら finalize でヘッダを確定する。エンコードは呼び出し スレッド上で同期的に行う。

finalize を呼ばずに drop した場合もベストエフォートで閉じる（端数の書き出しと ヘッダ確定を試み、エラーは握りつぶす）。確実に完結させたいときは finalize を 呼ぶこと。

Implementations

impl FlacWriter

pub fn create<P: AsRef<Path>>( path: P, sample_rate: u32, channels: u16, ) -> Result<FlacWriter>

path に 16bit FLAC ファイルを新規作成する（既存ファイルは上書き）。

対応範囲は channels 1..=2、sample_rate 1..=96,000 Hz。範囲外は EncodeError::Unsupported（ファイルは作られない）。

pub fn write_chunk(&mut self, interleaved: &[f32]) -> Result<()>

interleaved f32 サンプルを追記する。

長さは channels の倍数であること（flexaudio の AudioChunk.data は そのまま渡せる）。倍数でなければ EncodeError::Unsupported を返し、 何も書かない。ブロックに満たない端数は内部に持ち越し、次の呼び出しか finalize で書かれる。

pub fn finalize(self) -> Result<()>

端数フレームの書き出しとヘッダ確定を行い、ファイルを閉じる。

self を消費するので、以後の write_chunk は型で 不可能。Drop でも同じ処理をベストエフォートで行うが、書き込みエラーを 検知できるのはこちらだけなので finalize 推奨。

Trait Implementations

impl Debug for FlacWriter

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Drop for FlacWriter

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.