ColorTerm 2.3

Catégorie / Domaine : Interface
Compatibilité SCOL Voy@ger : V 3.5 et supérieure
Mise à jour : 10/2003

Fonction

Le module COLORTERM est un module de communication : il permet aux utilisateurs de dialoguer en temps réel (Chat) via une fenêtre de terminal avec texte en couleur, ligne d’édition et un système de macros permettant de mémoriser certaines phrases.
En l'associant au module LoginP4, il permet de mettre son pseudonyme en "away" (absent) et d'en informer les autres visiteurs via le chat.

Configuration


Figure 1 : Interface du module Colorterm

Pour chacune des options ci-dessous, il faut cliquer sur le carré de couleur pour changer celle-ci.

Couleur de fond => Couleur de fond de la fenêtre de Chat

Couleur des messages systèmes> => Couleur des messages systèmes commençant par >.

Couleur des mes. systèmes>> => Couleur des messages systèmes commençant par >>.

Couleur du nom de login utilisateur => Couleur des logins des utilisateurs

Couleur des messages d’actions => Couleur des messages d’action (macros)

Couleur aléatoire des messages => Liste de 8 couleurs aléatoirement attribuées aux utilisateurs n’ayant pas encore choisi de couleur

Couleur pour les autres utilisateurs => Couleur par défaut des autres utilisateurs

Couleur alternative pour les autres => Seconde couleur par défaut des autres utilisateurs

Couleur de texte de saisie => Couleur de saisie des messages

Autre couleur de texte => Couleur pour les autres types de messages, notamment ceux provenant d'autres modules ou de l'action privateInfo

Bouton de présence => Si coché, affiche un bouton à la droite de la ligne de saisie. Celui-ci permet à l'utilisateur d'indiquer son absence du chat.

Fichier de macros => Nom du fichier des macros. Un fichier par défaut est prédéfini.

Mise en oeuvre

Ouvrez l'arbre de création du SCS. Sélectionnez le dossier Interf puis double-cliquez sur colorTerm 2.1.
Etablissez les liens nécessaires au projet.

Les trois liens ci-desous sont impératifs pour utiliser le module, ce qui implique, entre autres, qu'un utilisateur devra être entré dans une cellule 3d pour qu'il soit actif.
shell.start à Colorterm.start
C3D3.hear à Colorterm.privateMsg
Colorterm.command à C3D3. !speak

Action Fonction
shell.start à Colorterm.start Démarre et affiche le module COLORTERM chez le client
C3D3.hear à Colorterm.privateMsg Permet de restituer un message chez un client particulier
module.événement à Colorterm.destroy Détruit le module COLORTERM chez le client
module.événement à Colorterm.broadMsg Permet de restituer un message chez tous les clients
module.événement à Colorterm.privateInfo Restitue une information à un client particulier (ne gère pas les espaces : insérer des \ avant chaque espace du message).
La chaîne attendue est du type :
"texte police taille couleur flag" avec ‘texte’ comme élément obligatoire.

Les autres paramètres sont pris dans l'ordre s’ils sont présents. En cas de problème, ce sont des valeurs par défaut qui sont utilisées. La police doit être spécifiée, par exemple :
Arial pour arial
La taille doit être donnée au format décimal.
La couleur peut aussi être paramétrée, sous forme décimale : 7829367 pour 0x777777

On peut utiliser une chaîne « texte police » par exemple mais pas une chaîne « texte taille », les éléments de la chaîne devant se suivre sans rompre la chaîne.

D’autres flags peuvent être incorporés, Flag peut prendre l'une des valeurs suivantes, valeurs qui peuvent être cumulées pour combiner les effets :
[rien] pour normal
1 pour Souligné
2 pour Gras
4 pour Italique
8 pour Barré

module.événement à Colorterm.broadInfo

Restitue une information à tous les clients (ne prend pas en compte les espaces). Voir privateInfo, ci-dessus.

module.événement à Colorterm.registerExtMacro Ajoute une macro externe sans passer par un fichier de configuration. Attend un paramètre du type :
‘originCat shortcut info flag’

A utiliser avec le module IRC

module.événement à Colorterm.unregisterExtMacro

Enlève une macro externe sans passer par un fichier de configuration. Ne prend que les paramètres :
‘originCat shortcut’

A utiliser avec le module IRC

module.événement à Colorterm. !ChgLogin Tout changement de pseudonyme est pris en compte dans le module COLORTERM (à relier au module Login ou LoginPx).
module.événement à Colorterm.ignLogOut Permet au module COLORTERM de prendre en compte les actions disponibles dans le module Ignore
module.événement à Colorterm. !addCommand Permet d’ajouter une commande spécifique dans la zone de saisie du module
module.événement à Colorterm.getDialogS Obsolète
module.événement à Colorterm.getDialog Obsolète

Evénement Fonction
Colorterm.command à C3D3. !speak à module Action Permet d’envoyer les messages vers les avatars connectés
Colorterm.entering à module Action Engendre une action à l’entrée dans le module
Colorterm.destroyed à module Action

Engendre une action à la fermeture du module

Colorterm.extMacroCommand à module Action Action déclenchée lors de la saisie d'une macro
Colorterm.in à module Action L’initialisation du module engendre une action
Colorterm.away à module Action  A relier  à l'action du même nom du module Loginp4
Colorterm.back à module Action  A relier  à l'action du même nom du module Loginp4

Zone Fonction Interface Affectation
ColorTerm.colorTerm Interface permettant d’envoyer et de recevoir des messages Client Oui