From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on dcvr.yhbt.net X-Spam-Level: X-Spam-ASN: AS22989 208.118.235.0/24 X-Spam-Status: No, score=-2.3 required=3.0 tests=AWL,BAYES_00 shortcircuit=no autolearn=unavailable version=3.3.2 X-Original-To: dtas-all@80x24.org Received: from lists.gnu.org (lists.gnu.org [208.118.235.17]) (using TLSv1 with cipher AES256-SHA (256/256 bits)) (No client certificate requested) by dcvr.yhbt.net (Postfix) with ESMTPS id 9D2731FAC6 for ; Sun, 10 May 2015 09:16:28 +0000 (UTC) Received: from localhost ([::1]:33070 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YrNLX-0003cE-Vn for dtas-all@80x24.org; Sun, 10 May 2015 05:16:27 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:53711) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YrNLV-0003bx-9C for dtas-all@nongnu.org; Sun, 10 May 2015 05:16:26 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YrNLS-0001EZ-0z for dtas-all@nongnu.org; Sun, 10 May 2015 05:16:25 -0400 Received: from dcvr.yhbt.net ([64.71.152.64]:55590) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YrNLR-0001EV-RH for dtas-all@nongnu.org; Sun, 10 May 2015 05:16:21 -0400 Received: from localhost (dcvr.yhbt.net [127.0.0.1]) by dcvr.yhbt.net (Postfix) with ESMTP id 9379E1FAC6; Sun, 10 May 2015 09:16:20 +0000 (UTC) From: Eric Wong To: Subject: [PATCH] doc: favor the "gain" effect over "vol" Date: Sun, 10 May 2015 09:16:19 +0000 Message-Id: <1431249379-31274-1-git-send-email-e@80x24.org> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 64.71.152.64 Cc: Eric Wong X-BeenThere: dtas-all@nongnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dtas-all-bounces+dtas-all=80x24.org@nongnu.org Sender: dtas-all-bounces+dtas-all=80x24.org@nongnu.org Followup-to commit 403ed90e2e7bed3e017938d76e17037b0d5059b6 (replaygain uses the "gain" effect instead of "vol") The `gain' effect seems superior as it can "see" across the effects chain to take into account extra/lost headroom. --- Documentation/dtas-env.txt | 2 +- Documentation/dtas-player_effects.txt | 6 +++--- Documentation/dtas-splitfx.txt | 8 ++++---- examples/splitfx.sample.yml | 2 +- examples/tfx.sample.yml | 4 ++-- 5 files changed, 11 insertions(+), 11 deletions(-) diff --git a/Documentation/dtas-env.txt b/Documentation/dtas-env.txt index 374f626..0f59709 100644 --- a/Documentation/dtas-env.txt +++ b/Documentation/dtas-env.txt @@ -24,7 +24,7 @@ INFILE - the primary input file for playback or processing. (e.g. "/path/to/ex.flac") RGFX - the sox effect used for applying ReplayGain compensation. -Only used during playback in dtas-player. (e.g. "vol -6.0dB"). +Only used during playback in dtas-player. (e.g. "gain -6.0"). Removing this prevents ReplayGain from working and may damage playback equipment with loudly mastered music. diff --git a/Documentation/dtas-player_effects.txt b/Documentation/dtas-player_effects.txt index 9bfc525..58b69c7 100644 --- a/Documentation/dtas-player_effects.txt +++ b/Documentation/dtas-player_effects.txt @@ -7,9 +7,9 @@ They are applied in the order described. rely on inter-track information. Examples include: - - ReplayGain (simple vol/gain changes) + - ReplayGain (simple gain changes) - anything which does not change the length of the audio: - vol, stereo, highpass, lowpass, loudness, bass, treble, equalizer, ... + gain, stereo, highpass, lowpass, loudness, bass, treble, equalizer, ... Modifying source effects should introduce no extra gaps in playback. Effects which modify the length of the audio is not recommended here, @@ -34,7 +34,7 @@ They are applied in the order described. - delaying a certain channel or frequency range for time-alignment - compressors/limiters - reverb - - vol + - gain - remix (for stereo image adjustments) Additionally, effects which are necessary due to the limitation of the diff --git a/Documentation/dtas-splitfx.txt b/Documentation/dtas-splitfx.txt index f8cbe5e..b58adec 100644 --- a/Documentation/dtas-splitfx.txt +++ b/Documentation/dtas-splitfx.txt @@ -46,7 +46,7 @@ to use ecasound(1), too. * infile - string, the pathname of the original audio file * env - ordered hash of environment variables to set for all commands env: !omap - FX: vol +3dB stats + FX: gain 3 stats * comments - hash of common tags for all audio (e.g. ARTIST, ALBUM, YEAR) comments: ARTIST: John Smith @@ -118,7 +118,7 @@ use in targets: * RATEFX - rate effect and arguments for sox(1) resampling * DITHERFX - dither effect and arguments for sox(1) dithering * FX - any user-specified sox effects which encompases the entire file. - (e.g. "highpass 35 vol +3dB stats") + (e.g. "highpass 35 gain 3 stats") # TARGETS @@ -150,8 +150,8 @@ imbalance in a live concert recording from the audience: targets: flac24: command: sox -M - "|sox $INFILE -c1 -p $TRIMFX remix 1v1 vol +9.5dB" - "|sox $INFILE -c1 -p $TRIMFX remix 2v1 vol +8.5dB" + "|sox $INFILE -c1 -p $TRIMFX remix 1v1 gain 9.5" + "|sox $INFILE -c1 -p $TRIMFX remix 2v1 gain 8.5" $COMMENTS $OUTFMT ${OUTDIR}bandYYYY-MM-DD.FOO.t0"$TRACKNUMBER.$SUFFIX" $RATEFX $DITHERFX stats diff --git a/examples/splitfx.sample.yml b/examples/splitfx.sample.yml index bbd224b..9c29df2 100644 --- a/examples/splitfx.sample.yml +++ b/examples/splitfx.sample.yml @@ -17,7 +17,7 @@ env: !omap SOX_OPTS: $SOX_OPTS -R FX: # highpass -1 120 highpass 40 highpass 40 - # vol +1.5dB + # gain 1.5 stats track_start: 1 # 0 for pregap/intro tracks cdda_align: true diff --git a/examples/tfx.sample.yml b/examples/tfx.sample.yml index 205a0a1..b8add0b 100644 --- a/examples/tfx.sample.yml +++ b/examples/tfx.sample.yml @@ -16,8 +16,8 @@ comments: track_start: 1 effects: # the following commands are equivalent -- trim 52 =53 sh sox $SOXIN $SOXOUT $TRIMFX vol -6dB -- trim 52 1 sox vol -6dB # shorthand +- trim 52 =53 sh sox $SOXIN $SOXOUT $TRIMFX gain -6 +- trim 52 1 sox gain -6 # shorthand # as are the following (for little endian machines) - trim 52 1 eca -eadb:-6 -- EW