JoyPro 1 (2021. do 2023.) je bio alat za DCS: pravio je relacije između ulaza različitih letjelica i dodjeljivao ih na isto mjesto na palici. JoyPro 2 zadržava upravo tu ideju i isti model relacija / dodjela / modifikatora (profil iz JoyPro 1 se otvara u JoyPro 2), a sve oko toga gradi iznova: novi interfejs, engine koji radi i samostalno, desetine igara, testovi za svaku funkciju i mnogo sigurnosti.
#Brojke
Sve brojke su izmjerene na izvornom kodu oba projekta (datoteke praćene u gitu; linije koda = neprazne C# linije koje nisu komentari). Brojke za JoyPro 2 potiču iz izrade ove web stranice.
| JoyPro 1 | JoyPro 2 | |
|---|---|---|
| Razvoj | 2021-02-11 do 2023-11-15 | od 2026-09-30 |
| Commitovi | 336 | 1,406 |
| Linije C# koda | 25,502 | 354,663 (13.9 x) |
| C# datoteke | 77 | 954 |
| Tipovi (klase, recordi, enumi ...) | 106 | 3,059 (29 x) |
| Metode | 450 | 16,702 (37 x) |
| Automatski testovi (unit, view model, render) | 0 | 1,537 u 198 testnih datoteka |
| Dijelovi smoke testa engine-a (pravi engine na testnim folderima) | 0 | 87 |
| Projekti u rješenju (solution) | 2 | 12 |
| Linije oznaka interfejsa | 973 (WPF XAML) | 17,250 (Avalonia AXAML) |
| Linije dokumentacije (Markdown) | 109 | 25,636 |
| Igre | 1 (DCS), kasnije IL-2 | 36 podržava JoyPro, 57 istraženih naslova |
| Jezici interfejsa | 1 | 39 |
| Komande engine-a (komandna linija) | nema (samo interfejs) | 451 u 60 oblasti, 19 globalnih opcija |
| Kontrole interfejsa opisane na ovoj web stranici | 1097 |
Gdje je kod u JoyPro 2 (linije C# koda): engine 187,202, interfejs 80,286, testovi interfejsa 56,600, povratna sila 14,394.
flowchart LR W["Jedan prozor<br/>(ekran i logika<br/>u jednom)"] --> D1["DCS datoteke"]
flowchart TB G["Prozor"] --> E["Engine<br/>(izvršava svaku radnju)"] G --> F["Pomoćnik za<br/>povratnu silu"] G --> V["Pomoćnik za<br/>virtualni joystick"] T["Praćenje<br/>u sistemskoj traci"] --> E E --> D2["36 igara"] F ~~~ V
Za početnike
#Šta je bolje za vas
- Mnogo igara, jedan profil. JoyPro 1 je bio za DCS. JoyPro 2 uvozi i izvozi 36 naslova igara: DCS, IL-2 (Great Battles, Korea, 1946, Cliffs of Dover), Star Citizen, MSFS 2020 i 2024, X-Plane 11 i 12, Falcon BMS, War Thunder, Elite Dangerous, X4, Arma i druge. Jedna relacija drži istu funkciju u svim njima.
- Počnite od onoga što imate. Uvoz čita vaše postojeće dodjele iz svake igre; podešavanje pri prvom pokretanju samo pronalazi vaše igre.
- Ništa se ne može trajno pokvariti. Svaki izvoz prvo pravi sigurnosnu kopiju datoteka igre, a Poništi zadnji izvoz ih vraća bajt po bajt. Svaka promjena u JoyPro se čuva automatski i može se poništiti, čak i nakon ponovnog pokretanja (historija profila).
- Kaže vam šta bi pošlo naopako. Provjera objašnjava probleme riječima igre i popravlja ih jednim klikom.
- Sam se podešava. Podesi sve umjesto mene stavlja važne funkcije na vašu palicu, ručicu gasa i pedale. Vi pogledate listu i pritisnete Koristi ovu dugmad i Zapiši u moju igru.
- Manje klikanja. Prijedlozi, Auto grupisanje, Auto dodjela, čarobnjak za podešavanje i JoyPro asistent prave relacije i dodjele umjesto vas; naučeni "vaš stil" prati kako ste to ranije radili.
- Primjećuje promjene. Kada nešto ponovo dodijelite u igri, JoyPro nakon zatvaranja igre pita da li to treba preuzeti u vaš profil.
- Vaš jezik. Interfejs govori 39 jezika.
- Više od dodjela. Slike uređaja i podsjetnici, HUD i overlay za stream, povratna sila iz telemetrije, virtualni joystick za igre koje čitaju samo jedan uređaj, glumljeni kontroler (virtualni Xbox pad) za igre koje poznaju samo Xbox kontroler, baza kokpita, statistika onoga čime letite.
- Pomoć za svako dugme. F1 objašnjava bilo koje dugme, vodiči pokazuju na prava dugmad, a Jednostavne riječi drže sve kratkim.
- Nema dodatnih runtimea za traženje. Izdanje je jedan zip sa svime unutra; bez SlimDX, bez C++ runtimea.
Napredno
#Funkcija po funkcija
| Oblast | JoyPro 1 | JoyPro 2 |
|---|---|---|
| Relacije | ručno, DCS id-ovi | ručno, s pretragom kroz sve igre, sinonimima, katalogom funkcija, prijedlozima s razlozima, Auto grupisanjem, grupisanjem po opisu, asistentom; „isti id, drugo značenje” po DCS letjelici |
| Dodjele | snimanje dugmeta ili ose | snimanje, praćenje ulaza, dodjela na slici uređaja, Auto dodjela za bilo koju kombinaciju uređaja, čarobnjak za podešavanje, Rasporedi s AI-jem |
| Podešavanje osa | DCS zakrivljenost, mrtva zona, saturacija | po igri u njenom vlastitom modelu odziva, opsezi po letjelici, kalibracija, način zaskočnika |
| Modifikatori | da | da, sa stranicom modifikatora, kombinacijama, prevođenjem po igri (BMS shift, ...) |
| Izvoz | DCS (clean, nuke) | svaka igra; četiri načina plus „očisti i moje druge uređaje”, po letjelici, minimalna razlika prema zadanim dodjelama DCS-a, oznake za dodjele koje nisu upisane, sigurnosne kopije i poništavanje |
| Uvezi | DCS | svaka igra, sa zadanim dodjelama, tastaturom, spajanjem uređaja, ponovnim uvozom imena/grupa/modifikatora |
| Sigurnost | „napravite sigurnosnu kopiju sami” | automatske sigurnosne kopije s verzijama, odbija pisati dok igra radi, historija profila s poništavanjem i nakon ponovnog pokretanja, zaštićeno okruženje za pisanje (sandbox) u testovima |
| Provjere | validacija | Provjera: kartice riječima igre, popravke jednim klikom, uzrok iz historije |
| Rasporedi | izvoz slika rasporeda | referentne slike uređaja (tačan model prema VID:PID i HID imenu), podsjetnici, 3D prikazi uređaja |
| Overlay | overlay u igri | HUD dizajner, overlay, stranica za stream za OBS, ulazi uživo |
| Lista igara | isporučena baza podataka (html) | pravi se na vašem računaru iz vaše instalacije, osvježava se nakon ažuriranja igre |
| Praćenje | nema | praćenje konfiguracija igara s pomoćnikom u sistemskoj traci, pita nakon izlaska iz igre |
| Force feedback | nema | povratna sila iz telemetrije za DCS, IL-2, War Thunder i druge (JoyPro.Ffb) |
| Virtualni uređaji | nema | način vJoy / Xbox pad s HidHide-om, virtualne funkcije, uvoz iz Joystick Gremlina |
| Jezici | engleski | 39 |
| Ažuriranja | ručno preuzimanje | provjera ažuriranja s bilješkama o izdanju, instalacija s provjerom kontrolnog zbira |
| Izvještaji o problemima | pitajte na Discordu | jedna datoteka za podršku sa zapisnicima, postavkama i (na zahtjev) profilom; korisnički folder zamijenjen; ništa se ne šalje na internet |
Tehnički detalji
#Arhitektura i kvalitet
- Podijeljen na engine i GUI. JoyPro 1 je bio jedna WPF aplikacija s logikom u kodu prozora. JoyPro 2 ima engine (
engine.exe, .NET Framework 4.8, običan C#) koji sadrži svu logiku profila, uvoza/izvoza i baze podataka kao 451 komandi, i Avalonia GUI (.NET 9) koji pokreće engine za svaku radnju. Brze interaktivne komande idu jednom dugotrajnomengine serve, pa GUI ostaje brz bez odustajanja od razdvajanja. Sve što GUI radi može se skriptovati (pogledajte komandnu liniju engine-a). - Zasebni procesi za stalne poslove:
JoyPro.Ffb.exe(povratna sila iz telemetrije),JoyPro.VJoy.exe(prosljeđivač virtualnog joysticka),JoyPro.Tray.exe(praćenje dok je GUI zatvoren), svaki s budžetom resursa i dugotrajnim testovima opterećenja, kako bi u pozadini ostali neprimjetni. - Testovi: 1,537 automatizovanih testova (xUnit: logika engine-a, view modeli, iscrtavanja stranica izvan ekrana u svijetloj i tamnoj temi), 87 dijelova smoke testa koji pokreću pravi engine nad testnim folderima, neobavezna provjera kvaliteta s provjerama invarijanti na stvarnim podacima, te end-to-end testovi u igri za igre koje to podržavaju. Testovi rade u zaštićenom okruženju za pisanje s provjerom otiska stvarnih foldera, pa nijedan test ne može dirati stvarne foldere igara.
- Podaci: liste komandi igara prave se na korisnikovom računaru iz instalirane igre u
%LOCALAPPDATA%\JoyPro2\GameData; JoyPro isporučuje samo vlastite podatke (katalog funkcija, katalog uređaja, tabele konverzije, bazu podataka kokpita). - Dokumentacija generisana iz izvornog koda: matrica podrške igara dolazi iz koda (
engine games support), referenca komandne linije izengine --help, a ova web stranica iz AXAML-a, view modela i dokumentacije.
#Povezano
- Stanje wikija: koliko je ova dokumentacija potpuna
- Podrška za igre: svaka igra i šta JoyPro radi za nju