Amazonian Nature Aquascape & Altum Angelfish Sanctuary

1:1 ADA 90-P Rimless Nature Aquarium, 60 Hz Altum Angelfish & Articulated Sump Rig

01 / What Was Built

Interactive, gallery-grade 3D ADA 90-P (90 × 45 × 45 cm) rimless nature aquarium built in Three.js (r186, WebGL2, 4x MSAA HalfFloat + AgX post-chain). Combines a Takashi Amano–inspired bogwood-and-Seiryu-stone underwater landscape with 60 Hz biomechanically swimming Pterophyllum altum angelfish, 18 schooling Cardinal Tetras, grazing Caridina shrimp and zebra snails, real-time GLSL water caustics/meniscus/pearling, and an articulated gallery cabinet housing a stainless canister filter and live CO2 bubble-counter rig.

02 / Creation Pipeline & Workflow

Engineered with Gemini Carbon across four specialized local asset pipelines: (1) Blender 5.2 profile lofts + Cycles 2K PBR bakes for rigged Altum angelfish (silhouette IoU = 0.808), Cardinal Tetras, shrimp, and snails; (2) #F2F2F2 studio sprites reconstructed locally on-device via the Local TripoSG pipeline + Blender watertight repair & 4K bark micro-normals for driftwood arches and Seiryu stones; (3) exact metric build123d CAD + Cycles 2K PBR for the ±80° hinged gallery cabinet, stainless canister filter, dual-gauge CO2 regulator, and CNC LED luminaire; and (4) runtime Three.js analytic heightfields, BVH flora ray-snapping, and custom GLSL underwater caustics/meniscus shaders.

03 / Scene, Simulation & Optical Highlights

011:1 Metric Gallery Setup: 0.90 × 0.45 × 0.45 m 10 mm low-iron OptiWhite tank on a 0.78 m dark gallery stand with 0°–80° hinged front doors, external filter hoses, right-side borosilicate CO2 U-bend + 96-bubble ceramic diffuser, lily pipes, and a suspended CNC LED luminaire.
02Live 60 Hz Ecosystem: 2 hero Pterophyllum altum gliding with C-to-S spine bending, turn-rate banking, and pectoral fin rowing; 18 Boids-schooling Paracheirodon axelrodi; 5 walking Caridina shrimp and 3 Neritina zebra snails surface-projected onto stones and wood; 5 flora species swaying in a shared lily-pipe flow field.
03Underwater Optics & Post-Chain: Capillary 3.5 mm wave meniscus, projected underwater-only caustics, volumetric light shafts, Beer-Lambert depth absorption, rising O2 leaf-pearling streams, and peripheral thin-lens DoF.
04Gallery HUD: Rendered cleanly outside post-processing with 3 lighting moods (Daylight, Twilight, Moonlight via 1–3), 5 camera views (Gallery Front, Sand River, Submerged Arch, Pedestal, Free Orbit via Shift+1–5), Cabinet Doors (O), and clean-screen toggle (H).

Three.js r186WebGL2GLSLBlender 5.2build123d CADLocal TripoSG

Interactive Controls

1 – 3 · Shift + 1 – 5Switch Daylight / Twilight / Moonlight moods and 5 curated camera views

O · HSwing open ±80° sump cabinet doors (O) or toggle clean-screen gallery mode (H)

Drag / ScrollFree-orbit tank, bogwood arches, lily pipes, and CO2 regulator sump

Metric Standard & Quality Gates

Coordinate & Metric Datum: 1 unit = 1 meter, +Y up, origin (0, 0, 0) at center of tank bottom outer glass face (waterLevel = 0.425 m, galleryFloor = -0.785 m).
Automated Verification Suite: Automated checks verify metric dimensions, closed/open cabinet interpenetration & attachment, reserved swim/sightline corridors, Altum reference silhouette match (IoU = 0.808), pixel exposure sanity, and 5 live behavior tests (test-01..05).
Master Showcase Capture: Native 3840x2160 @ 60 fps (64.0 s, CRF 14, -14 LUFS procedural felt-piano + hydrophone score) in both interactive HUD + live cursor and clean cinema editions.

AI Models & Role

Gemini Carbon

Monumental WebGPU TSL 3D projection mapping, OpenCascade Hot-V twin-turbo V8 CAD digital twins, two-stage Unity 6.6 + Blender 3D action games, living ecosystems, and beveled micro-voxel kinematics.

04 / Element-by-Element Build Breakdown

Asset foundry provenance — CAD, Blender Cycles PBR, 3D-Gen, TSL/GLSL & procedural audio

Altum Angelfish (2×)

Blender 5.2 Loft + Cycles 2K PBR + Rig

Lateral profile traced from Wikimedia ref (IoU = 0.81), metallic silver-amber & vertical-bar Cycles bake, PectoralLeft/RightPivot + runtime C-to-S spine skinning

Cardinal Tetras (18×)

Blender 5.2 Loft + Cycles 2K PBR

Traced body/fin loft with baked iridescent cyan-blue & ventral crimson stripes, driven by 60 Hz Boids schooling

Caridina Shrimp (5×) & Nerite Snails (3×)

Blender 5.2 Sculpt + Cycles 2K PBR

Translucent carapace & segmented walking legs (shrimp) + whorled zebra shell (snail), surface-normal snapped to hardscape

Driftwood Arches (3×)

#F2F2F2 Sprite → Local TripoSG Pipeline → Blender Polish

Single-item studio sprites reconstructed locally on-device via the Local TripoSG pipeline, watertight wood repair, seated pivots, and 4K bark micro-normals

Seiryu Stones (Oyaishi, Fukuishi, Bank & Talus)

#F2F2F2 Sprite → Local TripoSG Pipeline + Blender Voronoi

Local TripoSG image-to-3D hero/bank rocks + procedural fractured sub-stones with white calcite veins, buried 1/3 into aquasoil

Gallery Cabinet (0.90 × 0.45 × 0.78 m)

build123d CAD + Blender Surgical Rig

Exact metric solid CAD, Cycles 2K dark brushed finish, and DoorLeftPivot / DoorRightPivot (±80° hinges) + hose grommets

Canister Filter & CO2 Regulator Rig

build123d CAD + Cycles 2K PBR + Runtime

Stainless canister with clamps + pressurized CO2 cylinder, dual red-needle gauges, and live rising mineral-oil bubble counter

Suspended CNC LED Luminaire

build123d CAD + Cycles 2K PBR

Slim 0.86 m anodized aluminum heatsink bar with emissive diffuser and parametric ceiling suspension cables

Borosilicate Lily Pipes & CO2 Diffuser

Blender 5.2 Parametric + Runtime Glassware

Double-walled 1.8 mm swept J-hook lily outflow & laser-slotted intake + right-wall CO2 U-bend, check valve & 96-bubble ceramic frit

Rimless OptiWhite Tank & Plumbing Hoses

Runtime Parametric

10 mm low-iron beveled glass panes with green-cyan cut-edge refraction, 1.5 mm silicone seams, 5 mm EVA mat, and translucent water-core hoses

Aquasoil Terraces & Winding Sand River

Runtime Analytic Heightfield

Shared elevation & corridor field keeping the buff sand river clear while guaranteeing 0 floating plant stems

Aquatic Flora (5 Species)

Runtime Parametric + BVH Ray-Snap

Monte Carlo carpet clumps, rosette Amazon Swords, BVH crevice-snapped Anubias & Bucephalandra, moss cushions, and Vallisneria curtain with flow sway

Water Meniscus, Caustics, Light Shafts & Pearling

Custom GLSL Shaders + Particle Sim

Wave heightfield meniscus, underwater-clipped caustics injection, volumetric shafts, Beer-Lambert falloff, and rising O2 leaf bubbles

Studio Lighting Environment

CC0 2K HDRI (curated HDRI)

Poly Haven studio_small_09_2k.hdr paired with mood-interpolated overhead LED and sun key lights

Scene Element	Pipeline / Tooling	How It Was Built
Altum Angelfish (2×)	Blender 5.2 Loft + Cycles 2K PBR + Rig	Lateral profile traced from Wikimedia ref (IoU = 0.81), metallic silver-amber & vertical-bar Cycles bake, PectoralLeft/RightPivot + runtime C-to-S spine skinning
Cardinal Tetras (18×)	Blender 5.2 Loft + Cycles 2K PBR	Traced body/fin loft with baked iridescent cyan-blue & ventral crimson stripes, driven by 60 Hz Boids schooling
Caridina Shrimp (5×) & Nerite Snails (3×)	Blender 5.2 Sculpt + Cycles 2K PBR	Translucent carapace & segmented walking legs (shrimp) + whorled zebra shell (snail), surface-normal snapped to hardscape
Driftwood Arches (3×)	#F2F2F2 Sprite → Local TripoSG Pipeline → Blender Polish	Single-item studio sprites reconstructed locally on-device via the Local TripoSG pipeline, watertight wood repair, seated pivots, and 4K bark micro-normals
Seiryu Stones (Oyaishi, Fukuishi, Bank & Talus)	#F2F2F2 Sprite → Local TripoSG Pipeline + Blender Voronoi	Local TripoSG image-to-3D hero/bank rocks + procedural fractured sub-stones with white calcite veins, buried 1/3 into aquasoil
Gallery Cabinet (0.90 × 0.45 × 0.78 m)	build123d CAD + Blender Surgical Rig	Exact metric solid CAD, Cycles 2K dark brushed finish, and DoorLeftPivot / DoorRightPivot (±80° hinges) + hose grommets
Canister Filter & CO2 Regulator Rig	build123d CAD + Cycles 2K PBR + Runtime	Stainless canister with clamps + pressurized CO2 cylinder, dual red-needle gauges, and live rising mineral-oil bubble counter
Suspended CNC LED Luminaire	build123d CAD + Cycles 2K PBR	Slim 0.86 m anodized aluminum heatsink bar with emissive diffuser and parametric ceiling suspension cables
Borosilicate Lily Pipes & CO2 Diffuser	Blender 5.2 Parametric + Runtime Glassware	Double-walled 1.8 mm swept J-hook lily outflow & laser-slotted intake + right-wall CO2 U-bend, check valve & 96-bubble ceramic frit
Rimless OptiWhite Tank & Plumbing Hoses	Runtime Parametric	10 mm low-iron beveled glass panes with green-cyan cut-edge refraction, 1.5 mm silicone seams, 5 mm EVA mat, and translucent water-core hoses
Aquasoil Terraces & Winding Sand River	Runtime Analytic Heightfield	Shared elevation & corridor field keeping the buff sand river clear while guaranteeing 0 floating plant stems
Aquatic Flora (5 Species)	Runtime Parametric + BVH Ray-Snap	Monte Carlo carpet clumps, rosette Amazon Swords, BVH crevice-snapped Anubias & Bucephalandra, moss cushions, and Vallisneria curtain with flow sway
Water Meniscus, Caustics, Light Shafts & Pearling	Custom GLSL Shaders + Particle Sim	Wave heightfield meniscus, underwater-clipped caustics injection, volumetric shafts, Beer-Lambert falloff, and rising O2 leaf bubbles
Studio Lighting Environment	CC0 2K HDRI (curated HDRI)	Poly Haven studio_small_09_2k.hdr paired with mood-interpolated overhead LED and sun key lights