Line-of-Sight audio Occlusion and Obstruction

CMakeLists.txt

@@ -43,6 +43,7 @@ ccp_add_library(CarbonAudio SHARED
 	src/AudGameObjResource.cpp
 	src/AudGeometry.cpp
 	src/AudGeometry_Blue.cpp
+    src/AudObstructionOcclusion.cpp
 	src/SpatialAudioSettings.cpp
 	src/audio2.cpp
 	src/AudGameObjResource_Blue.cpp
@@ -83,6 +84,7 @@ target_sources(CarbonAudio PRIVATE
 	src/AudUIPlayer.h
 	src/AudMusicPlayer.h
 	src/AudGeometry.h
+    src/AudObstructionOcclusion.h
 	src/SpatialAudioSettings.h
 	src/autoversion.h
 	src/DebugUtilities.h
@@ -187,6 +189,14 @@ if(CMAKE_PROJECT_NAME STREQUAL PROJECT_NAME)
             RUNTIME DESTINATION bin/${CCP_PLATFORM}/${CCP_ARCHITECTURE}/${CCP_TOOLSET}
         )
 
+       if(MSVC)
+            install(
+                FILES $<TARGET_PDB_FILE:CarbonAudio>
+                CONFIGURATIONS ${CMAKE_CONFIGURATION_TYPES}
+                DESTINATION bin/${CCP_PLATFORM}/${CCP_ARCHITECTURE}/${CCP_TOOLSET}
+                OPTIONAL
+            )
+        endif()
         # Generate target configuration for the monolith
         configure_ccp_vendor_config_file(
             TARGET CarbonAudio

InstallToMonolith.vcxproj

@@ -20,15 +20,12 @@
   </PropertyGroup>
   <Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
   <PropertyGroup>
-    <!--
-      CCP_EVE_PERFORCE_BRANCH_PATH points at the P4V branch root, e.g. D:\frontier-master.
-      Fall back to HKCU\Environment so a Visual Studio started before the variable
-      was set still picks it up without a restart.
-    -->
     <MonolithBranchRoot>$(CCP_EVE_PERFORCE_BRANCH_PATH)</MonolithBranchRoot>
     <MonolithBranchRoot Condition="'$(MonolithBranchRoot)' == ''">$([MSBuild]::GetRegistryValue('HKEY_CURRENT_USER\Environment', 'CCP_EVE_PERFORCE_BRANCH_PATH'))</MonolithBranchRoot>
-    <MonolithInstallPrefix Condition="'$(MonolithBranchRoot)' != ''">$(MonolithBranchRoot.Replace('\', '/'))/vendor/github.com/ccpgames/carbon-audio/develop</MonolithInstallPrefix>
+    <MonolithInstallPrefix Condition="'$(MonolithBranchRoot)' != ''">$(MonolithBranchRoot.Replace('\', '/'))/vendor/github.com/carbonengine/audio/develop</MonolithInstallPrefix>
+    <MonolithInstallDirWin Condition="'$(MonolithBranchRoot)' != ''">$(MonolithBranchRoot)\vendor\github.com\carbonengine\audio\develop</MonolithInstallDirWin>
     <MonolithBuildDir>.cmake-build-monolith</MonolithBuildDir>
+    <VsScratchDir>$(ProjectDir)$(MonolithBuildDir)\.vs-installtomonolith\$(Platform)\$(Configuration)\</VsScratchDir>
     <RepoRoot>$(ProjectDir.Replace('\', '/'))</RepoRoot>
     <MonolithBuildScript>setlocal
 cd /d "$(ProjectDir)"
@@ -39,18 +36,26 @@ set "PATH_TO_VCPKG_ROOT=$(ProjectDir)vendor\github.com\microsoft\vcpkg"
 echo Installing CarbonAudio to: $(MonolithInstallPrefix)
 cmake -S . -B $(MonolithBuildDir) -G "Visual Studio 18 2026" "-DCMAKE_TOOLCHAIN_FILE=$(RepoRoot)vendor/github.com/microsoft/vcpkg/scripts/buildsystems/vcpkg.cmake" "-DVCPKG_CHAINLOAD_TOOLCHAIN_FILE=$(RepoRoot)vendor/github.com/carbonengine/vcpkg-registry/toolchains/x64-windows-145-carbon.cmake" "-DVCPKG_OVERLAY_TRIPLETS=$(RepoRoot)vendor/github.com/carbonengine/vcpkg-registry/triplets" -DVCPKG_TARGET_TRIPLET=x64-windows-internal -DVCPKG_HOST_TRIPLET=x64-windows-internal -DVCPKG_USE_HOST_TOOLS=ON -DINSTALL_TO_MONOLITH=ON -DBUILD_TESTING=OFF "-DCMAKE_INSTALL_PREFIX=$(MonolithInstallPrefix)"
 if errorlevel 1 exit /b 1
+if exist "$(MonolithInstallDirWin)" echo Removing existing install at: $(MonolithInstallDirWin)
+if exist "$(MonolithInstallDirWin)" rmdir /s /q "$(MonolithInstallDirWin)"
 cmake --build $(MonolithBuildDir) --config Internal --target INSTALL
 if errorlevel 1 exit /b 1
 echo === CarbonAudio installed to $(MonolithInstallPrefix) ===
 </MonolithBuildScript>
   </PropertyGroup>
   <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Internal|x64'">
+    <IntDir>$(VsScratchDir)</IntDir>
+    <OutDir>$(VsScratchDir)</OutDir>
     <NMakeBuildCommandLine>$(MonolithBuildScript)</NMakeBuildCommandLine>
     <NMakeReBuildCommandLine>cd /d "$(ProjectDir)"
 if exist $(MonolithBuildDir) rmdir /s /q $(MonolithBuildDir)
+mkdir "$(VsScratchDir)" 2&gt;nul
 $(MonolithBuildScript)</NMakeReBuildCommandLine>
     <NMakeCleanCommandLine>cd /d "$(ProjectDir)"
-if exist $(MonolithBuildDir) rmdir /s /q $(MonolithBuildDir)</NMakeCleanCommandLine>
+if exist $(MonolithBuildDir) rmdir /s /q $(MonolithBuildDir)
+mkdir "$(VsScratchDir)" 2&gt;nul
+if exist "$(MonolithInstallDirWin)" echo Removing install at: $(MonolithInstallDirWin)
+if exist "$(MonolithInstallDirWin)" rmdir /s /q "$(MonolithInstallDirWin)"</NMakeCleanCommandLine>
     <NMakeOutput>$(ProjectDir)$(MonolithBuildDir)\Internal\_audio2_internal.pyd</NMakeOutput>
     <NMakePreprocessorDefinitions>WIN32;NDEBUG;$(NMakePreprocessorDefinitions)</NMakePreprocessorDefinitions>
   </PropertyGroup>

src/AudManager.cpp

@@ -80,6 +80,7 @@ AudManager::AudManager( IRoot* lockobj ) :
 	// Initialize sound prioritization system
 	m_soundPrioritization = new SoundPrioritization();
 	m_spatialAudioSettings = new SpatialAudioSettings();
+	m_obstructionOcclusion = std::make_unique<AudObstructionOcclusion>( this );
 }
 
 AudManager::~AudManager()
@@ -117,6 +118,8 @@ void AudManager::Process()
 			m_soundPrioritization->CullAudio();
 		}
 
+		m_obstructionOcclusion->Update();
+
 		// Process bank requests, events, positions, RTPC, etc.
 		AK::SoundEngine::RenderAudio();
 
@@ -340,6 +343,11 @@ void AudManager::UnregisterGameObject( AkGameObjectID gameObjID )
 	{
 		m_soundPrioritization->UnregisterGameObject( gameObjID );
 	}
+
+	if( m_obstructionOcclusion )
+	{
+		m_obstructionOcclusion->RemoveEmitter( gameObjID );
+	}
 }
 
 bool AudManager::InitCommunication()
@@ -530,6 +538,41 @@ const bool AudManager::SpatialAudioIsSupported()
 	return s_systemSupportsSpatialAudio;
 }
 
+bool AudManager::SetEmitterLineOfSightBlockage( AkGameObjectID emitterID, float blockage )
+{
+	return m_obstructionOcclusion->SetEmitterLineOfSightBlockage( emitterID, blockage );
+}
+
+float AudManager::GetEmitterOcclusion( AkGameObjectID emitterID ) const
+{
+	return m_obstructionOcclusion->GetEmitterOcclusion( emitterID );
+}
+
+void AudManager::ClearObstructionOcclusion()
+{
+	m_obstructionOcclusion->ClearAll();
+}
+
+bool AudManager::GetObstructionOcclusionEnabled() const
+{
+	return m_obstructionOcclusion->IsEnabled();
+}
+
+void AudManager::SetObstructionOcclusionEnabled( bool value )
+{
+	m_obstructionOcclusion->SetEnabled( value );
+}
+
+float AudManager::GetObstructionOcclusionFadeRate() const
+{
+	return m_obstructionOcclusion->GetFadeRate();
+}
+
+void AudManager::SetObstructionOcclusionFadeRate( float value )
+{
+	m_obstructionOcclusion->SetFadeRate( value );
+}
+
 void AudManager::UpdateSettings( AudSettings* settings )
 {
 	m_settings = settings;
@@ -776,6 +819,7 @@ void AudManager::Disable()
 	}
 
 	ClearBanks();
+	m_obstructionOcclusion->Reset();
   AudGeometry::ClearAllGeometry();
 #ifndef AK_OPTIMIZED
 	AK::SoundEngine::UnregisterResourceMonitorCallback(ResourceMonitorCallback);

src/AudManager.h

@@ -9,6 +9,7 @@
 #include "AudListener.h"
 #include "SoundPrioritization.h"
 #include "SpatialAudioSettings.h"
+#include "AudObstructionOcclusion.h"
 #include "LowLevelIO/LowLevelIOHook.h"
 #include <atomic>
 #include <memory>
@@ -122,6 +123,18 @@ BLUE_CLASS( AudManager ) :
 	bool GetSpatialAudioGeometryEnabled() const;
 	// Enables or disables spatial audio geometry.
 	void SetSpatialAudioGeometryEnabled( bool enabled );
+	// Set a single line-of-sight blockage ratio for an emitter [0.0, 1.0]. 0 = clear line of sight.
+	bool SetEmitterLineOfSightBlockage( AkGameObjectID emitterID, float blockage );
+	// Current, mid-fade occlusion value for an emitter. 0.0 if the emitter is clear or not tracked.
+	float GetEmitterOcclusion( AkGameObjectID emitterID ) const;
+	// Fade all obstruction/occlusion values back to clear.
+	void ClearObstructionOcclusion();
+	// Enable or disable game-driven obstruction/occlusion processing.
+	bool GetObstructionOcclusionEnabled() const;
+	void SetObstructionOcclusionEnabled( bool value );
+	// How fast obstruction/occlusion values fade towards their targets, in units per second.
+	float GetObstructionOcclusionFadeRate() const;
+	void SetObstructionOcclusionFadeRate( float value );
 	// Can be called to see if the current platform supports spatial audio.
 	const bool SpatialAudioIsSupported();
 	// Stop all currently playing sounds on all game objects.
@@ -239,6 +252,7 @@ BLUE_CLASS( AudManager ) :
 
 	SoundPrioritization* m_soundPrioritization;
 	SpatialAudioSettings* m_spatialAudioSettings;
+	std::unique_ptr<AudObstructionOcclusion> m_obstructionOcclusion;
 
 	//  Map of game objects, used to guard Wwise callbacks
 	std::unordered_map<AkGameObjectID, AudGameObjResource*> m_callbackGameObjects;

src/AudManager_Blue.cpp

@@ -49,6 +49,10 @@ const Be::ClassInfo* AudManager::ExposeToBlue()
 		MAP_PROPERTY( "transmissionLoss", GetTransmissionLoss, SetTransmissionLoss, "Per-mesh setting: transmission loss [0.0-1.0] applied to geometry surfaces when meshes are registered.")
 		MAP_PROPERTY( "enableDiffraction", GetEnableDiffraction, SetEnableDiffraction, "Per-mesh setting: enable or disable geometric diffraction on mesh geometry.")
 		MAP_PROPERTY( "enableDiffractionOnBoundaryEdges", GetEnableDiffractionOnBoundaryEdges, SetEnableDiffractionOnBoundaryEdges, "Per-mesh setting: switch to enable or disable geometric diffraction on boundary edges for this mesh.")
+
+		// Obstruction / occlusion
+		MAP_PROPERTY( "obstructionOcclusionEnabled", GetObstructionOcclusionEnabled, SetObstructionOcclusionEnabled, "Enable or disable game-driven obstruction/occlusion processing. Disabling fades all values back to clear.")
+		MAP_PROPERTY( "obstructionOcclusionFadeRate", GetObstructionOcclusionFadeRate, SetObstructionOcclusionFadeRate, "How fast obstruction/occlusion values fade towards their targets, in units per second. 0 = instantaneous.")
 
 		MAP_METHOD_AND_WRAP
 		( 
@@ -160,6 +164,26 @@ const Be::ClassInfo* AudManager::ExposeToBlue()
 			":param stateName: The state you want to set in Wwise."
 		)
 		MAP_METHOD_AND_WRAP
+		(
+			"SetEmitterLineOfSightBlockage",
+			SetEmitterLineOfSightBlockage,
+			"Set a line-of-sight blockage ratio [0.0-1.0] for an emitter (0 = clear). Returns True if the emitter exists."
+		)
+		MAP_METHOD_AND_WRAP
+		(
+			"GetEmitterOcclusion",
+			GetEmitterOcclusion,
+			"Get the occlusion value currently applied to an emitter. This is the live, mid-fade value "
+			"rather than the target that was set, so it can be used to observe a fade in progress. "
+			"Returns 0.0 if the emitter is clear or is not being tracked."
+		)
+		MAP_METHOD_AND_WRAP
+		(
+			"ClearObstructionOcclusion",
+			ClearObstructionOcclusion,
+			"Fade the obstruction/occlusion values of all tracked emitters back to clear."
+		)
+		MAP_METHOD_AND_WRAP
 		( 
 			"SpatialAudioIsSupported",
 			SpatialAudioIsSupported,