@babylonjs-toolkit/next 9.0.1 → 9.1.0

package/lib/scenemanager.js

@@ -75,13 +75,11 @@ import { GPUParticleSystem } from '@babylonjs/core/Particles/gpuParticleSystem';
 import { AdvancedDynamicTexture } from '@babylonjs/gui/2D/advancedDynamicTexture';
 import { InputText } from '@babylonjs/gui/2D/controls/inputText';
 import { VideoTexture } from '@babylonjs/core/Materials/Textures/videoTexture';
-import { UniversalTerrainMaterial, UniversalTerrainMaterialPlugin } from './universalterrainmaterial';
-import { TreeBranchMaterial, TreeBranchMaterialPlugin } from './treebranchmaterial';
 import { UnitySlider } from './unityslider';
 import { UnityScrollBar } from './unityscrollbar';
 import { UnityDropdownMenu } from './unitydropdownmenu';
 export class SceneManager {
-    static get Version() { return "9.0.1 - R1"; }
+    static get Version() { return "9.1.0 - R1"; }
     static get Copyright() { return "All rights reserved (c) 2024 Mackey Kinard"; }
     static GetEngine(scene) {
         let result = null;
@@ -9263,6 +9261,643 @@ Utilities.LoadingState = -1;
 Utilities.OnPreloaderProgress = null;
 Utilities.OnPreloaderComplete = null;
 Utilities.LoaderItemsMarkedForDisposal = [];
+export class UniversalTerrainMaterial extends CustomShaderMaterial {
+    constructor(name, scene) {
+        super(name, scene);
+        this.terrainInfo = null;
+        this.shader = this.getShaderName();
+        this.plugin = new UniversalTerrainMaterialPlugin(this, this.shader);
+    }
+    awake() {
+    }
+    update() {
+    }
+    getShaderName() {
+        return "UniversalTerrainMaterial";
+    }
+    getTerrainInfo() {
+        return this.terrainInfo;
+    }
+}
+export class UniversalTerrainMaterialPlugin extends CustomShaderMaterialPlugin {
+    constructor(customMaterial, shaderName) {
+        super(customMaterial, shaderName, 100, { UNIVERSALTERRAINMATERIAL: false }, true, true, false);
+        this.colorName = "surfaceAlbedo";
+        this.splatmapSampler = "splatmapSampler";
+        this.detailsSampler = "detailsSampler";
+        this.normalsSampler = "normalsSampler";
+        this.GLSL_CustomFragment = null;
+        this.GLSL_CustomVertex = null;
+        this.GLSL_VertexMainEnd = null;
+        this.GLSL_FragmentUpdateColor = null;
+        this.WGSL_CustomFragment = null;
+        this.WGSL_CustomVertex = null;
+        this.WGSL_VertexMainEnd = null;
+        this.WGSL_FragmentUpdateColor = null;
+    }
+    isCompatible(shaderLanguage) {
+        return (shaderLanguage === ShaderLanguage.WGSL || shaderLanguage === ShaderLanguage.GLSL);
+    }
+    getClassName() {
+        return "UniversalTerrainMaterialPlugin";
+    }
+    getCustomCode(shaderType, shaderLanguage) {
+        const terrainInfo = this.getCustomShaderMaterial().getTerrainInfo();
+        if (shaderType === "vertex") {
+            if (shaderLanguage === ShaderLanguage.WGSL) {
+                if (this.WGSL_CustomVertex == null)
+                    this.WGSL_CustomVertex = this.WGSL_FormatTerrainVertexDefintions(terrainInfo);
+                if (this.WGSL_VertexMainEnd == null)
+                    this.WGSL_VertexMainEnd = this.WGSL_FormatTerrainVertexMainEnd(terrainInfo);
+                return {
+                    CUSTOM_VERTEX_DEFINITIONS: this.WGSL_CustomVertex,
+                    CUSTOM_VERTEX_MAIN_END: this.WGSL_VertexMainEnd,
+                };
+            }
+            else if (shaderLanguage === ShaderLanguage.GLSL) {
+                if (this.GLSL_CustomVertex == null)
+                    this.GLSL_CustomVertex = this.GLSL_FormatTerrainVertexDefintions(terrainInfo);
+                if (this.GLSL_VertexMainEnd == null)
+                    this.GLSL_VertexMainEnd = this.GLSL_FormatTerrainVertexMainEnd(terrainInfo);
+                return {
+                    CUSTOM_VERTEX_DEFINITIONS: this.GLSL_CustomVertex,
+                    CUSTOM_VERTEX_MAIN_END: this.GLSL_VertexMainEnd,
+                };
+            }
+        }
+        else if (shaderType === "fragment") {
+            if (shaderLanguage === ShaderLanguage.WGSL) {
+                if (this.WGSL_CustomFragment == null)
+                    this.WGSL_CustomFragment = this.WGSL_FormatTerrainFragmentDefintions(terrainInfo, this.splatmapSampler, this.detailsSampler, this.normalsSampler);
+                if (this.WGSL_FragmentUpdateColor == null)
+                    this.WGSL_FragmentUpdateColor = this.WGSL_FormatTerrainFragmentUpdateColor(terrainInfo, this.colorName, this.splatmapSampler, this.detailsSampler, this.normalsSampler, SceneManager.TerrainColorCorrection);
+                return {
+                    CUSTOM_FRAGMENT_DEFINITIONS: this.WGSL_CustomFragment,
+                    CUSTOM_FRAGMENT_BEFORE_LIGHTS: this.WGSL_FragmentUpdateColor,
+                };
+            }
+            else if (shaderLanguage === ShaderLanguage.GLSL) {
+                if (this.GLSL_CustomFragment == null)
+                    this.GLSL_CustomFragment = this.GLSL_FormatTerrainFragmentDefintions(terrainInfo, this.splatmapSampler, this.detailsSampler, this.normalsSampler);
+                if (this.GLSL_FragmentUpdateColor == null)
+                    this.GLSL_FragmentUpdateColor = this.GLSL_FormatTerrainFragmentUpdateColor(terrainInfo, this.colorName, this.splatmapSampler, this.detailsSampler, this.normalsSampler, SceneManager.TerrainColorCorrection);
+                return {
+                    CUSTOM_FRAGMENT_DEFINITIONS: this.GLSL_CustomFragment,
+                    CUSTOM_FRAGMENT_BEFORE_LIGHTS: this.GLSL_FragmentUpdateColor,
+                };
+            }
+        }
+        return null;
+    }
+    getUniforms(shaderLanguage) {
+        const wgsl = (shaderLanguage === ShaderLanguage.WGSL);
+        this.vertexDefinitions = this.getCustomShaderMaterial().getCustomVertexCode(wgsl);
+        this.fragmentDefinitions = (wgsl === true) ? this.getCustomShaderMaterial().getCustomFragmentCode(wgsl) : null;
+        return this.getCustomShaderMaterial().getCustomUniforms(wgsl);
+    }
+    getSamplers(samplers) {
+        const customSamplers = this.getCustomShaderMaterial().getCustomSamplers();
+        if (customSamplers != null && customSamplers.length > 0)
+            samplers.push(...customSamplers);
+    }
+    getAttributes(attributes, scene, mesh) {
+        const customAttributes = this.getCustomShaderMaterial().getCustomAttributes();
+        if (customAttributes != null && customAttributes.length > 0)
+            attributes.push(...customAttributes);
+    }
+    prepareDefines(defines, scene, mesh) {
+        if (!this.getIsEnabled())
+            return;
+        this.getCustomShaderMaterial().prepareCustomDefines(defines);
+    }
+    bindForSubMesh(uniformBuffer, scene, engine, subMesh) {
+        if (!this.getIsEnabled())
+            return;
+        this.getCustomShaderMaterial().updateCustomBindings(uniformBuffer);
+    }
+    WGSL_FormatTerrainVertexDefintions(terrainInfo) {
+        let result = "";
+        if (terrainInfo != null && terrainInfo.textureAtlas != null && terrainInfo.splatmapAtlas != null && terrainInfo.splatmapCount > 0) {
+            result = ("\r\n#ifndef TERRAIN_VERTEX_DEFINITIONS\r\n\r\n"
+                + "#define TERRAIN_VERTEX_DEFINITIONS\r\n\r\n"
+                + "varying vSplatmapUV: vec2<f32>;\r\n"
+                + "\r\n"
+                + "#endif\r\n\r\n");
+        }
+        return result;
+    }
+    WGSL_FormatTerrainVertexMainEnd(terrainInfo) {
+        let result = "";
+        if (terrainInfo != null && terrainInfo.textureAtlas != null && terrainInfo.splatmapAtlas != null && terrainInfo.splatmapCount > 0) {
+            result = ("\r\n#ifndef TERRAIN_VERTEX_MAIN_END\r\n\r\n"
+                + "#define TERRAIN_VERTEX_MAIN_END\r\n\r\n"
+                + "#ifdef UV1\r\n"
+                + "vertexOutputs.vSplatmapUV = uvUpdated;\r\n"
+                + "#endif\r\n"
+                + "\r\n"
+                + "#endif\r\n\r\n");
+        }
+        return result;
+    }
+    WGSL_FormatTerrainFragmentDefintions(terrainInfo, splatmapSampler, detailsSampler, normalsSampler) {
+        let result = "";
+        if (terrainInfo != null && terrainInfo.textureAtlas != null && terrainInfo.splatmapAtlas != null && terrainInfo.splatmapCount > 0) {
+            result = ("\r\n#ifndef TERRAIN_FRAGMENT_DEFNITIONS\r\n\r\n"
+                + "#define TERRAIN_FRAGMENT_DEFNITIONS\r\n\r\n"
+                + "varying vSplatmapUV: vec2<f32>;\r\n"
+                + "\r\n"
+                + "fn srgb_to_linear(c: vec3<f32>) -> vec3<f32>\r\n"
+                + "{\r\n"
+                + "    return pow(c, vec3<f32>(2.2));\r\n"
+                + "}\r\n"
+                + "\r\n"
+                + "fn linear_to_srgb(c: vec3<f32>) -> vec3<f32>\r\n"
+                + "{\r\n"
+                + "    return pow(c, vec3<f32>(1.0 / 2.2));\r\n"
+                + "}\r\n"
+                + "\r\n"
+                + "fn calculateMipmapLevel(uvs: vec2<f32>, size: vec2<f32>) -> f32\r\n"
+                + "{\r\n"
+                + "    let dx: vec2<f32> = dpdx(uvs * size.x);\r\n"
+                + "    let dy: vec2<f32> = dpdy(uvs * size.y);\r\n"
+                + "    let d: f32 = max(dot(dx, dx), dot(dy, dy));\r\n"
+                + "    return (0.4 * log2(d));\r\n"
+                + "}\r\n"
+                + "\r\n"
+                + "fn sampleTextureAtlas2D(atlas: texture_2d<f32>, sampler: sampler, gamma: f32, tile: vec2<f32>, rect: vec4<f32>, uvs: vec2<f32>, lod: f32) -> vec4<f32>\r\n"
+                + "{\r\n"
+                + "    var level: f32 = lod;\r\n"
+                + "    if (level < 0.0) {\r\n"
+                + "        level = clamp(calculateMipmapLevel(uvs, vec2(tile.x, tile.x)), 0.0, tile.y);\r\n"
+                + "    }\r\n"
+                + "    let size: f32 = pow(2.0, tile.y - level);\r\n"
+                + "    let sizex: f32 = size / rect.z;\r\n"
+                + "    let sizey: f32 = size / rect.w;\r\n"
+                + "    var uv: vec2<f32> = fract(uvs);\r\n"
+                + "    uv.x = uv.x * ((sizex * rect.z - 1.0) / sizex) + 0.5 / sizex + rect.z * rect.x;\r\n"
+                + "    uv.y = uv.y * ((sizey * rect.w - 1.0) / sizey) + 0.5 / sizey + rect.w * rect.y;\r\n"
+                + "    var color: vec4<f32> = textureSampleLevel(atlas, sampler, uv, level);\r\n"
+                + "    if (gamma != 1.0) {\r\n"
+                + "        color.r = pow(color.r, gamma);\r\n"
+                + "        color.g = pow(color.g, gamma);\r\n"
+                + "        color.b = pow(color.b, gamma);\r\n"
+                + "    }\r\n"
+                + "    return color;\r\n"
+                + "}\r\n"
+                + "\r\n"
+                + "fn sampleSplatmapAtlas2D(atlas: texture_2d<f32>, sampler: sampler, tile: vec2<f32>, rect: vec4<f32>, uvs: vec2<f32>) -> vec4<f32>\r\n"
+                + "{\r\n"
+                + "    let size: f32 = pow(2.0, tile.y);\r\n"
+                + "	   let sizex: f32 = size / rect.z;\r\n"
+                + "	   let sizey: f32 = size / rect.w;\r\n"
+                + "	   var uv: vec2<f32> = uvs;\r\n"
+                + "	   uv.x = uv.x * ((sizex * rect.z - 1.0) / sizex) + 0.5 / sizex + rect.z * rect.x;\r\n"
+                + "	   uv.y = uv.y * ((sizey * rect.w - 1.0) / sizey) + 0.5 / sizey + rect.w * rect.y;\r\n"
+                + "    return textureSample(atlas, sampler, uv);\r\n"
+                + "}\r\n"
+                + "\r\n"
+                + "fn blendSplatmapAtlasColors(splatmap: vec4<f32>, color1: vec4<f32>, color2: vec4<f32>, color3: vec4<f32>, color4: vec4<f32>, mixbuffer: vec3<f32>) -> vec3<f32>\r\n"
+                + "{\r\n"
+                + "    let buffer1: vec3<f32> = mix(mixbuffer, color1.rgb, splatmap.r);\r\n"
+                + "    let buffer2: vec3<f32> = mix(buffer1, color2.rgb, splatmap.g);\r\n"
+                + "    let buffer3: vec3<f32> = mix(buffer2, color3.rgb, splatmap.b);\r\n"
+                + "    return mix(buffer3, color4.rgb, splatmap.a);\r\n"
+                + "}\r\n"
+                + "\r\n"
+                + "fn perturbNormalSamplerColor(cotangentFrame: mat3x3<f32>, samplerColor: vec3<f32>, scale: f32) -> vec3<f32>\r\n"
+                + "{\r\n"
+                + "    var map: vec3<f32> = samplerColor.xyz;\r\n"
+                + "    map = map * 2.00787402 - 1.00787402;\r\n"
+                + "    #ifdef NORMALXYSCALE\r\n"
+                + "        map = normalize(map * vec3<f32>(scale, scale, 1.0));\r\n"
+                + "    #endif\r\n"
+                + "    return normalize(cotangentFrame * map);\r\n"
+                + "}\r\n"
+                + "#endif\r\n\r\n");
+        }
+        return result;
+    }
+    WGSL_FormatTerrainFragmentUpdateColor(terrainInfo, colorName, splatmapSampler, detailsSampler, normalsSampler, colorCorrection = 1.0) {
+        let result = "";
+        if (terrainInfo != null && terrainInfo.textureAtlas != null && terrainInfo.splatmapAtlas != null && terrainInfo.splatmapCount > 0) {
+            result = ("\r\n#ifndef TERRAIN_FRAGMENT_UPDATE_COLOR\r\n\r\n"
+                + "#define TERRAIN_FRAGMENT_UPDATE_COLOR\r\n\r\n"
+                + "var normalsColor: vec3<f32> = vec3<f32>(0.5, 0.5, 1.0);\r\n"
+                + "var normalsBuffer: vec3<f32> = normalW.rgb;\r\n"
+                + "var splatmapBuffer: vec3<f32> = " + colorName + ".rgb;\r\n"
+                + "var autoMipMapLevel: f32 = -1.0;\r\n"
+                + "var normalCorrection: f32 = 1.0;\r\n"
+                + "var detailCorrection: f32 = " + colorCorrection.toFixed(4) + ";\r\n"
+                + "\r\n"
+                + "#if defined(ALBEDO) && defined(" + splatmapSampler.toUpperCase() + ") && defined(" + detailsSampler.toUpperCase() + ")\r\n"
+                + "\r\n"
+                + "// Reset Normal Values\r\n"
+                + "#if defined(BUMP) || defined(PARALLAX) || defined(ANISOTROPIC)\r\n"
+                + "    uvOffset = vec2<f32>(0.0, 0.0);\r\n"
+                + "    #ifdef NORMAL\r\n"
+                + "        normalW = normalize(input.vNormalW);\r\n"
+                + "    #else\r\n"
+                + "        normalW = normalize(cross(dpdx(input.vPositionW), dpdy(input.vPositionW))) * scene.vEyePosition.w;\r\n"
+                + "    #endif\r\n"
+                + "    #ifdef CLEARCOAT\r\n"
+                + "        clearCoatNormalW = normalW;\r\n"
+                + "    #endif\r\n"
+                + "    #if defined(BUMP) || defined(PARALLAX)\r\n"
+                + "        #if defined(CLEARCOAT_BUMP) && defined(TANGENT) && defined(NORMAL)\r\n"
+                + "            TBN = vTBN;\r\n"
+                + "        #else\r\n"
+                + "            TBN = cotangent_frame(normalW, input.vPositionW, fragmentInputs.vSplatmapUV, vec2<f32>(1.0, 1.0));\r\n"
+                + "        #endif\r\n"
+                + "    #elif defined(ANISOTROPIC)\r\n"
+                + "        #if defined(CLEARCOAT_BUMP) && defined(TANGENT) && defined(NORMAL)\r\n"
+                + "            TBN = vTBN;\r\n"
+                + "        #else\r\n"
+                + "            TBN = cotangent_frame(normalW, input.vPositionW, fragmentInputs.vSplatmapUV, vec2<f32>(1.0, 1.0));\r\n"
+                + "        #endif\r\n"
+                + "    #endif\r\n"
+                + "    #ifdef PARALLAX\r\n"
+                + "        invTBN = transposeMat3(TBN);\r\n"
+                + "    #endif\r\n"
+                + "    normalW = perturbNormalSamplerColor(TBN, normalsColor, 1.0);\r\n"
+                + "#endif\r\n"
+                + "\r\n"
+                + "// Global Atlas Values\r\n"
+                + "let splatTileSize: f32 = " + terrainInfo.splatmapAtlas[2].toFixed(4) + ";\r\n"
+                + "let splatTileBits: f32 = " + terrainInfo.splatmapAtlas[3].toFixed(4) + ";\r\n"
+                + "let detailTileSize: f32 = " + terrainInfo.textureAtlas[2].toFixed(4) + ";\r\n"
+                + "let detailTileBits: f32 = " + terrainInfo.textureAtlas[3].toFixed(4) + ";\r\n"
+                + "\r\n"
+                + "// Sample splatmap textures\r\n");
+            if (terrainInfo.splatmapCount > 0) {
+                let counter = 0;
+                result += "normalsBuffer = vec3<f32>(0.0,0.0,0.0);\r\n";
+                for (let index = 0; index < terrainInfo.splatmapCount; index++) {
+                    counter = (index * 4);
+                    const splatmapRect = terrainInfo["splatmapRect" + index];
+                    result += "var splatmapRect" + index + ": vec4<f32> = vec4<f32>(" + splatmapRect[0].toFixed(4) + ", " + splatmapRect[1].toFixed(4) + ", " + splatmapRect[2].toFixed(4) + ", " + splatmapRect[3].toFixed(4) + ");\r\n";
+                    result += "var splatmapAlbedo" + index + ": vec4<f32> = sampleSplatmapAtlas2D(" + splatmapSampler + ", " + splatmapSampler + "Sampler, vec2<f32>(splatTileSize, splatTileBits), splatmapRect" + index + ", (fragmentInputs.vSplatmapUV + uvOffset));\r\n";
+                    result += "var textureAlbedo" + (counter + 0) + ": vec4<f32> = vec4<f32>(0.0, 0.0, 0.0, 1.0);\r\n";
+                    result += "var textureAlbedo" + (counter + 1) + ": vec4<f32> = vec4<f32>(0.0, 0.0, 0.0, 1.0);\r\n";
+                    result += "var textureAlbedo" + (counter + 2) + ": vec4<f32> = vec4<f32>(0.0, 0.0, 0.0, 1.0);\r\n";
+                    result += "var textureAlbedo" + (counter + 3) + ": vec4<f32> = vec4<f32>(0.0, 0.0, 0.0, 1.0);\r\n";
+                    if (terrainInfo["textureRect" + (counter + 0)]) {
+                        const textureRect = terrainInfo["textureRect" + (counter + 0)];
+                        const textureInfo = terrainInfo["textureInfo" + (counter + 0)];
+                        result += "var textureRect" + (counter + 0) + ": vec4<f32> = vec4<f32>(" + textureRect[0].toFixed(4) + ", " + textureRect[1].toFixed(4) + ", " + textureRect[2].toFixed(4) + ", " + textureRect[3].toFixed(4) + ");\r\n";
+                        result += "var textureScale" + (counter + 0) + ": vec2<f32> = vec2<f32>(" + textureInfo[0].toFixed(4) + ", " + textureInfo[1].toFixed(4) + ");\r\n";
+                        result += "var textureOffset" + (counter + 0) + ": vec2<f32> = vec2<f32>(" + textureInfo[2].toFixed(4) + ", " + textureInfo[3].toFixed(4) + ");\r\n";
+                        result += "var textureTileUV" + (counter + 0) + ": vec2<f32> = ((fragmentInputs.vSplatmapUV + textureOffset" + (counter + 0) + ") * textureScale" + (counter + 0) + ");\r\n";
+                        result += "textureAlbedo" + (counter + 0) + " = sampleTextureAtlas2D(" + detailsSampler + ", " + detailsSampler + "Sampler, detailCorrection, vec2<f32>(detailTileSize, detailTileBits), textureRect" + (counter + 0) + ", textureTileUV" + (counter + 0) + ", autoMipMapLevel);\r\n";
+                    }
+                    if (terrainInfo["textureRect" + (counter + 1)]) {
+                        const textureRect = terrainInfo["textureRect" + (counter + 1)];
+                        const textureInfo = terrainInfo["textureInfo" + (counter + 1)];
+                        result += "var textureRect" + (counter + 1) + ": vec4<f32> = vec4<f32>(" + textureRect[0].toFixed(4) + ", " + textureRect[1].toFixed(4) + ", " + textureRect[2].toFixed(4) + ", " + textureRect[3].toFixed(4) + ");\r\n";
+                        result += "var textureScale" + (counter + 1) + ": vec2<f32> = vec2<f32>(" + textureInfo[0].toFixed(4) + ", " + textureInfo[1].toFixed(4) + ");\r\n";
+                        result += "var textureOffset" + (counter + 1) + ": vec2<f32> = vec2<f32>(" + textureInfo[2].toFixed(4) + ", " + textureInfo[3].toFixed(4) + ");\r\n";
+                        result += "var textureTileUV" + (counter + 1) + ": vec2<f32> = ((fragmentInputs.vSplatmapUV + textureOffset" + (counter + 1) + ") * textureScale" + (counter + 1) + ");\r\n";
+                        result += "textureAlbedo" + (counter + 1) + " = sampleTextureAtlas2D(" + detailsSampler + ", " + detailsSampler + "Sampler, detailCorrection, vec2<f32>(detailTileSize, detailTileBits), textureRect" + (counter + 1) + ", textureTileUV" + (counter + 1) + ", autoMipMapLevel);\r\n";
+                    }
+                    if (terrainInfo["textureRect" + (counter + 2)]) {
+                        const textureRect = terrainInfo["textureRect" + (counter + 2)];
+                        const textureInfo = terrainInfo["textureInfo" + (counter + 2)];
+                        result += "var textureRect" + (counter + 2) + ": vec4<f32> = vec4<f32>(" + textureRect[0].toFixed(4) + ", " + textureRect[1].toFixed(4) + ", " + textureRect[2].toFixed(4) + ", " + textureRect[3].toFixed(4) + ");\r\n";
+                        result += "var textureScale" + (counter + 2) + ": vec2<f32> = vec2<f32>(" + textureInfo[0].toFixed(4) + ", " + textureInfo[1].toFixed(4) + ");\r\n";
+                        result += "var textureOffset" + (counter + 2) + ": vec2<f32> = vec2<f32>(" + textureInfo[2].toFixed(4) + ", " + textureInfo[3].toFixed(4) + ");\r\n";
+                        result += "var textureTileUV" + (counter + 2) + ": vec2<f32> = ((fragmentInputs.vSplatmapUV + textureOffset" + (counter + 2) + ") * textureScale" + (counter + 2) + ");\r\n";
+                        result += "textureAlbedo" + (counter + 2) + " = sampleTextureAtlas2D(" + detailsSampler + ", " + detailsSampler + "Sampler, detailCorrection, vec2<f32>(detailTileSize, detailTileBits), textureRect" + (counter + 2) + ", textureTileUV" + (counter + 2) + ", autoMipMapLevel);\r\n";
+                    }
+                    if (terrainInfo["textureRect" + (counter + 3)]) {
+                        const textureRect = terrainInfo["textureRect" + (counter + 3)];
+                        const textureInfo = terrainInfo["textureInfo" + (counter + 3)];
+                        result += "var textureRect" + (counter + 3) + ": vec4<f32> = vec4<f32>(" + textureRect[0].toFixed(4) + ", " + textureRect[1].toFixed(4) + ", " + textureRect[2].toFixed(4) + ", " + textureRect[3].toFixed(4) + ");\r\n";
+                        result += "var textureScale" + (counter + 3) + ": vec2<f32> = vec2<f32>(" + textureInfo[0].toFixed(4) + ", " + textureInfo[1].toFixed(4) + ");\r\n";
+                        result += "var textureOffset" + (counter + 3) + ": vec2<f32> = vec2<f32>(" + textureInfo[2].toFixed(4) + ", " + textureInfo[3].toFixed(4) + ");\r\n";
+                        result += "var textureTileUV" + (counter + 3) + ": vec2<f32> = ((fragmentInputs.vSplatmapUV + textureOffset" + (counter + 3) + ") * textureScale" + (counter + 3) + ");\r\n";
+                        result += "textureAlbedo" + (counter + 3) + " = sampleTextureAtlas2D(" + detailsSampler + ", " + detailsSampler + "Sampler, detailCorrection, vec2<f32>(detailTileSize, detailTileBits), textureRect" + (counter + 3) + ", textureTileUV" + (counter + 3) + ", autoMipMapLevel);\r\n";
+                    }
+                    result += "splatmapBuffer = blendSplatmapAtlasColors(splatmapAlbedo" + index + ", textureAlbedo" + (counter + 0) + ", textureAlbedo" + (counter + 1) + ", textureAlbedo" + (counter + 2) + ", textureAlbedo" + (counter + 3) + ", splatmapBuffer);\r\n";
+                    result += "#if defined(BUMP) || defined(PARALLAX) || defined(ANISOTROPIC)\r\n";
+                    result += "    #if defined(" + normalsSampler.toUpperCase() + ")\r\n";
+                    result += "        var normalColor" + (counter + 0) + ": vec4<f32> = vec4<f32>(0.0, 0.0, 0.0, 1.0);\r\n";
+                    result += "        var normalColor" + (counter + 1) + ": vec4<f32> = vec4<f32>(0.0, 0.0, 0.0, 1.0);\r\n";
+                    result += "        var normalColor" + (counter + 2) + ": vec4<f32> = vec4<f32>(0.0, 0.0, 0.0, 1.0);\r\n";
+                    result += "        var normalColor" + (counter + 3) + ": vec4<f32> = vec4<f32>(0.0, 0.0, 0.0, 1.0);\r\n";
+                    if (terrainInfo["textureRect" + (counter + 0)]) {
+                        const normalScale = terrainInfo["normalsScale" + (counter + 0)];
+                        result += "        var normalScale" + (counter + 0) + ": f32 = " + normalScale.toFixed(4) + ";\r\n";
+                        result += "        normalColor" + (counter + 0) + " = sampleTextureAtlas2D(" + normalsSampler + ", " + normalsSampler + "Sampler, normalCorrection, vec2<f32>(detailTileSize, detailTileBits), textureRect" + (counter + 0) + ", textureTileUV" + (counter + 0) + ", autoMipMapLevel);\r\n";
+                        result += "        normalColor" + (counter + 0) + " = vec4<f32>(perturbNormalSamplerColor(TBN, normalColor" + (counter + 0) + ".rgb, normalScale" + (counter + 0) + "), 1.0);\r\n";
+                    }
+                    if (terrainInfo["textureRect" + (counter + 1)]) {
+                        const normalScale = terrainInfo["normalsScale" + (counter + 1)];
+                        result += "        var normalScale" + (counter + 1) + ": f32 = " + normalScale.toFixed(4) + ";\r\n";
+                        result += "        normalColor" + (counter + 1) + " = sampleTextureAtlas2D(" + normalsSampler + ", " + normalsSampler + "Sampler, normalCorrection, vec2<f32>(detailTileSize, detailTileBits), textureRect" + (counter + 1) + ", textureTileUV" + (counter + 1) + ", autoMipMapLevel);\r\n";
+                        result += "        normalColor" + (counter + 1) + " = vec4<f32>(perturbNormalSamplerColor(TBN, normalColor" + (counter + 1) + ".rgb, normalScale" + (counter + 1) + "), 1.0);\r\n";
+                    }
+                    if (terrainInfo["textureRect" + (counter + 2)]) {
+                        const normalScale = terrainInfo["normalsScale" + (counter + 2)];
+                        result += "        var normalScale" + (counter + 2) + ": f32 = " + normalScale.toFixed(4) + ";\r\n";
+                        result += "        normalColor" + (counter + 2) + " = sampleTextureAtlas2D(" + normalsSampler + ", " + normalsSampler + "Sampler, normalCorrection, vec2<f32>(detailTileSize, detailTileBits), textureRect" + (counter + 2) + ", textureTileUV" + (counter + 2) + ", autoMipMapLevel);\r\n";
+                        result += "        normalColor" + (counter + 2) + " = vec4<f32>(perturbNormalSamplerColor(TBN, normalColor" + (counter + 2) + ".rgb, normalScale" + (counter + 2) + "), 1.0);\r\n";
+                    }
+                    if (terrainInfo["textureRect" + (counter + 3)]) {
+                        const normalScale = terrainInfo["normalsScale" + (counter + 3)];
+                        result += "        var normalScale" + (counter + 3) + ": f32 = " + normalScale.toFixed(4) + ";\r\n";
+                        result += "        normalColor" + (counter + 3) + " = sampleTextureAtlas2D(" + normalsSampler + ", " + normalsSampler + "Sampler, normalCorrection, vec2<f32>(detailTileSize, detailTileBits), textureRect" + (counter + 3) + ", textureTileUV" + (counter + 3) + ", autoMipMapLevel);\r\n";
+                        result += "        normalColor" + (counter + 3) + " = vec4<f32>(perturbNormalSamplerColor(TBN, normalColor" + (counter + 3) + ".rgb, normalScale" + (counter + 3) + "), 1.0);\r\n";
+                    }
+                    result += "        normalsBuffer = blendSplatmapAtlasColors(splatmapAlbedo" + index + ", normalColor" + (counter + 0) + ", normalColor" + (counter + 1) + ", normalColor" + (counter + 2) + ", normalColor" + (counter + 3) + ", normalsBuffer);\r\n";
+                    result += "    #endif\r\n";
+                    result += "#endif\r\n";
+                    result += "\r\n";
+                }
+            }
+            result += ("// Update Color Values\r\n"
+                + colorName + " = splatmapBuffer.rgb;\r\n"
+                + "#if defined(BUMP) || defined(PARALLAX) || defined(ANISOTROPIC)\r\n"
+                + "    #if defined(" + normalsSampler.toUpperCase() + ")\r\n"
+                + "        normalW = normalsBuffer.rgb;\r\n"
+                + "    #endif\r\n"
+                + "    #if defined(FORCENORMALFORWARD) && defined(NORMAL)\r\n"
+                + "        var faceNormal: vec3<f32> = normalize(cross(dpdx(input.vPositionW), dpdy(input.vPositionW))) * scene.vEyePosition.w;\r\n"
+                + "        #if defined(TWOSIDEDLIGHTING)\r\n"
+                + "            faceNormal = select(-faceNormal, faceNormal, fragmentInputs.frontFacing)\r\n"
+                + "        #endif\r\n"
+                + "        normalW *= sign(dot(normalW, faceNormal));\r\n"
+                + "    #endif\r\n"
+                + "    #if defined(TWOSIDEDLIGHTING) && defined(NORMAL)\r\n"
+                + "        normalW = select(-normalW, normalW, fragmentInputs.frontFacing);\r\n"
+                + "    #endif\r\n"
+                + "#endif\r\n"
+                + "\r\n"
+                + "#endif\r\n"
+                + "\r\n"
+                + "#endif\r\n\r\n");
+        }
+        return result;
+    }
+    GLSL_FormatTerrainVertexDefintions(terrainInfo) {
+        let result = "";
+        if (terrainInfo != null && terrainInfo.textureAtlas != null && terrainInfo.splatmapAtlas != null && terrainInfo.splatmapCount > 0) {
+            result = ("\r\n#ifndef TERRAIN_VERTEX_DEFINITIONS\r\n\r\n"
+                + "#define TERRAIN_VERTEX_DEFINITIONS\r\n\r\n"
+                + "varying vec2 vSplatmapUV;\r\n"
+                + "\r\n"
+                + "#endif\r\n\r\n");
+        }
+        return result;
+    }
+    GLSL_FormatTerrainVertexMainEnd(terrainInfo) {
+        let result = "";
+        if (terrainInfo != null && terrainInfo.textureAtlas != null && terrainInfo.splatmapAtlas != null && terrainInfo.splatmapCount > 0) {
+            result = ("\r\n#ifndef TERRAIN_VERTEX_MAIN_END\r\n\r\n"
+                + "#define TERRAIN_VERTEX_MAIN_END\r\n\r\n"
+                + "#ifdef UV1\r\n"
+                + "vSplatmapUV = uv;\r\n"
+                + "#endif\r\n"
+                + "\r\n"
+                + "#endif\r\n\r\n");
+        }
+        return result;
+    }
+    GLSL_FormatTerrainFragmentDefintions(terrainInfo, splatmapSampler, detailsSampler, normalsSampler) {
+        let result = "";
+        if (terrainInfo != null && terrainInfo.textureAtlas != null && terrainInfo.splatmapAtlas != null && terrainInfo.splatmapCount > 0) {
+            result = ("\r\n#ifndef TERRAIN_FRAGMENT_DEFNITIONS\r\n\r\n"
+                + "#define TERRAIN_FRAGMENT_DEFNITIONS\r\n\r\n"
+                + "varying vec2 vSplatmapUV;\r\n"
+                + "\r\n"
+                + "vec3 srgb_to_linear(const in vec3 c)\r\n"
+                + "{\r\n"
+                + "    return pow(c, vec3(2.2));\r\n"
+                + "}\r\n"
+                + "\r\n"
+                + "vec3 linear_to_srgb(const in vec3 c)\r\n"
+                + "{\r\n"
+                + "    return pow(c, vec3(1.0 / 2.2));\r\n"
+                + "}\r\n"
+                + "\r\n"
+                + "float calculateMipmapLevel(const in vec2 uvs, const in vec2 size)\r\n"
+                + "{\r\n"
+                + "    vec2 dx = dFdx(uvs * size.x);\r\n"
+                + "    vec2 dy = dFdy(uvs * size.y);\r\n"
+                + "    float d = max(dot(dx, dx), dot(dy, dy));\r\n"
+                + "    return 0.4 * log2(d);\r\n"
+                + "}\r\n"
+                + "\r\n"
+                + "vec4 sampleTextureAtlas2D(const in sampler2D atlas, const in float gamma, const in vec2 tile, const in vec4 rect, in vec2 uvs, in float lod)\r\n"
+                + "{\r\n"
+                + "    if (lod < 0.0) lod = clamp(calculateMipmapLevel(uvs, vec2(tile.x, tile.x)), 0.0, tile.y);   // Tile Info (tile.xy)\r\n"
+                + "    float size = pow(2.0, tile.y - lod);                                                        // Tile Bits (tile.y)\r\n"
+                + "    float sizex = size / rect.z;                                                                // Tile Width (rect.z)\r\n"
+                + "    float sizey = size / rect.w;                                                                // Tile Height (rect.w)\r\n"
+                + "    uvs = fract(uvs);                                                                           // Perfrom Tiling (fract)\r\n"
+                + "    uvs.x = uvs.x * ((sizex * rect.z - 1.0) / sizex) + 0.5 / sizex + rect.z * rect.x;           // Tile Position X (rect.x)\r\n"
+                + "    uvs.y = uvs.y * ((sizey * rect.w - 1.0) / sizey) + 0.5 / sizey + rect.w * rect.y;           // Tile Position Y (rect.y)\r\n"
+                + "    vec4 color = texture2DLodEXT(atlas, uvs, lod);\r\n"
+                + "    if (gamma != 1.0) {\r\n"
+                + "        color.r = pow(color.r, gamma);\r\n"
+                + "        color.g = pow(color.g, gamma);\r\n"
+                + "        color.b = pow(color.b, gamma);\r\n"
+                + "    }\r\n"
+                + "    return color;\r\n"
+                + "}\r\n"
+                + "\r\n"
+                + "vec4 sampleSplatmapAtlas2D(const in sampler2D atlas, const in vec2 tile, const in vec4 rect, in vec2 uvs)\r\n"
+                + "{\r\n"
+                + "    float size = pow(2.0, tile.y);                                                              // Tile Bits (tile.y)\r\n"
+                + "	   float sizex = size / rect.z;                                                                // Tile Width (rect.z)\r\n"
+                + "	   float sizey = size / rect.w;                                                                // Tile Height (rect.w)\r\n"
+                + "	   uvs.x = uvs.x * ((sizex * rect.z - 1.0) / sizex) + 0.5 / sizex + rect.z * rect.x;           // Tile Position X (rect.x)\r\n"
+                + "	   uvs.y = uvs.y * ((sizey * rect.w - 1.0) / sizey) + 0.5 / sizey + rect.w * rect.y;           // Tile Position Y (rect.y)\r\n"
+                + "    return texture2D(atlas, uvs);\r\n"
+                + "}\r\n"
+                + "\r\n"
+                + "vec3 blendSplatmapAtlasColors(const in vec4 splatmap, in vec4 color1, in vec4 color2, in vec4 color3, in vec4 color4, in vec3 mixbuffer)\r\n"
+                + "{\r\n"
+                + "    vec3 buffer1 = mix(mixbuffer, color1.rgb, splatmap.r);\r\n"
+                + "    vec3 buffer2 = mix(buffer1, color2.rgb, splatmap.g);\r\n"
+                + "    vec3 buffer3 = mix(buffer2, color3.rgb, splatmap.b);\r\n"
+                + "    return mix(buffer3, color4.rgb, splatmap.a);\r\n"
+                + "}\r\n"
+                + "\r\n"
+                + "vec3 perturbNormalSamplerColor(mat3 cotangentFrame, vec3 samplerColor, float scale)\r\n"
+                + "{\r\n"
+                + "    vec3 map = samplerColor.xyz;\r\n"
+                + "    map = map * 2.00787402 - 1.00787402;\r\n"
+                + "    #ifdef NORMALXYSCALE\r\n"
+                + "        map = normalize(map * vec3(scale, scale, 1.0));\r\n"
+                + "    #endif\r\n"
+                + "    return normalize(cotangentFrame * map);\r\n"
+                + "}\r\n"
+                + "\r\n"
+                + "\r\n"
+                + "#endif\r\n\r\n");
+        }
+        return result;
+    }
+    GLSL_FormatTerrainFragmentUpdateColor(terrainInfo, colorName, splatmapSampler, detailsSampler, normalsSampler, colorCorrection = 1.0) {
+        let result = "";
+        if (terrainInfo != null && terrainInfo.textureAtlas != null && terrainInfo.splatmapAtlas != null && terrainInfo.splatmapCount > 0) {
+            result = ("\r\n#ifndef TERRAIN_FRAGMENT_UPDATE_COLOR\r\n\r\n"
+                + "#define TERRAIN_FRAGMENT_UPDATE_COLOR\r\n\r\n"
+                + "vec3 normalsColor = vec3(0.5, 0.5, 1.0);\r\n"
+                + "vec3 normalsBuffer = normalW.rgb;\r\n"
+                + "vec3 splatmapBuffer = " + colorName + ".rgb;\r\n"
+                + "float autoMipMapLevel = -1.0;\r\n"
+                + "float normalCorrection = 1.0;\r\n"
+                + "float detailCorrection = " + colorCorrection.toFixed(4) + ";\r\n"
+                + "\r\n"
+                + "#if defined(ALBEDO) && defined(" + splatmapSampler.toUpperCase() + ") && defined(" + detailsSampler.toUpperCase() + ")\r\n"
+                + "\r\n"
+                + "// Reset Normal Values\r\n"
+                + "#if defined(BUMP) || defined(PARALLAX) || defined(ANISOTROPIC)\r\n"
+                + "    uvOffset = vec2(0.0, 0.0);\r\n"
+                + "    #ifdef NORMAL\r\n"
+                + "        normalW = normalize(vNormalW);\r\n"
+                + "    #else\r\n"
+                + "        normalW = normalize(cross(dFdx(vPositionW), dFdy(vPositionW))) * vEyePosition.w;\r\n"
+                + "    #endif\r\n"
+                + "    #ifdef CLEARCOAT\r\n"
+                + "        clearCoatNormalW = normalW;\r\n"
+                + "    #endif\r\n"
+                + "    #if defined(BUMP) || defined(PARALLAX)\r\n"
+                + "        #if defined(TANGENT) && defined(NORMAL)\r\n"
+                + "            TBN = vTBN;\r\n"
+                + "        #else\r\n"
+                + "            TBN = cotangent_frame(normalW, vPositionW, vSplatmapUV);\r\n"
+                + "        #endif\r\n"
+                + "    #elif defined(ANISOTROPIC)\r\n"
+                + "        #if defined(TANGENT) && defined(NORMAL)\r\n"
+                + "            TBN = vTBN;\r\n"
+                + "        #else\r\n"
+                + "            TBN = cotangent_frame(normalW, vPositionW, vSplatmapUV, vec2(1.0, 1.0));\r\n"
+                + "        #endif\r\n"
+                + "    #endif\r\n"
+                + "    #ifdef PARALLAX\r\n"
+                + "        invTBN = transposeMat3(TBN);\r\n"
+                + "    #endif\r\n"
+                + "    normalW = perturbNormalSamplerColor(TBN, normalsColor, 1.0);\r\n"
+                + "#endif\r\n"
+                + "\r\n"
+                + "// Global Atlas Values\r\n"
+                + "float splatTileSize = " + terrainInfo.splatmapAtlas[2].toFixed(4) + ";\r\n"
+                + "float splatTileBits = " + terrainInfo.splatmapAtlas[3].toFixed(4) + ";\r\n"
+                + "float detailTileSize = " + terrainInfo.textureAtlas[2].toFixed(4) + ";\r\n"
+                + "float detailTileBits = " + terrainInfo.textureAtlas[3].toFixed(4) + ";\r\n"
+                + "\r\n"
+                + "// Sample splatmap textures\r\n");
+            if (terrainInfo.splatmapCount > 0) {
+                let counter = 0;
+                result += "normalsBuffer = vec3(0.0,0.0,0.0);\r\n";
+                for (let index = 0; index < terrainInfo.splatmapCount; index++) {
+                    counter = (index * 4);
+                    const splatmapRect = terrainInfo["splatmapRect" + index];
+                    result += "vec4 splatmapRect" + index + " = vec4(" + splatmapRect[0].toFixed(4) + ", " + splatmapRect[1].toFixed(4) + ", " + splatmapRect[2].toFixed(4) + ", " + splatmapRect[3].toFixed(4) + ");\r\n";
+                    result += "vec4 splatmapAlbedo" + index + " = sampleSplatmapAtlas2D(" + splatmapSampler + ", vec2(splatTileSize, splatTileBits), splatmapRect" + index + ", (vSplatmapUV + uvOffset));\r\n";
+                    result += "vec4 textureAlbedo" + (counter + 0) + " = vec4(0.0, 0.0, 0.0, 1.0);\r\n";
+                    result += "vec4 textureAlbedo" + (counter + 1) + " = vec4(0.0, 0.0, 0.0, 1.0);\r\n";
+                    result += "vec4 textureAlbedo" + (counter + 2) + " = vec4(0.0, 0.0, 0.0, 1.0);\r\n";
+                    result += "vec4 textureAlbedo" + (counter + 3) + " = vec4(0.0, 0.0, 0.0, 1.0);\r\n";
+                    if (terrainInfo["textureRect" + (counter + 0)]) {
+                        const textureRect = terrainInfo["textureRect" + (counter + 0)];
+                        const textureInfo = terrainInfo["textureInfo" + (counter + 0)];
+                        result += "vec4 textureRect" + (counter + 0) + " = vec4(" + textureRect[0].toFixed(4) + ", " + textureRect[1].toFixed(4) + ", " + textureRect[2].toFixed(4) + ", " + textureRect[3].toFixed(4) + ");\r\n";
+                        result += "vec2 textureScale" + (counter + 0) + " = vec2(" + textureInfo[0].toFixed(4) + ", " + textureInfo[1].toFixed(4) + ");\r\n";
+                        result += "vec2 textureOffset" + (counter + 0) + " = vec2(" + textureInfo[2].toFixed(4) + ", " + textureInfo[3].toFixed(4) + ");\r\n";
+                        result += "vec2 textureTileUV" + (counter + 0) + " = ((vSplatmapUV + textureOffset" + (counter + 0) + ") * textureScale" + (counter + 0) + ");\r\n";
+                        result += "textureAlbedo" + (counter + 0) + " = sampleTextureAtlas2D(" + detailsSampler + ", detailCorrection, vec2(detailTileSize, detailTileBits), textureRect" + (counter + 0) + ", textureTileUV" + (counter + 0) + ", autoMipMapLevel);\r\n";
+                    }
+                    if (terrainInfo["textureRect" + (counter + 1)]) {
+                        const textureRect = terrainInfo["textureRect" + (counter + 1)];
+                        const textureInfo = terrainInfo["textureInfo" + (counter + 1)];
+                        result += "vec4 textureRect" + (counter + 1) + " = vec4(" + textureRect[0].toFixed(4) + ", " + textureRect[1].toFixed(4) + ", " + textureRect[2].toFixed(4) + ", " + textureRect[3].toFixed(4) + ");\r\n";
+                        result += "vec2 textureScale" + (counter + 1) + " = vec2(" + textureInfo[0].toFixed(4) + ", " + textureInfo[1].toFixed(4) + ");\r\n";
+                        result += "vec2 textureOffset" + (counter + 1) + " = vec2(" + textureInfo[2].toFixed(4) + ", " + textureInfo[3].toFixed(4) + ");\r\n";
+                        result += "vec2 textureTileUV" + (counter + 1) + " = ((vSplatmapUV + textureOffset" + (counter + 1) + ") * textureScale" + (counter + 1) + ");\r\n";
+                        result += "textureAlbedo" + (counter + 1) + " = sampleTextureAtlas2D(" + detailsSampler + ", detailCorrection, vec2(detailTileSize, detailTileBits), textureRect" + (counter + 1) + ", textureTileUV" + (counter + 1) + ", autoMipMapLevel);\r\n";
+                    }
+                    if (terrainInfo["textureRect" + (counter + 2)]) {
+                        const textureRect = terrainInfo["textureRect" + (counter + 2)];
+                        const textureInfo = terrainInfo["textureInfo" + (counter + 2)];
+                        result += "vec4 textureRect" + (counter + 2) + " = vec4(" + textureRect[0].toFixed(4) + ", " + textureRect[1].toFixed(4) + ", " + textureRect[2].toFixed(4) + ", " + textureRect[3].toFixed(4) + ");\r\n";
+                        result += "vec2 textureScale" + (counter + 2) + " = vec2(" + textureInfo[0].toFixed(4) + ", " + textureInfo[1].toFixed(4) + ");\r\n";
+                        result += "vec2 textureOffset" + (counter + 2) + " = vec2(" + textureInfo[2].toFixed(4) + ", " + textureInfo[3].toFixed(4) + ");\r\n";
+                        result += "vec2 textureTileUV" + (counter + 2) + " = ((vSplatmapUV + textureOffset" + (counter + 2) + ") * textureScale" + (counter + 2) + ");\r\n";
+                        result += "textureAlbedo" + (counter + 2) + " = sampleTextureAtlas2D(" + detailsSampler + ", detailCorrection, vec2(detailTileSize, detailTileBits), textureRect" + (counter + 2) + ", textureTileUV" + (counter + 2) + ", autoMipMapLevel);\r\n";
+                    }
+                    if (terrainInfo["textureRect" + (counter + 3)]) {
+                        const textureRect = terrainInfo["textureRect" + (counter + 3)];
+                        const textureInfo = terrainInfo["textureInfo" + (counter + 3)];
+                        result += "vec4 textureRect" + (counter + 3) + " = vec4(" + textureRect[0].toFixed(4) + ", " + textureRect[1].toFixed(4) + ", " + textureRect[2].toFixed(4) + ", " + textureRect[3].toFixed(4) + ");\r\n";
+                        result += "vec2 textureScale" + (counter + 3) + " = vec2(" + textureInfo[0].toFixed(4) + ", " + textureInfo[1].toFixed(4) + ");\r\n";
+                        result += "vec2 textureOffset" + (counter + 3) + " = vec2(" + textureInfo[2].toFixed(4) + ", " + textureInfo[3].toFixed(4) + ");\r\n";
+                        result += "vec2 textureTileUV" + (counter + 3) + " = ((vSplatmapUV + textureOffset" + (counter + 3) + ") * textureScale" + (counter + 3) + ");\r\n";
+                        result += "textureAlbedo" + (counter + 3) + " = sampleTextureAtlas2D(" + detailsSampler + ", detailCorrection, vec2(detailTileSize, detailTileBits), textureRect" + (counter + 3) + ", textureTileUV" + (counter + 3) + ", autoMipMapLevel);\r\n";
+                    }
+                    result += "splatmapBuffer = blendSplatmapAtlasColors(splatmapAlbedo" + index + ", textureAlbedo" + (counter + 0) + ", textureAlbedo" + (counter + 1) + ", textureAlbedo" + (counter + 2) + ", textureAlbedo" + (counter + 3) + ", splatmapBuffer);\r\n";
+                    result += "#if defined(BUMP) || defined(PARALLAX) || defined(ANISOTROPIC)\r\n";
+                    result += "    #if defined(" + normalsSampler.toUpperCase() + ")\r\n";
+                    result += "        vec4 normalColor" + (counter + 0) + " = vec4(0.0, 0.0, 0.0, 1.0);\r\n";
+                    result += "        vec4 normalColor" + (counter + 1) + " = vec4(0.0, 0.0, 0.0, 1.0);\r\n";
+                    result += "        vec4 normalColor" + (counter + 2) + " = vec4(0.0, 0.0, 0.0, 1.0);\r\n";
+                    result += "        vec4 normalColor" + (counter + 3) + " = vec4(0.0, 0.0, 0.0, 1.0);\r\n";
+                    if (terrainInfo["textureRect" + (counter + 0)]) {
+                        const normalScale = terrainInfo["normalsScale" + (counter + 0)];
+                        result += "        float normalScale" + (counter + 0) + " = " + normalScale.toFixed(4) + ";\r\n";
+                        result += "        normalColor" + (counter + 0) + " = sampleTextureAtlas2D(" + normalsSampler + ", normalCorrection, vec2(detailTileSize, detailTileBits), textureRect" + (counter + 0) + ", textureTileUV" + (counter + 0) + ", autoMipMapLevel);\r\n";
+                        result += "        normalColor" + (counter + 0) + ".rgb = perturbNormalSamplerColor(TBN, normalColor" + (counter + 0) + ".rgb, normalScale" + (counter + 0) + ");\r\n";
+                    }
+                    if (terrainInfo["textureRect" + (counter + 1)]) {
+                        const normalScale = terrainInfo["normalsScale" + (counter + 1)];
+                        result += "        float normalScale" + (counter + 1) + " = " + normalScale.toFixed(4) + ";\r\n";
+                        result += "        normalColor" + (counter + 1) + " = sampleTextureAtlas2D(" + normalsSampler + ", normalCorrection, vec2(detailTileSize, detailTileBits), textureRect" + (counter + 1) + ", textureTileUV" + (counter + 1) + ", autoMipMapLevel);\r\n";
+                        result += "        normalColor" + (counter + 1) + ".rgb = perturbNormalSamplerColor(TBN, normalColor" + (counter + 1) + ".rgb, normalScale" + (counter + 1) + ");\r\n";
+                    }
+                    if (terrainInfo["textureRect" + (counter + 2)]) {
+                        const normalScale = terrainInfo["normalsScale" + (counter + 2)];
+                        result += "        float normalScale" + (counter + 2) + " = " + normalScale.toFixed(4) + ";\r\n";
+                        result += "        normalColor" + (counter + 2) + " = sampleTextureAtlas2D(" + normalsSampler + ", normalCorrection, vec2(detailTileSize, detailTileBits), textureRect" + (counter + 2) + ", textureTileUV" + (counter + 2) + ", autoMipMapLevel);\r\n";
+                        result += "        normalColor" + (counter + 2) + ".rgb = perturbNormalSamplerColor(TBN, normalColor" + (counter + 2) + ".rgb, normalScale" + (counter + 2) + ");\r\n";
+                    }
+                    if (terrainInfo["textureRect" + (counter + 3)]) {
+                        const normalScale = terrainInfo["normalsScale" + (counter + 3)];
+                        result += "        float normalScale" + (counter + 3) + " = " + normalScale.toFixed(4) + ";\r\n";
+                        result += "        normalColor" + (counter + 3) + " = sampleTextureAtlas2D(" + normalsSampler + ", normalCorrection, vec2(detailTileSize, detailTileBits), textureRect" + (counter + 3) + ", textureTileUV" + (counter + 3) + ", autoMipMapLevel);\r\n";
+                        result += "        normalColor" + (counter + 3) + ".rgb = perturbNormalSamplerColor(TBN, normalColor" + (counter + 3) + ".rgb, normalScale" + (counter + 3) + ");\r\n";
+                    }
+                    result += "        normalsBuffer = blendSplatmapAtlasColors(splatmapAlbedo" + index + ", normalColor" + (counter + 0) + ", normalColor" + (counter + 1) + ", normalColor" + (counter + 2) + ", normalColor" + (counter + 3) + ", normalsBuffer);\r\n";
+                    result += "    #endif\r\n";
+                    result += "#endif\r\n";
+                    result += "\r\n";
+                }
+            }
+            result += ("// Update Color Values\r\n"
+                + colorName + " = splatmapBuffer.rgb;\r\n"
+                + "#if defined(BUMP) || defined(PARALLAX) || defined(ANISOTROPIC)\r\n"
+                + "    #if defined(" + normalsSampler.toUpperCase() + ")\r\n"
+                + "        normalW = normalsBuffer.rgb;\r\n"
+                + "    #endif\r\n"
+                + "    #if defined(FORCENORMALFORWARD) && defined(NORMAL)\r\n"
+                + "        vec3 faceNormal = normalize(cross(dFdx(vPositionW), dFdy(vPositionW))) * vEyePosition.w;\r\n"
+                + "        #if defined(TWOSIDEDLIGHTING)\r\n"
+                + "            faceNormal = gl_FrontFacing ? faceNormal : -faceNormal;\r\n"
+                + "        #endif\r\n"
+                + "        normalW *= sign(dot(normalW, faceNormal));\r\n"
+                + "    #endif\r\n"
+                + "    #if defined(TWOSIDEDLIGHTING) && defined(NORMAL)\r\n"
+                + "        normalW = gl_FrontFacing ? normalW : -normalW;\r\n"
+                + "    #endif\r\n"
+                + "#endif\r\n"
+                + "\r\n"
+                + "#endif\r\n"
+                + "\r\n"
+                + "#endif\r\n\r\n");
+        }
+        return result;
+    }
+}
 export class GrassStandardMaterial extends StandardShaderMaterial {
     constructor(name, scene) {
         super(name, scene);
@@ -10365,6 +11000,372 @@ export class GrassBillboardMaterialPlugin extends StandardShaderMaterialPlugin {
         this.getCustomShaderMaterial().updateCustomBindings(uniformBuffer);
     }
 }
+export class TreeBranchMaterial extends CustomShaderMaterial {
+    constructor(name, scene) {
+        super(name, scene);
+        this._windTimeAccum = 0.0;
+        this.shader = this.getShaderName();
+        this.plugin = new TreeBranchMaterialPlugin(this, this.shader);
+        this.addFloatUniform("g_windTime", 0.0);
+        this.addFloatUniform("g_windAmount", 0.5);
+        this.addFloatUniform("g_windSpeed", 1.0);
+        this.addFloatUniform("g_windStrength", 0.5);
+        this.addVector4Uniform("g_windDirection", new Vector4(1.0, 0.0, 0.0, 0.0));
+        this.addFloatUniform("g_branchRootY", 0.0);
+        this.addFloatUniform("g_branchMaxAngle", 0.35);
+        this.addFloatUniform("g_branchMaxHeight", 2.0);
+        this.addFloatUniform("g_useVertexColorMask", 1.0);
+        this.addFloatUniform("g_spatialFrequency", 0.15);
+        this._windTimeAccum = 0.0;
+    }
+    awake() {
+    }
+    update() {
+        try {
+            const rawDt = SceneManager.GetDeltaSeconds(this.getScene());
+            const dt = Math.min(rawDt, 1 / 30);
+            const speed = this.getFloatValue("g_windSpeed") ?? 0;
+            if (speed > 0) {
+                this._windTimeAccum += dt;
+                this.setFloatValue("g_windTime", this._windTimeAccum);
+            }
+        }
+        catch (e) {
+        }
+    }
+    getShaderName() {
+        return "TreeBranchMaterial";
+    }
+    setWindDirection(x, y, z) {
+        const v = new Vector3(x, y, z);
+        if (v.lengthSquared() < 1e-8) {
+            this.setVector4Value("g_windDirection", new Vector4(1, 0, 0, 0));
+            return;
+        }
+        v.normalize();
+        this.setVector4Value("g_windDirection", new Vector4(v.x, v.y, v.z, 0.0));
+    }
+    getWindDirection() {
+        return this.getVector4Value("g_windDirection");
+    }
+}
+export class TreeBranchMaterialPlugin extends CustomShaderMaterialPlugin {
+    constructor(customMaterial, shaderName) {
+        super(customMaterial, shaderName, 110, { TREEBRANCHMATERIAL: false });
+    }
+    isCompatible(shaderLanguage) {
+        return (shaderLanguage === ShaderLanguage.WGSL || shaderLanguage === ShaderLanguage.GLSL);
+    }
+    getCustomCode(shaderType, shaderLanguage) {
+        if (shaderType === "vertex") {
+            if (shaderLanguage === ShaderLanguage.WGSL) {
+                return {
+                    CUSTOM_VERTEX_MAIN_END: `
+                        // -------------------------
+                        // TreeBranch wind bending (local-space)
+                        // Authoring (recommended):
+                        //   vertexColor.r = bend weight (0 trunk .. 1 tips)
+                        //   vertexColor.g = phase offset noise (0..1)
+                        // Falls back to height-based weight if vertex color missing/disabled.
+                        // -------------------------
+
+                        fn safeNormalize(v: vec3f) -> vec3f {
+                          let lsq = dot(v, v);
+                          if (lsq < 1e-8) { return vec3f(1.0, 0.0, 0.0); }
+                          return v * inverseSqrt(lsq);
+                        }
+
+                        fn rotateRodrigues(p: vec3f, axis: vec3f, angle: f32) -> vec3f {
+                          let a = safeNormalize(axis);
+                          let c = cos(angle);
+                          let s = sin(angle);
+                          return p * c + cross(a, p) * s + a * dot(a, p) * (1.0 - c);
+                        }
+
+                        // Local position & normal (preferred: use normalUpdated if present in shader)
+                        var pL: vec3f = positionUpdated;
+
+                        // If COLOR attribute exists, Babylon usually provides vertexInputs.color.
+                        // If not available, these will be 1,1,1,1 (depending on pipeline) — we guard with g_useVertexColorMask.
+                        var bendMask: f32 = 1.0;
+                        var phaseNoise: f32 = 0.0;
+                        if (uniforms.g_useVertexColorMask > 0.5) {
+                          bendMask = clamp(vertexInputs.color.r, 0.0, 1.0);
+                          phaseNoise = vertexInputs.color.g; // 0..1
+                        }
+
+                        // Height-based fallback weight (normalized between rootY..maxHeight)
+                        let denom = max(uniforms.g_branchMaxHeight - uniforms.g_branchRootY, 1e-3);
+                        let h01 = clamp((pL.y - uniforms.g_branchRootY) / denom, 0.0, 1.0);
+
+                        // Final per-vertex weight:
+                        // - If using vertex colors: bendMask * smooth tip emphasis
+                        // - Else: height-based
+                        var w: f32 = h01;
+                        if (uniforms.g_useVertexColorMask > 0.5) {
+                          w = bendMask * (h01 * h01 * (3.0 - 2.0 * h01)); // smoothstep(h01)
+                        } else {
+                          w = h01 * h01; // a bit stiffer near base
+                        }
+
+                        // Wind direction in LOCAL space:
+                        // We transform windDirWorld by inverse world matrix rotation (approx using finalWorld columns).
+                        // finalWorld transforms local->world. For direction, inverse rotation is transpose of 3x3 if no shear.
+                        let windW = safeNormalize(uniforms.g_windDirection.xyz);
+                        let rightW = safeNormalize(finalWorld[0].xyz);
+                        let upW = safeNormalize(finalWorld[1].xyz);
+                        let fwdW = safeNormalize(finalWorld[2].xyz);
+
+                        // Convert world dir to local by dot with basis
+                        let windL = safeNormalize(vec3f(dot(windW, rightW), dot(windW, upW), dot(windW, fwdW)));
+
+                        // Bend axis: perpendicular to up and wind, in LOCAL space
+                        var axisL = safeNormalize(cross(vec3f(0.0, 1.0, 0.0), windL));
+                        if (dot(axisL, axisL) < 1e-6) { axisL = vec3f(1.0, 0.0, 0.0); }
+
+                        // Spatially varying phase so whole tree doesn't move as a rigid sheet
+                        // Use local xz for coherence; optionally mod by vertexColor.g
+                        let spatial = (pL.x + pL.z) * uniforms.g_spatialFrequency;
+                        let phase = uniforms.g_windTime * uniforms.g_windSpeed
+                                  + spatial * uniforms.g_windStrength
+                                  + phaseNoise * 6.28318;
+
+                        // Two-wave composite like Unity-ish wind
+                        let base = sin(phase);
+                        let gust = 0.5 * sin(phase * 1.7 + 1.2);
+                        let sway = (base + gust) * uniforms.g_windAmount;
+
+                        // Convert sway to angle (clamped)
+                        var angle = sway * w * uniforms.g_branchMaxAngle;
+                        angle = clamp(angle, -uniforms.g_branchMaxAngle, uniforms.g_branchMaxAngle);
+
+                        // Pivot in local space
+                        let pivotL = vec3f(0.0, uniforms.g_branchRootY, 0.0);
+                        let relL = pL - pivotL;
+                        let bentRelL = rotateRodrigues(relL, axisL, angle);
+                        let bentPL = pivotL + bentRelL;
+
+                        // Transform to world using finalWorld (keeps proper anchoring)
+                        let branchWorld = (finalWorld * vec4f(bentPL, 1.0)).xyz;
+
+                        // Rotate normal similarly (only if NORMAL is active)
+                        #ifdef NORMAL
+                          // Babylon WGSL PBR usually provides normalUpdated in local/object space
+                          var nL: vec3f = normalize(normalUpdated);
+                          let bentNL = rotateRodrigues(nL, axisL, angle);
+                          // Convert to world by world 3x3
+                          let nW = normalize(vec3f(
+                              dot(bentNL, vec3f(finalWorld[0].x, finalWorld[0].y, finalWorld[0].z)),
+                              dot(bentNL, vec3f(finalWorld[1].x, finalWorld[1].y, finalWorld[1].z)),
+                              dot(bentNL, vec3f(finalWorld[2].x, finalWorld[2].y, finalWorld[2].z))
+                          ));
+                          vertexOutputs.vNormalW = nW;
+                        #endif
+
+                        #if defined(POSITION) || defined(BUMP)
+                          vertexOutputs.vPositionW = branchWorld;
+                        #endif
+
+                        vertexOutputs.position = scene.viewProjection * vec4f(branchWorld, 1.0);
+                        `
+                };
+            }
+            else {
+                return {
+                    CUSTOM_VERTEX_DEFINITIONS: `
+                          uniform float g_windTime;
+                          uniform float g_windAmount;
+                          uniform float g_windSpeed;
+                          uniform float g_windStrength;
+                          uniform vec4  g_windDirection;
+
+                          uniform float g_branchRootY;
+                          uniform float g_branchMaxAngle;
+                          uniform float g_branchMaxHeight;
+                          uniform float g_useVertexColorMask;
+                          uniform float g_spatialFrequency;
+
+                          vec3 safeNormalize(vec3 v) {
+                            float lsq = dot(v, v);
+                            if (lsq < 1e-8) return vec3(1.0, 0.0, 0.0);
+                            return v * inversesqrt(lsq);
+                          }
+
+                          vec3 rotateRodrigues(vec3 p, vec3 axis, float angle) {
+                            vec3 a = safeNormalize(axis);
+                            float c = cos(angle);
+                            float s = sin(angle);
+                            return p * c + cross(a, p) * s + a * dot(a, p) * (1.0 - c);
+                          }
+                      `,
+                    CUSTOM_VERTEX_MAIN_END: `
+                          // Local/object position
+                          vec3 pL = positionUpdated;
+
+                          // Vertex color mask (recommended authoring)
+                          float bendMask = 1.0;
+                          float phaseNoise = 0.0;
+                          #ifdef VERTEXCOLOR
+                            if (g_useVertexColorMask > 0.5) {
+                              bendMask = clamp(color.r, 0.0, 1.0);
+                              phaseNoise = color.g;
+                            }
+                          #endif
+
+                          float denom = max(g_branchMaxHeight - g_branchRootY, 1e-3);
+                          float h01 = clamp((pL.y - g_branchRootY) / denom, 0.0, 1.0);
+
+                          float w = h01;
+                          if (g_useVertexColorMask > 0.5) {
+                            // smoothstep(h01)
+                            w = bendMask * (h01 * h01 * (3.0 - 2.0 * h01));
+                          } else {
+                            w = h01 * h01;
+                          }
+
+                          // Convert wind world dir to local using world basis (transpose approx)
+                          vec3 windW = safeNormalize(g_windDirection.xyz);
+                          vec3 rightW = safeNormalize(finalWorld[0].xyz);
+                          vec3 upW    = safeNormalize(finalWorld[1].xyz);
+                          vec3 fwdW   = safeNormalize(finalWorld[2].xyz);
+                          vec3 windL  = safeNormalize(vec3(dot(windW, rightW), dot(windW, upW), dot(windW, fwdW)));
+
+                          vec3 axisL = safeNormalize(cross(vec3(0.0, 1.0, 0.0), windL));
+                          if (dot(axisL, axisL) < 1e-6) axisL = vec3(1.0, 0.0, 0.0);
+
+                          float spatial = (pL.x + pL.z) * g_spatialFrequency;
+                          float phase = g_windTime * g_windSpeed
+                                      + spatial * g_windStrength
+                                      + phaseNoise * 6.2831853;
+
+                          float base = sin(phase);
+                          float gust = 0.5 * sin(phase * 1.7 + 1.2);
+                          float sway = (base + gust) * g_windAmount;
+
+                          float angle = clamp(sway * w * g_branchMaxAngle, -g_branchMaxAngle, g_branchMaxAngle);
+
+                          vec3 pivotL = vec3(0.0, g_branchRootY, 0.0);
+                          vec3 relL = pL - pivotL;
+                          vec3 bentPL = pivotL + rotateRodrigues(relL, axisL, angle);
+
+                          vec3 branchWorld = (finalWorld * vec4(bentPL, 1.0)).xyz;
+
+                          #if defined(POSITION) || defined(BUMP)
+                            vPositionW = branchWorld;
+                          #endif
+
+                          #ifdef NORMAL
+                            // normalUpdated is local/object normal
+                            vec3 nL = normalize(normalUpdated);
+                            vec3 bentNL = rotateRodrigues(nL, axisL, angle);
+
+                            // world normal from world basis (approx; assumes no non-uniform scale/shear)
+                            vec3 nW = normalize(bentNL.x * rightW + bentNL.y * upW + bentNL.z * fwdW);
+                            vNormalW = nW;
+                          #endif
+
+                          gl_Position = viewProjection * vec4(branchWorld, 1.0);
+                      `
+                };
+            }
+        }
+        if (shaderType === "fragment") {
+            if (shaderLanguage === ShaderLanguage.WGSL) {
+                return {
+                    CUSTOM_FRAGMENT_BEFORE_FINALCOLORCOMPOSITION: `
+                          // no-op
+                      `
+                };
+            }
+            else {
+                return {
+                    CUSTOM_FRAGMENT_BEFORE_FINALCOLORCOMPOSITION: `
+                          // no-op
+                      `
+                };
+            }
+        }
+        return null;
+    }
+    getUniforms(shaderLanguage) {
+        const wgsl = (shaderLanguage === ShaderLanguage.WGSL);
+        this.vertexDefinitions = this.getCustomShaderMaterial().getCustomVertexCode(wgsl);
+        this.fragmentDefinitions = (wgsl === true) ? this.getCustomShaderMaterial().getCustomFragmentCode(wgsl) : null;
+        return this.getCustomShaderMaterial().getCustomUniforms(wgsl);
+    }
+    getSamplers(samplers) {
+        const customSamplers = this.getCustomShaderMaterial().getCustomSamplers();
+        if (customSamplers && customSamplers.length > 0)
+            samplers.push(...customSamplers);
+    }
+    getAttributes(attributes, scene, mesh) {
+        const customAttributes = this.getCustomShaderMaterial().getCustomAttributes();
+        if (customAttributes && customAttributes.length > 0)
+            attributes.push(...customAttributes);
+        if (attributes.indexOf("color") === -1)
+            attributes.push("color");
+    }
+    prepareDefines(defines, scene, mesh) {
+        if (!this.getIsEnabled())
+            return;
+        this.getCustomShaderMaterial().prepareCustomDefines(defines);
+    }
+    bindForSubMesh(uniformBuffer, scene, engine, subMesh) {
+        if (!this.getIsEnabled())
+            return;
+        this.getCustomShaderMaterial().updateCustomBindings(uniformBuffer);
+    }
+    static ExtractWindZoneOverride(properties, terrainTransform, builderInstance) {
+        const candidates = [];
+        if (properties)
+            candidates.push(properties);
+        if (properties && properties.properties)
+            candidates.push(properties.properties);
+        const meta = terrainTransform?.metadata;
+        if (meta)
+            candidates.push(meta);
+        if (meta && meta.toolkit)
+            candidates.push(meta.toolkit);
+        if (meta && meta.properties)
+            candidates.push(meta.properties);
+        const bmeta = builderInstance?.metadata;
+        if (bmeta)
+            candidates.push(bmeta);
+        if (bmeta && bmeta.toolkit)
+            candidates.push(bmeta.toolkit);
+        const tmeta = builderInstance?.transform?.metadata;
+        if (tmeta)
+            candidates.push(tmeta);
+        if (tmeta && tmeta.toolkit)
+            candidates.push(tmeta.toolkit);
+        let zones = null;
+        for (const c of candidates) {
+            if (!c)
+                continue;
+            if (Array.isArray(c.windzones)) {
+                zones = c.windzones;
+                break;
+            }
+        }
+        if (!zones || zones.length === 0)
+            return null;
+        let best = null;
+        let bestScore = -1e9;
+        for (const z of zones) {
+            if (!z)
+                continue;
+            const t = ((z.type != null) ? z.type : (z.mode != null ? z.mode : "")).toString().toLowerCase();
+            const isDirectional = (t.indexOf("direction") >= 0);
+            const main = (z.windMain != null) ? z.windMain : 0.0;
+            const score = (isDirectional ? 1000.0 : 0.0) + main;
+            if (score > bestScore) {
+                bestScore = score;
+                best = z;
+            }
+        }
+        return best;
+    }
+}
 export class VertexAnimationMaterial extends CustomShaderMaterial {
     constructor(name, scene) {
         super(name, scene);