From 0500b5455df8bac40dd62cabeadaa0fd87a7c62d Mon Sep 17 00:00:00 2001 From: jpecquais <48678018+jpecquais@users.noreply.github.com> Date: Mon, 5 Aug 2024 11:03:24 +0200 Subject: [PATCH] add vs documentation --- ...Environment_Speaker_Arrangement_Editor.qmd | 6 +- ...lisation_Technology_Panning_Algorithms.qmd | 2 +- .../Third_Party_Venue_Synthesis.qmd | 101 ++++++++++++++++++ en_US/spat-revolution/_quarto.yml | 1 + 4 files changed, 106 insertions(+), 4 deletions(-) create mode 100644 en_US/spat-revolution/Third_Party_Venue_Synthesis.qmd diff --git a/en_US/spat-revolution/Spat_Environment_Speaker_Arrangement_Editor.qmd b/en_US/spat-revolution/Spat_Environment_Speaker_Arrangement_Editor.qmd index ac8dc877..50a8e860 100644 --- a/en_US/spat-revolution/Spat_Environment_Speaker_Arrangement_Editor.qmd +++ b/en_US/spat-revolution/Spat_Environment_Speaker_Arrangement_Editor.qmd @@ -1,4 +1,4 @@ -# Speaker Arrangement Editor {#sec-speaker-editor} +# Speaker Arrangement Editor {#sec-speakereditor} ![The speaker arrangement editor window showing a predefined 13.1 Auro 3D speaker arrangement.](https://media.githubusercontent.com/media/FLUX-SE/doc_images/main/SpatR/Setup/SpeakerEditor1.png) @@ -71,7 +71,7 @@ For such a use case, it is possible to create custom speaker arrangements. Using **Reset:** revert the *compute* process. -**Compute:** opens a dialog to help to set delay and gain on the speaker arrangement. More information of the [dedicated section below -@sec-speaker-editor-alignment] +**Compute:** opens a dialog to help to set delay and gain on the speaker arrangement. More information of the [dedicated section below -@sec-speakereditor-alignment] ### Selected or all speakers section @@ -182,7 +182,7 @@ We can quickly be tempted to create very precise speaker arrays, including heigh The rule of thumb is to think in plan and not in absolute height. If speakers are meant to reproduce the same sound plan, they should have the same height. Also, the main sound plan has to be set at a height of zero meters. If you try to validate a speaker arrangement that only has one plan and is not set to a height of 0, it will correct it automatically. It also applies to older sessions that were created before _SPAT Revolution_ had this feature. -### Alignment {#sec-speaker-editor-alignment} +### Alignment {#sec-speakereditor-alignment} ![](https://media.githubusercontent.com/media/FLUX-SE/doc_images/main/SpatR/Setup/AlignmentDialog.png) diff --git a/en_US/spat-revolution/Spatialisation_Technology_Panning_Algorithms.qmd b/en_US/spat-revolution/Spatialisation_Technology_Panning_Algorithms.qmd index 829f3849..2434372c 100644 --- a/en_US/spat-revolution/Spatialisation_Technology_Panning_Algorithms.qmd +++ b/en_US/spat-revolution/Spatialisation_Technology_Panning_Algorithms.qmd @@ -64,7 +64,7 @@ Three important dependencies to consider when using VBAP: 4. VBAP works best when the listening room is not very reverberant. :::{.callout-note} -See the [Alignment -@sec-speaker-editor-alignment] section: the speaker alignment feature provides the impression that the actual speakers are equidistant even when they are not. +See the [Alignment -@sec-speakereditor-alignment] section: the speaker alignment feature provides the impression that the actual speakers are equidistant even when they are not. ::: ## Vector Base Intensity (VBIP) diff --git a/en_US/spat-revolution/Third_Party_Venue_Synthesis.qmd b/en_US/spat-revolution/Third_Party_Venue_Synthesis.qmd new file mode 100644 index 00000000..e48320bd --- /dev/null +++ b/en_US/spat-revolution/Third_Party_Venue_Synthesis.qmd @@ -0,0 +1,101 @@ +# Venue Synthesis + + + +SPAT Revolution offers the capability to **import speaker arrangements** directly from JBL's [Venue Synthesis](https://jblpro.com/en/products/venue-synthesis) prediction tool. This feature streamlines system design and simplifies the creation of immersive audio systems by integrating Venue Synthesis projects into SPAT Revolution. + +**Prerequisites** + +The import of Venue Synthesis files needs the following versions: + ++ Venue Synthesis *version 1.1 or later*. ++ SPAT Revolution *version 24.08 or later*. + +## Importing Speaker Arrangements + +### Setting Up the Venue Synthesis File + +In Venue Synthesis, navigate to the **Venue** mode toolbar. Select **Venue > Add > SPAT Revolution Reference**. Define the position of the **SPAT Revolution reference** relative to the VS reference. + +::::{.columns} + +:::{.column} +![](https://media.githubusercontent.com/media/FLUX-SE/doc_images/main/SpatR/ThirdParty/VS/add_spat_ref.png) +::: + +:::{.column} +![](https://media.githubusercontent.com/media/FLUX-SE/doc_images/main/SpatR/ThirdParty/VS/spat_ref.png) +::: + +![](https://media.githubusercontent.com/media/FLUX-SE/doc_images/main/SpatR/ThirdParty/VS/spat_ref_context.png){width="91.5%"} + +:::: + +At this point, your Venue Synthesis file can now be imported directly into the SPAT Revolution speaker editor. + + + +:::{.callout-important} + +::::{.columns} + +:::{.column width="25%"} +![](https://media.githubusercontent.com/media/FLUX-SE/doc_images/main/SpatR/ThirdParty/VS/vs_hide.png){width="90%"} +::: + +:::{.column width="75%"} +Note that system groups that are not active at the saving stage will be discarded upon import into SPAT Revolution. This can become very handy on larger systems to only import the needed elements or to do multiple imports to create different speaker arrangements (or sub-arrangements) in SPAT Revolution (see ). +::: + +:::: + +::: + +### Import the File into SPAT Revolution + +In SPAT Revolution, open the speaker arrangement editor (see @sec-speakereditor). Select Import from and locate your Venue Synthesis .VSYN file. Confirm the import settings to complete the process (see detail @sec-vsimportoptions below). As mentioned above, the import will exclude non-active "hidden" system groups from the Venue Synthesis file. + +![](https://media.githubusercontent.com/media/FLUX-SE/doc_images/main/SpatR/ThirdParty/VS/import_vs.png) + +### Managing Multiple Speaker Arrangements + +SPAT Revolution supports the deployment of multiple system functions, such as front fills or balcony systems. Each subsystem can be part of a specific speaker arrangement, enabling: + ++ Selection of a distinctive panning technique. ++ Optimization of WFS rendering for specific zones. ++ Adjustment of acoustic simulation settings for specific zones. ++ Modification of listener audience-related parameters (e.g., protection zone, listener position and orientation). ++ This configuration allows for dedicated treatment of subsystems or specific listening zones, providing control for leveling and muting different subsystems. + +::::{.columns} + +:::{.column} +![First room for surrounding system (VBAP)](https://media.githubusercontent.com/media/FLUX-SE/doc_images/main/SpatR/ThirdParty/VS/system_1.png){width=91.5%} +::: + +:::{.column} +![Second for front fields (WFS)](https://media.githubusercontent.com/media/FLUX-SE/doc_images/main/SpatR/ThirdParty/VS/system_2.png) +::: + +:::: + +## Configure Import Options {#sec-vsimportoptions} + + +::::{.columns} + +:::{.column width="60%"} ++ **Layering Tolerance**: Maximum elevation gap under which two speakers are considered as belonging to the same layer. If all the speakers belong to the same layer, the setup is considered 2D. ++ **Import Subwoofer**: Choose whether to include subwoofers and provide an aux/LFE output for each. A maximum of 4 AUX/LFE are supported. ++ **Elevation Correction Type**: Select between Polar or Cartesian for lowering the speaker setup. Polar adjusts both Y and Z values, while Cartesian adjusts only the Z value. Cartesian type is recommended for WFS, KNN and DBAP panning laws. For others, including VBAP and derivative, we recommend using Polar type. +::: + +:::{.column width="40%"} +![](https://media.githubusercontent.com/media/FLUX-SE/doc_images/main/SpatR/ThirdParty/VS/import_options.png) +::: + +:::: \ No newline at end of file diff --git a/en_US/spat-revolution/_quarto.yml b/en_US/spat-revolution/_quarto.yml index f6e2da5f..7f554dbf 100644 --- a/en_US/spat-revolution/_quarto.yml +++ b/en_US/spat-revolution/_quarto.yml @@ -59,6 +59,7 @@ book: - Ecosystem_&_integration_ADM_OSC.qmd - part: Third_Party_Integration.qmd chapters: + - Third_Party_Venue_Synthesis.qmd - Third_Party_Cockos_Reaper.qmd - Third_Party_ReaVolution.qmd - Third_Party_ProTools.qmd