beezm
b1cf282295
Presentation only. Nothing here touches Topography, the noise, or any generation constant; the renderer is handed a height field LOADED from a .f32 dump and has no way to produce one, so a look change provably cannot move the terrain. Hillshade: Horn 3x3, cell size 1, edges clamped (never wrapped — the Trench border is a wall, not a seam). ZExaggeration is required rather than optional: measured median land slope is 0.22 degrees unexaggerated, so the island shades as a flat plane. Chosen from a measured slope table — zex 75 gives 16/28/37 deg at land median/p90/p99, which reads as natural relief. It is a look dial; raw units are not metres and no code may read it as if they were. Palette: stops placed on the MEASURED height distribution, not spread linearly. Land is bottom-heavy (median 0.456, p99 1.113, max 1.415 over 8.6M land columns across four seeds), so a linear ramp would spend 99% of its range on 1% of the land and the map would read as green with a few white dots. Bathymetry is compressed by d/(d+0.35) so the shallow shelf gets the range and the featureless abyss flattens. Anchors are absolute and fixed across the batch — a map coloured on its own min/max cannot be compared with its neighbour, and comparison is the point of a batch. Blend: the naive tint x hillshade darkens everything by 29% before any slope is involved, because flat ground shades to sin(altitude). So shade is normalized by its flat-ground value first — flat terrain keeps its true tint and only SLOPE moves the colour — then shadows multiply while highlights screen toward white. That asymmetry is the difference between a colour ramp and a map you would frame. Relief fades to zero with depth below sea. Not only taste: the deep floor is the Trench, a synthetic wall whose gradient is ~1.5x the p99 land gradient, so shading it faithfully draws a bright rim around the map and lights the abyss with noise mottle. The fade puts relief on the near-shore shelf where the bathymetry is real. Three named looks (atlas / relief / dusk), gated like any other change and kept deliberately few — iteration fatigue on a subjective gate is a real failure mode. Each pair isolates one question. HeightMapRenderer.cs is retired: its raw I/O moved to HeightField.cs and its ramp to ReliefPalette.cs, so there is one palette everywhere and the generator's own quick-look is coloured identically to a beauty render. No biome words, no classification, no water. The 0.15 line is a colour boundary.
217 lines
9.5 KiB
C#
217 lines
9.5 KiB
C#
using System;
|
||
using System.Collections.Generic;
|
||
using System.IO;
|
||
using System.Text;
|
||
using Godot;
|
||
using IslaApocalypse.Core;
|
||
|
||
namespace IslaApocalypse.Tools
|
||
{
|
||
/// <summary>
|
||
/// The taste-gate renderer: re-colours existing height fields into shaded-relief maps across a
|
||
/// small set of named looks, and writes an INDEX.md for browsing.
|
||
///
|
||
/// ⚠ IT RE-COLOURS; IT DOES NOT REGENERATE. Height fields are LOADED from the `.f32` dumps a
|
||
/// generation run left behind, so a look change provably cannot move the terrain. Only when a
|
||
/// dump is missing for the requested size — a showpiece at 4096, say, where no dump exists —
|
||
/// does it generate one, deterministically from the same seed. Same seed, same island.
|
||
///
|
||
/// ═══ RUNNING IT ═══
|
||
///
|
||
/// Godot_v4.7.2-stable_mono_linux.x86_64 --headless \
|
||
/// --path ~/celerNexus/islaApocalypse-v2 res://Tools/Scenes/ReliefRenderTool.tscn
|
||
///
|
||
/// ISLA_MAPSIZE side in columns (default 2048)
|
||
/// ISLA_SEEDS comma-separated positive (default: the 4 pinned seeds)
|
||
/// ISLA_LOOKS comma-separated look names (default: atlas,relief,dusk)
|
||
/// ISLA_BATCH output batch folder (default 03_relief_taste)
|
||
/// ISLA_SOURCE batch to read .f32 from (default 01_pass1_port)
|
||
/// ISLA_DUMP_RAW "1" to also dump .f32 when a field had to be generated
|
||
/// </summary>
|
||
public partial class ReliefRenderTool : Node
|
||
{
|
||
private static readonly int[] DefaultSeeds = { 1063685222, 20260819, 777001, 424242 };
|
||
|
||
public override void _Ready()
|
||
{
|
||
ToolingPaths.Configure(OS.GetUserDataDir());
|
||
|
||
int mapSize = EnvInt("ISLA_MAPSIZE", 2048);
|
||
int[] seeds = EnvSeeds("ISLA_SEEDS", DefaultSeeds);
|
||
string batch = EnvStr("ISLA_BATCH", "03_relief_taste");
|
||
string source = EnvStr("ISLA_SOURCE", "01_pass1_port");
|
||
bool dumpRaw = EnvStr("ISLA_DUMP_RAW", "0") == "1";
|
||
LookConfig[] looks = SelectLooks(EnvStr("ISLA_LOOKS", null));
|
||
|
||
string batchRoot = Path.Combine(ToolingPaths.BatchesRoot, batch);
|
||
string sourceRoot = Path.Combine(ToolingPaths.BatchesRoot, source);
|
||
DirAccess.MakeDirRecursiveAbsolute(batchRoot);
|
||
DirAccess.MakeDirRecursiveAbsolute(ToolingPaths.BatchScratch(batchRoot));
|
||
|
||
GD.Print("==================================================================");
|
||
GD.Print(" SHADED RELIEF — hypsometric tint + hillshade (Phase 1, the look)");
|
||
GD.Print("==================================================================");
|
||
GD.Print($"MapSize : {mapSize}");
|
||
GD.Print($"seeds : {string.Join(", ", seeds)}");
|
||
GD.Print($"looks : {string.Join(", ", Array.ConvertAll(looks, l => l.Name))}");
|
||
GD.Print($"source : {sourceRoot} (.f32 dumps; generated only if absent)");
|
||
GD.Print($"out : {batchRoot}");
|
||
GD.Print("------------------------------------------------------------------");
|
||
foreach (var l in looks) GD.Print($" {l}");
|
||
GD.Print("==================================================================");
|
||
|
||
var rows = new List<string>();
|
||
|
||
foreach (int seed in seeds)
|
||
{
|
||
// --- get the height field: LOAD if a dump exists, generate only as a fallback ---
|
||
ulong t0 = Time.GetTicksMsec();
|
||
string dumpPath = Path.Combine(sourceRoot, $"{seed}_full", "height.f32");
|
||
float[,] height = HeightField.Load(dumpPath, mapSize);
|
||
string origin;
|
||
|
||
if (height != null)
|
||
{
|
||
origin = "loaded";
|
||
}
|
||
else
|
||
{
|
||
var cfg = new TerrainGenConfig { MapSize = mapSize, Seed = seed, VariantLabel = "full" };
|
||
Pass1Result r = Topography.Generate(cfg);
|
||
height = r.Height;
|
||
origin = "generated";
|
||
if (dumpRaw)
|
||
{
|
||
string dir = Path.Combine(batchRoot, $"{seed}_source");
|
||
DirAccess.MakeDirRecursiveAbsolute(dir);
|
||
HeightField.Save(height, mapSize, Path.Combine(dir, "height.f32"));
|
||
}
|
||
}
|
||
ulong tLoad = Time.GetTicksMsec() - t0;
|
||
|
||
float hMin = float.MaxValue, hMax = float.MinValue;
|
||
for (int x = 0; x < mapSize; x++)
|
||
for (int y = 0; y < mapSize; y++)
|
||
{
|
||
float v = height[x, y];
|
||
if (v < hMin) hMin = v;
|
||
if (v > hMax) hMax = v;
|
||
}
|
||
|
||
GD.Print($"\n seed {seed} [{origin} in {tLoad} ms] h[{hMin:F3} .. {hMax:F3}]");
|
||
|
||
foreach (LookConfig look in looks)
|
||
{
|
||
ulong t1 = Time.GetTicksMsec();
|
||
string dir = Path.Combine(batchRoot, $"{seed}_{look.Name}");
|
||
DirAccess.MakeDirRecursiveAbsolute(dir);
|
||
ReliefRenderer.SavePng(height, mapSize, look, Path.Combine(dir, "relief.png"));
|
||
ulong ms = Time.GetTicksMsec() - t1;
|
||
|
||
GD.Print($" {look.Name,-8} -> {dir}/relief.png {ms} ms");
|
||
rows.Add($"| `{seed}_{look.Name}` | {seed} | {look.Name} | {look.Palette} | " +
|
||
$"{look.ZExaggeration:F0} | {look.LightAzimuth:F0}°/{look.LightAltitude:F0}° | " +
|
||
$"{look.HillshadeStrength:F2} | {ms} ms |");
|
||
}
|
||
}
|
||
|
||
WriteIndex(batchRoot, mapSize, seeds, looks, source, rows);
|
||
|
||
GD.Print("\n==================================================================");
|
||
GD.Print($" DONE — {rows.Count} renders in {batchRoot}");
|
||
GD.Print("==================================================================");
|
||
GetTree().Quit(0);
|
||
}
|
||
|
||
private static LookConfig[] SelectLooks(string csv)
|
||
{
|
||
LookConfig[] all = LookConfig.Variants();
|
||
if (string.IsNullOrWhiteSpace(csv)) return all;
|
||
|
||
var picked = new List<LookConfig>();
|
||
foreach (string want in csv.Split(',', StringSplitOptions.RemoveEmptyEntries))
|
||
foreach (LookConfig l in all)
|
||
if (string.Equals(l.Name, want.Trim(), StringComparison.OrdinalIgnoreCase))
|
||
picked.Add(l);
|
||
return picked.Count > 0 ? picked.ToArray() : all;
|
||
}
|
||
|
||
private static void WriteIndex(string batchRoot, int mapSize, int[] seeds,
|
||
LookConfig[] looks, string source, List<string> rows)
|
||
{
|
||
var (landLo, landHi) = ReliefPalette.LandAnchors;
|
||
var sb = new StringBuilder();
|
||
sb.AppendLine("# Batch — shaded relief, the taste gate (Phase 1)");
|
||
sb.AppendLine();
|
||
sb.AppendLine("**Presentation only.** These are the *same* height fields as");
|
||
sb.AppendLine($"`{source}` — loaded from its `.f32` dumps, not regenerated. Nothing here can move the");
|
||
sb.AppendLine("terrain; only its colours and its lighting differ.");
|
||
sb.AppendLine();
|
||
sb.AppendLine($"- **MapSize:** {mapSize}");
|
||
sb.AppendLine($"- **Sea colour boundary:** 0.15 — a *colour* boundary, **not a water surface.** No water is modelled (Phase 2).");
|
||
sb.AppendLine($"- **Palette anchors (FIXED across every image):** land {landLo} .. {landHi}; sea compressed by `d/(d+{ReliefPalette.SeaCompression})`");
|
||
sb.AppendLine($"- **Seeds:** {string.Join(", ", seeds)}");
|
||
sb.AppendLine();
|
||
sb.AppendLine("## ⭐ Pick a look");
|
||
sb.AppendLine();
|
||
sb.AppendLine("Three, deliberately — a subjective gate drowns in a wall of near-duplicates. Each pair");
|
||
sb.AppendLine("isolates one question:");
|
||
sb.AppendLine();
|
||
sb.AppendLine("| Look | Palette | Z-exag | Light | Strength | The question it answers |");
|
||
sb.AppendLine("|---|---|---|---|---|---|");
|
||
foreach (LookConfig l in looks)
|
||
{
|
||
string q = l.Name switch
|
||
{
|
||
"atlas" => "the baseline — classic physical-atlas plate, tint-forward",
|
||
"relief" => "**vs `atlas`:** how strong should the relief be? (same palette + light)",
|
||
"dusk" => "**vs `atlas`:** warmer palette and a lower sun — better, or too much?",
|
||
_ => "",
|
||
};
|
||
sb.AppendLine($"| `{l.Name}` | {l.Palette} | {l.ZExaggeration:F0} | {l.LightAzimuth:F0}°/{l.LightAltitude:F0}° | {l.HillshadeStrength:F2} | {q} |");
|
||
}
|
||
sb.AppendLine();
|
||
sb.AppendLine("Compare the **same seed** across the three folders. `1063685222` is the reference's own");
|
||
sb.AppendLine("commented seed and the one used throughout tasks 02–03.");
|
||
sb.AppendLine();
|
||
sb.AppendLine("> ⚠ **The seabed is raw, and that is expected — not unfinished-because-broken.** The");
|
||
sb.AppendLine("> submarine coast shelf and the offshore islets are DEFERRED Phase-2 items; they act only");
|
||
sb.AppendLine("> below sea level and are judged once water renders. Relief is deliberately dialled back");
|
||
sb.AppendLine("> underwater so the eye is not dragged to the one surface that is knowingly incomplete.");
|
||
sb.AppendLine();
|
||
sb.AppendLine("> ⚠ **No biome colour here.** This is height + slope + above/below sea, on a continuous");
|
||
sb.AppendLine("> ramp. White at the top is snow-*coloured cartography*, not a snow biome.");
|
||
sb.AppendLine();
|
||
sb.AppendLine("## Renders");
|
||
sb.AppendLine();
|
||
sb.AppendLine("| Folder | Seed | Look | Palette | Z-exag | Light | Strength | Time |");
|
||
sb.AppendLine("|---|---|---|---|---|---|---|---|");
|
||
foreach (string r in rows) sb.AppendLine(r);
|
||
sb.AppendLine();
|
||
sb.AppendLine("`scratch/` is persistent and is never cleaned.");
|
||
|
||
using var f = Godot.FileAccess.Open(Path.Combine(batchRoot, "INDEX.md"), Godot.FileAccess.ModeFlags.Write);
|
||
if (f == null) { GD.PrintErr("could not write INDEX.md"); return; }
|
||
f.StoreString(sb.ToString());
|
||
}
|
||
|
||
private static string EnvStr(string k, string fallback)
|
||
{
|
||
string v = System.Environment.GetEnvironmentVariable(k);
|
||
return string.IsNullOrWhiteSpace(v) ? fallback : v;
|
||
}
|
||
|
||
private static int EnvInt(string k, int fallback)
|
||
=> int.TryParse(EnvStr(k, null) ?? "", out int v) ? v : fallback;
|
||
|
||
private static int[] EnvSeeds(string k, int[] fallback)
|
||
{
|
||
string v = EnvStr(k, null);
|
||
if (v == null) return fallback;
|
||
var o = new List<int>();
|
||
foreach (string p in v.Split(',', StringSplitOptions.RemoveEmptyEntries))
|
||
if (int.TryParse(p.Trim(), out int s) && s > 0) o.Add(s);
|
||
return o.Count > 0 ? o.ToArray() : fallback;
|
||
}
|
||
}
|
||
}
|