# ninpo3d/fluidsimulation-unity6 architecture

> Architecture diagram of the GitHub repository ninpo3d/fluidsimulation-unity6, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ninpo3d/fluidsimulation-unity6
- Repository: https://github.com/ninpo3d/fluidsimulation-unity6

## Overview

This Unity project is a mobile real-time shallow-water and pigment simulation. The main workflow is pointer/touch interaction, optional parameter adjustment through the HUD, wave-and-pigment simulation, then displaced and shaded surface rendering. The README documents these capabilities and the named implementation files, but no source excerpts were provided, so links reflect documented behavior rather than verified calls between scripts.

Main entry points: [`Assets/FluidSimulation/Scripts/FluidSimulator.cs`](https://github.com/ninpo3d/fluidsimulation-unity6/blob/main/Assets/FluidSimulation/Scripts/FluidSimulator.cs) (Fluid Simulator), [`Assets/FluidSimulation/Scripts/FluidPointerInput.cs`](https://github.com/ninpo3d/fluidsimulation-unity6/blob/main/Assets/FluidSimulation/Scripts/FluidPointerInput.cs) (Pointer Input), [`Assets/FluidSimulation/Scripts/FluidSurfaceInteraction.cs`](https://github.com/ninpo3d/fluidsimulation-unity6/blob/main/Assets/FluidSimulation/Scripts/FluidSurfaceInteraction.cs) (Surface Interaction), [`Assets/FluidSimulation/Scripts/FluidMobileUI.cs`](https://github.com/ninpo3d/fluidsimulation-unity6/blob/main/Assets/FluidSimulation/Scripts/FluidMobileUI.cs) (Parameter HUD)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["User Interaction"]
  node_pointer["Pointer Input"]
  node_surface_input["Surface Interaction"]
  node_hud["Parameter HUD<br/>[FluidMobileUI.cs]"]
end

subgraph group_simulation["Fluid Simulation"]
  node_simulator["Fluid Simulator<br/>[FluidSimulator.cs]"]
  node_fluid_state[("Ping-Pong State<br/>[FluidSimulator.cs]")]
  node_blit["Simulation Blit"]
end

subgraph group_rendering["Surface Rendering"]
  node_plane["Procedural Plane<br/>[ProceduralPlane.cs]"]
  node_displacement["Displacement Shader"]
  node_shader_core["Displacement Core"]
  node_shader_input["Shader Inputs"]
end

subgraph group_scene["Scene Assets"]
  node_material["Fluid Material"]
  node_demo_scene["Paint Demo Scene"]
end

node_user(("Player"))

node_user -->|"provides input"| node_pointer
node_user -->|"adjusts parameters"| node_hud
node_pointer -->|"touch mapping"| node_surface_input
node_surface_input -->|"interacts with fluid"| node_simulator
node_hud -->|"sets parameters"| node_simulator
node_simulator -->|"updates state"| node_fluid_state
node_simulator -->|"solves wave pass"| node_blit
node_fluid_state -->|"drives surface"| node_displacement
node_plane -.->|"provides surface"| node_displacement
node_demo_scene -.->|"uses material"| node_material

click node_pointer "https://github.com/ninpo3d/fluidsimulation-unity6/blob/main/Assets/FluidSimulation/Scripts/FluidPointerInput.cs"
click node_surface_input "https://github.com/ninpo3d/fluidsimulation-unity6/blob/main/Assets/FluidSimulation/Scripts/FluidSurfaceInteraction.cs"
click node_hud "https://github.com/ninpo3d/fluidsimulation-unity6/blob/main/Assets/FluidSimulation/Scripts/FluidMobileUI.cs"
click node_simulator "https://github.com/ninpo3d/fluidsimulation-unity6/blob/main/Assets/FluidSimulation/Scripts/FluidSimulator.cs"
click node_fluid_state "https://github.com/ninpo3d/fluidsimulation-unity6/blob/main/Assets/FluidSimulation/Scripts/FluidSimulator.cs"
click node_blit "https://github.com/ninpo3d/fluidsimulation-unity6/blob/main/Assets/FluidSimulation/Shaders/FluidSimulationBlit.shader"
click node_plane "https://github.com/ninpo3d/fluidsimulation-unity6/blob/main/Assets/FluidSimulation/Scripts/ProceduralPlane.cs"
click node_displacement "https://github.com/ninpo3d/fluidsimulation-unity6/blob/main/Assets/FluidSimulation/Shaders/FluidDisplacement.shader"
click node_shader_core "https://github.com/ninpo3d/fluidsimulation-unity6/blob/main/Assets/FluidSimulation/Shaders/FluidDisplacementCore.hlsl"
click node_shader_input "https://github.com/ninpo3d/fluidsimulation-unity6/blob/main/Assets/FluidSimulation/Shaders/FluidDisplacementInput.hlsl"
click node_material "https://github.com/ninpo3d/fluidsimulation-unity6/blob/main/Assets/FluidSimulation/Materials/M_FluidDisplacement.mat"
click node_demo_scene "https://github.com/ninpo3d/fluidsimulation-unity6/blob/main/Assets/FluidSimulation/Scenes/LVL3_PaintDemo.unity"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_pointer,node_surface_input,node_hud toneBlue
class node_simulator,node_fluid_state,node_blit toneAmber
class node_plane,node_displacement,node_shader_core,node_shader_input toneMint
class node_material,node_demo_scene toneRose
class node_user toneIndigo
```

## Components

### User Interaction

- [Pointer Input](https://github.com/ninpo3d/fluidsimulation-unity6/blob/main/Assets/FluidSimulation/Scripts/FluidPointerInput.cs): `Assets/FluidSimulation/Scripts/FluidPointerInput.cs`
- [Surface Interaction](https://github.com/ninpo3d/fluidsimulation-unity6/blob/main/Assets/FluidSimulation/Scripts/FluidSurfaceInteraction.cs): `Assets/FluidSimulation/Scripts/FluidSurfaceInteraction.cs`
- [Parameter HUD](https://github.com/ninpo3d/fluidsimulation-unity6/blob/main/Assets/FluidSimulation/Scripts/FluidMobileUI.cs): `Assets/FluidSimulation/Scripts/FluidMobileUI.cs`

### Fluid Simulation

- [Fluid Simulator](https://github.com/ninpo3d/fluidsimulation-unity6/blob/main/Assets/FluidSimulation/Scripts/FluidSimulator.cs): `Assets/FluidSimulation/Scripts/FluidSimulator.cs`
- [Ping-Pong State](https://github.com/ninpo3d/fluidsimulation-unity6/blob/main/Assets/FluidSimulation/Scripts/FluidSimulator.cs): `Assets/FluidSimulation/Scripts/FluidSimulator.cs`
- [Simulation Blit](https://github.com/ninpo3d/fluidsimulation-unity6/blob/main/Assets/FluidSimulation/Shaders/FluidSimulationBlit.shader): `Assets/FluidSimulation/Shaders/FluidSimulationBlit.shader`

### Surface Rendering

- [Procedural Plane](https://github.com/ninpo3d/fluidsimulation-unity6/blob/main/Assets/FluidSimulation/Scripts/ProceduralPlane.cs): `Assets/FluidSimulation/Scripts/ProceduralPlane.cs`
- [Displacement Shader](https://github.com/ninpo3d/fluidsimulation-unity6/blob/main/Assets/FluidSimulation/Shaders/FluidDisplacement.shader): `Assets/FluidSimulation/Shaders/FluidDisplacement.shader`
- [Displacement Core](https://github.com/ninpo3d/fluidsimulation-unity6/blob/main/Assets/FluidSimulation/Shaders/FluidDisplacementCore.hlsl): `Assets/FluidSimulation/Shaders/FluidDisplacementCore.hlsl`
- [Shader Inputs](https://github.com/ninpo3d/fluidsimulation-unity6/blob/main/Assets/FluidSimulation/Shaders/FluidDisplacementInput.hlsl): `Assets/FluidSimulation/Shaders/FluidDisplacementInput.hlsl`

### Scene Assets

- [Fluid Material](https://github.com/ninpo3d/fluidsimulation-unity6/blob/main/Assets/FluidSimulation/Materials/M_FluidDisplacement.mat): `Assets/FluidSimulation/Materials/M_FluidDisplacement.mat`
- [Paint Demo Scene](https://github.com/ninpo3d/fluidsimulation-unity6/blob/main/Assets/FluidSimulation/Scenes/LVL3_PaintDemo.unity): `Assets/FluidSimulation/Scenes/LVL3_PaintDemo.unity`

### Other components

- **Player**

## Connections

- Player → Pointer Input: provides input (evidence: `README.md`)
- Player → Parameter HUD: adjusts parameters (evidence: `README.md`)
- Pointer Input → Surface Interaction: touch mapping (evidence: `README.md`)
- Surface Interaction → Fluid Simulator: interacts with fluid (evidence: `README.md`)
- Parameter HUD → Fluid Simulator: sets parameters (evidence: `README.md`)
- Fluid Simulator → Ping-Pong State: updates state (evidence: `README.md`)
- Fluid Simulator → Simulation Blit: solves wave pass (evidence: `README.md`)
- Ping-Pong State → Displacement Shader: drives surface (evidence: `README.md`)
- Procedural Plane → Displacement Shader: provides surface
- Paint Demo Scene → Fluid Material: uses material
