Merge pull request #133 from GPUOpen-LibrariesAndSDKs/develop

Merge develop to master version 3.0

Author: bsavery

.gitignore

@@ -54,6 +54,7 @@ bindings-ok
 
 kernelsCache/
 .hybrid_cache
+.tex_cache
 
 vscode/
 

BlenderPkg/create_zip_addon.py

@@ -14,6 +14,7 @@
 #********************************************************************
 
 import zipfile
+import zlib
 import platform
 from pathlib import Path
 import subprocess
@@ -93,7 +94,8 @@ def create_zip_addon(build_dir):
     zip_addon = build_dir / f"rprblender-{ver[0]}.{ver[1]}.{ver[2]}-{ver[3]}-{OS.lower()}.zip"
 
     print(f"Compressing addon files to: {zip_addon}")
-    with zipfile.ZipFile(zip_addon, 'w') as myzip:
+    with zipfile.ZipFile(zip_addon, 'w', compression=zipfile.ZIP_DEFLATED,
+                         compresslevel=zlib.Z_BEST_COMPRESSION) as myzip:
         for src, package_path in enumerate_addon_data():
             print(f"adding {src} --> {package_path}")
 

Changelog.md

@@ -1,49 +1,34 @@
-# Version 2.5.1
+# Version 3.0
+## New Features:
+-   The new plug-in version incorporates version 2.0 of our Radeon™ ProRender system and brings about these significant changes and enhancements:
+    - Hardware-accelerated ray tracing on AMD Radeon™ RX 6000 series GPUs
+    - Better scaling across multiple devices: the use of two or more GPUs gives a better performance improvement with Radeon ProRender 2.0 than with Radeon ProRender 1.0 in most cases.
+    - Less noise for a given number of render samples.  Using the same number of samples as with Radeon ProRender 1.0 may be slower in some scenes, but noise will be significantly lower.  
+    - RPR 2.0 is the default render mode called “Full”.  Users who wish to use RPR 1.0 can set the render quality mode to “Legacy”.
+    - A new setting for texture cache has been added.  The specified folder will cache textures for rendering, and can be cleaned up by the user if it becomes too large.
+- A new setting called “Contour Rendering” allows non-photorealistic outline style renders.
+- A setting has been added to allow “Motion Blur only in the Velocity AOV” in the Motion Blur settings.  Enabling this setting means that all AOVs will not have motion blur, but the Velocity AOV will contain motion blur information to allow compositing of post-process motion blur.
+- Support for UDIM based tiled image textures has been added
 
-## New Features
--   **Beta support for RPR 2.0 and the capability of using it for Viewport Rendering has been added.  This also gives better support for Point and Spot light softness parameters.  For equivalent sample counts, in most scenes, the noise should be lower, and scaling of render speeds across multiple devices should be better.**
--   The ML Denoising filter speed has been improved.
--   The viewport shading panel has been added in the viewport render mode.
--   Support for “Multiply Add” in the Math node has been added (thanks to user cmdrf for their contribution).
--   Support for muting nodes with the “M” key in the shader editor has been added.
--   Support for the Local mode with the “/” key in the viewport has been added.
--   The Object Info node is now supported in the Full mode.
--   The default adaptive tile size has been increased to 32 for adaptive rendering, which gives better results when rendering with multiple GPUs.
-A new setting in Viewport Sampling called “Samples per second” has been added, with the default being 15. This setting is roughly analogous to “Frames per second”. The viewport render resolution is adjusted during rendering to try and maintain this interactivity. There is also a “Minimum viewport resolution” setting which limits resolution downscaling. For users with high resolution displays, this adaptive resolution can maintain a much better viewport experience.
--   Support of image sequences of textures and sequences of animated OpenVDB files has been added.
--   Final rendering no longer uses the setting “Update samples”.  Renders are exponentially updated after 1, 1, 2, 4, 8, 16, 32, and every 32 samples thereafter.  This is done to maximize performance, especially with RPR 2.0.  Viewport rendering is unchanged.
--   For users interested in testing the latest developments in the Radeon ProRender for Blender plugin, a weekly “Development Build” will be posted on future Mondays. See https://github.com/GPUOpen-LibrariesAndSDKs/RadeonProRenderBlenderAddon/releases or follow the repository on github to get weekly updates.
--   Support for Blender 2.90
-
-## Fixed Issues
--   The Physical Light normalization  now takes transform scaling into account.
--   Export of .rpr files now uses the scene camera property.
--   Backplate images now work in viewport renders.
--   An issue with image texture gamma correction in Hybrid modes has been fixed.
--   Pixel filter settings are now exported to .rpr files.
--   CPU rendering is now selectable in the UI with RPR 2.0 enabled.
--   Rendering animations can no longer cause a memory leak and eventual crash.
--   Export of .rpr files should no longer be slow with many textures in Blender 2.83.
--   Scene sync and render times are now logged to the console.
--   AOV names in the config.json file exported with .rpr are no longer different from expected names.
--   When using collections of objects with the same name there could be a name duplication leading to some objects not being rendered — fixed.
--   Sometimes switching from the Object to the Edit mode in the viewport could result in the loss of an object’s UV coordinates — fixed.
--   Mapping node transformations were off, in particular, combinations of transforms and rotations only took Z into account — fixed.
--   “Generated” UV in the Texture Coordinate mode is now correct.
--   The scale wrap, sin, cos and tan functions in the vector math node are now not supported.
--   Exporting .rpr files to directories with non-latin characters is now supported
--   Fixed artifacts while using the denoiser with tiled rendering
--   Light Group AOVs and ID’s now use 1-4 instead of selecting a “key” or “fill” light group.
-
-## Known Issues
--   macOS ML denoiser may have issues (driver issue being investigated)
--   RPR 2.0 known issues
-    - Shadow and reflection catchers are not yet enabled
-    - Adaptive sampling is disabled
-    - Adaptive subdivision is disabled
-    - On macOS, currently RPR 2.0 uses OpenCL and not metal.
-    - Volumetric absorption does not currently work
+## Issues Fixed:
+-   Using the Uber shader with the “Metalness” reflection mode now matches the Disney shader PBR standard more closely. Among other improvements, the Blender “Principled BRDF” node respects the “Specular” parameter better.
+-   Motion Blur, particularly for rotation, is now more correct.
+-   Animated World settings were not being applied correctly — fixed.
+-   An error when using RGB Curve nodes in some instances — fixed.
+-   Object and material “Pass Index” Blender’s settings are now fully supported. 
+-   Some errors in Hybrid rendering have been resolved.
+-   Some users (particularly users with 4GB VRAM GPUs) could not use Hybrid rendering.  We have added a setting for them to use Hybrid in these instances with lower memory.
+-   A memory leak when rendering animations has been fixed.
+-   An issue involving OpenVDB compatibility with Blender 2.91 has been fixed.  
 
+## Known Issues:
+-   RPR 2.0 has some forthcoming features.  If these are needed, please use the “Legacy” render mode:
+    - Heterogenous volumes;
+    - Adaptive sampling;
+    - Adaptive subdivision.
+-   The first render on macOS® with RPR 2.0 can take a few minutes to start, while the kernels are being compiled.
+macOS® Mojave users should use Legacy mode if seeing crashes with Full mode.
+-   Pixelated textures or color artifacts in textures can sometimes happen in Full mode.
 
 # Version 2.4.11
 
@@ -122,6 +107,5 @@ A new setting in Viewport Sampling called “Samples per second” has been adde
 -   ML Denoiser on macOS (with certain Vega cards) and Ubuntu can produce black pixels.
 
 -   Viewport rendering with RPR 2.0 falls back to use RPR 1.0.
-
 
 -   Invisible area lights can cause firefly artifacts in RPR 2.0.

README-OSX.md

@@ -60,10 +60,10 @@ NOTES:
 
 ### Running
 
-Ensure that the BLENDER_28X_EXE environment variable is set.  For example, add the following to
+Ensure that the BLENDER_EXE environment variable is set.  For example, add the following to
 your ~/.profile with the correct path to the Blender executable:
 
-    export BLENDER_28X_EXE="/Users/amd/Downloads/blender-2.78c-OSX_10.6-x86_64/blender.app/Contents/MacOS/blender"
+    export BLENDER_EXE="/Users/amd/Downloads/blender-2.78c-OSX_10.6-x86_64/blender.app/Contents/MacOS/blender"
 
 To run the local build, use:
 	- ./run_blender_with_rpr_osx.sh

README.md

@@ -70,12 +70,12 @@ run `build.py` to build.
 ## Run Addon while developing it(without real installation)
 
 - make sure you have no installed addon for Blender version you want to use; remove installed version if needed.
-- set environment variable BLENDER_28x_EXE to blender.exe you want to use via the command line or system environment settings.
+- set environment variable BLENDER_EXE to blender.exe you want to use via the command line or system environment settings.
 - run run_blender_with_rpr.cmd
 
 Example:
 
-`set BLENDER_28X_EXE="C:\Program Files\Blender Foundation\Blender 2.81\blender.exe" && run_blender_with_rpr.cmd`
+`set BLENDER_EXE="C:\Program Files\Blender Foundation\Blender 2.81\blender.exe" && run_blender_with_rpr.cmd`
 
 ### Debugging
 

RadeonProImageProcessingSDK

@@ -88,7 +88,7 @@ def copy_rif_sdk():
         'Linux': "Ubuntu18",
         'Darwin': "OSX"
     }[OS]
-    bin_dir = rif_dir / os_str
+    bin_dir = rif_dir / os_str / "Dynamic"
 
     # copying inc files
     shutil.copytree(str(rif_dir / "include"), str(sdk_rif_dir / "inc"))
@@ -109,21 +109,21 @@ def copy_rif_sdk():
             shutil.copy(str(lib), str(sdk_lib_dir))
 
     elif OS == 'Linux':
-        shutil.copy(str(bin_dir / "libRadeonImageFilters.so.1.5.4"),
+        shutil.copy(str(bin_dir / "libRadeonImageFilters.so.1.6.1"),
                     str(sdk_bin_dir / "libRadeonImageFilters.so"))
-        shutil.copy(str(bin_dir / "libRadeonML_MIOpen.so.0.9.7"),
+        shutil.copy(str(bin_dir / "libRadeonML_MIOpen.so.0.9.8"),
                     str(sdk_bin_dir / "libRadeonML_MIOpen.so"))
         shutil.copy(str(bin_dir / "libOpenImageDenoise.so.0.9.0"),
                     str(sdk_bin_dir / "libOpenImageDenoise.so"))
-        shutil.copy(str(bin_dir / "libMIOpen.so.2.0.1"),
+        shutil.copy(str(bin_dir / "libMIOpen.so.2.0.4"),
                     str(sdk_bin_dir / "libMIOpen.so.2"))
 
     elif OS == 'Darwin':
-        shutil.copy(str(bin_dir / "libRadeonImageFilters.1.5.4.dylib"),
+        shutil.copy(str(bin_dir / "libRadeonImageFilters.1.6.1.dylib"),
                     str(sdk_bin_dir / "libRadeonImageFilters.dylib"))
         shutil.copy(str(bin_dir / "libOpenImageDenoise.0.9.0.dylib"),
                     str(sdk_bin_dir / "libOpenImageDenoise.dylib"))
-        shutil.copy(str(bin_dir / "libRadeonML_MPS.0.9.7.dylib"),
+        shutil.copy(str(bin_dir / "libRadeonML_MPS.0.9.8.dylib"),
                     str(sdk_bin_dir / "libRadeonML_MPS.dylib"))
 
         # adjusting id of RIF libs

RadeonProRenderSDK

@@ -17,12 +17,12 @@ REM  *******************************************************************
 
 @echo on
 
-if ""=="%BLENDER_28x_EXE%" goto error
+if ""=="%BLENDER_EXE%" goto error
 
-py cmd_tools/run_blender.py "%BLENDER_28x_EXE%" cmd_tools/test_rpr.py
+py cmd_tools/run_blender.py "%BLENDER_EXE%" cmd_tools/test_rpr.py
 pause
 REM it's much easier to get issue traceback on crash if pause is present; remove if not needed
 exit
 
 :error
-echo "Please set BLENDER_28x_EXE environment variable"
+echo "Please set BLENDER_EXE environment variable"