.. _crashcourse: ************************** SPACE HUB Quick Start ************************** Welcome to SPACE HUB. This short guide will explain the first steps necessary to create your first immersive mix. We guide you through the basic functionality of the application, giving you the tools to start quickly creating in a 3D soundstage with CODA SPACE. ----------------------------- **Running SPACE HUB Control for the first time** After downloading the latest version of SPACE HUB Control, follow the :ref:`installation` instructions and run the application. ----------------------------- **Connecting SPACE HUB Control to the Processor** Connecting the SPACE HUB :ref:`Processor` is simple and straightforward using a standard network connection. The system is completely flexible. You can choose to connect the computer using wired Ethernet or WIFI. Connect the SPACE HUB Processor's Ethernet port to your network, and ensure the computer running SPACE HUB Control is linked to the same network. Ensure that both the SPACE HUB Processor and the Control machine are in the same IP range with a matching subnet mask, so they can communicate with each other. Once the network is set up, open the :ref:`Settings` page in SPACE HUB Control and navigate to the Engine Interface dropdown list. Select the IP address for this network. Next, you can find and select your SPACE HUB in the Primary SPACE HUB dropdown list. Now the connection is established and you will see information about the Processor on the settings page and the Primary indicator (Pri) in the Top Bar will turn green. ----------------------------- **Importing a Speaker Layout** The speaker layout forms the building blocks of your 3D system. It is easy to import your layout into the SPACE HUB for precise control, so the Processor knows which loudspeaker is connected to which output, and where they are located in the room. This enables precise, phase aligned audio. If you have already designed your setup in `System Optimiser`_, you can export your design there and easily import it into SPACE HUB Control: .. _`System Optimiser`: https://codaaudio.com/softwares/coda-system-optimiser/ 1. Launch System Optimiser's Quick Command Line (keyboard shortcut: [Cmd/Ctrl + Shift + P]) and type “Export to SPACE HUB”. This will give you a **.json** :ref:`file` and a window will open, asking you to set the file's save destination. 2. Return to SPACE HUB Control and open the :ref:`Speakers` page, where you will find a button labeled :guilabel:`Load System Optimiser File`. Click it and select the **.json** file that you have just exported. You will see the Speakers appear. 3. Check the orientation and adjust it by selecting Mirror X, Mirror Y or Mirror Z, if necessary. This depends on how you want to align your venues in System Optimiser. 4. If you want to enable Panning for a loudspeaker, you need to set its :ref:`Function` to :guilabel:`Immersive` in the Speaker Table. 5. Once you have set up your speakers, hit the :guilabel:`Send to SPACE HUB` Button, and you will get an alert that the Processor has updated its layout. You don't have to use System Optimiser. If no System Optimiser project is available for your venue, you can quickly and easily add the Speakers manually and adjust their coordinates in SPACE HUB Control using the Add Speaker Button. Add the desired speakers, and be sure to set their :ref:`Function` to :guilabel:`Immersive` and hit :guilabel:`Send to SPACE HUB` once you're finished. ----------------------------- **Routing Audio Inputs and Outputs** Now it's time to start routing signals into and out of the SPACE HUB. First connect all required devices to a common Dante network, following Audinate's `guidelines`_. .. _`guidelines`: https://www.audinate.com/learning/training-certification/video-tutorials/video-series-getting-started-with-dante-audio-networking-training Then start Dante Controller and make sure that all your devices display, and that there are no errors. If you are having trouble finding a device, it might be in the wrong subnet and have a static IP. .. Tip:: It's good practice to label all your devices as well as all individual channels in Dante Controller first, before routing them. This way it is simple to patch devices labelled, for example, output “Left Surround” from the SPACE HUB to input “Left Surround” on the matching amplifier, instead of resorting to complicated tables. Once all devices have been discovered in Dante Controller and you have labelled the channels, set them all to the desired sample rate. Afterwards you can start routing the output of your DAW or mixing desk to the inputs of the SPACE HUB, and the outputs of the SPACE HUB to your amplifiers. When you send a signal into the SPACE HUB you should now see the Input Meters react in SPACE HUB Control. If you want to test your output routing, the SPACE HUB has an integrated Signal Generator, which allows you to send White Noise to a particular speaker. You can control this on the :ref:`Speakers` page with the Buttons labelled :guilabel:`Test` for all your individual outputs in the Speaker Table. ----------------------------- **Configuring an Object** You can also take advantage of object-based mixing. Let's look at the Object Parameters within the Object List. For now, we can control these from SPACE HUB Control's User Interface only. Firstly, change its name. To rename an Object, just double-click the default or current name and enter the desired name. While we're in the :ref:`Object` List, let's take a closer look at what else we can do. .. image:: ../../_images/quickstart/Object_List.* :alt: Object List :width: 50% :align: center ---------------------- Left of the Object's name you have the visual options: - :guilabel:`V` Visual Solo - selecting this will cause only this object to appear in the panning circle - :guilabel:`H` Hide - selecting this will hide the object from the panning circle - Link Stereo Objects Right of the Object's name you will find audio properties: - Level control over the object, with levels ranging from -144 to 0 dB - :guilabel:`S` Solo (can be switched between PFL and SIP on the :ref:`Settings` page) - :guilabel:`M` Mutes the selected object - An Input Meter shows changing input levels for each object .. image:: ../../_images/quickstart/Object_Faders.* :alt: Object Parameters :width: 10% :align: left Next to the Object List you can modify the :ref:`parameters` of the selected Object. Here you can change the Object's name and assign a different Colour to it, which helps you to stay organised when creating your mix. Below that, you can link it to another Object to create a stereo pair. The lower selector allows you to pick the :ref:`panning algorithm` for the selected Object. Below this there are three sliders to move the selected Object in space using spherical coordinates: :guilabel:`Azimuth`, :guilabel:`Elevation` & :guilabel:`Distance` :guilabel:`Spread` alters the stereo width of an Object, and how many different speakers the sound is passed through. :guilabel:`LFE1` and :guilabel:`LFE2` sliders send the signal to the Aux / LFE Buses. If an Object is linked as a stereo pair, another slider that controls :guilabel:`Stereo Width` between the linked Objects appears below. :guilabel:`orbit` and :guilabel:`random` refer to Orbits, which you can create on the :ref:`Orbits` page If you would like to increase or decrease the number of Objects, you can adjust this on the :ref:`Settings` page in the Project Tab. For a more in-depth description of Object parameters, as well as their panning, metering and mixing, go to the :ref:`Objects` page. ----------------------------- **Generating Orbits** Orbits are trajectories that SPACE HUB objects can follow. This is a powerful feature of SPACE HUB Control, allowing for the launch of multiple Objects into 'Orbits' within 3D space! You can define trajectories, or specify 'zones' within which the Object parameters will randomly change. Select an Object, go to the :ref:`Orbits` View, click 'Record', then in the panning circle click and drag the shape of your desired Object trajectory. Click 'Play' to see your Orbit being played. .. image:: ../../_images/quickstart/OrbitTrajectory.* :alt: OrbitTrajectory :width: 100% :align: center --------------------- Orbits can be named and saved for later use within the Objects View. Orbits that have been associated with Objects can be enabled and played from the Objects View. To get more information about defined Orbits, Random Orbits and the range or parameters associated with them, go to the :ref:`Orbits` View. ------------------------------ **Creating a Snapshot** Snapshots allow you to quickly switch between different scenes and change the configuration. Drag the Objects to the desired positions and open the :ref:`Snapshot` View. When you click :guilabel:`New` you will see a Snapshot appear in the list, which will automatically be selected and active. Snapshots can also be renamed by double-clicking their names. .. image:: ../../_images/quickstart/Snapshot_List.* :alt: Snapshot List :width: 50% :align: center --------------------------- Snapshots can be loaded manually, or they can be triggered to load via MIDI Time Code (MTC), MIDI Program Change or OSC commands. A Snapshot page allows for the addition of snapshots. Each snapshot can be allocated a fade-in time and a time code value for MTC triggering. A snapshot can be set to automatically follow another snapshot after an adjustable wait time. Now, let's create a second Snapshot: Move the Objects to a different configuration and positions and click :guilabel:`New`, another Snapshot will be added to the list. During a show, or in the interval, you can switch between Snapshots with the :guilabel:`<<` and :guilabel:`>>` buttons which will load them immediately, or you can select a Snapshot with the left and right arrow keys on your keyboard and recall the selected one with the space bar. Additional options to load Snapshots via :ref:`OSC` or :ref:`MIDI` Program Change or Timecode can be found on the :ref:`Control` page in the Snapshots Tab. There, you can also assign a :ref:`Reverb` Preset that will be linked to the Snapshot. ----------------------------- **Adding Reverb** Reverb can be a powerful tool to add a natural and atmospheric feel to your immersive experience. It is yet another creative option to explore and create a more impactful audio experience. To add Reverb, we need to activate the Early & Cluster as well as the Late send for each Object on the :ref:`Processing` page. Next we have to adjust the return levels from the three Reverb Buses (Early, Cluster and Late). Let's take a look at the :ref:`Reverb` page, where you can control all of these parameters. .. image:: ../../_images/Reverb_Page.* :alt: Reverb Page :width: 100% :align: center On the left-hand side of the user interface you can find a list of Reverb Presets that allow you to quickly alter the parameters and recreate different acoustic spaces. Presets can be added with the New button after adjusting the parameters on the right-hand side. There are different options to recall a Reverb Preset: - Manually with the Load button - Via :ref:`OSC` message - By linking a Reverb Preset to a Snapshot (this can be done in the Snapshots Tab on the :ref:`Control` Page) ----------------------------- **Moving Objects with the Plugin** The :ref:`Plugin` allows detailed movements that are linked to a timeline, as the soundstage evolves and adapts through time to suit your visual needs and create stunning aural movement. Simply open your DAW of choice, load the Plugin onto a track, select the Object that you would like to control with it, and you can start writing automation. .. image:: ../../_images/Plugin.* :alt: Plugin :width: 100% :align: center The Plugin gives you the same impressive object controls and parameters that are shown on the UI (Azimuth, Elevation, Distance, Spread, LFE, Stereo Width & Algorithm), routed to your DAW ready for automation. The steps necessary to set up parameter automation differ from DAW to DAW, so please refer to the DAW's manual if you are unsure about this.