POUR LA VERSION 0.9.28
PARTIE 4 - SCENE2D ET SPRITES
Un SPRITE est une image qui peut
être déplacée sur un SCENE2D
sans le perturber, et dont la couleur noire est dite transparente.
Un SPRITE doit être créé.
Quand il existe, il peut alors recevoir une image (au format BMP), être
déplacé, agrandi, caché, visualisé à nouveau,
détruit.
Pour toutes les commandes suivantes, N est le numéro du SPRITE.
SPRITE N | Crée le SPRITE numéro N dans le SCENE2D "cible" |
SPRITE_CREATE_SHOW |
Les prochains SPRITEs créés seront visibles |
SPRITE_CREATE_HIDE |
Les prochains SPRITEs créés ne seront pas visibles |
Le SCENE2D "cible" est
l'objet système qui visualise des SPRITEs.
C'est:
- le seul SCENE2D existant dans le cas où il n'y a qu'un seul SCENE2D,
- le premier SCENE2D créé dans le cas où il y a plusieurs SCENE2Ds et qu'aucun n'a été désigné comme "cible",
- le SCENE2D qui a été désigné comme "cible" par une commande SPRITE_TARGET_IS dans le cas où il y a plusieurs SCENE2D.
SPRITE_FILE_LOAD N, F | Charge dans le SPRITE numéro N l'image (BMP) contenue dans le fichier F |
SPRITE_IMAGE_LOAD N1, N2 | Charge dans le SPRITE numéro N1 l'image contenue dans l'objet système de numéro N2. |
Le fichier F est défini soit par un chemin absolu, soit en relatif au répertoire courant.
SPRITE_TEXT N, T | Le SPRITE
numéro N affiche le texte T. Le texte est visualisé avec la police, la taille, la couleur et le style définis pour le SCENE2D. |
SPRITE_BRIGHTNESS N,V | Modifie la luminosité du SPRITE numéro N. |
SPRITE_CONTRAST N,V | Modifie le contraste du SPRITE numéro N. |
SPRITE_GAMMA N,V | Modifie le gamma du SPRITE numéro N. |
Pour ces 3 commandes, V doit être entre -128 et 127.
A chaque fois qu'une commande est exécutée:
- si V=0, l'image reste inchangée,
- si V<0, sa luminosité ou son contraste ou son gamma diminue,
- si V>0, sa luminosité ou son contraste ou son gamma augmente.
SPRITE_DELETE N | Supprime le SPRITE numéro N. |
SPRITE_SHOW N | Visualise le SPRITE numéro N. |
SPRITE_HIDE N | Cache le SPRITE numéro N. |
SPRITE_SHOW_ALL | Visualise tous les SPRITE. |
SPRITE_HIDE_ALL | Cache tous les SPRITE. |
L'état par défaut d'un SPRITE à sa création est: visible.
SPRITE_X_POSITION N, X | Positionne en X le SPRITE numéro N. |
SPRITE_Y_POSITION N, Y | Positionne en Y le SPRITE numéro N. |
SPRITE_POSITION N, X, Y | Positionne en X et Y le SPRITE numéro N. |
La position d'un SPRITE est celle du coin supérieur gauche de son image, elle est exprimée en pixels.
Les coordonnées X et Y sont situées sur le SCENE2D auquel le SPRITE appartient, et sont des coordonnées "écran":
- l'origine (0,0) est le coin supérieur gauche du SCENE2D
- l'axe des X est un axe horizontal partant de l'origine: X devient de plus en plus positif lorsqu'on se déplace vers la droite
- l'axe des Y est un axe vertical partant de l'origine: Y devient de plus en plus positif lorsqu'on se déplace vers le bas
SPRITE_X_SCALE N, CX | Fait rétrécir ou dilater la largeur
du SPRITE numéro N. Rétrécir si CX <1, dilater si CX > 1 |
SPRITE_Y_SCALE N, CY | Fait rétrécir ou dilater la hauteur
du SPRITE numéro N. Rétrécir si CY <1, dilater si CY > 1 |
SPRITE_SCALE N, CX, CY | Fait rétrécir ou dilater la largeur et la hauteur du SPRITE numéro N. |
SPRITE_X_POSITION(N) | Retourne la position en X (coordonnée sur X) du SPRITE numéro N. |
SPRITE_Y_POSITION(N) | Retourne la position en Y (coordonnée sur Y) du SPRITE numéro N. |
NUMBER_SPRITES | Retourne le nombre de SPRITEs. |
SPRITE_EXISTS(N) |
Retourne 1 si le SPRITE numéro N existe, 0 sinon. |
Dernière mise à jour: 25 juin 2018