{"TotalCount":48,"Files":[{"Ident":"redsnail.watertool","Path":"Water/WaterManager.cs","FileName":"WaterManager.cs","PackageType":"library","CodeKind":"Game","AssetVersionId":342768,"Code":"using System;\r\nusing System.Collections.Generic;\r\nusing System.Linq;\r\nusing Sandbox;\r\nusing Sandbox.Rendering;\r\nusing RenderStage = Sandbox.Rendering.Stage;\r\n\r\nnamespace RedSnail.WaterTool;\r\n\r\n[Title(\u0022Water Manager\u0022)]\r\npublic partial class WaterManager : Component, Component.ExecuteInEditor, Component.DontExecuteOnServer, IHotloadManaged\r\n{\r\n\tprivate SceneCustomObject m_SceneObject;\r\n\t\r\n\t[SkipHotload] public static WaterManager Current { get; private set; } = null;\r\n\t\r\n\t[Property(Title = \u0022Ocean\u0022), Group(\u0022Profile\u0022), Order(0)] public WaterDefinition OceanWaveProfile { get; set; }\r\n\t[Property(Title = \u0022Lake\u0022), Group(\u0022Profile\u0022)] public WaterDefinition LakeWaveProfile { get; set; }\r\n\t[Property(Title = \u0022River\u0022), Group(\u0022Profile\u0022)] public WaterDefinition RiverWaveProfile { get; set; }\r\n\t[Property(Title = \u0022Pool\u0022), Group(\u0022Profile\u0022)] public WaterDefinition PoolWaveProfile { get; set; }\r\n\t[Property(Title = \u0022Custom\u0022), Group(\u0022Profile\u0022)] public WaterDefinition CustomWaveProfile { get; set; }\r\n\r\n\t[Property(Title = \u0022Underwater Volume\u0022), Group(\u0022Post Processing\u0022)] public PostProcessVolume UnderwaterPostProcessVolume { get; set; }\r\n\r\n\t// Skips the whole compute \u002B draw for any bounded water surface (pools, rivers) whose\r\n\t// bounds fall outside the camera frustum. The single biggest win when a scene has many\r\n\t// separate WaterQuads scattered around. Infinite oceans (WaterBodyRenderer) are never culled.\r\n\t[Property(Title = \u0022Frustum Culling\u0022), Group(\u0022Performance\u0022)] public bool EnableFrustumCulling { get; set; } = true;\r\n\t// Extra slack (world units) added to each surface\u0027s bounds before the frustum test, so\r\n\t// surfaces at the screen edge don\u0027t pop when the camera turns quickly.\r\n\t[Property(Title = \u0022Cull Padding\u0022), Group(\u0022Performance\u0022)] public float CullPadding { get; set; } = 256.0f;\r\n\t// Beyond this distance (world units, measured to the nearest point of a surface\u0027s bounds)\r\n\t// the surface is skipped entirely. 0 = no distance limit. Independent of frustum culling.\r\n\t[Property(Title = \u0022Max Render Distance\u0022), Group(\u0022Performance\u0022)] public float MaxRenderDistance { get; set; } = 25000.0f;\r\n\r\n\t// Distance LOD: distant water quads drop tessellation instead of staying at full density.\r\n\t// Each level halves the cell count and doubles the cell size, so the surface covers exactly\r\n\t// the same area with 4x fewer vertices \u2014 coverage, ring layout and texture tiling are all\r\n\t// unchanged, only the triangle density falls off with distance.\r\n\t[Property(Title = \u0022Distance LOD\u0022), Group(\u0022Performance\u0022)] public bool EnableDistanceLod { get; set; } = true;\r\n\t// Distance at which LOD 1 begins; each level after that doubles (LOD 2 at 2x, LOD 3 at 4x).\r\n\t[Property(Title = \u0022LOD Start Distance\u0022), Group(\u0022Performance\u0022)] public float LodStartDistance { get; set; } = 1000.0f;\r\n\t[Property(Title = \u0022Max LOD Level\u0022), Group(\u0022Performance\u0022), Range(0, 4)] public int MaxLodLevel { get; set; } = 3;\r\n\r\n\tprivate ComputeShader m_ComputeShader;\r\n\r\n\tprivate CommandList m_CommandList = new(\u0022Water Rendering\u0022);\r\n\r\n\tprivate CameraComponent m_LastCamera;\r\n\tprivate Vector3 m_CameraPosition;\r\n\tprivate Frustum m_CullFrustum;\r\n\tprivate bool m_HasCullFrustum;\r\n\tprivate WaterDefinition m_DefaultProfile;\r\n\r\n\t// Rebuilt each RenderAll: the bounded surfaces that survived frustum culling. Reused\r\n\t// across the compute / barrier / draw phases so the decision is made exactly once.\r\n\tprivate readonly List\u003CWaterQuad\u003E m_VisibleQuads = [];\r\n\tprivate readonly List\u003CWaterFlow\u003E m_VisibleFlows = [];\r\n\r\n\tprivate List\u003CWaterQuad\u003E Quads { get; } = [];\r\n\tprivate List\u003CWaterBodyRenderer\u003E QuadRenderers { get; } = [];\r\n\tpublic List\u003CWaterBody\u003E Bodies { get; } = [];\r\n\tpublic List\u003CWaterFlow\u003E Flows { get; } = [];\r\n\tpublic List\u003CWaterExclusionVolume\u003E ExclusionVolumes { get; } = [];\r\n\tpublic List\u003CHullWaterExclusionVolume\u003E HullExclusionVolumes { get; } = [];\r\n\t\r\n\t\r\n\t\r\n\tprotected override void OnAwake()\r\n\t{\r\n\t\tCurrent = Scene.Get\u003CWaterManager\u003E();\r\n\t\t\r\n\t\tm_ComputeShader = new ComputeShader(\u0022water_clipmap_cs\u0022);\r\n\r\n\t\tm_DefaultProfile = new WaterDefinition();\r\n\t}\r\n\t\r\n\t\r\n\t\r\n\tprotected override void OnEnabled()\r\n\t{\r\n\t\tm_SceneObject = new SceneCustomObject(Scene.SceneWorld)\r\n\t\t{\r\n\t\t\tRenderOverride = RenderAll,\r\n\t\t\tTransform = new Transform(Vector3.Zero, Rotation.Identity),\r\n\t\t\tFlags =\r\n\t\t\t{\r\n\t\t\t\tIsOpaque = false,\r\n\t\t\t\tIsTranslucent = true,\r\n\t\t\t\tWantsFrameBufferCopy = false,\r\n\t\t\t\tWantsPrePass = false\r\n\t\t\t}\r\n\t\t};\r\n\t\t\r\n\t\tUpdateCommandListRegistration();\r\n\r\n\t\tRefreshWaterQuadsList();\r\n\t\tRefreshWaterBodyRenderersList();\r\n\t\tRefreshWaterBodiesList();\r\n\t\tRefreshWaterExclusionVolumesList();\r\n\t\tRefreshWaterHullExclusionVolumesList();\r\n\t}\r\n\t\r\n\t\r\n\t\r\n\tprotected override void OnDisabled()\r\n\t{\r\n\t\tm_SceneObject?.Delete();\r\n\t\tm_SceneObject = null;\r\n\r\n\t\tm_RippleBuffer?.Dispose();\r\n\t\tm_RippleBuffer = null;\r\n\t\r\n\t\tClearCalmVolumes();\r\n\r\n\t\t// Unregister from the camera we actually registered with. Scene.Camera can have changed\r\n\t\t// (or gone) since then, so asking for it again would leave the list attached to a camera\r\n\t\t// we never clean up.\r\n\t\tif (m_LastCamera.IsValid())\r\n\t\t\tm_LastCamera.RemoveCommandList(m_CommandList);\r\n\r\n\t\tm_LastCamera = null;\r\n\t}\r\n\r\n\r\n\r\n\t/// \u003Csummary\u003E\r\n\t/// Keeps the compute command list attached to a camera that will actually replay it. This has\r\n\t/// to run every frame, not just on enable: a scene starting without a camera would never\r\n\t/// register at all, and leaving play mode destroys the play camera without the reference here\r\n\t/// turning null, so comparing references alone would leave us bound to a dead camera forever.\r\n\t/// \u003C/summary\u003E\r\n\tprivate void UpdateCommandListRegistration()\r\n\t{\r\n\t\tvar renderCamera = GetRenderCamera();\r\n\r\n\t\tif (renderCamera == m_LastCamera \u0026\u0026 m_LastCamera.IsValid())\r\n\t\t\treturn;\r\n\r\n\t\tif (m_LastCamera.IsValid())\r\n\t\t\tm_LastCamera.RemoveCommandList(m_CommandList);\r\n\r\n\t\tm_LastCamera = null;\r\n\r\n\t\tif (renderCamera.IsValid())\r\n\t\t{\r\n\t\t\trenderCamera.AddCommandList(m_CommandList, RenderStage.AfterTransparent);\r\n\t\t\tm_LastCamera = renderCamera;\r\n\t\t}\r\n\t}\r\n\r\n\r\n\r\n\t/// \u003Csummary\u003E\r\n\t/// The camera whose command list actually replays. A scene camera does so in the editor\r\n\t/// viewport as well as in game, so it wins when one exists; with no camera in the scene the\r\n\t/// editor camera is the only thing left that will replay ours.\r\n\t/// \u003C/summary\u003E\r\n\tprivate CameraComponent GetRenderCamera()\r\n\t{\r\n\t\tif (Scene.Camera.IsValid())\r\n\t\t\treturn Scene.Camera;\r\n\r\n\t\tif (Scene.IsEditor)\r\n\t\t\treturn Application.Editor?.Camera;\r\n\r\n\t\treturn null;\r\n\t}\r\n\r\n\r\n\r\n\t/// \u003Csummary\u003E\r\n\t/// World position the water should treat as the viewer, for anything that culls or picks\r\n\t/// volumes by distance. While editing that has to be the viewport camera rather than the scene\r\n\t/// camera, or volumes are gathered around wherever the game camera happens to be parked and the\r\n\t/// water you are actually looking at gets the wrong set. Falls back when no camera exists at\r\n\t/// all, which is a real case - Scene.Camera excludes the editor camera and can be null.\r\n\t/// \u003C/summary\u003E\r\n\tpublic static Vector3 GetViewPosition(Scene scene, Vector3 fallback = default)\r\n\t{\r\n\t\tif (!scene.IsValid())\r\n\t\t\treturn fallback;\r\n\r\n\t\tif (scene.IsEditor)\r\n\t\t{\r\n\t\t\tvar editorCamera = Application.Editor?.Camera;\r\n\t\t\tif (editorCamera.IsValid())\r\n\t\t\t\treturn editorCamera.WorldPosition;\r\n\t\t}\r\n\r\n\t\treturn scene.Camera.IsValid() ? scene.Camera.WorldPosition : fallback;\r\n\t}\r\n\t\r\n\t\r\n\t\r\n\tvoid IHotloadManaged.Destroyed(Dictionary\u003Cstring, object\u003E _State)\r\n\t{\r\n\t\t_State[\u0022IsActive\u0022] = Current == this;\r\n\t}\r\n\r\n\r\n\r\n\tvoid IHotloadManaged.Created(IReadOnlyDictionary\u003Cstring, object\u003E _State)\r\n\t{\r\n\t\tif (_State.GetValueOrDefault(\u0022IsActive\u0022) is true)\r\n\t\t\tCurrent = this;\r\n\t}\r\n\t\r\n\t\r\n\t\r\n\t/// \u003Csummary\u003E\r\n\t/// Whether a bounded water surface should render this frame: inside the cull camera\u0027s\r\n\t/// frustum and within the max render distance. Returns true \u2014 render it \u2014 when there\u0027s\r\n\t/// no viewer, or when both culls are disabled.\r\n\t/// \u003C/summary\u003E\r\n\t/// \u003Csummary\u003EDistance at which the given LOD level starts (level 1 = LodStartDistance).\u003C/summary\u003E\r\n\tprivate float LodThreshold(int lod) =\u003E LodStartDistance * MathF.Pow(2.0f, lod - 1);\r\n\r\n\t/// \u003Csummary\u003E\r\n\t/// Resolves the tessellation LOD for a surface from how far its bounds are from the viewer.\r\n\t/// Takes the surface\u0027s current level so the switch can be hysteretic: a level only changes\r\n\t/// once the distance is comfortably past the boundary, otherwise a camera hovering right on\r\n\t/// a threshold would rebuild that surface\u0027s GPU buffers every frame.\r\n\t/// \u003C/summary\u003E\r\n\tpublic int ComputeLodLevel(BBox worldBounds, int currentLod)\r\n\t{\r\n\t\tif (!EnableDistanceLod || !m_HasCullFrustum || MaxLodLevel \u003C= 0 || LodStartDistance \u003C= 0.0f)\r\n\t\t\treturn 0;\r\n\r\n\t\tconst float hysteresis = 0.15f;\r\n\r\n\t\tfloat distance = worldBounds.ClosestPoint(m_CameraPosition).Distance(m_CameraPosition);\r\n\r\n\t\tint lod = Math.Clamp(currentLod, 0, MaxLodLevel);\r\n\r\n\t\t// Step out as the surface recedes, in as it approaches \u2014 one level at a time\r\n\t\twhile (lod \u003C MaxLodLevel \u0026\u0026 distance \u003E LodThreshold(lod \u002B 1) * (1.0f \u002B hysteresis))\r\n\t\t\tlod\u002B\u002B;\r\n\r\n\t\twhile (lod \u003E 0 \u0026\u0026 distance \u003C LodThreshold(lod) * (1.0f - hysteresis))\r\n\t\t\tlod--;\r\n\r\n\t\treturn lod;\r\n\t}\r\n\r\n\r\n\r\n\tprivate bool IsRenderVisible(BBox worldBounds)\r\n\t{\r\n\t\t// Both culls need a viewer; without one, don\u0027t cull anything.\r\n\t\tif (!m_HasCullFrustum)\r\n\t\t\treturn true;\r\n\r\n\t\t// Distance cull \u2014 measured to the nearest point of the bounds, so a large surface\r\n\t\t// whose centre is far but edge is near still renders.\r\n\t\tif (MaxRenderDistance \u003E 0.0f)\r\n\t\t{\r\n\t\t\tfloat distSq = worldBounds.ClosestPoint(m_CameraPosition).DistanceSquared(m_CameraPosition);\r\n\r\n\t\t\tif (distSq \u003E MaxRenderDistance * MaxRenderDistance)\r\n\t\t\t\treturn false;\r\n\t\t}\r\n\r\n\t\t// Frustum cull\r\n\t\tif (EnableFrustumCulling \u0026\u0026 !m_CullFrustum.IsInside(worldBounds.Grow(CullPadding), partially: true))\r\n\t\t\treturn false;\r\n\r\n\t\treturn true;\r\n\t}\r\n\r\n\r\n\r\n\tprivate void RenderAll(SceneObject _)\r\n\t{\r\n\t\tif (Graphics.LayerType != SceneLayerType.Translucent)\r\n\t\t\treturn;\r\n\r\n\t\tm_CommandList.Reset();\r\n\r\n\t\t// Frustum-cull the bounded surfaces once, up front. The compute / barrier / draw\r\n\t\t// phases below all iterate these lists, so a culled surface pays for nothing.\r\n\t\tm_VisibleQuads.Clear();\r\n\t\tforeach (var quad in Quads)\r\n\t\t{\r\n\t\t\tif (quad.IsValid() \u0026\u0026 quad.ParticipatesInRendering \u0026\u0026 IsRenderVisible(quad.GetWorldBounds2D()))\r\n\t\t\t\tm_VisibleQuads.Add(quad);\r\n\t\t}\r\n\r\n\t\tm_VisibleFlows.Clear();\r\n\t\tforeach (var flow in Flows)\r\n\t\t{\r\n\t\t\tif (flow.IsValid() \u0026\u0026 flow.ParticipatesInRendering \u0026\u0026 IsRenderVisible(flow.GetWorldBounds()))\r\n\t\t\t\tm_VisibleFlows.Add(flow);\r\n\t\t}\r\n\r\n\t\tbool hasAnythingToRender = false;\r\n\r\n\t\t// Renderers are the infinite ocean surfaces \u2014 never culled (their bounds are \u0022everywhere\u0022)\r\n\t\tforeach (var renderer in QuadRenderers)\r\n\t\t{\r\n\t\t\tif (!renderer.IsValid() || !renderer.ParticipatesInRendering)\r\n\t\t\t\tcontinue;\r\n\r\n\t\t\thasAnythingToRender = true;\r\n\t\t\trenderer.RecordCompute(m_CommandList, m_ComputeShader, m_CameraPosition);\r\n\t\t}\r\n\r\n\t\tforeach (var quad in m_VisibleQuads)\r\n\t\t{\r\n\t\t\thasAnythingToRender = true;\r\n\t\t\tquad.RecordCompute(m_CommandList, m_ComputeShader, m_CameraPosition);\r\n\t\t}\r\n\r\n\t\t// Flows build their mesh on the CPU (no compute pass or barrier needed)\r\n\t\tif (m_VisibleFlows.Count \u003E 0)\r\n\t\t\thasAnythingToRender = true;\r\n\r\n\t\tif (hasAnythingToRender)\r\n\t\t{\r\n\t\t\tforeach (var renderer in QuadRenderers)\r\n\t\t\t{\r\n\t\t\t\tif (!renderer.IsValid() || !renderer.ParticipatesInRendering)\r\n\t\t\t\t\tcontinue;\r\n\r\n\t\t\t\trenderer.BarrierTransition(m_CommandList);\r\n\t\t\t}\r\n\r\n\t\t\tforeach (var quad in m_VisibleQuads)\r\n\t\t\t\tquad.BarrierTransition(m_CommandList);\r\n\r\n\t\t\tm_CommandList.Attributes.GrabFrameTexture(\u0022FrameBufferCopyTexture\u0022);\r\n\r\n\t\t\tforeach (var renderer in QuadRenderers)\r\n\t\t\t{\r\n\t\t\t\tif (!renderer.IsValid() || !renderer.ParticipatesInRendering)\r\n\t\t\t\t\tcontinue;\r\n\r\n\t\t\t\trenderer.Draw(m_CommandList);\r\n\t\t\t}\r\n\r\n\t\t\tforeach (var quad in m_VisibleQuads)\r\n\t\t\t\tquad.Draw(m_CommandList);\r\n\r\n\t\t\tforeach (var flow in m_VisibleFlows)\r\n\t\t\t\tflow.Draw(m_CommandList);\r\n\t\t}\r\n\t}\r\n\t\r\n\t\r\n\t\r\n\tprotected override void OnUpdate()\r\n\t{\r\n\t\t// We\u0027ve to make sure it\u0027s always correct while in the editor\r\n\t\t// (S\u0026box is a complete mess when it comes to managing a singleton properly on a component that execute in the editor, bcs its reference get constantly swapped between\r\n\t\t// gameplay and editor, we\u0027ve to do this non sense !)\r\n\t\tif (Scene.IsEditor)\r\n\t\t\tCurrent = Scene.Get\u003CWaterManager\u003E();\r\n\r\n\t\tUpdateCommandListRegistration();\r\n\r\n\t\t// The camera we cull and centre the clipmap against: the game camera while playing,\r\n\t\t// otherwise the editor viewport camera so culling follows what you\u0027re actually looking at.\r\n\t\tCameraComponent cullCamera = Game.IsPlaying ? Scene.Camera : Application.Editor?.Camera;\r\n\r\n\t\tif (cullCamera.IsValid())\r\n\t\t{\r\n\t\t\tm_CameraPosition = cullCamera.WorldPosition;\r\n\t\t\tm_CullFrustum = cullCamera.GetFrustum();\r\n\t\t\tm_HasCullFrustum = true;\r\n\t\t}\r\n\t\telse\r\n\t\t{\r\n\t\t\tm_CameraPosition = Vector3.Zero;\r\n\t\t\tm_HasCullFrustum = false;\r\n\t\t}\r\n\r\n\t\tif (UnderwaterPostProcessVolume.IsValid())\r\n\t\t\tUnderwaterPostProcessVolume.Enabled = IsPositionInsideAny(m_CameraPosition);\r\n\r\n\t\tUpdateRipples();\r\n\t\tUpdateCalmVolumes();\r\n\t}\r\n\r\n\t/// \u003Csummary\u003E\r\n\t/// We have to do all this non sense bcs using a Register/Unregister logic with OnEnabled/OnDisabled is a complete\r\n\t/// mess to manage when we enter play mode/stop play mode in the editor, the references get duplicated etc... Otherwise we\u0027ve to check by gameobject id...\r\n\t/// It\u0027s just way too annoying, refreshing the whole list is safer and we\u0027re always sure to have the proper count of components\r\n\t/// \u003C/summary\u003E\r\n\tpublic void RefreshWaterQuadsList()\r\n\t{\r\n\t\tif (!Scene.IsValid()) // S\u0026box make this null while stopping play mode and entering back the editor mode (We need to guard this)\r\n\t\t\treturn;\r\n\t\t\r\n\t\tQuads.Clear();\r\n\t\tQuads.AddRange(Scene.GetAll\u003CWaterQuad\u003E());\r\n\t}\r\n\r\n\tpublic void RefreshWaterBodyRenderersList()\r\n\t{\r\n\t\tif (!Scene.IsValid()) // S\u0026box make this null while stopping play mode and entering back the editor mode (We need to guard this)\r\n\t\t\treturn;\r\n\t\t\r\n\t\tQuadRenderers.Clear();\r\n\t\tQuadRenderers.AddRange(Scene.GetAll\u003CWaterBodyRenderer\u003E());\r\n\t}\r\n\r\n\tpublic void RefreshWaterBodiesList()\r\n\t{\r\n\t\tif (!Scene.IsValid()) // S\u0026box make this null while stopping play mode and entering back the editor mode (We need to guard this)\r\n\t\t\treturn;\r\n\t\t\r\n\t\tBodies.Clear();\r\n\t\tBodies.AddRange(Scene.GetAll\u003CWaterBody\u003E());\r\n\t}\r\n\t\r\n\tpublic void RefreshWaterFlowsList()\r\n\t{\r\n\t\tif (!Scene.IsValid()) // S\u0026box make this null while stopping play mode and entering back the editor mode (We need to guard this)\r\n\t\t\treturn;\r\n\t\t\r\n\t\tFlows.Clear();\r\n\t\tFlows.AddRange(Scene.GetAll\u003CWaterFlow\u003E());\r\n\t}\r\n\r\n\tpublic void RefreshWaterExclusionVolumesList()\r\n\t{\r\n\t\tif (!Scene.IsValid()) // S\u0026box make this null while stopping play mode and entering back the editor mode (We need to guard this)\r\n\t\t\treturn;\r\n\t\t\r\n\t\tExclusionVolumes.Clear();\r\n\t\tExclusionVolumes.AddRange(Scene.GetAll\u003CWaterExclusionVolume\u003E());\r\n\t}\r\n\r\n\tpublic void RefreshWaterHullExclusionVolumesList()\r\n\t{\r\n\t\tif (!Scene.IsValid()) // S\u0026box make this null while stopping play mode and entering back the editor mode (We need to guard this)\r\n\t\t\treturn;\r\n\t\t\r\n\t\tHullExclusionVolumes.Clear();\r\n\t\tHullExclusionVolumes.AddRange(Scene.GetAll\u003CHullWaterExclusionVolume\u003E());\r\n\t}\r\n\r\n\tprivate WaterDefinition GetWaveProfileForType(WaterBodyType waterType) =\u003E waterType switch\r\n\t{\r\n\t\tWaterBodyType.Ocean =\u003E OceanWaveProfile,\r\n\t\tWaterBodyType.Lake =\u003E LakeWaveProfile,\r\n\t\tWaterBodyType.River =\u003E RiverWaveProfile,\r\n\t\tWaterBodyType.Pool =\u003E PoolWaveProfile,\r\n\t\t_ =\u003E CustomWaveProfile\r\n\t};\r\n\r\n\tpublic static WaterDefinition GetWaveProfile(WaterBodyType _WaterType)\r\n\t{\r\n\t\tif (Current == null)\r\n\t\t\treturn null;\r\n\r\n\t\tWaterDefinition profile = Current.GetWaveProfileForType(_WaterType);\r\n\r\n\t\tif (profile.IsValid())\r\n\t\t\treturn profile;\r\n\r\n\t\tLog.Warning(\u0022[WaterTool] No water profile found in the \u0027Water Manager\u0027, please add a water profile for the specified water type ! (Project Settings \u003E Water Manager \u003E \u0027Assign the profiles\u0027)\u0022);\r\n\r\n\t\treturn Current.m_DefaultProfile;\r\n\t}\r\n}\r\n"},{"Ident":"redsnail.watertool","Path":"Water/WaterCalmVolume.cs","FileName":"WaterCalmVolume.cs","PackageType":"library","CodeKind":"Game","AssetVersionId":342768,"Code":"using Sandbox;\nusing Sandbox.Volumes;\n\nnamespace RedSnail.WaterTool;\n\n/// \u003Csummary\u003E\n/// Calms the water inside a volume: wave displacement (and the surface normals that\n/// come from it) smoothly fade to flat. Affects every water surface \u2014 WaterQuad,\n/// WaterBodyRenderer and WaterFlow \u2014 so it\u0027s the clean way to blend two of them\n/// together. The classic use is a river mouth meeting an ocean: drop a calm volume\n/// over the junction, set both surfaces to the same height there, and the wave\n/// mismatch (ocean chop poking above the river, seams) disappears.\n///\n/// Purely visual \u2014 it doesn\u0027t touch buoyancy, swimming or the flow current.\n/// \u003C/summary\u003E\n[Title(\u0022Water Calm Volume\u0022)]\n[Category(\u0022Volumes\u0022)]\n[Icon(\u0022water\u0022)]\npublic sealed class WaterCalmVolume : VolumeComponent, Component.ExecuteInEditor\n{\n\t// 0 = no effect, 1 = perfectly flat at the core. Lets a volume only partially\n\t// settle the water if you want some residual motion.\n\t[Property, Range(0.0f, 1.0f)] public float Strength { get; set; } = 1.0f;\n\n\t// Fraction of the volume (from each face inward) over which the calming ramps in.\n\t// 0 = hard edge (a visible crease), 1 = ramps all the way from the center.\n\t[Property, Range(0.05f, 1.0f)] public float Falloff { get; set; } = 0.4f;\n\t\n\t\n\t\n\tprotected override void OnEnabled()\n\t{\n\t\tWaterManager.Current?.RefreshWaterCalmVolumesList();\n\t}\n\t\n\tprotected override void OnDisabled()\n\t{\n\t\tWaterManager.Current?.RefreshWaterCalmVolumesList();\n\t}\n\n\tprotected override void DrawGizmos()\n\t{\n\t\tbase.DrawGizmos();\n\n\t\tif (!Gizmo.IsSelected)\n\t\t\treturn;\n\n\t\t// Faint fill so calm volumes read differently from exclusion volumes\n\t\tBBox box = SceneVolume.GetBounds();\n\n\t\tGizmo.Draw.Color = Color.Cyan.WithAlpha(0.06f);\n\t\tGizmo.Draw.SolidBox(box);\n\t}\n\n\tpublic (Vector3 Center, Vector3 Forward, Vector3 Up, Vector3 HalfExtents) GetWorldOBB()\n\t{\n\t\tBBox local = SceneVolume.GetBounds();\n\t\tVector3 center = WorldTransform.PointToWorld(local.Center);\n\t\tVector3 halfExtents = local.Size * 0.5f;\n\n\t\treturn (center, WorldRotation.Forward, WorldTransform.Up, halfExtents);\n\t}\n}\n"},{"Ident":"redsnail.watertool","Path":"Water/WaterManager.CalmVolumes.cs","FileName":"WaterManager.CalmVolumes.cs","PackageType":"library","CodeKind":"Game","AssetVersionId":342768,"Code":"using System;\nusing System.Collections.Generic;\nusing Sandbox;\n\nnamespace RedSnail.WaterTool;\n\npublic partial class WaterManager\n{\n\t// Calm volumes are few (river/ocean junctions) and apply to every water surface,\n\t// so \u2014 like ripples \u2014 they live in one shared buffer the manager updates once a\n\t// frame, rather than the per-component distance-sorted exclusion-volume pattern.\n\n\tprivate const int MAX_CALM_VOLUMES = 64;\n\tprivate const int CALM_VOLUME_ROWS = 4;\n\n\tpublic List\u003CWaterCalmVolume\u003E CalmVolumes { get; } = [];\n\n\tprivate GpuBuffer\u003CVector4\u003E m_CalmVolumeBuffer;\n\tprivate readonly Vector4[] m_CalmVolumeData = new Vector4[MAX_CALM_VOLUMES * CALM_VOLUME_ROWS];\n\tprivate int m_ActiveCalmCount;\n\t\n\t\n\t\n\tpublic void RefreshWaterCalmVolumesList()\n\t{\n\t\tif (!Scene.IsValid()) // S\u0026box make this null while stopping play mode and entering back the editor mode (We need to guard this)\n\t\t\treturn;\n\t\t\n\t\tCalmVolumes.Clear();\n\t\tCalmVolumes.AddRange(Scene.GetAll\u003CWaterCalmVolume\u003E());\n\t}\n\t\n\t\n\t\n\tprivate void UpdateCalmVolumes()\n\t{\n\t\tint count = 0;\n\n\t\tforeach (var volume in CalmVolumes)\n\t\t{\n\t\t\tif (!volume.IsValid() || !volume.Active)\n\t\t\t\tcontinue;\n\n\t\t\tif (count \u003E= MAX_CALM_VOLUMES)\n\t\t\t\tbreak;\n\n\t\t\tvar (center, forward, up, half) = volume.GetWorldOBB();\n\n\t\t\tint row = count * CALM_VOLUME_ROWS;\n\t\t\tm_CalmVolumeData[row \u002B 0] = new Vector4(forward.x, forward.y, forward.z, half.x);\n\t\t\tm_CalmVolumeData[row \u002B 1] = new Vector4(up.x, up.y, up.z, half.y);\n\t\t\tm_CalmVolumeData[row \u002B 2] = new Vector4(center.x, center.y, center.z, half.z);\n\t\t\tm_CalmVolumeData[row \u002B 3] = new Vector4(volume.Falloff, volume.Strength, 0.0f, 0.0f);\n\n\t\t\tcount\u002B\u002B;\n\t\t}\n\n\t\tm_ActiveCalmCount = count;\n\n\t\tEnsureCalmBuffer();\n\n\t\tm_CalmVolumeBuffer.SetData(m_CalmVolumeData.AsSpan(0, count * CALM_VOLUME_ROWS));\n\t}\n\n\tprivate void EnsureCalmBuffer()\n\t{\n\t\tif (!m_CalmVolumeBuffer.IsValid())\n\t\t\tm_CalmVolumeBuffer = new GpuBuffer\u003CVector4\u003E(MAX_CALM_VOLUMES * CALM_VOLUME_ROWS, GpuBuffer.UsageFlags.Structured);\n\t}\n\n\tinternal void ApplyCalmAttributes(RenderAttributes _Attributes)\n\t{\n\t\t_Attributes.Set(\u0022WaterCalmVolumeCount\u0022, m_ActiveCalmCount);\n\n\t\tif (m_CalmVolumeBuffer.IsValid())\n\t\t\t_Attributes.Set(\u0022WaterCalmVolumeData\u0022, m_CalmVolumeBuffer);\n\t}\n\n\n\n\t/// \u003Csummary\u003E\n\t/// CPU evaluation of the calm factor at a world position (0 = full waves, 1 = flat).\n\t/// MUST mirror ComputeWaterCalm() in water_calm_volume.fxc so physics (buoyancy,\n\t/// height queries) matches the flattened visual surface.\n\t/// \u003C/summary\u003E\n\tpublic float ComputeCalm(Vector3 _WorldPosition)\n\t{\n\t\tif (CalmVolumes.Count == 0)\n\t\t\treturn 0.0f;\n\n\t\tfloat calm = 0.0f;\n\n\t\tforeach (var volume in CalmVolumes)\n\t\t{\n\t\t\tif (!volume.IsValid() || !volume.Active)\n\t\t\t\tcontinue;\n\n\t\t\tvar (center, forward, up, half) = volume.GetWorldOBB();\n\n\t\t\tVector3 right = Vector3.Cross(up, forward);\n\t\t\tVector3 d = _WorldPosition - center;\n\n\t\t\tfloat nx = MathF.Abs(Vector3.Dot(d, forward)) / MathF.Max(half.x, 0.001f);\n\t\t\tfloat ny = MathF.Abs(Vector3.Dot(d, right))   / MathF.Max(half.y, 0.001f);\n\t\t\tfloat nz = MathF.Abs(Vector3.Dot(d, up))      / MathF.Max(half.z, 0.001f);\n\n\t\t\tfloat nmax = MathF.Max(nx, MathF.Max(ny, nz));\n\n\t\t\tfloat falloffStart = Math.Clamp(1.0f - volume.Falloff, 0.0f, 1.0f);\n\t\t\tfloat volumeCalm = (1.0f - SmoothStep(falloffStart, 1.0f, nmax)) * volume.Strength;\n\n\t\t\tcalm = MathF.Max(calm, volumeCalm);\n\t\t}\n\n\t\treturn Math.Clamp(calm, 0.0f, 1.0f);\n\t}\n\n\t// Matches HLSL smoothstep().\n\tprivate static float SmoothStep(float _Edge0, float _Edge1, float _X)\n\t{\n\t\tfloat t = Math.Clamp((_X - _Edge0) / MathF.Max(_Edge1 - _Edge0, 1e-6f), 0.0f, 1.0f);\n\t\treturn t * t * (3.0f - 2.0f * t);\n\t}\n\n\tprivate void ClearCalmVolumes()\n\t{\n\t\tm_CalmVolumeBuffer?.Dispose();\n\t\tm_CalmVolumeBuffer = null;\n\t}\n}\n"},{"Ident":"redsnail.watertool","Path":"Water/WaterWaveUtility.cs","FileName":"WaterWaveUtility.cs","PackageType":"library","CodeKind":"Game","AssetVersionId":342768,"Code":"using System;\r\nusing Sandbox;\r\n\r\nnamespace RedSnail.WaterTool;\r\n\r\npublic enum WaterBodyType\r\n{\r\n\tOcean,\r\n\tLake,\r\n\tRiver,\r\n\tPool,\r\n\tCustom\r\n}\r\n\r\npublic static class WaterWaveUtility\r\n{\r\n\tpublic static Vector3 ComputeDisplacementAt(Vector2 worldXY, WaterDefinition profile)\r\n\t{\r\n\t\tVector3 detail = ComputeGerstner(worldXY, profile.WavesScale, profile.WavesSpeed, profile.WavesDirection, profile.WavesOctaves, profile.WavesLacunarity, profile.WavesPersistence, profile.WavesSteepness) * profile.WavesIntensity;\r\n\t\tVector3 swell = ComputeGerstner(worldXY, profile.SwellScale, profile.SwellSpeed, profile.SwellDirection, profile.SwellOctaves, profile.SwellLacunarity, profile.SwellPersistence, profile.SwellSteepness) * profile.SwellIntensity;\r\n\t\treturn detail \u002B swell;\r\n\t}\r\n\r\n\tpublic static Vector3 ComputeVelocityAt(Vector2 worldXY, WaterDefinition profile)\r\n\t{\r\n\t\tVector3 detail = ComputeGerstnerVelocity(worldXY, profile.WavesScale, profile.WavesSpeed, profile.WavesDirection, profile.WavesOctaves, profile.WavesLacunarity, profile.WavesPersistence, profile.WavesSteepness) * profile.WavesIntensity;\r\n\t\tVector3 swell = ComputeGerstnerVelocity(worldXY, profile.SwellScale, profile.SwellSpeed, profile.SwellDirection, profile.SwellOctaves, profile.SwellLacunarity, profile.SwellPersistence, profile.SwellSteepness) * profile.SwellIntensity;\r\n\t\treturn detail \u002B swell;\r\n\t}\r\n\r\n\tprivate static Vector3 ComputeGerstner(Vector2 worldXY, float scale, float speed, Vector2 direction, int octaves, float lacunarity, float persistence, float steepness)\r\n\t{\r\n\t\tif (scale \u003C= 0.0f || speed \u003C= 0.0f || octaves \u003C= 0)\r\n\t\t\treturn Vector3.Zero;\r\n\r\n\t\tVector2 waveDirection = direction.Normal;\r\n\t\tfloat t = Time.Now * speed;\r\n\r\n\t\tVector3 displacement = Vector3.Zero;\r\n\t\tfloat amp = 1.0f;\r\n\t\tfloat freq = scale;\r\n\t\tfloat maxAmp = 0f;\r\n\r\n\t\tfor (int oct = 0; oct \u003C octaves; oct\u002B\u002B)\r\n\t\t{\r\n\t\t\tfloat angle = oct * 1.2f;\r\n\t\t\tVector2 octDir = new(\r\n\t\t\t\twaveDirection.x * MathF.Cos(angle) - waveDirection.y * MathF.Sin(angle),\r\n\t\t\t\twaveDirection.x * MathF.Sin(angle) \u002B waveDirection.y * MathF.Cos(angle)\r\n\t\t\t);\r\n\r\n\t\t\tfloat phase = freq * (octDir.x * worldXY.x \u002B octDir.y * worldXY.y) \u002B t * freq * 0.5f;\r\n\t\t\tdisplacement.x \u002B= steepness * amp * octDir.x * MathF.Cos(phase);\r\n\t\t\tdisplacement.y \u002B= steepness * amp * octDir.y * MathF.Cos(phase);\r\n\t\t\tdisplacement.z \u002B= amp * MathF.Sin(phase);\r\n\r\n\t\t\tmaxAmp \u002B= amp;\r\n\t\t\tamp *= persistence;\r\n\t\t\tfreq *= lacunarity;\r\n\t\t}\r\n\r\n\t\treturn maxAmp \u003E 0.0f ? displacement / maxAmp : Vector3.Zero;\r\n\t}\r\n\r\n\tprivate static Vector3 ComputeGerstnerVelocity(Vector2 worldXY, float scale, float speed, Vector2 direction, int octaves, float lacunarity, float persistence, float steepness)\r\n\t{\r\n\t\tif (scale \u003C= 0.0f || speed \u003C= 0.0f || octaves \u003C= 0)\r\n\t\t\treturn Vector3.Zero;\r\n\r\n\t\tVector2 waveDirection = direction.Normal;\r\n\t\tfloat t = Time.Now * speed;\r\n\r\n\t\tVector3 velocity = Vector3.Zero;\r\n\t\tfloat amp = 1.0f;\r\n\t\tfloat freq = scale;\r\n\t\tfloat maxAmp = 0f;\r\n\r\n\t\tfor (int oct = 0; oct \u003C octaves; oct\u002B\u002B)\r\n\t\t{\r\n\t\t\tfloat angle = oct * 1.2f;\r\n\t\t\tVector2 octDir = new(\r\n\t\t\t\twaveDirection.x * MathF.Cos(angle) - waveDirection.y * MathF.Sin(angle),\r\n\t\t\t\twaveDirection.x * MathF.Sin(angle) \u002B waveDirection.y * MathF.Cos(angle)\r\n\t\t\t);\r\n\r\n\t\t\tfloat phase = freq * (octDir.x * worldXY.x \u002B octDir.y * worldXY.y) \u002B t * freq * 0.5f;\r\n\t\t\tfloat angularVelocity = freq * speed * 0.5f;\r\n\r\n\t\t\tvelocity.x -= steepness * amp * octDir.x * angularVelocity * MathF.Sin(phase);\r\n\t\t\tvelocity.y -= steepness * amp * octDir.y * angularVelocity * MathF.Sin(phase);\r\n\t\t\tvelocity.z \u002B= amp * angularVelocity * MathF.Cos(phase);\r\n\r\n\t\t\tmaxAmp \u002B= amp;\r\n\t\t\tamp *= persistence;\r\n\t\t\tfreq *= lacunarity;\r\n\t\t}\r\n\r\n\t\treturn maxAmp \u003E 0.0f ? velocity / maxAmp : Vector3.Zero;\r\n\t}\r\n}\r\n"},{"Ident":"redsnail.watertool","Path":"Code/Water/HullWaterExclusionVolume.cs","FileName":"HullWaterExclusionVolume.cs","PackageType":"library","CodeKind":"Game","AssetVersionId":342768,"Code":"using System;\r\nusing System.Collections.Generic;\r\nusing System.Linq;\r\nusing Sandbox;\r\n\r\nnamespace RedSnail.WaterTool;\r\n\r\n/// \u003Csummary\u003E\r\n/// Excludes the water surface inside a mesh hull rather than an approximated box volume.\r\n/// Place on the same GameObject as the ModelRenderer. The physics collision mesh is extracted\r\n/// once and uploaded to the GPU as a triangle list; only the WorldToLocal matrix is updated\r\n/// each frame as the object moves or rotates.\r\n/// \u003C/summary\u003E\r\n[Title(\u0022Hull Water Exclusion Volume\u0022), Group(\u0022Water\u0022), Icon(\u0022sailing\u0022)]\r\npublic sealed class HullWaterExclusionVolume : Component, Component.ExecuteInEditor\r\n{\r\n\t/// \u003Csummary\u003ETriangle vertices in model LOCAL space, flat (v0,v1,v2, v0,v1,v2 \u2026).\u003C/summary\u003E\r\n\tpublic Vector3[] LocalTriangles { get; private set; } = Array.Empty\u003CVector3\u003E();\r\n\r\n\t/// \u003Csummary\u003EAABB of all local triangles, used for early GPU rejection.\u003C/summary\u003E\r\n\tpublic BBox LocalAABB { get; private set; }\r\n\t\r\n\t[Property] private Model CustomModel { get; set; }\r\n\r\n\tprivate Model _lastModel;\r\n\r\n\tprotected override void OnEnabled()\r\n\t{\r\n\t\tRebuildMesh();\r\n\r\n\t\tWaterManager.Current?.RefreshWaterHullExclusionVolumesList();\r\n\t}\r\n\r\n\tprotected override void OnDisabled()\r\n\t{\r\n\t\tWaterManager.Current?.RefreshWaterHullExclusionVolumesList();\r\n\t}\r\n\r\n\tprotected override void OnUpdate()\r\n\t{\r\n\t\tvar model = CustomModel.IsValid() ? CustomModel : GetComponent\u003CModelRenderer\u003E()?.Model;\r\n\t\t\r\n\t\tif (model != _lastModel)\r\n\t\t\tRebuildMesh();\r\n\t}\r\n\r\n\tprivate void RebuildMesh()\r\n\t{\r\n\t\tvar model = CustomModel.IsValid() ? CustomModel : GetComponent\u003CModelRenderer\u003E()?.Model;\r\n\r\n\t\tif (model == null)\r\n\t\t{\r\n\t\t\tLocalTriangles = Array.Empty\u003CVector3\u003E();\r\n\t\t\tLocalAABB = default;\r\n\t\t\t_lastModel = null;\r\n\t\t\tLog.Warning($\u0022{nameof(HullWaterExclusionVolume)}: No ModelRenderer or Model found.\u0022);\r\n\t\t\treturn;\r\n\t\t}\r\n\r\n\t\t_lastModel = model;\r\n\r\n\t\tvar tris = new List\u003CVector3\u003E();\r\n\t\tvar aabbMin = new Vector3(float.MaxValue, float.MaxValue, float.MaxValue);\r\n\t\tvar aabbMax = new Vector3(float.MinValue, float.MinValue, float.MinValue);\r\n\r\n\t\t// Prefer the physics collision mesh \u2014 it\u0027s already simplified and watertight.\r\n\t\tvar physics = model.Physics;\r\n\t\tif (physics != null)\r\n\t\t{\r\n\t\t\tforeach (var part in physics.Parts)\r\n\t\t\t{\r\n\t\t\t\tforeach (var meshPart in part.Meshes)\r\n\t\t\t\t{\r\n\t\t\t\t\tforeach (var tri in meshPart.GetTriangles())\r\n\t\t\t\t\t{\r\n\t\t\t\t\t\ttris.Add(tri.A);\r\n\t\t\t\t\t\ttris.Add(tri.B);\r\n\t\t\t\t\t\ttris.Add(tri.C);\r\n\r\n\t\t\t\t\t\taabbMin = Vector3.Min(aabbMin, Vector3.Min(tri.A, Vector3.Min(tri.B, tri.C)));\r\n\t\t\t\t\t\taabbMax = Vector3.Max(aabbMax, Vector3.Max(tri.A, Vector3.Max(tri.B, tri.C)));\r\n\t\t\t\t\t}\r\n\t\t\t\t}\r\n\r\n\t\t\t\t// Convex hull shapes have no MeshParts \u2014 triangulate each hull instead.\r\n\t\t\t\tforeach (var hullPart in part.Hulls)\r\n\t\t\t\t{\r\n\t\t\t\t\tvar pts = hullPart.GetPoints()?.ToArray();\r\n\t\t\t\t\tif (pts == null || pts.Length \u003C 4) continue;\r\n\t\t\t\t\tTriangulateConvexHull(pts, tris, ref aabbMin, ref aabbMax);\r\n\t\t\t\t}\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\t// Fallback: render mesh (may have more triangles, less ideal for GPU iteration)\r\n\t\tif (tris.Count == 0)\r\n\t\t{\r\n\t\t\tvar vertices = model.GetVertices();\r\n\t\t\tvar indices = model.GetIndices();\r\n\r\n\t\t\tif (vertices != null \u0026\u0026 indices != null)\r\n\t\t\t{\r\n\t\t\t\tfor (int i = 0; i \u002B 2 \u003C indices.Length; i \u002B= 3)\r\n\t\t\t\t{\r\n\t\t\t\t\tVector3 v0 = vertices[indices[i \u002B 0]].Position;\r\n\t\t\t\t\tVector3 v1 = vertices[indices[i \u002B 1]].Position;\r\n\t\t\t\t\tVector3 v2 = vertices[indices[i \u002B 2]].Position;\r\n\r\n\t\t\t\t\ttris.Add(v0);\r\n\t\t\t\t\ttris.Add(v1);\r\n\t\t\t\t\ttris.Add(v2);\r\n\r\n\t\t\t\t\taabbMin = Vector3.Min(aabbMin, Vector3.Min(v0, Vector3.Min(v1, v2)));\r\n\t\t\t\t\taabbMax = Vector3.Max(aabbMax, Vector3.Max(v0, Vector3.Max(v1, v2)));\r\n\t\t\t\t}\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\tLocalTriangles = tris.ToArray();\r\n\t\tLocalAABB = tris.Count \u003E 0 ? new BBox(aabbMin, aabbMax) : default;\r\n\t}\r\n\r\n\t// N\u00B3 convex hull triangulation.\r\n\t// Finds each hull face by collecting ALL coplanar vertices, then fan-triangulates once per face.\r\n\t// Without this, rectangular faces (4 coplanar verts) emit C(4,3)=4 overlapping triangles,\r\n\t// flipping the ray parity and incorrectly marking exterior points as inside.\r\n\tprivate static void TriangulateConvexHull(Vector3[] verts, List\u003CVector3\u003E result, ref Vector3 aabbMin, ref Vector3 aabbMax)\r\n\t{\r\n\t\tint n = verts.Length;\r\n\t\tif (n \u003C 4) return;\r\n\r\n\t\tvar centroid = Vector3.Zero;\r\n\t\tforeach (var v in verts) centroid \u002B= v;\r\n\t\tcentroid /= n;\r\n\r\n\t\tvar processedFaces = new HashSet\u003Cstring\u003E();\r\n\r\n\t\tfor (int i = 0; i \u003C n; i\u002B\u002B)\r\n\t\t\tfor (int j = i \u002B 1; j \u003C n; j\u002B\u002B)\r\n\t\t\t\tfor (int k = j \u002B 1; k \u003C n; k\u002B\u002B)\r\n\t\t\t\t{\r\n\t\t\t\t\tVector3 A = verts[i], B = verts[j], C = verts[k];\r\n\t\t\t\t\tVector3 rawNormal = Vector3.Cross(B - A, C - A);\r\n\t\t\t\t\tif (rawNormal.LengthSquared \u003C 1e-8f) continue;\r\n\t\t\t\t\tVector3 normal = rawNormal.Normal; // normalize so d = actual distance in units\r\n\r\n\t\t\t\t\tbool pos = false, neg = false;\r\n\t\t\t\t\tvar faceIndices = new List\u003Cint\u003E { i, j, k };\r\n\r\n\t\t\t\t\tfor (int m = 0; m \u003C n; m\u002B\u002B)\r\n\t\t\t\t\t{\r\n\t\t\t\t\t\tif (m == i || m == j || m == k) continue;\r\n\t\t\t\t\t\tfloat d = Vector3.Dot(normal, verts[m] - A);\r\n\t\t\t\t\t\tif (MathF.Abs(d) \u003C 0.01f)\r\n\t\t\t\t\t\t\tfaceIndices.Add(m);   // coplanar \u2014 part of this face\r\n\t\t\t\t\t\telse if (d \u003E 0f) pos = true;\r\n\t\t\t\t\t\telse neg = true;\r\n\t\t\t\t\t}\r\n\r\n\t\t\t\t\tif (pos \u0026\u0026 neg) continue;     // interior edge, not a hull face\r\n\t\t\t\t\tif (!pos \u0026\u0026 !neg) continue;   // degenerate \u2014 no non-coplanar vertices\r\n\r\n\t\t\t\t\t// Canonical key: sorted vertex indices \u2014 each face processed exactly once.\r\n\t\t\t\t\tfaceIndices.Sort();\r\n\t\t\t\t\tstring key = string.Join(\u0022,\u0022, faceIndices);\r\n\t\t\t\t\tif (!processedFaces.Add(key)) continue;\r\n\r\n\t\t\t\t\t// Collect face vertices and sort by angle around the face centroid.\r\n\t\t\t\t\tvar faceVerts = faceIndices.Select(idx =\u003E verts[idx]).ToList();\r\n\t\t\t\t\tvar fc = Vector3.Zero;\r\n\t\t\t\t\tforeach (var fv in faceVerts) fc \u002B= fv;\r\n\t\t\t\t\tfc /= faceVerts.Count;\r\n\r\n\t\t\t\t\t// Build a 2D frame in the face plane for angle sorting.\r\n\t\t\t\t\tvar outward = (Vector3.Dot(normal, centroid - A) \u003C 0f) ? normal : -normal;\r\n\t\t\t\t\tvar tan = faceVerts.Select(fv =\u003E fv - fc).FirstOrDefault(d =\u003E d.LengthSquared \u003E 1e-8f);\r\n\t\t\t\t\ttan = tan.Normal;\r\n\t\t\t\t\tvar bitan = Vector3.Cross(outward.Normal, tan);\r\n\r\n\t\t\t\t\tfaceVerts.Sort((p, q) =\u003E\r\n\t\t\t\t\t{\r\n\t\t\t\t\t\tfloat ap = MathF.Atan2(Vector3.Dot(p - fc, bitan), Vector3.Dot(p - fc, tan));\r\n\t\t\t\t\t\tfloat aq = MathF.Atan2(Vector3.Dot(q - fc, bitan), Vector3.Dot(q - fc, tan));\r\n\t\t\t\t\t\treturn ap.CompareTo(aq);\r\n\t\t\t\t\t});\r\n\r\n\t\t\t\t\t// Fan triangulate the face.\r\n\t\t\t\t\tfor (int t = 1; t \u003C faceVerts.Count - 1; t\u002B\u002B)\r\n\t\t\t\t\t{\r\n\t\t\t\t\t\tvar ta = faceVerts[0]; var tb = faceVerts[t]; var tc = faceVerts[t \u002B 1];\r\n\t\t\t\t\t\tresult.Add(ta); result.Add(tb); result.Add(tc);\r\n\t\t\t\t\t\taabbMin = Vector3.Min(aabbMin, Vector3.Min(ta, Vector3.Min(tb, tc)));\r\n\t\t\t\t\t\taabbMax = Vector3.Max(aabbMax, Vector3.Max(ta, Vector3.Max(tb, tc)));\r\n\t\t\t\t\t}\r\n\t\t\t\t}\r\n\t}\r\n\r\n\t/// \u003Csummary\u003E\r\n\t/// Fills the 4 rows of the WorldToLocal matrix (row-major, for mul(M, float4(worldPos,1)) in HLSL).\r\n\t/// \u003C/summary\u003E\r\n\t/// \u003Csummary\u003E\r\n\t/// Matches WorldTransform.PointToLocal = Rotation.Inverse * (worldPt - Position) / Scale.\r\n\t/// In s\u0026box: Forward=(1,0,0)=localX, Left=-Right=(0,1,0)=localY, Up=(0,0,1)=localZ.\r\n\t/// \u003C/summary\u003E\r\n\tpublic void GetWorldToLocalRows(out Vector4 r0, out Vector4 r1, out Vector4 r2, out Vector4 r3)\r\n\t{\r\n\t\tVector3 fwd = WorldRotation.Forward;        // world-space local X axis\r\n\t\tVector3 left = -WorldRotation.Right;          // world-space local Y axis  (Right = -Y in s\u0026box)\r\n\t\tVector3 up = WorldRotation.Up;             // world-space local Z axis\r\n\t\tVector3 pos = WorldPosition;\r\n\t\tVector3 scale = WorldScale;\r\n\r\n\t\tfloat isx = MathF.Abs(scale.x) \u003E 1e-6f ? 1f / scale.x : 0f;\r\n\t\tfloat isy = MathF.Abs(scale.y) \u003E 1e-6f ? 1f / scale.y : 0f;\r\n\t\tfloat isz = MathF.Abs(scale.z) \u003E 1e-6f ? 1f / scale.z : 0f;\r\n\r\n\t\tr0 = new Vector4(fwd.x * isx, fwd.y * isx, fwd.z * isx, -Vector3.Dot(fwd, pos) * isx);\r\n\t\tr1 = new Vector4(left.x * isy, left.y * isy, left.z * isy, -Vector3.Dot(left, pos) * isy);\r\n\t\tr2 = new Vector4(up.x * isz, up.y * isz, up.z * isz, -Vector3.Dot(up, pos) * isz);\r\n\t\tr3 = new Vector4(0f, 0f, 0f, 1f);\r\n\t}\r\n\r\n\tprotected override void DrawGizmos()\r\n\t{\r\n\t\tif (!Gizmo.IsSelected || LocalTriangles == null || LocalTriangles.Length == 0)\r\n\t\t\treturn;\r\n\r\n\t\tGizmo.Draw.Color = Color.Yellow.WithAlpha(0.5f);\r\n\t\tGizmo.Draw.LineBBox(LocalAABB);\r\n\t}\r\n}\r\n"},{"Ident":"redsnail.watertool","Path":"Water/WaterRippleEmitter.cs","FileName":"WaterRippleEmitter.cs","PackageType":"library","CodeKind":"Game","AssetVersionId":342768,"Code":"using Sandbox;\n\nnamespace RedSnail.WaterTool;\n\n/// \u003Csummary\u003E\n/// Emits water ripples when this object crosses the water surface, and optionally\n/// while it moves across it. A generic, dependency-free alternative to the entry\n/// ripple built into \u003Csee cref=\u0022Buoyancy\u0022/\u003E \u2014 drop it on anything that doesn\u0027t have\n/// a Buoyancy component (players, NPCs, projectiles, debris...).\n///\n/// Velocity is derived from the object\u0027s own position delta, so it works with any\n/// movement system (CharacterController, custom controllers, animation, etc.) and\n/// needs no Rigidbody.\n/// \u003C/summary\u003E\n[Icon(\u0022water\u0022), Group(\u0022Water\u0022), Title(\u0022Water Ripple Emitter\u0022)]\npublic sealed class WaterRippleEmitter : Component\n{\n\t[Property, Group(\u0022Entry\u0022)] public bool EmitOnEntry { get; set; } = true;\n\t[Property, Group(\u0022Entry\u0022)] public float EntryStrength { get; set; } = 0.2f;\n\t// Ring spacing for the entry splash \u2014 smaller = tighter, more concentric rings.\n\t[Property, Group(\u0022Entry\u0022), Range(20.0f, 400.0f)] public float EntryWavelength { get; set; } = 120.0f;\n\t// Ring size for the entry splash \u2014 larger = a bigger, broader ripple.\n\t[Property, Group(\u0022Entry\u0022), Range(10.0f, 500.0f)] public float EntryRingWidth { get; set; } = 50.0f;\n\t// Minimum downward speed (units/s) needed to splash. Set to 0 to ripple on any crossing.\n\t[Property, Group(\u0022Entry\u0022)] public float MinImpactSpeed { get; set; } = 40.0f;\n\n\t[Property, Group(\u0022Wake\u0022)] public bool EmitWake { get; set; } = false;\n\t[Property, Group(\u0022Wake\u0022)] public float WakeStrength { get; set; } = 0.1f;\n\t// Ring spacing for wake ripples \u2014 smaller = tighter, more concentric rings.\n\t[Property, Group(\u0022Wake\u0022), Range(20.0f, 400.0f)] public float WakeWavelength { get; set; } = 120.0f;\n\t// Ring size for wake ripples \u2014 larger = a bigger, broader ripple.\n\t[Property, Group(\u0022Wake\u0022), Range(10.0f, 500.0f)] public float WakeRingWidth { get; set; } = 50.0f;\n\t// Minimum horizontal speed (units/s) before a moving object leaves a wake.\n\t[Property, Group(\u0022Wake\u0022)] public float WakeMinSpeed { get; set; } = 1.0f;\n\t[Property, Group(\u0022Wake\u0022)] public float WakeInterval { get; set; } = 0.0333f; // 30 fps\n\n\t// Local-space offset of the point tested against the surface (e.g. the feet).\n\t[Property, Group(\u0022General\u0022)] public Vector3 SampleOffset { get; set; } = Vector3.Zero;\n\n\tprivate bool m_Initialized;\n\tprivate bool m_WasBelowSurface;\n\tprivate Vector3 m_LastPosition;\n\tprivate float m_WakeTimer;\n\n\tprivate Vector3 SamplePosition =\u003E WorldPosition \u002B WorldRotation * SampleOffset;\n\n\n\n\tprotected override void OnEnabled()\n\t{\n\t\tm_LastPosition = SamplePosition;\n\t\tm_WasBelowSurface = false;\n\t\tm_Initialized = false;\n\t}\n\n\n\n\tprotected override void OnUpdate()\n\t{\n\t\t// If this gameobject is parented to anything, we don\u0027t want to play water ripple effects\n\t\t// (e.g. A player inside a boat)\n\t\tif (GameObject.Parent != Scene)\n\t\t\treturn;\n\t\t\n\t\tVector3 samplePos = SamplePosition;\n\n\t\t// Velocity from position delta \u2014 no Rigidbody required\n\t\tVector3 velocity = Time.Delta \u003E 0.0f ? (samplePos - m_LastPosition) / Time.Delta : Vector3.Zero;\n\t\tm_LastPosition = samplePos;\n\n\t\tfloat waterHeight = WaterManager.GetWaterHeightAt(samplePos);\n\n\t\t// Not over any water surface\n\t\tif (waterHeight \u003C= float.MinValue)\n\t\t{\n\t\t\tm_WasBelowSurface = false;\n\t\t\treturn;\n\t\t}\n\n\t\tbool belowSurface = samplePos.z \u003C= waterHeight;\n\n\t\t// Skip the first valid frame so an object spawned already in water doesn\u0027t splash\n\t\tif (!m_Initialized)\n\t\t{\n\t\t\tm_WasBelowSurface = belowSurface;\n\t\t\tm_Initialized = true;\n\t\t\treturn;\n\t\t}\n\n\t\t// Entry splash on the above -\u003E below surface crossing\n\t\tif (EmitOnEntry \u0026\u0026 belowSurface \u0026\u0026 !m_WasBelowSurface)\n\t\t{\n\t\t\tfloat impactSpeed = float.Max(0.0f, -velocity.z);\n\n\t\t\tif (impactSpeed \u003E= MinImpactSpeed)\n\t\t\t{\n\t\t\t\tfloat strength = (impactSpeed / 150.0f).Clamp(0.3f, 2.5f) * EntryStrength;\n\t\t\t\t\n\t\t\t\tWaterManager.AddRipple(samplePos.WithZ(waterHeight), strength, EntryWavelength, EntryRingWidth);\n\t\t\t}\n\t\t}\n\n\t\tm_WasBelowSurface = belowSurface;\n\n\t\tfloat horizontalSpeed = velocity.WithZ(0.0f).Length;\n\t\t\n\t\t// Continuous wake while skimming/swimming through the surface\n\t\tif (EmitWake \u0026\u0026 belowSurface)\n\t\t{\n\t\t\tif (horizontalSpeed \u003E= WakeMinSpeed)\n\t\t\t{\n\t\t\t\tm_WakeTimer -= Time.Delta;\n\n\t\t\t\tif (m_WakeTimer \u003C= 0.0f)\n\t\t\t\t{\n\t\t\t\t\tWaterManager.AddRipple(samplePos.WithZ(waterHeight), WakeStrength, WakeWavelength, WakeRingWidth);\n\t\t\t\t\tm_WakeTimer = WakeInterval;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n}\n"},{"Ident":"redsnail.watertool","Path":"Editor/WaterFlowTool.cs","FileName":"WaterFlowTool.cs","PackageType":"library","CodeKind":"Editor","AssetVersionId":342768,"Code":"using Sandbox;\nusing Editor;\n\nnamespace RedSnail.WaterTool.Editor;\n\n/// \u003Csummary\u003E\n/// Scene editor tool for the WaterFlow component. Activates when a WaterFlow is\n/// selected and hosts the spline editor: select points, drag them and their In/Out\n/// tangent handles (for curved rivers), click on the river to insert a point, and\n/// shift-drag a point to extrude a new one. All edits are undo-aware and rebuild\n/// the river mesh live.\n/// \u003C/summary\u003E\n[Title(\u0022Water Flow\u0022)]\n[Icon(\u0022waves\u0022)]\n[Alias(\u0022water_flow\u0022)]\n[Group(\u00221\u0022)]\n[Order(1)]\npublic class WaterFlowTool : EditorTool\u003CWaterFlow\u003E\n{\n\tprivate WaterFlowWindow m_Window;\n\tprivate WaterFlow m_Selected;\n\n\n\n\tpublic override void OnEnabled()\n\t{\n\t\tm_Window = new WaterFlowWindow();\n\n\t\tAddOverlay(m_Window, TextFlag.RightBottom, 10);\n\n\t\tOnSelectionChanged();\n\t}\n\n\n\n\tpublic override void OnDisabled()\n\t{\n\t\tm_Window?.OnDisabled();\n\t}\n\n\n\n\tpublic override void OnUpdate()\n\t{\n\t\tm_Window?.OnUpdate();\n\t}\n\n\n\n\tpublic override void OnSelectionChanged()\n\t{\n\t\tWaterFlow target = GetSelectedComponent\u003CWaterFlow\u003E();\n\n\t\tif (!target.IsValid())\n\t\t\treturn;\n\n\t\t// Only re-target when the component itself changes \u2014 otherwise this fires on\n\t\t// every property edit and would reset the selected point each time.\n\t\tif (target != m_Selected)\n\t\t{\n\t\t\tm_Window?.OnSelectionChanged(target);\n\n\t\t\tm_Selected = target;\n\t\t}\n\t}\n}\n"},{"Ident":"redsnail.watertool","Path":"Editor/WaterFlowWindow.UI.cs","FileName":"WaterFlowWindow.UI.cs","PackageType":"library","CodeKind":"Editor","AssetVersionId":342768,"Code":"using Sandbox;\nusing Editor;\n\nnamespace RedSnail.WaterTool.Editor;\n\npublic partial class WaterFlowWindow\n{\n\tprivate const int HEADER_HEIGHT = 32;\n\n\n\n\tprivate void Rebuild()\n\t{\n\t\tLayout.Clear(true);\n\t\tLayout.Margin = 0;\n\n\t\tIcon = _isClosed ? \u0022\u0022 : \u0022waves\u0022;\n\t\tUpdateWindowTitle();\n\t\tIsGrabbable = !_isClosed;\n\n\t\tif (_isClosed)\n\t\t{\n\t\t\tBuildClosedState();\n\t\t\treturn;\n\t\t}\n\n\t\tMinimumWidth = 360;\n\t\tBuildHeader();\n\n\t\tif (_targetComponent.IsValid())\n\t\t\tBuildControlSheet();\n\n\t\tLayout.Margin = 4;\n\t}\n\n\n\n\tprivate void BuildClosedState()\n\t{\n\t\tvar closedRow = Layout.AddRow();\n\n\t\tclosedRow.Add(new IconButton(\u0022waves\u0022, () =\u003E { _isClosed = false; Rebuild(); })\n\t\t{\n\t\t\tToolTip = \u0022Open Water Flow Spline Editor\u0022,\n\t\t\tFixedHeight = HEADER_HEIGHT,\n\t\t\tFixedWidth = HEADER_HEIGHT,\n\t\t\tBackground = Color.Transparent\n\t\t});\n\n\t\tMinimumWidth = 0;\n\t}\n\n\n\n\tprivate void BuildHeader()\n\t{\n\t\tvar headerRow = Layout.AddRow();\n\n\t\theaderRow.AddStretchCell();\n\n\t\theaderRow.Add(new IconButton(\u0022info\u0022)\n\t\t{\n\t\t\tToolTip = GetInfoTooltip(),\n\t\t\tFixedHeight = HEADER_HEIGHT,\n\t\t\tFixedWidth = HEADER_HEIGHT,\n\t\t\tBackground = Color.Transparent\n\t\t});\n\n\t\theaderRow.Add(new IconButton(\u0022close\u0022, CloseWindow)\n\t\t{\n\t\t\tToolTip = \u0022Close Editor\u0022,\n\t\t\tFixedHeight = HEADER_HEIGHT,\n\t\t\tFixedWidth = HEADER_HEIGHT,\n\t\t\tBackground = Color.Transparent\n\t\t});\n\t}\n\n\n\n\tprivate string GetInfoTooltip()\n\t{\n\t\treturn \u0022Edit the river\u0027s spline.\\n\\n\u0022 \u002B\n\t\t\t   \u0022\u2022 Click a point to select it, then drag it or its In/Out tangent handles.\\n\u0022 \u002B\n\t\t\t   \u0022\u2022 Tangent Mode controls the curve: Auto smooths, Linear makes sharp corners,\\n\u0022 \u002B\n\t\t\t   \u0022  Mirrored/Split let you shape the bend by hand.\\n\u0022 \u002B\n\t\t\t   \u0022\u2022 Click anywhere on the river to insert a point there.\\n\u0022 \u002B\n\t\t\t   \u0022\u2022 Hold Shift while dragging a point to drag out a new one.\\n\\n\u0022 \u002B\n\t\t\t   \u0022The source point is green, the mouth is red.\u0022;\n\t}\n\n\n\n\tprivate void BuildControlSheet()\n\t{\n\t\tvar serialized = this.GetSerialized();\n\t\tvar controlSheet = new ControlSheet();\n\n\t\tcontrolSheet.AddRow(serialized.GetProperty(nameof(_selectedPointTangentMode)));\n\t\t_positionControl = controlSheet.AddRow(serialized.GetProperty(nameof(_selectedPointPosition)));\n\t\t_inTangentControl = controlSheet.AddRow(serialized.GetProperty(nameof(_selectedPointIn)));\n\t\t_outTangentControl = controlSheet.AddRow(serialized.GetProperty(nameof(_selectedPointOut)));\n\n\t\tcontrolSheet.AddLayout(BuildControlButtons());\n\n\t\tLayout.Add(controlSheet);\n\n\t\tToggleTangentInput();\n\t}\n\n\n\n\tprivate Layout BuildControlButtons()\n\t{\n\t\tvar row = Layout.Row();\n\t\trow.Spacing = 16;\n\t\trow.Margin = 8;\n\n\t\trow.Add(CreateNavigationButton(\u0022skip_previous\u0022, -1, \u0022Go to previous point\u0022));\n\t\trow.Add(CreateNavigationButton(\u0022skip_next\u0022, 1, \u0022Go to next point\u0022));\n\t\trow.Add(CreateDeleteButton());\n\t\trow.Add(CreateAddButton());\n\n\t\treturn row;\n\t}\n\n\n\n\tprivate IconButton CreateNavigationButton(string _Icon, int _Direction, string _Tooltip)\n\t{\n\t\treturn new IconButton(_Icon, () =\u003E\n\t\t{\n\t\t\tif (_Direction \u003C 0)\n\t\t\t\tSelectedPointIndex = int.Max(0, SelectedPointIndex - 1);\n\t\t\telse\n\t\t\t\tSelectedPointIndex = int.Min(_targetComponent.Spline.PointCount - 1, SelectedPointIndex \u002B 1);\n\n\t\t\tSelectPoint(SelectedPointIndex);\n\t\t\tFocus();\n\t\t})\n\t\t{ ToolTip = _Tooltip };\n\t}\n\n\n\n\tprivate IconButton CreateDeleteButton()\n\t{\n\t\treturn new IconButton(\u0022delete\u0022, () =\u003E\n\t\t{\n\t\t\t// The source point can\u0027t be deleted, and rivers need at least two points\n\t\t\tif (IsSourcePointSelected || _targetComponent.Spline.PointCount \u003C= 2)\n\t\t\t\treturn;\n\n\t\t\tusing (CreateUndoScope(\u0022Delete Water Flow Point\u0022))\n\t\t\t{\n\t\t\t\t_targetComponent.Spline.RemovePoint(SelectedPointIndex);\n\t\t\t\tSelectedPointIndex = int.Max(0, SelectedPointIndex - 1);\n\t\t\t}\n\n\t\t\tUpdateWindowTitle();\n\t\t\tFocus();\n\t\t})\n\t\t{ ToolTip = \u0022Delete the selected point (the source point is locked; minimum 2 points)\u0022 };\n\t}\n\n\n\n\tprivate IconButton CreateAddButton()\n\t{\n\t\treturn new IconButton(\u0022add\u0022, () =\u003E\n\t\t{\n\t\t\tusing (CreateUndoScope(\u0022Add Water Flow Point\u0022))\n\t\t\t{\n\t\t\t\tInsertNewPoint();\n\t\t\t\tSelectedPointIndex\u002B\u002B;\n\t\t\t}\n\n\t\t\tUpdateWindowTitle();\n\t\t\tFocus();\n\t\t})\n\t\t{\n\t\t\tToolTip = \u0022Insert a point after the selected one.\\n\u0022 \u002B\n\t\t\t\t\t  \u0022You can also click on the river, or Shift-drag a point.\u0022\n\t\t};\n\t}\n\n\n\n\tprivate void InsertNewPoint()\n\t{\n\t\tvar spline = _targetComponent.Spline;\n\n\t\tif (SelectedPointIndex == spline.PointCount - 1)\n\t\t{\n\t\t\t// Extend past the mouth, following the spline tangent\n\t\t\tfloat distance = spline.GetDistanceAtPoint(SelectedPointIndex);\n\t\t\tVector3 tangent = spline.SampleAtDistance(distance).Tangent;\n\t\t\tVector3 newPosition = _selectedPoint.Position \u002B tangent * 256.0f;\n\n\t\t\tspline.InsertPoint(SelectedPointIndex \u002B 1, _selectedPoint with { Position = newPosition });\n\t\t}\n\t\telse\n\t\t{\n\t\t\t// Split the segment toward the next point\n\t\t\tfloat currentDist = spline.GetDistanceAtPoint(SelectedPointIndex);\n\t\t\tfloat nextDist = spline.GetDistanceAtPoint(SelectedPointIndex \u002B 1);\n\n\t\t\tspline.AddPointAtDistance((currentDist \u002B nextDist) / 2.0f, true);\n\t\t}\n\t}\n\n\n\n\tprivate void UpdateWindowTitle()\n\t{\n\t\tWindowTitle = _isClosed\n\t\t\t? \u0022\u0022\n\t\t\t: $\u0022Water Flow \u2014 Point [{SelectedPointIndex}] \u2014 {_targetComponent?.GameObject?.Name ?? \u0022\u0022}\u0022;\n\t}\n\n\n\n\tprivate void CloseWindow()\n\t{\n\t\t_isClosed = true;\n\t\tRebuild();\n\t\tPosition = Parent.Size - 32;\n\t}\n}\n"},{"Ident":"redsnail.watertool","Path":"Code/Miscellaneous/BoatController.cs","FileName":"BoatController.cs","PackageType":"library","CodeKind":"Game","AssetVersionId":342768,"Code":"using System;\nusing Sandbox;\nusing Sandbox.Movement;\n\nnamespace RedSnail.WaterTool;\n\n/// \u003Csummary\u003E\n/// Minimal demo boat controller.\n/// \u003C/summary\u003E\n[Title( \u0022Demo Boat Controller\u0022 ), Group( \u0022Water\u0022 ), Icon( \u0022directions_boat\u0022 )]\npublic sealed class BoatController : Component, Component.IPressable, ISitTarget\n{\n\tprivate TimeSince m_TimeSinceLastUnderWave;\n\tprivate float m_LastHitTimer = 1.0f;\n\t\n\t[Property, Group( \u0022Seat\u0022 )] public GameObject SeatPosition { get; set; }\n\t[Property, Group( \u0022Seat\u0022 )] public GameObject EyePosition  { get; set; }\n\t[Property, Group( \u0022Seat\u0022 )] public GameObject ExitPoint    { get; set; }\n\n\t[Property, Group( \u0022Movement\u0022 )] public float ThrustForce   { get; set; } = 200_000f;\n\t[Property, Group( \u0022Movement\u0022 )] public float ReverseForce  { get; set; } = 80_000f;\n\t[Property, Group( \u0022Movement\u0022 )] public float TurnForce     { get; set; } = 60_000f;\n\t[Property, Group( \u0022Movement\u0022 )] public float Stability     { get; set; } = 50_000f;\n\t[Property, Group( \u0022Movement\u0022 )] public float TerminalSpeed { get; set; } = 800f;\n\n\t[Property, Group( \u0022Interaction\u0022 )] public string TooltipTitle { get; set; } = \u0022Drive\u0022;\n\t[Property, Group( \u0022Interaction\u0022 )] public string TooltipIcon  { get; set; } = \u0022directions_boat\u0022;\n\n\t[Property, Group( \u0022Sounds\u0022 )] public SoundEvent BoatUnderWaves  { get; set; }\n\t[Property, Group( \u0022Sounds\u0022 )] public SoundPointComponent BoatOnWaterLoop  { get; set; }\n\n\tprivate Rigidbody m_Rigidbody;\n\tprivate Buoyancy m_Buoyancy;\n\n\tprivate float m_TargetThrust;\n\tprivate float m_TargetTurn;\n\n\tpublic bool IsOccupied =\u003E GetComponentInChildren\u003CPlayerController\u003E( false ) != null;\n\n\n\n\tprotected override void OnStart()\n\t{\n\t\tm_Rigidbody = GetComponent\u003CRigidbody\u003E();\n\t\tm_Buoyancy = GetComponent\u003CBuoyancy\u003E();\n\t}\n\n\n\n\tprotected override void OnFixedUpdate()\n\t{\n\t\tif ( !m_Rigidbody.IsValid() )\n\t\t\treturn;\n\n\t\tHandleSounds();\n\t\tStabilize();\n\n\t\tif ( IsOccupied )\n\t\t\tHandleMovement();\n\t\telse\n\t\t{\n\t\t\t// Smoothly reset forces when unmanned\n\t\t\tm_TargetThrust = 0f;\n\t\t\tm_TargetTurn   = 0f;\n\t\t}\n\t}\n\t\n\t\n\t\n\tpublic bool CanPress( IPressable.Event e )\n\t{\n\t\treturn e.Source is PlayerController \u0026\u0026 !IsOccupied;\n\t}\n\n\tpublic bool Press( IPressable.Event e )\n\t{\n\t\tif ( e.Source is not PlayerController player ) return false;\n\t\tif ( IsOccupied ) return false;\n\n\t\tMountPlayer( player );\n\t\treturn true;\n\t}\n\n\tpublic IPressable.Tooltip? GetTooltip( IPressable.Event e )\n\t{\n\t\tif ( IsOccupied ) return null;\n\t\t\n\t\tvar tooltip = new IPressable.Tooltip\n\t\t{\n\t\t\tTitle = TooltipTitle,\n\t\t\tIcon = TooltipIcon\n\t\t};\n\n\t\treturn tooltip;\n\t}\n\t\n\t\n\t\n\tpublic void AskToLeave( PlayerController player )\n\t{\n\t\tDismountPlayer( player );\n\t}\n\n\tpublic void UpdatePlayerAnimator( PlayerController controller, SkinnedModelRenderer renderer )\n\t{\n\t\tcontroller.LocalTransform = global::Transform.Zero;\n\t\trenderer.LocalRotation   = Rotation.Identity;\n\t\trenderer.Set( \u0022sit\u0022,        (int)BaseChair.AnimatorSitPose.ChairForward );\n\t\trenderer.Set( \u0022b_grounded\u0022, true );\n\t\trenderer.Set( \u0022b_climbing\u0022, false );\n\t\trenderer.Set( \u0022b_swim\u0022,     false );\n\t\trenderer.Set( \u0022duck\u0022,       false );\n\t}\n\n\tpublic Transform CalculateEyeTransform( PlayerController controller )\n\t{\n\t\tvar anchor = EyePosition ?? SeatPosition ?? GameObject;\n\n\t\t// Position follows the seat anchor so the camera rides with the boat.\n\t\t// Rotation uses the player\u0027s eye angles in pure world space, the boat\u0027s\n\t\t// pitch and roll are intentionally NOT applied so the view stays level\n\t\t// even when the hull bobs or banks.\n\t\treturn new Transform\n\t\t{\n\t\t\tPosition = anchor.WorldPosition,\n\t\t\tRotation = controller.EyeAngles.ToRotation()\n\t\t};\n\t}\n\t\n\t\n\t\n\tprivate void MountPlayer( PlayerController player )\n\t{\n\t\tvar seat = SeatPosition ?? GameObject;\n\n\t\t// Disable the player\u0027s own physics so they don\u0027t fight the boat\n\t\tif ( player.Body.IsValid() )          player.Body.Enabled = false;\n\t\tif ( player.ColliderObject.IsValid() ) player.ColliderObject.Enabled = false;\n\t\t\n\t\tplayer.GameObject.SetParent( seat, false );\n\t\tplayer.GameObject.LocalTransform = global::Transform.Zero;\n\t}\n\n\tprivate void DismountPlayer( PlayerController player )\n\t{\n\t\tplayer.GameObject.SetParent( null, true );\n\t\t\n\t\tif ( player.Body.IsValid() )          player.Body.Enabled = true;\n\t\tif ( player.ColliderObject.IsValid() ) player.ColliderObject.Enabled = true;\n\t\t\n\t\t// Move to exit point, or eject to the side if none is set\n\t\tplayer.WorldPosition = ExitPoint != null\n\t\t\t? ExitPoint.WorldPosition\n\t\t\t: WorldPosition \u002B WorldRotation.Right * 100f \u002B Vector3.Up * 30f;\n\n\t\tm_TargetThrust = 0f;\n\t\tm_TargetTurn   = 0f;\n\t}\n\t\n\t\n\t\n\tprivate void HandleMovement()\n\t{\n\t\t// Only push when the hull is actually in the water\n\t\tif ( m_Buoyancy is { IsTouchingWater: false } )\n\t\t\treturn;\n\n\t\tfloat fwd  = Input.AnalogMove.x; // W = \u002B1  S = -1\n\t\tfloat side = Input.AnalogMove.y; // D = \u002B1  A = -1\n\t\t\n\t\t// Thrust\n\t\tfloat wantedThrust = fwd \u003E 0.02f  ?  ThrustForce * fwd\n\t\t                   : fwd \u003C -0.02f ? ReverseForce * fwd\n\t\t                   : 0f;\n\n\t\tm_TargetThrust = float.Lerp( m_TargetThrust, wantedThrust, Time.Delta * 3f );\n\n\t\tfloat speed   = m_Rigidbody.Velocity.WithZ( 0 ).Length;\n\t\tfloat limiter = MathF.Min( 1f, TerminalSpeed / ( speed \u002B 0.001f ) );\n\n\t\tm_Rigidbody.ApplyForce( WorldRotation.Right * m_TargetThrust * limiter );\n\n\t\t// Turning\n\t\tfloat speedFactor = float.Clamp( speed / 200f, 0.2f, 1f );\n\t\tfloat wantedTurn  = side * TurnForce * speedFactor;\n\t\tm_TargetTurn       = float.Lerp( m_TargetTurn, wantedTurn, Time.Delta * 5f );\n\n\t\tVector3 bow = WorldPosition \u002B WorldRotation.Forward * 60f;\n\t\tm_Rigidbody.ApplyForceAt( bow, WorldRotation.Left * m_TargetTurn );\n\n\t\t// Speed dependent damping so the boat decelerates naturally\n\t\tfloat damping = ( TerminalSpeed / ( speed \u002B 0.001f ) ) * 0.5f;\n\t\tm_Rigidbody.LinearDamping = float.Clamp( damping, 0.5f, 5f );\n\t}\n\t\n\t\n\t\n\tprivate void HandleSounds()\n\t{\n\t\tif (Scene.Camera is not CameraComponent camera)\n\t\t\treturn;\n\n\t\tHandleWavesSound(camera);\n\t\tHandleMovementSound(camera);\n\t}\n\t\n\t\n\t\n\tprivate void HandleWavesSound(CameraComponent _Camera)\n\t{\n\t\tif (!BoatUnderWaves.IsValid())\n\t\t\treturn;\n\t\t\n\t\tfloat distance = _Camera.WorldPosition.DistanceSquared(WorldPosition);\n\t\tfloat MaxDistanceSq = BoatUnderWaves.Distance * BoatUnderWaves.Distance;\n\n\t\tfloat speed = m_Rigidbody.Velocity.WithZ(0).Length;\n\t\t\n\t\tif (speed \u003C 10.0f \u0026\u0026 distance \u003C MaxDistanceSq \u0026\u0026 m_Buoyancy.IsTouchingWater \u0026\u0026 m_TimeSinceLastUnderWave \u003E m_LastHitTimer)\n\t\t{\n\t\t\tSound.Play(BoatUnderWaves, WorldPosition);\n\n\t\t\tm_TimeSinceLastUnderWave = 0;\n\t\t\tm_LastHitTimer = Game.Random.Float(2.0f, 10.0f);\n\t\t}\n\t}\n\t\n\t\n\t\n\tprivate void HandleMovementSound(CameraComponent _Camera)\n\t{\n\t\tif (!BoatOnWaterLoop.IsValid())\n\t\t\treturn;\n\t\t\n\t\tfloat distance = _Camera.WorldPosition.DistanceSquared(WorldPosition);\n\t\tfloat MaxDistanceSq = BoatOnWaterLoop.Distance * BoatOnWaterLoop.Distance;\n\t\t\n\t\tif (distance \u003E MaxDistanceSq)\n\t\t{\n\t\t\t// Disable the sound point if too far away from the camera (Avoid wasting resources)\n\t\t\tBoatOnWaterLoop.Enabled = false;\n\t\t}\n\t\telse\n\t\t{\n\t\t\tBoatOnWaterLoop.SoundOverride = true;\n\t\t\tBoatOnWaterLoop.Volume = m_Rigidbody.Velocity.WithZ(0).Length.Remap(0.0f, 200.0f);\n\t\t\tBoatOnWaterLoop.Enabled = true;\n\t\t}\n\t}\n\t\n\t\n\t\n\tprivate void Stabilize()\n\t{\n\t\tVector3 torque = Vector3.Cross( WorldRotation.Up, Vector3.Up ) * Stability;\n\t\tm_Rigidbody.ApplyTorque( torque );\n\t}\n}\n"},{"Ident":"redsnail.watertool","Path":"Code/Water/WaterBody.cs","FileName":"WaterBody.cs","PackageType":"library","CodeKind":"Game","AssetVersionId":342768,"Code":"using System;\r\nusing Sandbox;\r\nusing Sandbox.Volumes;\r\n\r\nnamespace RedSnail.WaterTool;\r\n\r\n/// \u003Csummary\u003E\r\n/// Defines a discrete body of water that participates in a renderer-driven water system.\r\n/// Provides volume bounds, a physics hull for buoyancy/swimming, and renderer inclusion in one component.\r\n/// Requires a WaterQuadRenderer present in the scene to produce a visible water surface.\r\n/// \u003C/summary\u003E\r\n[Title(\u0022Water Body\u0022)]\r\n[Category(\u0022Water\u0022)]\r\n[Icon(\u0022water_drop\u0022)]\r\npublic sealed class WaterBody : VolumeComponent, Component.ExecuteInEditor\r\n{\r\n\tprivate HullCollider m_HullCollider;\r\n\tprivate BBox m_LastLocalBounds;\r\n\r\n\t[Property, Group(\u0022General\u0022)] public WaterBodyType WaterType { get; set; } = WaterBodyType.Ocean;\r\n\r\n\tprotected override void OnEnabled()\r\n\t{\r\n\t\tWaterManager.Current?.RefreshWaterBodiesList();\r\n\r\n\t\tUpdateColliderState();\r\n\r\n\t\tm_LastLocalBounds = SceneVolume.GetBounds();\r\n\t}\r\n\r\n\tprotected override void OnDisabled()\r\n\t{\r\n\t\tWaterManager.Current?.RefreshWaterBodiesList();\r\n\r\n\t\tm_HullCollider?.Destroy();\r\n\t\tm_HullCollider = null;\r\n\t}\r\n\r\n\tprotected override void OnUpdate()\r\n\t{\r\n\t\tBBox localBounds = SceneVolume.GetBounds();\r\n\r\n\t\tif (localBounds != m_LastLocalBounds)\r\n\t\t{\r\n\t\t\tUpdateColliderState();\r\n\r\n\t\t\tm_LastLocalBounds = localBounds;\r\n\t\t}\r\n\t}\r\n\r\n\tprotected override void DrawGizmos()\r\n\t{\r\n\t\tif (!Gizmo.IsSelected || !m_HullCollider.IsValid())\r\n\t\t\treturn;\r\n\r\n\t\tGizmo.Draw.Color = Color.Cyan;\r\n\t\tGizmo.Draw.LineBBox(m_HullCollider.LocalBounds);\r\n\t}\r\n\r\n\t// Bounds\r\n\tpublic void SetBounds(BBox bounds)\r\n\t{\r\n\t\tSceneVolume = SceneVolume with { Box = bounds };\r\n\t}\r\n\r\n\tpublic float GetSurfaceHeight()\r\n\t{\r\n\t\tBBox local = SceneVolume.GetBounds();\r\n\r\n\t\treturn WorldTransform.PointToWorld(new Vector3(local.Center.x, local.Center.y, local.Maxs.z)).z;\r\n\t}\r\n\r\n\tpublic float GetBottomHeight()\r\n\t{\r\n\t\tBBox local = SceneVolume.GetBounds();\r\n\r\n\t\treturn WorldTransform.PointToWorld(new Vector3(local.Center.x, local.Center.y, local.Mins.z)).z;\r\n\t}\r\n\r\n\tpublic bool ContainsPointXY(Vector3 worldPosition)\r\n\t{\r\n\t\tBBox local = SceneVolume.GetBounds();\r\n\t\tVector3 point = WorldTransform.PointToLocal(worldPosition);\r\n\t\tVector3 half = local.Size * 0.5f;\r\n\r\n\t\treturn MathF.Abs(point.x - local.Center.x) \u003C= half.x \u0026\u0026 MathF.Abs(point.y - local.Center.y) \u003C= half.y;\r\n\t}\r\n\r\n\tpublic bool ContainsPointInVolume(Vector3 worldPosition)\r\n\t{\r\n\t\tBBox local = SceneVolume.GetBounds();\r\n\r\n\t\tVector3 point = WorldTransform.PointToLocal(worldPosition);\r\n\t\tVector3 half = local.Size * 0.5f;\r\n\r\n\t\treturn MathF.Abs(point.x - local.Center.x) \u003C= half.x \u0026\u0026\r\n\t\t\t   MathF.Abs(point.y - local.Center.y) \u003C= half.y \u0026\u0026\r\n\t\t\t   MathF.Abs(point.z - local.Center.z) \u003C= half.z;\r\n\t}\r\n\r\n\tpublic (Vector3 Center, Vector3 Forward, Vector3 Up, Vector3 HalfExtents) GetWorldOBB()\r\n\t{\r\n\t\tBBox local = SceneVolume.GetBounds();\r\n\r\n\t\treturn (WorldTransform.PointToWorld(local.Center), WorldRotation.Forward, WorldTransform.Up, local.Size * 0.5f);\r\n\t}\r\n\r\n\t// Wave queries\r\n\tpublic Vector3 GetWaveDisplacementAt(Vector3 _WorldPosition)\r\n\t{\r\n\t\tWaterDefinition profile = WaterManager.GetWaveProfile(WaterType);\r\n\r\n\t\treturn profile.IsValid() ? WaterWaveUtility.ComputeDisplacementAt(_WorldPosition, profile) : Vector3.Zero;\r\n\t}\r\n\r\n\tpublic Vector3 GetWaveVelocityAt(Vector3 _WorldPosition)\r\n\t{\r\n\t\tWaterDefinition profile = WaterManager.GetWaveProfile(WaterType);\r\n\r\n\t\treturn profile.IsValid() ? WaterWaveUtility.ComputeVelocityAt(_WorldPosition, profile) : Vector3.Zero;\r\n\t}\r\n\r\n\tpublic float GetWaveHeightAt(Vector3 _WorldPosition) =\u003E GetSurfaceHeight() \u002B GetWaveDisplacementAt(_WorldPosition).z;\r\n\r\n\tinternal float GetVerticalDistanceToSurface(Vector3 _WorldPosition) =\u003E MathF.Abs(_WorldPosition.z - GetSurfaceHeight());\r\n\r\n\tprivate void UpdateColliderState()\r\n\t{\r\n\t\tBBox local = SceneVolume.GetBounds();\r\n\r\n\t\tm_HullCollider = GetOrAddComponent\u003CHullCollider\u003E();\r\n\t\tm_HullCollider.Flags |= ComponentFlags.Hidden;\r\n\t\tm_HullCollider.Static = true;\r\n\t\tm_HullCollider.Type = HullCollider.PrimitiveType.Box;\r\n\t\tm_HullCollider.Center = local.Center;\r\n\t\tm_HullCollider.BoxSize = local.Size;\r\n\t\tm_HullCollider.IsTrigger = true;\r\n\r\n\t\tTags.Add(\u0022water\u0022);\r\n\t}\r\n}\r\n"},{"Ident":"redsnail.watertool","Path":"PostProcessing/SimpleFog.cs","FileName":"SimpleFog.cs","PackageType":"library","CodeKind":"Game","AssetVersionId":342768,"Code":"using Sandbox;\r\nusing Sandbox.Rendering;\r\n\r\nnamespace RedSnail.WaterTool;\r\n\r\n[Title(\u0022Simple Fog\u0022)]\r\n[Category(\u0022Post Processing\u0022)]\r\n[Icon(\u0022foggy\u0022)]\r\npublic sealed class SimpleFog : BasePostProcess\u003CSimpleFog\u003E\r\n{\r\n\t[Property] private Color Color { get; set; } = Color.White;\r\n\t[Property, Range(0, 1)] private float Intensity { get; set; } = 0.01f;\r\n\t[Property, Range(0, 1)] private float Opacity { get; set; } = 0.5f;\r\n\r\n\r\n\r\n\tpublic override void Render()\r\n\t{\r\n\t\tfloat opacity = GetWeighted(x =\u003E x.Opacity);\r\n\r\n\t\tif (opacity.AlmostEqual(0.0f))\r\n\t\t\treturn;\r\n\r\n\t\tAttributes.Set(\u0022Color\u0022, GetWeighted(x =\u003E x.Color));\r\n\t\tAttributes.Set(\u0022Intensity\u0022, GetWeighted(x =\u003E x.Intensity));\r\n\t\tAttributes.Set(\u0022Opacity\u0022, opacity);\r\n\r\n\t\tMaterial shader = Material.FromShader(\u0022pp_simplefog\u0022);\r\n\t\tBlitMode blit = BlitMode.WithBackbuffer(shader, Stage.BeforePostProcess, 60);\r\n\t\tBlit(blit, \u0022Simple Fog\u0022);\r\n\t}\r\n}\r\n"},{"Ident":"redsnail.watertool","Path":"Water/WaterDefinition.cs","FileName":"WaterDefinition.cs","PackageType":"library","CodeKind":"Game","AssetVersionId":342768,"Code":"using Sandbox;\r\n\r\nnamespace RedSnail.WaterTool;\r\n\r\n[AssetType(Name = \u0022Water Definition\u0022, Extension = \u0022wtdef\u0022, Category = \u0022Water\u0022)]\r\npublic sealed class WaterDefinition : GameResource\r\n{\r\n\t[Property, Group(\u0022Detail\u0022)] public float WavesIntensity { get; set; } = 4.0f;\r\n\t[Property, Group(\u0022Detail\u0022), Range(0, 5)] public float WavesSpeed { get; set; } = 0.3f;\r\n\t[Property, Group(\u0022Detail\u0022)] public float WavesScale { get; set; } = 0.05f;\r\n\t[Property, Group(\u0022Detail\u0022)] public Vector2 WavesDirection { get; set; } = new Vector2(1, 0.5f);\r\n\t[Property, Group(\u0022Detail\u0022), Range(1, 5)] public int WavesOctaves { get; set; } = 3;\r\n\t[Property, Group(\u0022Detail\u0022)] public float WavesLacunarity { get; set; } = 2.0f;\r\n\t[Property, Group(\u0022Detail\u0022), Range(0, 1)] public float WavesPersistence { get; set; } = 0.5f;\r\n\t[Property, Group(\u0022Detail\u0022), Range(0, 1)] public float WavesSteepness { get; set; } = 0.5f;\r\n\r\n\t[Property, Group(\u0022Swell\u0022)] public float SwellIntensity { get; set; } = 15.0f;\r\n\t[Property, Group(\u0022Swell\u0022), Range(0, 500)] public float SwellSpeed { get; set; } = 100.0f;\r\n\t[Property, Group(\u0022Swell\u0022)] public float SwellScale { get; set; } = 0.002f;\r\n\t[Property, Group(\u0022Swell\u0022)] public Vector2 SwellDirection { get; set; } = new Vector2(0.7f, 0.3f);\r\n\t[Property, Group(\u0022Swell\u0022), Range(1, 4)] public int SwellOctaves { get; set; } = 2;\r\n\t[Property, Group(\u0022Swell\u0022)] public float SwellLacunarity { get; set; } = 1.8f;\r\n\t[Property, Group(\u0022Swell\u0022), Range(0, 1)] public float SwellPersistence { get; set; } = 0.6f;\r\n\t[Property, Group(\u0022Swell\u0022), Range(0, 1)] public float SwellSteepness { get; set; } = 0.3f;\r\n\r\n\tpublic void ApplyTo(RenderAttributes attributes)\r\n\t{\r\n\t\tattributes.Set(\u0022WavesIntensity\u0022, WavesIntensity);\r\n\t\tattributes.Set(\u0022WavesSpeed\u0022, WavesSpeed);\r\n\t\tattributes.Set(\u0022WavesScale\u0022, WavesScale);\r\n\t\tattributes.Set(\u0022WavesDirection\u0022, WavesDirection);\r\n\t\tattributes.Set(\u0022WavesOctaves\u0022, WavesOctaves);\r\n\t\tattributes.Set(\u0022WavesLacunarity\u0022, WavesLacunarity);\r\n\t\tattributes.Set(\u0022WavesPersistence\u0022, WavesPersistence);\r\n\t\tattributes.Set(\u0022WavesSteepness\u0022, WavesSteepness);\r\n\r\n\t\tattributes.Set(\u0022SwellIntensity\u0022, SwellIntensity);\r\n\t\tattributes.Set(\u0022SwellSpeed\u0022, SwellSpeed);\r\n\t\tattributes.Set(\u0022SwellScale\u0022, SwellScale);\r\n\t\tattributes.Set(\u0022SwellDirection\u0022, SwellDirection);\r\n\t\tattributes.Set(\u0022SwellOctaves\u0022, SwellOctaves);\r\n\t\tattributes.Set(\u0022SwellLacunarity\u0022, SwellLacunarity);\r\n\t\tattributes.Set(\u0022SwellPersistence\u0022, SwellPersistence);\r\n\t\tattributes.Set(\u0022SwellSteepness\u0022, SwellSteepness);\r\n\t}\r\n\r\n\tprotected override Bitmap CreateAssetTypeIcon(int _Width, int _Height)\r\n\t{\r\n\t\treturn CreateSimpleAssetTypeIcon(\u0022water\u0022, _Width, _Height, \u0022#4287f5\u0022, \u0022white\u0022);\r\n\t}\r\n}\r\n"},{"Ident":"redsnail.watertool","Path":"Water/WaterExclusionVolume.cs","FileName":"WaterExclusionVolume.cs","PackageType":"library","CodeKind":"Game","AssetVersionId":342768,"Code":"using Sandbox;\r\nusing Sandbox.Volumes;\r\n\r\nnamespace RedSnail.WaterTool;\r\n\r\n/// \u003Csummary\u003E\r\n/// Suppresses water surface rendering inside a volume. Has no effect on the physical water hull\r\n/// so buoyancy and swimming still work within the excluded area.\r\n/// Intended for enclosed spaces that sit in water, such as the interior of a boat or submarine.\r\n/// \u003C/summary\u003E\r\n[Title(\u0022Water Exclusion Volume\u0022)]\r\n[Category(\u0022Volumes\u0022)]\r\n[Icon(\u0022water\u0022)]\r\npublic sealed class WaterExclusionVolume : VolumeComponent, Component.ExecuteInEditor\r\n{\r\n\tprotected override void OnEnabled()\r\n\t{\r\n\t\tWaterManager.Current?.RefreshWaterExclusionVolumesList();\r\n\t}\r\n\r\n\tprotected override void OnDisabled()\r\n\t{\r\n\t\tWaterManager.Current?.RefreshWaterExclusionVolumesList();\r\n\t}\r\n\r\n\tprotected override void DrawGizmos()\r\n\t{\r\n\t\tbase.DrawGizmos();\r\n\r\n\t\t/*\r\n\t\tSceneVolume sceneVolume = SceneVolume;\r\n\t\tGizmo.Draw.IgnoreDepth = false;\r\n\t\tGizmo.Draw.Color = Gizmo.Colors.Blue.WithAlpha(0.8f);\r\n\t\tGizmo.Draw.SolidBox(sceneVolume.Box);\r\n\t\tGizmo.Draw.IgnoreDepth = true;\r\n\t\tGizmo.Draw.Color = global::Color.White.WithAlpha(0.05f);\r\n\t\tGizmo.Draw.SolidBox(sceneVolume.Box);\r\n\t\t\r\n\t\tSceneVolume = sceneVolume;\r\n\t\t*/\r\n\t}\r\n\r\n\tprotected override void OnUpdate()\r\n\t{\r\n\t\t// DebugOverlay.Box(GetWorldBounds(), Color.Cyan, overlay: true);\r\n\t}\r\n\r\n\tpublic (Vector3 Center, Vector3 Forward, Vector3 Up, Vector3 HalfExtents) GetWorldOBB()\r\n\t{\r\n\t\tBBox local = SceneVolume.GetBounds();\r\n\t\tVector3 center = WorldTransform.PointToWorld(local.Center);\r\n\t\tVector3 halfExtents = local.Size * 0.5f;\r\n\r\n\t\treturn (center, WorldRotation.Forward, WorldTransform.Up, halfExtents);\r\n\t}\r\n\r\n\tpublic void SetLocalBounds(BBox localBounds)\r\n\t{\r\n\t\tvar sv = SceneVolume;\r\n\t\tsv.Box = localBounds;\r\n\t\tSceneVolume = sv;\r\n\t}\r\n}\r\n"},{"Ident":"redsnail.watertool","Path":"Water/WaterManager.Ripples.cs","FileName":"WaterManager.Ripples.cs","PackageType":"library","CodeKind":"Game","AssetVersionId":342768,"Code":"using System;\nusing System.Collections.Generic;\nusing Sandbox;\n\nnamespace RedSnail.WaterTool;\n\npublic partial class WaterManager\n{\n\t// Interactive ripples \u2014 expanding radial wave packets stamped onto the surface\n\t// when something enters or moves on the water. Each emitter is uploaded as two\n\t// float4 rows: row0 = (Center.xy, StartTime, Strength), row1 = (Wavelength, Width, _, _).\n\t// Amplitude/Speed/Damping are global; Strength, Wavelength and Width are per-ripple.\n\t// The exact same formula runs in advancedwater.shader (VS) and in ComputeRippleHeight\n\t// (CPU) so buoyancy bobs over the visual ripples.\n\n\tprivate const int MAX_RIPPLES = 64;\n\tprivate const int RIPPLE_ROWS = 2;\n\n\t[Property(Title = \u0022Amplitude\u0022), Group(\u0022Ripples\u0022)] public float RippleAmplitude { get; set; } = 8.0f;\n\t[Property(Title = \u0022Expansion Speed\u0022), Group(\u0022Ripples\u0022)] public float RippleSpeed { get; set; } = 100.0f;\n\t// Default ring spacing used when a ripple is spawned without an explicit wavelength.\n\t// Smaller = tighter, more concentric rings. Larger = fewer, broader rings.\n\t[Property(Title = \u0022Default Wavelength\u0022), Group(\u0022Ripples\u0022)] public float RippleWavelength { get; set; } = 120.0f;\n\t// Default ring size used when a ripple is spawned without an explicit width.\n\t// Larger = bigger, broader ripple (the wave packet spans a wider radial band).\n\t[Property(Title = \u0022Default Ring Width\u0022), Group(\u0022Ripples\u0022)] public float RippleWidth { get; set; } = 50.0f;\n\t[Property(Title = \u0022Damping\u0022), Group(\u0022Ripples\u0022)] public float RippleDamping { get; set; } = 1.0f;\n\t[Property(Title = \u0022Lifetime\u0022), Group(\u0022Ripples\u0022)] public float RippleLifetime { get; set; } = 3.0f;\n\n\tprivate struct RippleEmitter\n\t{\n\t\tpublic Vector2 Center;\n\t\tpublic float StartTime;\n\t\tpublic float Strength;\n\t\tpublic float Wavelength;\n\t\tpublic float Width;\n\t}\n\n\tprivate readonly List\u003CRippleEmitter\u003E m_Ripples = [];\n\tprivate GpuBuffer\u003CVector4\u003E m_RippleBuffer;\n\tprivate readonly Vector4[] m_RippleData = new Vector4[MAX_RIPPLES * RIPPLE_ROWS];\n\tprivate int m_ActiveRippleCount;\n\n\n\n\t/// \u003Csummary\u003E\n\t/// Spawn an expanding ripple on the water surface at the given world position.\n\t/// \u003C/summary\u003E\n\t/// \u003Cparam name=\u0022_WorldPosition\u0022\u003EWhere the ripple originates (only XY is used).\u003C/param\u003E\n\t/// \u003Cparam name=\u0022_Strength\u0022\u003EScales the height of the ripple (1 = a normal splash).\u003C/param\u003E\n\t/// \u003Cparam name=\u0022_Wavelength\u0022\u003ERing spacing \u2014 smaller = more rings. Pass \u0026lt;= 0 to use the manager\u0027s Default Wavelength.\u003C/param\u003E\n\t/// \u003Cparam name=\u0022_Width\u0022\u003ERing size \u2014 larger = a bigger, broader ripple. Pass \u0026lt;= 0 to use the manager\u0027s Default Ring Width.\u003C/param\u003E\n\tpublic static void AddRipple(Vector3 _WorldPosition, float _Strength = 1.0f, float _Wavelength = -1.0f, float _Width = -1.0f)\n\t{\n\t\tCurrent?.AddRippleInternal(_WorldPosition, _Strength, _Wavelength, _Width);\n\t}\n\n\tprivate void AddRippleInternal(Vector3 _WorldPosition, float _Strength, float _Wavelength, float _Width)\n\t{\n\t\tif (_Strength \u003C= 0.0f)\n\t\t\treturn;\n\n\t\t// Fall back to the global defaults when no per-ripple value is given\n\t\tif (_Wavelength \u003C= 0.0f)\n\t\t\t_Wavelength = RippleWavelength;\n\n\t\tif (_Width \u003C= 0.0f)\n\t\t\t_Width = RippleWidth;\n\n\t\t// Drop the oldest when full so the freshest splashes always survive\n\t\tif (m_Ripples.Count \u003E= MAX_RIPPLES)\n\t\t\tm_Ripples.RemoveAt(0);\n\n\t\tm_Ripples.Add(new RippleEmitter\n\t\t{\n\t\t\tCenter = new Vector2(_WorldPosition.x, _WorldPosition.y),\n\t\t\tStartTime = Time.Now,\n\t\t\tStrength = _Strength,\n\t\t\tWavelength = _Wavelength,\n\t\t\tWidth = _Width\n\t\t});\n\t}\n\n\n\n\tprivate void UpdateRipples()\n\t{\n\t\t// Prune expired emitters\n\t\tfor (int i = m_Ripples.Count - 1; i \u003E= 0; i--)\n\t\t{\n\t\t\tif (Time.Now - m_Ripples[i].StartTime \u003E RippleLifetime)\n\t\t\t\tm_Ripples.RemoveAt(i);\n\t\t}\n\n\t\tm_ActiveRippleCount = Math.Min(m_Ripples.Count, MAX_RIPPLES);\n\n\t\tfor (int i = 0; i \u003C m_ActiveRippleCount; i\u002B\u002B)\n\t\t{\n\t\t\tvar r = m_Ripples[i];\n\t\t\tint row = i * RIPPLE_ROWS;\n\n\t\t\tm_RippleData[row \u002B 0] = new Vector4(r.Center.x, r.Center.y, r.StartTime, r.Strength);\n\t\t\tm_RippleData[row \u002B 1] = new Vector4(r.Wavelength, r.Width, 0.0f, 0.0f);\n\t\t}\n\n\t\tEnsureRippleBuffer();\n\n\t\tm_RippleBuffer.SetData(m_RippleData.AsSpan(0, m_ActiveRippleCount * RIPPLE_ROWS));\n\t}\n\n\tprivate void EnsureRippleBuffer()\n\t{\n\t\tif (!m_RippleBuffer.IsValid())\n\t\t\tm_RippleBuffer = new GpuBuffer\u003CVector4\u003E(MAX_RIPPLES * RIPPLE_ROWS, GpuBuffer.UsageFlags.Structured);\n\t}\n\n\n\n\tinternal void ApplyRippleAttributes(RenderAttributes _Attributes)\n\t{\n\t\t_Attributes.Set(\u0022RippleCount\u0022, m_ActiveRippleCount);\n\t\t_Attributes.Set(\u0022RippleAmplitude\u0022, RippleAmplitude);\n\t\t_Attributes.Set(\u0022RippleSpeed\u0022, RippleSpeed);\n\t\t_Attributes.Set(\u0022RippleDamping\u0022, RippleDamping);\n\n\t\tif (m_RippleBuffer.IsValid())\n\t\t\t_Attributes.Set(\u0022RippleData\u0022, m_RippleBuffer);\n\t}\n\n\n\n\t/// \u003Csummary\u003E\n\t/// CPU evaluation of the ripple vertical displacement at a world XY position.\n\t/// MUST mirror ComputeRipples() in advancedwater.shader so physics matches visuals.\n\t/// \u003C/summary\u003E\n\tpublic float ComputeRippleHeight(Vector2 _WorldXY)\n\t{\n\t\tif (m_Ripples.Count == 0)\n\t\t\treturn 0.0f;\n\n\t\tfloat z = 0.0f;\n\n\t\tfor (int i = 0; i \u003C m_Ripples.Count; i\u002B\u002B)\n\t\t{\n\t\t\tvar r = m_Ripples[i];\n\n\t\t\tfloat age = Time.Now - r.StartTime;\n\t\t\tif (age \u003C 0.0f || age \u003E RippleLifetime)\n\t\t\t\tcontinue;\n\n\t\t\tfloat freq = r.Wavelength \u003E 0.001f ? (MathF.PI * 2.0f / r.Wavelength) : 0.0f;\n\t\t\tfloat invWidthSq = r.Width \u003E 0.001f ? 1.0f / (r.Width * r.Width) : 0.0f;\n\n\t\t\tfloat d = (_WorldXY - r.Center).Length;\n\t\t\tfloat ring = age * RippleSpeed;\n\t\t\tfloat ringDelta = d - ring;\n\n\t\t\tfloat spatialEnv = MathF.Exp(-ringDelta * ringDelta * invWidthSq);\n\t\t\tfloat timeEnv = MathF.Exp(-age * RippleDamping);\n\t\t\tfloat wave = MathF.Sin(ringDelta * freq);\n\n\t\t\tz \u002B= wave * spatialEnv * timeEnv * RippleAmplitude * r.Strength;\n\t\t}\n\n\t\treturn z;\n\t}\n}\n"},{"Ident":"redsnail.watertool","Path":"Code/Water/WaterBodyRenderer.cs","FileName":"WaterBodyRenderer.cs","PackageType":"library","CodeKind":"Game","AssetVersionId":342768,"Code":"using System;\r\nusing System.Collections.Generic;\r\nusing System.Linq;\r\nusing Sandbox;\r\nusing Sandbox.Rendering;\r\n\r\nnamespace RedSnail.WaterTool;\r\n\r\n[Icon(\u0022water\u0022), Group(\u0022Environment\u0022), Title(\u0022Water Body Renderer\u0022)]\r\npublic sealed class WaterBodyRenderer : Component, Component.ExecuteInEditor, Component.DontExecuteOnServer\r\n{\r\n#pragma warning disable CS0649\r\n\r\n\tprivate struct WaterVertex\r\n\t{\r\n\t\t[VertexLayout.Position] public Vector3 Position;\r\n\t\t[VertexLayout.Normal] public Vector3 Normal;\r\n\t\t[VertexLayout.Tangent] public Vector4 Tangent;\r\n\t\t[VertexLayout.TexCoord] public Vector2 TexCoord;\r\n\t\t[VertexLayout.Color] public Color Color;\r\n\t}\r\n\r\n#pragma warning restore CS0649\r\n\r\n\tprivate const float BASE_TILE_SIZE = 100.0f;\r\n\r\n\tprivate const int MAX_RINGS = 8;\r\n\r\n\tprivate const int MAX_WATER_INCLUSION_VOLUMES = 1024;\r\n\tprivate const int WATER_INCLUSION_VOLUME_ROWS = 3;\r\n\r\n\tprivate const int MAX_WATER_EXCLUSION_VOLUMES = 512;\r\n\tprivate const int WATER_EXCLUSION_VOLUME_ROWS = 3;\r\n\r\n\tprivate const int MAX_HULL_EXCLUSION_VOLUMES = 8;\r\n\tprivate const int HULL_EXCLUSION_META_ROWS = 6;\r\n\tprivate const int HULL_EXCLUSION_META_SIZE = MAX_HULL_EXCLUSION_VOLUMES * HULL_EXCLUSION_META_ROWS;\r\n\tprivate const int MAX_HULL_EXCLUSION_TRIS = 16384;\r\n\r\n\tprivate GpuBuffer\u003CWaterVertex\u003E m_VertexBuffer;\r\n\tprivate GpuBuffer\u003Cuint\u003E m_IndexBuffer;\r\n\tprivate GpuBuffer\u003CVector4\u003E m_WaterInclusionVolumeBuffer;\r\n\tprivate GpuBuffer\u003CVector4\u003E m_WaterExclusionVolumeBuffer;\r\n\tprivate int m_TotalIndexCount;\r\n\tprivate readonly RenderAttributes m_DrawAttributes = new();\r\n\tprivate int m_LastConfigHash;\r\n\tprivate readonly Vector4[] m_WaterInclusionVolumeData = new Vector4[MAX_WATER_INCLUSION_VOLUMES * WATER_INCLUSION_VOLUME_ROWS];\r\n\tprivate readonly Vector4[] m_WaterExclusionVolumeData = new Vector4[MAX_WATER_EXCLUSION_VOLUMES * WATER_EXCLUSION_VOLUME_ROWS];\r\n\tprivate GpuBuffer\u003CVector4\u003E m_HullExclusionBuffer;\r\n\tprivate readonly Vector4[] m_HullExclusionData = new Vector4[HULL_EXCLUSION_META_SIZE \u002B MAX_HULL_EXCLUSION_TRIS * 3];\r\n\r\n\t[Property, Group(\u0022General\u0022), Order(0)] public WaterBodyType WaterType { get; set; } = WaterBodyType.Ocean;\r\n\t[Property, Group(\u0022General\u0022), Order(0)] public Material Material { get; set; }\r\n\t[Property, Group(\u0022General\u0022), Order(0)] public float Width { get; set; } = 10000.0f;\r\n\t[Property, Group(\u0022General\u0022), Order(0)] public float Length { get; set; } = 10000.0f;\r\n\t[Property, Group(\u0022General\u0022), Order(0)] public float Depth { get; set; } = 300.0f;\r\n\t[Property(Title = \u0022Infinite Rendering\u0022), Group(\u0022General\u0022), Order(0)] public bool UseHybridInclusionBounds { get; set; } = true;\r\n\t[Property, Group(\u0022Clipmap\u0022), Order(1)] public float BaseCellSize { get; set; } = 8.0f;\r\n\t[Property, Group(\u0022Clipmap\u0022), Order(1), Range(16, 512)] public int CellsPerRing { get; set; } = 64;\r\n\t[Property(Title = \u0022Use Camera For Clipmap\u0022), Group(\u0022Clipmap\u0022), Order(1)] public bool FollowCameraForClipmap { get; set; } = true;\r\n\t[Property, Group(\u0022Texture\u0022), Order(2), Range(0.1f, 2.0f)] public float TextureTilingMultiplier { get; set; } = 1.0f;\r\n\r\n\tprivate int VerticesPerRing =\u003E (CellsPerRing \u002B 1) * (CellsPerRing \u002B 1);\r\n\tprivate float OuterExtent =\u003E CellsPerRing * BaseCellSize * (1 \u003C\u003C (ComputeRingCount() - 1));\r\n\r\n\tinternal bool ParticipatesInRendering =\u003E Active \u0026\u0026 Material.IsValid();\r\n\tinternal bool HasValidBuffers =\u003E m_VertexBuffer.IsValid() \u0026\u0026 m_IndexBuffer.IsValid();\r\n\r\n\tprotected override void OnEnabled()\r\n\t{\r\n\t\tif (!ParticipatesInRendering)\r\n\t\t\treturn;\r\n\r\n\t\tCreateBuffers();\r\n\r\n\t\tm_LastConfigHash = ComputeConfigHash();\r\n\r\n\t\tWaterManager.Current?.RefreshWaterBodyRenderersList();\r\n\t}\r\n\r\n\tprotected override void OnDisabled()\r\n\t{\r\n\t\tWaterManager.Current?.RefreshWaterBodyRenderersList();\r\n\r\n\t\tm_VertexBuffer = default;\r\n\t\tm_IndexBuffer = default;\r\n\t\tm_WaterInclusionVolumeBuffer?.Dispose();\r\n\t\tm_WaterInclusionVolumeBuffer = null;\r\n\t\tm_WaterExclusionVolumeBuffer?.Dispose();\r\n\t\tm_WaterExclusionVolumeBuffer = null;\r\n\t\tm_HullExclusionBuffer?.Dispose();\r\n\t\tm_HullExclusionBuffer = null;\r\n\t}\r\n\r\n\tprotected override void OnUpdate()\r\n\t{\r\n\t\tif (!ParticipatesInRendering)\r\n\t\t\treturn;\r\n\r\n\t\tint configHash = ComputeConfigHash();\r\n\t\tif (!HasValidBuffers || configHash != m_LastConfigHash)\r\n\t\t{\r\n\t\t\tCreateBuffers();\r\n\t\t\tm_LastConfigHash = configHash;\r\n\t\t}\r\n\r\n\t\tUpdateShaderAttributes();\r\n\t}\r\n\r\n\tinternal BBox GetWorldBounds2D()\r\n\t{\r\n\t\tVector3 right = WorldRotation.Right * (Length / 2.0f);\r\n\t\tVector3 forward = WorldRotation.Forward * (Width / 2.0f);\r\n\r\n\t\tVector3 c0 = WorldPosition \u002B right \u002B forward;\r\n\t\tVector3 c1 = WorldPosition - right \u002B forward;\r\n\t\tVector3 c2 = WorldPosition \u002B right - forward;\r\n\t\tVector3 c3 = WorldPosition - right - forward;\r\n\r\n\t\tfloat minX = MathF.Min(MathF.Min(c0.x, c1.x), MathF.Min(c2.x, c3.x));\r\n\t\tfloat maxX = MathF.Max(MathF.Max(c0.x, c1.x), MathF.Max(c2.x, c3.x));\r\n\t\tfloat minY = MathF.Min(MathF.Min(c0.y, c1.y), MathF.Min(c2.y, c3.y));\r\n\t\tfloat maxY = MathF.Max(MathF.Max(c0.y, c1.y), MathF.Max(c2.y, c3.y));\r\n\r\n\t\treturn new BBox(new Vector3(minX, minY, WorldPosition.z - Depth), new Vector3(maxX, maxY, WorldPosition.z));\r\n\t}\r\n\r\n\t// Records the clipmap compute dispatches into the command list as DEFERRED commands.\r\n\t// They run later, on the render thread, when the camera executes the list - so the\r\n\t// per-ring attributes are set through the command list (which writes Graphics.Attributes\r\n\t// at execute time, exactly what CommandList.DispatchCompute reads) rather than on the\r\n\t// shared shader instance.\r\n\tinternal void RecordCompute(CommandList commandList, ComputeShader shader, Vector3 cameraPosition)\r\n\t{\r\n\t\tif (!ParticipatesInRendering || !HasValidBuffers)\r\n\t\t\treturn;\r\n\r\n\t\tint ringCount = ComputeRingCount();\r\n\t\tint verticesPerRing = VerticesPerRing;\r\n\r\n\t\tvar localBounds = GetWorldBounds2D();\r\n\r\n\t\tfor (int ring = 0; ring \u003C ringCount; ring\u002B\u002B)\r\n\t\t{\r\n\t\t\tfloat cellSize = BaseCellSize * (1 \u003C\u003C ring);\r\n\t\t\tVector3 clipmapAnchor = FollowCameraForClipmap ? cameraPosition : WorldPosition;\r\n\t\t\tfloat snapX = MathF.Floor(clipmapAnchor.x / cellSize) * cellSize;\r\n\t\t\tfloat snapY = MathF.Floor(clipmapAnchor.y / cellSize) * cellSize;\r\n\r\n\t\t\tcommandList.Attributes.Set(\u0022VertexBuffer\u0022, m_VertexBuffer);\r\n\t\t\tcommandList.Attributes.Set(\u0022VertexOffset\u0022, ring * verticesPerRing);\r\n\t\t\tcommandList.Attributes.Set(\u0022GridWidth\u0022, CellsPerRing);\r\n\t\t\tcommandList.Attributes.Set(\u0022CellSize\u0022, cellSize);\r\n\t\t\tcommandList.Attributes.Set(\u0022SnapPosition\u0022, new Vector2(snapX, snapY));\r\n\t\t\tcommandList.Attributes.Set(\u0022WaterZ\u0022, WorldPosition.z);\r\n\t\t\tcommandList.Attributes.Set(\u0022TilingScale\u0022, 1.0f / OuterExtent);\r\n\t\t\tcommandList.Attributes.Set(\u0022ClampToBounds\u0022, false);\r\n\t\t\tcommandList.Attributes.Set(\u0022BoundsMin\u0022, new Vector2(localBounds.Mins.x, localBounds.Mins.y));\r\n\t\t\tcommandList.Attributes.Set(\u0022BoundsMax\u0022, new Vector2(localBounds.Maxs.x, localBounds.Maxs.y));\r\n\t\t\tcommandList.DispatchCompute(shader, verticesPerRing, 1, 1);\r\n\t\t}\r\n\t}\r\n\r\n\tinternal void BarrierTransition(CommandList _CommandList)\r\n\t{\r\n\t\tif (m_VertexBuffer.IsValid())\r\n\t\t\t_CommandList?.ResourceBarrierTransition(m_VertexBuffer, ResourceState.UnorderedAccess, ResourceState.VertexOrIndexBuffer);\r\n\t}\r\n\r\n\tinternal void Draw(CommandList _CommandList)\r\n\t{\r\n\t\tif (!ParticipatesInRendering || !HasValidBuffers)\r\n\t\t\treturn;\r\n\t\t\r\n\t\t_CommandList?.DrawIndexed(m_VertexBuffer, m_IndexBuffer, Material, 0, m_TotalIndexCount, m_DrawAttributes);\r\n\t}\r\n\r\n\tprivate void UpdateShaderAttributes()\r\n\t{\r\n\t\tBBox localBounds = GetWorldBounds2D();\r\n\r\n\t\tm_DrawAttributes.Set(\u0022RequireWaterInclusionVolumes\u0022, UseHybridInclusionBounds);\r\n\t\tm_DrawAttributes.Set(\u0022UseHybridInclusionBounds\u0022, UseHybridInclusionBounds);\r\n\t\tm_DrawAttributes.Set(\u0022HybridInclusionBoundsMin\u0022, new Vector2(localBounds.Mins.x, localBounds.Mins.y));\r\n\t\tm_DrawAttributes.Set(\u0022HybridInclusionBoundsMax\u0022, new Vector2(localBounds.Maxs.x, localBounds.Maxs.y));\r\n\r\n\t\tWaterDefinition profile = WaterManager.GetWaveProfile(WaterType);\r\n\r\n\t\tif (profile.IsValid())\r\n\t\t\tprofile.ApplyTo(m_DrawAttributes);\r\n\r\n\t\tm_DrawAttributes.Set(\u0022WaterTime\u0022, Time.Now);\r\n\t\tm_DrawAttributes.Set(\u0022DepthMax\u0022, Depth);\r\n\r\n\t\tfloat tilingScalar = (OuterExtent / BASE_TILE_SIZE) * TextureTilingMultiplier;\r\n\t\tm_DrawAttributes.Set(\u0022NormalTiling\u0022, new Vector2(tilingScalar, tilingScalar));\r\n\r\n\t\tWaterManager.Current?.ApplyRippleAttributes(m_DrawAttributes);\r\n\t\tWaterManager.Current?.ApplyCalmAttributes(m_DrawAttributes);\r\n\t\t\r\n\t\t// Band-limit the wave normal to the local clipmap vertex spacing (see shader)\r\n\t\tm_DrawAttributes.Set(\u0022WaveNormalEpsScale\u0022, 3.0f / CellsPerRing);\r\n\t\tm_DrawAttributes.Set(\u0022WaveNormalEpsMin\u0022, BaseCellSize);\r\n\r\n\t\tvar viewPosition = WaterManager.GetViewPosition(Scene, WorldPosition);\r\n\r\n\t\tSetWaterInclusionVolumes(viewPosition);\r\n\t\tSetWaterExclusionVolumes(viewPosition);\r\n\t\tSetHullExclusionVolumes();\r\n\t}\r\n\r\n\tprivate void SetWaterInclusionVolumes(Vector3 referencePosition)\r\n\t{\r\n\t\tEnsureWaterInclusionVolumeBuffer();\r\n\r\n\t\tvar volumes = WaterManager.Current.Bodies\r\n\t\t\t.Where(v =\u003E v.IsValid() \u0026\u0026 v.Active \u0026\u0026 v.WaterType == WaterType)\r\n\t\t\t.OrderBy(v =\u003E v.WorldPosition.DistanceSquared(referencePosition))\r\n\t\t\t.Take(MAX_WATER_INCLUSION_VOLUMES)\r\n\t\t\t.ToList();\r\n\r\n\t\tfor (int i = 0; i \u003C volumes.Count; i\u002B\u002B)\r\n\t\t{\r\n\t\t\tvar (center, forward, up, half) = volumes[i].GetWorldOBB();\r\n\r\n\t\t\tint rowOffset = i * WATER_INCLUSION_VOLUME_ROWS;\r\n\r\n\t\t\tm_WaterInclusionVolumeData[rowOffset \u002B 0] = new Vector4(forward.x, forward.y, forward.z, half.x);\r\n\t\t\tm_WaterInclusionVolumeData[rowOffset \u002B 1] = new Vector4(up.x, up.y, up.z, half.y);\r\n\t\t\tm_WaterInclusionVolumeData[rowOffset \u002B 2] = new Vector4(center.x, center.y, center.z, half.z);\r\n\t\t}\r\n\r\n\t\tm_WaterInclusionVolumeBuffer.SetData(m_WaterInclusionVolumeData.AsSpan(0, volumes.Count * WATER_INCLUSION_VOLUME_ROWS));\r\n\r\n\t\tm_DrawAttributes.Set(\u0022WaterInclusionVolumeCount\u0022, volumes.Count);\r\n\t\tm_DrawAttributes.Set(\u0022WaterInclusionVolumeRows\u0022, m_WaterInclusionVolumeBuffer);\r\n\t}\r\n\r\n\tprivate void SetWaterExclusionVolumes(Vector3 referencePosition)\r\n\t{\r\n\t\tEnsureWaterExclusionVolumeBuffer();\r\n\r\n\t\tvar volumes = WaterManager.Current.ExclusionVolumes\r\n\t\t\t.Where(v =\u003E v.IsValid() \u0026\u0026 v.Enabled \u0026\u0026 v.Active)\r\n\t\t\t.OrderBy(v =\u003E v.WorldPosition.DistanceSquared(referencePosition))\r\n\t\t\t.Take(MAX_WATER_EXCLUSION_VOLUMES)\r\n\t\t\t.ToList();\r\n\r\n\t\tfor (int i = 0; i \u003C volumes.Count; i\u002B\u002B)\r\n\t\t{\r\n\t\t\tvar (center, forward, up, half) = volumes[i].GetWorldOBB();\r\n\r\n\t\t\tint rowOffset = i * WATER_EXCLUSION_VOLUME_ROWS;\r\n\r\n\t\t\tm_WaterExclusionVolumeData[rowOffset \u002B 0] = new Vector4(forward.x, forward.y, forward.z, half.x);\r\n\t\t\tm_WaterExclusionVolumeData[rowOffset \u002B 1] = new Vector4(up.x, up.y, up.z, half.y);\r\n\t\t\tm_WaterExclusionVolumeData[rowOffset \u002B 2] = new Vector4(center.x, center.y, center.z, half.z);\r\n\t\t}\r\n\r\n\t\tm_WaterExclusionVolumeBuffer.SetData(m_WaterExclusionVolumeData.AsSpan(0, volumes.Count * WATER_EXCLUSION_VOLUME_ROWS));\r\n\r\n\t\tm_DrawAttributes.Set(\u0022WaterExclusionVolumeCount\u0022, volumes.Count);\r\n\t\tm_DrawAttributes.Set(\u0022WaterExclusionVolumeRows\u0022, m_WaterExclusionVolumeBuffer);\r\n\t}\r\n\r\n\tprivate void EnsureWaterExclusionVolumeBuffer()\r\n\t{\r\n\t\tif (m_WaterExclusionVolumeBuffer.IsValid())\r\n\t\t\treturn;\r\n\r\n\t\tm_WaterExclusionVolumeBuffer = new GpuBuffer\u003CVector4\u003E(MAX_WATER_EXCLUSION_VOLUMES * WATER_EXCLUSION_VOLUME_ROWS, GpuBuffer.UsageFlags.Structured);\r\n\t}\r\n\r\n\r\n\r\n\tprivate void SetHullExclusionVolumes()\r\n\t{\r\n\t\tif (WaterManager.Current == null)\r\n\t\t\treturn;\r\n\r\n\t\tvar hulls = WaterManager.Current.HullExclusionVolumes\r\n\t\t\t.Where(h =\u003E h.IsValid() \u0026\u0026 h.Active \u0026\u0026 h.LocalTriangles.Length \u003E 0)\r\n\t\t\t.Take(MAX_HULL_EXCLUSION_VOLUMES)\r\n\t\t\t.ToList();\r\n\r\n\t\tif (hulls.Count == 0)\r\n\t\t{\r\n\t\t\tm_DrawAttributes.Set(\u0022WaterHullExclusionCount\u0022, 0);\r\n\t\t\treturn;\r\n\t\t}\r\n\r\n\t\tEnsureHullExclusionBuffers();\r\n\r\n\t\tint triWriteCursor = HULL_EXCLUSION_META_SIZE;\r\n\r\n\t\tfor (int h = 0; h \u003C hulls.Count; h\u002B\u002B)\r\n\t\t{\r\n\t\t\tvar hull = hulls[h];\r\n\t\t\tvar tris = hull.LocalTriangles;\r\n\t\t\tint triCount = tris.Length / 3;\r\n\r\n\t\t\tif (triWriteCursor \u002B tris.Length \u003E m_HullExclusionData.Length)\r\n\t\t\t\tbreak;\r\n\r\n\t\t\thull.GetWorldToLocalRows(out var r0, out var r1, out var r2, out var r3);\r\n\r\n\t\t\tint meta = h * HULL_EXCLUSION_META_ROWS;\r\n\t\t\tm_HullExclusionData[meta \u002B 0] = r0;\r\n\t\t\tm_HullExclusionData[meta \u002B 1] = r1;\r\n\t\t\tm_HullExclusionData[meta \u002B 2] = r2;\r\n\t\t\tm_HullExclusionData[meta \u002B 3] = r3;\r\n\r\n\t\t\tvar aabb = hull.LocalAABB;\r\n\t\t\tm_HullExclusionData[meta \u002B 4] = new Vector4(triWriteCursor, triCount, aabb.Mins.x, aabb.Mins.y);\r\n\t\t\tm_HullExclusionData[meta \u002B 5] = new Vector4(aabb.Mins.z, aabb.Maxs.x, aabb.Maxs.y, aabb.Maxs.z);\r\n\r\n\t\t\tfor (int i = 0; i \u003C tris.Length; i\u002B\u002B)\r\n\t\t\t\tm_HullExclusionData[triWriteCursor \u002B i] = new Vector4(tris[i].x, tris[i].y, tris[i].z, 0f);\r\n\r\n\t\t\ttriWriteCursor \u002B= tris.Length;\r\n\t\t}\r\n\r\n\t\tm_HullExclusionBuffer.SetData(m_HullExclusionData.AsSpan(0, triWriteCursor));\r\n\r\n\t\tm_DrawAttributes.Set(\u0022WaterHullExclusionCount\u0022, hulls.Count);\r\n\t\tm_DrawAttributes.Set(\u0022WaterHullExclusionData\u0022, m_HullExclusionBuffer);\r\n\t}\r\n\r\n\r\n\r\n\tprivate void EnsureHullExclusionBuffers()\r\n\t{\r\n\t\tif (!m_HullExclusionBuffer.IsValid())\r\n\t\t\tm_HullExclusionBuffer = new GpuBuffer\u003CVector4\u003E(HULL_EXCLUSION_META_SIZE \u002B MAX_HULL_EXCLUSION_TRIS * 3, GpuBuffer.UsageFlags.Structured);\r\n\t}\r\n\r\n\r\n\r\n\tprivate void EnsureWaterInclusionVolumeBuffer()\r\n\t{\r\n\t\tif (m_WaterInclusionVolumeBuffer.IsValid())\r\n\t\t\treturn;\r\n\r\n\t\tm_WaterInclusionVolumeBuffer = new GpuBuffer\u003CVector4\u003E(MAX_WATER_INCLUSION_VOLUMES * WATER_INCLUSION_VOLUME_ROWS, GpuBuffer.UsageFlags.Structured);\r\n\t}\r\n\r\n\tprivate int ComputeConfigHash()\r\n\t{\r\n\t\treturn HashCode.Combine(Width, Length, BaseCellSize, CellsPerRing);\r\n\t}\r\n\r\n\tprivate int ComputeRingCount()\r\n\t{\r\n\t\treturn ComputeRingCount(Width, Length);\r\n\t}\r\n\r\n\tprivate int ComputeRingCount(float width, float length)\r\n\t{\r\n\t\tfloat maxDim = MathF.Max(length, width);\r\n\t\tfloat innerExtent = CellsPerRing * BaseCellSize;\r\n\t\tfloat requiredExtent = maxDim * 2.0f;\r\n\r\n\t\tif (requiredExtent \u003C= innerExtent)\r\n\t\t\treturn 1;\r\n\r\n\t\tint rings = (int)MathF.Ceiling(MathF.Log2(requiredExtent / innerExtent)) \u002B 1;\r\n\t\treturn Math.Clamp(rings, 1, MAX_RINGS);\r\n\t}\r\n\r\n\tprivate void CreateBuffers()\r\n\t{\r\n\t\tint ringCount = ComputeRingCount();\r\n\t\tint n = CellsPerRing;\r\n\t\tint verticesPerRing = VerticesPerRing;\r\n\r\n\t\tint innerStart = n / 4 \u002B 1;\r\n\t\tint innerEnd = n * 3 / 4 - 1;\r\n\t\tint innerBlockSize = innerEnd - innerStart;\r\n\t\tint filledCells = n * n;\r\n\t\tint hollowCells = filledCells - (innerBlockSize * innerBlockSize);\r\n\t\tint totalIndices = filledCells * 6;\r\n\t\ttotalIndices \u002B= (ringCount - 1) * hollowCells * 6;\r\n\r\n\t\tm_VertexBuffer = new GpuBuffer\u003CWaterVertex\u003E(ringCount * verticesPerRing, GpuBuffer.UsageFlags.Vertex | GpuBuffer.UsageFlags.Structured);\r\n\t\tm_IndexBuffer = new GpuBuffer\u003Cuint\u003E(totalIndices, GpuBuffer.UsageFlags.Index | GpuBuffer.UsageFlags.Structured);\r\n\t\tUploadIndexBuffer(ringCount);\r\n\t}\r\n\r\n\tprivate void UploadIndexBuffer(int ringCount)\r\n\t{\r\n\t\tint n = CellsPerRing;\r\n\t\tint verticesPerRing = VerticesPerRing;\r\n\t\tint innerStart = n / 4 \u002B 1;\r\n\t\tint innerEnd = n * 3 / 4 - 1;\r\n\r\n\t\tvar indices = new List\u003Cuint\u003E();\r\n\r\n\t\tfor (int ring = 0; ring \u003C ringCount; ring\u002B\u002B)\r\n\t\t{\r\n\t\t\tuint baseVertex = (uint)(ring * verticesPerRing);\r\n\r\n\t\t\tfor (int y = 0; y \u003C n; y\u002B\u002B)\r\n\t\t\t{\r\n\t\t\t\tfor (int x = 0; x \u003C n; x\u002B\u002B)\r\n\t\t\t\t{\r\n\t\t\t\t\tif (ring \u003E 0 \u0026\u0026 x \u003E= innerStart \u0026\u0026 x \u003C innerEnd \u0026\u0026 y \u003E= innerStart \u0026\u0026 y \u003C innerEnd)\r\n\t\t\t\t\t\tcontinue;\r\n\r\n\t\t\t\t\tuint i0 = baseVertex \u002B (uint)(y * (n \u002B 1) \u002B x);\r\n\t\t\t\t\tuint i1 = i0 \u002B 1;\r\n\t\t\t\t\tuint i2 = i0 \u002B (uint)(n \u002B 1);\r\n\t\t\t\t\tuint i3 = i2 \u002B 1;\r\n\r\n\t\t\t\t\tindices.Add(i0);\r\n\t\t\t\t\tindices.Add(i1);\r\n\t\t\t\t\tindices.Add(i2);\r\n\t\t\t\t\tindices.Add(i1);\r\n\t\t\t\t\tindices.Add(i3);\r\n\t\t\t\t\tindices.Add(i2);\r\n\t\t\t\t}\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\tm_IndexBuffer.SetData(indices);\r\n\t\tm_TotalIndexCount = indices.Count;\r\n\t}\r\n}\r\n"},{"Ident":"redsnail.watertool","Path":"Code/Water/WaterQuadBaker.cs","FileName":"WaterQuadBaker.cs","PackageType":"library","CodeKind":"Game","AssetVersionId":342768,"Code":"using System;\r\nusing System.Collections.Generic;\r\nusing System.Linq;\r\nusing System.Threading.Tasks;\r\nusing Sandbox;\r\nusing Sandbox.Audio;\r\n\r\nnamespace RedSnail.WaterTool;\r\n\r\n[Icon(\u0022water_drop\u0022), Group(\u0022Water\u0022), Title(\u0022Water Quad Baker\u0022)]\r\npublic sealed class WaterQuadBaker : Component, Component.ExecuteInEditor\r\n{\r\n\tprivate const string BakedContainerName = \u0022Water Volumes\u0022;\r\n\tprivate const string BakedTag = \u0022water_quad_bake\u0022;\r\n\r\n\tprivate readonly List\u003CTerrain\u003E _terrains = new();\r\n\tprivate readonly HashSet\u003CCollider\u003E _solidColliders = new();\r\n\tprivate float _insideTraceDistance;\r\n\tprivate int _physicsCreatedCount;\r\n\tprivate int _skippedInsideCount;\r\n\tprivate int _subdividedCount;\r\n\r\n\t[Property, Group(\u0022Water\u0022), Order(0)] public WaterBodyType WaterType { get; set; } = WaterBodyType.Ocean;\r\n\r\n\t[Property, Group(\u0022Bake Bounds\u0022)] public Vector2 BakeSizeXY { get; set; } = new(10000.0f, 10000.0f);\r\n\t[Property, Group(\u0022Bake Bounds\u0022)] public float WaterSurfaceZ { get; set; } = 0.0f;\r\n\t[Property, Group(\u0022Bake Bounds\u0022)] public float WaterDepth { get; set; } = 1000.0f;\r\n\r\n\t[Property, Group(\u0022Strict Pass\u0022), Range(256.0f, 8192.0f), Order(2)] public float MinCellSize { get; set; } = 4096.0f;\r\n\t[Property, Group(\u0022Strict Pass\u0022), Range(1, 12)] public int MaxDepth { get; set; } = 6;\r\n\t[Property, Group(\u0022Strict Pass\u0022), Range(0.0f, 64.0f)] public float QuadInset { get; set; } = 0.0f;\r\n\t[Property, Group(\u0022Strict Pass\u0022), Range(1.0f, 128.0f)] public float SolidProbeRadius { get; set; } = 8.0f;\r\n\t[Property, Group(\u0022Strict Pass\u0022), Range(0.0f, 256.0f)] public float TerrainPadding { get; set; } = 16.0f;\r\n\t[Property, Group(\u0022Strict Pass\u0022)] public bool IgnoreTerrainBelowWaterSurface { get; set; } = true;\r\n\t[Property, Group(\u0022Strict Pass\u0022), Range(0.0f, 5000.0f)] public float TerrainDepthIgnoreDistance { get; set; } = 512.0f;\r\n\r\n\t[Property, Group(\u0022Coastal Fill\u0022), Order(3)] public bool EnableCoastalFill { get; set; } = true;\r\n\t[Property, Group(\u0022Coastal Fill\u0022), Range(256.0f, 8192.0f)] public float CoastalFillMaxCellSize { get; set; } = 4096.0f;\r\n\t[Property, Group(\u0022Coastal Fill\u0022), Range(0.0f, 5000.0f)] public float CoastalFillPenetrationDistance { get; set; } = 192.0f;\r\n\t[Property, Group(\u0022Coastal Fill\u0022), Range(0.1f, 1.0f)] public float CoastalFillInlandThreshold { get; set; } = 1.0f;\r\n\r\n\t[Property, ToggleGroup(\u0022Soundscape\u0022), Order(4)] public bool Soundscape { get; set; } = false;\r\n\t[Property, Group(\u0022Soundscape\u0022), Range(0.0f, 1000.0f)] public float SoundscapeExtraHeight { get; set; } = 250.0f;\r\n\t[Property, Group(\u0022Soundscape\u0022)] public Soundscape SoundscapeAsset { get; set; }\r\n\t[Property, Group(\u0022Soundscape\u0022)] public MixerHandle SoundscapeTargetMixer { get; set; }\r\n\t[Property, Group(\u0022Soundscape\u0022)] public bool SoundscapeStayActiveOnExit { get; set; } = true;\r\n\t[Property, Group(\u0022Soundscape\u0022), Range(0.0f, 2.0f)] public float SoundscapeVolume { get; set; } = 1.0f;\r\n\t\r\n\t[Property, Group(\u0022Miscellaneous\u0022)] public bool ExcludeMeshGeometry { get; set; } = false;\r\n\r\n\r\n\r\n\t[Button]\r\n\tprivate async Task Bake()\r\n\t{\r\n\t\tCacheSceneGeometry();\r\n\t\tClearBaked();\r\n\r\n\t\t_physicsCreatedCount = 0;\r\n\t\t_skippedInsideCount = 0;\r\n\t\t_subdividedCount = 0;\r\n\r\n\t\t// Traverse the octree synchronously to collect candidate boxes.\r\n\t\tvar pending = new List\u003CBBox\u003E();\r\n\r\n\t\tCollectPhysicsNodes(GetLocalBakeBox(), 0, pending);\r\n\r\n\t\t// Create volumes with an editor progress bar.\r\n\t\tvar container = GetOrCreateBakedContainer();\r\n\r\n\t\tawait Application.Editor.ForEachAsync(pending, \u0022Baking Water Volumes\u0022, async (box, ct) =\u003E\r\n\t\t{\r\n\t\t\tif (CreateWaterBody(container, box))\r\n\t\t\t\t_physicsCreatedCount\u002B\u002B;\r\n\r\n\t\t\tawait Task.Delay(1, ct);\r\n\t\t});\r\n\r\n\t\tLog.Info($\u0022{nameof(WaterQuadBaker)}: baked {_physicsCreatedCount} water volume set(s), skipped {_skippedInsideCount} node(s), subdivided {_subdividedCount} node(s).\u0022);\r\n\t}\r\n\r\n\r\n\r\n\t[Button]\r\n\tprivate void ClearBaked()\r\n\t{\r\n\t\tFindBakedContainer()?.Destroy();\r\n\t}\r\n\r\n\r\n\r\n\tprotected override void DrawGizmos()\r\n\t{\r\n\t\tif (!Gizmo.IsSelected)\r\n\t\t\treturn;\r\n\r\n\t\tGizmo.Draw.Color = Color.Green;\r\n\t\tGizmo.Draw.LineBBox(GetLocalBakeBox());\r\n\r\n\t\tGizmo.Draw.Color = Color.Blue;\r\n\r\n\t\tforeach (var waterBody in GetComponentsInChildren\u003CWaterBody\u003E())\r\n\t\t{\r\n\t\t\tvar (center, forward, up, half) = waterBody.GetWorldOBB();\r\n\r\n\t\t\tGizmo.Draw.LineBBox(BBox.FromPositionAndSize(center, half * 2));\r\n\t\t}\r\n\t}\r\n\r\n\r\n\r\n\tprivate void CacheSceneGeometry()\r\n\t{\r\n\t\t_terrains.Clear();\r\n\t\t_solidColliders.Clear();\r\n\r\n\t\tforeach (var terrain in Scene.GetAllComponents\u003CTerrain\u003E())\r\n\t\t{\r\n\t\t\tif (!terrain.IsValid() || !terrain.Enabled || !terrain.Active || !terrain.EnableCollision || terrain.Storage is null)\r\n\t\t\t\tcontinue;\r\n\r\n\t\t\t_terrains.Add(terrain);\r\n\t\t\t_solidColliders.Add(terrain);\r\n\t\t}\r\n\r\n\t\tforeach (var collider in Scene.GetAllComponents\u003CCollider\u003E())\r\n\t\t{\r\n\t\t\tif (!collider.IsValid() || !collider.Enabled || !collider.Active || collider.IsTrigger)\r\n\t\t\t\tcontinue;\r\n\r\n\t\t\tif (collider.GameObject.Tags.Has(BakedTag))\r\n\t\t\t\tcontinue;\r\n\t\t\t\r\n\t\t\tif (ExcludeMeshGeometry \u0026\u0026 collider is not Terrain)\r\n\t\t\t\tcontinue;\r\n\r\n\t\t\t_solidColliders.Add(collider);\r\n\t\t}\r\n\r\n\t\t_insideTraceDistance = Math.Max(BakeSizeXY.Length * 2.0f, 10000.0f);\r\n\t}\r\n\r\n\r\n\r\n\tprivate void CollectPhysicsNodes(BBox _LocalBox, int _Depth, List\u003CBBox\u003E _Pending)\r\n\t{\r\n\t\tvar sample = ClassifyNode(_LocalBox);\r\n\r\n\t\tbool terrainRejected = sample.TerrainAllInside || (sample.TerrainMixed \u0026\u0026 !sample.MeshHasAny);\r\n\t\tbool meshRejected = sample.MeshAllInside;\r\n\t\tbool overlapsNonTerrainSolid = BoxOverlapsNonTerrainSolid(_LocalBox);\r\n\r\n\t\tif (meshRejected)\r\n\t\t{\r\n\t\t\t_skippedInsideCount\u002B\u002B;\r\n\r\n\t\t\treturn;\r\n\t\t}\r\n\r\n\t\tif (terrainRejected)\r\n\t\t{\r\n\t\t\tif (TryHandleCoastalNode(_LocalBox, _Depth, _Pending, sample))\r\n\t\t\t\treturn;\r\n\r\n\t\t\t_skippedInsideCount\u002B\u002B;\r\n\r\n\t\t\treturn;\r\n\t\t}\r\n\r\n\t\tbool shouldSubdivide = sample.MeshMixed || sample.TerrainMixed || overlapsNonTerrainSolid;\r\n\r\n\t\tif (shouldSubdivide \u0026\u0026 CanSubdivide(_LocalBox, _Depth))\r\n\t\t{\r\n\t\t\t_subdividedCount\u002B\u002B;\r\n\r\n\t\t\tforeach (var child in Subdivide(_LocalBox))\r\n\t\t\t\tCollectPhysicsNodes(child, _Depth \u002B 1, _Pending);\r\n\r\n\t\t\treturn;\r\n\t\t}\r\n\r\n\t\tif (shouldSubdivide)\r\n\t\t{\r\n\t\t\t_skippedInsideCount\u002B\u002B;\r\n\r\n\t\t\treturn;\r\n\t\t}\r\n\r\n\t\t_Pending.Add(_LocalBox);\r\n\t}\r\n\r\n\r\n\r\n\tprivate SampleSummary ClassifyNode(BBox _LocalBox)\r\n\t{\r\n\t\tint total = 0;\r\n\t\tint terrainInside = 0;\r\n\t\tint meshInside = 0;\r\n\r\n\t\tforeach (var localPoint in EnumerateSamplePoints(_LocalBox))\r\n\t\t{\r\n\t\t\ttotal\u002B\u002B;\r\n\r\n\t\t\tvar worldPoint = WorldTransform.PointToWorld(localPoint);\r\n\r\n\t\t\tif (IsPointInsideTerrainOnly(worldPoint))\r\n\t\t\t\tterrainInside\u002B\u002B;\r\n\r\n\t\t\tif (IsPointInsideSolidMeshOnly(worldPoint))\r\n\t\t\t\tmeshInside\u002B\u002B;\r\n\t\t}\r\n\r\n\t\treturn new SampleSummary\r\n\t\t{\r\n\t\t\tTotal = total,\r\n\t\t\tTerrainInside = terrainInside,\r\n\t\t\tMeshInside = meshInside\r\n\t\t};\r\n\t}\r\n\r\n\r\n\r\n\tprivate bool TryHandleCoastalNode(BBox _LocalBox, int _Depth, List\u003CBBox\u003E _Pending, SampleSummary _Sample)\r\n\t{\r\n\t\tif (!EnableCoastalFill || _Sample.MeshHasAny)\r\n\t\t\treturn false;\r\n\r\n\t\tfloat maxSize = Math.Max(_LocalBox.Size.x, _LocalBox.Size.y);\r\n\r\n\t\tif (maxSize \u003E CoastalFillMaxCellSize)\r\n\t\t{\r\n\t\t\t_subdividedCount\u002B\u002B;\r\n\r\n\t\t\tforeach (var child in Subdivide(_LocalBox))\r\n\t\t\t\tCollectPhysicsNodes(child, _Depth \u002B 1, _Pending);\r\n\r\n\t\t\treturn true;\r\n\t\t}\r\n\r\n\t\tif (IsCellTooFarInland(_LocalBox))\r\n\t\t\treturn false;\r\n\r\n\t\t_Pending.Add(_LocalBox);\r\n\r\n\t\treturn true;\r\n\t}\r\n\r\n\r\n\r\n\tprivate bool IsCellTooFarInland(BBox _LocalBox)\r\n\t{\r\n\t\tint inlandCount = 0;\r\n\t\tint total = 0;\r\n\r\n\t\tforeach (var localPoint in EnumerateXYSamplePoints(_LocalBox))\r\n\t\t{\r\n\t\t\ttotal\u002B\u002B;\r\n\r\n\t\t\tvar worldPoint = WorldTransform.PointToWorld(localPoint);\r\n\r\n\t\t\tif (IsInlandAtXY(worldPoint))\r\n\t\t\t\tinlandCount\u002B\u002B;\r\n\t\t}\r\n\r\n\t\treturn total \u003E 0 \u0026\u0026 ((float)inlandCount / total) \u003E= CoastalFillInlandThreshold;\r\n\t}\r\n\r\n\r\n\r\n\tprivate bool IsInlandAtXY(Vector3 _WorldPoint)\r\n\t{\r\n\t\tif (!IsLandAtXY(_WorldPoint))\r\n\t\t\treturn false;\r\n\r\n\t\tif (CoastalFillPenetrationDistance \u003C= 0.0f)\r\n\t\t\treturn true;\r\n\r\n\t\tVector3[] offsets =\r\n\t\t[\r\n\t\t\tVector3.Right * CoastalFillPenetrationDistance,\r\n\t\t\tVector3.Left * CoastalFillPenetrationDistance,\r\n\t\t\tVector3.Forward * CoastalFillPenetrationDistance,\r\n\t\t\tVector3.Backward * CoastalFillPenetrationDistance\r\n\t\t];\r\n\r\n\t\tforeach (var offset in offsets)\r\n\t\t{\r\n\t\t\tif (!IsLandAtXY(_WorldPoint \u002B offset))\r\n\t\t\t\treturn false;\r\n\t\t}\r\n\r\n\t\treturn true;\r\n\t}\r\n\r\n\r\n\r\n\tprivate bool IsLandAtXY(Vector3 _WorldPoint)\r\n\t{\r\n\t\tforeach (var terrain in _terrains)\r\n\t\t{\r\n\t\t\tif (TryGetTerrainSurfaceWorldHeight(terrain, _WorldPoint, out var worldHeight) \u0026\u0026 IsTerrainHeightBlocking(worldHeight))\r\n\t\t\t\treturn true;\r\n\t\t}\r\n\r\n\t\treturn false;\r\n\t}\r\n\r\n\r\n\r\n\tprivate bool IsPointInsideTerrainOnly(Vector3 _WorldPoint)\r\n\t{\r\n\t\tforeach (var terrain in _terrains)\r\n\t\t{\r\n\t\t\tif (TryGetTerrainSurfaceWorldHeight(terrain, _WorldPoint, out var worldHeight) \u0026\u0026 IsTerrainHeightBlocking(worldHeight))\r\n\t\t\t{\r\n\t\t\t\tif (_WorldPoint.z \u003C= worldHeight \u002B TerrainPadding)\r\n\t\t\t\t\treturn true;\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\treturn false;\r\n\t}\r\n\r\n\r\n\r\n\tprivate bool IsTerrainHeightBlocking(float _SampledWorldHeight)\r\n\t{\r\n\t\tif (IgnoreTerrainBelowWaterSurface \u0026\u0026 _SampledWorldHeight \u003C= WaterSurfaceZ - TerrainDepthIgnoreDistance)\r\n\t\t\treturn false;\r\n\r\n\t\treturn _SampledWorldHeight \u003E= WaterSurfaceZ \u002B TerrainPadding;\r\n\t}\r\n\r\n\r\n\r\n\tprivate bool IsPointInsideSolidMeshOnly(Vector3 _WorldPoint)\r\n\t{\r\n\t\tif (ExcludeMeshGeometry)\r\n\t\t\treturn false;\r\n\t\t\r\n\t\tvar probe = Scene.Trace\r\n\t\t\t.Sphere(SolidProbeRadius, _WorldPoint, _WorldPoint)\r\n\t\t\t.WithoutTags(BakedTag)\r\n\t\t\t.Run();\r\n\r\n\t\tif (probe.StartedSolid \u0026\u0026 probe.Collider is not Terrain)\r\n\t\t\treturn true;\r\n\r\n\t\tint oddAxes = 0;\r\n\r\n\t\tif (HasOddHitCount(_WorldPoint, Vector3.Right)) oddAxes\u002B\u002B;\r\n\t\tif (HasOddHitCount(_WorldPoint, Vector3.Forward)) oddAxes\u002B\u002B;\r\n\t\tif (HasOddHitCount(_WorldPoint, Vector3.Up)) oddAxes\u002B\u002B;\r\n\r\n\t\treturn oddAxes \u003E= 2;\r\n\t}\r\n\r\n\r\n\r\n\tprivate bool HasOddHitCount(Vector3 _Start, Vector3 _Direction)\r\n\t{\r\n\t\tif (ExcludeMeshGeometry)\r\n\t\t\treturn false;\r\n\t\t\r\n\t\tvar end = _Start \u002B _Direction.Normal * _insideTraceDistance;\r\n\r\n\t\tvar hits = Scene.Trace\r\n\t\t\t.Ray(_Start, end)\r\n\t\t\t.WithoutTags(BakedTag)\r\n\t\t\t.RunAll();\r\n\r\n\t\tint hitCount = 0;\r\n\t\tCollider lastCollider = null;\r\n\t\tfloat lastFraction = -10.0f;\r\n\r\n\t\tforeach (var hit in hits)\r\n\t\t{\r\n\t\t\tif (!hit.Hit || hit.Collider is null)\r\n\t\t\t\tcontinue;\r\n\r\n\t\t\tif (!_solidColliders.Contains(hit.Collider) || hit.Collider is Terrain)\r\n\t\t\t\tcontinue;\r\n\r\n\t\t\tif (hit.Collider == lastCollider \u0026\u0026 Math.Abs(hit.Fraction - lastFraction) \u003C 0.0001f)\r\n\t\t\t\tcontinue;\r\n\r\n\t\t\tlastCollider = hit.Collider;\r\n\t\t\tlastFraction = hit.Fraction;\r\n\t\t\thitCount\u002B\u002B;\r\n\t\t}\r\n\r\n\t\treturn (hitCount \u0026 1) == 1;\r\n\t}\r\n\r\n\r\n\r\n\tprivate bool BoxOverlapsNonTerrainSolid(BBox _LocalBox)\r\n\t{\r\n\t\tif (ExcludeMeshGeometry)\r\n\t\t\treturn false;\r\n\t\t\r\n\t\tvar center = WorldTransform.PointToWorld(_LocalBox.Center);\r\n\r\n\t\tvar hits = Scene.Trace\r\n\t\t\t.Box(_LocalBox.Size, center, center)\r\n\t\t\t.Rotated(WorldRotation)\r\n\t\t\t.WithoutTags(BakedTag)\r\n\t\t\t.RunAll();\r\n\r\n\t\tforeach (var hit in hits)\r\n\t\t{\r\n\t\t\tif (hit.Hit \u0026\u0026 hit.Collider is not null \u0026\u0026 hit.Collider is not Terrain)\r\n\t\t\t\treturn true;\r\n\t\t}\r\n\r\n\t\treturn false;\r\n\t}\r\n\r\n\r\n\r\n\tprivate static bool TryGetTerrainSurfaceWorldHeight(Terrain _Terrain, Vector3 _WorldPoint, out float _SampledWorldHeight)\r\n\t{\r\n\t\t_SampledWorldHeight = 0.0f;\r\n\r\n\t\tvar storage = _Terrain.Storage;\r\n\r\n\t\tif (storage is null || storage.HeightMap is null || storage.ControlMap is null || storage.Resolution \u003C= 1)\r\n\t\t\treturn false;\r\n\r\n\t\tvar localPoint = _Terrain.WorldTransform.PointToLocal(_WorldPoint);\r\n\r\n\t\tif (localPoint.x \u003C 0.0f || localPoint.y \u003C 0.0f || localPoint.x \u003E storage.TerrainSize || localPoint.y \u003E storage.TerrainSize)\r\n\t\t\treturn false;\r\n\r\n\t\tint resolution = storage.Resolution;\r\n\t\tfloat gridX = (localPoint.x / storage.TerrainSize) * (resolution - 1);\r\n\t\tfloat gridY = (localPoint.y / storage.TerrainSize) * (resolution - 1);\r\n\r\n\t\tint x0 = (int)MathF.Floor(gridX).Clamp(0, resolution - 1);\r\n\t\tint y0 = (int)MathF.Floor(gridY).Clamp(0, resolution - 1);\r\n\t\tint x1 = (x0 \u002B 1).Clamp(0, resolution - 1);\r\n\t\tint y1 = (y0 \u002B 1).Clamp(0, resolution - 1);\r\n\r\n\t\tvar control = new CompactTerrainMaterial(storage.ControlMap[x0 \u002B y0 * resolution]);\r\n\r\n\t\tif (control.IsHole)\r\n\t\t\treturn false;\r\n\r\n\t\tfloat tx = gridX - x0;\r\n\t\tfloat ty = gridY - y0;\r\n\t\tfloat h00 = storage.HeightMap[x0 \u002B y0 * resolution];\r\n\t\tfloat h10 = storage.HeightMap[x1 \u002B y0 * resolution];\r\n\t\tfloat h01 = storage.HeightMap[x0 \u002B y1 * resolution];\r\n\t\tfloat h11 = storage.HeightMap[x1 \u002B y1 * resolution];\r\n\t\tfloat hx0 = MathX.Lerp(h00, h10, tx);\r\n\t\tfloat hx1 = MathX.Lerp(h01, h11, tx);\r\n\t\tfloat sampledLocalHeight = MathX.Lerp(hx0, hx1, ty) * (storage.TerrainHeight / ushort.MaxValue);\r\n\r\n\t\t_SampledWorldHeight = _Terrain.WorldTransform.PointToWorld(new Vector3(localPoint.x, localPoint.y, sampledLocalHeight)).z;\r\n\r\n\t\treturn true;\r\n\t}\r\n\r\n\r\n\r\n\tprivate static IEnumerable\u003CVector3\u003E EnumerateSamplePoints(BBox _LocalBox)\r\n\t{\r\n\t\tfor (int ix = 0; ix \u003C 3; ix\u002B\u002B)\r\n\t\t\tfor (int iy = 0; iy \u003C 3; iy\u002B\u002B)\r\n\t\t\t\tfor (int iz = 0; iz \u003C 3; iz\u002B\u002B)\r\n\t\t\t\t{\r\n\t\t\t\t\tyield return new Vector3(\r\n\t\t\t\t\t\tMathX.Lerp(_LocalBox.Mins.x, _LocalBox.Maxs.x, ix * 0.5f),\r\n\t\t\t\t\t\tMathX.Lerp(_LocalBox.Mins.y, _LocalBox.Maxs.y, iy * 0.5f),\r\n\t\t\t\t\t\tMathX.Lerp(_LocalBox.Mins.z, _LocalBox.Maxs.z, iz * 0.5f)\r\n\t\t\t\t\t);\r\n\t\t\t\t}\r\n\t}\r\n\r\n\r\n\r\n\tprivate static IEnumerable\u003CVector3\u003E EnumerateXYSamplePoints(BBox _LocalBox)\r\n\t{\r\n\t\tfloat z = _LocalBox.Center.z;\r\n\r\n\t\tfor (int ix = 0; ix \u003C 5; ix\u002B\u002B)\r\n\t\t\tfor (int iy = 0; iy \u003C 5; iy\u002B\u002B)\r\n\t\t\t{\r\n\t\t\t\tyield return new Vector3(\r\n\t\t\t\t\tMathX.Lerp(_LocalBox.Mins.x, _LocalBox.Maxs.x, ix / 4.0f),\r\n\t\t\t\t\tMathX.Lerp(_LocalBox.Mins.y, _LocalBox.Maxs.y, iy / 4.0f),\r\n\t\t\t\t\tz\r\n\t\t\t\t);\r\n\t\t\t}\r\n\t}\r\n\r\n\r\n\r\n\tprivate bool CanSubdivide(BBox _LocalBox, int _Depth)\r\n\t{\r\n\t\tif (_Depth \u003E= MaxDepth)\r\n\t\t\treturn false;\r\n\r\n\t\tvar size = _LocalBox.Size;\r\n\r\n\t\treturn size.x \u003E MinCellSize || size.y \u003E MinCellSize;\r\n\t}\r\n\r\n\r\n\r\n\tprivate static IEnumerable\u003CBBox\u003E Subdivide(BBox _LocalBox)\r\n\t{\r\n\t\tvar center = _LocalBox.Center;\r\n\t\tvar mins = _LocalBox.Mins;\r\n\t\tvar maxs = _LocalBox.Maxs;\r\n\r\n\t\tfor (int ix = 0; ix \u003C 2; ix\u002B\u002B)\r\n\t\t\tfor (int iy = 0; iy \u003C 2; iy\u002B\u002B)\r\n\t\t\t{\r\n\t\t\t\tyield return new BBox(\r\n\t\t\t\t\tnew Vector3(ix == 0 ? mins.x : center.x, iy == 0 ? mins.y : center.y, mins.z),\r\n\t\t\t\t\tnew Vector3(ix == 0 ? center.x : maxs.x, iy == 0 ? center.y : maxs.y, maxs.z)\r\n\t\t\t\t);\r\n\t\t\t}\r\n\t}\r\n\r\n\r\n\r\n\tprivate bool CreateWaterBody(GameObject _Container, BBox _LocalBox)\r\n\t{\r\n\t\tfloat width = _LocalBox.Size.x - QuadInset * 2.0f;\r\n\t\tfloat length = _LocalBox.Size.y - QuadInset * 2.0f;\r\n\r\n\t\tif (width \u003C= 1.0f || length \u003C= 1.0f)\r\n\t\t\treturn false;\r\n\r\n\t\tvar go = new GameObject(_Container, true, \u0022Water Volume\u0022);\r\n\t\tgo.Tags.Add(BakedTag);\r\n\r\n\t\tvar worldPoint = WorldTransform.PointToWorld(_LocalBox.Center);\r\n\r\n\t\tgo.WorldPosition = new Vector3(worldPoint.x, worldPoint.y, WaterSurfaceZ - WaterDepth * 0.5f);\r\n\t\tgo.WorldRotation = WorldRotation;\r\n\t\tgo.WorldScale = 1.0f;\r\n\r\n\t\tvar bounds = new BBox\r\n\t\t(\r\n\t\t\tnew Vector3(-width * 0.5f, -length * 0.5f, -WaterDepth * 0.5f),\r\n\t\t\tnew Vector3(width * 0.5f, length * 0.5f, WaterDepth * 0.5f)\r\n\t\t);\r\n\r\n\t\tvar body = go.GetOrAddComponent\u003CWaterBody\u003E();\r\n\t\tbody.SetBounds(bounds);\r\n\t\tbody.WaterType = WaterType;\r\n\r\n\t\tif (Soundscape)\r\n\t\t\tCreateSoundscapeTrigger(go, width, length);\r\n\r\n\t\treturn true;\r\n\t}\r\n\r\n\r\n\r\n\tprivate void CreateSoundscapeTrigger(GameObject _Parent, float _Width, float _Length)\r\n\t{\r\n\t\tvar finalExtents = new Vector3(_Width * 0.5f, _Length * 0.5f, (WaterDepth * 0.5f) \u002B SoundscapeExtraHeight);\r\n\r\n\t\tif (finalExtents.x \u003C= 1.0f || finalExtents.y \u003C= 1.0f || finalExtents.z \u003C= 1.0f)\r\n\t\t\treturn;\r\n\r\n\t\tvar go = new GameObject(_Parent, true, \u0022Water Soundscape\u0022);\r\n\t\tgo.Tags.Add(BakedTag);\r\n\t\tgo.LocalPosition = Vector3.Zero.WithZ(SoundscapeExtraHeight);\r\n\t\tgo.LocalRotation = Rotation.Identity;\r\n\t\tgo.LocalScale = 1.0f;\r\n\r\n\t\tvar trigger = go.GetOrAddComponent\u003CSoundscapeTrigger\u003E();\r\n\t\ttrigger.Type = SoundscapeTrigger.TriggerType.Box;\r\n\t\ttrigger.Soundscape = SoundscapeAsset;\r\n\t\ttrigger.TargetMixer = SoundscapeTargetMixer;\r\n\t\ttrigger.StayActiveOnExit = SoundscapeStayActiveOnExit;\r\n\t\ttrigger.Volume = SoundscapeVolume;\r\n\t\ttrigger.BoxSize = finalExtents;\r\n\t}\r\n\r\n\r\n\r\n\tprivate BBox GetLocalBakeBox()\r\n\t{\r\n\t\tfloat minZ = WaterSurfaceZ - WaterDepth;\r\n\t\tfloat maxZ = WaterSurfaceZ;\r\n\r\n\t\tvar mins = new Vector3(-BakeSizeXY.x * 0.5f, -BakeSizeXY.y * 0.5f, minZ);\r\n\t\tvar maxs = new Vector3(BakeSizeXY.x * 0.5f, BakeSizeXY.y * 0.5f, maxZ);\r\n\r\n\t\treturn new BBox(mins, maxs);\r\n\t}\r\n\r\n\r\n\r\n\tprivate GameObject GetOrCreateBakedContainer()\r\n\t{\r\n\t\tvar existing = FindBakedContainer();\r\n\r\n\t\tif (existing.IsValid())\r\n\t\t\treturn existing;\r\n\r\n\t\tvar container = new GameObject(GameObject, true, BakedContainerName);\r\n\t\tcontainer.Tags.Add(\u0022container\u0022);\r\n\t\tcontainer.Tags.Add(BakedTag);\r\n\t\tcontainer.LocalPosition = Vector3.Zero;\r\n\t\tcontainer.LocalRotation = Rotation.Identity;\r\n\t\tcontainer.LocalScale = 1.0f;\r\n\r\n\t\treturn container;\r\n\t}\r\n\r\n\r\n\r\n\tprivate GameObject FindBakedContainer()\r\n\t{\r\n\t\treturn GameObject.Children.FirstOrDefault(child =\u003E child.IsValid() \u0026\u0026 child.Tags.Has(\u0022container\u0022));\r\n\t}\r\n\r\n\r\n\r\n\tprivate struct SampleSummary\r\n\t{\r\n\t\tpublic int Total;\r\n\t\tpublic int TerrainInside;\r\n\t\tpublic int MeshInside;\r\n\r\n\t\tpublic bool TerrainAllInside =\u003E Total \u003E 0 \u0026\u0026 TerrainInside == Total;\r\n\t\tpublic bool TerrainMixed =\u003E TerrainInside \u003E 0 \u0026\u0026 TerrainInside \u003C Total;\r\n\t\tpublic bool MeshAllInside =\u003E Total \u003E 0 \u0026\u0026 MeshInside == Total;\r\n\t\tpublic bool MeshHasAny =\u003E MeshInside \u003E 0;\r\n\t\tpublic bool TerrainHasAny =\u003E TerrainInside \u003E 0;\r\n\t\tpublic bool MeshMixed =\u003E MeshInside \u003E 0 \u0026\u0026 MeshInside \u003C Total;\r\n\t}\r\n}\r\n"},{"Ident":"redsnail.watertool","Path":"Code/Water/WaterRippleEmitter.cs","FileName":"WaterRippleEmitter.cs","PackageType":"library","CodeKind":"Game","AssetVersionId":342768,"Code":"using Sandbox;\n\nnamespace RedSnail.WaterTool;\n\n/// \u003Csummary\u003E\n/// Emits water ripples when this object crosses the water surface, and optionally\n/// while it moves across it. A generic, dependency-free alternative to the entry\n/// ripple built into \u003Csee cref=\u0022Buoyancy\u0022/\u003E \u2014 drop it on anything that doesn\u0027t have\n/// a Buoyancy component (players, NPCs, projectiles, debris...).\n///\n/// Velocity is derived from the object\u0027s own position delta, so it works with any\n/// movement system (CharacterController, custom controllers, animation, etc.) and\n/// needs no Rigidbody.\n/// \u003C/summary\u003E\n[Icon(\u0022water\u0022), Group(\u0022Water\u0022), Title(\u0022Water Ripple Emitter\u0022)]\npublic sealed class WaterRippleEmitter : Component\n{\n\t[Property, Group(\u0022Entry\u0022)] public bool EmitOnEntry { get; set; } = true;\n\t[Property, Group(\u0022Entry\u0022)] public float EntryStrength { get; set; } = 0.2f;\n\t// Ring spacing for the entry splash \u2014 smaller = tighter, more concentric rings.\n\t[Property, Group(\u0022Entry\u0022), Range(20.0f, 400.0f)] public float EntryWavelength { get; set; } = 120.0f;\n\t// Ring size for the entry splash \u2014 larger = a bigger, broader ripple.\n\t[Property, Group(\u0022Entry\u0022), Range(10.0f, 500.0f)] public float EntryRingWidth { get; set; } = 50.0f;\n\t// Minimum downward speed (units/s) needed to splash. Set to 0 to ripple on any crossing.\n\t[Property, Group(\u0022Entry\u0022)] public float MinImpactSpeed { get; set; } = 40.0f;\n\n\t[Property, Group(\u0022Wake\u0022)] public bool EmitWake { get; set; } = false;\n\t[Property, Group(\u0022Wake\u0022)] public float WakeStrength { get; set; } = 0.1f;\n\t// Ring spacing for wake ripples \u2014 smaller = tighter, more concentric rings.\n\t[Property, Group(\u0022Wake\u0022), Range(20.0f, 400.0f)] public float WakeWavelength { get; set; } = 120.0f;\n\t// Ring size for wake ripples \u2014 larger = a bigger, broader ripple.\n\t[Property, Group(\u0022Wake\u0022), Range(10.0f, 500.0f)] public float WakeRingWidth { get; set; } = 50.0f;\n\t// Minimum horizontal speed (units/s) before a moving object leaves a wake.\n\t[Property, Group(\u0022Wake\u0022)] public float WakeMinSpeed { get; set; } = 1.0f;\n\t[Property, Group(\u0022Wake\u0022)] public float WakeInterval { get; set; } = 0.0333f; // 30 fps\n\n\t// Local-space offset of the point tested against the surface (e.g. the feet).\n\t[Property, Group(\u0022General\u0022)] public Vector3 SampleOffset { get; set; } = Vector3.Zero;\n\n\tprivate bool m_Initialized;\n\tprivate bool m_WasBelowSurface;\n\tprivate Vector3 m_LastPosition;\n\tprivate float m_WakeTimer;\n\n\tprivate Vector3 SamplePosition =\u003E WorldPosition \u002B WorldRotation * SampleOffset;\n\n\n\n\tprotected override void OnEnabled()\n\t{\n\t\tm_LastPosition = SamplePosition;\n\t\tm_WasBelowSurface = false;\n\t\tm_Initialized = false;\n\t}\n\n\n\n\tprotected override void OnUpdate()\n\t{\n\t\t// If this gameobject is parented to anything, we don\u0027t want to play water ripple effects\n\t\t// (e.g. A player inside a boat)\n\t\tif (GameObject.Parent != Scene)\n\t\t\treturn;\n\t\t\n\t\tVector3 samplePos = SamplePosition;\n\n\t\t// Velocity from position delta \u2014 no Rigidbody required\n\t\tVector3 velocity = Time.Delta \u003E 0.0f ? (samplePos - m_LastPosition) / Time.Delta : Vector3.Zero;\n\t\tm_LastPosition = samplePos;\n\n\t\tfloat waterHeight = WaterManager.GetWaterHeightAt(samplePos);\n\n\t\t// Not over any water surface\n\t\tif (waterHeight \u003C= float.MinValue)\n\t\t{\n\t\t\tm_WasBelowSurface = false;\n\t\t\treturn;\n\t\t}\n\n\t\tbool belowSurface = samplePos.z \u003C= waterHeight;\n\n\t\t// Skip the first valid frame so an object spawned already in water doesn\u0027t splash\n\t\tif (!m_Initialized)\n\t\t{\n\t\t\tm_WasBelowSurface = belowSurface;\n\t\t\tm_Initialized = true;\n\t\t\treturn;\n\t\t}\n\n\t\t// Entry splash on the above -\u003E below surface crossing\n\t\tif (EmitOnEntry \u0026\u0026 belowSurface \u0026\u0026 !m_WasBelowSurface)\n\t\t{\n\t\t\tfloat impactSpeed = float.Max(0.0f, -velocity.z);\n\n\t\t\tif (impactSpeed \u003E= MinImpactSpeed)\n\t\t\t{\n\t\t\t\tfloat strength = (impactSpeed / 150.0f).Clamp(0.3f, 2.5f) * EntryStrength;\n\t\t\t\t\n\t\t\t\tWaterManager.AddRipple(samplePos.WithZ(waterHeight), strength, EntryWavelength, EntryRingWidth);\n\t\t\t}\n\t\t}\n\n\t\tm_WasBelowSurface = belowSurface;\n\n\t\tfloat horizontalSpeed = velocity.WithZ(0.0f).Length;\n\t\t\n\t\t// Continuous wake while skimming/swimming through the surface\n\t\tif (EmitWake \u0026\u0026 belowSurface)\n\t\t{\n\t\t\tif (horizontalSpeed \u003E= WakeMinSpeed)\n\t\t\t{\n\t\t\t\tm_WakeTimer -= Time.Delta;\n\n\t\t\t\tif (m_WakeTimer \u003C= 0.0f)\n\t\t\t\t{\n\t\t\t\t\tWaterManager.AddRipple(samplePos.WithZ(waterHeight), WakeStrength, WakeWavelength, WakeRingWidth);\n\t\t\t\t\tm_WakeTimer = WakeInterval;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n}\n"},{"Ident":"redsnail.watertool","Path":"Code/Water/WaterWaveUtility.cs","FileName":"WaterWaveUtility.cs","PackageType":"library","CodeKind":"Game","AssetVersionId":342768,"Code":"using System;\r\nusing Sandbox;\r\n\r\nnamespace RedSnail.WaterTool;\r\n\r\npublic enum WaterBodyType\r\n{\r\n\tOcean,\r\n\tLake,\r\n\tRiver,\r\n\tPool,\r\n\tCustom\r\n}\r\n\r\npublic static class WaterWaveUtility\r\n{\r\n\tpublic static Vector3 ComputeDisplacementAt(Vector2 worldXY, WaterDefinition profile)\r\n\t{\r\n\t\tVector3 detail = ComputeGerstner(worldXY, profile.WavesScale, profile.WavesSpeed, profile.WavesDirection, profile.WavesOctaves, profile.WavesLacunarity, profile.WavesPersistence, profile.WavesSteepness) * profile.WavesIntensity;\r\n\t\tVector3 swell = ComputeGerstner(worldXY, profile.SwellScale, profile.SwellSpeed, profile.SwellDirection, profile.SwellOctaves, profile.SwellLacunarity, profile.SwellPersistence, profile.SwellSteepness) * profile.SwellIntensity;\r\n\t\treturn detail \u002B swell;\r\n\t}\r\n\r\n\tpublic static Vector3 ComputeVelocityAt(Vector2 worldXY, WaterDefinition profile)\r\n\t{\r\n\t\tVector3 detail = ComputeGerstnerVelocity(worldXY, profile.WavesScale, profile.WavesSpeed, profile.WavesDirection, profile.WavesOctaves, profile.WavesLacunarity, profile.WavesPersistence, profile.WavesSteepness) * profile.WavesIntensity;\r\n\t\tVector3 swell = ComputeGerstnerVelocity(worldXY, profile.SwellScale, profile.SwellSpeed, profile.SwellDirection, profile.SwellOctaves, profile.SwellLacunarity, profile.SwellPersistence, profile.SwellSteepness) * profile.SwellIntensity;\r\n\t\treturn detail \u002B swell;\r\n\t}\r\n\r\n\tprivate static Vector3 ComputeGerstner(Vector2 worldXY, float scale, float speed, Vector2 direction, int octaves, float lacunarity, float persistence, float steepness)\r\n\t{\r\n\t\tif (scale \u003C= 0.0f || speed \u003C= 0.0f || octaves \u003C= 0)\r\n\t\t\treturn Vector3.Zero;\r\n\r\n\t\tVector2 waveDirection = direction.Normal;\r\n\t\tfloat t = Time.Now * speed;\r\n\r\n\t\tVector3 displacement = Vector3.Zero;\r\n\t\tfloat amp = 1.0f;\r\n\t\tfloat freq = scale;\r\n\t\tfloat maxAmp = 0f;\r\n\r\n\t\tfor (int oct = 0; oct \u003C octaves; oct\u002B\u002B)\r\n\t\t{\r\n\t\t\tfloat angle = oct * 1.2f;\r\n\t\t\tVector2 octDir = new(\r\n\t\t\t\twaveDirection.x * MathF.Cos(angle) - waveDirection.y * MathF.Sin(angle),\r\n\t\t\t\twaveDirection.x * MathF.Sin(angle) \u002B waveDirection.y * MathF.Cos(angle)\r\n\t\t\t);\r\n\r\n\t\t\tfloat phase = freq * (octDir.x * worldXY.x \u002B octDir.y * worldXY.y) \u002B t * freq * 0.5f;\r\n\t\t\tdisplacement.x \u002B= steepness * amp * octDir.x * MathF.Cos(phase);\r\n\t\t\tdisplacement.y \u002B= steepness * amp * octDir.y * MathF.Cos(phase);\r\n\t\t\tdisplacement.z \u002B= amp * MathF.Sin(phase);\r\n\r\n\t\t\tmaxAmp \u002B= amp;\r\n\t\t\tamp *= persistence;\r\n\t\t\tfreq *= lacunarity;\r\n\t\t}\r\n\r\n\t\treturn maxAmp \u003E 0.0f ? displacement / maxAmp : Vector3.Zero;\r\n\t}\r\n\r\n\tprivate static Vector3 ComputeGerstnerVelocity(Vector2 worldXY, float scale, float speed, Vector2 direction, int octaves, float lacunarity, float persistence, float steepness)\r\n\t{\r\n\t\tif (scale \u003C= 0.0f || speed \u003C= 0.0f || octaves \u003C= 0)\r\n\t\t\treturn Vector3.Zero;\r\n\r\n\t\tVector2 waveDirection = direction.Normal;\r\n\t\tfloat t = Time.Now * speed;\r\n\r\n\t\tVector3 velocity = Vector3.Zero;\r\n\t\tfloat amp = 1.0f;\r\n\t\tfloat freq = scale;\r\n\t\tfloat maxAmp = 0f;\r\n\r\n\t\tfor (int oct = 0; oct \u003C octaves; oct\u002B\u002B)\r\n\t\t{\r\n\t\t\tfloat angle = oct * 1.2f;\r\n\t\t\tVector2 octDir = new(\r\n\t\t\t\twaveDirection.x * MathF.Cos(angle) - waveDirection.y * MathF.Sin(angle),\r\n\t\t\t\twaveDirection.x * MathF.Sin(angle) \u002B waveDirection.y * MathF.Cos(angle)\r\n\t\t\t);\r\n\r\n\t\t\tfloat phase = freq * (octDir.x * worldXY.x \u002B octDir.y * worldXY.y) \u002B t * freq * 0.5f;\r\n\t\t\tfloat angularVelocity = freq * speed * 0.5f;\r\n\r\n\t\t\tvelocity.x -= steepness * amp * octDir.x * angularVelocity * MathF.Sin(phase);\r\n\t\t\tvelocity.y -= steepness * amp * octDir.y * angularVelocity * MathF.Sin(phase);\r\n\t\t\tvelocity.z \u002B= amp * angularVelocity * MathF.Cos(phase);\r\n\r\n\t\t\tmaxAmp \u002B= amp;\r\n\t\t\tamp *= persistence;\r\n\t\t\tfreq *= lacunarity;\r\n\t\t}\r\n\r\n\t\treturn maxAmp \u003E 0.0f ? velocity / maxAmp : Vector3.Zero;\r\n\t}\r\n}\r\n"},{"Ident":"redsnail.watertool","Path":"Water/WaterBodyRenderer.cs","FileName":"WaterBodyRenderer.cs","PackageType":"library","CodeKind":"Game","AssetVersionId":342768,"Code":"using System;\r\nusing System.Collections.Generic;\r\nusing System.Linq;\r\nusing Sandbox;\r\nusing Sandbox.Rendering;\r\n\r\nnamespace RedSnail.WaterTool;\r\n\r\n[Icon(\u0022water\u0022), Group(\u0022Environment\u0022), Title(\u0022Water Body Renderer\u0022)]\r\npublic sealed class WaterBodyRenderer : Component, Component.ExecuteInEditor, Component.DontExecuteOnServer\r\n{\r\n#pragma warning disable CS0649\r\n\r\n\tprivate struct WaterVertex\r\n\t{\r\n\t\t[VertexLayout.Position] public Vector3 Position;\r\n\t\t[VertexLayout.Normal] public Vector3 Normal;\r\n\t\t[VertexLayout.Tangent] public Vector4 Tangent;\r\n\t\t[VertexLayout.TexCoord] public Vector2 TexCoord;\r\n\t\t[VertexLayout.Color] public Color Color;\r\n\t}\r\n\r\n#pragma warning restore CS0649\r\n\r\n\tprivate const float BASE_TILE_SIZE = 100.0f;\r\n\r\n\tprivate const int MAX_RINGS = 8;\r\n\r\n\tprivate const int MAX_WATER_INCLUSION_VOLUMES = 1024;\r\n\tprivate const int WATER_INCLUSION_VOLUME_ROWS = 3;\r\n\r\n\tprivate const int MAX_WATER_EXCLUSION_VOLUMES = 512;\r\n\tprivate const int WATER_EXCLUSION_VOLUME_ROWS = 3;\r\n\r\n\tprivate const int MAX_HULL_EXCLUSION_VOLUMES = 8;\r\n\tprivate const int HULL_EXCLUSION_META_ROWS = 6;\r\n\tprivate const int HULL_EXCLUSION_META_SIZE = MAX_HULL_EXCLUSION_VOLUMES * HULL_EXCLUSION_META_ROWS;\r\n\tprivate const int MAX_HULL_EXCLUSION_TRIS = 16384;\r\n\r\n\tprivate GpuBuffer\u003CWaterVertex\u003E m_VertexBuffer;\r\n\tprivate GpuBuffer\u003Cuint\u003E m_IndexBuffer;\r\n\tprivate GpuBuffer\u003CVector4\u003E m_WaterInclusionVolumeBuffer;\r\n\tprivate GpuBuffer\u003CVector4\u003E m_WaterExclusionVolumeBuffer;\r\n\tprivate int m_TotalIndexCount;\r\n\tprivate readonly RenderAttributes m_DrawAttributes = new();\r\n\tprivate int m_LastConfigHash;\r\n\tprivate readonly Vector4[] m_WaterInclusionVolumeData = new Vector4[MAX_WATER_INCLUSION_VOLUMES * WATER_INCLUSION_VOLUME_ROWS];\r\n\tprivate readonly Vector4[] m_WaterExclusionVolumeData = new Vector4[MAX_WATER_EXCLUSION_VOLUMES * WATER_EXCLUSION_VOLUME_ROWS];\r\n\tprivate GpuBuffer\u003CVector4\u003E m_HullExclusionBuffer;\r\n\tprivate readonly Vector4[] m_HullExclusionData = new Vector4[HULL_EXCLUSION_META_SIZE \u002B MAX_HULL_EXCLUSION_TRIS * 3];\r\n\r\n\t[Property, Group(\u0022General\u0022), Order(0)] public WaterBodyType WaterType { get; set; } = WaterBodyType.Ocean;\r\n\t[Property, Group(\u0022General\u0022), Order(0)] public Material Material { get; set; }\r\n\t[Property, Group(\u0022General\u0022), Order(0)] public float Width { get; set; } = 10000.0f;\r\n\t[Property, Group(\u0022General\u0022), Order(0)] public float Length { get; set; } = 10000.0f;\r\n\t[Property, Group(\u0022General\u0022), Order(0)] public float Depth { get; set; } = 300.0f;\r\n\t[Property(Title = \u0022Infinite Rendering\u0022), Group(\u0022General\u0022), Order(0)] public bool UseHybridInclusionBounds { get; set; } = true;\r\n\t[Property, Group(\u0022Clipmap\u0022), Order(1)] public float BaseCellSize { get; set; } = 8.0f;\r\n\t[Property, Group(\u0022Clipmap\u0022), Order(1), Range(16, 512)] public int CellsPerRing { get; set; } = 64;\r\n\t[Property(Title = \u0022Use Camera For Clipmap\u0022), Group(\u0022Clipmap\u0022), Order(1)] public bool FollowCameraForClipmap { get; set; } = true;\r\n\t[Property, Group(\u0022Texture\u0022), Order(2), Range(0.1f, 2.0f)] public float TextureTilingMultiplier { get; set; } = 1.0f;\r\n\r\n\tprivate int VerticesPerRing =\u003E (CellsPerRing \u002B 1) * (CellsPerRing \u002B 1);\r\n\tprivate float OuterExtent =\u003E CellsPerRing * BaseCellSize * (1 \u003C\u003C (ComputeRingCount() - 1));\r\n\r\n\tinternal bool ParticipatesInRendering =\u003E Active \u0026\u0026 Material.IsValid();\r\n\tinternal bool HasValidBuffers =\u003E m_VertexBuffer.IsValid() \u0026\u0026 m_IndexBuffer.IsValid();\r\n\r\n\tprotected override void OnEnabled()\r\n\t{\r\n\t\tif (!ParticipatesInRendering)\r\n\t\t\treturn;\r\n\r\n\t\tCreateBuffers();\r\n\r\n\t\tm_LastConfigHash = ComputeConfigHash();\r\n\r\n\t\tWaterManager.Current?.RefreshWaterBodyRenderersList();\r\n\t}\r\n\r\n\tprotected override void OnDisabled()\r\n\t{\r\n\t\tWaterManager.Current?.RefreshWaterBodyRenderersList();\r\n\r\n\t\tm_VertexBuffer = default;\r\n\t\tm_IndexBuffer = default;\r\n\t\tm_WaterInclusionVolumeBuffer?.Dispose();\r\n\t\tm_WaterInclusionVolumeBuffer = null;\r\n\t\tm_WaterExclusionVolumeBuffer?.Dispose();\r\n\t\tm_WaterExclusionVolumeBuffer = null;\r\n\t\tm_HullExclusionBuffer?.Dispose();\r\n\t\tm_HullExclusionBuffer = null;\r\n\t}\r\n\r\n\tprotected override void OnUpdate()\r\n\t{\r\n\t\tif (!ParticipatesInRendering)\r\n\t\t\treturn;\r\n\r\n\t\tint configHash = ComputeConfigHash();\r\n\t\tif (!HasValidBuffers || configHash != m_LastConfigHash)\r\n\t\t{\r\n\t\t\tCreateBuffers();\r\n\t\t\tm_LastConfigHash = configHash;\r\n\t\t}\r\n\r\n\t\tUpdateShaderAttributes();\r\n\t}\r\n\r\n\tinternal BBox GetWorldBounds2D()\r\n\t{\r\n\t\tVector3 right = WorldRotation.Right * (Length / 2.0f);\r\n\t\tVector3 forward = WorldRotation.Forward * (Width / 2.0f);\r\n\r\n\t\tVector3 c0 = WorldPosition \u002B right \u002B forward;\r\n\t\tVector3 c1 = WorldPosition - right \u002B forward;\r\n\t\tVector3 c2 = WorldPosition \u002B right - forward;\r\n\t\tVector3 c3 = WorldPosition - right - forward;\r\n\r\n\t\tfloat minX = MathF.Min(MathF.Min(c0.x, c1.x), MathF.Min(c2.x, c3.x));\r\n\t\tfloat maxX = MathF.Max(MathF.Max(c0.x, c1.x), MathF.Max(c2.x, c3.x));\r\n\t\tfloat minY = MathF.Min(MathF.Min(c0.y, c1.y), MathF.Min(c2.y, c3.y));\r\n\t\tfloat maxY = MathF.Max(MathF.Max(c0.y, c1.y), MathF.Max(c2.y, c3.y));\r\n\r\n\t\treturn new BBox(new Vector3(minX, minY, WorldPosition.z - Depth), new Vector3(maxX, maxY, WorldPosition.z));\r\n\t}\r\n\r\n\t// Records the clipmap compute dispatches into the command list as DEFERRED commands.\r\n\t// They run later, on the render thread, when the camera executes the list - so the\r\n\t// per-ring attributes are set through the command list (which writes Graphics.Attributes\r\n\t// at execute time, exactly what CommandList.DispatchCompute reads) rather than on the\r\n\t// shared shader instance.\r\n\tinternal void RecordCompute(CommandList commandList, ComputeShader shader, Vector3 cameraPosition)\r\n\t{\r\n\t\tif (!ParticipatesInRendering || !HasValidBuffers)\r\n\t\t\treturn;\r\n\r\n\t\tint ringCount = ComputeRingCount();\r\n\t\tint verticesPerRing = VerticesPerRing;\r\n\r\n\t\tvar localBounds = GetWorldBounds2D();\r\n\r\n\t\tfor (int ring = 0; ring \u003C ringCount; ring\u002B\u002B)\r\n\t\t{\r\n\t\t\tfloat cellSize = BaseCellSize * (1 \u003C\u003C ring);\r\n\t\t\tVector3 clipmapAnchor = FollowCameraForClipmap ? cameraPosition : WorldPosition;\r\n\t\t\tfloat snapX = MathF.Floor(clipmapAnchor.x / cellSize) * cellSize;\r\n\t\t\tfloat snapY = MathF.Floor(clipmapAnchor.y / cellSize) * cellSize;\r\n\r\n\t\t\tcommandList.Attributes.Set(\u0022VertexBuffer\u0022, m_VertexBuffer);\r\n\t\t\tcommandList.Attributes.Set(\u0022VertexOffset\u0022, ring * verticesPerRing);\r\n\t\t\tcommandList.Attributes.Set(\u0022GridWidth\u0022, CellsPerRing);\r\n\t\t\tcommandList.Attributes.Set(\u0022CellSize\u0022, cellSize);\r\n\t\t\tcommandList.Attributes.Set(\u0022SnapPosition\u0022, new Vector2(snapX, snapY));\r\n\t\t\tcommandList.Attributes.Set(\u0022WaterZ\u0022, WorldPosition.z);\r\n\t\t\tcommandList.Attributes.Set(\u0022TilingScale\u0022, 1.0f / OuterExtent);\r\n\t\t\tcommandList.Attributes.Set(\u0022ClampToBounds\u0022, false);\r\n\t\t\tcommandList.Attributes.Set(\u0022BoundsMin\u0022, new Vector2(localBounds.Mins.x, localBounds.Mins.y));\r\n\t\t\tcommandList.Attributes.Set(\u0022BoundsMax\u0022, new Vector2(localBounds.Maxs.x, localBounds.Maxs.y));\r\n\t\t\tcommandList.DispatchCompute(shader, verticesPerRing, 1, 1);\r\n\t\t}\r\n\t}\r\n\r\n\tinternal void BarrierTransition(CommandList _CommandList)\r\n\t{\r\n\t\tif (m_VertexBuffer.IsValid())\r\n\t\t\t_CommandList?.ResourceBarrierTransition(m_VertexBuffer, ResourceState.UnorderedAccess, ResourceState.VertexOrIndexBuffer);\r\n\t}\r\n\r\n\tinternal void Draw(CommandList _CommandList)\r\n\t{\r\n\t\tif (!ParticipatesInRendering || !HasValidBuffers)\r\n\t\t\treturn;\r\n\t\t\r\n\t\t_CommandList?.DrawIndexed(m_VertexBuffer, m_IndexBuffer, Material, 0, m_TotalIndexCount, m_DrawAttributes);\r\n\t}\r\n\r\n\tprivate void UpdateShaderAttributes()\r\n\t{\r\n\t\tBBox localBounds = GetWorldBounds2D();\r\n\r\n\t\tm_DrawAttributes.Set(\u0022RequireWaterInclusionVolumes\u0022, UseHybridInclusionBounds);\r\n\t\tm_DrawAttributes.Set(\u0022UseHybridInclusionBounds\u0022, UseHybridInclusionBounds);\r\n\t\tm_DrawAttributes.Set(\u0022HybridInclusionBoundsMin\u0022, new Vector2(localBounds.Mins.x, localBounds.Mins.y));\r\n\t\tm_DrawAttributes.Set(\u0022HybridInclusionBoundsMax\u0022, new Vector2(localBounds.Maxs.x, localBounds.Maxs.y));\r\n\r\n\t\tWaterDefinition profile = WaterManager.GetWaveProfile(WaterType);\r\n\r\n\t\tif (profile.IsValid())\r\n\t\t\tprofile.ApplyTo(m_DrawAttributes);\r\n\r\n\t\tm_DrawAttributes.Set(\u0022WaterTime\u0022, Time.Now);\r\n\t\tm_DrawAttributes.Set(\u0022DepthMax\u0022, Depth);\r\n\r\n\t\tfloat tilingScalar = (OuterExtent / BASE_TILE_SIZE) * TextureTilingMultiplier;\r\n\t\tm_DrawAttributes.Set(\u0022NormalTiling\u0022, new Vector2(tilingScalar, tilingScalar));\r\n\r\n\t\tWaterManager.Current?.ApplyRippleAttributes(m_DrawAttributes);\r\n\t\tWaterManager.Current?.ApplyCalmAttributes(m_DrawAttributes);\r\n\t\t\r\n\t\t// Band-limit the wave normal to the local clipmap vertex spacing (see shader)\r\n\t\tm_DrawAttributes.Set(\u0022WaveNormalEpsScale\u0022, 3.0f / CellsPerRing);\r\n\t\tm_DrawAttributes.Set(\u0022WaveNormalEpsMin\u0022, BaseCellSize);\r\n\r\n\t\tvar viewPosition = WaterManager.GetViewPosition(Scene, WorldPosition);\r\n\r\n\t\tSetWaterInclusionVolumes(viewPosition);\r\n\t\tSetWaterExclusionVolumes(viewPosition);\r\n\t\tSetHullExclusionVolumes();\r\n\t}\r\n\r\n\tprivate void SetWaterInclusionVolumes(Vector3 referencePosition)\r\n\t{\r\n\t\tEnsureWaterInclusionVolumeBuffer();\r\n\r\n\t\tvar volumes = WaterManager.Current.Bodies\r\n\t\t\t.Where(v =\u003E v.IsValid() \u0026\u0026 v.Active \u0026\u0026 v.WaterType == WaterType)\r\n\t\t\t.OrderBy(v =\u003E v.WorldPosition.DistanceSquared(referencePosition))\r\n\t\t\t.Take(MAX_WATER_INCLUSION_VOLUMES)\r\n\t\t\t.ToList();\r\n\r\n\t\tfor (int i = 0; i \u003C volumes.Count; i\u002B\u002B)\r\n\t\t{\r\n\t\t\tvar (center, forward, up, half) = volumes[i].GetWorldOBB();\r\n\r\n\t\t\tint rowOffset = i * WATER_INCLUSION_VOLUME_ROWS;\r\n\r\n\t\t\tm_WaterInclusionVolumeData[rowOffset \u002B 0] = new Vector4(forward.x, forward.y, forward.z, half.x);\r\n\t\t\tm_WaterInclusionVolumeData[rowOffset \u002B 1] = new Vector4(up.x, up.y, up.z, half.y);\r\n\t\t\tm_WaterInclusionVolumeData[rowOffset \u002B 2] = new Vector4(center.x, center.y, center.z, half.z);\r\n\t\t}\r\n\r\n\t\tm_WaterInclusionVolumeBuffer.SetData(m_WaterInclusionVolumeData.AsSpan(0, volumes.Count * WATER_INCLUSION_VOLUME_ROWS));\r\n\r\n\t\tm_DrawAttributes.Set(\u0022WaterInclusionVolumeCount\u0022, volumes.Count);\r\n\t\tm_DrawAttributes.Set(\u0022WaterInclusionVolumeRows\u0022, m_WaterInclusionVolumeBuffer);\r\n\t}\r\n\r\n\tprivate void SetWaterExclusionVolumes(Vector3 referencePosition)\r\n\t{\r\n\t\tEnsureWaterExclusionVolumeBuffer();\r\n\r\n\t\tvar volumes = WaterManager.Current.ExclusionVolumes\r\n\t\t\t.Where(v =\u003E v.IsValid() \u0026\u0026 v.Enabled \u0026\u0026 v.Active)\r\n\t\t\t.OrderBy(v =\u003E v.WorldPosition.DistanceSquared(referencePosition))\r\n\t\t\t.Take(MAX_WATER_EXCLUSION_VOLUMES)\r\n\t\t\t.ToList();\r\n\r\n\t\tfor (int i = 0; i \u003C volumes.Count; i\u002B\u002B)\r\n\t\t{\r\n\t\t\tvar (center, forward, up, half) = volumes[i].GetWorldOBB();\r\n\r\n\t\t\tint rowOffset = i * WATER_EXCLUSION_VOLUME_ROWS;\r\n\r\n\t\t\tm_WaterExclusionVolumeData[rowOffset \u002B 0] = new Vector4(forward.x, forward.y, forward.z, half.x);\r\n\t\t\tm_WaterExclusionVolumeData[rowOffset \u002B 1] = new Vector4(up.x, up.y, up.z, half.y);\r\n\t\t\tm_WaterExclusionVolumeData[rowOffset \u002B 2] = new Vector4(center.x, center.y, center.z, half.z);\r\n\t\t}\r\n\r\n\t\tm_WaterExclusionVolumeBuffer.SetData(m_WaterExclusionVolumeData.AsSpan(0, volumes.Count * WATER_EXCLUSION_VOLUME_ROWS));\r\n\r\n\t\tm_DrawAttributes.Set(\u0022WaterExclusionVolumeCount\u0022, volumes.Count);\r\n\t\tm_DrawAttributes.Set(\u0022WaterExclusionVolumeRows\u0022, m_WaterExclusionVolumeBuffer);\r\n\t}\r\n\r\n\tprivate void EnsureWaterExclusionVolumeBuffer()\r\n\t{\r\n\t\tif (m_WaterExclusionVolumeBuffer.IsValid())\r\n\t\t\treturn;\r\n\r\n\t\tm_WaterExclusionVolumeBuffer = new GpuBuffer\u003CVector4\u003E(MAX_WATER_EXCLUSION_VOLUMES * WATER_EXCLUSION_VOLUME_ROWS, GpuBuffer.UsageFlags.Structured);\r\n\t}\r\n\r\n\r\n\r\n\tprivate void SetHullExclusionVolumes()\r\n\t{\r\n\t\tif (WaterManager.Current == null)\r\n\t\t\treturn;\r\n\r\n\t\tvar hulls = WaterManager.Current.HullExclusionVolumes\r\n\t\t\t.Where(h =\u003E h.IsValid() \u0026\u0026 h.Active \u0026\u0026 h.LocalTriangles.Length \u003E 0)\r\n\t\t\t.Take(MAX_HULL_EXCLUSION_VOLUMES)\r\n\t\t\t.ToList();\r\n\r\n\t\tif (hulls.Count == 0)\r\n\t\t{\r\n\t\t\tm_DrawAttributes.Set(\u0022WaterHullExclusionCount\u0022, 0);\r\n\t\t\treturn;\r\n\t\t}\r\n\r\n\t\tEnsureHullExclusionBuffers();\r\n\r\n\t\tint triWriteCursor = HULL_EXCLUSION_META_SIZE;\r\n\r\n\t\tfor (int h = 0; h \u003C hulls.Count; h\u002B\u002B)\r\n\t\t{\r\n\t\t\tvar hull = hulls[h];\r\n\t\t\tvar tris = hull.LocalTriangles;\r\n\t\t\tint triCount = tris.Length / 3;\r\n\r\n\t\t\tif (triWriteCursor \u002B tris.Length \u003E m_HullExclusionData.Length)\r\n\t\t\t\tbreak;\r\n\r\n\t\t\thull.GetWorldToLocalRows(out var r0, out var r1, out var r2, out var r3);\r\n\r\n\t\t\tint meta = h * HULL_EXCLUSION_META_ROWS;\r\n\t\t\tm_HullExclusionData[meta \u002B 0] = r0;\r\n\t\t\tm_HullExclusionData[meta \u002B 1] = r1;\r\n\t\t\tm_HullExclusionData[meta \u002B 2] = r2;\r\n\t\t\tm_HullExclusionData[meta \u002B 3] = r3;\r\n\r\n\t\t\tvar aabb = hull.LocalAABB;\r\n\t\t\tm_HullExclusionData[meta \u002B 4] = new Vector4(triWriteCursor, triCount, aabb.Mins.x, aabb.Mins.y);\r\n\t\t\tm_HullExclusionData[meta \u002B 5] = new Vector4(aabb.Mins.z, aabb.Maxs.x, aabb.Maxs.y, aabb.Maxs.z);\r\n\r\n\t\t\tfor (int i = 0; i \u003C tris.Length; i\u002B\u002B)\r\n\t\t\t\tm_HullExclusionData[triWriteCursor \u002B i] = new Vector4(tris[i].x, tris[i].y, tris[i].z, 0f);\r\n\r\n\t\t\ttriWriteCursor \u002B= tris.Length;\r\n\t\t}\r\n\r\n\t\tm_HullExclusionBuffer.SetData(m_HullExclusionData.AsSpan(0, triWriteCursor));\r\n\r\n\t\tm_DrawAttributes.Set(\u0022WaterHullExclusionCount\u0022, hulls.Count);\r\n\t\tm_DrawAttributes.Set(\u0022WaterHullExclusionData\u0022, m_HullExclusionBuffer);\r\n\t}\r\n\r\n\r\n\r\n\tprivate void EnsureHullExclusionBuffers()\r\n\t{\r\n\t\tif (!m_HullExclusionBuffer.IsValid())\r\n\t\t\tm_HullExclusionBuffer = new GpuBuffer\u003CVector4\u003E(HULL_EXCLUSION_META_SIZE \u002B MAX_HULL_EXCLUSION_TRIS * 3, GpuBuffer.UsageFlags.Structured);\r\n\t}\r\n\r\n\r\n\r\n\tprivate void EnsureWaterInclusionVolumeBuffer()\r\n\t{\r\n\t\tif (m_WaterInclusionVolumeBuffer.IsValid())\r\n\t\t\treturn;\r\n\r\n\t\tm_WaterInclusionVolumeBuffer = new GpuBuffer\u003CVector4\u003E(MAX_WATER_INCLUSION_VOLUMES * WATER_INCLUSION_VOLUME_ROWS, GpuBuffer.UsageFlags.Structured);\r\n\t}\r\n\r\n\tprivate int ComputeConfigHash()\r\n\t{\r\n\t\treturn HashCode.Combine(Width, Length, BaseCellSize, CellsPerRing);\r\n\t}\r\n\r\n\tprivate int ComputeRingCount()\r\n\t{\r\n\t\treturn ComputeRingCount(Width, Length);\r\n\t}\r\n\r\n\tprivate int ComputeRingCount(float width, float length)\r\n\t{\r\n\t\tfloat maxDim = MathF.Max(length, width);\r\n\t\tfloat innerExtent = CellsPerRing * BaseCellSize;\r\n\t\tfloat requiredExtent = maxDim * 2.0f;\r\n\r\n\t\tif (requiredExtent \u003C= innerExtent)\r\n\t\t\treturn 1;\r\n\r\n\t\tint rings = (int)MathF.Ceiling(MathF.Log2(requiredExtent / innerExtent)) \u002B 1;\r\n\t\treturn Math.Clamp(rings, 1, MAX_RINGS);\r\n\t}\r\n\r\n\tprivate void CreateBuffers()\r\n\t{\r\n\t\tint ringCount = ComputeRingCount();\r\n\t\tint n = CellsPerRing;\r\n\t\tint verticesPerRing = VerticesPerRing;\r\n\r\n\t\tint innerStart = n / 4 \u002B 1;\r\n\t\tint innerEnd = n * 3 / 4 - 1;\r\n\t\tint innerBlockSize = innerEnd - innerStart;\r\n\t\tint filledCells = n * n;\r\n\t\tint hollowCells = filledCells - (innerBlockSize * innerBlockSize);\r\n\t\tint totalIndices = filledCells * 6;\r\n\t\ttotalIndices \u002B= (ringCount - 1) * hollowCells * 6;\r\n\r\n\t\tm_VertexBuffer = new GpuBuffer\u003CWaterVertex\u003E(ringCount * verticesPerRing, GpuBuffer.UsageFlags.Vertex | GpuBuffer.UsageFlags.Structured);\r\n\t\tm_IndexBuffer = new GpuBuffer\u003Cuint\u003E(totalIndices, GpuBuffer.UsageFlags.Index | GpuBuffer.UsageFlags.Structured);\r\n\t\tUploadIndexBuffer(ringCount);\r\n\t}\r\n\r\n\tprivate void UploadIndexBuffer(int ringCount)\r\n\t{\r\n\t\tint n = CellsPerRing;\r\n\t\tint verticesPerRing = VerticesPerRing;\r\n\t\tint innerStart = n / 4 \u002B 1;\r\n\t\tint innerEnd = n * 3 / 4 - 1;\r\n\r\n\t\tvar indices = new List\u003Cuint\u003E();\r\n\r\n\t\tfor (int ring = 0; ring \u003C ringCount; ring\u002B\u002B)\r\n\t\t{\r\n\t\t\tuint baseVertex = (uint)(ring * verticesPerRing);\r\n\r\n\t\t\tfor (int y = 0; y \u003C n; y\u002B\u002B)\r\n\t\t\t{\r\n\t\t\t\tfor (int x = 0; x \u003C n; x\u002B\u002B)\r\n\t\t\t\t{\r\n\t\t\t\t\tif (ring \u003E 0 \u0026\u0026 x \u003E= innerStart \u0026\u0026 x \u003C innerEnd \u0026\u0026 y \u003E= innerStart \u0026\u0026 y \u003C innerEnd)\r\n\t\t\t\t\t\tcontinue;\r\n\r\n\t\t\t\t\tuint i0 = baseVertex \u002B (uint)(y * (n \u002B 1) \u002B x);\r\n\t\t\t\t\tuint i1 = i0 \u002B 1;\r\n\t\t\t\t\tuint i2 = i0 \u002B (uint)(n \u002B 1);\r\n\t\t\t\t\tuint i3 = i2 \u002B 1;\r\n\r\n\t\t\t\t\tindices.Add(i0);\r\n\t\t\t\t\tindices.Add(i1);\r\n\t\t\t\t\tindices.Add(i2);\r\n\t\t\t\t\tindices.Add(i1);\r\n\t\t\t\t\tindices.Add(i3);\r\n\t\t\t\t\tindices.Add(i2);\r\n\t\t\t\t}\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\tm_IndexBuffer.SetData(indices);\r\n\t\tm_TotalIndexCount = indices.Count;\r\n\t}\r\n}\r\n"},{"Ident":"redsnail.watertool","Path":"Water/WaterQuad.cs","FileName":"WaterQuad.cs","PackageType":"library","CodeKind":"Game","AssetVersionId":342768,"Code":"using System;\r\nusing System.Collections.Generic;\r\nusing System.Linq;\r\nusing Sandbox;\r\nusing Sandbox.Rendering;\r\n\r\nnamespace RedSnail.WaterTool;\r\n\r\n[Icon(\u0022water\u0022), Group(\u0022Water\u0022), Title(\u0022Water Quad\u0022)]\r\npublic sealed class WaterQuad : Component, Component.ExecuteInEditor, Component.DontExecuteOnServer\r\n{\r\n\t#pragma warning disable CS0649\r\n\r\n\tprivate struct WaterVertex\r\n\t{\r\n\t\t[VertexLayout.Position] public Vector3 Position;\r\n\t\t[VertexLayout.Normal] public Vector3 Normal;\r\n\t\t[VertexLayout.Tangent] public Vector4 Tangent;\r\n\t\t[VertexLayout.TexCoord] public Vector2 TexCoord;\r\n\t\t[VertexLayout.Color] public Color Color;\r\n\t}\r\n\r\n\t#pragma warning restore CS0649\r\n\r\n\t// GPU buffers (per-quad, owned here \u2014 WaterManager owns the command lists and ComputeShader)\r\n\tprivate GpuBuffer\u003CWaterVertex\u003E m_VertexBuffer;\r\n\tprivate GpuBuffer\u003Cuint\u003E m_IndexBuffer;\r\n\tprivate int m_TotalIndexCount;\r\n\tprivate int m_CircleGridWidth = 1;\r\n\tprivate readonly RenderAttributes m_DrawAttributes = new();\r\n\tprivate GpuBuffer\u003CVector4\u003E m_WaterExclusionVolumeBuffer;\r\n\tprivate readonly Vector4[] m_WaterExclusionVolumeData = new Vector4[MAX_WATER_EXCLUSION_VOLUMES * WATER_EXCLUSION_VOLUME_ROWS];\r\n\tprivate GpuBuffer\u003CVector4\u003E m_HullExclusionBuffer;\r\n\tprivate readonly Vector4[] m_HullExclusionData = new Vector4[HULL_EXCLUSION_META_SIZE \u002B MAX_HULL_EXCLUSION_TRIS * 3];\r\n\r\n\tprivate HullCollider m_HullCollider;\r\n\tprivate int m_LastConfigHash;\r\n\tprivate float m_LastWidth;\r\n\tprivate float m_LastLength;\r\n\tprivate float m_LastDepth;\r\n\tprivate bool m_LastIsCircleShape;\r\n\tprivate int m_LastNumCircleSegments;\r\n\tprivate Vector3 m_LastHullCenter;\r\n\tprivate Vector3 m_LastHullBoxSize;\r\n\tprivate Material m_LastMaterial;\r\n\r\n\tprivate const float BASE_TILE_SIZE = 100.0f;\r\n\r\n\tprivate const int MAX_RINGS = 8;\r\n\r\n\tprivate const int MAX_WATER_EXCLUSION_VOLUMES = 512;\r\n\tprivate const int WATER_EXCLUSION_VOLUME_ROWS = 3;\r\n\r\n\tprivate const int MAX_HULL_EXCLUSION_VOLUMES = 8;\r\n\tprivate const int HULL_EXCLUSION_META_ROWS = 6;\r\n\tprivate const int HULL_EXCLUSION_META_SIZE = MAX_HULL_EXCLUSION_VOLUMES * HULL_EXCLUSION_META_ROWS;\r\n\tprivate const int MAX_HULL_EXCLUSION_TRIS = 16384;\r\n\r\n\t[Property, Group(\u0022General\u0022), Order(0)] public WaterBodyType WaterType { get; set; } = WaterBodyType.Ocean;\r\n\t[Property, Group(\u0022General\u0022), Order(0)] public Material Material { get; set; }\r\n\t[Property, Group(\u0022General\u0022), Step(1), Order(0)] public float Width { get; set; } = 5000.0f;\r\n\t[Property, Group(\u0022General\u0022), Step(1), Order(0)] public float Length { get; set; } = 5000.0f;\r\n\t[Property, Group(\u0022General\u0022), Step(1), Order(0)] public float Depth { get; set; } = 300.0f;\r\n\r\n\t[Property, Group(\u0022Clipmap\u0022), Order(2)] public float BaseCellSize { get; set { field = value.Clamp(8, 4096); } } = 32.0f;\r\n\t[Property, Group(\u0022Clipmap\u0022), Order(2), Range(16, 512)] public int CellsPerRing { get; set { field = value.Clamp(16, 512); } } = 256;\r\n\t[Property(Title = \u0022Use Camera For Clipmap\u0022), Group(\u0022Clipmap\u0022), Order(2)] public bool FollowCameraForClipmap { get; set; } = true;\r\n\t\r\n\t[Property, Group(\u0022Shape\u0022), Order(3)] public bool CircleShape { get; set; } = false;\r\n\t[Property, Group(\u0022Shape\u0022), Order(3), Range(5, 32), ShowIf(nameof(CircleShape), true)] public int CircleSegments { get; set { field = value.Clamp(5, 32); } } = 16;\r\n\r\n\t[Property, Group(\u0022Texture\u0022), Order(4), Range(0.1f, 2.0f)] public float TextureTilingMultiplier { get; set; } = 1.0f;\r\n\r\n\tpublic HullCollider HullCollider =\u003E m_HullCollider;\r\n\r\n\t// Distance LOD level resolved by the WaterManager (0 = full detail). At level L the grid\r\n\t// uses half the cells at twice the size per level, so it covers exactly the same area with\r\n\t// 4^L fewer vertices. CellsPerRing * BaseCellSize is preserved exactly, which is what keeps\r\n\t// the ring count, coverage and texture tiling identical across levels \u2014 only the\r\n\t// tessellation density changes, so there\u0027s no swimming or resizing when a level switches.\r\n\tprivate int m_LodLevel;\r\n\r\n\tprivate int EffectiveCellsPerRing =\u003E Math.Max(16, CellsPerRing \u003E\u003E m_LodLevel);\r\n\tprivate float EffectiveBaseCellSize =\u003E BaseCellSize * ((float)CellsPerRing / EffectiveCellsPerRing);\r\n\r\n\tprivate int VerticesPerRing =\u003E (EffectiveCellsPerRing \u002B 1) * (EffectiveCellsPerRing \u002B 1);\r\n\r\n\r\n\r\n\tprotected override void OnEnabled()\r\n\t{\r\n\t\tRefreshRenderBuffers();\r\n\t\tUpdateColliderState();\r\n\r\n\t\tm_LastWidth = Width;\r\n\t\tm_LastLength = Length;\r\n\t\tm_LastDepth = Depth;\r\n\t\tm_LastIsCircleShape = CircleShape;\r\n\t\tm_LastNumCircleSegments = CircleSegments;\r\n\t\tm_LastMaterial = Material;\r\n\r\n\t\tWaterManager.Current?.RefreshWaterQuadsList();\r\n\t}\r\n\r\n\r\n\r\n\tprotected override void OnDisabled()\r\n\t{\r\n\t\tWaterManager.Current?.RefreshWaterQuadsList();\r\n\r\n\t\tm_HullCollider?.Destroy();\r\n\r\n\t\tm_VertexBuffer = default;\r\n\t\tm_IndexBuffer = default;\r\n\t\tm_WaterExclusionVolumeBuffer?.Dispose();\r\n\t\tm_WaterExclusionVolumeBuffer = null;\r\n\t\tm_HullExclusionBuffer?.Dispose();\r\n\t\tm_HullExclusionBuffer = null;\r\n\t}\r\n\r\n\r\n\r\n\tprotected override void OnUpdate()\r\n\t{\r\n\t\tif (WaterManager.Current == null)\r\n\t\t\treturn;\r\n\r\n\t\t// Material was just assigned after the component was already enabled, register now.\r\n\t\tif (m_LastMaterial == null \u0026\u0026 Material != null)\r\n\t\t\tWaterManager.Current?.RefreshWaterQuadsList();\r\n\r\n\t\tm_LastMaterial = Material;\r\n\r\n\t\tif (Material == null)\r\n\t\t\treturn;\r\n\r\n\t\t// Resolve the tessellation level before the buffers are checked \u2014 it feeds the config\r\n\t\t// hash, so a level change rebuilds the grid at the new density (rare, thanks to the\r\n\t\t// hysteresis in ComputeLodLevel).\r\n\t\tm_LodLevel = WaterManager.Current.ComputeLodLevel(GetWorldBounds2D(), m_LodLevel);\r\n\r\n\t\tUpdateBuffers();\r\n\r\n\t\tif (Width != m_LastWidth || Length != m_LastLength || Depth != m_LastDepth || CircleShape != m_LastIsCircleShape || m_LastNumCircleSegments != CircleSegments)\r\n\t\t{\r\n\t\t\tUpdateColliderState();\r\n\r\n\t\t\tm_LastWidth = Width;\r\n\t\t\tm_LastLength = Length;\r\n\t\t\tm_LastDepth = Depth;\r\n\t\t\tm_LastIsCircleShape = CircleShape;\r\n\t\t\tm_LastNumCircleSegments = CircleSegments;\r\n\t\t}\r\n\r\n\t\tif (m_HullCollider.IsValid())\r\n\t\t{\r\n\t\t\tif (m_HullCollider.Center != m_LastHullCenter)\r\n\t\t\t{\r\n\t\t\t\tm_HullCollider.Center = m_LastHullCenter;\r\n\t\t\t\t\r\n\t\t\t\tLog.Warning(\u0022[WaterTool] Do not use S\u0026box gizmos to control the size of the water quad, please use the intended: Width, Length \u0026 Depth property in the editor!\u0022);\r\n\t\t\t}\r\n\r\n\t\t\tif (m_HullCollider.BoxSize != m_LastHullBoxSize)\r\n\t\t\t{\r\n\t\t\t\tm_HullCollider.BoxSize = m_LastHullBoxSize;\r\n\t\t\t\t\r\n\t\t\t\tLog.Warning(\u0022[WaterTool] Do not use S\u0026box gizmos to control the size of the water quad, please use the intended: Width, Length \u0026 Depth property in the editor!\u0022);\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\tUpdateShaderAttributes();\r\n\t}\r\n\r\n\r\n\r\n\tprotected override void DrawGizmos()\r\n\t{\r\n\t\tif (!Gizmo.IsSelected)\r\n\t\t\treturn;\r\n\r\n\t\tif (!m_HullCollider.IsValid())\r\n\t\t\treturn;\r\n\r\n\t\tGizmo.Draw.Color = Color.Cyan;\r\n\r\n\t\tif (CircleShape)\r\n\t\t{\r\n\t\t\tVector3 pointA = m_HullCollider.Center;\r\n\t\t\tpointA.z -= m_HullCollider.Height / 2.0f;\r\n\r\n\t\t\tVector3 pointB = m_HullCollider.Center;\r\n\t\t\tpointB.z \u002B= m_HullCollider.Height / 2.0f;\r\n\r\n\t\t\tGizmo.Draw.LineCylinder(pointA, pointB, m_HullCollider.Radius, m_HullCollider.Radius2, CircleSegments);\r\n\t\t}\r\n\t\telse\r\n\t\t{\r\n\t\t\tGizmo.Draw.LineBBox(m_HullCollider.LocalBounds);\r\n\t\t}\r\n\t}\r\n\r\n\r\n\r\n\tprivate int ComputeConfigHash()\r\n\t{\r\n\t\treturn HashCode.Combine(Width, Length, BaseCellSize, CellsPerRing, CircleShape, CircleSegments, m_LodLevel);\r\n\t}\r\n\r\n\r\n\r\n\tprivate int ComputeRingCount()\r\n\t{\r\n\t\treturn ComputeRingCount(Width, Length);\r\n\t}\r\n\r\n\r\n\r\n\tprivate int ComputeRingCount(float _Width, float _Length)\r\n\t{\r\n\t\tfloat maxDim = MathF.Max(_Length, _Width);\r\n\r\n\t\t// Authored product on purpose: LOD preserves CellsPerRing * BaseCellSize exactly, so the\r\n\t\t// ring layout and coverage stay identical across levels \u2014 only the density changes.\r\n\t\tfloat innerExtent = CellsPerRing * BaseCellSize;\r\n\r\n\t\tfloat requiredExtent = maxDim * 2.0f;\r\n\r\n\t\tif (requiredExtent \u003C= innerExtent)\r\n\t\t\treturn 1;\r\n\r\n\t\tint rings = (int)MathF.Ceiling(MathF.Log2(requiredExtent / innerExtent)) \u002B 1;\r\n\r\n\t\treturn Math.Clamp(rings, 1, MAX_RINGS);\r\n\t}\r\n\r\n\r\n\r\n\tprivate float OuterExtent\r\n\t{\r\n\t\tget\r\n\t\t{\r\n\t\t\tif (CircleShape)\r\n\t\t\t\treturn MathF.Min(Width, Length) / 2.0f;\r\n\r\n\t\t\tint ringCount = ComputeRingCount();\r\n\r\n\t\t\t// Authored product (LOD-invariant) so texture tiling doesn\u0027t shift on a level change\r\n\t\t\treturn CellsPerRing * BaseCellSize * (1 \u003C\u003C (ringCount - 1));\r\n\t\t}\r\n\t}\r\n\r\n\r\n\r\n\tprivate void UpdateBuffers()\r\n\t{\r\n\t\tint configHash = ComputeConfigHash();\r\n\r\n\t\tif (configHash != m_LastConfigHash)\r\n\t\t{\r\n\t\t\tCreateBuffers();\r\n\r\n\t\t\tm_LastConfigHash = configHash;\r\n\t\t}\r\n\t}\r\n\r\n\r\n\r\n\tprivate void CreateBuffers()\r\n\t{\r\n\t\tif (CircleShape)\r\n\t\t{\r\n\t\t\tBuildCircleBuffers();\r\n\r\n\t\t\treturn;\r\n\t\t}\r\n\r\n\t\tint ringCount = ComputeRingCount();\r\n\t\tint n = EffectiveCellsPerRing;\r\n\t\tint verticesPerRing = VerticesPerRing;\r\n\r\n\t\tint innerStart = n / 4 \u002B 1;\r\n\t\tint innerEnd = n * 3 / 4 - 1;\r\n\t\tint innerBlockSize = innerEnd - innerStart;\r\n\t\tint filledCells = n * n;\r\n\t\tint hollowCells = filledCells - (innerBlockSize * innerBlockSize);\r\n\r\n\t\tint totalIndices = filledCells * 6;\r\n\t\ttotalIndices \u002B= (ringCount - 1) * hollowCells * 6;\r\n\r\n\t\tm_VertexBuffer = new GpuBuffer\u003CWaterVertex\u003E(ringCount * verticesPerRing, GpuBuffer.UsageFlags.Vertex | GpuBuffer.UsageFlags.Structured);\r\n\t\tm_IndexBuffer = new GpuBuffer\u003Cuint\u003E(totalIndices, GpuBuffer.UsageFlags.Index | GpuBuffer.UsageFlags.Structured);\r\n\r\n\t\tUploadIndexBuffer(ringCount);\r\n\t}\r\n\r\n\r\n\r\n\tprivate void RefreshRenderBuffers()\r\n\t{\r\n\t\tCreateBuffers();\r\n\r\n\t\tm_LastConfigHash = ComputeConfigHash();\r\n\t}\r\n\r\n\r\n\r\n\tprivate void BuildCircleBuffers()\r\n\t{\r\n\t\tfloat radius = MathF.Min(Width, Length) / 2.0f;\r\n\t\tint M = ComputeCircleGridWidth();\r\n\t\tm_CircleGridWidth = M;\r\n\r\n\t\tfloat cellSize = (radius * 2.0f) / M;   // M cells span the full diameter\r\n\t\tfloat half = M * cellSize * 0.5f;        // == radius (grid centred on the circle)\r\n\t\tfloat r2 = radius * radius;\r\n\r\n\t\t// \u0022Minecraft circle\u0022: a uniform, world-axis-aligned grid of square cells, masked\r\n\t\t// to a circular boundary. Because the vertices live on the same grid as a\r\n\t\t// rectangular quad, wave displacement behaves identically (no polar pinching).\r\n\t\tint verticesPerSide = M \u002B 1;\r\n\t\tint vertexCount = verticesPerSide * verticesPerSide;\r\n\t\tm_VertexBuffer = new GpuBuffer\u003CWaterVertex\u003E(vertexCount, GpuBuffer.UsageFlags.Vertex | GpuBuffer.UsageFlags.Structured);\r\n\r\n\t\tvar indices = new List\u003Cuint\u003E();\r\n\r\n\t\t// Emit a cell\u0027s two triangles only when its centre falls inside the circle\r\n\t\tfor (int y = 0; y \u003C M; y\u002B\u002B)\r\n\t\t{\r\n\t\t\tfor (int x = 0; x \u003C M; x\u002B\u002B)\r\n\t\t\t{\r\n\t\t\t\tfloat cx = (x \u002B 0.5f) * cellSize - half;\r\n\t\t\t\tfloat cy = (y \u002B 0.5f) * cellSize - half;\r\n\r\n\t\t\t\tif (cx * cx \u002B cy * cy \u003E r2)\r\n\t\t\t\t\tcontinue;\r\n\r\n\t\t\t\tuint i0 = (uint)(y * verticesPerSide \u002B x);\r\n\t\t\t\tuint i1 = i0 \u002B 1;\r\n\t\t\t\tuint i2 = i0 \u002B (uint)verticesPerSide;\r\n\t\t\t\tuint i3 = i2 \u002B 1;\r\n\r\n\t\t\t\tindices.Add(i0); indices.Add(i1); indices.Add(i2);\r\n\t\t\t\tindices.Add(i1); indices.Add(i3); indices.Add(i2);\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\tm_IndexBuffer = new GpuBuffer\u003Cuint\u003E(indices.Count, GpuBuffer.UsageFlags.Index | GpuBuffer.UsageFlags.Structured);\r\n\t\tm_IndexBuffer.SetData(indices);\r\n\t\tm_TotalIndexCount = indices.Count;\r\n\t}\r\n\r\n\r\n\r\n\t// Number of grid cells across the circle\u0027s diameter, driven by BaseCellSize so the\r\n\t// blockiness matches the rest of the water \u2014 smaller cells = finer (rounder) edge.\r\n\tprivate int ComputeCircleGridWidth()\r\n\t{\r\n\t\tfloat diameter = MathF.Min(Width, Length);\r\n\t\tint cells = (int)MathF.Ceiling(diameter / EffectiveBaseCellSize);\r\n\t\treturn Math.Clamp(cells, 1, 256);\r\n\t}\r\n\r\n\r\n\r\n\tprivate void UploadIndexBuffer(int _RingCount)\r\n\t{\r\n\t\tint n = EffectiveCellsPerRing;\r\n\t\tint verticesPerRing = VerticesPerRing;\r\n\r\n\t\tint innerStart = n / 4 \u002B 1;\r\n\t\tint innerEnd = n * 3 / 4 - 1;\r\n\r\n\t\tvar indices = new List\u003Cuint\u003E();\r\n\r\n\t\tfor (int ring = 0; ring \u003C _RingCount; ring\u002B\u002B)\r\n\t\t{\r\n\t\t\tuint baseVertex = (uint)(ring * verticesPerRing);\r\n\r\n\t\t\tfor (int y = 0; y \u003C n; y\u002B\u002B)\r\n\t\t\t{\r\n\t\t\t\tfor (int x = 0; x \u003C n; x\u002B\u002B)\r\n\t\t\t\t{\r\n\t\t\t\t\tif (ring \u003E 0 \u0026\u0026 x \u003E= innerStart \u0026\u0026 x \u003C innerEnd \u0026\u0026 y \u003E= innerStart \u0026\u0026 y \u003C innerEnd)\r\n\t\t\t\t\t\tcontinue;\r\n\r\n\t\t\t\t\tuint i0 = baseVertex \u002B (uint)(y * (n \u002B 1) \u002B x);\r\n\t\t\t\t\tuint i1 = i0 \u002B 1;\r\n\t\t\t\t\tuint i2 = i0 \u002B (uint)(n \u002B 1);\r\n\t\t\t\t\tuint i3 = i2 \u002B 1;\r\n\r\n\t\t\t\t\tindices.Add(i0);\r\n\t\t\t\t\tindices.Add(i1);\r\n\t\t\t\t\tindices.Add(i2);\r\n\t\t\t\t\tindices.Add(i1);\r\n\t\t\t\t\tindices.Add(i3);\r\n\t\t\t\t\tindices.Add(i2);\r\n\t\t\t\t}\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\tm_IndexBuffer.SetData(indices);\r\n\r\n\t\tm_TotalIndexCount = indices.Count;\r\n\t}\r\n\r\n\r\n\r\n\tinternal bool HasValidBuffers =\u003E m_VertexBuffer.IsValid() \u0026\u0026 m_IndexBuffer.IsValid();\r\n\r\n\tinternal bool ParticipatesInRendering =\u003E Material.IsValid();\r\n\t\r\n\t\r\n\t\r\n\tinternal BBox GetWorldBounds2D()\r\n\t{\r\n\t\tVector3 right = WorldRotation.Right * (Length / 2.0f);\r\n\t\tVector3 forward = WorldRotation.Forward * (Width / 2.0f);\r\n\r\n\t\tVector3 c0 = WorldPosition \u002B right \u002B forward;\r\n\t\tVector3 c1 = WorldPosition - right \u002B forward;\r\n\t\tVector3 c2 = WorldPosition \u002B right - forward;\r\n\t\tVector3 c3 = WorldPosition - right - forward;\r\n\r\n\t\tfloat minX = MathF.Min(MathF.Min(c0.x, c1.x), MathF.Min(c2.x, c3.x));\r\n\t\tfloat maxX = MathF.Max(MathF.Max(c0.x, c1.x), MathF.Max(c2.x, c3.x));\r\n\t\tfloat minY = MathF.Min(MathF.Min(c0.y, c1.y), MathF.Min(c2.y, c3.y));\r\n\t\tfloat maxY = MathF.Max(MathF.Max(c0.y, c1.y), MathF.Max(c2.y, c3.y));\r\n\r\n\t\treturn new BBox(new Vector3(minX, minY, WorldPosition.z - Depth), new Vector3(maxX, maxY, WorldPosition.z));\r\n\t}\r\n\r\n\r\n\r\n\t// Records the clipmap compute dispatches into the command list as DEFERRED commands -\r\n\t// see WaterBodyRenderer.RecordCompute for why per-ring attributes go through the list.\r\n\tinternal void RecordCompute(CommandList _CommandList, ComputeShader _Shader, Vector3 _CameraPosition)\r\n\t{\r\n\t\tif (!ParticipatesInRendering || !HasValidBuffers)\r\n\t\t\treturn;\r\n\r\n\t\tfloat outerExtent = OuterExtent;\r\n\r\n\t\tif (CircleShape)\r\n\t\t{\r\n\t\t\tint M = m_CircleGridWidth;\r\n\t\t\tint verticesPerSide = M \u002B 1;\r\n\t\t\tfloat cellSize = MathF.Min(Width, Length) / M;   // M cells span the diameter\r\n\r\n\t\t\t_CommandList.Attributes.Set(\u0022VertexBuffer\u0022, m_VertexBuffer);\r\n\t\t\t_CommandList.Attributes.Set(\u0022VertexOffset\u0022, 0);\r\n\r\n\t\t\t_CommandList.Attributes.Set(\u0022GridWidth\u0022, M);\r\n\t\t\t_CommandList.Attributes.Set(\u0022CellSize\u0022, cellSize);\r\n\r\n\t\t\t// Static grid centred on the quad \u2014 the circular pool doesn\u0027t follow the camera\r\n\t\t\t_CommandList.Attributes.Set(\u0022SnapPosition\u0022, (Vector2)WorldPosition);\r\n\t\t\t_CommandList.Attributes.Set(\u0022WaterZ\u0022, WorldPosition.z);\r\n\r\n\t\t\t_CommandList.Attributes.Set(\u0022TilingScale\u0022, 1.0f / outerExtent);\r\n\t\t\t_CommandList.Attributes.Set(\u0022ClampToBounds\u0022, false);\r\n\r\n\t\t\t_CommandList.DispatchCompute(_Shader, verticesPerSide * verticesPerSide, 1, 1);\r\n\r\n\t\t\treturn;\r\n\t\t}\r\n\r\n\t\tint ringCount = ComputeRingCount();\r\n\t\tint verticesPerRing = VerticesPerRing;\r\n\r\n\t\tvar localBounds = GetWorldBounds2D();\r\n\t\tfloat boundsMinX = localBounds.Mins.x;\r\n\t\tfloat boundsMaxX = localBounds.Maxs.x;\r\n\t\tfloat boundsMinY = localBounds.Mins.y;\r\n\t\tfloat boundsMaxY = localBounds.Maxs.y;\r\n\r\n\t\tfor (int ring = 0; ring \u003C ringCount; ring\u002B\u002B)\r\n\t\t{\r\n\t\t\tfloat cellSize = EffectiveBaseCellSize * (1 \u003C\u003C ring);\r\n\r\n\t\t\tVector3 clipmapAnchor = FollowCameraForClipmap ? _CameraPosition : WorldPosition;\r\n\r\n\t\t\tfloat snapX = MathF.Floor(clipmapAnchor.x / cellSize) * cellSize;\r\n\t\t\tfloat snapY = MathF.Floor(clipmapAnchor.y / cellSize) * cellSize;\r\n\r\n\t\t\t_CommandList.Attributes.Set(\u0022VertexBuffer\u0022, m_VertexBuffer);\r\n\t\t\t_CommandList.Attributes.Set(\u0022VertexOffset\u0022, ring * verticesPerRing);\r\n\r\n\t\t\t_CommandList.Attributes.Set(\u0022GridWidth\u0022, EffectiveCellsPerRing);\r\n\t\t\t_CommandList.Attributes.Set(\u0022CellSize\u0022, cellSize);\r\n\r\n\t\t\t_CommandList.Attributes.Set(\u0022SnapPosition\u0022, new Vector2(snapX, snapY));\r\n\t\t\t_CommandList.Attributes.Set(\u0022WaterZ\u0022, WorldPosition.z);\r\n\r\n\t\t\t_CommandList.Attributes.Set(\u0022TilingScale\u0022, 1.0f / outerExtent);\r\n\t\t\t_CommandList.Attributes.Set(\u0022ClampToBounds\u0022, true);\r\n\r\n\t\t\t_CommandList.Attributes.Set(\u0022BoundsMin\u0022, new Vector2(boundsMinX, boundsMinY));\r\n\t\t\t_CommandList.Attributes.Set(\u0022BoundsMax\u0022, new Vector2(boundsMaxX, boundsMaxY));\r\n\r\n\t\t\t_CommandList.DispatchCompute(_Shader, verticesPerRing, 1, 1);\r\n\t\t}\r\n\t}\r\n\r\n\r\n\r\n\tinternal void BarrierTransition(CommandList _CommandList)\r\n\t{\r\n\t\tif (m_VertexBuffer.IsValid())\r\n\t\t\t_CommandList?.ResourceBarrierTransition(m_VertexBuffer, ResourceState.UnorderedAccess, ResourceState.VertexOrIndexBuffer);\r\n\t}\r\n\r\n\r\n\r\n\tinternal void Draw(CommandList _CommandList)\r\n\t{\r\n\t\tif (!ParticipatesInRendering || !HasValidBuffers)\r\n\t\t\treturn;\r\n\t\t\r\n\t\t_CommandList?.DrawIndexed(m_VertexBuffer, m_IndexBuffer, Material, 0, m_TotalIndexCount, m_DrawAttributes);\r\n\t}\r\n\r\n\r\n\r\n\tprivate void UpdateColliderState()\r\n\t{\r\n\t\tm_HullCollider = GetOrAddComponent\u003CHullCollider\u003E();\r\n\t\tm_HullCollider.Flags |= ComponentFlags.Hidden;\r\n\t\tm_HullCollider.Static = true;\r\n\r\n\t\tm_HullCollider.Type = CircleShape ? HullCollider.PrimitiveType.Cylinder : HullCollider.PrimitiveType.Box;\r\n\r\n\t\tm_HullCollider.Center = new Vector3(0, 0, -Depth / 2.0f);\r\n\r\n\t\tif (CircleShape)\r\n\t\t{\r\n\t\t\tm_HullCollider.Radius = MathF.Min(Width, Length) / 2.0f;\r\n\t\t\tm_HullCollider.Radius2 = MathF.Min(Width, Length) / 2.0f;\r\n\t\t\tm_HullCollider.Height = Depth;\r\n\t\t\tm_HullCollider.Slices = CircleSegments;\r\n\t\t}\r\n\t\telse\r\n\t\t{\r\n\t\t\tm_HullCollider.BoxSize = new Vector3(Width, Length, Depth);\r\n\t\t}\r\n\t\t\r\n\t\tm_LastHullCenter = m_HullCollider.Center;\r\n\t\tm_LastHullBoxSize = m_HullCollider.BoxSize;\r\n\r\n\t\tm_HullCollider.IsTrigger = true;\r\n\r\n\t\tTags.Add(\u0022water\u0022);\r\n\t}\r\n\r\n\r\n\r\n\tinternal (Vector3 Center, Vector3 Forward, Vector3 Up, Vector3 HalfExtents) GetWorldOBB()\r\n\t{\r\n\t\treturn (\r\n\t\t\tWorldPosition \u002B (WorldTransform.Up * (-Depth * 0.5f)),\r\n\t\t\tWorldRotation.Forward,\r\n\t\t\tWorldTransform.Up,\r\n\t\t\tnew Vector3(Width * 0.5f, Length * 0.5f, Depth * 0.5f)\r\n\t\t);\r\n\t}\r\n\r\n\r\n\r\n\tprivate void UpdateShaderAttributes()\r\n\t{\r\n\t\tm_DrawAttributes.Set(\u0022RequireWaterInclusionVolumes\u0022, false);\r\n\r\n\t\tWaterDefinition profile = WaterManager.GetWaveProfile(WaterType);\r\n\r\n\t\tif (profile.IsValid())\r\n\t\t\tprofile.ApplyTo(m_DrawAttributes);\r\n\r\n\t\tm_DrawAttributes.Set(\u0022WaterTime\u0022, Time.Now);\r\n\t\tm_DrawAttributes.Set(\u0022DepthMax\u0022, Depth);\r\n\r\n\t\tfloat outerExtent = OuterExtent;\r\n\r\n\t\tVector2 tiling = new Vector2((outerExtent / BASE_TILE_SIZE) * TextureTilingMultiplier, (outerExtent / BASE_TILE_SIZE) * TextureTilingMultiplier);\r\n\r\n\t\tm_DrawAttributes.Set(\u0022NormalTiling\u0022, tiling);\r\n\r\n\t\tWaterManager.Current?.ApplyRippleAttributes(m_DrawAttributes);\r\n\t\tWaterManager.Current?.ApplyCalmAttributes(m_DrawAttributes);\r\n\t\t\r\n\t\t// Band-limit the wave normal to the local clipmap vertex spacing (see shader)\r\n\t\t// Uses the EFFECTIVE grid: the normal\u0027s finite-difference step has to track the real\r\n\t\t// vertex spacing, which coarsens with the LOD level. Feeding the authored values here\r\n\t\t// would reconstruct detail the LODed mesh can\u0027t represent \u2014 the static world-locked\r\n\t\t// moir\u00E9 pattern all over again, worst exactly where LOD kicks in.\r\n\t\tm_DrawAttributes.Set(\u0022WaveNormalEpsScale\u0022, 3.0f / EffectiveCellsPerRing);\r\n\t\tm_DrawAttributes.Set(\u0022WaveNormalEpsMin\u0022, EffectiveBaseCellSize);\r\n\r\n\t\tSetWaterExclusionVolumes(WaterManager.GetViewPosition(Scene, WorldPosition));\r\n\t\tSetHullExclusionVolumes();\r\n\t}\r\n\r\n\r\n\r\n\tprivate void SetWaterExclusionVolumes(Vector3 _ReferencePosition)\r\n\t{\r\n\t\tif (WaterManager.Current == null)\r\n\t\t\treturn;\r\n\r\n\t\tEnsureWaterExclusionVolumeBuffer();\r\n\r\n\t\tvar volumes = WaterManager.Current.ExclusionVolumes\r\n\t\t\t.Where(v =\u003E v.IsValid() \u0026\u0026 v.Active)\r\n\t\t\t.OrderBy(v =\u003E v.WorldPosition.DistanceSquared(_ReferencePosition))\r\n\t\t\t.Take(MAX_WATER_EXCLUSION_VOLUMES)\r\n\t\t\t.ToList();\r\n\r\n\t\tfor (int i = 0; i \u003C volumes.Count; i\u002B\u002B)\r\n\t\t{\r\n\t\t\tvar (center, forward, up, half) = volumes[i].GetWorldOBB();\r\n\r\n\t\t\tint rowOffset = i * WATER_EXCLUSION_VOLUME_ROWS;\r\n\r\n\t\t\tm_WaterExclusionVolumeData[rowOffset \u002B 0] = new Vector4(forward.x, forward.y, forward.z, half.x);\r\n\t\t\tm_WaterExclusionVolumeData[rowOffset \u002B 1] = new Vector4(up.x, up.y, up.z, half.y);\r\n\t\t\tm_WaterExclusionVolumeData[rowOffset \u002B 2] = new Vector4(center.x, center.y, center.z, half.z);\r\n\t\t}\r\n\r\n\t\tm_WaterExclusionVolumeBuffer.SetData(m_WaterExclusionVolumeData.AsSpan(0, volumes.Count * WATER_EXCLUSION_VOLUME_ROWS));\r\n\r\n\t\tm_DrawAttributes.Set(\u0022WaterExclusionVolumeCount\u0022, volumes.Count);\r\n\t\tm_DrawAttributes.Set(\u0022WaterExclusionVolumeRows\u0022, m_WaterExclusionVolumeBuffer);\r\n\t}\r\n\r\n\r\n\r\n\tprivate void EnsureWaterExclusionVolumeBuffer()\r\n\t{\r\n\t\tif (m_WaterExclusionVolumeBuffer.IsValid())\r\n\t\t\treturn;\r\n\r\n\t\tm_WaterExclusionVolumeBuffer = new GpuBuffer\u003CVector4\u003E(MAX_WATER_EXCLUSION_VOLUMES * WATER_EXCLUSION_VOLUME_ROWS);\r\n\t}\r\n\r\n\r\n\r\n\tprivate void SetHullExclusionVolumes()\r\n\t{\r\n\t\tif (WaterManager.Current == null)\r\n\t\t\treturn;\r\n\r\n\t\tvar hulls = WaterManager.Current.HullExclusionVolumes\r\n\t\t\t.Where(h =\u003E h.IsValid() \u0026\u0026 h.Active \u0026\u0026 h.LocalTriangles.Length \u003E 0)\r\n\t\t\t.Take(MAX_HULL_EXCLUSION_VOLUMES)\r\n\t\t\t.ToList();\r\n\t\t\r\n\t\tif (hulls.Count == 0)\r\n\t\t{\r\n\t\t\tm_DrawAttributes.Set(\u0022WaterHullExclusionCount\u0022, 0);\r\n\t\t\treturn;\r\n\t\t}\r\n\r\n\t\tEnsureHullExclusionBuffers();\r\n\r\n\t\t// Triangles are written after the fixed-size metadata section\r\n\t\tint triWriteCursor = HULL_EXCLUSION_META_SIZE;\r\n\r\n\t\tfor (int h = 0; h \u003C hulls.Count; h\u002B\u002B)\r\n\t\t{\r\n\t\t\tvar hull = hulls[h];\r\n\t\t\tvar tris = hull.LocalTriangles;\r\n\t\t\tint triCount = tris.Length / 3;\r\n\r\n\t\t\tif (triWriteCursor \u002B tris.Length \u003E m_HullExclusionData.Length)\r\n\t\t\t\tbreak;\r\n\r\n\t\t\thull.GetWorldToLocalRows(out var r0, out var r1, out var r2, out var r3);\r\n\r\n\t\t\tint meta = h * HULL_EXCLUSION_META_ROWS;\r\n\t\t\tm_HullExclusionData[meta \u002B 0] = r0;\r\n\t\t\tm_HullExclusionData[meta \u002B 1] = r1;\r\n\t\t\tm_HullExclusionData[meta \u002B 2] = r2;\r\n\t\t\tm_HullExclusionData[meta \u002B 3] = r3;\r\n\r\n\t\t\tvar aabb = hull.LocalAABB;\r\n\t\t\t// vertStart is an absolute index into the combined buffer\r\n\t\t\tm_HullExclusionData[meta \u002B 4] = new Vector4(triWriteCursor, triCount, aabb.Mins.x, aabb.Mins.y);\r\n\t\t\tm_HullExclusionData[meta \u002B 5] = new Vector4(aabb.Mins.z, aabb.Maxs.x, aabb.Maxs.y, aabb.Maxs.z);\r\n\r\n\t\t\tfor (int i = 0; i \u003C tris.Length; i\u002B\u002B)\r\n\t\t\t\tm_HullExclusionData[triWriteCursor \u002B i] = new Vector4(tris[i].x, tris[i].y, tris[i].z, 0f);\r\n\r\n\t\t\ttriWriteCursor \u002B= tris.Length;\r\n\t\t}\r\n\r\n\t\tm_HullExclusionBuffer.SetData(m_HullExclusionData.AsSpan(0, triWriteCursor));\r\n\r\n\t\tm_DrawAttributes.Set(\u0022WaterHullExclusionCount\u0022, hulls.Count);\r\n\t\tm_DrawAttributes.Set(\u0022WaterHullExclusionData\u0022, m_HullExclusionBuffer);\r\n\t}\r\n\r\n\r\n\r\n\tprivate void EnsureHullExclusionBuffers()\r\n\t{\r\n\t\tif (!m_HullExclusionBuffer.IsValid())\r\n\t\t\tm_HullExclusionBuffer = new GpuBuffer\u003CVector4\u003E(HULL_EXCLUSION_META_SIZE \u002B MAX_HULL_EXCLUSION_TRIS * 3, GpuBuffer.UsageFlags.Structured);\r\n\t}\r\n\r\n\r\n\r\n\tpublic Vector3 GetWaveDisplacementAt(Vector3 _WorldPosition)\r\n\t{\r\n\t\tWaterDefinition profile = WaterManager.GetWaveProfile(WaterType);\r\n\r\n\t\treturn WaterWaveUtility.ComputeDisplacementAt(_WorldPosition, profile);\r\n\t}\r\n\r\n\r\n\r\n\tpublic Vector3 GetWaveVelocityAt(Vector3 _WorldPosition)\r\n\t{\r\n\t\tWaterDefinition profile = WaterManager.GetWaveProfile(WaterType);\r\n\r\n\t\treturn WaterWaveUtility.ComputeVelocityAt(_WorldPosition, profile);\r\n\t}\r\n\r\n\r\n\r\n\tpublic float GetWaveHeightAt(Vector3 _WorldPosition)\r\n\t{\r\n\t\treturn WorldPosition.z \u002B GetWaveDisplacementAt(_WorldPosition).z;\r\n\t}\r\n}\r\n"}]}