Síla dokumentace

Vytvořili jste si několik programů A možná si říkáš, jak si zapamatuješ všechny tyhle příkazy? Jestli je to ovál nebo kružnice nebo elipsa? Je to šířka nebo výška, nebo výška a šířka? Musím si to všechno pamatovat? Jasně že ne! Na to máme počítače. Věc se má tak, že vždy když programujeme, tak s sebou máme počítač a počítače jsou v pamatování věcí velmi dobré. Takže co kdyby si za nás počítač pamatoval všechny detaily a jenom věděli, jak je máme použít. Takže se můžeme soustředit na vytváření cool programů a nemusíme se učit zpaměti spoustu nudných detailů. To je něco, čemu říkáme dokumentace. Dokumenty, které vysvětlují, jak programovat v konkrétním jazyce a prostředí včetně ukázání příkladů. Takže když si nepamatujete přesné detaily, nebojte se. Vždy si je můžete najít. Možná si říkáte, že číst dokumentaci je nuda, a vlastně máte pravdu. S kódem si užijete víc zábavy! Ale pokud se nechcete učit nazpaměť úplně všechno, musíte se naučit používat dokumentaci, abyste mohli své nápady naprogramovat. Ani ti nejlepší programátoři si vše nepamatují nazpaměť. Pravdou je, že dobří programátoři jsou dobří i v čtení dokumentace. Například když si vykresluji smajlíka a už jsem za použití elipsy vykreslila obličej a oči díky funkci, kterou už dobře znám. Ale nějakou práci mám ještě před sebou. Zaprvé, chci vykreslit obličej tlustými čarami, jako samolepku. Pamatuji si, že to bylo něco s obrysem (stroke) ale přesně si nepamatuji jméno. takže pokusu to znovu vynalézt, což by mi mohlo trvat hodiny, se jednoduše kouknu do dokumentace rozhlédnu se a zkusím najít to, co hledám. Kouknu se pod "coloring" kategorii (barvení), která vypadá že by v ním mohly být funkce, které hledám a konečně na konci najdu "stroke weight" (váha obrysu) která mění tloušťku čar. Takže tu vidíme jméno funkce a parametry speciálně pro tento případ. Co obvykle na začátku udělám je, že kód zkopíruji a vložím do mého kódu. Ale v zápětí se objeví chyba "thickness is not defined" (tloušťka není definována) To protože šířka je parametr, který rezervuje místo Není to reálná hodnota, takže jí musím nahradit za šířku, kterou chci. To může být číslo nebo proměnná odkazující na číslo - v tom případě se tam vloží hodnota proměnné. Řekněme, že číslo 10 je pěkné, ale my víme, že si s ním můžeme ještě trochu pohrát a sledovat, co se děje. Hehe, to je trošku extrémní. Fajn, jdeme o kousek zpátky...12 vypadá cool Ještě nám tu očividně něco chybí: Úsměv. Tak vlastně chceš něco takovéhleho Můžeš se na úsměv podívat a myslet si, že to nevypadá jako vykreslené pomocí elipsy nebo přímky Protože je potřeba to ohnout a zároveň nemít nic uvnitř Takže by asi bylo dobré kouknout se do dokumentace a zjistit, jestli tu najdu způsob, jak tento oblouk vykreslit. Takže jdeme do dokumentace! Roluju dolů...hledám... Zkusím se kouknout do kategorie tvarů ("shapes") Aha! Hned první tvar je oblouk ("arc") který se používá pro kreslení oblouků. Tak. To je tvar úsměvu. Je to správně. Tenhle má ale daleko více parametrů. Které mu začnu předávat A pamatuj si, že tyto parametry rezervují místo a musíme je nahradit hodnotami, které si myslíme, že by tam měli být. Dobrá, takže x a y jsou místo, kde chci začít řekněme, že prostředek je 100, takže asi začnu na 150. y je možná 250...a potom šířka šířka zní jako šířka oblouku. takže tam asi dáme něco menšího, než šířku celého obličeje. takže možná 200...teď výška to asi bude výška oblouku od vrchu dolů což by mohlo být 50. Hmm, vlastně nevím, co jsou tyhle zač fajn, zasekl jsem se, koukám se na funkci a zkouším jí použít. Ale vlastně parametrům vůbec nerozumím. Naštěstí se můžu opět podívat do dokumentace Kliknutí na funkci, která mě zajímá mě dostane přímo k programu, který mi ukáže, jak ji použít a dokonce mi i detailně vysvětlí parametry. Píše se tu, že x je souřadnice na ose x ve středu elipsy odvozené z oblouku Což v zásadě znamená, že vykreslení oblouku tak to připomíná vykreslování části elipsy a spočítání všeho ostatního na jejím základě. Takže x a y představují ohniska elipsy, šířka a výška představují šířku a výšku imaginární elipsy a start a stop - tohle mi nebylo jasné... Začátek a konec je zorný úhel...Dobře, takže začátek je místo, kde začíná oblouk, ve stupních, a konec (stop) je místo, kde končí. A konečně se můžeme kouknout na příklad, který jsme tu udělali. vykreslení oblouku od 1 do 270, to je nejspíš tento oblouk. Protože to odpovídá 1° a 270°. Teď to zkusím změnit. Od 1° do 180°, to by mělo dávat smysl a máme zhruba to, co jsme chtěli...polovina oblouku, fajn, teď když už obloukům rozumím dostatečně můžu se vrátit zpět k úsměvu. Takže 0° až 180° a... Skoro to mám. Hodnota x je mimo mísu, protože jsem si neuvědomila že x je vlastně střed elipsy. A je to trošku moc široké, takže ho uděláme menší Haha! Konečně mám pořádný úsměv. Díky použití dokumentace mi to šlo rychleji. A to je vlastně cílem programování - překlopit svoje nápady co nejrychleji do reality. Takže pamatujte na sílu dokumentace!