likeprocessing 0.1.6

Like processing library with pygame

Structure du programme

Installation:

Dans pycharm :
CTRL+ALT+s, puis choisir project -> python interpreter et + puis likeprocessing

dans le terminal :
pip install likeprocessing

Les fonctions setup(), draw() et run(globals())

Le programme doit contenir deux fonctions, setup() et draw(), et l'exécution est lancée à l'aide de l'instruction run(globals()).

Lorsque l'on exécute l'instruction run(globals()), la fonction setup() est exécutée une fois :

from likeprocessing.processing import *
def setup():
    createCanvas(800,600)
    # instructions de paramétrage de l'affichage

Cette fonction permet de définir les dimensions de la fenêtre de tracé, et quelques paramètres initiaux. Les valeurs données aux paramètres de la fonction **createCanvas() ** sont affectées automatiquement à deux variables systèmes : width pour le premier paramètre et height pour le second. On peut récupérer les valeurs de width et height grâce au fonction width() et height()

Puis la fonction draw() est ensuite exécutée en boucle, après l'exécution de setup():

def draw():
    # instructions de dessin

Elle contient des instructions qui seront exécutées avec une fréquence réglable, permettant de modifier le contenu de la fenêtre et de créer des contenus statiques ou des animations.

L'instruction stop() met fin à l'exécution de la boucle :

def compute():
    # instructions de calcul

Cette fonction n'est pas obligatoire. Elle permet d'éviter de trop surcharger la fonction draw() en réservant celle-ci aux instructions de dessins. La fonction compute() si elle existe est insérée dans la boucle et est exécutée avant la fonction draw()

Structure de base :

from likeprocessing.processing import *

def setup():
   createCanvas(400,200)
   background("grey")

def draw():
   pass

run(globals())

Fonctions système

Fonctions	description
width(), height()	Dimensions de la zone de dessin. Les valeurs de width et height sont définies par les paramètres de la fonction createCanvas().

Rafraîchissement

Fonctions	description
frameCount()	Nombre d'images affichées depuis le démarrage du programme.
frameRate() \ getFrameRate()	Renvoie le nombre d'images affichées chaque seconde.
frameRate(valeur) \ setFrameRate(valeur)	Spécifie le nombre d'images à afficher chaque seconde.
noLoop()	Si cette instruction est présente dans la fonction setup la fonction draw sera exécutée une seule fois. Si cette instruction est présente dans la fonction draw, les instructions de la fonction draw en cours sont exécutées (il n'y a pas d'interruption) mais celle-ci ne sera pas appelée à nouveau.
loop()	Relance l'exécution en boucle de draw().

Couleurs

Désigner une couleur

syntaxe	description
'red'	nom de couleur
120	niveau de gris : 0 - 255
(100, 125, 255)	couleur r, v, b (décimal) : 0 - 255
'#2aff95'	couleur r, v, b (hexadécimal) : 00 - ff

Dessiner en couleur

Fonctions	description
background(couleur)	Définit la couleur d'arrière-plan de la zone de dessin (255 par défaut).
fill(couleur=None)	Définit la couleur de remplissage des formes (255 par défaut) et réactive le remplissage des formes. Sans paramètre seul le remplissage est activé (utile après un noFill())
get_fill()	Retour la couleur de fond actuelle
noFill()	Désactive la couleur de remplissage.
stroke(couleur)	Définit la couleur du tracé des bords des formes et des lignes("black" par défaut).
get_stroke()	retourne la couleur des bords actuelle
noStroke()	Désactive le tracé du contour des figures.
save_fill_stroke()	Sauvegarde les paramètres fill et stroke
restore_fill_stroke()	recharge les paramètres fill et stroke précédemment sauvegardé avec save_fill_stroke

Si noFill() et noStroke() sont exécutées en même temps, rien n'est tracé dans la zone de dessin.

Formes

Primitives 2d

L'origine du repère est située en haut à gauche. Les abscisses augmentent de gauche à droite, les ordonnées augmentent de haut en bas.

fonctions	description
point(x, y)	Trace un point de coordonnées (x, y). carré de 2x2 pixels
line(x1, y1, x2, y2)	Trace un segment reliant les deux points de coordonnées (x1, y1) et (x2, y2).
ellipse(x, y, largeur, hauteur)	Tracer une ellipse dont le centre a pour coordonnées (x, y) et dont la largeur et la hauteur prennent les valeurs fixées.
circle(x, y, diametre)	Trace un cercle dont le centre a pour coordonnées (x, y) et dont le diamètre prend la valeur fixée. Idem ellipse((x, y, diametre, diametre)
arc(x,y,largeur,hauteur,,angleDebut, angleFin)	Créer une portion d'ellipse type part de tarte qui pourra être rempli entre les points repérés par les angles angleDébut et angleFin (en radians). x et y sont les coordonnées du centre du cercle.
circle_arc(x,y,rayon,angleDebut, angleFin)	idem arc mais à partir d'un disque
ellipseMode(corners_center: str)	Définie la position des points x et y des fonctions basées sur ellipse. par défaut : "corners" x et y sont les coordonnées du point en haut à gauche du rectangle dans lequel est inscrit l'ellipse. si les paramètre est "center" x et y représente le centre du rectangle
rect(x, y, largeur, hauteur)	Créer un rectangle aux coordonnées x,y de largeur largeur et de hauteur. Sii rectMode('center') x et y sont les coordonnées du centre du rectangle. Si rectMode('corners') x,y sont les coordonnées du coin haut gauche. Le rectangle est rempli par la couleur définie par fill(couleur). Si le paramètre image est renseigné le fond du rectangle sera occupé pas l'image retaillée aux dimensions du rectangle sauf si largeur et/ou hauteur sont nulles (ou non renseignées). largeur et/ou hauteur seront alors celles de l'image. Les paramètres allign_h (left, center et right) et allign_v (top,center et bottom) permettent d'aligner l'image dans un cadre plus grand qu'elle.
square(x, y, cote)	Trace un carré dont le sommet en haut à gauche a pour coordonnées (x, y) et dont le côté prend la valeur fixée. fonctionnement idem rectangle
rectMode(corners_center: str)	Définie la position des points x et y des fonctions basées sur rect. par défaut : "corners" x et y sont les coordonnées du point en haut à gauche du rectangle. si les paramètre est "center" x et y représente le centre du rectangle
triangle(x1, y1, x2, y2, x3, y3)	Trace un triangle dont les trois sommets ont pour coordonnées (x1, y1), (x2, y2), et (x3, y3).
quad(x1, y1, x2, y2, x3, y3, x4, y4)	Trace un quadrilatère dont les quatre sommets ont pour coordonnées (x1, y1), (x2, y2), (x3, y3) et (x4, y4).
k_line(points)	trace un ligne brisée à partir d'une liste de points [[1,2],[5,6],[8,3],.....]. (nb_point = nb_segments + 1)

Tracés

fonctions	description
strokeWeight(epaisseur)	Définit l'épaisseur du tracé en pixels (par défaut : 1 pixel).
noStroke()	Désactive le tracé du contour des figures.
stroke(couleur)	Définit la couleur du tracé des bords des formes et des lignes ("black" par défaut). Si aucune valeur n'est passée, celle-ci retourne la couleur actuelle.

Textes

fonctions	description
text(chaine, x, y)	Affiche la chaîne à la position (x, y) dans une boite ajustée. couleur, largeur bord et couleur bord de la boite idem formes.
text(chaine, x, y, largeur, hauteur)	Affiche la chaîne à la position (x, y) dans une boite de dimensions largeur x hauteur. couleur, largeur bord et couleur bord de la boite idem formes.
textAlign(alignement_horizontal) textAlign(alignement_horizontal, alignement_vertical)	Spécifie l'alignement horizontal parmi LEFT, CENTER, et RIGHT et l'alignement vertical parmi TOP, BOTTOM, CENTER, et BASELINE
textFont(police) textFont(police, taille)	Spécifie la police de caractères et éventuellement sa taille
textSize(taille)	Spécifie la taille de la police de caractères
textStyle(style)	Spécifie le style parmi NORMAL, ITALIC, BOLD et BOLDITALIC
textWidth(chaine)	Largeur en pixels de l'affichage de chaîne, dans la police et taille actuelles

Événements

Touches du clavier

fonctions	description
key()	état des touches du clavier (list)
keyCode()	Code de la dernière touche appuyée.
keyIsPressed() isKeyPressed()	Vaut True lorsqu'une touche du clavier est appuyée et False sinon.
keyIsDown(code) keyIsDown(touche)	Vaut True si la touche concernée est appuyée et False sinon.

Souris

fonctions	description
mouseX(), mouseY()	Coordonnées du pointeur de la souris
mouseXY()	Coordonnées du pointeur de la souris sous forme de tuple
mouseIsPressed()	Vaut True si la souris est cliquée, et False sinon.
fill_mouse_on(couleur:str)	Change la couleur des formes quand on passe la souris dessus. Non actif par défaut.
noFill_mouse_on()	annule l'effet de fill_mouse_on()

Mathématiques

Angles

fonctions	description
angleMode(mode_angle:str)	Définit l'unité de mesure des angles. \ 'rad' les angles des fonctions trigonométriques seront pris comme des radians (défaut) \ 'deg' les angles des fonctions trigonométriques seront pris comme des degrés \ 'grd' les angles des fonctions trigonométriques seront pris comme des grades \ Une exception est levée en cas d'erreur de paramètre si mode_angle == "" la valeur de mode est retournée (str)
cos(), sin(), tan(), acos(),asin(),atan(),atan2()	Fonctions trigonométriques usuelles l'unité considérée sera celle choisie avec angleMode(). atan2 : même fonctionnement que la fonction math.atan2 mais l'unité de l'angle retourné dépend de angleMode()
degrees(mesure) \ radians(mesure) \ grades(mesure)	Convertit une mesure d'angle en degrés, en radians ou en grades. l'unité de mesure dépend de angleMode().
HALF_PI, PI, QUARTER_PI, TWO_PI	Constantes permettant respectivement d'approcher les valeurs de π/2, π, π/4, 2π

Géométrie

fonctions	description
dist(x1,y1,x2,y2)	retourne la distance entre deux points

Images

fonctions	description
loadImage(chemin)	Charge une image à partir d'un chemin et crée un objet Image. Si nécessaire, l'image peut être préchargée en plaçant l'appel à la fonction loadImage dans la fonction preload.
background(Image)	Affiche une Image en fond d'écran
image(image, x, y)	Affiche une Image en plaçant le pixel en haut à gauche au point de coordonnées (x, y) dans la zone de dessin.
copy_image(picture: Image, rect=None) -> Image	retourne une copie de picture ou une partie de picture au dimensions de rect
get_pixel_color(picture: Image, pos: tuple) -> tuple	retourne la valeur de la couleur d'un pixel d'une image (picture) sous la forme d'un tuple

Transformations

fonctions	description
translate(x,y)	applique une translation à toutes les fonctions de dessin et d'image. x et y sont des valeurs relatives qui s'ajoutent aux translations précédentes. La translation est remise à zéro avant chaque exécution de la fonction draw().
get_translate()	retourne la valeur de la translation sous la forme d'un tuple (x,y)
init_translate()	Force la remise à zéro de la translation. (A utiliser dans la fonction draw() en cas de besoin
rotate(angle,axis)	applique une rotation <angle> par rapport à <axis>. à toutes les fonctions de dessin et d'image. angle est une valeur absolue. Par défaut axis vaut (0,0)
flip_h(axe_h)	entraîne une symétrie horizontale par rapport à la droite y = axe_h
flip_v(axe_v)	entraîne une symétrie verticale par rapport à la droite x = axe_v

Temporisations

fonctions	description
t=Tempo(duree_ms)	t=Tempo(500) créer un objet de temporisation t de durée 500 ms qui se relance indéfiniment.
t.fin()	renvoie True lorsque la temporisation est terminée. Pour notre exemple au bout de 500 ms.
t.is_on()	renvoie True si la temporisation est à on.
t.is_off()	renvoie True si la temporisation est à off.
t.set_tempo(duree_ms)	permet de réinitialiser la temporisation avec une nouvelle valeur.