JoyPro 1 (2021–2023) oli DCS-työkalu: se loi suhteita eri ilma-alusten tulojen välille ja määritti ne samaan kohtaan ohjainsauvassa. JoyPro 2 säilyttää täsmälleen saman idean ja saman suhde / näppäinmääritys / muunnin -mallin (JoyPro 1 -profiili avautuu JoyPro 2:ssa) ja rakentaa kaiken muun uudelleen: uusi käyttöliittymä, myös itsenäisesti toimiva moottori, kymmeniä pelejä, testit jokaiselle ominaisuudelle ja paljon turvallisuutta.
#Luvut
Kaikki luvut on mitattu molempien projektien lähdekoodista (gitissä seuratut tiedostot; koodirivit = ei-tyhjät C#-rivit, jotka eivät ole kommentteja). JoyPro 2:n luvut ovat tämän sivuston koontiversiosta.
| JoyPro 1 | JoyPro 2 | |
|---|---|---|
| Kehitys | 2021-02-11–2023-11-15 | 2026-09-30 alkaen |
| Commitit | 336 | 1,406 |
| C#-koodirivit | 25,502 | 354,663 (13.9 x) |
| C#-tiedostot | 77 | 954 |
| Tyypit (luokat, recordit, enumit ...) | 106 | 3,059 (29 x) |
| Metodit | 450 | 16,702 (37 x) |
| Automaattiset testit (yksikkö, näkymämalli, renderöinti) | 0 | 1,537, 198 testitiedostossa |
| Moottorin savutestin osat (oikea moottori testikansioilla) | 0 | 87 |
| Projektit ratkaisussa | 2 | 12 |
| Käyttöliittymän merkintäkielen rivit | 973 (WPF XAML) | 17,250 (Avalonia AXAML) |
| Dokumentaation rivit (Markdown) | 109 | 25,636 |
| Pelit | 1 (DCS), myöhemmin IL-2 | 36 JoyPron tukemaa, 57 peliä tutkittu |
| Käyttöliittymän kielet | 1 | 39 |
| Moottorin komennot (komentorivi) | ei yhtään (vain käyttöliittymä) | 451 komentoa 60 alueella, 19 yleistä valitsinta |
| Tällä sivustolla dokumentoidut käyttöliittymän ohjausobjektit | 1097 |
Missä JoyPro 2:n koodi on (C#-koodirivit): moottori 187,202, käyttöliittymä 80,286, käyttöliittymätestit 56,600, voimapalaute 14,394.
flowchart LR W["Yksi ikkuna<br/>(näyttö ja logiikka<br/>samassa)"] --> D1["DCS-tiedostot"]
flowchart TB G["Ikkuna"] --> E["Moottori<br/>(tekee jokaisen toiminnon)"] G --> F["Voimapalautteen<br/>apuohjelma"] G --> V["Virtuaalisen joystickin<br/>apuohjelma"] T["Seuranta<br/>ilmaisinalueella"] --> E E --> D2["36 peliä"] F ~~~ V
#Mikä on parempaa sinulle
- Monta peliä, yksi profiili. JoyPro 1 oli DCS:lle. JoyPro 2 tuo ja vie 36 peliä: DCS, IL-2 (Great Battles, Korea, 1946, Cliffs of Dover), Star Citizen, MSFS 2020 ja 2024, X-Plane 11 ja 12, Falcon BMS, War Thunder, Elite Dangerous, X4, Arma ja muita. Yksi suhde pitää saman toiminnon niissä kaikissa.
- Aloita siitä, mitä sinulla on. Tuonti lukee olemassa olevat näppäinmäärityksesi jokaisesta pelistä; ensimmäisen käynnistyksen määritys löytää pelisi itse.
- Mikään ei voi rikkoutua lopullisesti. Jokainen vienti varmuuskopioi ensin pelin tiedostot, ja Kumoa viimeisin vienti palauttaa ne tavu tavulta. Jokainen muutos JoyProssa tallennetaan automaattisesti ja voidaan kumota, myös uudelleenkäynnistyksen jälkeen (profiilin historia).
- Se kertoo, mikä menisi pieleen. Tarkistus selittää ongelmat pelin sanoin ja korjaa ne yhdellä napsautuksella.
- Se määrittää itsensä. Tee kaikki puolestani sijoittaa tärkeät toiminnot ohjainsauvaasi, kaasuvipuusi ja polkimiisi. Katsot luetteloa ja painat Käytä näitä painikkeita ja Kirjoita peliini.
- Vähemmän napsauttelua. Ehdotukset, Automaattinen ryhmittely, Automaattinen määritys, määritysohjattu toiminto ja JoyPro-avustaja rakentavat suhteet ja näppäinmääritykset puolestasi; opittu ”oma tyylisi” seuraa sitä, miten teit asiat aiemmin.
- Se huomaa muutokset. Kun määrität jotain uudelleen pelin sisällä, JoyPro kysyy pelin sulkeuduttua, otetaanko muutos profiiliisi.
- Sinun kielesi. Käyttöliittymä puhuu 39 kieltä.
- Enemmän kuin näppäinmäärityksiä. Laitekuvat ja pikaohjeet, HUD ja striimin peittokuva, voimapalaute telemetriasta, virtuaalinen joystick peleille, jotka lukevat vain yhtä laitetta, leikkiohjain (virtuaalinen Xbox-ohjain) peleille, jotka tuntevat vain Xbox-ohjaimen, ohjaamotietokanta ja tilastot siitä, millä lennät.
- Ohje jokaiselle painikkeelle. F1 selittää minkä tahansa painikkeen, esittelyt osoittavat oikeita painikkeita, ja Helpot sanat pitää tekstit lyhyinä.
- Ei ylimääräisiä ajonaikaisia kirjastoja etsittäväksi. Julkaisu on yksi zip, jossa on kaikki; ei SlimDX:ää, ei C++-ajonaikaisia kirjastoja.
#Ominaisuus ominaisuudelta
| Alue | JoyPro 1 | JoyPro 2 |
|---|---|---|
| Suhteet | käsin, DCS-tunnisteet | käsin, haku kaikista peleistä, synonyymit, toimintoluettelo, perustellut ehdotukset, Automaattinen ryhmittely, ryhmittely kuvauksen mukaan, avustaja; "sama tunniste, eri merkitys" DCS-ilma-aluksittain |
| Määritykset | tallenna painike tai akseli | syötteen tallennus, tulon seuraaminen, määritys laitteen kuvassa, Automaattinen määritys mille tahansa laiteyhdistelmälle, ohjattu määritys, Aseta tekoälyllä |
| Akseleiden säätö | DCS:n kaarevuus, kuollut alue, kyllästys | pelikohtaisesti pelin omalla vastemallilla, ilma-aluskohtaiset alueet, kalibrointi, pykälätila |
| Muuntimet | kyllä | kyllä: muunninsivu, yhdistelmät, pelikohtainen muunnos (BMS shift, ...) |
| Vie | DCS (clean, nuke) | kaikki pelit; neljä tilaa ja "tyhjennä myös", ilma-aluskohtainen, mahdollisimman pieni ero DCS:n oletuksiin, merkinnät kirjoittamatta jääneille määrityksille, varmuuskopiot ja kumoaminen |
| Tuo | DCS | kaikki pelit, oletukset, näppäimistö, laitteiden yhdistäminen, nimien/ryhmien/muuntimien uudelleentuonti |
| Turvallisuus | "tee varmuuskopio itse" | automaattiset versioidut varmuuskopiot, ei kirjoita pelin ollessa käynnissä, profiilihistoria ja kumoaminen istuntojen yli, kirjoitushiekkalaatikko testeissä |
| Tarkistukset | tarkista | Tarkista-kortit pelin sanoin, korjaus yhdellä napsautuksella, aiheuttaja historiasta |
| Asettelut | asettelukuvien vienti | laitteiden referenssikuvat (tarkka malli VID:PID:n ja HID-nimen perusteella), pikaohjeet, 3D-laitenäkymät |
| Peittokuva | pelinsisäinen peittokuva | HUD-suunnittelija, peittokuva, striimisivu OBS:lle, reaaliaikaiset tulot |
| Peliluettelo | mukana toimitettu tietokanta (html) | rakennetaan PC:lläsi omasta asennuksestasi, päivitetään pelipäivitysten jälkeen |
| Seuranta | ei mitään | pelin asetusten seuranta ilmaisinalueella, kysyy pelin sulkeuduttua |
| Voimapalaute | ei mitään | telemetriaan perustuva voimapalaute DCS:lle, IL-2:lle, War Thunderille ja muille (JoyPro.Ffb) |
| Virtuaaliset laitteet | ei mitään | vJoy- / Xbox-ohjaintila ja HidHide, virtuaaliset toiminnot, Joystick Gremlin -tuonti |
| Kielet | englanti | 39 |
| Päivitykset | lataus käsin | päivitystarkistus julkaisutietoineen, tarkistussummalla varmistettu asennus |
| Ongelmaraportit | kysy Discordissa | yksi tukitiedosto, jossa lokit, asetukset ja (pyynnöstä) profiili; käyttäjäkansio korvattu; mitään ei ladata verkkoon |
#Arkkitehtuuri ja laatu
- Jaettu moottoriin ja käyttöliittymään. JoyPro 1 oli yksi WPF-sovellus, jonka logiikka oli ikkunakoodissa. JoyPro 2:ssa on moottori (
engine.exe, .NET Framework 4.8, tavallinen C#), joka sisältää kaiken profiili-, tuonti-/vienti- ja tietokantalogiikan 451 komentona, sekä Avalonia-käyttöliittymä (.NET 9), joka suorittaa moottorin jokaista toimintoa varten. Nopeat vuorovaikutteiset komennot menevät yhdelle pitkään käynnissä olevalleengine serve-prosessille, joten käyttöliittymä pysyy nopeana luopumatta erottelusta. Kaiken, mitä käyttöliittymä tekee, voi tehdä skriptillä (katso moottorin komentorivi). - Erilliset prosessit pysyville tehtäville:
JoyPro.Ffb.exe(telemetrian voimapalaute),JoyPro.VJoy.exe(virtuaalisen joystickin välittäjä),JoyPro.Tray.exe(seuranta, kun käyttöliittymä on suljettu), kullakin resurssibudjetit ja kestotestit, jotta ne pysyvät huomaamattomina taustalla. - Testit: 1,537 automaattista testiä (xUnit: moottorin logiikka, näkymämallit, sivujen näytön ulkopuoliset renderöinnit vaaleana ja tummana), 87 moottorin savutestin osaa, jotka ajavat oikeaa moottoria testikansioita vasten, valinnainen laatuportti invarianttitarkistuksineen oikealla datalla sekä pelinsisäiset päästä päähän -ajot niille peleille, jotka tukevat niitä. Testit ajetaan kirjoitushiekkalaatikossa, jossa on oikeiden kansioiden sormenjälkitarkistus, joten mikään testi ei voi koskea oikeisiin pelikansioihin.
- Data: pelien komentoluettelot rakennetaan käyttäjän PC:llä asennetusta pelistä kansioon
%LOCALAPPDATA%\JoyPro2\GameData; JoyPro toimittaa vain omat tietonsa (toimintoluettelo, laiteluettelo, muunnostaulukot, ohjaamotietokanta). - Dokumentaatio luodaan lähdekoodista: pelien tukimatriisi tulee koodista (
engine games support), komentorivin viite komennostaengine --helpja tämä sivusto AXAML-tiedostoista, näkymämalleista ja dokumentaatiosta.
#Liittyvät
- Wikin tila: kuinka valmis tämä dokumentaatio on
- Pelituki: jokainen peli ja mitä JoyPro tekee sille