Tekst źródłowy strony Wprowadzenie 3 - Słowniczek podstawowych bloków

<p align="center">[[Plik:Logo_Mistrzowie.png]]</p>
<b><p align="center">Materiały stworzone przez Ośrodek Edukacji Informatycznej i Zastosowań Komputerów w Warszawie w ramach Programu „Mistrzowie Kodowania” finansowanego przez Samsung Electronics Polska,
objęte licencją CC-BY-SA „Uznanie autorstwa – Na tych samych warunkach 3.0 Polska”</p></b><br/>
<br/>
==Słowniczek podstawowych bloków programu Scratch 2.0==
Scratch to skryptowy, wizualny język programowania. Budujemy w nim skrypty układając je
z bloków reprezentujących polecenia, instrukcje sterujące, wyrażenia itd. Zestaw bloków
w wersji 2.0 podzielony jest na 10 kategorii (w wersji 1.4 było 8 kategorii), bloki każdej z nich
oznaczone są innym kolorem. Niniejszy słowniczek nie stanowi opisu wszystkich bloków,
jedynie najważniejszych oraz wykorzystywanych w scenariuszach zajęć przeznaczonych dla
uczniów klas IV-VI szkół podstawowych opracowanych w ramach projektu „Mistrzowie
kodowania”. W wersji 2.0 wprowadzono bardzo ważną kategorię '''Więcej bloków'''
umożliwiającą definiowanie własnych bloków. Nie została ona tutaj opisana, ponieważ
pierwszych osiem scenariuszy nie przewiduje tworzenia własnych bloków. Będzie opisana
przy następnych scenariuszach.<br/>
Każdy duszek, a także scena, może posiadać własne skrypty. Zestaw bloczków, z których
można budować skrypty dla sceny jest nieco inny niż dla duszków, np. kategoria '''Ruch''' jest dla
sceny pusta, ponieważ sceny nie można przesuwać ani obracać. Najpierw zostaną omówione
poszczególne kategorie bloczków dla duszków, a następnie podane podstawowe informacje
o bloczkach dostępnych dla sceny. <br/>
<br/>
===Ruch===
<p align="left">[[Plik:instr3_plik1.JPG]]</p>

W kategorii '''Ruch''' zgromadzone są bloczki związane z ruchem duszków, a więc ich
przesuwaniem, obracaniem oraz odczytywaniem aktualnych danych związanych z położeniem
duszka. Są to podstawowe bloczki bardzo często używane. Poniżej znajduje się opis
wszystkich bloczków tej kategorii.<br/>
<ol>

<li><p align="left">[[Plik:ruch1_1.JPG]]</p>Przesuwa duszka o określoną odległość zgodnie z aktualnym kierunkiem oraz aktualnymi
ustawieniami pisaka (przyłożony/podniesiony, kolor, grubość). Domyślną wartość możemy
edytować. Jeśli chcemy przesunąć duszka do tyłu należy podać wartość ujemną.
</li>

<p align="left">[[Plik:ruch1_2.JPG]]</p>
----<br/>

<li> <p align="left">[[Plik:ruch2_1.JPG]]</p>
Obraca duszka w prawo (zgodnie z ruchem wskazówek zegara) o określoną liczbę stopni.
Domyślną wartość możemy edytować.</li>

<p align="left">[[Plik:ruch2_2.JPG]]</p>
----<br/>

<li><p align="left">[[Plik:ruch3_1.JPG]]</p>
Obraca duszka w lewo (przeciwnie do ruchu wskazówek zegara) o określoną liczbę stopni.
Domyślną wartość możemy edytować. Jest równoważne obrotowi w prawo z ujemną
wartością.</li>

<p align="left">[[Plik:ruch3_2.JPG]]</p>
----<br/>

<li><p align="left">[[Plik:ruch4_1.JPG]]</p>
Ustawia duszka na określony kierunek. Można z listy wybrać jeden z czterech kierunków (90
stopni – prawo, -90 stopni – lewo, 0 stopni – do góry, 180 stopni – dół) lub wpisać ręcznie
określony kąt wyrażony w stopniach. </li>

<p align="left">[[Plik:ruch4_2.JPG]]</p>
----<br/>

<li><p align="left">[[Plik:ruch5_1.JPG]]</p>
Ustawia duszka w kierunku na kursor myszy lub innego duszka. Obiekt (określonego duszka
lub kursor myszy) wybieramy z listy rozwijalnej. </li>

<p align="left">[[Plik:ruch5_2.JPG]]</p>
----<br/>

<li><p align="left">[[Plik:ruch6_1.JPG]]</p>
Przesuwa duszka do punktu o określonych współrzędnych (x,y) zgodnie z aktualnymi
ustawieniami pisaka (przyłożony/podniesiony, kolor, grubość).</li>

<p align="left">[[Plik:ruch6_2.JPG]]</p>
----<br/>

<li><p align="left">[[Plik:ruch7_1.JPG]]</p>
Przesuwa duszka do pozycji kursora myszy lub innego duszka zgodnie z aktualnymi
ustawieniami pisaka (przyłożony/podniesiony, kolor, grubość). Obiekt (określonego duszka
lub kursor myszy) wybieramy z listy rozwijalnej.</li>

<p align="left">[[Plik:ruch7_2.JPG]]</p>
----<br/>

<li><p align="left">[[Plik:ruch8_1.JPG]]</p>
Analogiczne do polecenia idź do x y, ale wykonywane przez określony czas.</li>

<p align="left">[[Plik:ruch8_2.JPG]]</p>
----<br/>

<li><p align="left">[[Plik:ruch9_1.JPG]]</p>
Zmienia współrzędną x-ową duszka o określoną wartość zgodnie z aktualnymi ustawieniami
pisaka (przyłożony/podniesiony, kolor, grubość). Domyślną wartość możemy edytować.</li>

<p align="left">[[Plik:ruch9_2.JPG]]</p>
----<br/>

<li><p align="left">[[Plik:ruch10_1.JPG]]</p>
Przesuwa duszka do punktu o określonej współrzędnej x-owej (y-owa współrzędna pozostaje
bez zmiany) zgodnie z aktualnymi ustawieniami pisaka (przyłożony/podniesiony, kolor,
grubość). Domyślną wartość możemy edytować.</li>

<p align="left">[[Plik:ruch10_2.JPG]]</p>
----<br/>

<li><p align="left">[[Plik:ruch11_1.JPG]]</p>
Zmienia współrzędną y-ową duszka o określoną wartość zgodnie z aktualnymi ustawieniami
pisaka (przyłożony/podniesiony, kolor, grubość). Domyślną wartość możemy edytować.</li>

<p align="left">[[Plik:ruch11_2.JPG]]</p>
----<br/>

<li><p align="left">[[Plik:ruch12_1.JPG]]</p>
Przesuwa duszka do punktu o określonej współrzędnej y-owej (x-owa współrzędna pozostaje
bez zmiany) zgodnie z aktualnymi ustawieniami pisaka (przyłożony/podniesiony, kolor,
grubość). Domyślną wartość możemy edytować.</li>

<p align="left">[[Plik:ruch12_2.JPG]]</p>
----<br/>

<li><p align="left">[[Plik:ruch13_1.JPG]]</p>
Zmienia kierunek na przeciwny, jeśli duszek dotyka krawędzi sceny</li>

<p align="left">[[Plik:ruch13_2.JPG]]</p>
----<br/>

<li><p align="left">[[Plik:ruch14_1.JPG]]</p>
Określa sposób zachowania duszka w zależności od kierunku. Z listy rozwijalnej mamy do
wyboru trzy opcje:
<ul>
<li> dookoła – duszek patrzy zgodnie ze swoim kierunkiem,</li>
<li> lewo-prawo – duszek patrzy tylko w lewą lub prawą stronę,</li>
<li> nie obracaj – duszek nie reaguje na zmianę kierunku.</li></ul>
Niezależnie od sposobu wskazywania kierunku duszek porusza się zgodnie ze swoim kierunkiem. Sposób wskazywania kierunku można także określić edycyjnie.</li>

<p align="left">[[Plik:ruch14_2.JPG]]</p>
----<br/>

<li><p align="left">[[Plik:ruch15_1.JPG]]</p>
Aktualna wartość współrzędnej x-owej pozycji duszka – jego środka. Środek można ustawić
edytując kostium duszka. Zwracaną wartość można wykorzystać jako argument
w wyrażeniach. Włączenie znacznika po lewej stronie powoduje wyświetlanie aktualnej
współrzędnej na scenie. Przyjmuje wartości od -240 do 240.</li>

<p align="left">[[Plik:ruch15_2.JPG]]</p>
----<br/>

<li><p align="left">[[Plik:ruch16_1.JPG]]</p>
Aktualna wartość współrzędnej y-owej pozycji duszka – jego środka. Środek można ustawić
edytując kostium duszka. Zwracaną wartość można wykorzystać jako argument
w wyrażeniach. Włączenie znacznika po lewej stronie powoduje wyświetlanie aktualnej
współrzędnej na scenie. Przyjmuje wartości od -180 do 180.</li>

<p align="left">[[Plik:ruch16_2.JPG]]</p>
----<br/>

<li><p align="left">[[Plik:ruch17_1.JPG]]</p>
Aktualna wartość kierunku duszka. Można ją wykorzystać jako argument w wyrażeniach.
Włączenie znacznika po lewej stronie powoduje wyświetlanie aktualnego kierunku na scenie.
Przyjmuje wartości od -180 do 180 stopni.</li></ol>

<p align="left">[[Plik:ruch17_2.JPG]]</p>
----<br/>

===Wygląd===

<p align="left">[[Plik:instr3_plik2.JPG]]</p>
W kategorii '''Wygląd''' zgromadzone są bloczki związane z wyglądem duszków, a więc
kostiumem, wielkością, widocznością, itp.. Niektóre z tych bloczków są bardzo często
używane. Poniżej znajduje się opis większości bloczków tej kategorii.<br/>
<ol>
<li> [[Plik:wyglad1_1.JPG]] Przez określony czas wyświetla w dymku tekst podany w polu edycyjnym. Oznacza to
wstrzymanie działania skryptu na podaną liczbę sekund. Do pola edycyjnego można także
przeciągnąć zmienną lub zbudować w tym miejscu wyrażenie, często do połączenia
wyświetlanych informacji wykorzystujemy bloczek połącz. <br/>
[[Plik:wyglad1_2.JPG]] </li>

----

<li> [[Plik:wyglad2_1.JPG]] Wyświetla w dymku tekst podany w polu edycyjnym i nie wstrzymuje działania skryptu.
Wykonywane są w związku z tym kolejne instrukcje, co może powodować szybkie zniknięcie
dymku. Do pola edycyjnego można także przeciągnąć zmienną lub zbudować w tym miejscu
wyrażenie, często do połączenia wyświetlanych informacji wykorzystujemy bloczek połącz.<br/>
[[Plik:wyglad2_2.JPG]] </li>

----

<li> [[Plik:wyglad3_1.JPG]] Przez określony czas wyświetla w dymku tekst podany w polu edycyjnym. Oznacza to
wstrzymanie działania skryptu na podaną liczbę sekund. Działa analogicznie jak polecenie
powiedz, inny jest tylko rodzaj wyświetlanej informacji. Do pola edycyjnego można także
przeciągnąć zmienną lub zbudować w tym miejscu wyrażenie, często do połączenia
wyświetlanych informacji wykorzystujemy bloczek połącz.<br/>
[[Plik:wyglad3_2.JPG]]</li>

----

<li> [[Plik:wyglad4_1.JPG]] Wyświetla w dymku tekst podany w polu edycyjnym i nie wstrzymuje działania skryptu.
Wykonywane są w związku z tym kolejne instrukcje, co może powodować szybkie zniknięcie
wyświetlanej informacji. Działa analogicznie jak polecenie powiedz, inny jest tylko rodzaj
dymku. Do pola edycyjnego można także przeciągnąć zmienną lub zbudować w tym miejscu
wyrażenie, często do połączenia wyświetlanych informacji wykorzystujemy bloczek połącz.<br/>
[[Plik:wyglad4_2.JPG]]</li>

----

<li> [[Plik:wyglad5.JPG]] Powoduje wyświetlenie obrazu duszka (aktualnego kostiumu), jeśli duszek jest ukryty. Jeśli
duszek jest widoczny nie powoduje żadnego efektu.</li>

----

<li> [[Plik:wyglad6.JPG]] Powoduje ukrycie obrazu duszka, jeśli duszek jest widoczny. Jeśli duszek jest niewidoczny nie
powoduje żadnego efektu.</li>

----

<li> [[Plik:wyglad7_1.JPG]] Powoduje zmianę kostiumu duszka na określony, wybrany z listy rozwijalnej. Domyślny
duszek (kotek) ma dwa kostiumy.<br/>
[[Plik:wyglad7_2.JPG]]</li>

----

<li> [[Plik:wyglad8_1.JPG]] Powoduje zmianę kostiumu duszka na następny. Następnym kostiumem po ostatnim jest
ponownie pierwszy. Klocek ten jest często wykorzystywany do animacji postaci duszka.<br/>
[[Plik:wyglad8_2.JPG]]</li>

----

<li> [[Plik:wyglad9_1.JPG]] Scena może się składać z wielu scen (domyślnie jest tylko jedno, białe tło). Przy pomocy tego
klocka duszek może zmienić tło na wybrane z listy rozwijalnej (o konkretnej nazwie, następne
tło, poprzednie tło). Uwaga: klocek niedostępny dla skryptów duszków w wersji 1.4
(dostępny jedynie dla skryptów sceny).</li>

----

<li> [[Plik:wyglad10_1.JPG]] Powoduje zmianę wielkości duszka (wszystkich kostiumów) o określoną wartość. Jeśli
chcemy pomniejszyć wielkość duszka należy podać ujemny argument.<br/>
[[Plik:wyglad10_2.JPG]]</li>

----

<li> [[Plik:wyglad11_1.JPG]] Powoduje zmianę wielkości duszka (wszystkich kostiumów) na określoną wielkość wyrażoną
w procentach. Jeśli chcemy przywrócić oryginalną wielkość należy ustawić rozmiar na 100%.<br/>
[[Plik:wyglad11_2.JPG]] </li>

----

<li>[[Plik:wyglad12_1.JPG]] Jeśli duszek jest przykryty przez inne duszki, zostanie wyświetlony na wierzchu.<br/>
[[Plik:wyglad12_2.JPG]]</li>

----

<li> [[Plik:wyglad13_1.JPG]] Aktualny numer kostiumu duszka. Można go wykorzystać jako argument w wyrażeniach.
Włączenie znacznika po lewej stronie powoduje wyświetlanie aktualnego numeru na scenie. <br/>
[[Plik:wyglad13_2.JPG]]</li>

----

<li>[[Plik:wyglad14_1.JPG]] Nazwa aktualnie wyświetlanego tła. Można ją wykorzystać jako argument w wyrażeniach.
Włączenie znacznika po lewej stronie powoduje wyświetlanie nazwy tła na scenie. <br/>
[[Plik:wyglad14_2.JPG]]</li>

----

<li> [[Plik:wyglad15_1.JPG]] Aktualny rozmiar duszka wyrażony w procentach. Można go wykorzystać jako argument w
wyrażeniach. Włączenie znacznika po lewej stronie powoduje wyświetlanie rozmiaru na
scenie. <br/>
[[Plik:wyglad15_2.JPG]]</li></ol>

===Dżwięk===
<p align="left">[[Plik:instr3_plik3.JPG]]</p>
W kategorii '''Dźwięk''' zgromadzone są bloczki związane z dźwiękami, instrumentami i nutami.
Poniżej znajduje się opis jedynie bloczków związanych z odtwarzaniem plików dźwiękowych.
Z duszkiem mogą być związane różne dźwięki (przypisane im pliki dźwiękowe), domyślne
duszek kot ma przypisany jeden dźwięk – miauczenie. Zmian dźwięków przypisanych
duszkowi (usunięcie/dodanie pliku dźwiękowego, nagranie własnego dźwięku) dokonujemy
w zakładce '''Dźwięki'''. <br/>
<ol>
<li><p align="left">[[Plik:dzwiek1_1.JPG]]</p>
Powoduje odtworzenie pliku dźwiękowego wybranego z listy rozwijalnej. Kolejne instrukcje skryptu są wykonywane niezależnie od odtwarzanego dźwięku.</li>

<p align="left">[[Plik:dzwiek1_2.JPG]]</p>
---- <br/>

<li> <p align="left">[[Plik:dzwiek2_1.JPG]]</p>
Powoduje odtwarzanie pliku dźwiękowego wybranego z listy rozwijalnej oraz wstrzymanie działania
skryptu. Kolejne instrukcje skryptu są wykonywane po zakończeniu odtwarzania pliku dźwiękowego. </li>

<p align="left">[[Plik:dzwiek2_2.JPG]]</p>
---- <br/>

<li><p align="left">[[Plik:dzwiek3.JPG]]</p>
Powoduje zatrzymanie wszystkich odtwarzanych aktualnie dźwięków.</li>

---- <br/></ol>

===Pisak===

<p align="left">[[Plik:instr3_plik4.JPG]]</p>
W kategorii '''Pisak''' zgromadzone są bloczki związane z pisakiem duszka, jego stanem, kolorem,
grubością. W tej grupie bloczków znajduje się również klocek do czyszczenia stworzonych
rysunków oraz możliwość odbicia wizerunku duszka jako pieczątki. Poniżej znajduje się opis
wszystkich bloczków tej kategorii. <br/>
<ol>
<li> [[Plik:pisak1_1.JPG]] <br/>
Powoduje wyczyszczenie rysunków utworzonych przez wszystkie duszki. Nie ma wpływu na
tło sceny.</li>

----

<li> [[Plik:pisak2_1.JPG]] <br/> Powoduje przystemplowanie wizerunku duszka (aktualnego kostiumu) jak odbicie pieczątki. <br/>
[[Plik:pisak2_2.JPG]]</li>

----

<li> [[Plik:pisak3_1.JPG]] <br/> Powoduje opuszczenie pisaka duszka. Wykonywane ruchy będą powodowały rysowanie
zgodnie z ustawieniami pisaka (kolor, grubość). <br/>
[[Plik:pisak3_2.JPG]]</li>

----

<li> [[Plik:pisak4_1.JPG]] <br/> Powoduje podniesienie pisaka duszka. Wykonywane ruchy duszka nie będą powodowały
rysowania. Przykład: patrz opis bloczka '''przyłóż pisak'''.</li>

----

<li> [[Plik:pisak5_1.JPG]] <br/> Powoduje wybranie koloru pisaka. Należy kliknąć myszką w kwadracik z kolorem, następnie
wybrać kolor kursorem myszy z dostępnych na ekranie. W poniższym przykładzie wybrano
kolor zielony klikając w zieloną flagę oraz kolor czerwony w przycisk zatrzymania
wykonywania skryptów. W zależności od wybranego koloru zmienia także ustawienia
odcienia koloru.
Uwaga: W wersji 1.4 po kliknięciu w kwadracik klocka z kolorem wyświetlana była również
paleta kolorów do wyboru. Niestety obecnie w wersji 2.0 nie ma tej możliwości.<br/>
[[Plik:pisak5_2.JPG]] <br/></li>

----

<li> [[Plik:pisak6_1.JPG]] <br/> Każdy kolor posiada swoją wartość liczbową. Numery kolorów zmieniają się w zakresie od 0
do 200 przechodząc przez kolory tęczy. Kolor o numerze 0 to czerwony, 70 to zielony, 130
niebieski, a 170 karmazynowy (magenta). Polecenie powoduje zmianę wartości koloru
o podany argument.<br/>
[[Plik:pisak6_2.JPG]]</li>

----

<li> [[Plik:pisak7_1.JPG]] <br/> Każdy kolor posiada swoją wartość liczbową. Numery kolorów zmieniają się w zakresie od 0
do 200 przechodząc przez kolory tęczy. Kolor o numerze 0 to czerwony, 70 to zielony, 130
niebieski, a 170 karmazynowy (magenta). Polecenie powoduje ustawienie koloru zgodnie
z podaną wartością liczbową. <br/>
[[Plik:pisak7_2.JPG]]</li>

----

<li> [[Plik:pisak8_1.JPG]] <br/> Każdy kolor posiada swój odcień określony wartością liczbową w zakresie od 0 do 100.
Odcień o wartości 0 jest zbliżony do czerni, odcień o wartości 100 do bieli. Standardową
wartością jest 50. Polecenie powoduje zmianę wartości odcienia o podany argument.<br/>
[[Plik:pisak8_2.JPG]] </li>

----

<li> [[Plik:pisak9_1.JPG]] <br/> Każdy kolor posiada swój odcień określony wartością liczbową w zakresie od 0 do 100.
Odcień o wartości 0 jest zbliżony do czerni, odcień o wartości 100 do bieli. Standardową
wartością jest 50. Polecenie powoduje ustawienie wartości odcienia na podaną wartość. <br/>
[[Plik:pisak9_2.JPG]] </li>

----

<li> [[Plik:pisak10_1.JPG]] <br/> Polecenie powoduje zmianę wartości grubości pisaka o podany argument.<br/>
[[Plik:pisak10_2.JPG]] <br/></li>

----

<li> [[Plik:pisak11_1.JPG]] <br/> Polecenie ustawia grubość pisaka na podaną wartość. <br/>
[[Plik:pisak11_2.JPG]] <br/></li>

----

</ol>

===Dane===

<p align="left">[[Plik:instr3_plik5.JPG]]</p>

Kategoria '''Dane''' zawiera przyciski do tworzenia zmiennych. Po utworzeniu własnych
zmiennych pojawią się bloczki do ich modyfikowania oraz wykorzystania wartości. Zmienne
umożliwiają przechowywanie danych. Zmienną możemy porównać do szuflady, w której coś
chowamy, pytamy się co tam jest, zmieniamy zawartość. Także Scratch korzysta ze
zmiennych, np. w kategorii '''Ruch''' możemy pobrać wartość aktualnych współrzędnych
położenia duszka lub jego kierunek. <br/>
<ol>
<li> '''Tworzenie zmiennej''' <br/>
Jeśli jeszcze nie utworzyliśmy żadnej własnej zmiennej, w kategorii '''Dane''' będą dostępne dwa
przyciski. <br/>
Drugi przycisk '''Stwórz listę''' służy do tworzenia zmiennych przechowujących bardziej
skomplikowane dane. Po kliknięciu w przycisk '''Stwórz zmienną''' pojawi się na
ekranie okno dialogowe, jak na poniższym rysunku. Musimy określić nazwę zmiennej oraz
wybrać dostępność – czy zmienna ma być dostępna dla wszystkich duszków (także dla sceny),
czy tylko dla danego duszka (inne duszki nie widzą wówczas tej zmiennej, oznacza to, że mogą
mieć również zmienną o takiej samej nazwie, ale będą to różne zmienne).<br/>

Po zatwierdzeniu przyciskiem OK pojawią się bloczki umożliwiające operacje na zmiennych.</li>

<li> Aktualna wartość zmiennej. Można ją wykorzystać jako argument w wyrażeniach. Włączenie
znacznika po lewej stronie powoduje wyświetlanie aktualnej wartości zmiennej na scenie. <br/>

Po kliknięciu prawym przyciskiem myszy w klocek z nazwą zmiennej w obszarze danych
z menu kontekstowego możemy wybrać jedną z dwóch opcji: zmianę nazwy zmiennej lub jej
usunięcie. </li>

<li>Przypisuje wartość zmiennej. Domyślna wartość można edytować, można też w to miejsce
wstawić wyrażenie. </li>

<li>Zmienia wartość zmiennej o podaną wartość. W przykładzie powyżej zmienna '''licznik''' jest
powiększana o jeden przy każdym dotknięciu duszka '''mysz'''. </li>

<li>Powoduje, że wartość zmiennej będzie wyświetlana na scenie. Działa analogicznie, jak
edycyjne włączenie znacznika przy nazwie zmiennej. Po kliknięciu prawym przyciskiem
myszy w zmienną na scenie z menu kontekstowego możemy wybrać sposób wyświetlania
wartości.<br/>

Normal readout” oznacza standardowe wyświetlanie, aktualna wartość zmiennej łącznie
z nazwą, możliwość edycji wartości. „Large readout” oznacza wyświetlanie jedynie wartości
(bez nazwy zmiennej) powiększoną czcionką, z możliwością edycji. Wybranie opcji suwak
powoduje pojawienie się dodatkowo suwaka do zmiany wartości zmiennej. Ostatnia opcja
powoduje ukrycie wyświetlania wartości na scenie. Jeśli wyświetlany jest suwak, w menu
kontekstowym dostępna jest dodatkowa opcja umożliwiająca wybór minimalnej
i maksymalnej wartości dla suwaka. </li>

<li>Powoduje, że wartość zmiennej nie będzie wyświetlana na scenie. Działa analogicznie, jak
edycyjne wyłączenie znacznika przy nazwie zmiennej.</li>
</ol>

===Zdarzenia===

<p align="left">[[Plik:instr3_plik6.JPG]]</p>
Kategoria '''Zdarzenia''' zawiera klocki rozpoczynające skrypty reagujące na określone
zdarzenia (np. kliknięcie duszka myszką, naciśnięcie klawisza na klawiaturze) oraz związane
z obsługą komunikatów (oznacza to samodzielne generowanie zdarzeń w programie). Poniżej
znajduje się opis prawie wszystkich bloczków tej kategorii. <br/>

<ol>
<li> Podstawowy bloczek. Od niego zaczyna się większość skryptów. Skrypty są uruchamiane po
kliknięciu na ekranie ikony zielonej flagi – uruchomienie programu. </li>

<li>Bloczek uruchamia skrypt po naciśnięciu określonego klawisza na klawiaturze. Klawisz
wybieramy z listy rozwijalnej.</li>

<li>Bloczek uruchamia skrypt po kliknięciu danego duszka lewym przyciskiem myszy. </li>

<li>Bloczek uruchamia skrypt wtedy, gdy nastąpi zmiana tła. Nazwę tła wybieramy z listy
rozwijalnej. Skrypt zostanie uruchomiony wtedy, gdy to tło stanie się aktualnym
(wyświetlanym na scenie). </li>

<li> Bloczek uruchamia skrypt wtedy, gdy nastąpi nadanie komunikatu o określonej nazwie
wybranej z listy rozwijalnej. Komunikat definiujemy w bloczku '''nadaj komunikat'''. Nadawanie
i odbieranie komunikatów umożliwia porozumiewanie się pomiędzy duszkami, a także sceną.
W ten sposób jeden duszek może np. uruchomić skrypt innego duszka. </li>

<li> Bloczek umożliwia zdefiniowanie i nadanie komunikatu. Nazwę komunikatu możemy wybrać
z listy rozwijalnej lub zdefiniować nowy komunikat przy pomocy opcji '''nowy komunikat...'''
dostępnej po rozwinięciu listy. <br/>
Wyświetlone będzie wówczas okno dialogowe, w którym podajemy nazwę nowego
komunikatu.<br/>
Po nadaniu komunikatu (wykonaniu tego bloczka) uruchamiane są automatycznie skrypty
zaczynające się od bloczków '''kiedy otrzymam ''nazwa komunikatu'''''. Działanie skryptu, który nadał
komunikat jest kontynuowane równolegle. Przykład: patrz opis polecenia '''kiedy otrzymam'''.
</li>

<li> Działa analogicznie jak bloczek '''nadaj ''nazwa komunikatu'''''. (patrz opis tego polecenia).
Różnica polega na tym, że działanie skryptu, w którym nadano dany komunikat
wstrzymywane jest do czasu zakończenia działania wszystkich skryptów odbierających ten
komunikat.</li></ol>

===Kontrola===

<p align="left">[[Plik:instr3_plik7.JPG]]</p>
Kategoria '''Kontrola''' zawiera bardzo ważne klocki – odpowiedniki instrukcji sterujących
języków programowania (pętle, instrukcje warunkowe). Poniżej znajduje się opis wszystkich
bloczków tej kategorii za wyjątkiem klonowania duszków. <br/>
<ol>
<li>Bloczek powoduje wstrzymanie działania skryptu na określony czas. Domyślną wartość
możemy edytować. </li>

<li>Bloczek powoduje powtarzanie zestawu instrukcji określoną liczbę razy. Domyślną liczbę
powtórzeń możemy edytować.</li>

<li>Bloczek powoduje powtarzanie zestawu instrukcji w nieskończoność, do naciśnięcia
przycisku przerwania – czerwonego koła. Jeśli skrypt z bloczkiem '''zawsze''' ma się zatrzymać
sam, należy w jego wnętrzu użyć instrukcji warunkowej i bloczka '''zatrzymaj'''.</li>

<li>Bloczek instrukcji warunkowej, wykonany zostanie raz zestaw instrukcji, jeżeli warunek
logiczny wstawiony po słowie '''jeżeli''' jest prawdziwy. Warunki budujemy z bloczków kategorii
'''Czujniki''' i '''Wyrażenia'''.</li>

<li>Bloczek instrukcji warunkowej, wykonany zostanie zestaw instrukcji pomiędzy słowami '''to'''
i '''w przeciwnym razie''', jeżeli warunek logiczny wstawiony po słowie '''jeżeli''' jest prawdziwy.
W przeciwnym przypadku zostanie wykonany zestaw instrukcji po słowie w przeciwnym
razie. Warunki budujemy z bloczków kategorii '''Czujniki''' i '''Wyrażenia'''.</li>

<li>Wstrzymuje działanie skryptu do momentu spełnienia warunku logicznego. Warunki
budujemy z bloczków kategorii '''Czujniki i Wyrażenia'''.</li>

<li>Bloczek powoduje powtarzanie zestawu instrukcji aż do spełnienia warunku logicznego.
Warunki budujemy z bloczków kategorii '''Czujniki i Wyrażenia'''.</li>

<li>Powoduje zatrzymanie wykonywania skryptu lub skryptów. Z listy rozwijalnej można
wybrać: zatrzymanie skryptu, w którym umieszczono bloczek ('''ten skrypt'''), wszystkich
skryptów wszystkich duszków i sceny ('''wszystko''') oraz innych skryptów danego duszka za
wyjątkiem skryptu, w którym został uruchomiony ten bloczek ('''inne skrypty duszka''').
Przykłady: patrz opis bloczków '''zawsze i jeżeli'''.</li>
</ol>

===Czujniki===

<p align="left">[[Plik:instr3_plik8.JPG]]</p>
Kategoria '''Czujniki''' zawiera bloczki związane z rozpoznawaniem różnych sytuacji
zachodzących na scenie, dotyczących m.in. duszków i myszki, bloczki umożliwiające
pobieranie danych z klawiatury, bloczki związane z zegarem, datą oraz kamerą. Poniżej
znajduje się opis większości bloczków tej kategorii za wyjątkiem obsługi kamery oraz
bloczków daty. <br/>
<ol>
<li> [[Plik:czuj1_1.JPG]] <br/> Sprawdza, czy duszek dotyka elementu wybranego z listy rozwijalnej. Może to być dowolny
inny duszek, kursor myszy lub krawędź sceny. Bloczek ten jest wykorzystywany najczęściej
w połączeniu z jednym z bloczków '''jeżeli, powtarzaj aż, czekaj aż'''.<br/>
[[Plik:czuj1_2.JPG]]</li>

----

<li> [[Plik:czuj2_1.JPG]] <br/> Sprawdza, czy duszek dotyka określonego koloru na scenie. Aby wybrać kolor, należy kliknąć
myszką w kwadracik z kolorem w bloczku, następnie wybrać kolor kursorem myszy
z dostępnych na ekranie. Bloczek ten jest wykorzystywany najczęściej w połączeniu z jednym
z bloczków '''jeżeli, powtarzaj aż, czekaj aż'''. <br/>
[[Plik:czuj2_2.JPG]]/li>

----

<li> [[Plik:czuj3_1.JPG]] <br/>Sprawdza, czy wybrany kolor postaci duszka dotyka określonego koloru na scenie. Aby
wybrać kolor, należy kliknąć myszką w kwadracik z kolorem w bloczku, następnie wybrać
kolor kursorem myszy z dostępnych na ekranie. Bloczek ten jest wykorzystywany najczęściej
w połączeniu z jednym z bloczkami '''jeżeli, powtarzaj aż, czekaj aż'''. <br/>
[[Plik:czuj3_2.JPG]]</li>

----

<li> [[Plik:czuj4_1.JPG]] <br/> Aktualna odległość danego duszka od elementu wybranego z listy rozwijalnej – kursora
myszy lub innego duszka. Można ją wykorzystać jako argument w wyrażeniach. Odległość jest
liczona od środka duszka – można go ustawić edytując kostium. <br/>
[[Plik:czuj4_2.JPG]]<br/>
[[Plik:czuj4_3.JPG]]</li>

----

<li> [[Plik:czuj5_1.JPG]] <br/> Wyświetla w dymku tekst wpisany w pole bloczka oraz okienko na scenie z polem edycyjnym.
Czeka na wprowadzenie danych w polu edycyjnym i zatwierdzenie klawiszem Enter lub
przyciskiem w polu edycyjnym. Wprowadzona z klawiatury informacja dostępna jest
w skryptach za pomocą bloczka '''odpowiedź'''. <br/>
[[Plik:czuj5_2.JPG]]</li>

----

<li> [[Plik:czuj6_1.JPG]] <br/> Podana przez użytkownika odpowiedź, jako wynik działania klocka '''Zapytaj i czekaj'''. Można
ją wykorzystać jako argument w wyrażeniach. Włączenie znacznika po lewej stronie
powoduje wyświetlanie podanej odpowiedzi na scenie. Przykład: patrz opis bloczka '''Zapytaj
i czekaj'''.</li>

----

<li> [[Plik:czuj7_1.JPG]] <br/> Sprawdza, czy wybrany z listy rozwijalnej klawisz został naciśnięty. Bloczek ten jest wykorzystywany
najczęściej w połączeniu z jednym z bloczków '''jeżeli, powtarzaj aż, czekaj aż.''' <br/>
[[Plik:czuj7_2.JPG]]</li>

----

<li> [[Plik:czuj8_1.JPG]] <br/> Sprawdza, czy został wciśnięty lewy klawisz myszy. Bloczek ten jest wykorzystywany
najczęściej w połączeniu z jednym z bloczków '''jeżeli, powtarzaj aż, czekaj aż'''. <br/>
[[Plik:czuj8_2.JPG]] </li>

----

<li> [[Plik:czuj9_1.JPG]] <br/> Aktualna wartość x-owej oraz y-owej współrzędnej kursora myszy. Można je wykorzystać
jako argument w wyrażeniach. Współrzędne te są także wyświetlane pod prawym dolnym
rogiem sceny. <br/>
[[Plik:czuj9_2.JPG]]</li>

----

<li> [[Plik:czuj10_1.JPG]] <br/> Aktualna czas liczony w sekundach od momentu ostatniego kliknięcia zielonej flagi lub
wykonania bloczka kasuj zegar. Można go wykorzystać jako argument w wyrażeniach.
Włączenie znacznika po lewej stronie powoduje wyświetlanie czasu na scenie. <br/>
[[Plik:czuj10_2.JPG]]</li>

----

<li> [[Plik:czuj11_1.JPG]] <br/> Zeruje odliczanie czasu. Wartości oddawane przez bloczek czasomierz będą ponownie liczone
od zera.<br/>
[[Plik:czuj11_2.JPG]]</li>

----

<li> [[Plik:czuj12_1.JPG]] <br/> Aktualna wartość wybrana z pierwszej listy rozwijalnej, dotycząca duszka wybranego
z drugiej listy lub sceny. Można wybrać x-ową lub y-ową współrzędną, kierunek, numer
kostiumu lub nazwę kostiumu, rozmiar. Dla sceny do wyboru są numer lub nazwa tła.
Oddawaną wartość można wykorzystać w wyrażeniach.<br/>
[[Plik:czuj12_2.JPG]]</li>

----
</ol>

===Wyrażenia===

<p align="left">[[Plik:instr3_plik9.JPG]]</p>
W kategorii '''Wyrażenia''' zgrupowane są bloczki podstawowych działań arytmetycznych,
operacji logicznych oraz różnych funkcji (zarówno arytmetycznych jak i na tekstach).
Wszystkie bloczki tej kategorii są wykorzystywane jako argumenty do innych bloczków.
Poniżej znajduje się opis większości bloczków tej kategorii. <br/>
<ol>
<li> [[Plik:wyr1_1.JPG]] <br/>
Bloczki czterech podstawowych operacji arytmetycznych (dodawanie, odejmowanie,
mnożenie, dzielenie). W polach edycyjnych należy podać argumenty (mogą to być ręcznie
wpisane liczby, wartość zmiennej lub wynik innego działania, a więc bloczki można
zagnieżdżać). Zbudowane wyrażenie arytmetyczne należy wykorzystać jako argument innego
bloczka, np. określenia wartości zmiennej, czy wyrażenia logicznego. <br/>
[[Plik:wyr1_2.JPG]] </li>

----

<li> [[Plik:wyr2_1.JPG]] <br/> Losuje liczbę z podanego zakresu. W polach edycyjnych należy podać dolny i górny zakres
losowania. Bloczek należy wykorzystać jako argument innego bloczka.<br/>
[[Plik:wyr2_2.JPG]]</li>

----

<li> [[Plik:wyr3_1.JPG]] <br/>
Bloczki porównania (mniejsze, równe, większe). W polach edycyjnych należy podać
porównywane wartości. Można wpisać konkretne wartości w pola edycyjne, najczęściej
jednym z argumentów jest wartość zmiennej lub wartość odczytywana przy pomocy innego
bloczka (np. współrzędna położenia duszka na scenie). Bloczek jest wykorzystywany
najczęściej w instrukcjach '''jeżeli, powtarzaj aż, czekaj aż'''.
[[Plik:wyr3_2.JPG]]</li> 

----

<li> [[Plik:wyr4_1.JPG]] <br/>
Bloczki służące do budowania złożonych wyrażeń logicznych (koniunkcja – obydwa warunki są
prawdziwe, alternatywa – jeden z warunków jest prawdziwy, negacja – zaprzeczenie). W pola
argumentów należy wstawić pasujące bloczki zwracające wartości logiczne (prawda lub fałsz).
Bloczki są wykorzystywane najczęściej w instrukcjach '''jeżeli, powtarzaj aż, czekaj aż'''.<br/>
[[Plik:wyr4_2.JPG]]</li>

----

<li> [[Plik:wyr5_1.JPG]] <br/> Bloczek służący do połączenia dwóch napisów w jeden. Najczęściej jeden z argumentów jest
wpisanym tekstem, a drugi wartością zwracaną przez inny bloczek. Bloczek jest
wykorzystywany często jako argument w bloczkach '''powiedz i pomyśl'''. <br/>
[[Plik:wyr5_2.JPG]]</li>

----

<li> [[Plik:wyr6_1.JPG]] <br/> Wartością jest reszta z dzielenia pierwszego argumentu przez drugi. Bloczek jest
wykorzystywany jako argument w wyrażeniach arytmetycznych i logicznych. <br/>
[[Plik:wyr6_2.JPG]] 
[[Plik:wyr6_3.JPG]]</li>

----

<li> [[Plik:wyr7_1.JPG]] <br/> Wartością jest zaokrąglony argument do najbliższej liczby całkowitej – zgodnie z regułami
zaokrąglania, tzn. 0.5 i więcej jest zaokrąglana w górę, w przeciwnym przypadku w dół.
Bloczek jest wykorzystywany jako argument w innych bloczkach.<br/>
[[Plik:wyr7_2.JPG]]</li>

----

<li> [[Plik:wyr8_1.JPG]] <br/> Wartością jest wynik funkcji wybranej z listy rozwijalnej dla argumentu podanego w polu
edycyjnym. Z listy rozwijalnej można wybrać następujące funkcje:<br/>
[[Plik:wyr8_2.JPG]] <br/>
Bloczek jest wykorzystywany jako argument w innych bloczkach. Wyjaśnienia mogą wymagać
funkcje o nazwach '''podłoga''' (zaokrąglenie zawsze w dół) oraz '''sufit''' (zaokrąglenie zawsze
w górę).<br/>
[[Plik:wyr8_3.JPG]]</li>

----
</ol>

===Bloki sceny===
<p align="left">[[Plik:scena2.JPG]]</p>
'''Scena''', podobnie jak duszki, może mieć własne skrypty. Aby tworzyć skrypty dla sceny trzeba
ją wybrać jako aktywny obiekt w lewym dolnym roku ekranu – obszarze zarządzania
duszkami i sceną. <br/>
<p align="left">[[Plik:scena1.JPG]]</p>
Zmieni się wówczas repertuar dostępnych bloków – wiele z nich dotyczy
wyłącznie duszków i nie można ich wykorzystywać w skryptach sceny. Poniżej opisano
występujące różnice.<br/>

1. Kategoria '''Ruch'''
Nie ma w tej kategorii żadnych bloczków, sceny nie można przesuwać ani obracać.<br/>

2. Kategoria '''Wygląd'''
Najwięcej zmian jest w tej kategorii. Scena może posiadać wiele teł, podobnie jak duszek
kostiumów. Dostępne są bloczki związane ze zmianą tła oraz informacje o wybranym tle.
Najważniejsze z nich to:<br/>
<ul>
<li>[[Plik:scena_3.JPG]] '''Zmiana tła na wybrane''' z listy rozwijalnej. Tła sceny przypisujemy
w zakładce tła. Możemy załadować tło z galerii, narysować, wybrać z pliku na dysku bądź
sfotografować przy pomocy kamery. W przypadku importowania jako tło plików
graficznych należy pamiętać o wymiarach sceny – 480 na 360 punktów.</li>
<li>[[Plik:scena_4.JPG]]'''Zmiana tła na następne'''. Następnym tłem po ostatnim jest ponownie
pierwsze.</li>
<li>[[Plik:scena_5.JPG]]'''Nazwa''' aktualnie wyświetlanego tła.</li>
<li>[[Plik:scena_6.JPG]]'''Numer''' aktualnie wyświetlanego tła.</li></ul>
3. Kategoria '''Dźwięk'''
Bloczki są takie same, ale w przypadku odtwarzania plików dźwiękowych odnoszą się do
dźwięków przypisanych scenie w zakładce Dźwięki.<br/>
4. Kategoria '''Pisak'''
W tej kategorii dla sceny jest tylko jeden bloczek – wyczyść.<br/>
5. Kategoria '''Dane'''
Tak samo jak dla duszków. Jedyna zmiana, to taka, że można tu tworzyć zmienne
dostępne tylko dla wszystkich duszków.<br/>
6. Kategoria '''Zdarzenia'''
Takie same bloczki jak dla duszków.<br/>
7. Kategoria '''Kontrola'''
Takie same bloczki jak dla duszków.<br/>
8. Kategoria '''Czujniki'''
Takie same bloczki jak dla duszków. Nie występują bloczki dotyczące oddziaływania
duszków z innymi obiektami i kolorami (dotyka, dotyka koloru, czy kolor dotyka
koloru, odległość od)<br/>
9. Kategoria '''Wyrażenia'''
Takie same bloczki jak dla duszków.