O Poder da Documentação

RKA11C Ok, você escreveu alguns programas, mas deve estar se perguntando: "Como eu devo lembrar de todos esses comandos? O certo é oval, circle ou ellipse? É width e height, ou height e width? Eu tenho que memorizar tudo isso?" Felizmente, não! É para isso que serve o computador. Acontece que nós sempre temos um computador conosco quando programamos, e um computador é muito bom em lembrar coisas, melhor que nós. E se fizéssemos o computador lembrar dos detalhes para nós, e nós pudéssemos usá-lo como uma referência para a programação? Então, poderíamos nos concentrar em criar programas legais, e não em memorizar um monte de detalhes chatos. É isso o que chamamos de documentação. Um documento que explica como programar em uma linguagem e um ambiente em particular, com exemplos e pegadinhas. Se não conseguirmos nos lembrar dos detalhes exatos, sem problemas, podemos simplesmente consultá-lo. Você pode pensar que é chato ler documentação... e você está certo, é um pouco chato mesmo. É muito mais divertido escrever código! Mas, a não ser que você queira memorizar absolutamente tudo, você precisa aprender a usar a documentação ou ser capaz de programar suas ideias. Mesmo grandes programadores não tentam memorizar tudo, na verdade, grandes programadores são algumas das melhores pessoas em ler documentação. Por exemplo, eu estou desenhando este rosto aqui, sorridente, e eu já desenhei o rosto e os olhos usando ellipse, uma função que eu conheço bem. Mas eu ainda tenho mais trabalho a fazer. Primeiro, quero desenhar o rosto com contornos grossos, como um adesivo, e eu lembro que isso tem alguma coisa a ver com stroke, mas eu não me lembro exatamente do nome. Então, em vez de sentar aqui e tentar inventar o nome, o que pode demorar horas ou tempo infinito, vou até a aba "documentação" dar uma olhada, procurando o que preciso. Vou olhar para essa categoria de coloração, porque ela parece relacionada, e vejo as funções aqui. Então, lá no final, encontro stroke weigth para mudar a espessura de linhas e contornos. Aqui, nós vemos o nome da função e seus parâmetros... Apenas um neste caso. Em geral, o que eu faço é começar apenas copiando este código e colando no meu código. Mas eu imediatamente recebo um erro: thickness não está definido. Isso acontece porque thickness é um parâmetro de exemplo, não é um valor de verdade. Eu preciso trocá-lo pelo valor que eu quero que realmente seja, e isso pode ser com um número ou com uma variável que se refere a um número. Bem, isso é um pouco extremo. E este é pequeno demais... Enfim, vamos voltar para 12. Legal, agora existe algo muito óbvio faltando nesse rosto: o sorriso. Eu basicamente preciso de algo assim, certo? E eu posso olhar para o sorriso e pensar: "Bem, não parece algo que eu desenharia usando ellipse, line ou rect, porque tem essa curva. Mas ele não tem uma parte de dentro, então, eu penso: "Bem, eu deveria olhar para a documentação e ver se existe alguma outra forma de desenhar uma curva assim". Então, para a máquina de documentação! Rolando para baixo, rolando para baixo, olhando por aqui... Então, olhando para a categoria de formas, a primeira entrada é arc, que é usado para desenhar um arco, o que soa perfeito, porque é isso que o sorriso é. Este aqui tem mais parâmetros. Eu vou começar colando isto aqui. Lembre-se: esses são parâmetros de exemplo, então, precisamos substituí-los pelo que achamos que devem ser. Certo, então x e y. Talvez x e y seja onde eu quero começar. A nossa metade é 200, talvez vamos começar em 150. O y é talvez 250, então, width parece ser a espessura do arco. É provavelmente um pouco menos que a espessura do próprio rosto. Talvez possa ser 200, então height talvez seja a altura a partir do topo do arco até a parte de baixo. Talvez seja 50. Agora, start e stop... Eu não sei o que essas coisas são. Ok, estou preso aqui, porque estou olhando para essa função, tentando usá-la, mas eu não compreendo realmente esses parâmetros. Bem, felizmente, o que você pode fazer é apenas descer de novo até os documentos e clicar na função em que você está interessado. Isso fará aparecer um programa que mostra como usá-la, e explica os parâmetros em mais detalhes. Olhando para isto, ele diz que x é a coordenada x do centro da elipse, derivada do arco. Então, para desenhar um arco, você tem que fingir que está desenhando uma elipse, mas apenas a parte dela, e calcular tudo baseado nisso. Então x e y é, na verdade, o centro dessa elipse de mentirinha que estamos fazendo. E width e height são a largura e a altura dessa elipse. E start e stop, que são os que eu ainda não sabia, start e stop são os ângulos. Ok! O ângulo com o qual o arco se inicia, em graus, e o ângulo onde o arco deve terminar. Nós podemos olhar para os exemplos que estão aqui e desenhar um arco sem fio de 1 a 270. Provavelmente é este cara aqui, porque de 1 grau a 270 graus ficaria mais ou menos assim. Vamos tentar mudar. Agora sim, isso faz sentido, certo? Porque, de 1 a 180... Isso é mais ou menos o que queremos, certo? Porque, não queremos um meio arco? Ok, então agora acho que entendo arc bem o suficiente para usá-la. Vamos voltar para o rosto. Vamos de zero a 180. Nós quase acertamos, mas o meu x e y estão errados. Porque eu não percebi que x é, na verdade, o meio da elipse. Está um pouquinho largo demais, então vamos reduzir isso. Eu tenho agora um sorriso de verdade! Usando a documentação, fui capaz de fazer o que eu queria muito mais facilmente, e esse é o objetivo da programação: transformar nossas ideias em realidade mais rapidamente. Lembre-se: o poder da documentação!