B.1 Souřadnice

Výchozí bod je na dolním levém okraji okna. Implicitní velikost okna je 640 x 480 pixelů; lze ji měnit. Souřadnice jsou zadávány v pixelech.

Všechny funkce, které přijímají souřadnice je přijímají jako entici (x, y).

Circle((300, 200), 10)     # :) This is good
Circle(300, 200, 10)       # :( This is bad

B.2 Barvy

Syntaxe pro volání barvy je: color.farba, kde farba je legitimní název barvy, např:

color.black.

Přípustné názvy barev jsou uvedeny v přehledu Gaspu.

B.3 Nezbytné náležitosti

from gasp import *

begin_graphics()

...    # all of your code

end_graphics()

Toto jsou nezbytné náležitosti grafického zobrazení v Gasp. Příkaz from gasp import * importuje modul gasp, begin_graphics() otevírá grafické okno a end_graphics() zavírá grafické okno. Je to krajně jednoduché ale také krajně nezbytné.

B.4 Grafické funkce

begin_graphics()

begin_graphics(height=640, width=480>, title="Gasp", background=color.white)

Toto implicitně vytvoří grafické okno o rozměrech 640x480, s názvem Gasp a bílou barvou pozadí.

height

Výška okna v pixelech.

width

Šířka okna v pixelech.

title

Řetězec, který se stane názvem okna

background

Pozadí grafického okna. Může jím být barva nebo zobrazení.

end_graphics()

endgraphics()

Uzavře grafické okno

clear_screen()

clear_screen()

Vymete vše z grafického okna. To vypadá jako nové po volání příkazem begin_graphics().

remove_from_screen()

remove_from_screen(obj)

Odstraní zadané objekty z plochy.

obj

Některý z objektů plochy, uvedený v seznamu screen_objects.

B.5 Objekty plochy

Objekty, jež lze zobrazit v grafickém okně. Lze jimi manipulovat pomocí metod objektů plochy.

Plot

Plot(pos, color=color.black, size=1)

Umístí tečku do plochy.

pos

Souřadnice tečky na ploše.

color

Barva tečky.

size

Číslo, určující velikost tečky

Line

Line(start, end, color=color.black)

Vytváří přímku na ploše.

start

Počáteční souřadnice přímky.

end

Koncová souřadnice přímky.

color

Barva přímky

Box

Box(center, width, height, filled=False, color=color.black, thickness=1)

Vytvoří obdélník na ploše

center

Souřadnice středu obdélníka.

width

Šířka obdélníka v pixelech.

height

Výška obdélníka v pixelech.

filled

Booleovská hodnota, která určuje, zda bude obdélník vyplněn

color

Barva obdélníka.

thickness

Tloušťka obvodu obdélníka.

Polygon

Polygon(points, filled=False, color=color.black, thickness=1)

Vytvoří lomenou čáru na ploše.

points

Seznam souřadnic bodů polygonu; musí obsahovat alespoň dva body.

filled

Booleovská hodnota mající smysl pro uzavřený polygon. Při hodnotě False není polygon vyplněn.

color

Barva lomené čáry

thickness

Tloušťka čar polygonu.

Circle

Circle(center, radius, filled=False, color=color.black, thickness=1)

Kreslí kružnici, zadanou středem a poloměrem v pixelech. Implicitní nastavení je pro kružnici nevyplněnou, s černou čárou tloušťky 1.

center

Souřadnice středu kružnice.

radius

Číslo, udávající velikost poloměru kružnice

filled

Booleovská hodnota určující vyplněnost kružnice

color

Barva obvodu kružnice.

thickness

Tloušťka čáry v pixelech.

Arc

Arc(center, radius, start_angle, end_angle, filled=False, color=color.black, thickness1)

Vytvoří kruhový oblouk na ploše.

center

Souřadnice středu oblouku.

radius

Číslo, udávající velikost poloměru kruhového oblouku.

start_angle

Počáteční úhel oblouku ve stupních

end_angle

Koncový úhel oblouku ve stupních

filled

Booleovská hodnota, určující vyplněnost oblouku

color

Barva oblouku (včetně výplně)

thickness

Tloušťka čáry v pixelech

Oval

Oval(center, width, height, filled=False, color=color.black, thickness=1)

Nakreslí ovál (elipsu) do zadaného místa v ploše.

center

Souřadnice středu oválu

width

Šířka oválu v pixelech

height

Výška oválu v pixelech

filled

Booleovská hodnota, určující vyplněnost oválu.

color

Barva oválu

thickness

Tloušťka čáry oválu

Image

Image(self, file_path, center, width=None, height=None):

Natáhne připravené zobrazení na plochu. Zadá-li se hodnota pouze jednomu parametru width nebo hight, doplní se druhá hodnota automaticky. Nezadá-li se žádná tato hodnota, použije se původní rozměr zobrazení.

file_path

Cesta a název souboru se zobrazením ve formátu řetězce (v uvozovkách).

center

Souřadnice středu zobrazení

width

Šířka zobrazení v pixelech.

height

Výška zobrazení v pixelech

B.6 Metody objektů plochy

Metody, které manipulují s objekty.

move_to()

move_to(obj, pos>)

Přemísti objekt na pozici pos.

obj

Přemisťovaný objekt plochy.

pos

Souřadnice místa, kam bude objekt přemístěn

move_by()

move_by(obj, dx, dy)

Posuň objekt o zadané hodnoty

obj

Posouvaný objekt plochy

dx

Velikost posunu ve směru 'x' v pixelech; kladná či záporná.

dy

Velikost posunu ve směru 'y' v pixelech; kladná či záporná.

rotate_to()

rotate_to(obj, angle)

Otoč objekt do zadaného natočení

obj

Otáčený objekt

angle

Úhel výsledného natočení

rotate_by()

rotate_by(obj, angle)

Pootoč objekt o určitý úhel.

obj

Pootáčený objekt

angle

Úhel pootočení; kladný či záporný.

B.7 Text

Text()

Text(text, pos, color=color.black, size=12)

Umístí text na plochu

text

Zobrazovaný text ve formátu řetězce

pos

Souřadnice středu textu

color

Barva textu

size

Velikost fontu

B.8 Zvuk

Všechny funkce, které manipulují se zvukem.

Sound()

Sound(file_path)

Vytvoří zvukový objekt

file_path

Cesta a jméno souboru, ze kterého chceš vytvořit zvukový objekt

play_sound()

play_sound(obj, loop=False)

Přehraje zvukový objekt

obj

Zvukový objekt

loop

Při hodnotě False se soubor přehraje jednou, při hodnotě True se přehrává opakovaně, dokud není zastaven.

stop_sound()

stop_sound(obj, finish=False, fade=True)

Zastaví přehrávaný objekt

obj

Zastavovaný zvukový objekt

finish

Při hodnotě True se objekt zastaví, až se přehraje. Při hodnotě False se zastaví okamžitě.

fade

Při True se zastaví s dozněním, při False se zastaví bez doznění.

B.9 Myš

mouse_position()

mouse_position()

Vrací aktuální pozici myši.

mouse_buttons()

mouse_buttons()

Vrací slovník s aktuálním stavem tlačítek myši, například: {'left': 0, 'middle': 0, 'right': 0}.

B.10 Klávesnice

keys_pressed()

keys_pressed()

Vrací seznam všech klávesnic, stisknutých v daném okamžiku.

B.11 Nástroje Gaspu

screen_shot

screen_shot(filename)

Uloží aktuální grafickou plochu do souboru png.

filename

Jméno souboru s relativní cestou zadané jako řetězec.