readme update

Author: TalhaMudo

PROJECT.md

@@ -1652,6 +1652,7 @@ env FIXMAT=1 FIXMAT_MODE=3 NOMOVIES=1 SNDSYNC=1 GPUVS=1 WINDOW=1 ALARM=0 \
 | ALFA TESTİ VARYANTI (`ALFAVAR`) | **−6.32 ± 0.48 (−%17)** | −2.8 ± 1.1 / −0.3 ± 0.8 | −1.8 ± 1.7 / +0.8 ± 1.7 | varsayılan açık (HD: −%27) |
 | EKRAN YÖNLENDİRME (`SCRREDIR`) | −0.02 ± 0.88 | −10.7 ± 1.1 / −10.1 ± 0.8 | **−20.4 ± 1.9 / −21.0 ± 1.8** | varsayılan açık |
 | GEÇİŞ YÜKLEMESİ (DontCare / karalama Z) | +0.6 ± 0.8 | +0.9 ± 1.1 / +0.6 ± 0.6 | +1.6 ± 1.8 / +1.2 ± 1.4 | elendi, kod kaldırıldı |
+| SON İŞLEM ZİNCİRİ (`FBZINCIR`), 2 koşu | −1.07 ± 0.53 / +2.39 ± 1.44 (ort. ≈ −0.7 ± 0.5) | −11.1 / −9.6 okuma, −5.8 / −4.2 yazma | **−12.6 / −9.8 okuma, −12.9 / −10.8 yazma** | varsayılan açık |
 
 GPU süresi (DVFS'li, yalnız bilgi): `ALFAVAR` açık 5.28 / kapalı 6.08 ms/kare.
 
@@ -1755,6 +1756,59 @@ gradyanı):
 Gözle: kaputun karbon dokusu, jant telleri ve fren diski delikleri artık keskin.
 `UVFIX=0` eski (bulanık) davranış.
 
+### SIRALI DOKU YÜKLEME (`TEXORD`) — doku yarışı (2026-10-19)
+
+Oyun bazı dokuları her karede yeniden yazıyor: son işlem renk tabloları #8 ve
+#9, 5467 karede 5467 yükleme (`TEXUPSAY=1` sayar). Yükleme `replaceRegion` ile
+anında dokuya gidiyordu. Konuk thread kare N+1'i kaydederken ana thread kare
+N'i kodluyor ya da GPU onu çiziyor. Kare N bu yüzden bazen kare N+1'in
+tablosunu, hatta yarım yazılmış tabloyu görüyordu. D3D9'da her çizim
+gönderildiği andaki içeriği görür.
+
+Belirtisi şuydu: aynı karede aynı çizimi iki kez kodlamak bile farklı sonuç
+veriyordu (son işlem zinciri doğrulamasında 0.6 M piksel, en çok 2/255).
+
+Düzeltme: bir dokunun ikinci ve sonraki yüklemeleri çizim listesine sıralı kayıt
+olarak giriyor. Veri karenin yükleme alanına kopyalanıyor (çift tampon, 8 MB),
+kodlamada çizimlerle sıralı bir blit (tampondan dokuya) oluyor. İlk yükleme
+(yükleme ekranı, henüz kullanılmamış doku) eskisi gibi anında. Atlanan
+(kodlanmayan) karenin bekleyen yüklemeleri, tampon yeniden kullanılmadan önce
+anında uygulanıyor. Kare başına ~2.3 yükleme, taşma 0. Sonra aynı çizim iki kez
+kodlanınca **0 piksel fark**. `TEXORD=0` eski davranış.
+
+### SON İŞLEM ZİNCİRİ (`FBZINCIR`) — üç geçiş tek geçişte (2026-10-19)
+
+Son işlem üç tam ekran geçişle renk tablosu uyguluyor: `#3 = ps28(#2)`,
+`#2 = ps27(#3)`, `#3 = ps26(#2)`. Her adımın girdisi bir öncekinin aynı
+pikseldeki çıktısı. Ölçüldü (`ABTEST=SKIPPS` + `SKIPPS=26,27,28`): üç geçiş GPU
+enerjisinin ~%16'sı, DRAM'de ~33 MB/kare.
+
+Zincir şimdi iki hedefi birden bağlayan tek bir geçişte çiziliyor. Her adım
+girdisini dokudan değil karo belleğinden okuyor (`[[color(n)]]`, Apple GPU'da
+çizim sırasıyla). Gölgelendirici varyantı (`vsemu.c` `ps_to_msl_fb`) aşama 0
+örneğini karo bellek girdisiyle değiştiriyor; arka planda derleniyor, hazır
+olana kadar eski yol kullanılıyor.
+
+Koşullar (kayıt başına):
+- tek dörtgen, hedefi tam kaplıyor;
+- Z, karışım ve alfa testi yok;
+- aşama 0 dokusu diğer zincir hedefi, aynı boyut ve biçimde;
+- UV teksel merkezine 1:1 (UV ÖLÇEĞİ sonrası);
+- ps aşama 0'ı tek yerde `TCRD(0)` ile örnekliyor;
+- diğer aşamalar zincir hedeflerini okumuyor;
+- ardışık kayıtlar iki hedef arasında gidip geliyor.
+
+Doğrulama: `FBZINCIR=2` zinciri eski yoldan çiziyor, aynı girdiyle birleşik
+yolu karalama dokularına çiziyor ve ikisini GPU'da piksel piksel
+karşılaştırıyor. Sonuç: 5454 zincirde **0 fark**, hem son çıktıda hem ara
+hedefte. `FBZCTRL=1` yardımcıyı normal boru hattıyla, `FBZCTRL=2` iki kez
+çalıştırıp kendisiyle karşılaştırıyor; determinizm testi bu ikisi.
+Doku yarışı düzeltilmeden önce sonuç 1–3/255'lik farklar veriyordu. O
+farkların kaynağı zincir değil, yukarıdaki yarıştı.
+
+Kazanç: DRAM −23 MB/kare (iki koşu); GPU çekirdek enerjisi ölçüm gürültüsü
+içinde (ort. ≈ −0.7 ± 0.5 mJ/kare). Kare başına ~1.3 zincir (yarış + menü).
+
 ### Elenenler
 
 - **GEÇİŞ YÜKLEMESİ:** tam ekran kaplayan çizimle başlayan geçişte renk
@@ -1778,3 +1832,8 @@ Yeni anahtarlar:
 | `ALFAVAR=0/2/3` | testsiz varyantı kapat / sayaçlı tanı (ps başına; ayrıca [0,1] dışı köşe rengi sayımı) / tanının pozitif kontrolü |
 | `RENKSAT=0` | köşe rengi kırpmasını kapat (eski, D3D9'a aykırı) |
 | `UVFIX=0` | ölçekli hedeflerde yarım teksel düzeltmesini kapat (eski, bulanık) |
+| `TEXORD=0` | tekrar yüklenen dokuları anında yaz (eski, yarışlı) |
+| `TEXUPSAY=1` | çıkışta doku başına yükleme sayısı (en çok 12) |
+| `FBZINCIR=0/2` | son işlem zinciri birleştirmesini kapat / birebirlik doğrulaması |
+| `FBZCTRL=1/2` | (`FBZINCIR=2` ile) yardımcıyı normal boru hattıyla çalıştır / kendisiyle karşılaştır |
+| `SKIPPS=…` + `ABTEST=SKIPPS` | o ps'lerin bedelini koşu içinde ölç (yalnız KAPALI dilimlerde atlar) |

README.md

@@ -1,10 +1,15 @@
-# NFSU2 on Apple Silicon — static recompilation of a Win32/x86 game to native ARM64
+# Need for Speed: Underground 2 on Mac — native Apple Silicon port, no Wine
 
-This repository contains the tools and runtime that turn the original Windows
-executable of *Need for Speed: Underground 2* (2004, 32-bit x86, Direct3D 9)
-into a **native ARM64 macOS binary**. The game's x86 machine code is lifted to
-C ahead of time and compiled with clang. There is no Wine, no emulator, no JIT
-and no Windows involved at run time.
+**Play *Need for Speed: Underground 2* (NFSU2, 2004) natively on Apple Silicon
+Macs (M1 and later): no Wine, no CrossOver, no emulator, no virtual machine.**
+
+NFSU2Recomp is a static recompiler and runtime that turn the original Windows PC
+executable of the game (`SPEED2.EXE`, 32-bit x86, Direct3D 9) into a **native
+ARM64 macOS app**. The game's x86 machine code is lifted to C ahead of time and
+compiled with clang; Direct3D 9 is translated to Metal, DirectSound to
+CoreAudio. There is no Wine, no emulator, no JIT and no Windows involved at run
+time. On an M1 Pro, races run at **119 fps** (the display's limit), against
+**10–15 fps** for the same game under Wine.
 
 > **This repository contains no game code and no game assets.** It contains the
 > recompiler and the runtime only. You need your own copy of the game; the C
@@ -168,6 +173,47 @@ OVERRIDE=60fab0,61e390,61f130,5c7ed0,50d510,65ae35,6623ea,66aa3f,66ace2,6691b1,6
 
 `run.sh` documents the environment switches; most are diagnostics.
 
+## FAQ
+
+**Can I play Need for Speed: Underground 2 on a Mac?**
+Yes, on an Apple Silicon Mac (M1 or later) with your own copy of the PC game.
+Build the port as described above; `./pack.sh` produces a double-clickable
+`NFSU2.app`. Menus, races and sound work.
+
+**Do I need Wine, CrossOver, Whisky, Parallels or a virtual machine?**
+No. The game's code is recompiled to native ARM64 and runs directly on macOS.
+Rosetta 2 is not used to run the game (only, optionally, by one test tool).
+
+**Is it faster than Wine or CrossOver?**
+On an M1 Pro at 1280×960: 119 fps in races (capped by the 120 Hz display)
+against 10–15 fps under Wine 11.18 with Rosetta 2, and 119 fps against 45 fps
+in the 3D menus. Method and raw numbers are in `WINE_KIYAS.md`.
+
+**Is there a ready-made download?**
+No. The recompiled program is derived from EA's executable, so it is built on
+your own Mac from your own copy of the game and is not distributed.
+
+**Which version of the game does it need?**
+The Windows PC version, with the exact `SPEED2.EXE` listed under
+[Requirements](#requirements). Other builds, including the console versions,
+are not supported.
+
+**Does it work on Intel Macs?**
+No. Only Apple Silicon is targeted and tested.
+
+**What does not work yet?**
+Videos are skipped, there is no gamepad or wheel support and no online play.
+See [Known limitations](#known-limitations).
+
+**How is this different from other NFSU2 projects?**
+
+| Project | Approach | Platforms |
+|---|---|---|
+| **NFSU2Recomp** (this) | Recompiles the PC executable with its own x86 → C lifter; own Direct3D 9 → Metal renderer | macOS (Apple Silicon) |
+| [OpenUG2](https://github.com/whoismept/OpenUG2) | Reimplements the engine from scratch and reads the game's data files; does not run the original code | Linux, macOS, Windows |
+| [nfsu2-recompiled](https://github.com/codepdbh/nfsu2-recompiled) | Recompiles the PC executable with pcrecomp; Direct3D 9 through DXVK | Windows, Android |
+| [nfsu2-sw](https://github.com/antoxa2584x/nfsu2-sw) | Recompiles the original Xbox version with xboxrecomp | Nintendo Switch, Linux |
+
 ## Related work
 
 Static recompilation of x86 is not new, and this is not the first project to do

runtime/metal.m

@@ -4415,7 +4415,11 @@ static MTLBlendOperation d3d_blendop(unsigned op){
  * okumuyor.  Ardisik kayitlar iki hedef arasinda gidip geliyor.
  * FBZINCIR=0 kapatir; FBZINCIR=2 dogrulama: zincir eski yoldan cizilir, ayni
  * girdiyle birlesik yol karalama dokularina cizilir ve ikisi GPU'da piksel
- * piksel karsilastirilir (rapor: "fark eden piksel", 0 olmali). */
+ * piksel karsilastirilir (rapor: "fark eden piksel", 0 olmali; olculdu
+ * 2026-10-19: 5454 zincirde 0).  FBZCTRL=1 yardimciyi normal boru hattiyla,
+ * FBZCTRL=2 iki kez calistirip kendisiyle karsilastirir (determinizm; SIRALI
+ * DOKU YUKLEME'den once burada 1-3/255 fark cikiyordu).
+ * Kazanc (ABTEST=FBZINCIR, iki kosu): DRAM -23 MB/kare, GPU enerjisi gurultu icinde. */
 static int fbz_mode(void){
     static int m = -1; if (m < 0){ const char *e = ENVC("FBZINCIR"); m = (e && *e) ? atoi(e) : 1; }
     return m;