JoyPro 1 (2021. do 2023.) bio je alat za DCS: stvarao je relacije između ulaza različitih zrakoplova 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 otvara se u JoyPro 2), a sve oko toga gradi iznova: novo sučelje, engine koji radi i samostalno, desetci igara, testovi za svaku funkciju i puno sigurnosti.
#Brojke
Sve su brojke izmjerene na izvornom kodu obaju projekata (datoteke praćene u gitu; redci koda = neprazni C# redci koji nisu komentari). Brojke za JoyPro 2 potječ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 |
| Redci 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 mapama) | 0 | 87 |
| Projekti u rješenju (solution) | 2 | 12 |
| Redci oznaka sučelja | 973 (WPF XAML) | 17,250 (Avalonia AXAML) |
| Redci dokumentacije (Markdown) | 109 | 25,636 |
| Igre | 1 (DCS), kasnije IL-2 | 36 podržava JoyPro, 57 istraženih naslova |
| Jezici sučelja | 1 | 39 |
| Naredbe engine-a (naredbeni redak) | nema (samo sučelje) | 451 u 60 područja, 19 globalnih opcija |
| Kontrole sučelja opisane na ovoj web-stranici | 1097 |
Gdje je kôd u JoyPro 2 (redci C# koda): engine 187,202, sučelje 80,286, testovi sučelja 56,600, force feedback 14,394.
flowchart LR W["Jedan prozor<br/>(zaslon 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/>force feedback"] G --> V["Pomoćnik za<br/>virtualni joystick"] T["Praćenje<br/>na programskoj traci"] --> E E --> D2["36 igara"] F ~~~ V
Za početnike
#Što je bolje za vas
- Mnogo igara, jedan profil. JoyPro 1 bio je 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 svima njima.
- Počnite od onoga što imate. Uvoz čita vaše postojeće dodjele iz svake igre; postavljanje pri prvom pokretanju samo pronalazi vaše igre.
- Ništa se ne može trajno pokvariti. Svaki izvoz najprije sigurnosno kopira datoteke igre, a Poništi zadnji izvoz vraća ih bajt po bajt. Svaka promjena u JoyPro sprema se automatski i može se poništiti, čak i nakon ponovnog pokretanja (povijest profila).
- Kaže vam što bi pošlo po zlu. Provjera objašnjava probleme riječima igre i popravlja ih jednim klikom.
- Postavlja se sam. Postavi sve umjesto mene stavlja važne funkcije na vašu palicu, gas i pedale. Vi pogledate popis i pritisnete Koristi ove tipke i Zapiši u moju igru.
- Manje klikanja. Prijedlozi, Automatsko grupiranje, Automatska dodjela, čarobnjak za postavljanje i JoyPro pomoćnik izrađuju relacije i dodjele umjesto vas; naučeni "vaš stil" slijedi kako ste to prije radili.
- Primjećuje promjene. Kad nešto ponovno dodijelite u igri, JoyPro nakon zatvaranja igre pita treba li to preuzeti u vaš profil.
- Vaš jezik. Sučelje govori 39 jezika.
- Više od dodjela. Slike uređaja i podsjetnici, HUD i preklop za stream, force feedback iz telemetrije, virtualni joystick za igre koje čitaju samo jedan uređaj, glumljeni kontroler (virtualni Xbox gamepad) za igre koje poznaju samo Xbox kontroler, baza kokpita, statistika onoga čime letite.
- Pomoć za svaku tipku. F1 objašnjava bilo koju tipku, vodiči pokazuju na prave tipke, a Jednostavne riječi drže sve kratkim.
- Nema dodatnih runtimeova za traženje. Izdanje je jedan zip sa svime unutra; bez SlimDX, bez C++ runtimeova.
Napredno
#Značajku po značajku
| Područje | JoyPro 1 | JoyPro 2 |
|---|---|---|
| Relacije | ručno, DCS id-ovi | ručno, s pretraživanjem kroz sve igre, sinonimima, katalogom funkcija, prijedlozima s razlozima, Automatskim grupiranjem, grupiranjem po opisu, pomoćnikom; „isti id, drugo značenje” po DCS zrakoplovu |
| Dodjele | snimanje tipke ili osi | snimanje, praćenje ulaza, dodjela na slici uređaja, Automatska dodjela za bilo koju kombinaciju uređaja, čarobnjak za postavljanje, Rasporedi s AI-jem |
| Podešavanje osi | DCS zakrivljenost, mrtva zona, saturacija | po igri u njezinu vlastitom modelu odziva, područja po zrakoplovu, kalibracija, način zaskočnika |
| Modifikatori | da | da, sa stranicom modifikatora, kombinacijama, prijevodom po igri (BMS shift, ...) |
| Izvoz | DCS (clean, nuke) | svaka igra; četiri načina plus „očisti i moje druge uređaje”, po zrakoplovu, minimalna razlika prema zadanim postavkama DCS-a, oznake za dodjele koje nisu zapisane, sigurnosne kopije i poništavanje |
| Uvezi | DCS | svaka igra, sa zadanim postavkama, tipkovnicom, spajanjem uređaja, ponovnim uvozom imena/grupa/modifikatora |
| Sigurnost | „napravite sigurnosnu kopiju sami” | automatske sigurnosne kopije s verzijama, odbija pisati dok igra radi, povijest profila s poništavanjem i nakon ponovnog pokretanja, zaštićeno okruženje za pisanje (sandbox) u testovima |
| Provjere | provjera valjanosti | Provjera: kartice riječima igre, ispravci jednim klikom, uzrok iz povijesti |
| Rasporedi | izvoz slika rasporeda | referentne slike uređaja (točan model prema VID:PID i HID imenu), podsjetnici, 3D prikazi uređaja |
| Preklop (overlay) | preklop u igri | HUD dizajner, preklop, stranica za stream za OBS, ulazi uživo |
| Popis igara | isporučena baza podataka (html) | izrađuje se na vašem računalu iz vaše instalacije, osvježava se nakon ažuriranja igre |
| Praćenje | nema | praćenje konfiguracije igre s pomoćnikom na programskoj traci, pita nakon izlaska iz igre |
| Force feedback | nema | force feedback iz telemetrije za DCS, IL-2, War Thunder i druge (JoyPro.Ffb) |
| Virtualni uređaji | nema | način vJoy / Xbox gamepad s HidHideom, 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 zbroja |
| Izvješća o problemima | pitajte na Discordu | jedna datoteka za podršku sa zapisnicima, postavkama i (na zahtjev) profilom; korisnička mapa zamijenjena; ništa se ne šalje na internet |
Tehnički detalji
#Arhitektura i kvaliteta
- Podijeljen na engine i GUI. JoyPro 1 bio je 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 naredbi, te Avalonia GUI (.NET 9) koji pokreće engine za svaku radnju. Brze interaktivne naredbe idu jednom dugotrajnomengine serve, pa GUI ostaje brz bez odustajanja od razdvajanja. Sve što GUI radi može se skriptirati (pogledajte naredbeni redak engine-a). - Zasebni procesi za stalne poslove:
JoyPro.Ffb.exe(force feedback iz telemetrije),JoyPro.VJoy.exe(prosljeđivač virtualnog joysticka),JoyPro.Tray.exe(praćenje dok je GUI zatvoren), svaki s proračunom resursa i dugotrajnim testovima opterećenja, kako bi u pozadini ostali neprimjetni. - Testovi: 1,537 automatiziranih testova (xUnit: logika engine-a, view modeli, iscrtavanja stranica izvan zaslona u svijetloj i tamnoj temi), 87 dijelova smoke testa koji pokreću pravi engine nad testnim mapama, neobavezna provjera kvalitete 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 mapa, pa nijedan test ne može dirati stvarne mape igara.
- Podaci: popisi naredbi igara izrađuju se na korisnikovu računalu iz instalirane igre u
%LOCALAPPDATA%\JoyPro2\GameData; JoyPro isporučuje samo vlastite podatke (katalog funkcija, katalog uređaja, tablice pretvorbe, bazu podataka kokpita). - Dokumentacija generirana iz izvornog koda: matrica podrške igara dolazi iz koda (
engine games support), referenca naredbenog retka 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 što JoyPro radi za nju