Documentation

Version	1.14

	Ce documument explique le fonctionnement de l'interface graphique. Il est écrit de façon générale car il s'applique à plusieurs applications de jeux d'aventures. Pour la documentation spécifique à cette application, on doit lire le document 'LisezMoiAussi.rtf', s'il existe.

Application

	L'application est soit 32 bits, soit 64 bits Intel.

Système minimum requis

	MacOsX 10.4 pour la version 32 bits.
	MacOsX 10.6 pour la version 64 bits.

	Ce programme a été developpé et testé sur MacOsX version 10.6.8 (Snow Leopard). Il fonctionne aussi sur les versions 10.11.6 (El Capitan), 10.12.6 (Sierra) et 10.13.2 (High Sierra). Il devrait aussi fonctionner sur les versions intermédiaires.

Interpréteur

	Dans ce texte, le terme 'interpréteur' désigne la partie du programme qui 'joue' l'aventure.

Fenêtre texte

	La fenêtre texte affiche le texte produit par l'interpréteur. Ce texte ne peut pas être modifié.

	La fenêtre permet aussi d'entrer les commandes à envoyer à l'interpréteur. Ce texte est entré après l'invite. Il peut être entré et modifié comme expliqué dans la section Édition.

	Certains interpréteurs supportent aussi une vue de statut qui affiche le nom du lieu et d'autres informations comme le score, le nombre de tours joués ou certains commentaires à propos de l'expérience du joueur.

	Le nom de la fenêtre est celui de l'aventure. Par contre, si l'interpréteur supporte une vue de statut avec le nom du lieu, le nom du lieu est ajouté au nom de l'aventure. Le nom de la fenêtre est alors 'Nom de l'aventure - Nom du lieu'.

	Les polices normalement utilisées peuvent être vues en affichant les préférences. Si certaines polices ne sont pas disponibles sur votre système, elles ont été remplacées par des polices utilisées par le système mais leur nom n'est pas reflété dans les préférences.

Édition

	Les fonctions Couper, Copier et Coller agissent normalement si le curseur est dans la ligne de commandes, soit après l'invite. Si le curseur est en avant de la fin de l'invite:

	Couper est transformé en Copier.
	Copier agit normalement.
	Coller ajoute le texte à coller à la fin de la ligne de commandes.

	Si vous double cliquez un mot dans le texte,
		et que la ligne d'entrée est vide,
			la commande 'take mot' est automatiquement envoyée à l'interpréteur.
		Mais si la clef 'alt' est aussi pressée,
			la commande 'examine mot' est automatiquement envoyée à l'interpréteur.
		Mais s'il y a du texte déjà entré,
			le mot est inséré dans la ligne d'entrée, au point d'insertion.

	Les flèches 'vers la gauche' et 'vers la droite' déplacent le curseur dans la ligne éditée.

	Les flèches 'vers le haut' et 'vers le bas' permettent de naviguer dans l'historique des commandes précédentes. Le texte d'une ligne d'historique peut être édité. L'historique mémorise les 100 dernières commandes au maximum.

Clavier numérique

	L'application affiche un clavier numérique virtuel simulant un vrai clavier numérique. En cliquant sur une clef virtuelle, celle-ci devient sélectionnée et les boutons 'Exécuter' et 'Éditer' deviennent actifs. 'Exécuter' place la commande dans la ligne d'entrée. 'Éditer' permet d'éditer le texte de la clef.

	Double cliquer sur une clef est un raccourci pour le bouton 'Exécuter'. Double cliquer sur une clef en maintenant la clef 'alt' enfoncée est un raccourci pour le bouton 'Éditer'.

	Si vous possédez un clavier étendu, vous pouvez utiliser directement le clavier numérique physique pour transmettre les commandes des clefs à l'interpréteur.

	Les clefs déjà définies et les clefs en gris pâle peuvent être éditées. Les clefs en gris foncé ne peuvent pas être éditées. L'édition se fait directement dans le rectangle de la clef.

	Entrez le texte de la clef et terminez l'édition par un retour. S'il y a du texte, celui-ci est affiché dans la clef sur fond blanc. S'il n'y a aucun texte, la couleur du fond de la clef devient gris pâle.

	Par défaut, le caractère retour est conservé à la fin du texte, de telle sorte que la commande soit automatiquement envoyée à l'interpréteur. Mais si le dernier caractère avant le retour est un espace, le retour est enlevé, de sorte que la commande est inscrite dans la ligne d'entrée, sans être envoyée à l'interpréteur.

	Le texte des clefs est persistant, il est mémorisé dans les préférences de l'application. Le bouton 'Défauts' permet de rétablir le clavier original.

	La fenêtre du clavier numérique est collée à la fenêtre texte active, simulant plus ou moins un tiroir de fenêtre qui ne ferme pas. Elle ne peut pas être déplacée indépendamment de la fenêtre texte active. Si la 'fenêtre texte' est déplacée ou redimmentionnée, la fenêtre clavier numérique se déplace automatiquement.

	Elle peut être masqué par le menu 'Fenêtre->Masquer le clavier numérique'.
	Elle peut être alors affiché par le menu 'Fenêtre->Afficher le clavier numérique'.

Sauver/Restaurer

	Pour sauver ou restaurer une position, il est préférable d'utiliser les menus 'Fichier->Sauver…' et 'Fichier->Restaurer…' plutôt que les commandes 'Save' et 'Restore' de l'interpréteur. Vous pouvez facilement choisir le dossier et vous n'avez pas à taper de longs noms de fichier. Si par erreur vous entrez la commande 'Save' ou 'Restore', vous pouvez l'annuler en entrant un retour seulement.

	Si vous sauvez et qu'une vue statut est présente avec le nom du lieu, le nom du lieu suivi de l'extension par défaut est proposé comme nom de fichier. Vous pouvez modifier les deux. S'il n'y a plus d'extension, l'extension par défaut est ajouté. S'il y en a une, elle est utilisée.

	Dans Finder, on peut double cliquer sur une partie sauvée, si la bonne extension est présente. L'application est alors lancée, si elle ne l'est pas déjà. L'aventure est automatiquement restaurée dans la position sauvée. Si l'application est déjà lancée, une nouvelle fenêtre s'ouvre avec la position restaurée.

	Les fichiers sauvés en mode 64 bits sont identiques au fichiers sauvés en mode 32 bits.

Menus

	Les menus sont en 14 langues. La langue utilisée est selon le choix de langue de l'utilisateur dans l'option 'Langue et texte' des Préférences Système. Les traductions proviennent principalement de l'application TextEdit, certaines de l'application Moniteur d'activité et d'autres de Google Traduction.

Menu NomDeLapplication->Préférences…

	Ce menu présente une fenêtre permettant de modifier les trois polices par défaut utilisées, soit la police de la barre de statut, la police du texte sorti et la police du texte entré. En cliquant sur un des trois boutons présentant les noms des polices, vous pouvez modifer la police au moyen du panneau choix des polices qui a été ouvert automatiquement. On peut alors expérimenter car les changements aparaissent aussitôt.

	Le bouton du texte en sortie est pressé la première fois que cette fenêtre est ouverte. Le bouton 'Défauts' permet de revenir aux polices utilisées par défaut.

Menu NomDeLapplication->Lister l'historique

	Ce menu liste l'historique des commandes dans la fenêtre de l'aventure. Une flèche indique où on est rendu dans l'historique. Jusqu'à 11 commandes peuvent être affichée à la fois.

Menus Fichier, Édition et Fenêtres

	Ces menus fonctionnent comme prévu. 

Menus Fenêtre->Masquer le clavier numérique

	Ce menu masque le clavier numérique. Il est remplacé alors par le menu 'Fenêtre->Afficher le clavier numérique'.

Autres Menus

	Certains menus sont plus ou moins utiles. Ce sont des menus par défaut proposés par le système de développement xCode d'Apple. Certains fonctionnent comme prévu. Les autres pourraient servir dans une version futures.

Problèmes

	S.V.P rapportez tout problème à <pierre.tremblay99@videotron.qc.ca>

	Pierre Tremblay