Files
hydro-builder-app/docs/graphics_proposals.md
2026-06-13 17:36:44 -07:00

51 lines
3.4 KiB
Markdown

# Graphics Design Proposals — 10 Visual Upgrades (Water Focus)
A list of 10 graphic design concepts to make the Hydro Builder look stunning and professional, with water flow as the primary focus, along with strategies to prevent lag.
---
## 10 Graphic Design Proposals
### 1. Transparent Refractive Pipe Walls (PBR)
* **Visual:** Overhaul the solid PVC pipe cylinders to use a translucent, refractive `MeshPhysicalMaterial` with high transmission and thickness. You will see the glowing water column refract inside a clear transparent pipe, like real acrylic or clear braided vinyl tubing.
### 2. GPU Vertex-Displaced Wave Ripples
* **Visual:** Replace the flat water plane in the reservoir with a custom vertex shader. Oscillate the grid vertices in a wave pattern using sine-noise functions, creating realistic, undulating water surface ripples when pumps are circulating.
### 3. Animated Splashes and Drops at Drain Outlets
* **Visual:** Add a GPU particle emitter system at the exits of drains and emitters. When flowing, little cyan water drops spray downwards into the reservoir or trays, creating the visual dynamics of cascading water.
### 4. Aeration Flow Bubble Streams
* **Visual:** Draw tiny, animated circular air bubble particles inside the pipe flow texture that stretch vertically (motion blur) into speed-streaks under high velocities.
### 5. Temperature/Nutrient Color Grading
* **Visual:** Grade the water color dynamically along the flow path: supply lines can be bright, aerated cyan-blue, while return drains can fade into a slightly deeper, organic blue-green to represent nutrient and oxygen shifts.
### 6. Emissive Liquid Glow
* **Visual:** Give the water columns a light emissive glow. In X-Ray or Dark modes, the pipelines will project a soft blue light onto nearby structures (like the inside of grow tents or bucket rows).
### 7. Liquid Caustic Projection
* **Visual:** Project a dynamic, light-refracting caustic texture onto the floor grid beneath the reservoir. The light patterns will shift and animate, simulating sunshine refracting through moving liquid.
### 8. Condensation Droplets normal maps
* **Visual:** Apply a condensation normal map to the outside of cold water supply lines, showing tiny beads of moisture forming on the outer pipe shell in high-humidity modes.
### 9. Grow Light volumetric beams (God Rays)
* **Visual:** Add a soft, transparent conical mesh beneath grow lights with a shifting noise texture, representing light beams cutting through the air.
### 10. High-Reflectivity Structural Frames
* **Visual:** Update the grow trays, frames, and stands to use highly reflective metallic PBR materials that catch the light and soft reflections from the grow light beams and glowing water lines.
---
## Performance Optimization (Lag-Free Strategy)
To implement these high-fidelity graphics without dropping frames, we apply the following guidelines:
1. **GPU-Bound Animations (Vertex & Fragment Shaders):**
- All scrolling textures, bubble movement, and water surface wave displacements are calculated entirely on the GPU. The CPU does not touch the coordinates, maintaining a constant 60+ FPS.
2. **Instanced Mesh Rendering:**
- Draw repeating identical parts (like Net Pots or Wall Panels) using a single Draw Call via Three.js `InstancedMesh`.
3. **Frustum Culling & Level of Detail (LOD):**
- Automatically bypass complex shaders and shadow-casting for parts that are outside the camera's view frustum or positioned far away.