La puissance de la documentation

OK. Bon ! Vous avez fait quelques programmes... Vous vous demandez : "Comment puis-je retenir... ... toutes ces fonctions ?" Est-ce que c'est "ovale" ou "cercle" ou "ellipse" ? Est-ce que c'est largeur puis hauteur ou hauteur puis largeur ? Est-ce que j'ai besoin de retenir tout ça ? Heureusement... Non. L'ordinateur va nous aider pour ça aussi. Pour coder, vous avez besoin d'un ordinateur... ... et il est parfait pour se souvenir de tout cela, ... bien mieux que nous ! Donc on va le laisser se souvenir de tout ça ! et, nous, on va l'utiliser comme un dictionnaire pour coder. On va donc se concentrer sur la création de programmes intéressants, pas sur la mémorisation de tous ces détails ennuyeux. C'est ce qu'on appelle : la documentation. C'est un document qui explique comment coder avec un langage de programmation, avec des exemples et des conseils. Donc si on ne se souvient pas d'un détail, pas de problème, allons voir la documentation ! C'est ennuyeux de lire la documentation, c'est vrai... c'est beaucoup plus sympa d'écrire du code ! Mais à moins de retenir absolument tout (!), vous aurez besoin d'utiliser la documentation pour coder vos idées. Même les meilleurs programmeurs n'essaient pas de tout retenir ! En fait, ce sont ceux qui savent le mieux UTILISER la documentation. Par exemple, je veux dessiner un visage souriant, et j'ai déjà fait le visage et les yeux avec "ellipse", ... ... une fonction que je connais plutôt bien. Mais il faut que je complète ça maintenant. D'abord, je veux un bord plus épais. Je me souviens que c'est avec une fonction ... qui ressemble à "stroke" quelque chose... mais je ne me souviens plus très bien. Donc au lieu d'attendre que ça me revienne, (ça peut prendre trop de temps !)... je vais voir la documentation. Et j'essaye d'y trouver ce que je cherche. Je regarde dans la catégorie "Couleurs" car ça y ressemble, et je retrouve toutes les fonctions... ici. et à la fin, je trouve "strokeWeight" : pour "modifier l'épaisseur des lignes et des contours" Donc... ici... on voit le nom de la fonction et ses paramètres, ... juste un paramètre pour celle-la. Donc, ce que je fais souvent, c'est de copier ce code... ... et le coller dans mon programme. Mais j'ai une erreur : "épaisseur n'est pas défini". C'est parce que "épaisseur" est le nom du paramètre, ce n'est pas une valeur. Je dois donc remplacer ça par la valeur que je veux utiliser, ça peut être un nombre ou une variable qui contient un nombre. Dans mon cas, je mets juste un nombre. Ha ! OK.... 10 c'est bien. On peut modifier ça et voir ce que ça donne. Bon... c'est un peut trop... ... là c'est trop fin... OK. prenons... 12. Cool ! Maintenant, il manque quand même quelque chose d'important : le sourire ! Donc, il faut que je fasse quelque chose comme... ça ! à peu prêt ! Et quand je le regarde, Est-ce que ça ressemble à un truc que j'ai dessiné, avec une ellipse, une ligne ou un rectangle ? Car il y a une courbe mais sans rien d'autre. Bon, le réflexe, c'est d'aller voir dans la doc... pour voir s'il y a quelque chose pour dessiner ça. Allons-y... maintenant ! On regarde un peu... plus bas... on cherche... Regardons la catégorie des "Formes" Haha ! Une des fonction est "arc", pour dessiner un arc d'ellipse. Hum... ça semble bon... car c'est ce qu'on veut pour notre sourire. Cette fonction a beaucoup plus de paramètres. Je copie et colle le code... ici... Alors... on doit remplacer les paramètres, avec les valeurs qui vont correspondre. OK... commençons par "x" et "y". C'est peut être l'endroit où je veux que ça commence. Donc, disons... notre milieu est à 200, essayons de commencer à 150. Donc, pour "y", essayons... 250. Maintenant, "w" c'est souvent la largeur, la largeur de l'arc, donc prenons une largeur plus petite que celle du visage. Essayons... 200. Et donc, "h", c'est probablement la hauteur du haut au bas de l'arc... donc essayons... 50. "début" et "fin"... Je ne vois pas à quoi cela correspond... Ha... Je suis bloqué. Mais j'ai besoin de l'utiliser, et je ne comprends pas ces 2 paramètres. OK... Donc retournons voir la doc, et on clique sur la fonction qui nous intéresse. Cela affiche un programme qui nous montre comment l'utiliser et des explications pour chaque paramètre plus dans le détail. En regardant ça, cela explique que, "x" est la coordonnée x du centre de l'ellipse complète... ... formée par l'arc OK. donc cela veut dire que dessiner un arc, ... ressemble à dessiner une ellipse, ... mais seulement une partie de l'ellipse, et indiquer les paramètres en fonction de ça. Donc "x" et "y" est le centre de l'ellipse, le "w" et le "h" sont la largeur et la hauteur de l'ellipse, et "début" et "fin" sont les 2 que je ne connaît pas. "début" et "fin" sont les angles...Ha ! OK. "début" est l'angle, en degré, pour commencer l'arc, et "fin" est l'angle pour terminer l'arc. On peut regarder les exemples... ici. Dessin d'un arc sans couleur de remplissage de 1 jusqu'à 270... c'est probablement celui-là ! car de 1 degré à 270 degrés, ça ressemble à ça... Essayons de changer ça. Et voila... On comprends mieux... car de 1 à 180, c'est ce qu'on veut, en fait ! car on veut un demi-arc. OK. Donc maintenant je comprends assez la fonction pour l'utiliser. Revenons à mon visage. Bon, on va partir de 0, jusqu'à 180, et... hey ! c'est pas trop mal ! mes "x" et "y" ne sont pas bons car... ils doivent représenter le centre de l'ellipse. Et c'est un peu trop large, donc, réduisons ça. Ha Ha ! J'ai un vrai visage souriant maintenant ! Grâce à la doc Elle m'a permis de faire ce que je voulais rapidement. Et c'est un objectif quand on code : c'est réaliser ses idées... rapidement. Souvenez-vous : utilisez la documentation !