NOM: Play - Scroll


SYNTAXE: Scroll ( [sourceX/0], [sourceY/0], [largeur/maxi],  
[hauteur/maxi], [destX/0], [destY/0], [vitesse/10],  [direction/0] )


DESCRIPTION: Commande du serveur de fonctions AREXX 'Play'.

Scroll() copie un rectangle de la coulisse sur la scène, en  
utilisant un fondu qui fait glisser le rectangle de la scène ce  qui 
révéle celui de la coulisse.


PARAMETRES:

- SOURCE X, SOURCE Y: coordonnées du coin supérieur gauche  du 
rectangle source. Par défaut il s'agit du coin  supérieur gauche de 
l'écran, soit SourceX = 0 et  sourceY = 0.

- LARGEUR, HAUTEUR: sont les dimensions du rectangle copié.  Les 
valeurs par défaut sont respectivement la largeur et  la hauteur 
maximales, compatibles avec les dimensions des  images. Une image de 
320x256 donnera comme valeur par  défaut Largeur = 320 et 
Hauteur = 256.

- DEST X, DEST Y: coordonnées du coin supérieur gauche du  
rectangle destination. Par défaut il s'agit du coin  supérieur gauche 
de l'écran, soit DestX = 0 et DestY = 0.

- VITESSE: indique le nombre d'images intermédiaires  utilisées 
pour rendre l'effet du fondu.

Par défaut la valeur est 10.

Plus la valeur est grande, plus le fondu est lent.

- DIRECTION: détermine le sens de progression: 

DIRECTION = 0 vers la droite (défaut)

DIRECTION = 1 vers la droite en montant

DIRECTION = 2 vers le haut

DIRECTION = 3 vers la gauche en montant

DIRECTION = 4 vers la gauche

DIRECTION = 5 vers la gauche en descendant

DIRECTION = 6 vers le bas

DIRECTION = 7 vers la droite en descendant


REMARQUES: La vitesse n'est plus significative au delà d'une  
valeur supérieure au double de la dimension de la  zone d'effet.

A la différence du balayage (Wipe()), la portion  d'image 
présente dans le rectangle destination  n'est pas recouverte par le 
rectangle source mais  poussée dans le sens de la progression du  
rectangle source.


RETOUR: Aucun.

VOIR: Wipe().


EXEMPLE:

/* Reproduit les 8 directions de l'effet SCROLL */

LOAD('image:image1') /* charge l'image en coulisse */

DISPLAY() /* Affiche l'image pour avoir la bonne résolution  
d'écran. */

CLEAR() /* efface l'écran */

do i=0 to 7

SCROLL(41,0,237,255,41,0,50,i)

end