OpenMoonRay · ashleylee-dwa · Aug 21, 2026 · Aug 21, 2026
diff --git a/docs/_data/user-reference/scene-objects/geometry/RdlCurveGeometry.yml b/docs/_data/user-reference/scene-objects/geometry/RdlCurveGeometry.yml
@@ -1,2 +1,9 @@
 ---
 overview: overviews/RdlCurveGeometryOverview.md
+image_path: /assets/images/user-reference/scene-objects/geometry
+
+attributes:
+  shadow_ray_epsilon_falloff:
+    videos:
+      - video: sreFalloffWedge.mp4
+        text: "shadow_ray_epsilon_falloff [0, 1]"
diff --git a/docs/_data/user-reference/scene-objects/geometry/RdlInstancerGeometry.yml b/docs/_data/user-reference/scene-objects/geometry/RdlInstancerGeometry.yml
@@ -1,2 +1,9 @@
 ---
 overview: overviews/RdlInstancerGeometryOverview.md
+image_path: /assets/images/user-reference/scene-objects/geometry
+
+attributes:
+  shadow_ray_epsilon_falloff:
+    videos:
+      - video: sreFalloffWedge.mp4
+        text: "shadow_ray_epsilon_falloff [0, 1]"
diff --git a/docs/_data/user-reference/scene-objects/geometry/RdlMeshGeometry.yml b/docs/_data/user-reference/scene-objects/geometry/RdlMeshGeometry.yml
@@ -1,2 +1,9 @@
 ---
 overview: overviews/RdlMeshGeometryOverview.md
+image_path: /assets/images/user-reference/scene-objects/geometry
+
+attributes:
+  shadow_ray_epsilon_falloff:
+    videos:
+      - video: sreFalloffWedge.mp4
+        text: "shadow_ray_epsilon_falloff [0, 1]"
diff --git a/docs/_data/user-reference/scene-objects/geometry/RdlPointGeometry.yml b/docs/_data/user-reference/scene-objects/geometry/RdlPointGeometry.yml
@@ -1,2 +1,9 @@
 ---
 overview: overviews/RdlPointGeometryOverview.md
+image_path: /assets/images/user-reference/scene-objects/geometry
+
+attributes:
+  shadow_ray_epsilon_falloff:
+    videos:
+      - video: sreFalloffWedge.mp4
+        text: "shadow_ray_epsilon_falloff [0, 1]"
diff --git a/docs/_data/user-reference/scene-objects/geometry/SphereGeometry.yml b/docs/_data/user-reference/scene-objects/geometry/SphereGeometry.yml
@@ -11,3 +11,7 @@ attributes:
   phi_max:
     videos:
       - video: phi_max.mp4
+  shadow_ray_epsilon_falloff:
+    videos:
+      - video: ../sreFalloffWedge.mp4
+        text: "shadow_ray_epsilon_falloff [0, 1]"
diff --git a/docs/_data/user-reference/scene-objects/geometry/UsdGeometry.yml b/docs/_data/user-reference/scene-objects/geometry/UsdGeometry.yml
@@ -1,2 +1,9 @@
 ---
 overview: overviews/UsdGeometryOverview.md
+image_path: /assets/images/user-reference/scene-objects/geometry
+
+attributes:
+  shadow_ray_epsilon_falloff:
+    videos:
+      - video: sreFalloffWedge.mp4
+        text: "shadow_ray_epsilon_falloff [0, 1]"
diff --git a/docs/_data/user-reference/scene-objects/geometry/UsdInstanceGeometry.yml b/docs/_data/user-reference/scene-objects/geometry/UsdInstanceGeometry.yml
@@ -1,2 +1,9 @@
 ---
 overview: overviews/UsdInstanceGeometryOverview.md
+image_path: /assets/images/user-reference/scene-objects/geometry
+
+attributes:
+  shadow_ray_epsilon_falloff:
+    videos:
+      - video: sreFalloffWedge.mp4
+        text: "shadow_ray_epsilon_falloff [0, 1]"
diff --git a/docs/_data/user-reference/scene-objects/geometry/VdbGeometry.yml b/docs/_data/user-reference/scene-objects/geometry/VdbGeometry.yml
@@ -1,2 +1,9 @@
 ---
 overview: overviews/VdbGeometryOverview.md
+image_path: /assets/images/user-reference/scene-objects/geometry
+
+attributes:
+  shadow_ray_epsilon_falloff:
+    videos:
+      - video: sreFalloffWedge.mp4
+        text: "shadow_ray_epsilon_falloff [0, 1]"
diff --git a/docs/_data/user-reference/scene-objects/lights/CylinderLight.yml b/docs/_data/user-reference/scene-objects/lights/CylinderLight.yml
@@ -5,3 +5,17 @@ image_path: /assets/images/user-reference/scene-objects/lights/CylinderLight
 gallery:
   - image: CylinderLight.png
     text: CylinderLight example
+
+attributes:
+  min_shadow_distance_falloff:
+    videos:
+      - video: ../minSDFalloffWedge.mp4
+        text: "min_shadow_distance_falloff [0, 1]"
+  max_shadow_distance_falloff:
+    videos:
+      - video: ../maxSDFalloffWedge.mp4
+        text: "max_shadow_distance_falloff [0, 1]"
+  clear_radius_falloff:
+    videos:
+      - video: ../clearRadFalloffWedge.mp4
+        text: "clear_radius_falloff [0, 1]"
diff --git a/docs/_data/user-reference/scene-objects/lights/DiskLight.yml b/docs/_data/user-reference/scene-objects/lights/DiskLight.yml
@@ -5,3 +5,17 @@ image_path: /assets/images/user-reference/scene-objects/lights/DiskLight
 gallery:
   - image: DiskLight.png
     text: DiskLight example
+
+attributes:
+  min_shadow_distance_falloff:
+    videos:
+      - video: ../minSDFalloffWedge.mp4
+        text: "min_shadow_distance_falloff [0, 1]"
+  max_shadow_distance_falloff:
+    videos:
+      - video: ../maxSDFalloffWedge.mp4
+        text: "max_shadow_distance_falloff [0, 1]"
+  clear_radius_falloff:
+    videos:
+      - video: ../clearRadFalloffWedge.mp4
+        text: "clear_radius_falloff [0, 1]"
diff --git a/docs/_data/user-reference/scene-objects/lights/DistantLight.yml b/docs/_data/user-reference/scene-objects/lights/DistantLight.yml
@@ -5,3 +5,17 @@ image_path: /assets/images/user-reference/scene-objects/lights/DistantLight
 gallery:
   - image: DistantLight.png
     text: DistantLight example
+
+attributes:
+  min_shadow_distance_falloff:
+    videos:
+      - video: ../minSDFalloffWedge.mp4
+        text: "min_shadow_distance_falloff [0, 1]"
+  max_shadow_distance_falloff:
+    videos:
+      - video: ../maxSDFalloffWedge.mp4
+        text: "max_shadow_distance_falloff [0, 1]"
+  clear_radius_falloff:
+    videos:
+      - video: ../clearRadFalloffWedge.mp4
+        text: "clear_radius_falloff [0, 1]"
diff --git a/docs/_data/user-reference/scene-objects/lights/EnvLight.yml b/docs/_data/user-reference/scene-objects/lights/EnvLight.yml
@@ -5,3 +5,17 @@ image_path: /assets/images/user-reference/scene-objects/lights/EnvLight
 gallery:
   - image: EnvLight.png
     text: EnvLight example
+
+attributes:
+  min_shadow_distance_falloff:
+    videos:
+      - video: ../minSDFalloffWedge.mp4
+        text: "min_shadow_distance_falloff [0, 1]"
+  max_shadow_distance_falloff:
+    videos:
+      - video: ../maxSDFalloffWedge.mp4
+        text: "max_shadow_distance_falloff [0, 1]"
+  clear_radius_falloff:
+    videos:
+      - video: ../clearRadFalloffWedge.mp4
+        text: "clear_radius_falloff [0, 1]"
diff --git a/docs/_data/user-reference/scene-objects/lights/MeshLight.yml b/docs/_data/user-reference/scene-objects/lights/MeshLight.yml
@@ -5,3 +5,17 @@ image_path: /assets/images/user-reference/scene-objects/lights/MeshLight
 gallery:
   - image: MeshLight.png
     text: MeshLight example
+
+attributes:
+  min_shadow_distance_falloff:
+    videos:
+      - video: ../minSDFalloffWedge.mp4
+        text: "min_shadow_distance_falloff [0, 1]"
+  max_shadow_distance_falloff:
+    videos:
+      - video: ../maxSDFalloffWedge.mp4
+        text: "max_shadow_distance_falloff [0, 1]"
+  clear_radius_falloff:
+    videos:
+      - video: ../clearRadFalloffWedge.mp4
+        text: "clear_radius_falloff [0, 1]"
diff --git a/docs/_data/user-reference/scene-objects/lights/RectLight.yml b/docs/_data/user-reference/scene-objects/lights/RectLight.yml
@@ -5,3 +5,17 @@ image_path: /assets/images/user-reference/scene-objects/lights/RectLight
 gallery:
   - image: RectLight.png
     text: RectLight example
+
+attributes:
+  min_shadow_distance_falloff:
+    videos:
+      - video: ../minSDFalloffWedge.mp4
+        text: "min_shadow_distance_falloff [0, 1]"
+  max_shadow_distance_falloff:
+    videos:
+      - video: ../maxSDFalloffWedge.mp4
+        text: "max_shadow_distance_falloff [0, 1]"
+  clear_radius_falloff:
+    videos:
+      - video: ../clearRadFalloffWedge.mp4
+        text: "clear_radius_falloff [0, 1]"
diff --git a/docs/_data/user-reference/scene-objects/lights/SphereLight.yml b/docs/_data/user-reference/scene-objects/lights/SphereLight.yml
@@ -5,3 +5,17 @@ image_path: /assets/images/user-reference/scene-objects/lights/SphereLight
 gallery:
   - image: SphereLight.png
     text: SphereLight example
+
+attributes:
+  min_shadow_distance_falloff:
+    videos:
+      - video: ../minSDFalloffWedge.mp4
+        text: "min_shadow_distance_falloff [0, 1]"
+  max_shadow_distance_falloff:
+    videos:
+      - video: ../maxSDFalloffWedge.mp4
+        text: "max_shadow_distance_falloff [0, 1]"
+  clear_radius_falloff:
+    videos:
+      - video: ../clearRadFalloffWedge.mp4
+        text: "clear_radius_falloff [0, 1]"
diff --git a/docs/_data/user-reference/scene-objects/lights/SpotLight.yml b/docs/_data/user-reference/scene-objects/lights/SpotLight.yml
@@ -5,3 +5,17 @@ image_path: /assets/images/user-reference/scene-objects/lights/SpotLight
 gallery:
   - image: SpotLight.png
     text: SpotLight example
+
+attributes:
+  min_shadow_distance_falloff:
+    videos:
+      - video: ../minSDFalloffWedge.mp4
+        text: "min_shadow_distance_falloff [0, 1]"
+  max_shadow_distance_falloff:
+    videos:
+      - video: ../maxSDFalloffWedge.mp4
+        text: "max_shadow_distance_falloff [0, 1]"
+  clear_radius_falloff:
+    videos:
+      - video: ../clearRadFalloffWedge.mp4
+        text: "clear_radius_falloff [0, 1]"
diff --git a/docs/assets/images/user-reference/scene-objects/geometry/sreFalloff.mp4 b/docs/assets/images/user-reference/scene-objects/geometry/sreFalloff.mp4
diff --git a/docs/assets/images/user-reference/scene-objects/lights/clearRadFalloff.mp4 b/docs/assets/images/user-reference/scene-objects/lights/clearRadFalloff.mp4
diff --git a/docs/assets/images/user-reference/scene-objects/lights/maxSDFalloff.mp4 b/docs/assets/images/user-reference/scene-objects/lights/maxSDFalloff.mp4
diff --git a/docs/assets/images/user-reference/scene-objects/lights/minSDFalloff.mp4 b/docs/assets/images/user-reference/scene-objects/lights/minSDFalloff.mp4
diff --git a/docs/user-reference/how-to-guides/shadow-controls.md b/docs/user-reference/how-to-guides/shadow-controls.md
diff --git a/docs/user-reference/how-to-guides/shadow-ray-manipulation.md b/docs/user-reference/how-to-guides/shadow-ray-manipulation.md
@@ -12,6 +12,18 @@ MoonRay provides a number of different controls that allow us to ignore occludin
 - [max_shadow_distance](#max-shadow-distance)
 - [clear_radius](#clear-radius)
 
+There are also accompanying falloff controls to help soften the terminator:
+
+- `shadow_ray_epsilon_falloff`
+- `min_shadow_distance_falloff`
+- `max_shadow_distance_falloff`
+- `clear_radius`
+
+Each is a value [0, 1] that determines the shadow falloff, with 0 being no shadow falloff, and 1 being full falloff. 
+
+< [!WARNING]
+< Enabling any of these attributes will result in a performance hit, and the impact will depend on how large the shadow gradients are in your scene. 
+
 ## What are shadow rays?
 
 At each shading point in the scene, we must determine whether (and how much) the point is in shadow. The way we measure 

diff --git a/docs/user-reference/scene-objects/geometry/RdlCurveGeometry.md b/docs/user-reference/scene-objects/geometry/RdlCurveGeometry.md
@@ -379,6 +379,16 @@ title: RdlCurveGeometry
       {%-include video-gallery.html videos=site.data.user-reference.scene-objects.geometry.RdlCurveGeometry.attributes.shadow_ray_epsilon.videos data=site.data.user-reference.scene-objects.geometry.RdlCurveGeometry-%}
       {%-include see-also.html links=site.data.user-reference.scene-objects.geometry.RdlCurveGeometry.attributes.shadow_ray_epsilon.links heading=4-%}
     </p>
+    <h3>shadow_ray_epsilon_falloff</h3>
+    <p class="scene-class-type">
+      <b>Float</b>
+      <br>
+      default: 0.0
+      <p class="scene-class-comments">Value [0, 1] that controls the softness of the shadow_ray_epsilon terminator, where 0 means no falloff and 1 means full linear falloff from shadow_ray_epsilon to 0.</p>
+      {%-include image-gallery.html images=site.data.user-reference.scene-objects.geometry.RdlCurveGeometry.attributes.shadow_ray_epsilon_falloff.images data=site.data.user-reference.scene-objects.geometry.RdlCurveGeometry-%}
+      {%-include video-gallery.html videos=site.data.user-reference.scene-objects.geometry.RdlCurveGeometry.attributes.shadow_ray_epsilon_falloff.videos data=site.data.user-reference.scene-objects.geometry.RdlCurveGeometry-%}
+      {%-include see-also.html links=site.data.user-reference.scene-objects.geometry.RdlCurveGeometry.attributes.shadow_ray_epsilon_falloff.links heading=4-%}
+    </p>
   </p>
 </details>
 <details open>

diff --git a/docs/user-reference/scene-objects/geometry/RdlInstancerGeometry.md b/docs/user-reference/scene-objects/geometry/RdlInstancerGeometry.md
@@ -215,6 +215,16 @@ title: RdlInstancerGeometry
       {%-include video-gallery.html videos=site.data.user-reference.scene-objects.geometry.RdlInstancerGeometry.attributes.shadow_ray_epsilon.videos data=site.data.user-reference.scene-objects.geometry.RdlInstancerGeometry-%}
       {%-include see-also.html links=site.data.user-reference.scene-objects.geometry.RdlInstancerGeometry.attributes.shadow_ray_epsilon.links heading=4-%}
     </p>
+    <h3>shadow_ray_epsilon_falloff</h3>
+    <p class="scene-class-type">
+      <b>Float</b>
+      <br>
+      default: 0.0
+      <p class="scene-class-comments">Value [0, 1] that controls the softness of the shadow_ray_epsilon terminator, where 0 means no falloff and 1 means full linear falloff from shadow_ray_epsilon to 0.</p>
+      {%-include image-gallery.html images=site.data.user-reference.scene-objects.geometry.RdlInstancerGeometry.attributes.shadow_ray_epsilon_falloff.images data=site.data.user-reference.scene-objects.geometry.RdlInstancerGeometry-%}
+      {%-include video-gallery.html videos=site.data.user-reference.scene-objects.geometry.RdlInstancerGeometry.attributes.shadow_ray_epsilon_falloff.videos data=site.data.user-reference.scene-objects.geometry.RdlInstancerGeometry-%}
+      {%-include see-also.html links=site.data.user-reference.scene-objects.geometry.RdlInstancerGeometry.attributes.shadow_ray_epsilon_falloff.links heading=4-%}
+    </p>
   </p>
 </details>
 <details open>

diff --git a/docs/user-reference/scene-objects/geometry/RdlMeshGeometry.md b/docs/user-reference/scene-objects/geometry/RdlMeshGeometry.md
@@ -486,6 +486,16 @@ title: RdlMeshGeometry
       {%-include video-gallery.html videos=site.data.user-reference.scene-objects.geometry.RdlMeshGeometry.attributes.shadow_ray_epsilon.videos data=site.data.user-reference.scene-objects.geometry.RdlMeshGeometry-%}
       {%-include see-also.html links=site.data.user-reference.scene-objects.geometry.RdlMeshGeometry.attributes.shadow_ray_epsilon.links heading=4-%}
     </p>
+    <h3>shadow_ray_epsilon_falloff</h3>
+    <p class="scene-class-type">
+      <b>Float</b>
+      <br>
+      default: 0.0
+      <p class="scene-class-comments">Value [0, 1] that controls the softness of the shadow_ray_epsilon terminator, where 0 means no falloff and 1 means full linear falloff from shadow_ray_epsilon to 0.</p>
+      {%-include image-gallery.html images=site.data.user-reference.scene-objects.geometry.RdlMeshGeometry.attributes.shadow_ray_epsilon_falloff.images data=site.data.user-reference.scene-objects.geometry.RdlMeshGeometry-%}
+      {%-include video-gallery.html videos=site.data.user-reference.scene-objects.geometry.RdlMeshGeometry.attributes.shadow_ray_epsilon_falloff.videos data=site.data.user-reference.scene-objects.geometry.RdlMeshGeometry-%}
+      {%-include see-also.html links=site.data.user-reference.scene-objects.geometry.RdlMeshGeometry.attributes.shadow_ray_epsilon_falloff.links heading=4-%}
+    </p>
   </p>
 </details>
 <details open>

diff --git a/docs/user-reference/scene-objects/geometry/RdlPointGeometry.md b/docs/user-reference/scene-objects/geometry/RdlPointGeometry.md
@@ -327,6 +327,16 @@ title: RdlPointGeometry
       {%-include video-gallery.html videos=site.data.user-reference.scene-objects.geometry.RdlPointGeometry.attributes.shadow_ray_epsilon.videos data=site.data.user-reference.scene-objects.geometry.RdlPointGeometry-%}
       {%-include see-also.html links=site.data.user-reference.scene-objects.geometry.RdlPointGeometry.attributes.shadow_ray_epsilon.links heading=4-%}
     </p>
+    <h3>shadow_ray_epsilon_falloff</h3>
+    <p class="scene-class-type">
+      <b>Float</b>
+      <br>
+      default: 0.0
+      <p class="scene-class-comments">Value [0, 1] that controls the softness of the shadow_ray_epsilon terminator, where 0 means no falloff and 1 means full linear falloff from shadow_ray_epsilon to 0.</p>
+      {%-include image-gallery.html images=site.data.user-reference.scene-objects.geometry.RdlPointGeometry.attributes.shadow_ray_epsilon_falloff.images data=site.data.user-reference.scene-objects.geometry.RdlPointGeometry-%}
+      {%-include video-gallery.html videos=site.data.user-reference.scene-objects.geometry.RdlPointGeometry.attributes.shadow_ray_epsilon_falloff.videos data=site.data.user-reference.scene-objects.geometry.RdlPointGeometry-%}
+      {%-include see-also.html links=site.data.user-reference.scene-objects.geometry.RdlPointGeometry.attributes.shadow_ray_epsilon_falloff.links heading=4-%}
+    </p>
   </p>
 </details>
 <details open>

diff --git a/docs/user-reference/scene-objects/geometry/SphereGeometry.md b/docs/user-reference/scene-objects/geometry/SphereGeometry.md
@@ -90,6 +90,16 @@ title: SphereGeometry
       {%-include video-gallery.html videos=site.data.user-reference.scene-objects.geometry.SphereGeometry.attributes.shadow_ray_epsilon.videos data=site.data.user-reference.scene-objects.geometry.SphereGeometry-%}
       {%-include see-also.html links=site.data.user-reference.scene-objects.geometry.SphereGeometry.attributes.shadow_ray_epsilon.links heading=4-%}
     </p>
+    <h3>shadow_ray_epsilon_falloff</h3>
+    <p class="scene-class-type">
+      <b>Float</b>
+      <br>
+      default: 0.0
+      <p class="scene-class-comments">Value [0, 1] that controls the softness of the shadow_ray_epsilon terminator, where 0 means no falloff and 1 means full linear falloff from shadow_ray_epsilon to 0.</p>
+      {%-include image-gallery.html images=site.data.user-reference.scene-objects.geometry.SphereGeometry.attributes.shadow_ray_epsilon_falloff.images data=site.data.user-reference.scene-objects.geometry.SphereGeometry-%}
+      {%-include video-gallery.html videos=site.data.user-reference.scene-objects.geometry.SphereGeometry.attributes.shadow_ray_epsilon_falloff.videos data=site.data.user-reference.scene-objects.geometry.SphereGeometry-%}
+      {%-include see-also.html links=site.data.user-reference.scene-objects.geometry.SphereGeometry.attributes.shadow_ray_epsilon_falloff.links heading=4-%}
+    </p>
   </p>
 </details>
 <details open>