Adds source code

Author: ragnaringi

.gitignore

@@ -0,0 +1,2 @@
+builds/
+/JuceLibraryCode

3dti_AudioToolkit_Plugin.jucer

@@ -0,0 +1,32 @@
+3D Tune-In Toolkit VST plugin V1.0
+
+The 3D Tune-In Toolkit VST plugin was developed by Ragnar Hrafnkelsson, under the supervision of Lorenzo Picinali and Arcadio Reyes-Lecuona, as a VST interface for the 3D Tune-In Toolkit. For technical details, please refer to:
+
+	Picinali, L., Hrafnkelsson, R., & Reyes-Lecuona, A. (2019, March). The 3D Tune-In Toolkit VST Binaural Audio Plugin. In Audio Engineering Society 	Conference: 2019 AES International Conference on Immersive and Interactive Audio. Audio Engineering Society.
+
+More information about the 3D Tune-In Toolkit can be found in the open-source GitHub repository at https://github.com/3DTune-In/3dti_AudioToolkit/. Technical details about the 3D Tune-In Toolkit spatialiser are described in:
+
+    	Cuevas-Rodríguez M, Picinali L, González-Toledo D, Garre C, de la Rubia-Cuestas E, Molina-Tanco L and Reyes-Lecuona A. (2019) 3D Tune-In Toolkit: An 	open-source library for real-time binaural spatialisation. PLOS ONE 14(3): e0211899. https://doi.org/10.1371/journal.pone.0211899
+
+More information about the 3D Tune-In project can be found at http://3d-tune-in.eu/.
+
+HRTF files are extracted from the IRCAM LISTEN databased and processed to remove ITDs.
+BRIR files were created within the 3D Tune-In project.
+
+
+Copyright and License
+
+The 3D Tune-In Toolkit VST plugin, Copyright (c) 2019 Imperial College London and University of Malaga, is distributed as open source under GPLv3. 
+
+You may use this program to generate 3D sounds without additional restrictions to those imposed by the license of the original audio. You are not compelled to make any mention to this software or the 3D Tune-In project when using or distributing these audio files, but we would highly appreciate if you could kindly acknowledge the use of the 3D Tune-In Toolkit.
+
+
+Acknowledgements
+
+This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreements No 644051 and 726765.
+We would also like to acknowledge Angel Rodríguez-Rivero for his help in testing the first release of this software.
+
+
+Contact
+
+Lorenzo Picinali (l.picinali@imperial.ac.uk) and Arcadio Reyes-Lecuona (areyes@uma.es).

Resources/About.txt

@@ -0,0 +1,204 @@
+/**
+* \class AnechoicControls
+*
+* \brief Declaration of AnechoicControls interface.
+* \date  June 2019
+*
+* \authors Reactify Music LLP: R. Hrafnkelsson ||
+* Coordinated by , A. Reyes-Lecuona (University of Malaga) and L.Picinali (Imperial College London) ||
+* \b Contact: areyes@uma.es and l.picinali@imperial.ac.uk
+*
+* \b Project: 3DTI (3D-games for TUNing and lEarnINg about hearing aids) ||
+* \b Website: http://3d-tune-in.eu/
+*
+* \b Copyright: University of Malaga and Imperial College London - 2019
+*
+* \b Licence: This copy of the 3D Tune-In Toolkit Plugin is licensed to you under the terms described in the LICENSE.md file included in this distribution.
+*
+* \b Acknowledgement: This project has received funding from the European Union's Horizon 2020 research and innovation programme under grant agreements No 644051 and 726765.
+*/
+
+#include "AnechoicControls.h"
+
+AnechoicControls::AnechoicControls(Toolkit3dtiPluginAudioProcessor& processor)
+  : mProcessor(processor),
+  mCore(processor.getCore()),
+  distanceAttenuationLabel("Distance Label", "dB attenuation per double distance")
+{
+  for ( int i = 0; i < BundledHRTFs.size(); i++ ) {
+    hrtfMenu.addItem( BundledHRTFs[i], i+1 ); // IDs must be non-zero
+  }
+  hrtfMenu.onChange = [this] { hrtfMenuChanged(); };
+  hrtfMenu.setSelectedItemIndex(0, dontSendNotification);
+  addAndMakeVisible( hrtfMenu );
+  
+  headCircumferenceToggle.setButtonText( "Custom Head Circumference" );
+  headCircumferenceToggle.onClick = [this] { updateHeadCircumference(); };
+  addAndMakeVisible(headCircumferenceToggle);
+  
+  mapParameterToSlider( headCircumferenceSlider, mCore.headCircumference );
+  headCircumferenceSlider.setTextValueSuffix(" mm");
+  headCircumferenceSlider.setTextBoxStyle( Slider::TextBoxRight, false, 65, 24 );
+  headCircumferenceSlider.addListener( this );
+  headCircumferenceSlider.setValue( mCore.headCircumference, dontSendNotification );
+  addAndMakeVisible( headCircumferenceSlider );
+  
+  headCircumferenceSlider.setEnabled( headCircumferenceToggle.getToggleState() );
+  
+  bypassToggle.setButtonText("On/Off");
+  bypassToggle.setToggleState(true, dontSendNotification);
+  bypassToggle.onClick = [this] { updateBypass(); };
+  addAndMakeVisible( bypassToggle );
+  
+  nearFieldToggle.setButtonText( "Near field correction (IIR)" );
+  nearFieldToggle.onClick = [this] { updateNearFieldCorrection(); };
+  addAndMakeVisible( nearFieldToggle );
+  
+  farFieldToggle.setButtonText( "Far field correction (IIR)" );
+  farFieldToggle.onClick = [this] { updateFarFieldCorrection(); };
+  addAndMakeVisible( farFieldToggle );
+  
+  distanceAttenuationToggle.setButtonText("On/Off");
+  distanceAttenuationToggle.setToggleState(true, dontSendNotification);
+  distanceAttenuationToggle.onClick = [this] { updateDistanceAttenuation(); };
+  addAndMakeVisible( distanceAttenuationToggle );
+  
+  qualityToggle.setButtonText( "High Quality" );
+  qualityToggle.onClick = [this] { updateQualitySetting(); };
+  // addAndMakeVisible( qualityToggle );
+  
+  setLabelStyle( distanceAttenuationLabel );
+  distanceAttenuationLabel.setJustificationType( Justification::left );
+  addAndMakeVisible( distanceAttenuationLabel );
+  
+  mapParameterToSlider( distanceAttenuationSlider, mCore.sourceDistanceAttenuation );
+  distanceAttenuationSlider.setTextValueSuffix(" dB");
+  distanceAttenuationSlider.setTextBoxStyle( Slider::TextBoxRight, false, 65, 24 );
+  distanceAttenuationSlider.addListener( this );
+  addAndMakeVisible( distanceAttenuationSlider );
+  
+  updateGui();
+}
+
+void AnechoicControls::updateGui() {
+  headCircumferenceToggle.setToggleState( mCore.enableCustomizedITD, dontSendNotification );
+  headCircumferenceSlider.setValue( mCore.headCircumference, dontSendNotification );
+  headCircumferenceSlider.setEnabled( headCircumferenceToggle.getToggleState() );
+  
+  if ( !mCore.getSources().empty() ) {
+    auto source = mCore.getSources().front();
+    bypassToggle.setToggleState(source->IsAnechoicProcessEnabled(), dontSendNotification);
+    
+    bool distanceAttenuationEnabled = source->IsDistanceAttenuationEnabledAnechoic();
+    distanceAttenuationToggle.setToggleState(distanceAttenuationEnabled, dontSendNotification);
+    distanceAttenuationSlider.setValue(mCore.sourceDistanceAttenuation, dontSendNotification);
+    distanceAttenuationLabel.setEnabled(distanceAttenuationEnabled);
+    distanceAttenuationSlider.setEnabled(distanceAttenuationEnabled);
+  }
+  
+  nearFieldToggle.setToggleState( mCore.enableNearDistanceEffect, dontSendNotification);
+  farFieldToggle.setToggleState( mCore.enableFarDistanceEffect, dontSendNotification);
+  qualityToggle.setToggleState( mCore.spatializationMode, dontSendNotification);
+  
+  auto hrtfIndex = mCore.getHrtfIndex();
+  if ( hrtfIndex != hrtfMenu.getSelectedItemIndex() && hrtfIndex < BundledHRTFs.size()-2 ) { // Show filename if custom file is selected
+    hrtfMenu.setSelectedItemIndex(hrtfIndex, dontSendNotification);
+  }
+}
+
+void AnechoicControls::resized() {
+  auto area = getLocalBounds();
+  bypassToggle.setBounds( 10, 4, 80, 24 );
+  hrtfMenu.setBounds( 12, 40, area.getWidth()-24, 22 );
+  headCircumferenceToggle.setBounds( 10, hrtfMenu.getBottom() + 8, area.getWidth()-20, 26);
+  headCircumferenceSlider.setBounds( 6, headCircumferenceToggle.getBottom(), area.getWidth()-18, 24);
+  nearFieldToggle.setBounds(10, headCircumferenceSlider.getBottom(), area.getWidth()-20, 32);
+  farFieldToggle.setBounds(10, nearFieldToggle.getBottom(), area.getWidth()-20, 32);
+  // qualityToggle.setBounds(10, farFieldToggle.getBottom(), area.getWidth()-20, 30);
+  distanceAttenuationToggle.setBounds( 10, farFieldToggle.getBottom() + 4, 80, 24);
+  distanceAttenuationLabel.setBounds( 94, distanceAttenuationToggle.getY(), area.getWidth()-100, 24);
+  distanceAttenuationSlider.setBounds( 6, distanceAttenuationToggle.getBottom() + 4, area.getWidth()-20, 24);
+}
+
+void AnechoicControls::updateBypass() {
+  bool enabled = bypassToggle.getToggleState();
+  if ( enabled  ) {
+    mCore.getSources().front()->EnableAnechoicProcess();
+  } else {
+    mCore.getSources().front()->DisableAnechoicProcess();
+  }
+  setAlpha( enabled + 0.4f );
+}
+
+void AnechoicControls::hrtfMenuChanged() {
+  auto text = hrtfMenu.getText();
+  // Note(Ragnar): Windows FileChooser will only accept
+  // one filetype at at time se we provide separate options
+  if ( text == "Load 3DTI" ) {
+    loadCustomHrtf("*.3dti-hrtf");
+  } else if ( text == "Load SOFA" ) {
+    loadCustomHrtf("*.sofa");
+  } else {
+    mCore.loadHRTF(hrtfMenu.getSelectedItemIndex());
+  }
+}
+
+void AnechoicControls::loadCustomHrtf(String fileTypes) {
+  fc.reset (new FileChooser ("Choose a file to open...",
+                             HRTFDirectory(),
+                             fileTypes,
+                             true));
+  
+  fc->launchAsync(FileBrowserComponent::openMode | FileBrowserComponent::canSelectFiles,
+                  [this] (const FileChooser& chooser)
+                  {
+                    String chosen;
+                    auto results = chooser.getURLResults();
+                    
+                    auto result = results.getFirst();
+                    
+                    chosen << (result.isLocalFile() ? result.getLocalFile().getFullPathName()
+                               : result.toString (false));
+                    
+                    if ( mCore.loadHRTF(File(chosen.removeCharacters("\n"))) ) {
+                      updateHrtfLabelText();
+                    };
+                  });
+}
+
+void AnechoicControls::updateHeadCircumference() {
+  bool enabled = headCircumferenceToggle.getToggleState();
+  mCore.enableCustomizedITD = enabled;
+  mCore.headCircumference = headCircumferenceSlider.getValue();
+  
+  // TODO: Show circumference in mm
+  // IM.slHeadCircumference.footer = "mm (r: " + Utils.FloatToString(r_cm, 1) + " cm)";
+  headCircumferenceSlider.setEnabled(enabled);
+}
+
+void AnechoicControls::updateHrtfLabelText() {
+  auto hrtf = mCore.getHrtfPath().getFileNameWithoutExtension().upToLastOccurrenceOf("_", false, false);;
+  hrtfMenu.setText(hrtf, dontSendNotification);
+}
+
+void AnechoicControls::updateNearFieldCorrection() {
+  mCore.enableNearDistanceEffect = nearFieldToggle.getToggleState();
+}
+
+void AnechoicControls::updateFarFieldCorrection() {
+  mCore.enableFarDistanceEffect = farFieldToggle.getToggleState();
+}
+
+void AnechoicControls::updateQualitySetting() {
+  auto mode = qualityToggle.getToggleState() ? Binaural::HighQuality : Binaural::HighPerformance;
+  mCore.spatializationMode = mode;
+}
+
+void AnechoicControls::updateDistanceAttenuation() {
+  auto source = mCore.getSources().front();
+  if ( distanceAttenuationToggle.getToggleState() ) {
+    source->EnableDistanceAttenuationAnechoic();
+  } else {
+    source->DisableDistanceAttenuationAnechoic();
+  }
+}

Resources/Images/3DTI_Logo.png

@@ -0,0 +1,89 @@
+/**
+* \class AnechoicControls
+*
+* \brief Declaration of AnechoicControls interface.
+* \date  June 2019
+*
+* \authors Reactify Music LLP: R. Hrafnkelsson ||
+* Coordinated by , A. Reyes-Lecuona (University of Malaga) and L.Picinali (Imperial College London) ||
+* \b Contact: areyes@uma.es and l.picinali@imperial.ac.uk
+*
+* \b Project: 3DTI (3D-games for TUNing and lEarnINg about hearing aids) ||
+* \b Website: http://3d-tune-in.eu/
+*
+* \b Copyright: University of Malaga and Imperial College London - 2019
+*
+* \b Licence: This copy of the 3D Tune-In Toolkit Plugin is licensed to you under the terms described in the LICENSE.md file included in this distribution.
+*
+* \b Acknowledgement: This project has received funding from the European Union's Horizon 2020 research and innovation programme under grant agreements No 644051 and 726765.
+*/
+
+#pragma once
+
+#include "../JuceLibraryCode/JuceHeader.h"
+#include "PluginProcessor.h"
+#include "Utils.h"
+
+//==============================================================================
+/*
+ */
+class AnechoicControls  : public Component, public Slider::Listener
+{
+public:
+  AnechoicControls(Toolkit3dtiPluginAudioProcessor& processor);
+  
+  ~AnechoicControls() {}
+  
+  void updateGui();
+  
+  void paint (Graphics& g) override {
+    g.fillAll (getLookAndFeel().findColour (ResizableWindow::backgroundColourId));   // clear the background
+    g.setColour (Colours::grey);
+    g.drawRect (getLocalBounds(), 1);
+    g.setColour(Colours::white);
+    g.setFont(18.0f);
+    g.drawText("Anechoic Path", getLocalBounds().withTrimmedBottom( getLocalBounds().getHeight() - 32 ),
+                Justification::centred, true);
+  }
+  
+  void resized() override;
+  
+  void sliderValueChanged(Slider* slider) override {
+    if ( slider == &headCircumferenceSlider ) {
+      updateHeadCircumference();
+    } else {
+      mCore.sourceDistanceAttenuation = (float)slider->getValue();
+    }
+  }
+  
+  ToggleButton bypassToggle;
+  
+private:
+  
+  void hrtfMenuChanged();
+  void loadCustomHrtf(String fileTypes);
+  void updateBypass();
+  void updateHeadCircumference();
+  void updateHrtfLabelText();
+  void updateNearFieldCorrection();
+  void updateFarFieldCorrection();
+  void updateQualitySetting();
+  void updateDistanceAttenuation();
+  
+  Toolkit3dtiPluginAudioProcessor& mProcessor;
+  Toolkit3dtiProcessor& mCore;
+  
+  ComboBox hrtfMenu;
+  ToggleButton headCircumferenceToggle;
+  Slider headCircumferenceSlider;
+  std::unique_ptr<FileChooser> fc;
+  
+  ToggleButton nearFieldToggle;
+  ToggleButton farFieldToggle;
+  ToggleButton qualityToggle;
+  ToggleButton distanceAttenuationToggle;
+  Label distanceAttenuationLabel;
+  Slider distanceAttenuationSlider;
+  
+  JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR (AnechoicControls)
+};

Resources/Images/Imperial_Logo.png

@@ -0,0 +1,43 @@
+/**
+* \class ElevationDial
+*
+* \brief Declaration of ElevationDial interface.
+* \date  June 2019
+*
+* \authors Reactify Music LLP: R. Hrafnkelsson ||
+* Coordinated by , A. Reyes-Lecuona (University of Malaga) and L.Picinali (Imperial College London) ||
+* \b Contact: areyes@uma.es and l.picinali@imperial.ac.uk
+*
+* \b Project: 3DTI (3D-games for TUNing and lEarnINg about hearing aids) ||
+* \b Website: http://3d-tune-in.eu/
+*
+* \b Copyright: University of Malaga and Imperial College London - 2019
+*
+* \b Licence: This copy of the 3D Tune-In Toolkit Plugin is licensed to you under the terms described in the LICENSE.md file included in this distribution.
+*
+* \b Acknowledgement: This project has received funding from the European Union's Horizon 2020 research and innovation programme under grant agreements No 644051 and 726765.
+*/
+
+#pragma once
+
+#include "../JuceLibraryCode/JuceHeader.h"
+
+//==============================================================================
+/*
+*/
+
+class ElevationDial : public Slider {
+public:
+  
+  // TODO(Ragnar): Better implementation of this
+  bool hitTest (int x, int y) override {
+    // const int thumbHeight = getLookAndFeel().getSliderThumbRadius(*this);
+    const int thumbCentre = valueToProportionOfLength (getValue()) * getHeight();
+    // DBG("Thumb centre: " + String(thumbCentre));
+    // return (std::abs(y - thumbCentre) < thumbHeight);
+    bool isAtEdges = (thumbCentre < 25 || thumbCentre > 95);
+    int cutoff = isAtEdges ? 50 : 65;
+    return x > cutoff;
+  }
+
+};