Toll forrásának megtekintése

[[Fájl:Pen Project 6.png|thumbnail|Példa a Toll használatával elkészített rajzra]]
A '''toll''' a [[Scratch]] egy olyan funkciója, amely lehetővé teszi a [[Szereplő|szereplők]] számára formák, színes pixelek<!--????? Ez biztos értelmes megfogalmazás, hogy "színes pixelek rajzolása"? Az mit takar pontosan?--> és egyebek rajzolását a képernyőre a [[Toll bővítmény|toll blokkokkal]]. Először a [[Scratch 1.0]] verziójában jelent meg. A toll a [https://hu.wikipedia.org/wiki/Logo_(programoz%C3%A1si_nyelv) Logo] teknős grafikájához vezethető vissza a [[Mozgás blokkok|mozgás blokkokhoz]] hasonlóan, amelyekkel együtt használható a toll.

A vonal, a pont, a téglalap és a kör a legegyszerűbben lerajzolható alakzatok, de elegendő programozással bármilyen forma létrehozható.

==Működése==

A teknőcgrafika olyan grafikai modell, melyben mindent egy mozgó objektummal rajzoltatunk meg, amely vagy húz maga után vonalat, vagy nem. (Lehetne grafikai elemeket úgy is a képernyőre rajzoltatni, hogy csak megnevezzük a grafikai elem nevét, s elhelyezzük a képernyőn valahol. Esetleg valamilyen paramétereket is megadunk, amellyel az elem egyes tulajdonságait szabhatjuk meg, pl. a színét.) A teknős grafika esetében azonban mozgó rajzolónk van. A Logo nyelvekben, vagy például a {{wp|Python_(programozási_nyelv)#Példa_a_teknőcgrafikához|Python Turtle könyvtára}} ez a rajzoló objektum egy teknős, a Scratchben meg bármely [[szereplő]] működhet ekként a Toll kiegészítő használata segítségével.

Fontos, hogy ez a mozgó objektum kis lépésekre felbontott parancsokkal irányítható. Például, hogy tegye le a tollat, azaz a parancstól kezdve húzzon csíkot maga után, vagy haladjon előre valamennyi lépést, forduljon valamennyit stb. A szereplő mozgatását a Scratchben a [[Mozgás blokkok|mozgás blokkok]] segítségével lehet elérni, a "nála levő tollat" pedig a Toll kiegészítő blokkjaival lehet működtetni.

==Toll blokkok==
*[[Töröld a rajzokat (blokk)|<sb>töröld a rajzokat</sb>]] {{-}} törli az összes tollnyomot a képernyőről
*[[Készíts lenyomatot (blokk)|<sb>készíts lenyomatot</sb>]] {{-}} rajzol a szereplőről egy másolatot a [[Színpad|színpadra]]
*[[Tollat tedd le (blokk)|<sb>tollat tedd le</sb>]] {{-}} működteti az adott szereplő toll funkcióját, vagyis a szereplő tollnyomot fog hagyni a képernyőn bárhova mozdul el, amíg a toll deaktiválódik
*[[Tollat emeld fel (blokk)|<sb>tollat emeld fel</sb>]] {{-}} kikapcsolja a toll funkciót, így a szereplő már nem fog tovább írni a tollal, amikor mozog
*[[Toll színe legyen () (színbemenetes blokk)|<sb>toll színe legyen (#ffffff)</sb>]] {{-}} a toll színét egy meghatározott értékre állítja
*[[Toll (tulajdonsága) változzon () (blokk)|<sb>toll ( v) változzon ()</sb>]] {{-}} a toll egyik tulajdonságát egy adott értékkel változtatja meg
*[[Toll (tulajdonsága) legyen () (blokk)|<sb>toll ( v) legyen ()</sb>]] {{-}} a toll egyik tulajdonságát egy adott értékre állítja
*[[Toll mérete változzon () (blokk)|<sb>toll mérete változzon ()</sb>]] {{-}} a toll méretét a kiválasztott értékkel módosítja
*[[Toll mérete legyen () (blokk)|<sb>toll mérete legyen ()</sb>]] {{-}} a toll méretét a beírt értékre állítja

==Használata==
A toll blokkokat gyakran használják:
{{Jegyzet|Példa projekteket találhatsz az egyes felhasználási kategóriák mögött lábjegyzetben<ref group="megj.">A listába került projektek készítői semmilyen anyagi javakat nem juttattak a wiki szerkesztői részére annak érdekében, hogy projektjeik kiválasztásra kerüljenek. A választás csupán az első alkalmas projektekre esett. Ennek megfelelően kibővíthető. Ha javasolnál is még példát mutató projektet, még ha nem vagy szerkesztő, akkor is írhatsz [[Szerkesztő:Simiagain]], vagy más szerkesztő profiljára a Scratchen.</ref>}}

* '''kígyós játék'''ok ({{l|en}}: {{Idéz|snake game}}) készítésekor <ref group="példák">{{Projekt|169375686|Kígyós játék}} ({{l|en}}), {{Projekt|108566337|Slither.io}} ({{l|en}})</ref>
* '''nyomvonal'''at hagyó szereplőknél <ref group="példák">{{Projekt|608|Bogárka tányéron}} ({{l|hu}})</ref>
* '''animációk''' készítésére (például [[Intrók]]/[[Outro]]-k esetében) <ref group="példák">{{Projekt|88746385|Óra animáció}}, {{Projekt|79597842|Varázslat}} ({{l|en}}, {{Projekt|479857713|1. intró}} ({{l|en}}), {{Projekt|507206948|2. intró}} ({{l|en}}), {{Projekt|648145620|1. outro}} ({{l|en}}), {{Projekt|611164594|2. outro}} ({{l|en}}), {{Projekt|522440153|3. outro}} ({{l|en}})</ref>
* tárgyak, '''objektumok rajzolására''' egyszereplős projektekben<ref group="példák">{{Projekt|525277044}} ({{l|en}}), {{Projekt|602571199}} ({{l|en}}), {{Projekt|714283726}}</ref>
* '''minták''', '''[[fraktál]]ok''' rajzolására <ref group="példák">{{Projekt|89132897|Mintakészítő}} ({{l|en}}), {{Projekt|100488827|Menő minták}}, {{Projekt|87202492|Koch fraktál}} ({{l|hu}}), {{Projekt|3229598|Sierpenski háromszög}} ({{l|en}})</ref>
* '''grafikonok''' létrehozására<ref group="példák>{{Projekt|89042838}} ({{l|en}}, {{Projekt|429901948}} ({{l|en}}), {{Projekt|764634827}} ({{l|en}})</ref>
* '''grafikai szerkesztőprogramok'''nál (pl. rajzoló<ref group="példák">{{Projekt|112563206|Egyszerű rajzoló program}} ({{l|hu}})</ref>, képszerkesztő<ref group="példák">{{Projekt|552647396|Fejlettebb képszerkesztő}}</ref>, animáció-szerkesztő<ref group="példák">{{Projekt|944051842|Pixel animátor}}</ref> programok)
* {{ún}} '''''platformer''''' típusú játékokban a platform megalkotására<ref group="példák">{{Projekt|146120846}}, {{Projekt|252744806}}</ref>
* '''3D-s projektek'''ben (leginkább játékokat kel érteni ezalatt) a nagyon sokféle és gyorsan változó látvány megrajzolására <ref group="példák">{{Projekt|861541218|''A torony'' játék}} ({{l|en}}), {{Projekt|74221074|Repülő szimulátor}} ({{l|en}}), {{Projekt|463553665|Kristálykereső RPG}} ({{l|en}}), {{Projekt|216369673|Minigolf}} ({{l|en}}, {{Projekt|17209672|Labirintus}} ({{l|en}}), {{Projekt||Minecraft}} ({{l|en}}), {{Projekt|670754400|Tornyos védekező játék, {{ún}} Tower defence}} ({{l|en}}), {{Projekt|220855459|Kockás ügyességi játék}} ({{l|en}}), {{Projekt|954212874|Platformer}} ({{l|en}}, {{Projekt|600000129|Domborzat-generáló}} ({{l|en}}), {{Projekt|59886728|Bolygó készítő}} ({{l|en}}), {{Projekt|212867722|Rubik kocka}}</ref>
* '''szövegkiírás'''ra ({{l|en}}: {{Idéz|text rendering}})<ref group="példák">{{Projekt|406678232|Tollat használó szövegkiíró-motor}}</ref>
* vagy '''logikai játék'''ok elkészítésére <ref group="példák">{{Projekt|119960353}}, {{Projekt|847205776}}, {{Projekt|145930269}}</ref>

===Példák a használatra===

<references group="példák"/>

==Átlátszó toll==
A [[Toll átlátszóság]]a alapvetőleg a [[Toll (tulajdonsága) legyen () (blokk)|<sb>toll (átlátszósága v) legyen ()</sb>]] és a [[Toll (tulajdonsága) változzon () (blokk)|<sb>toll (átlátszósága v) változzon ()</sb>]] blokkokkal változtatható. Azonban be lehet állítani az átlátszóság értékét a [[Toll színe legyen () (színbemenetes blokk)|<sb>toll színe legyen [#0000FF]</sb>]] blokkal is az alábbiakban leírt módon.

===Képlet===
Az ARGB-s színmeghatározás hasonló az RGB-shez, csak ki van bővítve egy további értékkel, ami az átlátszóság, vagy jobban mondva az átlátszatlanság megadásáért felel. (Átlátszatlanság, ugyanis a maximum értéknél egyáltalán nem átlátszó, s 0-nál meg teljesen.) Az átlátszóságot megadó értéket ''alfa értéknek'' nevezzük, melyet A-val rövidítünk, s ezért kerül az RGB betűk elé egy A is az átlátszatlanságot is használó színképletbe. Ahol az R amúgy a piros értéknek felel meg, a G a zöldnek, s a B a kéknek. Ezek a jelölések színek angol neveiből erednek (''red'', ''green'' és ''blue''). Az összetett színt úgy határozzuk meg, mint ennek a három színnek a kevertjeként. Hogy milyen erősen vannak meg az összetett színben a piros, zöld és kék, azt az értékeik mutatják meg. Általában az RGB-s és az ARGB-s színkeverés értékei 1-től 255-ig terjednek (ugyanis így az értékeiket 16-os számrendszerben még 2 számjeggyel pont le lehet írni). Ez az alfa értékre is igaz.

A színmeghatározást RGB értékek esetében a következőképpen teheted meg a Scratchben:
<scratchblocks>
toll színe legyen ((((R) * (65536)) + ((G) * (256))) + (B)) // Fontos, hogy a színbemenetes blokkot használd

toll színe legyen [#0000FF] // Ez a színbemenetes blokk
</scratchblocks>

ARGB esetében pedig:

<scratchblocks>
toll színe legyen ((((A) * (16777216)) + ((R) * (65536))) + (((G) * (256)) + (B)))
</scratchblocks>

{{Figyelem|Győződj meg róla, hogy az A, R, G és B értékek egész számok, így nem a más színértékeket befolyásolják. Ha bármelyikük lehet törtszám is, akkor a lenti kerekítéses kódot használd (legbiztosabb, ha mindig kerekítesz persze)}}

ARGB esetén kerekítést használva:

<scratchblocks>
toll színe legyen (((((A) kerekítve) * (16777216)) + (((R) kerekítve) * (65536))) + ((((G) kerekítve) * (256)) + ((B) kerekítve)))
</scratchblocks>

==A {{"|1}}Futtatás képernyőfrissítés nélkül{{"|2}}-t használó saját blokkok előnyei==
{{Fő|Képkockafestő szkript}}

A {{"|1}}Futtatás képernyőfrissítés nélkül{{"|2}}, az egy működési formája a saját blokkoknak, ami megtakarít munkafolyamatokat azáltal, hogy a képernyőt csak a (saját blokk alatt meghatározott) művelet befejeztével frissíti. Ennek a működésnek az eléréséhez csak a saját blokk készítésénél, vagy szerkesztésénél található jelölőnégyzetet kell bepipálni, amelynek szövege pont így hangzik: {{Idéz|futtatás képernyőfrissítés nélkül}}. 

A Scratch normális működése mellett egy hosszú rajzolási folyamatot nagyon lassan tud csak lefuttatni, de elképzelhető, hogy a rajzolni kívánt mintának csak a végeredményére van szükségünk, s a maga a rajzolási folyamatot nem szeretnénk megjeleníteni (mint például 3D projektek esetében, amikor az aktuális látványt szeretnénk kirajzolni lehetőleg minél gyorsabban, hogy időben minél több legyen a frissítése a látványnak, vagyis nagy legyen az {{wp|FPS}} szám). Ekkor nagyon sokat segít nekünk a képernyőfrissítés-mentes futtatása a rajzolásnak.

Tekintsük például a két következő saját blokkot, amely a színpad minden pixelét kifesti valamilyen színűre. Az első esetben egy listában vannak eltárolva a képpontok színei.

<scratchblocks>
színpadfestés meghatározása
[hely v] legyen (0) //  A változónk a képpont sorszámának nyomonkövetésére a listában
toll mérete legyen (2) //  A toll mérete 2 legyen (noha képpontokként fogunk haladni), hogy egy Flash Player hibát kikerüljünk
ugorj ide: x: (-240) y: (180) // A képernyő bal felső sarka
ismételd (360) 
  ismételd (480) 
    [hely v] változzon (1) // Növelődjön a változó, hisz új képponthoz értünk
    toll (színe v) legyen ([képpontok lista v] (hely) eleme) //  A toll színe az aktuális képpont színe kell legyen (listában meghatározva)
    tollat tedd le //  Lenyomat
    tollat emeld fel
    x változzon (1) //  Következő képpont
  end //  x iránybeli ismétlés
  y változzon (-1) //  Újabb sor
  x legyen (-240) //  Vissza a képernyő bal oldalára
end //  y iránybeli ismétlés
</scratchblocks>

A következő esetben egy változóban (<sb>(változó)</sb> névvel) vannak felsorolva pontosan 3 számjeggyel a képpontok színei (ha az első képpont színe például 1, akkor 001-el fog kezdődni a változónk).

<scratchblocks>
draw meghatározása
[hely v] legyen (0) //  Ez lesz a változónk, hogy nyomonkövessük a változóban az aktuális képpont színadatának helyét
toll mérete legyen (2) //  A toll mérete 2 legyen (noha képpontokként fogunk haladni), hogy egy Flash Player hibát kikerüljünk
ugorj ide: x: (-240) y: (180) //  A kezdeti pozíciónk most is bal fent
ismételd (360) 
  ismételd (480) 
    [hely v] változzon (3) //  Egy adatnak a hosszával (3 karakter) változtassuk a helyet megadó változónkat
    [ideiglenes v] legyen [] //  Egy ideiglenes változót használunk a színadat kinyeréséhez
    [ideiglenes v] legyen ((változó) ((hely) - (2)) betűje) //  Első számjegy
    [ideiglenes v] legyen ((ideiglenes) ((változó) ((hely) - (1)) betűje) együtt) //  Első és második számjegy
    [ideiglenes v] legyen ((ideiglenes) ((változó) (hely) betűje) együtt) //  Mindhárom számjegy együtt
    toll (színe v) legyen (ideiglenes) //  A kinyert adatra állítjuk a toll színét
    tollat tedd le  //  Lenyomat
    tollat emeld fel
    x változzon (1) //  Következő képpont
  end //  x irányú ismétlés
  y változzon (-1) //  Eggyel alatti sorba
  x legyen (-240) //  Vissza a sor elejére
end //  y irányú ismétlés
</scratchblocks>

Bármelyik esetet is használjuk, összesen 172 800 képpontunk van (!), s ezeknek mindegyikének a színét el kell tároljuk vagy a listában vagy a változóban (ekkor  518 400 számjegy hosszú lesz a változónk!). Ez még megoldható, viszont kivárni, hogy képernyőfrissítéssel végigfesse az egész színpadot elég hosszas lenne. Ezért használjuk ilyenkor mindenképpen a frisstés nélküli futtatás funkcióját. Kisebb felbontás is persze használható, s olyankor gyorsabban végez a festés és kevesebb adatot is kell eltárolnunk (például ha tényleg 2 képpontokként fessük le a színpadot, az már lefelezi mindkét értéket).

==Lásd még==
* [[Képkockafestő Szkript]]
* [[Toll kiegészítő]]

==Külső linkek==
{{KülsőProgram|szekció}}
* {{l|en}}: [https://people.eecs.berkeley.edu/~bh/v1ch10/turtle.html ''Computer Science Logo Style'', kötet 1, "Turtle Geometry" ('Teknőc geometria')]

==Megjegyzések==
<references group="megj." />

[[Kategória:Scratch Program]]
[[en:Pen]]
[[ja:ペン]]