FR 2. Prise en main

Comment débuter

Installation

AJUI_Animate doit être installé dans le dossier composant (Components) de votre projet 4D avec un second composant fourni : AJ_Math fournissant des fonctions géométriques et mathématiques complémentaires.

Comment créer une animation

Le but de cet exemple d’animation consiste à faire rebondir un objet de formulaire 4D (rectangle) depuis sa position initiale.

Commençons par créer un formulaire dans lequel nous allons ajouter un objet 4D d’interface de type rectangle et un simple bouton.

Vous allez ensuite définir l’effet d’animation voulu.

Dans la méthode objet du Bouton du formulaire, nous allons écrire le code suivant :

C_OBJECT($animation)
$animation:=New Animation
$animation.target:="Rectangle"
$animation.bounce()

La méthode New Animation va retourner une variable objet 4D contenant l’ensemble des fonctions membres à disposition.

C_OBJECT($animation)
$animation:= New Animation

Dans cet objet, vous allez pouvoir éditer plusieurs propriétés qui dépendront du type d’effet utilisé (voir liste des fonctions membres et propriétés)

À présent il faut définir l’objet de formulaire qui sera l’objet à animer. Ici ce sera l’objet nommé "Rectangle":

$animation.target:="Rectangle"

Et enfin nous allons faire appel à la fonction membre "bounce" qui définira l’animation à effectuer :

$animation.bounce()

À présent nous allons lancer l’exécution de notre Formulaire et cliquer sur le bouton :

Miracle, vous venez de réaliser votre première animation !

Nous allons maintenant lancer deux animations simultanément. Pour cela nous allons ajouter un deuxième rectangle : "Rectangle1".

Dans la méthode objet du Bouton du formulaire, nous allons ajouter le code suivant :

C_OBJECT($animation)
$animation:=New Animation
$animation.target:="Rectangle"

C_OBJECT($animation2)
$animation2:=New Animation
$animation2.target:="Rectangle1"

$animation.bounceIn()
$animation2.bounceIn()

À présent nous allons lancer l’exécution de notre Formulaire.

En cliquant sur le bouton, vous pourrez voir les deux rectangles s’animer simultanément !

AJUI_Animate classe

Depuis la V18R3, vous pouvez remplacer l'instance retournée par New Animation par l'appel de la classe Animation. Les fonctions de la classe Animation utilisent les mêmes noms et les mêmes paramètres que pour les formules obtenable par New Animation. Les valeurs par défaut sont également les mêmes.

La seule différence en terme de code se trouvent lors de la création de l'instance :

  //avec les formules
    $myAnim:=new Animation ()

  //avec la classe
    $myAnim:= AJUI_Animate.new ()