Xex2CarGUI: masowa konwersja XEX na CAR dla Atari 8-bit

Xex2CarGUI zamienia pliki wykonywalne Atari 8-bit (.xex) na obrazy cartridge’a (.car), i to hurtem: przeciągasz pliki albo całe foldery, klikasz jeden przycisk i dostajesz komplet obrazów. To wersja tylko XEX → CAR, bez obsługi ATR. Konwerter opiera się na pracy GienekP (xex2car), a loader w programie jest moją poprawioną wersją jego kodu.

/ Jak z tego korzystać

1. Uruchom Xex2CarGUI.exe. Nic więcej nie jest potrzebne: konwerter i poprawiony loader są wbudowane, a oryginalny xex2car.exe nie jest wymagany.
2. Dodaj pliki do kolejki: przeciągnij pliki .xex lub całe foldery na okno (foldery są przeszukiwane z podfolderami), użyj „Dodaj pliki...” (wielokrotny wybór) albo „Dodaj folder...” (rekurencyjnie, brane są tylko pliki *.xex).
3. Kliknij „Konwertuj wszystko”.
4. Sprawdź statusy: [ .. ] oczekuje, [ OK ] gotowe, [BŁĄD] nie udało się (powód obok nazwy). „Wyczyść kolejkę” opróżnia listę (nie działa w trakcie konwersji).

/ Wynik

• Miejsce zapisu: plik nazwa.car powstaje obok nazwa.xex. Istniejący .car o tej nazwie jest nadpisywany bez pytania.
• Rozmiar: dobierany automatycznie do rozmiaru gry: 8, 16, 32, 64, 128, 256, 512 lub 1024 kB. Typ w nagłówku to J(atari)Cart (kody 104–111 formatu CAR).
• Limit: około 1 MB (1016 kB) pliku XEX. Większych plików program nie sprawdza i nie ostrzega, więc ich nie używaj.
• Brak bloku RUN: jeśli plik XEX go nie ma, loader sam dodaje uruchomienie od adresu pierwszego bloku.

/ Uruchamianie gotowego .car

Emulator, flashcart lub programator muszą obsługiwać mapper J(atari)Cart (w Atari800 są to typy 104–111). Docelowy komputer to XL/XE. Loader przełącza banki przez $D500+n i wyłącza cartridge przez $D5FF. Przytrzymanie OPTION przy starcie uruchamia komputer bez cartridge’a.

/ Co poprawiłem w loaderze

Wersja 4 zawiera cztery poprawki loadera GienekP, każdą sprawdzoną w emulatorze:

• Szybsze ładowanie: usunąłem dwie zbędne synchronizacje do linii rastra (VCOUNT) przy każdym przełączeniu banku. Na większych plikach daje to oszczędność rzędu kilkunastu sekund.
• Test pamięci rozszerzonej: rejestr PBCTL ($D303) miał czasem wyzerowany bit 2 w chwili, gdy gry testują banki rozszerzonej pamięci. Poprawka naprawia m.in. Karateka, Airball i Koronis Rift.
• Wyścig z przerwaniem NMI: przerwanie mogło trafić w moment, gdy loader miał włączony bank cartridge’a, a handler gry leżał w obszarze $A000–$BFFF. To najważniejsza poprawka: naprawia m.in. Kaboom!, The Last Guardian i Barbarian.
• Bezpieczny handler BREAK: wektor VBREAK nie był inicjalizowany. Teraz wskazuje na bezpieczne „PLA; RTI” z oryginalnego OS-u.

/ Jak dobrze to działa

Na próbce około 550 plików z kolekcji GBATARI ok. 96% działało: kończyło ładowanie albo czekało na gracza. Na osobnej próbce 120 losowych plików w pełni działało 95% (114 z 120). Część przypadków jest zdiagnozowana, ale nienaprawiona:

• Crash: Bomb Jack (320 XE), Eureka, Laura (English, 130 XE).
• Zawieszenie: Ardeny 1944, Red Max, Duszpasterz Jan Rzygon, Basil the Great Mouse Detective, Ninja Commando, Elektra Glide, Mastermatch, Ketchup, Teenage Queen Black Jack, Alfa Boot, Droga Do Duplandu (256 XE).

Jeśli trafisz na plik z takim objawem, napisz (kontakt), o jaki plik chodzi. Pozwoli to poprawiać pojedyncze przypadki zamiast szukać po omacku. Pełny opis poprawek i testów jest w pakiecie ze źródłami.

/ Budowanie ze źródeł

Pakiet ze źródłami zawiera kod aplikacji i skrypt build.sh. Potrzebujesz mingw-w64 (x86_64-w64-mingw32-g++ i windres) oraz Dear ImGui v1.91.5 rozpakowanego do vendor/imgui (nie jest dołączony). Źródło loadera xex2car_patched.asm (MADS 2.1.7) i tablicę xex2car_patched.h można też wkleić do oryginalnego xex2car.c. Program wymaga Windows 64-bit z DirectX 11.

Program autorski: Splavinho 2026. Konwerter i oryginalny loader: xex2car autorstwa GienekP.