Repository navigation
Groovy NLC v1.0-alpha
This version enables NLC, Input overhaul and bug fixes to enable stable 480p over 1500 MTU gigabit.
Video: NLC codec (new)
- NLC ("Near-Lossless Codec") — a third frame-compression mode alongside RAW and LZ4, decoded in FPGA logic (rtl/nlc_*.v). Pixels go through a reversible YCoCg-R colour transform, a MED spatial predictor, an optional ±N "near-lossless" quantiser, and an entropy pack. Unlike LZ4 it has no back-references, so the hardware decoder is deterministic and cannot wedge.
- Golomb-Rice entropy front-end — best compression ratio of the three packs (GLOBAL / TILED / RICE). Now the default together with near-level 1.
- Near-lossless levels 0–3 — level 0 is bit-exact; levels ≥1 trade an imperceptible ±1 error for a large drop in peak bitrate. Near 1 is what keeps heavy scenes inside the MiSTer's ~38 MB/s ingest ceiling.
- Result: the problematic 3D title that stuttered under LZ4 now runs a locked 60 fps (16.71 ms frame period, 99% delivery, zero decoder recoveries).
- Parallel-plane wire format v2 — each scanline is a self-describing record with per-plane byte lengths, so four hardware bit-readers decode the colour planes simultaneously.
- Plane-threaded host encoder — ~2.7× faster than the first implementation, bit-identical output.
- DDR/bandwidth rework (ddram.sv, ddr_mux2.v, line-buffer + hsize blocks) to feed the decoder without starving the scanout path.
Inputs: protocol v2 (new)
- 32-bit, up from 16 to enable more buttons (full dualshock controller support)
- Analog triggers — LT/RT per player (0–255) alongside the existing sticks.
- Rumble — client → MiSTer → physical pad, gated per pad and per profile.
- New Controller menu. OSD: named per-device profiles, per-controller-type button labels, single-button remap, per-profile rumble strength and invert-Y.
- Fixed input-subscribe bug where controllers went dead on a second core launch, and unplug lag.
Client API (api/)
- Hardening: idempotent teardown (previously could close garbage fds), RIO send-completion drain + telemetry on Windows, a fixed RIO dequeue off-by-one, PollInputs safe before bind, pluggable log sink, isConnected() / CmdSendClose() / ResendInputSubscribe().
- Build flexibility: GM_SYSTEM_LZ4 to link the host's LZ4 instead of the bundled copy; MSVC/RIO and NOMINMAX guards.
- Flat C wrapper (gmw_*) at full v2 parity, with a function-pointer table for dlopen/LoadLibrary hosts.
Not tested for backwards compatibility. Be sure to launch from compatible emulator clients.