Files
lilygo-t-deck/lib/raylib-esp32/VENDOR.md
T
Dejvino 0f22c6afca Add raylib-esp32 lib and FloorPlan3D demo (3D floor plan via rlsw)
Vendor raylib-esp32 v1.0.3 (63db94b) under lib/ — raylib 6.x core with
the rlsw software renderer plus the ESP32-S3 port layer (SPI display
drivers, async double-buffered flush). raylib/examples, projects, tools
and logo are trimmed (~80 MB of content nothing here compiles); see
lib/raylib-esp32/VENDOR.md for provenance.

New floorplan3d-demo (emulator-template base) renders the NetDeck demo
map (nd_demomap.h) as a 3D floor plan — bulkhead walls, blast door,
cover crates, airlock pad, terminal — through the real on-device 3D
stack on the desktop:

- rcore_emu.c: desktop PLATFORM_CUSTOM layer mirroring rcore_esp32.c,
  flushing the RGB565 sw-renderer buffer into emuGfx::fb instead of SPI
- raylib_emu_config.h: same module/limit defines as the device build
- HUD via 3x5 bitmap font into fb: rlsw's 2D textured-quad path
  (DrawText/DrawRectangle) misplaces/flips quads and samples wrong
  atlas texels in this build; the 3D path is pixel-accurate

Verified: dual build (make netdeck) green, demo smoke test clean at
~59 FPS, 600-frame stability run OK.
2026-11-16 21:46:31 +01:00

32 lines
1.2 KiB
Markdown

# Vendored: raylib-esp32
Source: https://github.com/jensroth-git/raylib-esp32
Upstream commit: 63db94b3f9ff8ef9d4f04ed97520a77eeeebd9ff (v1.0.3)
The upstream repo vendors the raylib source tree in-tree (the `.gitmodules`
entry for `raysan5/raylib` is vestigial — the index tracks the files
directly). raylib version here: 6.0.
## Trimming vs upstream (this vendored copy only)
Removed because nothing in this repo compiles them and they are ~80 MB:
- `raylib/examples/`, `raylib/projects/`, `raylib/tools/`, `raylib/logo/`,
`raylib/.github/`, `raylib/cmake/`
- upstream git metadata (`.git`)
Kept intact:
- `include/` + `src/` — the ESP32 port (platform layer, display drivers,
SPI port) as used by the PlatformIO build (`library.json`/`pio_build.py`)
- `raylib/src/` — raylib core + `external/rlsw.h` software renderer
- `docs/` — ESP32 optimization notes (contains the on-device benchmarks)
- `examples/` — the library's own hello_3d / model_loading device examples
Consumers:
- `floorplan3d-demo/` — compiles `raylib/src/{rcore,rshapes,rtextures,rtext,rmodels}.c`
with `-DGRAPHICS_API_OPENGL_SOFTWARE -DPLATFORM_CUSTOM` plus a local
desktop platform layer (`rcore_emu.c`)
- future firmware integration — same recipe as `library.json` flags