Docs

render の制約と運用上の注意

`render` を使うときの制約や、フォーマットごとの注意点をまとめたページです。

`render` の主な制約

--out と --out-dir は同時指定できません。
複数入力時に --out は使えません。--out-dir を使います。
--same-format と --format は同時指定できません。
--out 使用時は、出力形式を --format、--same-format、または出力パスの拡張子で決定できる必要があります。
--format を使う場合、--out に拡張子があるときはその拡張子と一致している必要があります。

sample rate と bit depth

--sample-rate は次の標準値のみ指定できます。

8000
11025
16000
22050
32000
44100
48000
88200
96000
176400
192000

bit depth や sample format には次の制約があります。

--sample-format は WAV 出力でのみ有効です。
WAV で --sample-format float を使う場合、--bits-per-sample 32 が必要です。
FLAC は 24 bit までです。

フォーマットごとの注意点

--flac-compression-level は FLAC 出力でのみ有効です。
--vorbis-quality は Ogg Vorbis 出力でのみ有効です。
--comment で追加したタグは FLAC / Ogg Vorbis では保持されますが、WAV / AIFF では出力時に保持されません。

代表的な使い方

単一ファイルを FLAC に書き出す例です。

a9a_cli render input.wav \
  --out output.flac \
  --format flac \
  --sample-rate 48000 \
  --bits-per-sample 24 \
  --op loudness target=-16LUFS max-true-peak=-1dBTP

job file に処理内容を寄せ、CLI 側で出力先だけ差し替える例です。

a9a_cli render \
  --job jobs/master.toml \
  --out-dir build/mastered \
  --comment REVISION=2025-08-28

運用上の考え方

render は多くの前処理を 1 本のワークフローで扱える反面、入出力条件の組み合わせによって有効な指定が変わります。実運用では次の順で整理しておくと扱いやすくなります。

出力形式を先に決める
sample rate や bit depth の方針を決める
operation を必要最小限から積み上げる
手順が固まったら job file に落とし込む

まずは単一ファイルで挙動を確認し、その後にバッチ処理へ広げるのが安全です。