DemoEars.component
README.md
DemoEars
The film's ears.
The scene's AudioListener rides this entity, and this entity rides whichever
camera is currently drawing the viewport. A cutscene builds its own camera each
time it plays, so the listener cannot be authored onto it. It follows.
Every source in the mix is spatial and stands where its sound is made, so most of the film's sound design is done by walking the camera through the building: the music box is audible in shot 4 because the camera is a metre and a half from it and inaudible everywhere else because it carries nine metres, and the calliope under the stage is plumbing from the dressing room and a fairground from the ballroom. None of that works unless the ears are where the lens is, which is what this does.
What it attaches to
One entity in the scene skeleton, carrying both this component and an
AudioListener. Do not add a second, and do not add another AudioListener
anywhere, because spatial audio is heard from here, and two listeners is not twice the
sound, it is an argument about which one is the audience.
It runs at executionOrder = -60, after the film clock and before the mix, so
the position it writes is this frame's camera and not last frame's.
Fields
| Field | Meaning |
|---|---|
active | Off leaves the ears wherever they last stood. |
Methods
| Call | Returns |
|---|---|
ears:following() | The id of the camera the ears are currently riding, which is the check that the listener is on the film's camera and not on the editor's. |