MDL SDK 2023.1.4 (373000.3036)

Author: jreichel-nvidia

.gitattributes

@@ -4,3 +4,6 @@ src/io/image/image/tests/reference/export_of_test_gray_alpha_bpc_2.png.png filte
 src/io/image/image/tests/reference/export_of_test_pt_uint16.png.tif filter=lfs diff=lfs merge=lfs -text
 src/io/image/image/tests/reference/export_of_test_jpg_progressive.jpg.png filter=lfs diff=lfs merge=lfs -text
 src/io/image/image/tests/test_pt_uint16.png filter=lfs diff=lfs merge=lfs -text
+
+# Prevent MBSDF files without reflection and transmission from being misidentified as text files.
+*.mbsdf binary

CHANGELOG.md

@@ -1,5 +1,57 @@
 Change Log
 ==========
+MDL SDK 2023.1.4 (373000.3036): 18 Mar 2024
+-----------------------------------------------
+
+ABI compatible with the MDL SDK 2023.1.4 (373000.3036) binary release
+(see [https://developer.nvidia.com/mdl-sdk](https://developer.nvidia.com/mdl-sdk))
+
+**Added and Changed Features**
+
+- General
+    - Added a linker script on Linux that hides all defined symbols except for the factory symbol(s).
+    
+- MDL SDK examples
+    - Updated OptiX 7 example to support up to OptiX SDK 8.0.0.
+    - Example AXF to MDL
+        - Added support for AxF 1.9 sheen for SVBRDF representation.
+        - Improved compatibility for refracting carpaint representation.
+        - Improved mapping of Cook-Torrance spreads (used for non-measured BRDF fallback
+          and flake orientation).
+    - Example Execution GLSL: 
+        - Added enable/disable SSBO and noise function remap by command line arguments.
+
+**Fixed Bugs**
+
+- General
+    - Fixed a crash if `IMdl_resolved_resource_element::create_reader()` returns `nullptr`. 
+      This might be due to an incorrect user implementation, or in legitimate cases, e.g.,
+      if the file disappeared between resolving and the query.
+    - Fixed a memory leak involving the interface pointer used with the context option
+      "user_data".
+      
+- MDL Compiler and Backends
+    - Fixed inconsistent storing and reading of matrix material parameters in target
+      argument blocks for the native backend.
+    - Avoid warnings about unsupported PTX features for native backend.
+    - Don't let LLVM abort at shutdown, when writing to stderr fails.
+    - mdltlc: Fixed error in pattern matching of material nodes.
+    - Fixed HLSL/GLSL code generation that sometimes placed temporaries into a
+      loop body that are used outside, causing invalid code.
+    - Fixed crash in the core compiler that might happen on heavily malformed MDL code.
+    - Prevent errors/warnings in the core compiler without line numbers
+      due to internal clone operations.
+    - Slightly speedup compilation in multithreaded operations.
+    - Do not try to resolve empty resource URLs; Note that this is still malformed MDL code.
+
+- MDL SDK examples
+    - Example df_vulkan
+        - Fixed command line options to match other examples for `--mdl_path` / `-p` option.
+    - Example AXF to MDL
+        - Fixed re-coding of BRDF colors table (used in non-measured BRDF fallback).
+    - Example Execution GLSL: 
+        - Fixed OpenGL 3.3 mode.
+
 MDL SDK 2023.1.3 (373000.2208): 14 Feb 2024
 -----------------------------------------------
 

INSTALL.md

@@ -148,7 +148,7 @@ features.
     The old version is available in the
     [CUDA Toolkit Archive](https://developer.nvidia.com/cuda-toolkit-archive).
 
--   **OptiX** *(7.0 to 7.5)*  
+-   **OptiX** *(7.0.0 to 8.0.0)*  
     This dependency is required to build the OptiX 7 example.  
     Please follow the instructions on the [OptiX Website](https://developer.nvidia.com/designworks/optix/download).
 

cmake/linkerscript.txt.in

@@ -0,0 +1,6 @@
+{
+global:
+@_GLOBAL@
+local:
+*;
+};

cmake/utilities.cmake

@@ -678,7 +678,7 @@ function(CREATE_FROM_BASE_PRESET)
     # general option MDL_MSVC_DYNAMIC_RUNTIME_EXAMPLES
     set(options WIN32 WINDOWS_UNICODE EXAMPLE DYNAMIC_MSVC_RUNTIME STATIC_MSVC_RUNTIME SKIP_UNDEFINED_SYMBOL_CHECK)
     set(oneValueArgs TARGET VERSION TYPE NAMESPACE EXPORT_NAME OUTPUT_NAME VS_PROJECT_NAME EMBED_RC)
-    set(multiValueArgs SOURCES ADDITIONAL_INCLUDE_DIRS)
+    set(multiValueArgs SOURCES ADDITIONAL_INCLUDE_DIRS EXPORTED_SYMBOLS)
     cmake_parse_arguments(CREATE_FROM_BASE_PRESET "${options}" "${oneValueArgs}" "${multiValueArgs}" ${ARGN} )
 
     # sanity check
@@ -826,6 +826,25 @@ function(CREATE_FROM_BASE_PRESET)
         endif()
     endif()
 
+    # exported symbols
+    if(CREATE_FROM_BASE_PRESET_EXPORTED_SYMBOLS)
+        if(LINUX)
+            set(_GLOBAL "")
+            foreach(_SYMBOL ${CREATE_FROM_BASE_PRESET_EXPORTED_SYMBOLS})
+                set(_GLOBAL "${_GLOBAL}${_SYMBOL};\n")
+            endforeach()
+            configure_file(
+                "${MDL_BASE_FOLDER}/cmake/linkerscript.txt.in"
+                "${CMAKE_CURRENT_BINARY_DIR}/${CMAKE_BUILD_TYPE}/linkerscript.txt"
+                @ONLY
+            )
+            target_link_libraries(${CREATE_FROM_BASE_PRESET_TARGET}
+                PRIVATE
+                    -Wl,--version-script,${CMAKE_CURRENT_BINARY_DIR}/${CMAKE_BUILD_TYPE}/linkerscript.txt
+            )
+        endif()
+    endif()
+
     # configure visual studio and maybe other IDEs
     setup_ide(TARGET ${CREATE_FROM_BASE_PRESET_TARGET}
         SOURCES ${CREATE_FROM_BASE_PRESET_SOURCES}

doc/base_module/index.html

@@ -169,7 +169,7 @@ <h3>Edge</h3>
 
 </div><div id="blackfooter">
   <span class="footeritem">
-12&#160;February&#160;2024,&#160;20:26,&#160;rev375208, v1.3
+18&#160;March&#160;2024,&#160;20:40,&#160;rev376036, v1.3
 </span>
  <span class="footeritem">
 <a href="https://www.nvidia.com/en-us/about-nvidia/legal-info/">&copy; 2024 NVIDIA&nbsp;Corporation.</a> All rights reserved.

doc/build/doxygen_footer.html

@@ -2,7 +2,7 @@
 <!-- start footer part -->
 <!--BEGIN GENERATE_TREEVIEW-->
 <div id="nav-path">
-<span class="footeritem">MDL SDK 2023.1.3 (373000.2208): $datetime</span>
+<span class="footeritem">MDL SDK 2023.1.4 (373000.3036): $datetime</span>
 <span class="footeritem">
   <a href="http://www.nvidia.com/">
     &copy;&#160;2024&#160;NVIDIA&#160;Corporation.</a>

doc/core_definitions/index.html

@@ -202,8 +202,8 @@ <h2>Page cannot be loaded</h2>
 bottom of the page or from the following links:</p>
 
 <div style="padding-left:2em;">
-<a href="mdl_core_definitions.240212.A4.pdf">View documentation in A4 format</a><br>
-<a href="mdl_core_definitions.240212.LTR.pdf">View documentation in US Letter format</a><br>
+<a href="mdl_core_definitions.240318.A4.pdf">View documentation in A4 format</a><br>
+<a href="mdl_core_definitions.240318.LTR.pdf">View documentation in US Letter format</a><br>
 </div>
 <h3>Overriding security settings</h3>
 
@@ -277,7 +277,7 @@ <h3>Edge</h3>
 <span class="footeritem">
 </span>
   <span class="footeritem">
-12&#160;February&#160;2024,&#160;20:27,&#160;rev375208, v1.4
+18&#160;March&#160;2024,&#160;20:40,&#160;rev376036, v1.4
 </span>
  <span class="footeritem">
 <a href="https://www.nvidia.com/en-us/about-nvidia/legal-info/">&copy; 2024 NVIDIA&nbsp;Corporation.</a> All rights reserved.

doc/index.html

@@ -61,7 +61,7 @@
 </div>
 <div id="blackfooter">
 <span class="footeritem">
-MDL SDK 2023.1.3 (373000.2208): 14 Feb 2024
+MDL SDK 2023.1.4 (373000.3036): 18 Mar 2024
 </span>
 <span class="footeritem">
 <a href="http://www.nvidia.com/">&copy;&#160;2024&#160;NVIDIA&#160;Corporation.</a> &#160;All&#160;rights&#160;reserved.

doc/mdl_sdkapi/getting_started.dox

@@ -109,7 +109,7 @@ of examples is of no interest to you.
     corresponding SDK 10.0.18362.0. Additionally the optional *Graphic Tools*
     feature has to be installed.
 
--   **DirectX Shader Compiler support** (July 2022) (Windows only) \n 
+-   **DirectX Shader Compiler support** (July 2022) (Windows only) \n
     Building the DXR example requires an updated version of the DirectX Shader
     Compiler. \n
     Download and extract the pre-compiled x64 binaries from
@@ -147,7 +147,7 @@ features.
     Pre-compiled binaries can be found on
     [llvm.org](http://releases.llvm.org/download.html#12.0.1).
 
--   **MaterialX** (github repository, tag: v1.38.7, Windows only) \n
+-   **MaterialX** (github repository, tag: v1.38.9, Windows only) \n
     This dependency adds MaterialX support to the DXR example. \n
     Please download a release from
     [github](https://github.com/AcademySoftwareFoundation/MaterialX/releases). \n
@@ -160,7 +160,7 @@ features.
     The old version is available in the
     [CUDA Toolkit Archive](https://developer.nvidia.com/cuda-toolkit-archive).
 
--   **OptiX** (7.0 to 7.5) \n
+-   **OptiX** (7.0.0 to 8.0.0) \n
     This dependency is required to build the OptiX 7 example. \n
     Please follow the instructions on the [OptiX Website](https://developer.nvidia.com/designworks/optix/download).
 

examples/mdl/nvidia/axf_importer/axf_importer.mdl

@@ -38,8 +38,8 @@ import ::math::*;
 // the version of this module loosely follows the corresponding
 // version of the AxF SDK the axf importer uses / supports
 module [[
-	anno::version(1, 7, 100),
-	anno::display_name("Materials used by the AxF importer")
+        anno::version(1, 9, 0),
+        anno::display_name("Materials used by the AxF importer")
 ]];
 
 
@@ -222,6 +222,14 @@ export material svbrdf(
         anno::hidden()
     ]],
     uniform texture_2d specular_amount_texture = texture_2d()
+    [[
+        anno::hidden()
+    ]],
+    uniform texture_2d sheen_color_texture = texture_2d()
+    [[
+        anno::hidden()
+    ]],
+    uniform texture_2d sheen_roughness_texture = texture_2d()
     [[
         anno::hidden()
     ]]
@@ -231,7 +239,7 @@ export material svbrdf(
     anno::hidden(),
     anno::description("MDL implementation of the SVBRDF model used in AxF files"),
     anno::author("NVIDIA Corporation"),
-    anno::copyright_notice("Copyright 2023 NVIDIA Corporation. All rights reserved."),
+    anno::copyright_notice("Copyright 2024 NVIDIA Corporation. All rights reserved."),
     anno::key_words(string[]("axf","svbrdf"))
 ]]
  = let {
@@ -384,6 +392,10 @@ export material svbrdf(
                 df::color_bsdf_component(diffuse.tint, df::diffuse_reflection_bsdf()))
             );
 
+    //
+    // clearcoat
+    //
+    
     float clearcoat_ior = has_clearcoat ? base::file_texture(
         texture:  clearcoat_ior_texture,
         uvw: coordinate,
@@ -410,11 +422,41 @@ export material svbrdf(
     bsdf coated = has_clearcoat ? 
         df::fresnel_layer(ior: clearcoat_ior, weight: 1.0, layer: df::specular_bsdf(tint: clearcoat_color), base: base, normal: clearcoat_normal) : 
         base;
-    
+
+    //
+    // sheen
+    //
+
+    base::texture_return sheen_color = base::file_texture(
+        texture: sheen_color_texture,
+        uvw: coordinate,
+        wrap_u: wrap,
+        wrap_v: wrap,
+        mono_source: base::mono_maximum
+        );
+
+    base::texture_return sheen_roughness = base::file_texture(
+        texture: sheen_roughness_texture,
+        uvw: coordinate,
+        wrap_u: wrap,
+        wrap_v: wrap,
+        mono_source: base::mono_maximum
+        );
+
+    bool has_sheen = tex::texture_isvalid(sheen_color_texture) && tex::texture_isvalid(sheen_roughness_texture);
+    bsdf coated_sheen = has_sheen ? df::weighted_layer(
+        weight: sheen_color.mono,
+        layer: df::sheen_bsdf(
+            roughness: sheen_roughness.mono,
+            tint: sheen_color.tint / sheen_color.mono,
+            multiscatter_tint: color(1.0f),
+            multiscatter: coated),
+        base: coated) : coated;
+
     bsdf surface = df::weighted_layer(
         weight: 1.0,
         normal: normal,
-        layer: coated
+        layer: coated_sheen
         );
 
     // height texture is in millimeters, respect that in the scale
@@ -875,7 +917,7 @@ export material carpaint(
     anno::hidden(),
     anno::description("MDL approximation of the AxF carpaint material"),
     anno::author("NVIDIA Corporation"),
-    anno::copyright_notice("Copyright 2023 NVIDIA Corporation. All rights reserved."),
+    anno::copyright_notice("Copyright 2024 NVIDIA Corporation. All rights reserved."),
     anno::key_words(string[]("axf","carpaint"))
 ]]
  = let {
@@ -1007,7 +1049,7 @@ export material volumetric(
     anno::hidden(),
     anno::description("MDL version of the AxF volumetric material"),
     anno::author("NVIDIA Corporation"),
-    anno::copyright_notice("Copyright 2023 NVIDIA Corporation. All rights reserved."),
+    anno::copyright_notice("Copyright 2024 NVIDIA Corporation. All rights reserved."),
     anno::key_words(string[]("axf","volumetric"))
 ]]
 = material(

examples/mdl/nvidia/core_definitions.mdl

@@ -69,7 +69,7 @@ module [[
     anno::display_name("NVIDIA core definitions")
 ]];
 
-const string COPYRIGHT = "Copyright 2023 NVIDIA Corporation. All rights reserved.";
+const string COPYRIGHT = "Copyright 2024 NVIDIA Corporation. All rights reserved.";
 
 //some local functions, dont document
 // blend two normals, similar to

examples/mdl/nvidia/core_definitions_de.xlf

@@ -32,7 +32,7 @@
       <note from="translator">::anno::author(string)</note>
     </trans-unit>
     <trans-unit id="6" approved="yes">
-      <source xml:space="preserve">Copyright 2023 NVIDIA Corporation. All rights reserved.</source>
+      <source xml:space="preserve">Copyright 2024 NVIDIA Corporation. All rights reserved.</source>
       <target xml:space="preserve"></target>
       <note from="translator">::anno::copyright_notice(string)</note>
     </trans-unit>

examples/mdl/nvidia/core_definitions_fr.xlf

@@ -324,8 +324,8 @@
 ::anno::author(string) light_ies</note>
             </trans-unit>
             <trans-unit id="56">
-                <source xml:space="preserve">Copyright 2023 NVIDIA Corporation. All rights reserved.</source>
-                <target xml:space="preserve">Copyright 2023 NVIDIA Corporation. Tous droits réservés.</target>
+                <source xml:space="preserve">Copyright 2024 NVIDIA Corporation. All rights reserved.</source>
+                <target xml:space="preserve">Copyright 2024 NVIDIA Corporation. Tous droits réservés.</target>
                 <note from="translator">::anno::copyright_notice(string) blend_colors(color,color,::base::color_layer_mode,float)
 ::anno::copyright_notice(string) file_texture(texture_2d,::base::mono_mode,float,float,float2,float2,float,bool,int,bool)
 ::anno::copyright_notice(string) perlin_noise_texture(color,color,bool,int,bool,float,float,float3,float3,float3,int)