BlueGit

timfa raytracer

Overview

Activity

NovDecJanFebMarAprMayJunJulAugSepOctNov

22 contributions in the last 12 months

LessMore

Commits, merge requests and comments.

raytracer
README.md

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

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

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/