# raytracer

Wolfenstein-achtige raycaster op [frameworkv3](https://git.timfalken.com/timfa/frameworkv3) (WebGL), met **paperdoll-NPC’s**, **vloer/plafond-casting** en een **level-editor**.

## Lokaal bouwen en draaien

```bash
# Framework-bundel (eenmalig / bij framework-update)
cd /pad/naar/frameworkv3 && ./glbuild.sh
cp js/framework.js /pad/naar/raytracer/build/framework.js

# Game- + editor-bundel
./src/build.sh

# Statische server
python3 -m http.server 8080 --directory build
# spel:    http://localhost:8080/
# editor:  http://localhost:8080/editor.html
# level:   http://localhost:8080/?level=level-1
```

Besturing: WASD / pijltjes, klik voor pointer-lock, `<` `>` voor raycast-resolutie. HUD: vorige/volgende level.

## Levels (`build/levels.json`)

Schema **format_version: 2** (v1 migreert automatisch):

- `textures[]` – id + url (nu `stone` / `wood`, dezelfde set als muren)
- `levels[]` – per level: `id`, `name`, `width`/`height`, `cellSize`, `ambient` (0..1), `spawn{tileX,tileY,yawRad}`, `walls[]`, `floors[]`, `ceilings[]` (textuur-id of `null` = zwart), `npcs[]`, `lights[]`
- `lights[]` – `{id,x,y,z,color[r,g,b],intensity,range,falloff}` in world-units (cellSize=32)

Validatie en legacy-migratie: `src/levelFormat.js`.

## Vloer / plafond

**GPU-pad (runtime):** fragment shader (`src/floorGpu.js`) met camera-plane rays, level-grid als NEAREST data-texture, stone/wood als albedo, lampen als uniforms. Geen per-frame `ImageData`/`putImageData`. CPU-`FloorCast` blijft voor tests/fallback. `posZ = (cellSize/2)·screenH` koppelt de vloer aan muurprojectie. Tiles zonder floor/ceiling onder muren krijgen een default (stone/wood) zodat er geen zwarte gaten/seams ontstaan. NPC-voeten op het vloervlak (body-atlas, niet gear).

## Camera / anti-fisheye

Gedeelde `src/camera.js`: FOV 90° via camera-vlak (`dir + plane·camX`), loodrechte diepte voor muurhoogte, floor rowDist, NPC-projectie en z-buffer. Zo blijven muren recht bij draaien en verdwijnt een NPC niet achter de muur als je alleen roteert.

## Lampen

Point lights: muren CPU (N·L + falloff + grid-LOS met nudge); vloer/plafond in de GPU-shader (geen LOS, voorkomt seams); paperdolls één keer per cel belicht (Half-Lambert + geoTilt) en gecached, daarna alleen geprojecteerd. Zonder `lights[]` blijft ambient/face-shade.

## Level-editor

`build/editor.html`: meerdere levels toevoegen/hernoemen/verwijderen/dupliceren, grootte, muur/vloer/plafond schilderen (klik/sleep + texture-previews), spawn + NPC’s, download/upload JSON, localStorage, **Speel dit level**. Lampen volgen in een latere stap (`lights[]` staat al in het formaat).

## Paperdolls

- Assets in `build/paperdolls/` (body + sword). Zie `build/paperdolls/ATTRIBUTION.md`.
- Depth-atlassen als `.u16` (LE gray+alpha) naast de `.ppda`.
- Live compositor + per-pixel z-buffer t.o.v. muren (loodrechte diepte).
- Yaw 0 = voorkant, 90 = linkerzijde van het model; pitch alleen uit hoogteverschil (kijken omhoog/omlaag kantelt de sprite niet).

## Tests

```bash
node --test test/*.test.js
```

## Structuur

- `src/` – game, `camera.js`, `floorCast.js`, `floorGpu.js`, `lighting.js`, `levelFormat.js`, `editorApp.js`, `src/ppda/`
- `build/` – speelbare output + `levels.json` + `editor.html`
- `archive/legacy-js/` – oude canvas2d-versie

## Deploy

BlueGit CI (`ftp_upload` op master) synchroniseert `build/` via FTP naar `projectftp` (secrets: `timftphost`/`timftpuser`/`timftppassword`/`timftproot`/`projectftp`). **Geen `--delete`**. Live: https://projects.timfalken.com/raycaster/
