La classe Alpha

L'objet NodeComponent Alpha apporte des méthodes pour convertir une valeur temporelle en un coefficient réel compris entre 0 et 1 selon une fonction f(t) où t est le temps. Une utilisation usuelle de l'objet Alpha consiste à générer des valeurs pour les behaviors Interpolator.

La fonction f(t) et les caractéristiques de l'objet Alpha sont déterminées par des paramètres définis par l'utilisateur:

loopCount: Nombre de fois où cet Alpha est exécuté. Une valeur de -1 indique un nombre d'exécutions infini.
triggerTime: Durée en millisecondes entre le lancement du système est la première activation de l'objet Alpha. Si (startTime+trigerTime >= currentTime) alors l'Alpha est lancé sitôt que possible.
phaseDelayDuration: Nombre de millisecondes attendues après le triggerTime avant de lancer cet Alpha.
mode: Peut être configuré avec INCREASING_ENABLE, DECREASING_ENABLE ou une combinaison des deux. INCREASING_ENABLE active les paramètres croissants d'un Alpha. DECREASING_ENABLE active les paramètres décroissants d'un Alpha.

Paramètres croissants d'un Alpha:

increasingAlphaDuration: Période durant laquelle l'Alpha passe de 0 à 1.
increasingAlphaRampDuration: Contrôle de la forme de courbe de l'Alpha croisant:
- si increasingAlphaRampDuration égal 0: Phase de croissance linéaire.
- si increasingAlphaRampDuration entre 0 et increasingAlphaDuration/2: Accélération constante pendant les increasingAlphaRampDuration premières millisecondes après le début de la phase d'accélération. Décélération constante pendant les decreasingAlphaRampDuration dernières millisecondes de la phase d'accroissement.
- si increasingAlphaRampDuration > increasingAlphaDuration/2: Seuillage à increasingAlphaDuration/2.
alphaAtOneDuration: Période pendant laquelle un Alpha reste à 1.

Paramètres décroissants d'un Alpha:

decreasingAlphaDuration: Période durant laquelle l'Alpha passe de 1 à 0.
decreasingAlphaRampDuration: Contrôle de la forme de courbe de l'Alpha décroisant:
- si decreasingAlphaRampDuration égal 0: Phase de décroissance linéaire.
- si decreasingAlphaRampDuration entre 0 et decreasingAlphaDuration/2: Décélération constante pendant les decreasingAlphaRampDuration premières millisecondes de la phase de décroissance. Accélération constante pendant les decreasingAlphaRampDuration dernières millisecondes de la phase de décroissance.
- si decreasingAlphaRampDuration > decreasingAlphaDuration/2: Seuillage à decreasingAlphaDuration/2.
alphaAtZeroDuration: Période pendant laquelle un Alpha reste à 0.

Constructeur

Alpha(): Construit un objet Alpha avec tous ses paramètres à leur valeur par défaut.

Alpha(int loopCount, int mode, long triggerTime, long phaseDelayDuration, long increasingAlphaDuration, long increasingAlphaRampDuration, long alphaAtOneDuration, long decreasingAlphaDuration, long decreasingAlphaRampDuration, long alphaAtZeroDuration): Construit un objet Alpha avec configuration de tous ses paramètres.

Alpha(int loopCount, long increasingAlphaDuration): Construit un objet Alpha avec ses paramètres à leur valeur par défaut sauf pour loopCount et increasingAlphaDuration qui sont initialisés avec les paramètres d'entête.

Alpha(int loopCount, long triggerTime, long phaseDelayDuration, long increasingAlphaDuration, long increasingAlphaRampDuration, long alphaAtOneDuration): Construit un objet Alpha avec initialisation des paramètres pour le mode INCREASING_ENABLE.

Valeur rendue	Nom et paramètres
boolean	finished(): Indique si l'Alpha a fini son nombre de boucles.
long	getAlphaAtOneDuration(): Retourne l'alphaAtOneDuration.
long	getAlphaAtZeroDuration(): Retourne l'alphaAtZeroDuration.
long	getDecreasingAlphaDuration(): Retourne le decreasingAlphaDuration.
long	getDecreasingAlphaRampDuration(): Retourne le decreasingAlphaRampDuration.
long	getIncreasingAlphaDuration(): Retourne l'increasingAlphaDuration.
long	getIncreasingAlphaRampDuration(): Retourne l'increasingAlphaRampDuration.
int	getLoopCount(): Retourne le loopCount.
int	getMode(): Retourne le mode.
long	getPhaseDelayDuration(): Retourne le phaseDelayDuration.
long	getStartTime(): Retourne le startTime (instant de base relatif pour l'ensemble des périodes de temps gérées). La valeur par défaut pour startTime est l'heure de démarrage du système.
long	getTriggerTime(): Retourne le triggerTime.
void	setAlphaAtOneDuration(long alphaAtOneDuration): Configure l'alphaAtOneDuration.
void	setAlphaAtZeroDuration(long alphaAtZeroDuration): Configure l'alphaAtZeroDuration.
void	setDecreasingAlphaDuration(long decreasingAlphaDuration): Configure le decreasingAlphaDuration.
void	setDecreasingAlphaRampDuration(long decreasingAlphaRampDuration): Configure le decreasingAlphaRampDuration.
void	setIncreasingAlphaDuration(long increasingAlphaDuration): Configure l'increasingAlphaDuration.
void	setIncreasingAlphaRampDuration(long increasingAlphaRampDuration): Configure l'increasingAlphaRampDuration.
void	setLoopCount(int loopCount): Configure le loopCount.
void	setMode(int mode): Configure le mode.
void	setPhaseDelayDuration(long phaseDelayDuration): Configure le phaseDelayDuration.
void	setStartTime(long startTime): Configure le startTime (instant de base relatif pour l'ensemble des périodes de temps gérées). La valeur par défaut pour startTime est l'heure de démarrage du système.
void	setTriggerTime(long triggerTime): Configure le triggerTime.
float	value(): Retourne la valeur de l'Alpha calculée à partir des ses paramètres et de l'heure courante.
float	value(long atTime): Retourne la valeur de l'Alpha calculée à partir des ses paramètres et de l'heure passée en paramètre.

Valeur	Champ
static int	DECREASING_ENABLE: La phase de décroissante de l'Alpha est activée.
static int	INCREASING_ENABLE: La phase de croissante de l'Alpha est activée.

Retour