refactor: Improve RTT update graph and node insertion

This commit enhances the Render-to-Texture (RTT) node handling by refining inheritance, update propagation, and insertion logic:

- RTT Inheritance Refactor: Streamlined RTT inheritance between child and parent nodes, ensuring a consistent RTT state across the hierarchy.
- Efficient RTT Clearing: Optimized the clearing of RTT nodes
- Update Loop Optimization: Removed duplicate `update()` calls for RTT nodes for improved performance
- Hierarchical RTT Node Insertion: Implemented an insertion strategy that respects the hierarchy when adding new RTT nodes, ensuring that child RTT nodes render before parent RTT nodes.

Author: wouterlucas

examples/index.ts

@@ -382,7 +382,9 @@ async function runAutomation(
       // Override Math.random() as stable random number generator
       // - Each test gets the same sequence of random numbers
       // - This only is in effect when tests are run in automation mode
-      const rand = mt19937.factory({ seed: 1234 });
+      // eslint-disable-next-line @typescript-eslint/unbound-method
+      const factory = mt19937.factory || mt19937.default.factory;
+      const rand = factory({ seed: 1234 });
       Math.random = function () {
         return rand() / rand.MAX;
       };

examples/tests/rtt-dimension.ts

@@ -2,8 +2,13 @@ import type { ExampleSettings } from '../common/ExampleSettings.js';
 import rocko from '../assets/rocko.png';
 
 export async function automation(settings: ExampleSettings) {
-  await test(settings);
-  await settings.snapshot();
+  const page = await test(settings);
+
+  const maxPages = 6;
+  for (let i = 0; i < maxPages; i++) {
+    page(i);
+    await settings.snapshot();
+  }
 }
 
 export default async function test({ renderer, testRoot }: ExampleSettings) {
@@ -251,4 +256,44 @@ export default async function test({ renderer, testRoot }: ExampleSettings) {
       rttNode.height = rttNode.height === 200 ? 300 : 200;
     }
   });
+
+  // Define the page function to configure different test scenarios
+  const page = (i = 0) => {
+    switch (i) {
+      case 1:
+        rttNode.rtt = false;
+        rttNode2.rtt = false;
+        rttNode3.rtt = false;
+        break;
+
+      case 2:
+        rttNode.rtt = true;
+        rttNode2.rtt = true;
+        rttNode3.rtt = true;
+        break;
+
+      case 4:
+        // Modify child texture properties in nested RTT node
+        rocko4.x = 0;
+        break;
+
+      case 5:
+        nestedRTTNode1.rtt = false;
+        break;
+
+      case 6:
+        nestedRTTNode1.rtt = true;
+        break;
+
+      default:
+        // Reset to initial state
+        rttNode.rtt = true;
+        rttNode2.rtt = true;
+        rttNode3.rtt = true;
+        nestedRTTNode1.rtt = true;
+        break;
+    }
+  };
+
+  return page;
 }