@DATABASE DocumentationEti @AUTHORT Xavier Mertens @WORDWRAP @FONT topaz.font 8 ## $VER: Eti.guide v1.02 (10.04.93) @MASTER "Eti.guide" @NODE main "Documentation d'Eti v1.02 © Xavier Mertens (10.04.93)" Bienvenue dans la documentation hypertexte d'Eti... Cette documentation utilise le programme AmigaGuide (© Commodore). Pour plus d'informations sur ce programme,cliquez sur le gadget 'Aide' çi-dessus. Table des matières : 1. @{"A propos... " link apropos} 2. @{"Ressources nécessaires... " link ressources} 3. @{"Présentation du programme..." link presentation} 4. @{"Installation... " link installation} 5. @{"Utilisation... " link utilisation} 6. @{"Configuration... " link configuration} 7. @{"Messages d'erreur... " link erreur} 8. @{"Contacts... " link contacts} @endnode @node apropos Eti version 1.02 © Xavier Mertens (10.04.93) Programme d'impression d'étiquettes pour disquette. Ce programme est @{"SHAREWARE" link shareware}.Si vous l'utilisez,n'oubliez pas une petite contribution pour l'auteur.Merci d'avance! Eti a été écrit avec le SAS/C v6.00 sur un A3000 avec 6Mo de RAM et 132Mo de disque dur. L'interface a été créée au moyen de @{"Precognition" link precognition}. Mes coordonnées sont lisibles dans la rubrique @{"Contacts" link contacts}. @endnode @node precognition Precognition: A step beyond Intuition Release 1,December 1991 Ecrit par Lee Willis 590 Eleanora Dr. Cuyagoga Falls, Ohio USA 44223-2732 Ce programme permet la création d'interface puissante en un minimum de temps! @endnode @node shareware Cette méthode de distribution de logiciels implique que l'utilisateur 'final' verse une petite contribution à l'auteur pour l'encourager dans son travail. Mes coordonnées sont lisibles dans la rubrique @{"Contacts" link contacts}. Merci d'avance! @endnode @node ressources Eti fonctionne sur tout Amiga équipé au minimum d'un système 2.x ou supérieur.Il ne nécessite pas beaucoup de mémoire ni de disque dur. Par contre,une imprimante serait peut-être la bienvenue :-). @endnode @node presentation Ce programme a été écrit dans le but d'imprimer facilement et rapidement des étiquettes simples mais contenant les informations nécessaires de la disquette telles que par exemple : le nom,la date etc... L'impression peut se faire sur différents types de papier.Personellement, j'utilise des étiquette de 10x10 cm disposées en 1 seule colonne facilement trouvable dans le commerce (par bande de 100). La création et l'impression des étiquettes se fait presque exclusivement au moyen d'un interface intuitive. @endnode @node installation L'installation est simple et ne nécessite pas de script! Copiez le programme et son icône dans un répertoire et copiez ensuite le fichier de configuration dans le répertoire @{"ENV:" link env}.C'est tout! Pour plus d'informations sur le fichier de configuration,voyez la partie @{"Configuration" link configuration}. ATTENTION : Le programme nécessite une pile d'au moins 10 Ko pour fonctionner sans problème! N'oubliez pas de l'@{"augmenter" link augmenter} avant de lancer la programme. @endnode @node env Ce répertoire présent en RAM: contient entre autre tous les fichiers préférences du système ainsi que vos variables d'environnement. Normalement,votre startup-sequence doit contenir une ligne de ce genre : Copy >NIL: EnvArc: RAM:Env All Quiet NoReq Il est donc nécessaire soit de copier également Eti.prefs en ENVARC: soit de lancer le programme et de sauver la configuration une fois pour être certain de sa présence en ENVARC:! @endnode @node augmenter La pile peut être augmentée de manière différente selon que le programme soit lancé depuis le Shell ou depuis le Workbench : 1. Sous Shell : Avant de lancer le programme,entrez l'instruction suivante : 1.> Stack 10000 Puis le programme lui-même : 1.> Eti 2. Sous Workbench : Sélectionnez l'icône du programme et éditez ses paramètres au moyen du menu 'Icônes/Information...'.Dans la fenêtre ainsi ouverte,adaptez la taille de la pile grâce au gadget prévu à cet effet puis sauvez. Finalement double-cliquez sur l'icône du programme. @endnode @node utilisation Eti peut être chargé depuis le Shell ou le Workbench sans distinction. Il ouvre une fenêtre sur l'écran Workbench (ou sur l'écran public actif). A chaque chargement,un requester de bienvenue s'affiche avec le nom de l'auteur,la version du programme ainsi qu'un rappel sur le mode de distribution @{"SHAREWARE" link shareware}. L'interface est claire et chaque option sera détaillée çi-après.Sachez qu'une @{"aide en ligne" link aide} est à tout moment disponible. La fenêtre principale vous permet d'accéder à toutes les ressources du programme. Les étiquettes imprimées possédent les données suivantes : - Le @{"nom" link nom} de la disquette. - La @{"date" link date} du jour. - L'@{"espace" link espace} libre. - Le @{"FileSystem" link filesystem} de la disquette. - Six @{"lignes" link lignes} de textes. Description des différents gadgets de la fenêtre principale : @{"Add " link add} @{"Delete " link delete} @{"ListEditor" link listeditor} @{"Modifier " link modifier} @{"Lecteur " link lecteur} @{"Impression" link impression} @{"Reset " link reset} @{"Aide " link aide} @{"Iconifier " link iconifier} Pour quitter le programme,fermez simplement la fenêtre. @endnode @node nom Le nom est le nom de la disquette sous AmigaDOS. Il appraît dans l'étiquette sur la face avant et sur l'arête centrale. Cette dernière position permet un repérage facile de la disquette dans une boîte de rangement par exemple. @endnode @node date La date du jour est imprimée sur la face avant de l'étiquette. Elle est au format : 99 XXXXX 9999 Cette option est désactivable par l'utilisateur. @endnode @node espace L'espace libre est imprimé sur l'étiquette. Celui-çi est exprimé en Ko. Cette option est désactivable par l'utilisateur. @endnode @node filesystem Cette information pourra paraître inutile à certain,mais est très utile pour les gens qui,comme moi,échangent énormement de disquettes. Le système 3.0 a vu l'arrivée d'un nouveau filesystem nommé DCFS (Directory Caching File System) or tout le monde ne peut être à jour dans les différentes versions du Kickstart d'où les problèmes d'incompatibilité des disquettes! Grâce à cette option,il est possible de connaître à tout moment si une disquette est compatible avec telle ou telle machine! Le programme reconnait les file system suivants : OFS OldFileSystem (1.2) FFS FastFileSystem (1.3 - disque dur uniquement) OFS-INT OldFileSystem International (2.x) FFS-INT FastFileSystem International (2.x) DCFS-OFS Directory Caching with OldFileSystem (3.0) DCFS-FFS Directory Caching with FastFileSystem (3.0) Pour plus de renseignements,voyez mon petit utilitaire @{"CheckFS" link checkfs}! @endnode @node checkfs CheckFS v1.00 © Xavier Mertens Ce petit programme détecte le type de filesystem d'une disquette donnée. Les routines présentent dans Eti sont exactement les mêmes que celles de CheckFS. @endnode @node lignes L'étiquette possède une zone pouvant contenir jusqu'à 6 lignes de 43 caractères chacune. L'utilisateur a une totale liberté quant au contenu de celle-çi. @endnode @node add Ce gadget permet d'ajouter une ligne de texte à l'étiquette en cours. Cette ligne sera éditée dans le gadget chaîne réservé à cet effet et pourra contenir tous types de caractère alphanumériques. Une fois l'édition terminée,la nouvelle ligne s'ajoutera dans le gadget @{"ListeEditor" link listeditor}. ATTENTION : ° Une étiquette ne peut contenir que six lignes de texte! Tout texte supplémentaire sera purement ignoré! ° Chaque ligne de texte ne peut contenir que 43 caractères. @endnode @node delete Ce gadget efface la ligne de texte sélectionnée dans le gadget @{"ListEditor" link listeditor} @endnode @node listeditor Cette zone contient le texte de votre future étiquette. Vous pouvez sélectionner une ligne déjà entrée pour soit l'éditer au moyen du gadget chaîne réservé à cet effet ou bien l'effacer définitivement au moyen du gadget @{"Delete" link delete} @endnode @node modifier Sélectionnez ce gadget pour accéder à la configuration du programme. Pour plus de renseignements,voyez la partie @{"Configuration" link configuration}. @endnode @node lecteur Ce gadget cyclique vous permet de sélectionner le lecteur contenant votre disquette. A chaque clic sur celui-çi,le gadget change et prend une valeur parmi celles-çi : DF0: DF1: DF2: DF3: Autre Ce dernier choix permet d'imprimer des étiquettes pour des lecteurs spéciaux (voyez Configuration/@{"Autre lecteur" link autrelecteur} pour plus de renseignements) @endnode @node impression Ce gadget lance l'impression de l'étiquette avec tous les textes et paramètres spécifiés auparavant. @endnode @node reset Cliquez sur ce gadget pour remettre plus rapidement à zéro les différents paramètres du programme (par exemple avant de commencer une nouvelle étiquette). En sélectionnant ce gadget,le texte courant est effacé et le fichier de configuration est rechargé. @endnode @node aide Une aide est disponible à tout moment en cliquant simplement le gadget 'Aide'. Une fois celle-çi activée,chaque opération sera précédée d'un requester explicatif. L'utilisation de l'aide en ligne peut être vérifiée par une modification de la barre de titre de la fenêtre principale. Pour annuler cette aide,recliquez simplement sur le même gadget. @endnode @node iconifier Le programme peut être mis en veille grâce à ce gadget. La fenêtre principale est alors fermée et un item est rajouté dans le @{"menu Outils" link menuoutils} du Workbench. Pour réactiver le programme,sélectionnez simplement cet item. Cette méthode permet par exemple de libérer de la mémoire CHIP en cas de problème ou bien de faire de la place sur votre écran. @endnode @node menuoutils A partir du système 2.x,de nouvelles fonctions ont fait leur apparition dans la bibliothèque Intuition. Parmi celles-çi,AddAppMenuItem() qui permet d'ajouter une rubrique au menu Outils du Workbench. L'utilisateur a donc ainsi la possibilité d'avoir ses propres programmes à portée de la main. Cette fonction est également utilisée par les programmes du genre ToolManager. @endnode @node configuration La configuration du programme peut être modifiée à tout moment par l'utilisateur. Pour cela,une nouvelle fenêtre est ouverte contenant les gadgets suivants : @{"Code de configuration" link code} @{"Marge de gauche " link marge} @{"Saut de page " link saut} @{"Autre lecteur " link autrelecteur} @{"Date " link date2} @{"Impression NLQ " link nlq} @{"Espace libre " link espacelibre} @{"Lecture auto. " link lectureauto} @{"Utiliser " link utiliser} @{"Sauver " link sauver} @{"Ignorer " link ignorer} @endnode @node code Ce gadget permet à l'utilisateur d'entrer une séquence de caractères qui sera envoyée à l'imprimante avant l'impression de l'étiquette. Ce code est du type ESC+... Il doit être rentré SANS caractère ESC et doit figurer parmi les codes connus du @{"printer.device" link printerdevice}. Par défaut,l'imprimante est configurée en mode condensé ([4w). @endnode @node printerdevice L'impression se fait en passant par le printer.device (PRT:). Ceci suppose donc que vos préférences soit bien réglées. Le printer.device permet d'envoyer des séquences standards de caractères pour le paramétrage de votre imprimante. Le code demandé dans la configuration sera issu de cette liste. Exemple de codes : - [3m : Italique - [4m : Souligné - [1m : Gras - [2w : Caractère Elite - Etc... Pour obtenir la liste complète des codes,consultez votre manuel de l'AmigaDOS ou le fichier include 'devices/printer.h'. @endnode @node marge Ce gadget contient la largeur de la marge de gauche exprimée en caractères. L'utilisateur peut la modifier comme bon lui semble mais elle ne peut excéder 10 caractères. Valeur par défaut : 3 caractères. Remarque : Un valeur de 0 supprime toute marge! @endnode @node saut Ce gadget contient la longueur du saut de page effectué après chaque étiquette.Il est exprimé en lignes. L'utilisateur peut le modifier comme bon lui semble mais il ne peut excéder 10 lignes. Valeur par défaut : 3 lignes Remarque : Un valeur de 0 supprime tout saut de page! @endnode @node autrelecteur L'utilisateur a ici la possibilité d'ajouter un device propre à sa configuration. Le programme peut lire les lecteurs de DF0: à DF3: mais peut également accéder à un device personnel (par l'intermédiaire du @{"gadget cyclique" link lecteur}. Le device supplémentaire sera alors celui spécifié dans ce gadget. Par défaut,l'autre device est PC0: (lecture de disquette MsDOS). @endnode @node date2 Ce gadget permet de demander l'impression automatique de la date du jour sur l'étiquette. Par défaut,cette option est activée. @endnode @node nlq Ce gadget permet d'imprimer l'étiquette en mode NQL (proche de la qualité courier). Par défaut,ce mode est désactivé. Remarque : Il se peut que l'impression se fasse en qualité normale malgré la demande d'une impression NLQ. Dans ce cas,vérifiez que le @{"code de configuration" link code} donné soit bien compatible avec le NLQ. @endnode @node espacelibre Ce gadget permet de demander l'impression automatique de l'espace encore libre sur l'étiquette. Par défaut,cette option est activée. @endnode @node lectureauto Ce gadget permet d'imprimer directement une étiquette. Dans ce cas,le nom de la disquette n'est pas modifiable. Dans le cas contraire,un requester apparaît dans lequel vous pouvez modifier le nom de la disquette. @endnode @node utiliser Ce gadget permet de valider les modifications de la configuration jusqu'à ce que le programme se termine ou que les préférences soient de nouveau modifiées. @endnode @node sauver Ce gadget permet de valider les modifications effectuées aux préférences mais cette fois de manire définitive. La sauvegarde se fait dans un fichier 'Eti.prefs' dans le répertoire @{"ENV:" link env}. @endnode @node ignorer Ce gadget permet d'annuler les mofifications apportées aux préférences. @endnode @node erreur Voici la liste des messages d'erreur que pourrait vous renvoyez le programme avec,chaque fois,un petit mot d'explication. Messages d'avertissement : @{"Auncun texte à imprimer! Confirmer ? " link warning1} Messages d'erreur : @{"Erreur de lecture sur le drive sélectionné! " link error1} @{"Impossible d'accéder à l'imprimante! " link error2} @{"Une étiquette ne peut contenir que 6 lignes de texte! " link error3} @{"Impossible de lire les préférences.Utilisation des valeurs par défaut!" link error4} @{"Impossible d'écrire les préférences! " link error5} @{"Mauvais fichier de configuration.Utilisation des valeurs par défaut! " link error6} @{"Impossible de déterminer le type de FileSystem! " link error7} @endnode @node warning1 Ce message apparaît lorsque l'utilisateur tente d'imprimer une étiquette sans avoir entré de texte. Cliquez sur 'OUI' pour imprimer malgré tout l'étiquette ou sur 'NON' pour arrêter l'opération. @endnode @node error1 Cette erreur se produit lorsque le programme tente d'accéder à un lecteur vide. @endnode @node error2 Cette erreur se produit lorsque le programme ne peut accéder à l'imprimante. Par exemple,lorsqu'elle est déjà utilisée par un autre programme. @endnode @node error3 Cette erreur se produit lorsque l'utilisateur tente d'écrire plus de six lignes de texte. Le programme permet d'en entrer un nombre supérieur mais seul les six premières seront prises en compte. @endnode @node error4 Cette erreur se produit si le fichier de configuration n'est pas accessible par le programme. Dans ce cas,les @{"valeurs par défaut" link defaut} sont prises. @endnode @node defaut Ces valeurs sont utilisées au cas où les préférences ne seraient pas accessibles : Code : [4w Marge : 3 Saut de page : 3 Autre lecteur : PC0: Date : On Espace libre : On NLQ : On Lecture auto : Off @endnode @node error5 Cette erreur se produit lorsque le programme ne peut écrire sa configuration. Par exemple,si le périphérique est protégé en écriture. @endnode @node error6 Cette erreur se produit si le fichier de configuration n'est pas au bon format. Dans ce cas,les @{"valeurs par défaut" link defaut} sont prises. @endnode @node error7 Cette erreur se produit lorsque le programme rencontre un problème lors de la détermination du FileSystem d'une disquette. Par exemple,si la disquette est une démo au format NDOS. @endnode @node contacts Pour tous renseignements sur le programme, pour verser vos contributions, vous pouvez me contacter à l'adresse suivante : Xavier MERTENS 46,rue A. Brenez 7390 Quaregnon (B) Merci de votre lecture et n'oubliez pas : /// /// Only \\\/// makes it possible... \XX/ @endnode