Update hdas for openmoonray 2026.29.1

README.md

@@ -1,21 +1,54 @@
 # moonray_dcc_plugins - part of the [MoonRay](https://github.com/OpenMoonRay/openmoonray) project
+
 Policies concerning [Governance](https://github.com/OpenMoonRay/openmoonray/blob/main/GOVERNANCE.md), [Code of Conduct](https://github.com/OpenMoonRay/openmoonray/blob/main/CODE_OF_CONDUCT.md), and [Contribution](https://github.com/OpenMoonRay/openmoonray/blob/main/CONTRIBUTING.md) are available in the overarching MoonRay project, defined in the [`OpenMoonRay/openmoonray` GitHub repository superproject](https://github.com/OpenMoonRay/openmoonray).
 
 This repository contains plugins for DCC apps to support MoonRay.
 
-## houdini 
-Include the folders inside of the houdini folder into your HOUDINI_PATH by copying them into a folder already sourced or adding them to the HOUDINI_PATH environment variable
+# Houdini 
+## Installation
+
+If you folow the cmake build and install instructions in the root repo, this plugin is copied as an installation step and you should not need to do anything if you source the `setupHoudini.sh` script.
+
+If you want to make changes or develop the plugin, note that 
+1. The plugin is copied to `<openmoonray_install_dir>/plugin/houdini`
+2. This path is added to the `HOUDINI_PATH` in `<openmoonray_install_dir>/scripts/{macOS, Rocky9}/setupHoudini.sh` 
+
+It is also possible to copy the plugin to your `~/Houdini20.0/` directory, or another location in `HOUINI_PATH`. Just be careful to not include two different versions of these folders.
+
+> see https://www.sidefx.com/docs/houdini/basics/config.html
+
+
+## Updating
+
+We provide a script `moonray_dcc_plugins/scripts/update_hdas.py` to update the existing `.hda` and `.ds` files from local Moonray modifications. We encourage developers to update relevant nodes with modifications to the underlying renderer.
+
+Runtime dependencies:
+    - hython / hou (Houdini writes the `.hda` and `.ds` files itself)
+    - `rdl2_json_exporter` on $PATH, with $RDL2_DSO_PATH set to the proxy DSOs
+    - pxr Python modules (optional; falls back to static output tags)
+
+1. Set up environment:
+Use houdini shell, or source their setup.sh, for example:
+```
+source <houdini_install_dir>/Houdini20.0.751/Frameworks/Houdini.framework/Versions/Current/Resources/houdini_setup
+```
+
+Add the moonray environment:
+```
+source <openmoonray_install_dir>/scripts/{macOS, Rocky9}/setupHoudini.sh
+```
+
+2. Run script
 
-see https://www.sidefx.com/docs/houdini/basics/config.html
+```
+cd <moonray_dcc_plugins_repo_root>
+hython scripts/update_hdas.py --output-dir ./houdini
+```
 
-- Add to Variable:
-    add the openmoonray/plugin/houdini/ folder to your HOUDINI_PATH
-    ```
-        HOUDINI_PATH = $HOUDINI_PATH:<openmoonray_install_dir>/plugin/houdini
-    ```
+3. Install
+```
+cp houdini/moonray_nodes.json <openmoonray_install_dir>/plugin/houdini
+cp -r houdini/{otls,soho,python*} <openmoonray_install_dir>/plugin/houdini
+```
 
-- copy the folders inside into your local houdini:
-    ```
-        cp -r <openmoonray_install_dir>/plugin/houdini/* ~/houdini19.5/
-    ```
 

houdini/soho/parameters/HdMoonrayRendererPlugin_Aov.ds

@@ -200,6 +200,28 @@
         disablewhen "{ xn__parametersmoonraymaterial_aov_control_g1bh == block } { xn__parametersmoonraymaterial_aov_control_g1bh == none }"
         parmtag { "usdvaluetype" "string" }
     }
+    parm {
+        name    "xn__parametersmoonraymaterial_aov_secondary_rays_control_vqch"
+        label   "parameters:moonray:material_aov_secondary_rays"
+        type    string
+        default { "none" }
+        menujoin {
+            "set"           "![BUTTONS_set_or_create]Set or Create"
+            "setexisting"   "![BUTTONS_set_if_exists]Set if Exists"
+            "block"         "![BUTTONS_set_block]Block"
+            "none"          "![BUTTONS_set_nothing]Do Nothing"
+        }
+        parmtag { "sidefx::look" "icon" }
+    }
+    parm {
+        name    "xn__parametersmoonraymaterial_aov_secondary_rays_udch"
+        label   "Material Aov Secondary Rays"
+        type    toggle
+        default { "0" }
+        help    "When \"result\" is \"material aov\", this controls whether the material aov is evaluated on secondary (indirect) rays in addition to primary rays.  Enabling this allows material aovs to appear behind refractive or reflective surfaces.  Defaults to false for backward compatibility."
+        disablewhen "{ xn__parametersmoonraymaterial_aov_secondary_rays_control_vqch == block } { xn__parametersmoonraymaterial_aov_secondary_rays_control_vqch == none }"
+        parmtag { "usdvaluetype" "bool" }
+    }
     parm {
         name    "xn__parametersmoonraylpe_control_smbh"
         label   "parameters:moonray:lpe"