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

Update docs for OptionChannelsTogether

Browse Source
This commit is contained in:
Chris Cannam
2023-03-23 17:58:46 +00:00
parent 18b32431b4
commit 21b968c0c5
1 changed files with 14 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
rubberband/RubberBandStretcher.h
View File

@@ -353,9 +353,8 @@ public:
* processing. * processing.
* *
* 11. Flags prefixed \c OptionChannels control the method used * 11. Flags prefixed \c OptionChannels control the method used
* for processing two-channel stereo audio. These have different, * for processing two-channel stereo audio. These options may not
* but related, effects in the R2 and R3 engines. These options * be changed after construction.
* may not be changed after construction.
* *
* \li \c OptionChannelsApart - Channels are handled for maximum * \li \c OptionChannelsApart - Channels are handled for maximum
* individual fidelity, at the expense of synchronisation. In * individual fidelity, at the expense of synchronisation. In
@@ -364,19 +363,20 @@ public:
* higher. In R2, it means the stereo channels are processed * higher. In R2, it means the stereo channels are processed
* individually and only synchronised at transients. In both * individually and only synchronised at transients. In both
* engines this gives the highest quality for the individual * engines this gives the highest quality for the individual
* channels but a more diffuse stereo image and an unnatural * channels but a more diffuse stereo image, an unnatural
* increase in "width". This option is the default. * increase in "width", and generally a loss of mono
* compatibility (i.e. mono mixes from stereo can sound phasy).
* This option is the default.
* *
* \li \c OptionChannelsTogether - Channels are handled for * \li \c OptionChannelsTogether - Channels are handled for
* higher synchronisation at the expense of individual * higher synchronisation at some expense of individual
* fidelity. In the R3 engine, this means stereo synchronisation * fidelity. In particular, a stretcher processing two channels
* is maintained more closely for the full frequency range. In * will treat its input as a stereo pair and aim to maximise
* R2, it means the first two channels are considered to be a * clarity at the centre and preserve mono compatibility. This
* stereo pair and are processed in mid-side format, with mid * gives relatively less stereo space and width than the
* and side processed as if they were separate channels before * default, as well as slightly lower fidelity for individual
* being recombined. This usually leads to better focus in the * channel content, but the results may be more appropriate for
* centre but relatively less stereo space and width and lower * many situations making use of stereo mixes.
* fidelity for individual channel content.
* *
* Finally, flags prefixed \c OptionStretch are obsolete flags * Finally, flags prefixed \c OptionStretch are obsolete flags
* provided for backward compatibility only. They are ignored by * provided for backward compatibility only. They are ignored by