@@ -9249,7 +9249,7 @@ <h1>AUDIO FILTERS</h1>
92499249</dd>
92509250<dt><tt class="docutils literal"><span class="pre">scaletempo[=option1:option2:...]</span></tt></dt>
92519251<dd><p class="first">Scales audio tempo without altering pitch, optionally synced to playback
9252- speed (default) .</p>
9252+ speed.</p>
92539253<p>This works by playing 'stride' ms of audio at normal speed then consuming
92549254'stride*scale' ms of input audio. It pieces the strides together by
92559255blending 'overlap'% of stride with audio following the previous stride. It
@@ -9318,7 +9318,10 @@ <h1>AUDIO FILTERS</h1>
93189318<dd><p class="first">Scales audio tempo without altering pitch.
93199319The algorithm is ported from chromium and uses the
93209320Waveform Similarity Overlap-and-add (WSOLA) method.
9321- It seems to achieve a higher audio quality than scaletempo and rubberband.</p>
9321+ It seems to achieves higher audio quality than scaletempo, and rubberband R2
9322+ engine, or <tt class="docutils literal">engine=faster</tt>. This filter is inserted automatically if
9323+ <tt class="docutils literal"><span class="pre">audio-pitch-correction</span></tt> option is used (on by default) when the playback
9324+ speed is changed.</p>
93229325<p>By default, the <tt class="docutils literal"><span class="pre">search-interval</span></tt> and <tt class="docutils literal"><span class="pre">window-size</span></tt> parameters
93239326have the same values as in chromium.</p>
93249327<dl class="last docutils">
@@ -9335,19 +9338,39 @@ <h1>AUDIO FILTERS</h1>
93359338</dd>
93369339<dt><tt class="docutils literal">rubberband</tt></dt>
93379340<dd><p class="first">High quality pitch correction with librubberband. This can be used in place
9338- of <tt class="docutils literal">scaletempo</tt>, and will be used to adjust audio pitch when playing
9339- at speed different from normal. It can also be used to adjust audio pitch
9340- without changing playback speed.</p>
9341- <dl class="docutils">
9342- <dt><tt class="docutils literal"><span class="pre"><pitch-scale></span></tt></dt>
9343- <dd>Sets the pitch scaling factor. Frequencies are multiplied by this value.</dd>
9341+ of <tt class="docutils literal">scaletempo</tt> and <tt class="docutils literal">scaletempo2</tt>, and will be used to adjust audio pitch
9342+ when playing at speed different from normal. It can also be used to adjust
9343+ audio pitch without changing playback speed.</p>
9344+ <dl class="docutils">
9345+ <dt><tt class="docutils literal"><span class="pre">pitch-scale=<amount></span></tt></dt>
9346+ <dd>Sets the pitch scaling factor. Frequencies are multiplied by this value.
9347+ (default: 1.0)</dd>
9348+ <dt><tt class="docutils literal"><span class="pre">engine=<faster|finer></span></tt></dt>
9349+ <dd><p class="first">Select the core Rubberband engine to be used. There are two available:</p>
9350+ <table class="last docutils field-list" frame="void" rules="none">
9351+ <col class="field-name" />
9352+ <col class="field-body" />
9353+ <tbody valign="top">
9354+ <tr class="field"><th class="field-name">Faster:</th><td class="field-body">This is the Rubberband R2 engine. It uses significantly less
9355+ CPU than the Finer (R3) engine.</td>
9356+ </tr>
9357+ <tr class="field"><th class="field-name">Finer:</th><td class="field-body">This is the Rubberband R3 engine. This engine is only available
9358+ with librubberband version 3 or newer. This produces significantly
9359+ higher quality output, at the cost of higher CPU usage. (Default
9360+ if available)</td>
9361+ </tr>
9362+ </tbody>
9363+ </table>
9364+ </dd>
93449365</dl>
93459366<p>This filter has a number of additional sub-options. You can list them with
93469367<tt class="docutils literal">mpv <span class="pre">--af=rubberband=help</span></tt>. This will also show the default values
93479368for each option. The options are not documented here, because they are
93489369merely passed to librubberband. Look at the librubberband documentation
93499370to learn what each option does:
93509371<a class="reference external" href="https://breakfastquay.com/rubberband/code-doc/classRubberBand_1_1RubberBandStretcher.html">https://breakfastquay.com/rubberband/code-doc/classRubberBand_1_1RubberBandStretcher.html</a>
9372+ Do note that certain options are only applicable to one of R2 (faster) and
9373+ R3 (finer) engines.
93519374(The mapping of the mpv rubberband filter sub-option names and values to
93529375those of librubberband follows a simple pattern: <tt class="docutils literal">"Option" + Name + Value</tt>.)</p>
93539376<p>This filter supports the following <tt class="docutils literal"><span class="pre">af-command</span></tt> commands:</p>
0 commit comments