ShaderTools: Add DXCompiler library loader for macOS

Author: MikhailGorobets

Graphics/GraphicsEngine/interface/GraphicsTypes.h

@@ -4262,6 +4262,12 @@ struct EngineMtlCreateInfo DILIGENT_DERIVE(EngineCreateInfo)
     #endif
     ;
 
+    /// Path to DirectX Shader Compiler, which is required to use Shader Model 6.0+
+    /// features when compiling shaders from HLSL (e.g. mesh shaders).
+
+    /// By default, the engine will search for "libdxcompiler.dylib".
+    const Char* pDxCompilerPath DEFAULT_INITIALIZER(nullptr);
+
 #if DILIGENT_CPP_INTERFACE
     EngineMtlCreateInfo() noexcept :
         EngineMtlCreateInfo{EngineCreateInfo{}}

Graphics/GraphicsEngineVulkan/CMakeLists.txt

@@ -243,6 +243,16 @@ if(PLATFORM_LINUX)
     set(DXC_SPIRV_PATH "/usr/lib/dxc/libdxcompiler.so")
 endif()
 
+if(PLATFORM_MACOS)
+    if(VULKAN_SDK)
+        if(EXISTS "${VULKAN_SDK}/lib/libdxcompiler.dylib")
+            set(DXC_SPIRV_PATH "${VULKAN_SDK}/lib/libdxcompiler.dylib")
+        elseif(EXISTS "${VULKAN_SDK}/macOS/lib/libdxcompiler.dylib")
+            set(DXC_SPIRV_PATH "${VULKAN_SDK}/macOS/lib/libdxcompiler.dylib")
+        endif()
+    endif()
+endif()
+
 if(EXISTS ${DXC_SPIRV_PATH})
     set(DILIGENT_DXCOMPILER_FOR_SPIRV_PATH "${DXC_SPIRV_PATH}" CACHE INTERNAL "" FORCE)
     message(STATUS "Found DXCompiler for Vulkan: " ${DILIGENT_DXCOMPILER_FOR_SPIRV_PATH})

Graphics/ShaderTools/CMakeLists.txt

@@ -19,7 +19,7 @@ set(SOURCE
 )
 
 set(DXC_SUPPORTED FALSE)
-if((PLATFORM_WIN32 AND NOT MINGW_BUILD) OR PLATFORM_UNIVERSAL_WINDOWS OR PLATFORM_LINUX)
+if((PLATFORM_WIN32 AND NOT MINGW_BUILD) OR PLATFORM_UNIVERSAL_WINDOWS OR PLATFORM_LINUX OR PLATFORM_MACOS)
     set(DXC_SUPPORTED TRUE)
 endif()
 
@@ -73,11 +73,13 @@ if (DXC_SUPPORTED)
         list(APPEND SOURCE src/DXCompilerLibraryUWP.cpp)
     elseif(PLATFORM_LINUX)
         list(APPEND SOURCE src/DXCompilerLibraryLinux.cpp)
+    elseif(PLATFORM_MACOS)
+        list(APPEND SOURCE src/DXCompilerLibraryMacOS.cpp)
     else()
         message(FATAL_ERROR "Unexpected platform")
     endif()
 
-    if(PLATFORM_LINUX)
+    if(PLATFORM_LINUX OR PLATFORM_MACOS)
         list(APPEND INCLUDE
             ../../ThirdParty/DirectXShaderCompiler/dxc/dxcapi.h
             ../../ThirdParty/DirectXShaderCompiler/dxc/WinAdapter.h

Graphics/ShaderTools/include/DXCompilerLibrary.hpp

@@ -1,5 +1,5 @@
 /*
- *  Copyright 2024-2025 Diligent Graphics LLC
+ *  Copyright 2024-2026 Diligent Graphics LLC
  *
  *  Licensed under the Apache License, Version 2.0 (the "License");
  *  you may not use this file except in compliance with the License.
@@ -37,7 +37,7 @@
 #    include <Unknwn.h>
 #    include "WinHPostface.h"
 
-#elif PLATFORM_LINUX
+#elif PLATFORM_LINUX || PLATFORM_MACOS
 
 #else
 #    error Unsupported platform

Graphics/ShaderTools/src/DXCompilerLibraryMacOS.cpp

@@ -0,0 +1,62 @@
+/*
+ *  Copyright 2026 Diligent Graphics LLC
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ *
+ *  In no event and under no legal theory, whether in tort (including negligence),
+ *  contract, or otherwise, unless required by applicable law (such as deliberate
+ *  and grossly negligent acts) or agreed to in writing, shall any Contributor be
+ *  liable for any damages, including any direct, indirect, special, incidental,
+ *  or consequential damages of any character arising as a result of this License or
+ *  out of the use or inability to use the software (including but not limited to damages
+ *  for loss of goodwill, work stoppage, computer failure or malfunction, or any and
+ *  all other commercial damages or losses), even if such Contributor has been advised
+ *  of the possibility of such damages.
+ */
+
+#include "DXCompilerLibrary.hpp"
+
+#include <dlfcn.h>
+
+namespace Diligent
+{
+
+void DXCompilerLibrary::Load()
+{
+    if (!m_LibName.empty())
+        m_Library = dlopen(m_LibName.c_str(), RTLD_LOCAL | RTLD_LAZY);
+
+    if (m_Library == nullptr)
+        m_Library = dlopen("libdxcompiler.dylib", RTLD_LOCAL | RTLD_LAZY);
+
+    // try to load from Homebrew path
+    if (m_Library == nullptr)
+        m_Library = dlopen("/usr/local/lib/libdxcompiler.dylib", RTLD_LOCAL | RTLD_LAZY);
+
+    // try to load from Homebrew on Apple Silicon
+    if (m_Library == nullptr)
+        m_Library = dlopen("/opt/homebrew/lib/libdxcompiler.dylib", RTLD_LOCAL | RTLD_LAZY);
+
+    m_DxcCreateInstance = m_Library != nullptr ? reinterpret_cast<DxcCreateInstanceProc>(dlsym(m_Library, "DxcCreateInstance")) : nullptr;
+}
+
+void DXCompilerLibrary::Unload()
+{
+    if (m_Library != nullptr)
+    {
+        dlclose(m_Library);
+        m_Library = nullptr;
+    }
+}
+
+} // namespace Diligent

Graphics/ShaderTools/src/SPIRVShaderResources.cpp

@@ -902,7 +902,7 @@ SPIRVShaderResources::SPIRVShaderResources(IMemoryAllocator&     Allocator,
 
     VERIFY(ResourceNamesPool.GetRemainingSize() == 0, "Names pool must be empty");
 
-    if (m_ShaderType == SHADER_TYPE_COMPUTE)
+    if (m_ShaderType == SHADER_TYPE_COMPUTE || m_ShaderType == SHADER_TYPE_MESH || m_ShaderType == SHADER_TYPE_AMPLIFICATION)
     {
         for (uint32_t i = 0; i < m_ComputeGroupSize.size(); ++i)
             m_ComputeGroupSize[i] = Compiler.get_execution_mode_argument(spv::ExecutionModeLocalSize, i);