BlueGit

timfa raytracer

Files

raytracer / README.md

README.md

README.md 3.3 KiB Download Raw

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 (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

Klassieke floor/ceiling casting (Lode-stijl) op de CPU → ImageData → één NEAREST WebGL-quad onder de muren. Motief: frameworkv3 is WebGL1-sprites zonder gedeelde depth buffer; een grid-data-texture-shader zou draw-order/z-buffer van paperdolls breken. Scanlines met 2×2 NEAREST-blocks houden het performant. posZ = (cellSize/2)·screenH koppelt de vloer aan dezelfde projectie als muurhoogte (anders bleef rowDist ≈ 1–2 en zag je één effen texel). Tiles zonder floor/ceiling blijven zwart/clear. NPC-voeten op het vloervlak (body-atlas, niet gear).

Lampen

Point lights (CPU) op muren/vloer/plafond (N·L + afstand + grid-LOS) en op paperdolls via view-space normals uit .ppda (zelfde encoding als Paperdoll relight: RGB = n·0.5+0.5, view=+Z). Lichtvector wordt naar de gekozen yaw-view getransformeerd zodat een lamp links de linkerkant belicht. CPU i.p.v. custom shader: frameworkv3 is WebGL1-sprites zonder G-buffer; vloer/NPC’s zijn al CPU-ImageData — lighting past in die paden zonder extra GPU-pipeline. Zonder lights[] blijft de oude ambient/face-shade look.

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.

Tests

node --test test/*.test.js

Structuur

  • src/ – game, levelFormat.js, floorCast.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/

Source
1# raytracer
2
3Wolfenstein-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)
9cd /pad/naar/frameworkv3 && ./glbuild.sh
10cp js/framework.js /pad/naar/raytracer/build/framework.js
11
12# Game- + editor-bundel
13./src/build.sh
14
15# Statische server
16python3 -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
22Besturing: WASD / pijltjes, klik voor pointer-lock, `<` `>` voor raycast-resolutie. HUD: vorige/volgende level.
23
24## Levels (`build/levels.json`)
25
26Schema **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
32Validatie en legacy-migratie: `src/levelFormat.js`.
33
34## Vloer / plafond
35
36Klassieke floor/ceiling casting (Lode-stijl) op de CPU → `ImageData` → één NEAREST WebGL-quad **onder** de muren. Motief: frameworkv3 is WebGL1-sprites zonder gedeelde depth buffer; een grid-data-texture-shader zou draw-order/z-buffer van paperdolls breken. Scanlines met 2×2 NEAREST-blocks houden het performant. `posZ = (cellSize/2)·screenH` koppelt de vloer aan dezelfde projectie als muurhoogte (anders bleef `rowDist` ≈ 1–2 en zag je één effen texel). Tiles zonder floor/ceiling blijven zwart/clear. NPC-voeten op het vloervlak (body-atlas, niet gear).
37
38## Lampen
39
40Point lights (CPU) op muren/vloer/plafond (N·L + afstand + grid-LOS) en op paperdolls via view-space normals uit `.ppda` (zelfde encoding als Paperdoll `relight`: RGB = n·0.5+0.5, view=+Z). Lichtvector wordt naar de gekozen yaw-view getransformeerd zodat een lamp links de linkerkant belicht. **CPU i.p.v. custom shader:** frameworkv3 is WebGL1-sprites zonder G-buffer; vloer/NPC’s zijn al CPU-ImageData — lighting past in die paden zonder extra GPU-pipeline. Zonder `lights[]` blijft de oude ambient/face-shade look.
41
42## Level-editor
43
44`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).
45
46## Paperdolls
47
48- Assets in `build/paperdolls/` (body + sword). Zie `build/paperdolls/ATTRIBUTION.md`.
49- Depth-atlassen als `.u16` (LE gray+alpha) naast de `.ppda`.
50- Live compositor + per-pixel z-buffer t.o.v. muren.
51
52## Tests
53
54```bash
55node --test test/*.test.js
56```
57
58## Structuur
59
60- `src/` – game, `levelFormat.js`, `floorCast.js`, `editorApp.js`, `src/ppda/`
61- `build/` – speelbare output + `levels.json` + `editor.html`
62- `archive/legacy-js/` – oude canvas2d-versie
63
64## Deploy
65
66BlueGit 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/