Käsud

Just käskudega saab panna kilpkonna või KTurtle'i midagi tegema. Osa käske eeldab sisendit, osa annab väljundi. Selles osas kirjeldame kõiki KTurtle'i sisseehitatud käske. Lisaks saab oma käske luua käsuga learn. Käsitletavad sisseehitatud käsud on esile tõstetud tumesinise värviga.

Kilpkonna liigutamine

Kilpkonna saab lõuendil liigutada mitme käsuga.

forward (fw)
forward X

forward paneb kilpkonna otse edasi liikuma X piksli võrra. Kui pliiats on sees, jätab kilpkonna ka jälje maha. forward asemel võib kasutada lühendit fw.

backward (bw)
backward X

backward paneb kilpkonna otse tagasi liikuma X piksli võrra. Kui pliiats on sees, jätab kilpkonna ka jälje maha. backward asemel võib kasutada lühendit bw.

turnleft (tl)
turnleft X

turnleft paneb kilpkonna X kraadi võrra vasakule pöörama. turnleft asemel võib kasutada lühendit tl.

turnright (tr)
turnright X

turnright paneb kilpkonna X kraadi võrra paremale pöörama. turnright asemel võib kasutada lühendit tr.

direction (dir)
direction X

direction määrab kilpkonna suunaks X kraadi arvestades nullist, see ei ole seotud kilpkonna varasema suunaga. direction asemel võib kasutada lühendit dir.

getdirection
getdirection

getdirection tagastab kilpkonna suuna kraadidena arvestades nullist, kus null on suund, millega kilpkonn suundub üles.

center
center

center sunnib kilpkonna liikuma lõuendi keskpunkti.

go
go X,Y

go paneb kilpkonna liikuma lõuendi konkreetsesse punkti. See asub X piksli kaugusel lõuendi vasakust servast ja Y piksli kaugusel lõuendi ülaservast.

gox
gox X

gox paneb kilpkonna samal kõrgusel liikuma X piksli kaugusele lõuendi vasakust servast. gox asemel võib kasutada lühemat gx.

goy
goy Y

goy paneb kilpkonna samal laiusel (kaugusel vasakust servast) liikuma Y piksli kaugusele lõuendi ülaservast. goy asemel võib kasutada lühemat gy.

Märkus

Käskudega go, gox, goy ja center ei joonista kilpkonn joont, olgu pliiats üleval või all.

Kus on kilpkonn?

Kilpkonna asukohta lõuendil saab teada kahe käsuga.

getx

getx tagastab pikslite arvu lõuendi vasakust servast kilpkonna asukohani.

gety

gety tagastab pikslite arvu lõuendi ülemisest servast kilpkonna asukohani.

Kilpkonn pliiatsiga

Kilpkonnal on pliiats, millega ta liikudes joont veab. Pliiatsit saab juhtida mitme käsuga, mida siin tutvustamegi.

penup (pu)
penup

penup tõstab pliiatsi lõuendilt ja kuni see on üleval, ei tõmba kilpkonn liikudes ühtki joont. Vaata ka pendown. penup asemel võib kasutada lühendit pu.

pendown (pd)
pendown

pendown surub pliiatsi lõuendi vastu ja kuni see on all, tõmbab kilpkonn liikudes joone. Vaata ka penup. pendown asemel võib kasutada ka lühendit pd.

penwidth (pw)
penwidth X

penwidth määrab pliiatsi tõmmatava joone laiuseks X pikslit. penwidth asemel võib kasutada ka lühendit pw.

pencolor (pc)
pencolor R,G,B

pencolor määrab pliitsi tõmmatava joone värvi. pencolor tahab saada sisendina RGB värvikoodi. pencolor asemel võib kasutada ka lühendit pc.

Lõuendiga seotud käsud

Lõuendi omadusi saab muuta mitme käsuga.

canvassize (cs)
canvassize X,Y

Käsk canvassize määrab lõuendi suuruse. Käsu sisendiks on X ja Y, kus X on uue lõuendi laius pikslites ja Y uue lõuendi kõrgus samuti pikslites. canvassize asemel võib kasutada lühendit cs.

canvascolor (cc)
canvascolor R,G,B

Käsk canvascolor määrab lõuendi värvi. canvascolor tahab saada sisendina RGB värvikoodi. canvascolor asemel võib kasutada ka lühendit cc.

Puhastamiskäsud

Kahe käsuga saab lõuendi puhastada sellest, mida sa sinna oled valmis meisterdanud.

clear (ccl)
clear

Käsk clear puhastab lõuendilt kogu joonistatu. Muud asjad jäävad püsima: kilpkonna asukoht ja nurk, lõuendivärv, kilpkonna nähaolek ja lõuendi suurus.

reset
reset

Käsk reset puhastab palju rohkem asju kui clear. Pärast käsku reset on kõik taas selline, nagu KTurtle'i käivitamisel: kilpkonn on lõuendi keskel, lõuendi värv on valge, kilpkonn hakkab liikudes vedama musta joont ja lõuendi suurus on 400 x 400 pikslit.

Kilpkonn on sprait

Vaevalt et paljud teavad, mis õieti on sprait, nii et ütleme siis saladuse välja: sprait on väike pilt, mida saab ekraanil liigutada. Täpsemalt vaata sõnastikust mõiste sprait kirjeldust. See tähendab, et meie kilpkonn on sprait!

Toome siin ära kõik käsud, mida saab spraidi puhul kasutada.

[KTurtle'i praegune versioon toetab spraidina ainult kilpkonna kasutamist. Aga tulevikus võib olla vägagi võimalik, et võid kilpkonna oma soovi kohaselt millegi muuga asendada.]

spriteshow (ss)
spriteshow

Käsk spriteshow muudab kilpkonna uuesti nähtavaks pärast tema peitmist. spriteshow asemel võib kasutada ka lühendit ss.

spritehide (sh)
spritehide

spritehide peidab kilpkonna. Seda on mõtet kasutada siis, kui kilpkonn kohe kuidagi ei taha sinu joonistusele sobida. spritehide asemel võib kasutada ka lühendit sh.

Kas kilpkonn oskab ka kirjutada?

Õige vastus: jah, muidugi. Kilpkonn võib kirjutada küll, aga mõistagi pead sina talle ütlema, mida kirjutada.

print
print X

print annab kilpkonnale käsu midagi lõuendile kirjutada. print sisendiks võivad olla nii numbrid kui stringid. Sümbolit + kasutades saab käsuga print lasta kirjutada mitmesuguseid numbreid ja stringe. Toome siin väikese näite:

$year = 2003
$author = "Cies"
print $author + " alustas KTurtle'i projekti aastal " + $year + "  ja ta töötab endiselt rõõmuga selle kallal!"

fontsize
fontsize X

fontsize määrab fondi suuruse, mida print kirjutamisel kasutab. fontsize sisend peab olema number. Suurus määratakse pikslites.

Matemaatilised käsud

Järgmised käsud on KTurtle'i keerukamad matemaatilised käsud.

round
round(x)

round ümardab antud arvu lähima täisarvuni.

print round(10.8)
forward 20
print round(10.3)

Selle koodiga kirjutab kilpkonn arvud 11 ja 10.

random (rnd)
random X,Y

random on käsk, mis tahab saada sisendit ja annab kohe ka väljundi. Sisendiks on kaks arvu, milles üks (X) määrab minimaalse ja teine (Y) maksimaalse väljundi. Väljund on juhuslik arv, mis on miinimumiga võrdne või suurem ning maksimumiga võrdne või väiksem. Üks väike näide:

repeat 500 {
  $x = random 1,20
  forward $x
  turnleft 10 - $x
}

Käsuga random saab oma programmi veidi kaootilisemaks muuta.

mod
mod X,Y

Käsk mod tagastab esimese arvu jagamisel teisega tekkiva jäägi.

sqrt
sqrt X

Käsk sqrt peab leidma arvu X ruutjuure.

pi
pi

See käsk tagastab konstandi pii 3,14159.

sin, cos, tan

sin X
cos X
tan X

Need kolm käsku esindavad maailmakuulsaid trigonomeetrilisi funktsioone sin, cos ja tan. Nende käskude sisendargument X on arv.

arcsin, arccos, arctan

arcsin X
arccos X
arctan X

Need käsud on funktsioonide sin, cos and tan pöördväärtused. Nende käskude sisendargument X on arv.

Sisend ja tagasiside dialoogide kaudu

Dialoog on väike hüpikaken, mis annab teatud tagasisidet või soovib saada mingit sisendit. KTurtle kasutab dialoogidele kaht käsku: message ja ask.

message
message X

Käsk message vajab sisendina stringi. See näitab hüpikdialoogi, mis sisaldab stringi teksti.

message  "Cies alustas KTurtle'iga aastal 2003  ja ta töötab endiselt rõõmuga selle kallal!"

ask
ask X

Käsk ask vajab sisendina stringi. See näitab hüpikdialoogi, mis sisaldab stringi nagu ka message. Kuid lisaks sellele on dialoogis ka sisendiväli. Selle abil saab kasutaja sisestada arvu või stringi, mis on võimalik salvestada muutujasse või edastada argumendina käsule. Näide:

$in = ask "Kui vana sa oled?"
$out = 2003 - $in
print "Aastal 2003 olid sa " + $out + " aastat vana."

Kui kasutaja sulgeb sisenddialoogi või ei sisesta midagi, on muutuja tühi.