Files
security-game/docs/screens/realism/2026-11-01-v2/report.json
T
zwitschi d7e523f63c
Full build / Import + headless tests (push) Successful in 34s
Full build / Full desktop build + optional release (push) Skipped
Adopt the realism pass and refresh screenshots/docs
- add the v2 runtime picks: per-phase skyline panoramas, brick, sidewalk
  pavers, dry/wet asphalt, awning canvas, and their normal maps
- add the realism tooling and evidence: tools/scene_concepts.py, capture_realism.gd,
  concept frames, reports/sheets, and tests
- retune phase lighting/fog/exposure, add sun yaw, brighten the night glow,
  add the flashlight beam mesh, and rebuild the planter/tree assets
- regenerate all eleven staged screenshots from the current build; compare is
  11 good / 0 bad
- finish the visual-alignment closeout in DONE/TODO, update architecture,
  blender-assets, PLAN, and ignore rules (editable Blender sources untracked)
- keep the judge retry and document the verified default judge model

Verification: headless 227/227; Python tooling 86/86; check_screenshots 11/11.
2026-11-01 17:03:05 +01:00

361 lines
15 KiB
JSON

{
"run": "docs/screens/realism/2026-11-01-v2",
"judge_model": "google/gemini-2.5-flash-lite",
"sets": {
"baseline": {
"boulevard_day": {
"target": "docs/screens/concepts/boulevard_skyline_day.png",
"metrics": {
"edge_density": 20.75,
"fine_detail": 8.2,
"contrast": 49.63,
"saturation_mean": 72.04,
"colour_spread": 55.45
},
"target_metrics": {
"edge_density": 20.74,
"fine_detail": 8.23,
"contrast": 54.85,
"saturation_mean": 73.09,
"colour_spread": 58.16
},
"metric_gap": 0.036,
"judge": {
"scores": {
"lighting": 3.0,
"materials": 2.0,
"texture_detail": 1.0,
"backdrop": 4.0,
"characters": 1.0,
"overall": 2.0
},
"fixes": [
"Improve the lighting model to include more realistic global illumination and soft shadows. The current lighting is too flat and harsh.",
"Replace the current low-polygon character models with more detailed and anatomically correct models. Add variations in clothing and appearance.",
"Increase the texture resolution and detail on all surfaces, especially buildings, roads, and foliage. Implement normal maps and specular maps for greater realism.",
"Enhance the backdrop by adding more detailed building models in the distance, atmospheric perspective (haze), and a more nuanced skybox.",
"Refine the material properties of all objects to better simulate real-world materials. This includes adjusting reflectivity, roughness, and subsurface scattering where appropriate."
]
}
},
"boulevard_night": {
"target": "docs/screens/concepts/hollywood_entrance_rain_night.png",
"metrics": {
"edge_density": 21.77,
"fine_detail": 8.45,
"contrast": 50.38,
"saturation_mean": 95.12,
"colour_spread": 55.61
},
"target_metrics": {
"edge_density": 8.43,
"fine_detail": 3.51,
"contrast": 27.34,
"saturation_mean": 159.44,
"colour_spread": 26.61
},
"metric_gap": 1.231,
"judge": {
"scores": {
"lighting": 2.0,
"materials": 1.0,
"texture_detail": 1.0,
"backdrop": 2.0,
"characters": 1.0,
"overall": 1.0
},
"fixes": [
"Improve lighting to match the dramatic, atmospheric, and volumetric lighting of the target image, focusing on warm, directional light from the marquee and streetlamp, and realistic reflections on wet surfaces.",
"Significantly upgrade material shaders to achieve realistic PBR (Physically Based Rendering) properties, especially for brick, asphalt, glass, and metal, to mimic the specular highlights, subsurface scattering, and roughness of the target.",
"Increase texture resolution and detail for all surfaces, particularly the brickwork, sidewalk, and building facades, to match the fine-grained realism of the target.",
"Redesign character models with higher polygon counts, more detailed textures, and realistic clothing and facial features to match the stylized but grounded look of the target's lone figure.",
"Enhance the backdrop by adding atmospheric effects like fog, rain, and distant city lights, and refine the building models to have more architectural detail and variation, similar to the target's moody urban environment."
]
}
},
"entrance_day": {
"target": "docs/screens/concepts/hollywood_entrance_morning.png",
"metrics": {
"edge_density": 26.19,
"fine_detail": 9.27,
"contrast": 56.39,
"saturation_mean": 65.24,
"colour_spread": 59.96
},
"target_metrics": {
"edge_density": 16.87,
"fine_detail": 6.92,
"contrast": 70.27,
"saturation_mean": 121.02,
"colour_spread": 69.83
},
"metric_gap": 0.308,
"judge": {
"scores": {
"lighting": 3.0,
"materials": 2.0,
"texture_detail": 2.0,
"backdrop": 3.0,
"characters": 10.0,
"overall": 2.0
},
"fixes": [
"Improve brick texture and material to match the target's depth and variation.",
"Add more detailed and varied foliage, especially for the trees and bushes, to match the target's organic look.",
"Enhance lighting to create softer shadows, more atmospheric haze, and warmer tones, particularly around the building entrance and street.",
"Refine building details, such as window frames, signage, and architectural elements, to increase realism.",
"Introduce subtle imperfections and wear on surfaces like the sidewalk and building facade to mimic real-world aging."
]
}
},
"street_day": {
"target": "docs/screens/concepts/boulevard_skyline_day.png",
"metrics": {
"edge_density": 12.44,
"fine_detail": 5.32,
"contrast": 41.37,
"saturation_mean": 77.84,
"colour_spread": 44.96
},
"target_metrics": {
"edge_density": 20.74,
"fine_detail": 8.23,
"contrast": 54.85,
"saturation_mean": 73.09,
"colour_spread": 58.16
},
"metric_gap": 0.307,
"judge": {
"scores": {
"lighting": 2.0,
"materials": 1.0,
"texture_detail": 1.0,
"backdrop": 2.0,
"characters": 2.0,
"overall": 1.0
},
"fixes": [
"Improve lighting to match the warm, directional sunlight and soft shadows of the target. Add volumetric fog for atmospheric perspective.",
"Replace flat, untextured building models with detailed geometry and realistic materials (concrete, glass, metal).",
"Add high-resolution textures to all surfaces, especially the road, sidewalk, and buildings, to mimic the detail in the target.",
"Model a more detailed and varied cityscape for the backdrop, including buildings with distinct architectural styles and realistic lighting.",
"Redesign character models to be more anatomically correct and have realistic clothing textures and animations."
]
}
},
"street_night": {
"target": "docs/screens/concepts/boulevard_skyline_dusk.png",
"metrics": {
"edge_density": 11.94,
"fine_detail": 5.35,
"contrast": 48.34,
"saturation_mean": 98.21,
"colour_spread": 48.85
},
"target_metrics": {
"edge_density": 8.83,
"fine_detail": 4.61,
"contrast": 33.26,
"saturation_mean": 188.16,
"colour_spread": 35.38
},
"metric_gap": 0.337,
"judge": {
"scores": {
"lighting": 3.0,
"materials": 2.0,
"texture_detail": 1.0,
"backdrop": 2.0,
"characters": 1.0,
"overall": 2.0
},
"fixes": [
"Improve lighting to match the dramatic sunset and neon glow of the target image, focusing on volumetric lighting and bloom effects.",
"Enhance material properties for buildings, road, and car to achieve a more realistic PBR (Physically Based Rendering) look, with appropriate reflections and specularity.",
"Increase texture resolution and detail on all surfaces, especially the road and building facades, to mimic the fine grain and imperfections seen in the target.",
"Redesign the backdrop to include a more detailed and atmospheric skyline with realistic haze and a richer sunset color gradient.",
"Replace the current character models with more detailed and realistically proportioned characters that fit the urban environment."
]
}
}
},
"candidate": {
"boulevard_day": {
"target": "docs/screens/concepts/boulevard_skyline_day.png",
"metrics": {
"edge_density": 20.67,
"fine_detail": 7.8,
"contrast": 42.49,
"saturation_mean": 67.55,
"colour_spread": 48.32
},
"target_metrics": {
"edge_density": 20.74,
"fine_detail": 8.23,
"contrast": 54.85,
"saturation_mean": 73.09,
"colour_spread": 58.16
},
"metric_gap": 0.113,
"judge": {
"scores": {
"lighting": 3.0,
"materials": 2.0,
"texture_detail": 2.0,
"backdrop": 5.0,
"characters": 1.0,
"overall": 2.0
},
"fixes": [
"Improve road and sidewalk materials to have more realistic specular highlights and surface imperfections.",
"Increase texture resolution and detail on buildings, especially the brickwork, to match the target's fidelity.",
"Replace stylized character models with realistic human models that have appropriate proportions and clothing.",
"Enhance lighting to create softer shadows, more realistic ambient occlusion, and better global illumination, especially around the streetlights and building facades.",
"Add atmospheric perspective and volumetric fog to the distant cityscape to create a more convincing sense of depth and distance haze."
]
}
},
"boulevard_night": {
"target": "docs/screens/concepts/hollywood_entrance_rain_night.png",
"metrics": {
"edge_density": 20.67,
"fine_detail": 7.86,
"contrast": 46.43,
"saturation_mean": 98.69,
"colour_spread": 50.59
},
"target_metrics": {
"edge_density": 8.43,
"fine_detail": 3.51,
"contrast": 27.34,
"saturation_mean": 159.44,
"colour_spread": 26.61
},
"metric_gap": 1.073,
"judge": {
"scores": {
"lighting": 2.0,
"materials": 1.0,
"texture_detail": 1.0,
"backdrop": 3.0,
"characters": 2.0,
"overall": 1.0
},
"fixes": [
"Improve lighting to create atmospheric mood, with strong contrast and volumetric effects like fog/rain.",
"Enhance material properties for realism: add specular highlights, subsurface scattering for skin, and more detailed surface imperfections.",
"Increase texture resolution and detail, especially on buildings, pavement, and clothing, to match the target's gritty realism.",
"Redesign characters to have more realistic proportions, clothing, and facial features, and animate them with more natural movement.",
"Develop a more detailed and atmospheric backdrop, including realistic city buildings, distant haze, and appropriate weather effects."
]
}
},
"entrance_day": {
"target": "docs/screens/concepts/hollywood_entrance_morning.png",
"metrics": {
"edge_density": 24.54,
"fine_detail": 8.92,
"contrast": 52.41,
"saturation_mean": 61.63,
"colour_spread": 54.98
},
"target_metrics": {
"edge_density": 16.87,
"fine_detail": 6.92,
"contrast": 70.27,
"saturation_mean": 121.02,
"colour_spread": 69.83
},
"metric_gap": 0.303,
"judge": {
"scores": {
"lighting": 3.0,
"materials": 2.0,
"texture_detail": 2.0,
"backdrop": 3.0,
"characters": 1.0,
"overall": 2.0
},
"fixes": [
"Improve brick texture and material to add more variation, grime, and imperfections.",
"Enhance lighting to create softer shadows, more atmospheric haze, and realistic light falloff.",
"Add more detail and variation to the building facade, including window frames, signage, and architectural elements.",
"Replace low-poly trees and bushes with more detailed and realistic foliage models.",
"Refine character models to match the realistic style of the target image, focusing on proportions, clothing, and facial features."
]
}
},
"street_day": {
"target": "docs/screens/concepts/boulevard_skyline_day.png",
"metrics": {
"edge_density": 14.54,
"fine_detail": 5.32,
"contrast": 36.3,
"saturation_mean": 74.49,
"colour_spread": 39.9
},
"target_metrics": {
"edge_density": 20.74,
"fine_detail": 8.23,
"contrast": 54.85,
"saturation_mean": 73.09,
"colour_spread": 58.16
},
"metric_gap": 0.326,
"judge": {
"scores": {
"lighting": 2.0,
"materials": 1.0,
"texture_detail": 1.0,
"backdrop": 3.0,
"characters": 1.0,
"overall": 1.0
},
"fixes": [
"Improve road and sidewalk materials to have more realistic specular highlights and surface imperfections.",
"Add significant detail to the car models, including realistic reflections, panel gaps, and tire textures.",
"Implement volumetric fog and atmospheric scattering to create a more convincing sense of depth and haze in the backdrop.",
"Replace the placeholder character with a detailed, realistically lit 3D model that matches the environment's style.",
"Enhance the lighting model to include softer shadows, more accurate ambient occlusion, and realistic light bounce."
]
}
},
"street_night": {
"target": "docs/screens/concepts/boulevard_skyline_dusk.png",
"metrics": {
"edge_density": 16.12,
"fine_detail": 6.06,
"contrast": 48.36,
"saturation_mean": 103.44,
"colour_spread": 49.1
},
"target_metrics": {
"edge_density": 8.83,
"fine_detail": 4.61,
"contrast": 33.26,
"saturation_mean": 188.16,
"colour_spread": 35.38
},
"metric_gap": 0.495,
"judge": {
"scores": {
"lighting": 3.0,
"materials": 2.0,
"texture_detail": 2.0,
"backdrop": 4.0,
"characters": 1.0,
"overall": 2.0
},
"fixes": [
"Improve lighting to match the dramatic, atmospheric sunset and neon glow of the target image. Add volumetric fog and bloom effects.",
"Significantly enhance material properties for buildings, road, and vehicles to achieve a more realistic PBR (Physically Based Rendering) look, with appropriate reflections and surface imperfections.",
"Increase texture resolution and detail on all surfaces, especially buildings and the road, to match the crispness and complexity of the target.",
"Redesign the backdrop to include a more detailed and atmospheric city skyline with appropriate haze and color grading to match the sunset.",
"Completely overhaul character models to be significantly more detailed, with realistic proportions, clothing, and animation, to match the quality of the target scene."
]
}
}
}
}
}