JoyPro 1 (2021 do 2023) je bil orodje za DCS: delal je relacije med vhodi različnih letal in jih vezal na isto mesto na palici. JoyPro 2 ohrani natanko to zamisel in isti model relacija / vezava / modifikator (profil JoyPro 1 se odpre v JoyPro 2) ter vse okoli njega zgradi na novo: nov vmesnik, pogon, ki teče tudi samostojno, desetine iger, teste za vsako funkcijo in veliko varnosti.
#Številke
Vse številke so izmerjene na izvorni kodi obeh projektov (datoteke, ki jih sledi git; vrstice kode = neprazne vrstice C#, ki niso komentarji). Številke JoyPro 2 so iz gradnje te spletne strani.
| JoyPro 1 | JoyPro 2 | |
|---|---|---|
| Razvoj | 2021-02-11 do 2023-11-15 | od 2026-09-30 |
| Commiti | 336 | 1,406 |
| Vrstice kode C# | 25,502 | 354,663 (13.9 x) |
| Datoteke C# | 77 | 954 |
| Tipi (razredi, zapisi, naštevanja ...) | 106 | 3,059 (29 x) |
| Metode | 450 | 16,702 (37 x) |
| Samodejni testi (enote, modeli pogleda, izris) | 0 | 1,537 v 198 testnih datotekah |
| Deli hitrega preizkusa pogona (pravi pogon na testnih mapah) | 0 | 87 |
| Projekti v rešitvi | 2 | 12 |
| Vrstice oznak vmesnika | 973 (WPF XAML) | 17,250 (Avalonia AXAML) |
| Vrstice dokumentacije (Markdown) | 109 | 25,636 |
| Igre | 1 (DCS), pozneje IL-2 | 36 jih podpira JoyPro, 57 raziskanih naslovov |
| Jeziki vmesnika | 1 | 39 |
| Ukazi pogona (ukazna vrstica) | nič (samo GUI) | 451 v 60 področjih, 19 splošnih možnosti |
| Kontrolniki GUI, opisani na tej spletni strani | 1097 |
Kje je koda v JoyPro 2 (vrstice kode C#): pogon 187,202, GUI 80,286, testi GUI 56,600, povratna sila 14,394.
flowchart LR W["Eno okno<br/>(zaslon in logika<br/>v enem)"] --> D1["Datoteke DCS"]
flowchart TB G["Okno"] --> E["Pogon<br/>(izvede vsako dejanje)"] G --> F["Pomočnik za<br/>povratno silo"] G --> V["Pomočnik za<br/>virtualni joystick"] T["Spremljevalec iger<br/>v sistemski vrstici"] --> E E --> D2["36 iger"] F ~~~ V
Za začetnike
#Kaj je bolje za vas
- Veliko iger, en profil. JoyPro 1 je bil za DCS. JoyPro 2 uvaža in izvaža 36 naslovov iger: DCS, IL-2 (Great Battles, Korea, 1946, Cliffs of Dover), Star Citizen, MSFS 2020 in 2024, X-Plane 11 in 12, Falcon BMS, War Thunder, Elite Dangerous, X4, Arma in še več. Ena relacija hrani isto funkcijo v vseh.
- Začnite s tem, kar imate. Uvoz prebere vaše obstoječe vezave iz vsake igre; nastavitev ob prvem zagonu sama najde vaše igre.
- Nič se ne more trajno pokvariti. Vsak izvoz najprej naredi varnostno kopijo datotek igre, Razveljavi zadnji izvoz pa jih vrne bajt za bajtom. Vsaka sprememba v JoyPro se shrani samodejno in jo lahko razveljavite, tudi po ponovnem zagonu (zgodovina profila).
- Pove vam, kaj bi šlo narobe. Preverjanje razloži težave z besedami igre in jih popravi z enim klikom.
- Nastavi se sam. Nastavi vse namesto mene postavi pomembne funkcije na vašo palico, plinsko ročico in pedala. Pogledate seznam in pritisnete Uporabi te gumbe ter Zapiši v mojo igro.
- Manj klikanja. Predlogi, Samodejno združevanje, Samodejna dodelitev, čarovnik za nastavitev in pomočnik JoyPro zgradijo relacije in vezave namesto vas; naučeni "vaš slog" sledi temu, kako ste to naredili prej.
- Opazi spremembe. Ko v igri kaj na novo vežete, JoyPro po zaprtju igre vpraša, ali naj to prevzame v vaš profil.
- Vaš jezik. Vmesnik govori 39 jezikov.
- Več kot vezave. Slike naprav in pregledni listi, HUD in prekrivni prikaz za prenos v živo, povratna sila iz telemetrije, virtualni joystick za igre, ki berejo samo eno napravo, navidezni krmilnik (virtualni Xbox pad) za igre, ki poznajo samo krmilnik Xbox, podatkovna zbirka kokpitov, statistika o tem, s čim letite.
- Pomoč za vsak gumb. F1 razloži kateri koli gumb, ogledi pokažejo na prave gumbe, Preproste besede pa vse ohranijo kratko.
- Brez iskanja dodatnih izvajalnih okolij. Izdaja je en zip z vsem v njem; brez SlimDX, brez izvajalnih okolij C++.
Napredno
#Funkcija za funkcijo
| Področje | JoyPro 1 | JoyPro 2 |
|---|---|---|
| Relacije | ročno, id-ji DCS | ročno z iskanjem po vseh igrah, sinonimi, katalogom funkcij, predlogi z razlogi, Samodejnim združevanjem, združevanjem po opisu, pomočnikom; "isti id, drug pomen" za vsako letalo DCS |
| Vezave | zajemi gumb ali os | zajemanje, sledenje vhodu, vezava na sliki naprave, Samodejna dodelitev za katero koli kombinacijo naprav, čarovnik za nastavitev, Razporedi z UI |
| Nastavitev osi | ukrivljenost, mrtva cona, nasičenje v DCS | za vsako igro v njenem lastnem modelu odziva, obsegi za posamezno letalo, umerjanje, način zaskočke |
| Modifikatorji | da | da, s stranjo za modifikatorje, kombinacijami, prevodom za vsako igro (BMS shift, ...) |
| Izvozi | DCS (clean, nuke) | vse igre; štirje načini in "počisti tudi", za posamezno letalo, najmanjša razlika glede na privzete nastavitve DCS, oznake za vezave, ki niso zapisane, varnostne kopije in razveljavitev |
| Uvozi | DCS | vse igre, s privzetimi nastavitvami, tipkovnico, združevanjem naprav, ponovnim uvozom imen/skupin/modifikatorjev |
| Varnost | "sami naredite varnostno kopijo" | samodejne varnostne kopije z različicami, zavrne pisanje, dokler igra teče, zgodovina profila z razveljavitvijo prek več sej, peskovnik za pisanje pri testih |
| Preverjanja | validate | preverjanje: kartice z besedami igre, popravki z enim klikom, vzrok iz zgodovine |
| Postavitve | izvoz slik postavitve | referenčne slike naprav (natančen model po VID:PID in imenu HID), pregledni listi, 3D-pogledi naprav |
| Prekrivni prikaz | prekrivni prikaz v igri | oblikovalnik HUD, prekrivni prikaz, stran za pretok v OBS, vhodi v živo |
| Seznam iger | priložena baza podatkov (html) | zgrajen na vašem računalniku iz vaše namestitve, osvežen po posodobitvah iger |
| Spremljanje | brez | spremljanje konfiguracije iger z gostiteljem v sistemski vrstici, vpraša po izhodu iz igre |
| Force feedback | brez | telemetrijska povratna sila za DCS, IL-2, War Thunder in druge (JoyPro.Ffb) |
| Virtualne naprave | brez | način vJoy / Xbox pad s HidHide, virtualne funkcije, uvoz iz Joystick Gremlin |
| Jeziki | angleščina | 39 |
| Posodobitve | ročni prenos | preverjanje posodobitev z opombami ob izdaji, namestitev s preverjeno kontrolno vsoto |
| Poročila o težavah | vprašajte na Discordu | ena datoteka za podporo z dnevniki, nastavitvami in (na zahtevo) profilom; uporabniška mapa nadomeščena; nič se ne naloži |
Tehnične podrobnosti
#Arhitektura in kakovost
- Razdeljeno na pogon in GUI. JoyPro 1 je bil ena aplikacija WPF z logiko v kodi okna. JoyPro 2 ima pogon (
engine.exe, .NET Framework 4.8, navaden C#), ki vsebuje vso logiko profilov, uvoza/izvoza in baze podatkov kot 451 ukazov, in GUI Avalonia (.NET 9), ki za vsako dejanje zažene pogon. Hitri interaktivni ukazi gredo v en dolgo tekočengine serve, zato GUI ostane hiter, ne da bi se odpovedal ločitvi. Vse, kar naredi GUI, je mogoče skriptirati (glejte ukazno vrstico pogona). - Ločeni procesi za stalna opravila:
JoyPro.Ffb.exe(telemetrijska povratna sila),JoyPro.VJoy.exe(posredovalnik virtualnega joysticka),JoyPro.Tray.exe(spremljanje, ko je GUI zaprt), vsak s proračunom virov in dolgotrajnimi testi obremenitve, da v ozadju ostanejo neopazni. - Testi: 1,537 avtomatskih testov (xUnit: logika pogona, modeli pogledov, izrisi strani zunaj zaslona v svetli in temni temi), 87 delov hitrega testa pogona, ki pravi pogon poženejo na testnih mapah, izbirna kakovostna vrata s preverjanji invariant na pravih podatkih in celoviti testi v igri za igre, ki to podpirajo. Testi tečejo v peskovniku za pisanje s preverjanjem prstnega odtisa pravih map, zato se noben test ne more dotakniti pravih map iger.
- Podatki: seznami ukazov iger se zgradijo na uporabnikovem računalniku iz nameščene igre v
%LOCALAPPDATA%\JoyPro2\GameData; JoyPro prinaša samo svoje podatke (katalog funkcij, katalog naprav, pretvorbene tabele, bazo kokpitov). - Dokumentacija iz izvorne kode: matrika podpore iger pride iz kode (
engine games support), referenca CLI izengine --help, to spletno mesto pa iz AXAML, modelov pogledov in dokumentacije.
#Povezano
- Stanje wikija: kako popolna je ta dokumentacija
- Podpora za igre: vsaka igra s tem, kaj JoyPro naredi zanjo