1. Programmeerimise põhimõtted. C#-iga programmeerimise lühitutvustus

Selles peatükis tutvud põhilise programmeerimisega seonduvaga. See võib olla kohati põhjalikum ja isegi mitte seotud sellega, mida Unitys vaja läheb (C# konsooliaplikatsiooni süntaks), seega soovitan selle peatüki kinnistamisele mitte liiga kaua aega kulutada. Sellegipoolest, soovitan neil, kes programmeerimises vähem kogenud või uued C#  keeles või C- või Java-taolistes keeltes, luua konsooliaplikatsiooni, et vahetult rakendada ja kinnistada peatükis õpitut. Kui C#-i kohta tekib küsimusi, soovitan täpsema seletuse jaoks uurida lehekülge: https://www.w3schools.com/cs/index.php.

Süntaks

Koodiridade asukoht ja väljanägemine 

(peaaegu) iga koodirida lõpetatakse C#-is ja paljudes teistes programmeerimiskeeltes semikooloniga; 

Enamus koodist on nurgeliste sulgude { } sees klassi või meetodi skoobis. See, mis ei ole nurgeliste sulgude sees on kas viide teegile (kui on võtmesõna using ees – see on teegi/ library/namespace-ile ligi pääsemiseks) või vigane kood.

Kommenteerimine

// on C#-is ja paljudes teistes sümbolitekombinatsioon, mis muudab rea kommentaariks, st see ei ole enam loetav kompilaatorile ning sinna võib igasuguseid süntaksiga mitteühtivaid märkmeid kirjutada. /* ... */ on viis "kommentaaristada" mitu rida korraga.

Matemaatilised tehted

Liitmine ja lahutamine käivad sümbolitega + ja - ning neid sümboleid ei tohi kasutada nimedes. 

Korrutamine ja jagamine käivad sümbolitega * ja /.

int a = 1:

int b = 2;

int summa;

summa = a + b;

int korrutis = a*b;

int jagatis = a/b; // väljundis jagatis annaks vastuseks "0", kui see oleks float, siis oleks vastus "0.5"

a jagatud b-ga on eelmise näite puhul 1-st väiksem ja pole täisarv. Sel juhul ümarduvad int-tüüpi muutujad alla ehk nulliks.

Muutujate nimetamine

Iga muutuja nimi peab olema üks sõna või kokkukirjutatud fraas. 

(Pro Tip: Unitys tasub muutujaid mille nimi oleks muidu mitmeosaline kirjutada järgmiselt: int mitmeosalineFraas; float suurVõiVäikeArv; , sest Unity Editori Inspectori kompileerija teeb need eraldi sõnadeks)

Muutuja peab koosnema tuntumatest ascii karakteritest ja ei tohi alata arvuga ega koosneda tehete sümbolitest.

Järjendi ja reastuse deklareerimine ja defineerimine

Järjendeid defineeritakse järgnevalt: 

int[] täisArvuJärjend = {1, 5, 50}

int esimeneLiige = täisArvuJärjend[0];

int viimaneLiige = täisArvuJärjend[2]; 

Programmeerimises on sellistel järjenditel indeksid, mille kohaselt kohal "0" asub esimene liige. See tähendab, et kui tahta järjendi esimest või kolmandat elementi tuleb kasutada indeksit 0 ja 2:

Reastusi (C#-is List<T>) deklareeritakse ja defineeritakse järgnevalt:

 List<int> reastus = new List<int>();

List<T> on C# teegist eraldi andmeklass ning seda tuleb deklareerida konstruktorina (st meie mõistes lihtsalt selle veidra süntaksiga) nagu eelnevas näites on seda tehtud.

reastus.Add(2); reastus.Add(5);

int sisend = Console.ReadLine() // Console.ReadLine() on konsooliaplikatsiooni API-is sisendit lugev funktsioon

reastus.Add(sisend):

Viimased kaks rida võtavad konsoolist sisendi, mis võiks täisarv olla, ja lisavad selle reastusesse.

Console.WriteLine(); // Console.WriteLine() on konsooliaplikatsiooni API-is väljundit kirjutav funktsioon

Sümbolite (characters) ja sõnede (strings) defineerimine ja deklareerimine ning nendega seonduvad tehted

string sõna1 = "karu";

char ja_märk = '+';

string sõna2 = "jänes";

string fraas = sõna1 + ' ' + ja_märk + ' ' + sõna2;

Console.WriteLine(fraas);

Viimase rea väljundiks "karu + jänes"

Meetodid (funktsioonid)

C#-is meetodid (mujal funktsioonid), on üldistatud kompaktsust tagavad koodilõigud, mis saavad võtta sisendiks parameetreid ja anda väljundiks uusi muutujaid. Neid defineeritakse järgmiselt:

static [andmetüüp] Meetod([andmetüüp1] parameeter1, [andmetüüp2] parameeter2)

{

// toimub mingi koodimine

[andmetüüp] väljastatav = ...;

return väljastatav;

}

Meetodil ei pea olema argumente ning void-tüüpi meetod ei väljasta mingit väärtust. Näide erinevatest meetoditest konsoolaplikatsioonis:

OOP: Skoop, hierarhia ja klasside/komponentide instantsid (instances of objects)

https://www.w3schools.com/cs/cs_oop.php

Unity esmaseks kasutamiseks pole otseselt vaja teada, kuidas luua konstruktoreid ja klasse. Küll aga oleks mõistlik saada üldine kokkupuude OOP-st (objektorienteeritud programmeerimisest) ning täpsemalt hierarhiast ja klassidest ning nende omadustest ja Unity C# API-st (application programming interface).

Mida Unity kasutuseks vaja teada? Näide Unity C# API GameObject põhjal ( boldis on read kopeeritud Unity C# skriptist):

GameObject mingiObjekt; 

See on põhiline stseenis oleva objekti külge kinnituv klass/konstruktor

Objektile kuuluvatele alamobjektidele viitamine käib punktiga (.), klass Transform on hierarhiliselt GameObjecti "all"/ GameObjecti kaudu kättesaadav.

Transform mingiObjektiTransform = mingiObjekt.transform; 

Nüüd on meil mingiObjekti Transform. Transformi "all" on muutujad Scale ja Position, mis on Vector3 klassi //suurused ning Rotation, mis on Quaternion klassist.

Lehelt https://docs.unity3d.com/ScriptReference/GameObject.html properties alt paistab, et "properties" (põhimõtteliselt mingi klassipunktiga ligipääsetavad alamobjektid) all on muutujad Tag ja Name (märksõna? ja nimi), mis on kättesaadavad järgnevalt (märksõna ja nimi on Unity Editoris muudetavad string-tüüpi muutujad):

string  märksõna = mingiObjekt.tag;

string nimi = mingiObjekt.name; 

Tulles tagasi transform.positioni juurde, oletame et tahame objekti x-koordinaati teada ja muuta. https://docs.unity3d.com/ScriptReference/Transform.html 

float koordinaatX = mingiObjektiTransform.position.x; //alternatiivselt float koordinaatX  = mingiObject.transform.position.x;

Selleks et x-koordinaati muuta, ei saa teha nii, et mingiObjektiTransform.position.x = uusKoordinaatX;, sest mingiObjektiTransform.position.x  väljastab koopia Vector3 Position x-väärtusest, mis ei ole modifitseeritav suurus. Modifitseeritav on aga suurus Vector3 ehk position ise, seega saab teha järgnevalt:

float uusKoordinaatX = 5f;

mingiObjekt.transform.position = new Vector3(uusKoordinaatX, mingiObjekt.transform.position.y, mingiObjekt.transform.position.z); // ainult x-koordinaat on erinev