raytracer
Wolfenstein-achtige raycaster op frameworkv3 (WebGL), met paperdoll-NPC’s, vloer/plafond-casting en een level-editor.
Lokaal bouwen en draaien
# 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 (nustone/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 ofnull= 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). Ziebuild/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
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.htmlarchive/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/
Source
| 1 | # raytracer |
| 2 | |
| 3 | Wolfenstein-achtige raycaster op [frameworkv3](https://git.timfalken.com/timfa/frameworkv3) (WebGL), met **paperdoll-NPC’s**, **vloer/plafond-casting** en een **level-editor**. |
| 4 | |
| 5 | ## Lokaal bouwen en draaien |
| 6 | |
| 7 | ```bash |
| 8 | # Framework-bundel (eenmalig / bij framework-update) |
| 9 | cd /pad/naar/frameworkv3 && ./glbuild.sh |
| 10 | cp js/framework.js /pad/naar/raytracer/build/framework.js |
| 11 | |
| 12 | # Game- + editor-bundel |
| 13 | ./src/build.sh |
| 14 | |
| 15 | # Statische server |
| 16 | python3 -m http.server 8080 --directory build |
| 17 | # spel: http://localhost:8080/ |
| 18 | # editor: http://localhost:8080/editor.html |
| 19 | # level: http://localhost:8080/?level=level-1 |
| 20 | ``` |
| 21 | |
| 22 | Besturing: WASD / pijltjes, klik voor pointer-lock, `<` `>` voor raycast-resolutie. HUD: vorige/volgende level. |
| 23 | |
| 24 | ## Levels (`build/levels.json`) |
| 25 | |
| 26 | Schema **format_version: 2** (v1 migreert automatisch): |
| 27 | |
| 28 | - `textures[]` – id + url (nu `stone` / `wood`, dezelfde set als muren) |
| 29 | - `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[]` |
| 30 | - `lights[]` – `{id,x,y,z,color[r,g,b],intensity,range,falloff}` in world-units (cellSize=32) |
| 31 | |
| 32 | Validatie en legacy-migratie: `src/levelFormat.js`. |
| 33 | |
| 34 | ## Vloer / plafond |
| 35 | |
| 36 | **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). |
| 37 | |
| 38 | ## Camera / anti-fisheye |
| 39 | |
| 40 | 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. |
| 41 | |
| 42 | ## Lampen |
| 43 | |
| 44 | 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. |
| 45 | |
| 46 | ## Level-editor |
| 47 | |
| 48 | `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). |
| 49 | |
| 50 | ## Paperdolls |
| 51 | |
| 52 | - Assets in `build/paperdolls/` (body + sword). Zie `build/paperdolls/ATTRIBUTION.md`. |
| 53 | - Depth-atlassen als `.u16` (LE gray+alpha) naast de `.ppda`. |
| 54 | - Live compositor + per-pixel z-buffer t.o.v. muren (loodrechte diepte). |
| 55 | - Yaw 0 = voorkant, 90 = linkerzijde van het model; pitch alleen uit hoogteverschil (kijken omhoog/omlaag kantelt de sprite niet). |
| 56 | |
| 57 | ## Tests |
| 58 | |
| 59 | ```bash |
| 60 | node --test test/*.test.js |
| 61 | ``` |
| 62 | |
| 63 | ## Structuur |
| 64 | |
| 65 | - `src/` – game, `camera.js`, `floorCast.js`, `floorGpu.js`, `lighting.js`, `levelFormat.js`, `editorApp.js`, `src/ppda/` |
| 66 | - `build/` – speelbare output + `levels.json` + `editor.html` |
| 67 | - `archive/legacy-js/` – oude canvas2d-versie |
| 68 | |
| 69 | ## Deploy |
| 70 | |
| 71 | 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/ |