jamulussoftware / jamuluswebsite

This is the GitHub Pages repository for the Jamulus main website. For the jamulus application source code, please visit jamulussoftware/jamulus.
https://jamulus.io
GNU Lesser General Public License v2.1
15 stars 82 forks source link

Document delay panning #389

Closed ann0see closed 3 years ago

ann0see commented 3 years ago

The short description can be: --delaypan Switches the server to 'delay panning' mode instead of the default 'volume panning' mode.

A bit more detailed description (elsewhere) can be: When using a Jamulus server in 'delay panning' mode, the musicians listening under their head­phones can hear each other outside of their heads like in a physical meeting. The heard directions to the others can be con­trol­led by the respective PAN knobs. To achieve this result, all client Jamuli should be set to 'mono in / stereo out'.

Originally posted by @DetlefHennings in https://github.com/jamulussoftware/jamulus/issues/1151#issuecomment-804901574

gilgongo commented 3 years ago

Presumably we can put this into the "What's this?" tooltip as well as the server docs. I'd suggest something more like:

"Delay panning uses small differences in sound arrival time between the two ears. It produces a stereo effect similar to natural human hearing when compared to normal "volume" panning. Note that to achieve the effect, all clients should be set to 'mono in / stereo out' (or to 'stereo', but only if transmitting a stereo signal)."

ann0see commented 3 years ago

Yep

all clients should be set to 'mono in / stereo out'

Or stereo ;-).

DetlefHennings commented 3 years ago

I would prefer to avoid 'psycho-acoustics' because this may not explain anything to poeple, who are not familiar with this term.
... and please have in mind that setting a client to 'stereo' only works well with delay panning, if this client transmits a stereo signal (from stereo microphones or from another stereo source).
We could write something like this: "Delay panning means using small differences in sound arrival time between the two ears and is similar to natural human hearing. That's why it sounds more realistic than volume panning. Note that to achieve this, all clients should be set to 'mono in / stereo out' (or to 'stereo', but only if transmitting a stereo signal)."

gilgongo commented 3 years ago

Done. Not sure why this wasn't close automatically on the merge though. Hm.

ann0see commented 3 years ago

Maybe it wasn't linked?

gilgongo commented 3 years ago

It was (well, is), but I think the project automation doesn't have a condition for "if PR on linked to issue closes, move issue to done". For some reason I thought it did (and the wording on the link above says "Successfully merging a pull request may close this issue." - weird). I guess maybe that would be problematic if more than on PR was linked?

ann0see commented 3 years ago

I guess maybe that would be problematic if more than on PR was linked?

Could be.