NARRATE

Syntaxe

Description

Cette instruction permet d'émettre la forme phonèmes vers le haut-parleur.

Remarques

• La commande NARRATE énonce une chaîne de caractères étant une liste de codes de phonèmes. (Les phonèmes sont les petites unités de vitesse, constituant les syllabes et les mots de la langue parlée.) La chaîne de caractères peut être du texte anglais que vous avez converti en phonèmes avec la commande TRANSLATE$. Ou, vous pouvez créer votre propre chaîne de caractères de phonèmes pour que votre Amiga parle comme vous le souhaitez - même dans une autre langue. (La commande TRANSLATE$ ne peut convertir que du texte anglais.)
• En général, utilisez TRANSLATE$ lorsque vous voulez que votre Amiga prononce une chaîne de caractères générée dans un programme en cours d'exécution, comme la réponse d'un utilisateur à une commande INPUT. Créez vos propres chaînes de caractères phonèmes lorsque vous savez à l'avance ce que vous voulez que l'Amiga dise, afin que vous puissiez affiner la qualité de la voix et la diction. Avec la pratique, vous serez en mesure de traduire des mots en phonèmes rapidement et facilement.
• L'instruction NARRATE est en fait une fonction. Le ABasiC attribue une valeur de zéro à la variable entière spécifiée s'il ne trouve aucune erreur dans la chaîne de caractères phonèmes. Si ABasiC rencontre un phonèmes mal orthographié (un qu'il ne peut pas reconnaître), la variable contient la position de chaîne de caractères où NARRATE a trouvé l'erreur. En outre, le ABasiC place le code d'erreur de traduction approprié dans la variable système STATUS. (Non pas que la valeur de la fonction renvoyée ne soit pas valide si vous utilisez le mode de synchronisation 1).
• Votre Amiga prononce la chaîne de caractères de la manière que vous décrivez dans le tableau d'entiers spécifié, en utilisant les neuf paramètres décrits ci-dessous. Si vous souhaitez utiliser toutes les valeurs par défaut pour ces paramètres, omettez le nom du tableau. L'instruction NARRATE attribue automatiquement les valeurs par défaut.
• Vous trouverez ci-dessous une liste des paramètres des éléments du tableau et leurs descriptions :

Élément	Description
0 (pitch)	Cette élément permet d'indiquer qu'il n'y a pas de base pour la voix, en hertz. Spécifiez une valeur comprise entre 65 et 320. La valeur par défaut est 110 (voix masculine normale).
1 (inflection)	Cette élément permet d'indiquer une inflexion. Choisissez l'une des deux valeurs :
	Valeur	Description
	0	Cette valeur permet d'indiquer une inflexion et accentuation des syllabes (valeur par défaut).
	1	Cette valeur permet d'indiquer une voix monotone (semblable à un robot).
2 (rate)	Cette élément permet d'indiquer le taux de parole pour la voix, en mots par minute. Spécifiez une valeur comprise entre 40 et 400. La valeur par défaut est 150.
3 (voice)	Cette élément permet d'indiquer le parler avec la voix. Choisissez l'une des deux valeurs :
	Valeur	Description
	0	Cette valeur permet d'indiquer une voix masculine (par défaut).
	1	Cette valeur permet d'indiquer une voix féminine.
4 (tuning)	Cette élément permet d'indiquer la fréquence d'échantillonnage, en hertz. Ce paramètre contrôle les changements de qualité vocale. Spécifiez une valeur comprise entre 5000 (faible et grondant) et 28000 (élevé et grinçant). La valeur par défaut est 22200.
5 (volume)	Cette élément permet d'indiquer le volume. Spécifiez une valeur comprise entre 0 (pas de son) et 64 (le plus fort). La valeur par défaut est 64.
6 (channel)	Cette élément permet d'indiquer l'affectation des canaux pour la sortie vocale. Les canaux 0 et 3 vont à la sortie audio gauche et les canaux 1 et 2 vont à la sortie audio droite. La valeur par défaut est le code 10, attribuant toute paire de canaux gauche / droite disponible.
7 (mode)	Cette élément permet d'indiquer le mode de synchronisation. Spécifiez l'un des nombres entiers suivants :
	Valeur	Description
	0	Cette valeur permet d'indiquer une sortie vocale synchronisé. Le ABasiC attend la fin de l'exécution en cours de NARRATE avant d'exécuter d'autres commandes. La valeur renvoyée par NARRATE est valide. Ceci est la valeur par défaut.
	1	Cette valeur permet d'indiquer une sortie vocale désynchronisé. Le ABasiC commence à exécuter l'instruction NARRATE actuelle, puis reprend immédiatement le traitement des commandes suivantes. Le NARRATE renvoie toujours 0 dans le mode, bien que ce ne soit pas une valeur valide.
8 (control)	Cette élément permet d'indiquer le mode de contrôle du périphérique de narrateur. Ce paramètre indique à ABasiC comment gérer une deuxième instruction NARRATE pendant qu'il exécute une première. (Cela n'a de sens que si vous utilisez la sortie vocale désynchronisée - mode 1 dans le paramètre précédent - pour la première commande NARRATE.) Spécifiez l'un des nombres entiers suivants :
	Valeur	Description
	0	Cette valeur permet d'indiquer un traitement normalement. Le ABasic termine l'exécution de la première instruction NARRATE, puis exécute la seconde. C'est le mode par défaut.
	1	Cette valeur permet d'indiquer un arrêt de traitement de la parole ABasiC met immédiatement fin à la première instruction NARRATE. (Le deuxième NARRATE est un mannequin - la chaîne de parole et les autres paramètres sont inutilisés.)
	2	Cette valeur permet d'indiquer de remplacer le traitement. Le ABasiC interrompt immédiatement la première instruction NARRATE et exécute la seconde.



• Codes d'attribution de canal :

Valeur	Canal
0	0
1	1
2	2
3	3
4	0 et 1
5	0 et 2
6	3 et 1
7	3 et 2
8	soit le canal gauche disponible
9	soit le canal droit disponible
10	paires de canaux gauche / droite disponibles (par défaut)
11	n'importe quel canal unique disponible