Miten Jypeli-peli toimii¶

Tämä sivu kertoo, mistä osista Jypeli-peli koostuu, mihin kohtaan tiedostoa koodirivit kirjoitetaan ja mitä sanat kenttä, kamera ja ruutu tarkoittavat. Tietoa tarvitaan lähes joka ohjeessa.

Peli on luokka, Begin sen alku¶

Peli on C#-luokka, joka perii Jypelin PhysicsGame-luokan (tai Game, jos fysiikkaa ei tarvita). Jypeli kutsuu pelin Begin-aliohjelmaa kerran käynnistyksessä. Sen jälkeen Jypeli pyörittää pelisilmukkaa itse: se siirtää olioita, laskee törmäykset, piirtää ruudun ja kutsuu sinun aliohjelmiasi, kun jotain tapahtuu (näppäintä painetaan, ajastin laukeaa, oliot törmäävät). Omaa silmukkaa ei siis kirjoiteta. Silmukan vaiheet selitetään sivulla Mitä konepellin alla tapahtuu.

public class Peli : PhysicsGame
{
    public override void Begin()
    {
        // Luo oliot, aseta näppäimet, käynnistä ajastimet.
    }
}

Mihin koodi kirjoitetaan¶

Ohjeissa on paljon yksittäisiä koodirivejä. Peliluokassa on kolme paikkaa, joihin ne kuuluvat.

using Jypeli;

public class Peli : PhysicsGame
{
    // 1. ATTRIBUUTIT: luokan sisällä, aliohjelmien ulkopuolella.
    PhysicsObject pelaaja;
    IntMeter pisteet;

    // 2. BEGIN: suoritetaan kerran pelin alussa.
    public override void Begin()
    {
        pelaaja = new PhysicsObject(40, 40);
        Add(pelaaja);
        Keyboard.Listen(Key.Space, ButtonState.Pressed, Hyppaa, "Hyppää");
    }

    // 3. OMAT ALIOHJELMAT: luokan sisällä, Beginin rinnalla.
    void Hyppaa()
    {
        pelaaja.Hit(new Vector(0, 500));
    }
}

• Yksittäiset rivit, kuten Gravity = new Vector(0, -800); tai Add(olio);, kirjoitetaan aliohjelman sisään, useimmiten Begin-aliohjelmaan.
• Kokonaiset aliohjelmat, jotka alkavat esimerkiksi void LuoKentta(), kirjoitetaan luokan sisään mutta toisten aliohjelmien ulkopuolelle. Aliohjelmaa ei voi kirjoittaa toisen aliohjelman sisään.
• Rivi using Jypeli; on tiedoston alussa ja tulee projektimallista.

Paikallinen muuttuja vai attribuutti¶

Muuttuja, joka luodaan aliohjelman sisällä (PhysicsObject pallo = new ... Begin-aliohjelmassa), on paikallinen: se on olemassa vain siinä aliohjelmassa. Jos toinen aliohjelma, vaikkapa näppäimen käsittelijä, tarvitsee samaa oliota, on kaksi tapaa.

Tapa 1: anna olio parametrina. Listen-kutsun loppuun voi lisätä omia parametreja, jotka Jypeli välittää käsittelijälle.

public override void Begin()
{
    PhysicsObject pallo = new PhysicsObject(40, 40);
    Add(pallo);
    Keyboard.Listen(Key.Space, ButtonState.Pressed, Hyppaa, "Hyppää", pallo);
}

void Hyppaa(PhysicsObject olio)
{
    olio.Hit(new Vector(0, 500));
}

Tämä on suositeltava tapa, kun se riittää: aliohjelma toimii millä tahansa oliolla.

Tapa 2: tee muuttujasta attribuutti. Siirrä muuttujan esittely luokan tasolle ja anna sille arvo Begin-aliohjelmassa ilman tyyppiä.

PhysicsObject pallo;      // esittely luokan tasolla

public override void Begin()
{
    pallo = new PhysicsObject(40, 40);   // ei "PhysicsObject" eteen!
    Add(pallo);
}

void Hyppaa()
{
    pallo.Hit(new Vector(0, 500));
}

Tavallinen virhe on kirjoittaa Begin-aliohjelmaan uudestaan PhysicsObject pallo = new .... Silloin syntyy uusi paikallinen muuttuja, joka peittää attribuutin, ja attribuutti jää tyhjäksi (null).

Attribuutti sopii asioille, joita on yksi ja joita moni aliohjelma tarvitsee: pelaaja, pistelaskuri, ajastin. Ks. myös Ohjelmointi 1:n luento attribuuteista.

Oliot¶

Kaikki ruudulla näkyvä on olioita. PhysicsObject noudattaa fysiikkaa, GameObject ei. Olio tulee näkyviin vasta, kun se on lisätty peliin Add-aliohjelmalla, ja katoaa, kun sille kutsutaan Destroy-metodia. Tarkemmin: Olion luominen ja Oliotyypit.

Koordinaatisto¶

Kentän origo (0, 0) on ruudun keskellä. X kasvaa oikealle ja y kasvaa ylöspäin, kuten matematiikassa (ei kuten useissa muissa grafiikkakirjastoissa, joissa y kasvaa alaspäin). Koordinaatit ovat Jypelin omia yksiköitä, eivät näytön pikseleitä. Kuinka suurena olio ruudulla näkyy, riippuu muun muassa kamerasta.

Sijainti annetaan Vector-oliona tai erikseen: olio.Position = new Vector(100, -50) tai olio.X = 100; olio.Y = -50;. Kulmat annetaan Angle-tyyppinä, esimerkiksi Angle.FromDegrees(90); nolla osoittaa oikealle ja kulma kasvaa vastapäivään.

Kenttä, kamera ja ruutu¶

Aloittelijan tavallisin hämmennys: olio on luotu ja lisätty, mutta se ei näy. Syy on yleensä, että olio on kameran näkymän ulkopuolella. Kutsu Camera.ZoomToLevel() tai tarkista sijainti.

Fysiikan yksiköt¶

Fysiikka-arvot käyttävät samoja yksiköitä kuin koordinaatisto. Painovoima annetaan yksikköinä sekunnissa toiseen, esimerkiksi Gravity = new Vector(0, -981) vastaa tulkintaa "yksi yksikkö on senttimetri". Nopeus on yksikköä sekunnissa. Sopivat arvot löytyvät kokeilemalla, ks. Painovoima ja Fysiikan ilmiöt.

Tapahtumat ja käsittelijät¶

Peli reagoi asioihin tapahtumankäsittelijöillä: annat Jypelille oman aliohjelmasi nimen, ja Jypeli kutsuu sitä, kun tapahtuma sattuu.

Keyboard.Listen(Key.Left, ButtonState.Down, LiikutaVasemmalle, "Liiku vasemmalle");
AddCollisionHandler(pallo, maila, PalloOsuiMailaan);
ajastin.Timeout += LisaaVihollinen;

Käsittelijä on tavallinen aliohjelma, jonka parametrit riippuvat tapahtumasta. Ks. Ohjainten lisääminen, Törmäysten käsittely ja Ajastimet. Se, miksi aliohjelman nimi kelpaa parametriksi, selitetään sivulla Delegaatit.

Aliohjelman parametrit tulevat tapahtumasta¶

Tapahtumankäsittelijän parametrit määrää tapahtuma, et sinä:

Jos parametrit ovat väärät, Rider ilmoittaa virheestä Listen- tai AddCollisionHandler-rivillä, ei aliohjelman kohdalla. Ks. Yleiset virheet.

Sisältötiedostot¶

Kuvat, äänet ja kenttätiedostot laitetaan projektin Content-kansioon ja ladataan nimellä: LoadImage("norsu"), LoadSoundEffect("pum"). Ks. Kuvat ja äänet mukaan projektiin.