h3. Obdĺžniky

Vypĺňať plochu s pomocou čiar je možné (ako ste sa mohli presvedčiť v predošlej lekcii). Ak to však nerobíte pozorne, môže sa vám stať, že niektoré bodíky na obrazovke ujdú vašej pozornosti a nevyplníte ich. Môže z toho síce vzísť pekná vzorka (ako sa stalo pri prvom príklade predošlej lekcie), ale to nie je vždy to, čo si človek želá. Preto má RUDL funkcie určené špeciálne na vypĺňanie určených plôch.

Najjednoduchšie je vyplniť obdĺžnik. Napríklad obdĺžnik, ktorého protiľahlé vrcholy majú súradnice [30,70] a [160,140] sa vyplní príkazom <code>$screen.rectangle</code>. Ako parametre uvedieme obdĺžnik, čo treba vyplniť, a jeho farbu. Obdĺžniky sa ale v RUDL nezadávajú ako <code>[x1,y1,x2,y2]</code>, ale ako <code>[x,y,šírka,výška]</code>.

Šírka obdĺžnika bude 130 (rozdiel x-súradníc) a výška bude 70 (rozdiel y-súradníc), takže to bude:

<code>
$screen.filled_rectangle([30,70,130,70], [255,198,198])
</code>

(Existuje aj funkcia <code>rectangle</code>, ktorá nakreslí nevyplnený obdĺžnik.)

h3. N-uholníky

Trojuholníky, štvoruholníky atď. sa kreslia pomocou príkazu <code>polygon</code>:

<code>
$screen.polygon([[130,30], [420,70], [270,342]], [255,198,198])
</code>

(<code>polygon</code> chce pole vrcholov a farbu.)

Keď treba vyplnené viacuholníky, použije sa <code>filled_polygon</code>.

<code>
$screen.filled_polygon([[320,20], [420,460], [100,140], [540,140], [220,460]], [255,0,0])
</code>

(Ak hranica mnohouholníka pretína sama seba, vypĺňanie sa správa podivne -- ako sa koniec koncov môžete presvedčiť na uvedenom príklade.)

h3. Krúžky

Kruhy sa kreslia pomocou funkcií <code>circle</code> a <code>filled_circle</code>.

<code>
$screen.filled_circle([400,300], 100, [255,255,0])
</code>

Zadáva sa polomer, nie priemer (takže ten príklad hore nakreslí krúžok veľký 200x200 px).

Elipsy sa zase kreslia pomocou <code>ellipse</code> a <code>filled_ellipse</code>:

<code>
$screen.filled_ellipse([400,300], 200, 50, [0,0,255])
</code>

Pri elipse sa zadávajú dva polomery: x-ový a y-ový (takže ten príklad hore nakreslí elipsu širokú 400 px a vysokú 100 px).

*Úloha č. 1:* Napíšte, pochopte, spustite uvedené príklady. Všetky dajte do jedného programu (samozrejme pred každým vymažte obrazovku a za každý dajte <code>$screen.flip</code> a <code>keypress</code>).

*Úloha č. 2:* Náhodné celé číslo od 0 do 99 vyrobíte pomocou funkcie <code>rand(100)</code>. Nakreslite 1000 náhodných trojuholníkov náhodnej farby.

*Úloha č. 3:* Nakreslite šachovnicu aj s bielymi a čiernymi poľami.

*Špeciálna úloha:* Nakresliť červenú hviezdu bez diery v prostriedku. (Ak vám to pomôže, nemusí nutne mať súradnice rovnaké ako tá z toho príkladu vyššie.)

*Špeciálna úloha č. 2:* Predstavte si tento program:

<code>
$screen.rectangle([290,210,60,60], [0,255,0])
$screen.rectangle([260,180,120,120], [0,255,0])
$screen.floodfill([320,200], [0,128,0])
</code>

<code>floodfill</code> v angličtine znamená "vyplň" (funguje to ako ten nástroj v Paint-e). Bohužiaľ v RUDL žiadna takáto funkcia neexistuje, takže uvedený program vyhlási chybu. Skúste zistiť, čo by ten program nakreslil, keby existovala (napríklad si to môžete nakresliť na papier), a vytvoriť svoj vlastný spustiteľný (t.j. chybu nevyhlasujúci) program, ktorý to nakreslí.

h3. Dodatky

h4. <code>filled_rectangle</code> vs <code>fill</code>

Okrem <code>Surface#filled_rectangle(rect,color)</code> sa na vypĺňanie obdĺžnikov dá použiť aj stará známa funkcia <code>fill</code>. Tá normálne vyplní celý obrázok jednou farbou, ale má aj druhý nepovinný parameter, ktorý obmedzuje, ktorá časť obrázka sa má vyplniť.

Prečo je kreslenie obdĺžnikov v RUDL dvakrát? Nuž, ako som zmienil v prvej lekcii, RUDL spája dokopy SDL aj mnohé ďalšie dodatkové knižnice. SDL samotná neobsahuje takmer žiadne funkcie na prácu s obrázkami, v podstate iba kopírovanie z obrázka do obrázka a vypĺňanie častí nejakou farbou. (Nie je tam ani <code>plot</code>, resp. <code>putpixel</code>) Väčšina kresliacich funkcií v RUDL pochádza z knižnice SDL_gfx. Tá už je omnoho kompletnejšia a obsahuje všetko možné, _aj_ ďalšiu funkciu na vypĺňanie obdĺžnikov.

RUDL všetky tieto knižnice spája dohromady, takže v RUDL sú obidve tieto funkcie. <code>fill</code> je z SDL a <code>filled_rectangle</code> je z SDL_gfx.

Podľa dokumentácie RUDL (http://rudl.sf.net/docs/): "Choose whichever you like best." Čiže: "Používajte si, ktorý chcete." (Pozor na to, že majú opačné poradie parametrov - fill chce najprv farbu a filled_rectangle chce najprv obdĺžnik.)

h4. Zoznam kresliacich funkcií - zhrnutie

Funkcie na vyfarbovanie obrázkov (v angličtine sa mimochodom volajú "drawing primitives"): <code>line</code>, <code>rectangle</code>, <code>circle</code>, <code>ellipse</code>, <code>filled_pie</code>, <code>polygon</code>, <code>print</code>, <code>plot</code>.

"<code>filled_</code>" verzie funkcií <code>rectangle</code>, <code>circle</code>, <code>ellipse</code>, <code>polygon</code> nakreslia nie len obrys, ale vyplnený útvar.

"<code>antialiased_</code>" verzie funkcií <code>line</code>, <code>circle</code>, <code>ellipse</code>, <code>polygon</code> nakreslia antialiasované útvary.

<code>filled_pie</code> kreslí výsek z elipsy, konkrétne použitie a parametre nájdete v dokumentácii RUDL.

<code>plot(súradnice, farba)</code> nakreslí na dané miesto bodku veľkú jeden pixel. Má aj skratku, ktorá niekedy môže byť čitateľnejšia: <code>$screen[x,y] = [r,g,b]</code> - s plochami sa dá narábať ako s nejakými dvojrozmernými poľami.