PANORAMIC: MANUEL UTILISATEUR

POUR LA VERSION 0.9.28

PARTIE 4 - SCENE2D ET SPRITES


1 - GESTION DES SPRITES


1 - GESTION DES 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.

Haut de page

1.1 - Créer

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.

Haut de page

1.2 - Charger une image

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.

Haut de page

1.3 - Charger un texte

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.

Haut de page

1.4 - Traitement d'image

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.

Haut de page

1.5 - Supprimer

SPRITE_DELETE N Supprime le SPRITE numéro N.

Haut de page

1.6 - Visualiser ou cacher

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.

Haut de page

1.7 - Positionner

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

Haut de page

1.8 - Mise à l'échelle

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.

Haut de page

1.9 - Obtenir la position

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.

Haut de page

1.10 - Divers

NUMBER_SPRITES Retourne le nombre de SPRITEs.
SPRITE_EXISTS(N)

Retourne 1 si le SPRITE numéro N existe, 0 sinon.

Haut de page


Dernière mise à jour: 25 juin 2018