david/librubberband
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Further docs for short window

Browse Source
This commit is contained in:
Chris Cannam
2022-09-29 08:27:50 +01:00
parent e3c817b8cf
commit 4599b1afd7
2 changed files with 20 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
main/main.cpp
View File

@@ -325,11 +325,12 @@ int main(int argc, char **argv)
cerr << "(2) --no-transients Disable phase resynchronisation at transients" << endl; cerr << "(2) --no-transients Disable phase resynchronisation at transients" << endl;
cerr << "(2) --bl-transients Band-limit phase resync to extreme frequencies" << endl; cerr << "(2) --bl-transients Band-limit phase resync to extreme frequencies" << endl;
cerr << "(2) --no-lamination Disable phase lamination" << endl; cerr << "(2) --no-lamination Disable phase lamination" << endl;
cerr << "(2) --window-long Use longer processing window (actual size may vary)" << endl;
cerr << "(2) --window-short Use shorter processing window" << endl;
cerr << "(2) --smoothing Apply window presum and time-domain smoothing" << endl; cerr << "(2) --smoothing Apply window presum and time-domain smoothing" << endl;
cerr << "(2) --detector-perc Use percussive transient detector (as in pre-1.5)" << endl; cerr << "(2) --detector-perc Use percussive transient detector (as in pre-1.5)" << endl;
cerr << "(2) --detector-soft Use soft transient detector" << endl; cerr << "(2) --detector-soft Use soft transient detector" << endl;
cerr << "(2) --window-long Use longer processing window (actual size may vary)" << endl;
cerr << " --window-short Use shorter processing window (with the R3 engine" << endl;
cerr << " this is effectively a quick \"draft mode\")" << endl;
cerr << " --pitch-hq In RT mode, use a slower, higher quality pitch shift" << endl; cerr << " --pitch-hq In RT mode, use a slower, higher quality pitch shift" << endl;
cerr << " --centre-focus Preserve focus of centre material in stereo" << endl; cerr << " --centre-focus Preserve focus of centre material in stereo" << endl;
cerr << " (at a cost in width and individual channel quality)" << endl; cerr << " (at a cost in width and individual channel quality)" << endl;

24
rubberband/RubberBandStretcher.h
View File

@@ -276,13 +276,23 @@ public:
* this causes the engine's full multi-resolution processing * this causes the engine's full multi-resolution processing
* scheme to be used. * scheme to be used.
* *
* \li \c OptionWindowShort - Use a shorter window. With the R2 * \li \c OptionWindowShort - Use a shorter window. This has
* engine this may result in crisper sound for audio that * different effects with R2 and R3 engines.
* depends strongly on its timing qualities. With the R3 engine, *
* this causes the engine to be restricted to a single window * With the R2 engine it may result in crisper sound for audio
* size, resulting in both dramatically faster processing and * that depends strongly on its timing qualities, but is likely
* lower latency than OptionWindowStandard, but at the expense * to sound worse in other ways and will have similar
* of some sound quality. * efficiency.
*
* With the R3 engine, it causes the engine to be restricted to
* a single window size, resulting in both dramatically faster
* processing and lower delay than OptionWindowStandard, but at
* the expense of some sound quality. It may still sound better
* for non-percussive material than the R2 engine.
*
* With both engines it reduces the start delay somewhat (see
* RubberBandStretcher::getStartDelay) which may be useful for
* real-time handling.
* *
* \li \c OptionWindowLong - Use a longer window. With the R2 * \li \c OptionWindowLong - Use a longer window. With the R2
* engine this is likely to result in a smoother sound at the * engine this is likely to result in a smoother sound at the