attribution: in-game ODbL credit via AGigLineHUD

The demo is built from OpenStreetMap data (ODbL 1.0) and needs attribution
wherever the derived work is shown. Add it to the running game, not just the
documents.

- AGigLineHUD (C++): plain AHUD::DrawText in the bottom-left draws
  '(c) OpenStreetMap contributors' and 'Data (c) OpenStreetMap contributors,
  ODbL 1.0 - openstreetmap.org/copyright', with a shadow pass for legibility
  over bright pavement and sky. No UMG widget asset, so a cook cannot drop it
  through a missing widget reference.
- AGigLineGameModeBase: HUDClass = AGigLineHUD, so the credit is on by default.
- AGigLineShotActor: screenshots are now requested with the UI shown, so the
  attribution appears in every capture under Screenshots/ and the obligation
  is provable in review rather than only described.

Docs: THIRD_PARTY_NOTICES records that the string is displayed in-game;
Screenshots/README documents the overlay; TODO marks the item done and
narrows the remaining ODbL question to the shipped-derivative-database
posture.

Game/GigLine/Source/GigLine/GigLineGameModeBase.cpp

@@ -1,8 +1,11 @@
 #include "GigLineGameModeBase.h"
 
 #include "GigLineCharacter.h"
+#include "GigLineHUD.h"
 
 AGigLineGameModeBase::AGigLineGameModeBase()
 {
 	DefaultPawnClass = AGigLineCharacter::StaticClass();
+	// ODbL attribution must be visible in the running demo, not only in docs.
+	HUDClass = AGigLineHUD::StaticClass();
 }

Game/GigLine/Source/GigLine/GigLineHUD.cpp

@@ -0,0 +1,29 @@
+#include "GigLineHUD.h"
+
+#include "Engine/Canvas.h"
+#include "Engine/Engine.h"
+
+void AGigLineHUD::DrawHUD()
+{
+	Super::DrawHUD();
+
+	if (!Canvas || AttributionLine.IsEmpty())
+	{
+		return;
+	}
+
+	// Bottom-left, above any letterbox: the standard place for map/data credits.
+	const float LineHeight = Canvas->ClipY > 0 ? 22.0f * TextScale : 22.0f * TextScale;
+	const float X = MarginPx;
+	const float Y = Canvas->ClipY - MarginPx - LineHeight * 2.1f;
+
+	const FLinearColor Shadow(0.0f, 0.0f, 0.0f, 0.55f);
+	const FLinearColor Ink(1.0f, 1.0f, 1.0f, 0.92f);
+
+	// Shadow pass for legibility over bright pavement and sky.
+	DrawText(AttributionLine, Shadow, X + 1.0f, Y + 1.0f, nullptr, TextScale);
+	DrawText(LicenceLine, Shadow, X + 1.0f, Y + LineHeight + 1.0f, nullptr, TextScale * 0.82f);
+
+	DrawText(AttributionLine, Ink, X, Y, nullptr, TextScale);
+	DrawText(LicenceLine, Ink, X, Y + LineHeight, nullptr, TextScale * 0.82f);
+}

Game/GigLine/Source/GigLine/GigLineHUD.h

@@ -0,0 +1,42 @@
+#pragma once
+
+#include "CoreMinimal.h"
+#include "GameFramework/HUD.h"
+#include "GigLineHUD.generated.h"
+
+/**
+ * Always-on geographic attribution for the shipped demo.
+ *
+ * The demo is built from OpenStreetMap data, which is ODbL 1.0 licensed and
+ * requires attribution wherever a derived database or produced work is shown.
+ * This HUD draws the required credit in the bottom-left corner of the screen so
+ * it is present in the game, not only in the repository documents.
+ *
+ * Plain AHUD::DrawText is used deliberately: no UMG widget asset is needed, so
+ * the attribution cannot be accidentally dropped from a cook by a missing
+ * widget reference.
+ */
+UCLASS()
+class GIGLINE_API AGigLineHUD : public AHUD
+{
+	GENERATED_BODY()
+
+public:
+	virtual void DrawHUD() override;
+
+	/** Main credit line. Must match the ODbL attribution requirement. */
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Attribution")
+	FString AttributionLine = TEXT("\u00A9 OpenStreetMap contributors");
+
+	/** Licence line, including where the licence can be read. */
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Attribution")
+	FString LicenceLine = TEXT("Data \u00A9 OpenStreetMap contributors, ODbL 1.0 \u2014 openstreetmap.org/copyright");
+
+	/** Screen-space margin in pixels. */
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Attribution")
+	float MarginPx = 18.0f;
+
+	/** Text scale relative to the default canvas font. */
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Attribution")
+	float TextScale = 1.45f;
+};

Game/GigLine/Source/GigLine/GigLineShotActor.cpp

@@ -34,7 +34,7 @@ void AGigLineShotActor::Tick(float DeltaSeconds)
 				: FString::FromInt(CurrentShot);
 			const FString FileName = FString::Printf(TEXT("review-%s"), *Name);
 			// Resolution is the game window's; the runner passes -ResX/-ResY.
-			FScreenshotRequest::RequestScreenshot(FileName, false, false);
+			FScreenshotRequest::RequestScreenshot(FileName, /*bInShowUI=*/true, false);
 			bWaitingForScreenshot = true;
 		}
 		return;

Screenshots/README.md

@@ -56,6 +56,11 @@ All ☑ approved 2026-11-07.
   FBX → Unreal import.
 - **Lighting is dynamic-only** (`r.AllowStaticLighting=False`, all lights
   Movable), so no lighting build is ever required.
+- **Attribution overlay**: every shot carries the required ODbL credit in the
+  bottom-left (`© OpenStreetMap contributors` / `Data © OpenStreetMap
+  contributors, ODbL 1.0 — openstreetmap.org/copyright`), drawn by
+  `AGigLineHUD`. Screenshots are requested with the UI shown so the obligation
+  is visible in review.
 
 ## What to look for
 

THIRD_PARTY_NOTICES.md

@@ -25,6 +25,8 @@ Status values: **verified** (licence confirmed and permits our use), **pending**
 
 Attribution string for any OSM-derived output: "© OpenStreetMap contributors", <https://www.openstreetmap.org/copyright>. The data is available under the [Open Database License 1.0](https://opendatacommons.org/licenses/odbl/1-0/).
 
+This attribution is **displayed in the running game**, not only in this document: `AGigLineHUD` (`Game/GigLine/Source/GigLine/GigLineHUD.cpp`) draws the credit and the licence URL in the bottom-left of every frame, so the obligation is met by the shipped build. It is visible in every capture under `Screenshots/` because the screenshot actor requests screenshots with the UI shown.
+
 ## Reference photography (local only, not committed, not shipped)
 
 Reference photographs are **not** part of this repository. They live in the gitignored `Art/reference/` tree on the development machine, are used only for internal, private development, and are never built into a build or shipped. `.gitignore` enforces this; nothing under `Art/reference/` may be added, staged, or committed.

TODO.md

@@ -89,14 +89,14 @@ The MPFB character asset is planned as the NPC template (see `ROADMAP.md`). Keep
 - [A] Build sidewalks, roads, and collision meshes. Terrain, road, sidewalks and kerbs exist (`Art/blender/terrain/`, `street/`) and are assembled in `site/site-2026-11-06.blend`; collision and details (crossing markings, kerb radii, aprons) are not built. Ground must follow the DEM: 3.94 m fall along the block, ~2 % crown between the gutters at ±10–11 m from the centreline, north sidewalk higher than south. Kerb height is an unresolved assumption — the DEM does not resolve it (`Geo/verification/2026-11-06-cross-sections.md`).
 - [ ] Materials and look development for all exported assets.
 
-### Gameplay - active - 01a1b26b-3c94-707f-9665-2f6b4a79b564 (branch `gameplay-lighting-0.1.0`)
+### Gameplay - active - 01a1b26b-3c94-707f-9665-2f6b4a79b564 (branch `gameplay-attribution-0.1.0`)
 
 - [x] First-person movement, mouse look, and Enhanced Input bindings. Implemented 2026-11-07: `AGigLineCharacter` (C++, 1.75 m capsule, 1.60 m eye camera, 4 m/s walk, mouse look in deg/s, jump) as the default pawn, with five actions and an 11-entry context in `/Game/Input` built by `Tools/ue_create_input_assets.py`. **Not yet confirmed interactively** — launch PIE on `Test/ReviewMap` and walk. Screenshot review pending (`Screenshots/README.md`).
 - [D] Collision, reset, and pause functionality. Reset (**R**) and pause (**Escape**, a real game pause that releases the cursor) are implemented in `AGigLineCharacter` with `/Game/Input/IA_Reset` and `IA_Pause`. Collision now exists — terrain, road and sidewalks import as complex-as-simple, so a simple hull cannot ramp over the kerbs. **Not verified by hand**: walk, reset and pause need a human at the keyboard. No pause menu widget yet, only the pause itself.
 - [x] Build the walkable demo level: terrain, street, and hero facade assembled into one map with a start point on the north sidewalk, so the demo is something a player can walk rather than a review staging. **Built 2026-11-07** by `Tools/ue_build_demo_map.py` → `/Game/Hollywood/DemoMap`: sun/sky, `Hero_Facade`, six site meshes imported with collision (`Terrain_DEM`, `Road_Hollywood`, both sidewalks and both kerbs), and a `Demo_PlayerStart` on the north sidewalk 20 m back from the frontage. Demo views in `Screenshots/demo/` re-rendered and ☑ approved 2026-11-07.
 - [x] Walkable sidewalks and a designated street crossing. Crossing chosen: mid-block signalised crossing, OSM way 385648319, at 130 m along the block (`Geo/verification/2026-11-06-street-profile.md`). Done 2026-11-07: continental zebra markings (0.5 m bars / 0.5 m gaps, 3 m band) at all three signalised crossings, no collision on the paint; kerbs were already flushed at the crossings. Enablers found on the way: the street surfaces were 100 % down-facing (invisible in engine) — winding flipped; the terrain buried the street — 10.7 m corridor cut around the centreline (sidewalks cover the transition, walk-check 0 holes); LFS-lockable `.blend`/`.umap` check out read-only — builders now chmod before saving and fail loudly. Screenshot ☑ approved 2026-11-07 (`Screenshots/demo/review-demo-crossing`); the corridor renders near-black in shadow — that was the **Fixed daytime lighting** item, now also done.
 - [x] Fixed daytime lighting and basic ambience. **Done 2026-11-07, screenshots approved.** Demo map now has a fixed daytime rig in `Tools/ue_build_demo_map.py`: sun pitch −50 / yaw 120 (intensity 4, warm 255/245/230, atmosphere sun light), sky light 2.6 with real-time capture, sky atmosphere, height fog (density 0.008), and a manual-exposure post-process volume (min = max brightness 1.0) so a shot cannot wash out or crush to black. Two root causes found while doing it: (a) **Blender flat diffuse colours do not survive the FBX→UE import** — every site mesh arrived white and the terrain arrived with `WorldGridMaterial`, which is what actually made the scene look blown out; explicit `M_Asphalt` / `M_Concrete` / `M_Ground` / `M_RoadPaint` materials are now created and assigned in the demo builder. (b) only **one of the three crossings** was reaching the game: each band was its own object and Blender renamed the duplicates `.001`/`.002`, which site assembly skips; all bands are now one `Crossing_Markings` object. Demo cameras also fixed: street-level sat inside the façade body, and the crossing camera aimed at the wrong crossing (s=36.6 instead of the designated s=130.1 at UE X −14956). Lighting is dynamic-only (`r.AllowStaticLighting=False`, all lights Movable) so the editor's "LIGHTING NEEDS TO BE REBUILT" warning no longer fires. All four demo views approved by the owner.
-- [ ] Geographic attribution display ("© OpenStreetMap contributors" + license link).
+- [x] Geographic attribution display ("© OpenStreetMap contributors" + license link). Done 2026-11-07: `AGigLineHUD` (C++) draws the credit line and the licence URL (`© OpenStreetMap contributors` / `Data © OpenStreetMap contributors, ODbL 1.0 — openstreetmap.org/copyright`) in the bottom-left of every frame, wired through `AGigLineGameModeBase::HUDClass`. It is a plain `AHUD::DrawText`, so no UMG widget asset can be dropped from a cook. `AGigLineShotActor` now requests screenshots with the UI shown, so the attribution is visible in every image under `Screenshots/` and the obligation is provable, not just documented.
 
 ### Repository publication
 
@@ -104,7 +104,7 @@ The MPFB character asset is planned as the NPC template (see `ROADMAP.md`). Keep
 - [x] Scan all reachable Git history and the publication changes with Gitleaks 8.28.0. Removed an Android File Server security token from history and disabled the unused server; the rescans found no leaks.
 - [x] Review Unreal asset provenance via the generation/import scripts and inspect all 18 reachable Unreal asset versions for recognizable private-reference paths. No such paths were found; this is not a full binary-content audit.
 - [x] Review OSM source distribution notices: original data retains attribution and licence metadata, and the repository links directly to ODbL 1.0.
-- [ ] Review ODbL obligations for each shipped derivative database or produced work before public release.
+- [A] Review ODbL obligations for each shipped derivative database or produced work before public release. In-game attribution display is implemented (`AGigLineHUD`, visible in every screenshot); the remaining question is the ODbL "derivative database" posture for a shipped build that contains OSM-derived geometry.
 - [x] Validate Gitea LFS support. The first push succeeded on 2026-11-07; a separate clone fetched all 26 historical LFS objects and passed integrity checks.
 - [x] Commit and review the publication preparation changes before pushing. Initial publication commit: `101db3f`.