APrf2 v2.00 - Manuel d'utilisation Ce manuel décrit la version 2.00 de l'utilitaire APrf2. Ce programme est (c)1989-1990-1991-1992 par Denis GOUNELLE, toute utilisation commerciale ou vente sans autorisation écrite est strictement interdite. Vous pouvez copier et diffuser ce programme aux conditions suivantes : - l'ensemble des fichiers doit être fourni - aucun fichier ne doit avoir été modifié - vous ne devez pas demander plus de 40FF pour cela "PowerPacker 2.3b" est (c)1989 par PowerPeak et Nico FRANCOIS, "PowerPacker Pro 3.0b" est (c)1990 par PowerPeak et par UGA Software. La bibliothèque "powerpacker.library" est (c)1990 par Nico FRANCOIS. AREXX est (c)1987 par William Hawes. La bibliothèque "reqtools.library" est (c)1990- 1991 par Nico FRANCOIS. Malgrès de nombreux tests, je ne peux garantir qu'APrf ne contient aucune erreur. VOUS UTILISEZ CE PROGRAMME A VOS RISQUES ET PERILS. Je ne pourrai en aucun cas être tenu responsable de tout dommage, direct ou indirect, résultant de l'utilisation d'APrf. Sommaire : ---------- 1. Introduction 2. Mode d'emploi 2.1 Appel depuis le CLI 2.2 Appel depuis le Workbench 2.3 Démarrage du programme 2.4 Les gadgets 2.5 Les menus 2.6 Entête et pied de page 2.7 La pré-visualisation 2.8 Modification de la sélection 3. Concepts avancés 3.1 La bibliothèque "powerpacker.library" 3.2 Le mode "eXpress" 3.3 Le mode AREXX 3.4 La fenêtre d'application (AppWindow) 3.5 Le fichier "APrf.Init" 4. Gestion de la mémoire 4.1 Le fichier à imprimer 4.2 Le tampon de sortie 4.3 Mémoire nécessaire 5. Divers 1.Introduction : ---------------- APrf2 est une nouvelle version de APrf, capable d'utiliser les fonctions de la version 2.0 du système. Ce programme peut toujours être utilisé avec le système 1.3, bien que certaines des nouvelles possibilités ne soient pas disponibles dans ce cas. APrf est un utilitaire d'impression qui permet (entre autres) l'ajout d'une entête, d'un pied de page, de marges, la numérotation des lignes, l'impression sur plusieurs colonnes, etc... et utilise les valeurs fixées dans les Préférences. APrf dispose de plus d'un port compatible AREXX, d'une fenêtre d'application (ou "AppWindow", sous système 2.0 uniquement) et peut charger des fichiers compactés par "PowerPacker 2.3b" ou par "PowerPacker Pro 3.0b". Vous pouvez me faire part de vos remarques ou critiques sur APrf, en écrivant à l'adresse suivante : M. GOUNELLE Denis Boite 71 6, rue des cailloux 92110 CLICHY - FRANCE Merci à Serge HAMMOUCHE, Jean-Yves PROUX, Jean-Philippe RAPP, Jean ROUGELIN, Michel SCHINZ, et Pierre VITET, pour leurs tests et leurs idées. En France, la dernière version de ce programme est disponible auprès de Serge HAMMOUCHE, 3 rue Anatole France, 13220 Chateauneuf-les- Martigues. Pour recevoir le catalogue complet, il vous suffit d'envoyer deux timbres à cette adresse. 2. Mode d'emploi : ------------------ APrf peut être lancé aussi bien depuis le Workbench que depuis le CLI. Dans ce dernier cas, il n'y a pas besoin d'utiliser une commande "RunBack" ou "ARun", car APrf se détache automatiquement de la fenêtre CLI. 2.1 Appel depuis le CLI : ------------------------- Depuis le CLI, on peut appeler APrf avec une série d'options qui permettent de modifier les paramêtres par défaut. La syntaxe de la ligne de commande est : APrf [fichier][-c#][-d#][-e#][-f#,#][-g#][-n#][-p#][-t#][-vF] [-x#][-A][-Cseq][-D#][-E{G|C|D}fmt][-F{G|C|D}][-Ifont] [-N#][-Oopts][-P{p|e|f}][-Spages][-X] Si on précise l'argument , le fichier correspondant sera considéré comme le fichier à imprimer. Voici la description des autres options : -c# (nombre de Colonnes) Imprime sur # colonnes. Valeur par défaut : # = 1. Valeur minimale : # = 1. Valeur maximale : # = 999. -d# (marge Droite) Ajoute une marge droite de # caractères. Notez que les marges fixées dans les Préférences sont prises en compte quoi qu'il arrive. Valeur par défaut : # = 0. Valeur minimale : # = 0. Valeur maximale : # = 999. -e# (Espacement) Sépare les colonnes par # espaces. Valeur par défaut : # = 1. Valeur minimale : # = 1. Valeur maximale : # = 999. -f#,# (Format de page) Sélectionne le format de la page et les pages où faire la présentation. Le premier # peut prendre les valeurs suivantes : 0 : pas de format particulier 1 : ajoute une entête 2 : ajoute un pied de page 3 : ajoute une entête et un pied de page Valeur par défaut : # = 1. Le second # peut prendre les valeurs suivantes : 0 : sur toutes les pages 1 : sur toutes les pages sauf la première 2 : sur les pages paires 3 : sur les pages impaires Valeur par défaut : # = 0 Il est possible de n'indiquer qu'un seul paramètre : les formes "-f1,2", "-f1" et "-f,2" sont acceptées. Pour plus de détails voir §2.6. -g# (marge Gauche) Ajoute une marge gauche de # caractères. Notez que les marges fixées dans les Préférences sont prises en compte quoi qu'il arrive. Valeur par défaut : # = 0. Valeur minimale : # = 0. Valeur maximale : # = 999. -n# (Numérotation des lignes) Numérote les lignes (numéros de # chiffres). Valeur par défaut : # = 0 (pas de numéros de ligne). Valeur minimale : # = 0. Valeur maximale : # = 10. -p# (longueur des Pages) Imprime par pages de # lignes. Valeur par défaut : "Paper Length" des Préférences. Valeur minimale : # = 5. Valeur maximale : # = 999. -t# (Tabulation) Règle les positions des tabulations sur les colonnes #+1, 2#+1, 3#+1, etc... Valeur par défaut : # = 8. Valeur minimale : # = 1. Valeur maximale : # = 999. -vF (Vers) L'impression est redirigée vers le fichier F. -x# (eXemplaires) Imprime # exemplaires du fichier. Valeur par défaut : # = 1. Valeur minimale : # = 1. Valeur maximale : # = 999. -A (mode AREXX) Place APrf en mode AREXX (voir §3.3) -Cseq (séquence de Contrôle) Sélectionne la séquence de contrôle "seq" (voir §3.5). -D# (format de la Date) Indique le format de la date dans l'entête. # peut prendre les valeurs : 0 : format AmigaDOS (jj-mmm-aa) 1 : format international (aa-mm-jj) 2 : format américain (mm-jj-aa) 3 : format européen (jj-mm-aa) Valeur par défaut : # = 0. Pour plus de détails voir §2.6. -E{G|C|D}fmt (format de l'Entête) Indique le format de l'entête. Pour plus de détails voir §2.6. -F{G|C|D}fmt (format du pied de page) Indique le format du pied de page. Pour plus de détails voir §2.6. -Ifont (police Interne) Sélectionne la police interne indiquée. Pour plus de détails voir §3.5. -N# (Numéro de la première page) La numérotation des pages commence au nombre #. Valeur par défaut : # = 1. Valeur minimale : # = 1. Valeur maximale : # = 899. -Oopts (Options) Permet de modifier certaines options. opts est une combinaison quelconque des caractères : c qualité courrier l qualité listing 8 interligne 8LPI 6 interligne 6LPI C alimentation papier continu F alimentation feuilles à feuilles t tronque les lignes trop longues f filtre les caractères de contrôle a filtre les séquences d'échappement k tampon de sortie d'un kilo-octets n n'envoit pas de sauts de page u souligne l'entête Voir la description du menu "Options" au §2.5 pour plus de détails. -P{p|e|f} (Pas d'impression) Permet de sélectionner le pas d'impression : -Pp pour le pas "pica" -Pe pour le pas "elite" -Pf pour le pas "fine" Valeur par défaut : "Pitch" des Préférences. -Spages (Sélection) Permet de sélectionner les pages à imprimer. La sélection peut prendre les formes suivantes : x : page x uniquement x-y : pages x à y x,y,z,... : pages x,y,z,... Vous pouvez également utiliser une combinaisons des deux dernières formes, comme par exemple "-S1,3,5-8". ATTENTION : les numéros de page indiqués dans la sélection doivent tenir compte du numéro de la première page (voir option -N) -X (eXpress) Lance APrf en mode eXpress (voir §3.2). En cas d'erreur dans la ligne de commande, une fenêtre apparait sur l'écran Workbench, portant le message "Arguments incorrects". Cliquez sur le gadget "OK" pour la faire disparaitre, et relancez APrf après correction de la ligne de commande. Notez que le menu "Outils" possède une commande qui permet de savoir quelles options de la ligne de commande correspondent aux options courantes (voir §2.5 pour plus de détails). 2.2 Appel depuis le Workbench : ------------------------------- Il y a trois façon d'appeler APrf depuis le Workbench quand on veut lui indiquer le ou les fichiers à imprimer : - en double-cliquant sur une icône de type "Project" qui a APrf comme outil par défaut ("Default tool") - en cliquant sur une ou plusieurs icônes de fichiers puis en double-cliquant sur l'icône d'APrf tout en gardant la touche SHIFT enfoncée. - en cliquant sur l'icône d'APrf (et éventuellement sur des icônes de fichiers) puis en double-cliquant sur une icône de fichier tout en gardant la touche SHIFT enfoncée. Dans tous les cas, le ou les fichiers sélectionnés sont transmis à APrf, qui affiche le nom du premier fichier dans le gadget "Fichier à imprimer" (voir §2.4). La commande "Fichier suivant" du menu "Projet" permet de passer au fichier suivant (voir §2.5), et la commande "Options défaut" du menu "Outils" permet de revenir au premier fichier de la liste (voir §2.5). Comme pour l'appel depuis le CLI, il est possible d'appeler APrf avec des options. Pour ce faire, cliquez sur l'icône du fichier à imprimer, appelez le menu "Icons" du Workbench et choisissez l'item "Information". Ensuite, cliquez sur le gadget "New" de la zone "TOOL TYPES" et entrez les options en respectant la syntaxe suivante : APRF=[-c#][-d#][-e#][-f#,#][-g#][-n#][-p#][-t#][-vF][-x#] [-Cseq][-D#][-E{G|C|D}fmt][-F{G|C|D}][-Ifont][-N#] [-Oopts][-P{p|e|f}][-Spages] Ces options sont décrites au paragraphe précédent (§2.1). Si vous appelez APrf depuis le Workbench sans arguments (juste en double-cliquant sur l'icône d'APrf) les options seront cherchées dans le champ "TOOL TYPES" de l'icône d'APrf. Notez que les options -A (mode AREXX) et -X (mode eXpress) ne peuvent être utilisées en cas d'appel depuis le Workbench. 2.3 Démarrage du programme : ---------------------------- APrf utilise la version 2.0c de la bibliothèque "reqtools.library". Vous devez donc copier cette bibliothèque dans le répertoire "LIBS:", si ce n'est déjà fait. Si tout se passe bien, un écran s'ouvre, sur lequel apparaissent une vingtaine de gadgets. Un port AREXX est également ouvert (voir §3.3). Sous système 2.0, APrf ouvre systématiquement une "AppWindow" (fenêtre d'application, voir §3.4). Sinon une fenêtre apparait sur l'écran Workbench, indiquant le problème rencontré. Cliquez sur le gadget "OK" pour la faire disparaitre, APrf s'arrête et retourne la valeur 10 (ERROR, voir commande IF de l'AmigaDOS). Il se peut que APrf rende la main sans dire pourquoi, c'est-à-dire sans afficher aucun message, mais en retournant cependant la valeur 10. Ceci ne peut se produire que dans trois cas : a) APrf n'a pu ouvrir la bibliothèque "reqtools.library" b) APrf n'a pu ouvrir la fenêtre pour afficher le message d'erreur c) APrf n'a pu ouvrir l'écran Workbench Je suppose maintenant que le programme a démarré correctement. Les deux paragraphes qui suivent vont vous expliquer comment utiliser les gadgets et les menus d'APrf. Si vous utilisez APrf pour la première fois, je vous conseille de lancer le programme afin de pouvoir mieux suivre les explications. 2.4 Les gadgets : ----------------- Ce paragraphe décrit les gadgets affichés sur l'écran, de haut en bas et de gauche à droite. Fichier à imprimer : Ce gadget indique le nom du fichier à imprimer. Pour modifier sa valeur il suffit de cliquer dessus. Une boite de requête apparait, vous permettant de choisir le fichier à imprimer. Si vous cliquez sur le gadget "CANCEL", ou sur le gadget "OK" sans avoir choisi de fichier, l'ancien nom de fichier sera conservé. Le caractère "*" apparait à droite du nom de fichier quand le fichier est chargé en mémoire (voir §4.1). Fichier de sortie : Ce gadget indique où sera envoyée l'impression. Par défaut il indique "PRT:", mais cette valeur peut être changée à l'appel grâce à l'option -v (voir §2.1). Pour modifier la valeur de ce gadget, il suffit de cliquer dessus. Une boite de requête apparait, vous permettant de choisir le fichier de sortie. Si vous cliquez sur "CANCEL", le fichier de sortie devient "PRT:". Pages sélectionnées : Ce gadget indique quelles pages seront imprimées. Par défaut il indique "*", ce qui signifie "toutes les pages", mais cette valeur peut être changée à l'appel grâce à l'option -S (voir §2.1). Pour modifier la valeur de la sélection, reportez-vous au §2.8. Les neufs gadgets suivants permettent de spécifier respectivement : la taille de la marge gauche, la taille de la marge droite, la longueur des tabulations, le nombre de lignes par page, le numéro de la première page, la taille des numéros de lignes, le nombre de colonnes, l'espacement des colonnes, et le nombre d'exemplaires à imprimer. Chacun de ces gadgets indique la valeur actuelle du paramêtre correspondant, suivit par une flèche vers le haut et une flèche vers le bas. Vous pouvez cliquer sur la valeur, et la modifier au clavier (appuyez sur Amiga-X pour effacer la valeur précédente, n'oubliez pas d'appuyer sur pour valider la nouvelle valeur). Vous pouvez également cliquez sur la flèche vers le haut pour augmenter la valeur, ou sur la flèche vers le bas pour la réduire. Si la valeur ne change pas, c'est que vous avez atteind la limite inférieure ou supérieure admise pour ce paramêtre. La valeur augmente ou diminue automatiquement tant que vous appuyez sur le bouton gauche de la souris. Marge gauche : (voir §2.1, option -g) Valeur par défaut : 0 Valeur minimale : 0 Valeur maximale : 999 Marge droite : (voir §2.1, option -d) Valeur par défaut : 0 Valeur minimale : 0 Valeur maximale : 999 Tabulation : (voir §2.1, option -t) Valeur par défaut : 8 Valeur minimale : 1 Valeur maximale : 999 Lignes par page : (voir §2.1, option -p) Valeur par défaut : "Paper length" des Préférences Valeur minimale : 5 Valeur maximale : 999 No première page : (voir §2.1, option -N) Valeur par défaut : 1 Valeur minimale : 1 Valeur maximale : 899 NOTE : la sélection des pages est effacée à chaque modification du numéro de la première page. No de lignes : (voir §2.1, option -n) Valeur par défaut : 0 (pas de numéros de ligne) Valeur minimale : 0 (pas de numéros de ligne) Valeur maximale : 10 Colonnes : (voir §2.1, option -c) Valeur par défaut : 1 Valeur minimale : 1 Valeur maximale : 999 Espacement : (voir §2.1, option -e) Valeur par défaut : 1 Valeur minimale : 1 Valeur maximale : 999 Exemplaires : (voir §2.1, option -x) Valeur par défaut : 1 Valeur minimale : 1 Valeur maximale : 999 Les cinq gadgets suivants proposent différentes valeurs, que vous pouvez faire défiler en cliquant sur le gadget en forme de flèche affiché juste à droite de la valeur. Si vous appuyez sur une des touches SHIFT en même temps, les valeurs défileront en sens inverse. Caractères : Ce gadget indique le pas d'impression. Par défaut, le pas est celui indiqué dans le champ "Pitch" des Préférences, mais cela peut être changé à l'appel grâce à l'option -P (voir §2.1). Police : Ce gadget indique la police interne à utiliser. Normalement il s'agit de la police par défaut, mais cela peut être changé à l'appel grâce à l'option -I (voir §2.1). Pour plus de détails, voir §3.5. Format Date : Ce gagdet indique dans quel format sera la date. Par défaut le format est le format AmigaDOS, mais ceci peut être changé à l'appel grâce à l'option -D (voir §2.1). Pour plus de détails, voir §2.6. Format Page : Ce gadget indique le format de page courant Par défaut le format est "entête", mais ceci peut être changé à l'appel grâce à l'option -f (voir §2.1). Pour plus de détails, voir §2.6. sur : Ce gadget indique sur quelles pages seront ajoutés l'entête et/ou le pied de page. Par défaut, ce sera sur toutes les pages, mais ceci peut être changé à l'appel grâce à l'option -f (voir §2.1). Pour plus de détails, voir §2.6. Les gadgets suivants vous permettent de personnaliser l'entête et le pied de page. Entête : Ce gadget indique le format des trois parties de l'entête : la partie gauche, la partie centrale, et la partie droite. La valeur par défaut de chaque partie peut être changée à l'appel grâce à l'option -E (voir §2.1). Pour modifier la valeur d'une des parties, il vous suffit de cliquer dessus : une fenêtre avec un gadget de chaine apparait alors. Appuyez sur Amiga-X pour effacer la valeur, sur RETURN pour valider, ou cliquez sur le bouton de fermeture pour annuler l'opération. Pour plus de détails, voir §2.6. Pied de page : Fonctionne de la même façon que pour l'entête. La valeur par défaut peut être changée à l'appel grâce à l'option -F (voir §2.1). Pour plus de détails, voir §2.6. Les deux gadgets en forme de losange, en bas de l'écran, permettent de lancer l'impression (celui de gauche) et de lancer la pré-visualisation (celui de droite) sans avoir à passer par les menus. Vous pouvez également cliquer sur le gadget de fermeture de la fenêtre principale (en haut à gauche) pour quitter le programme, ou sur le gadget "zoom" (en haut à droite, sous système 2.0 uniquement) pour iconifier APrf. 2.5 Les menus : --------------- APrf possède trois menus : le menu "Projet", le menu "Outils" et le menu "Options". Chaque commande peut être sélectionnée à l'aide de la souris ou de raccourcis clavier, par contre les items du menu "Options" ne peuvent être modifiés qu'à la souris. Les rubriques du menu "Projet" sont les suivantes : Commande "Fichier suivant" (Amiga-F) : Si l'on a appelé APrf depuis le Workbench en sélectionnant plusieurs fichiers, cette commande permet de passer au fichier suivant dans la liste des fichiers sélectionnés. Le gadget "Fichier à imprimer" est mis à jour (voir §2.4) et l'ancien fichier est vidé de la mémoire (s'il était chargé, voir §4.1). Commande "Imprime" (Amiga-P) : Lance l'impression. Commande "Palette" : Vous permet de modifier les couleurs de l'écran de APrf. Pour sauvegarder la nouvelle palette immédiatement, appelez la commande "Sauve config" et entrez "palette" comme nom de configuration. Sinon, lorsque vous voudrez quitter le programme, APrf vous demandera si vous voulez sauver la nouvelle palette. Commande "A Propos..." (Amiga-?) : Affiche quelques informations sur APrf. Pour faire disparaitre la fenêtre, cliquez à l'intérieur ou appuyez sur une touche. Commande "Iconifie" (Amiga-I) : Iconifie APrf. L'écran d'APrf est fermé et, sous système 1.3 une petite fenêtre dont le titre est "APrf2 v2.00" vient se placer dans le coin supérieur gauche de l'écran Workbench. Sous système 2.0, la fenêtre d'application reste ouverte. Notez que le port AREXX est toujours actif pendant que APrf est iconifié. Pour réveiller APrf, rendez cette fenêtre active puis cliquez sur le bouton droit de la souris. Vous pouvez quitter APrf lorsqu'il est iconifié sans avoir à le réveiller, en cliquant sur le gadget de fermeture de la fenêtre. Commande "Quitte" (Amiga-Q ou ESCAPE) : Termine l'exécution d'APrf. Une boite de requête apparaitra pour vous demander confirmation. Voici la description des commandes du menu "Outils" : Commande "Options défaut" (Amiga-D) : Permet de recharger les options par défaut (dans l'ordre : valeurs des Préférences, puis options de la ligne de commande). Si l'on a appelé APrf depuis le Workbench en sélectionnant plusieurs fichiers, le premier fichier sélectionné devient le fichier à imprimer. Cette commande peut être utile (entre autres) si vous avez changé les Préférences, car cela permet à APrf de prendre en compte ces modifications sans que vous ayez à quitter le programme. Commande "Charge fichier" (Amiga-C) : Permet de charger immédiatement le fichier à imprimer en mémoire. Si ce fichier était déjà en mémoire, il est rechargé quand même (voir §4.1). Commande "Libère fichier" (Amiga-L) : Permet de libérer la mémoire occupée par le fichier à imprimer (voir §4.1) Commande "Pré-visualise" (Amiga-V) : Permet de visualiser la mise en page du fichier à imprimer. (voir §2.7). Commande "Ligne de cmd" (Amiga-K) : Affiche la liste des options à donner à l'appel pour que les paramêtres d'impressions aient leur valeur actuelle. Pour faire disparaitre la fenêtre, cliquez à l'intérieur ou appuyez sur une touche. Commande "Sauve config" (Amiga-S) : Sauve les options courantes (sauf le nom du fichier à imprimer) en créant une nouvelle ligne dans le fichier "S:APrf.Init". Une fenêtre apparait, et vous devez entrer le nom de la nouvelle configuration. Cliquez sur le gadget de fermeture de la fenêtre pour annuler l'opération. Notez que le nouveau fichier de configuration n'est pas rechargé. Voir §3.5 pour d'autres détails. Commande "Doc info" (Amiga-X) : Affiche le nombre de pages, de lignes et de caractères que produira l'impression courant. Ce décompte tient compte de toutes les options de mise en page, mais notez que le nombre de caractères est approximatif. Pour faire disparaitre la fenêtre, cliquez sur le gadget "OK". Voici la description des items du menu "Options" : Option "Courrier" : Permet de sélectionner la qualité d'impression : "courrier" ou "listing". Par défaut la qualité est celle indiquée par le champ "Print Quality" des Preferences, mais cela peut être changé à l'appel par l'option -O (voir §2.1). Option "8 LPI" : Permet de régler l'interligne : "8 LPI" ou "6 LPI". Par défaut l'interligne est celui indiqué par le champ "Spacing" des Préférences, mais cela peut être changé à l'appel par l'option -O (voir §2.1). Option "Continu" : Permet d'indiquer comment est alimentée votre imprimante : par du papier en continu, ou feuille à feuille. Par défaut, l'alimentation est celle indiquée par le champ "Paper type" des Préférences, mais cela peut être changé à l'appel grâce à l'option -O (voir §2.1). Option "Tronque" : Si cette option est active, les lignes trop longues seront tronquées au lieu d'être imprimées sur plusieurs lignes. Normalement cette option n'est pas active, mais cela peut être changé à l'appel grâce à l'option -O (voir §2.1). Option "Filtre CTRL" : Si cette option est active, les caractères de contrôle (code ASCII inférieur à 32 ou supérieur à 126) trouvés dans le fichier à imprimer ne seront pas envoyés à l'imprimante. Normalement cette option n'est pas active, mais cela peut être changé à l'appel grâce à l'option -O (voir §2.1). Option "Filtre ANSI" : Si cette option est active, les séquence d'échappement ANSI (définies au §6) trouvées dans le fichier à imprimer ne seront pas envoyés à l'imprimante. Normalement cette option n'est pas active, mais cela peut être changé à l'appel grâce à l'option -O (voir §2.1). Option "Tampon 1Ko" : Si cette option est active, le tampon de sortie aura une taille d'un kilo-octets (et non d'une page). Normalement cette option n'est pas active, mais cela peut être changé à l'appel grâce à l'option -O (voir §2.1). Voir §4.2 pour plus de détails. Option "Envoie FF" : Si cette option est active, un caractère "saut de page" (Form Feed) est envoyé à la fin de chaque page. Normalement cette option est active, mais cela peut être changé à l'appel grâce à l'option -O (voir §2.1). Option "Soul.entête" : Si cette option est active, l'entête sera souligné lors de l'impression. Normalement cette option n'est pas active, mais cela peut être changé à l'appel grâce à l'option -O (voir §2.1). 2.6 L'entête et le pied de page : --------------------------------- APrf vous permet d'ajouter une entête, un pied de page, ou les deux, sur vos documents. Le choix se fait soit à l'appel (option -f, voir §2.1) soit avec le gadget "Format Page" (voir §2.4). L'entête et le pied de page utilisent chacun deux lignes sur la page. Lorsque vous demandez une entête (et/ou un pied de page), APrf utilise la valeur des gadgets "Entête" (et/ou "Pied de page") pour composer cette entête (et/ou ce pied de page). Le gadget à gauche indique ce qui sera écrit à gauche, le gadget central ce qui sera écrit au milieu, et le gadget à droite ce qui sera écrit à droite. Les spécifications de format peuvent utiliser les séquences suivantes : %a nom du jour de la semaine (e.g. "Lundi") %b nom du mois (complet, e.g. "septembre") %B nom du mois (abbrégé, e.g. "Sep") %d jour du mois (01 à 31) %D date telle qu'indiquée par le gadget "Format Date" %f nom de base du fichier (e.g. "toto") %F nom complet du fichier (e.g. "RAM:titi/toto") %h heure (00 à 11) %H heure (00 à 23) %m mois (01 à 12) %M minutes (00 à 59) %n numéro de page %p période de la journée (AM ou PM) %s taille du fichier en octets %S secondes (00 à 59) %v version du programme (e.g. "APrf v4.20") %w jour de la semaine (0 à 6) %x numéro d'exemplaire %y année (00 à 99) La valeur par défaut de l'entête est "%f" pour la partie gauche, "Page %n" pour la partie centrale, et "%D" pour la partie droite. La valeur par défaut du pied de page est "Page %n" pour la partie centrale, et rien pour les autres parties. Vous avez la possibilité d'indiquer un format différent pour l'entête (et/ou le pied de page), soit en cliquant sur le gadget correspondant à la partie que vous voulez modifier, soit à l'appel avec l'option -E (et/ou l'option -F) : "-EGformat" modifie la valeur par défaut de la partie gauche, "-ECformat" celle de la partie centrale, et "-EDformat" celle de la partie droite. Vous pouvez également préciser sur quelles pages doivent apparaitre l'entête (et/ou le pied de page), soit avec le gadget "sur" (voir §2.4), soit à l'appel à l'aide de l'option -f (voir §2.1). 2.7 La pré-visualisation : -------------------------- Cette fonction vous permet de voir l'aspect final du texte en fonction des options de mise en page. Pour l'utiliser, réglez tous les paramêtres d'impression, puis choisissez la commande "Pré-visualise" du menu "Outils". Une fenêtre apparait au milieu de l'écran, et vous montre le résultat de la mise en page en commençant par la première page sélectionnée (la taille de la fenêtre est fonction de la taille de la page). Pour passer à la page suivante, cliquez à l'intérieur de la fenêtre, ou appuyez sur la touche RETURN. A tout moment vous pouvez arrêter l'opération de visualisation en cliquant sur le gadget de fermeture ou en appuyant sur la touche ESCAPE. Notez cependant que si la longueur des pages est très grande (plus de 121 lignes en mode PAL, ou plus de 93 lignes en mode NTSC), APrf ne pourra pas ouvrir la fenêtre de pré-visualisation. 2.8 Modification de la sélection -------------------------------- Pour modifier la sélection des pages à imprimer, cliquez sur le gadget "Pages sélectionnées". Une fenêtre apparaitra au milieu de l'écran. La partie supérieure de cette fenêtre est une grille de 100 cases, dont les numéros correspondent aux numéros de pages. Les numéros sont écrits en noir sur blanc si la page correspondante est sélectionnée, en noir sur bleu dans le cas contraire. Si vous cliquez sur un numéro, vous inverserez la sélection de la page correspondante. Vous avez également à votre disposition les gadgets suivants : TOUT sélectionne toutes les pages INVERSER inverse la sélection RIEN aucune page n'est sélectionnée VALIDER validation de la nouvelle sélection (ou RETURN) REPRENDRE reprise de la sélection précédente ANNULER annulation de la nouvelle sélection (ou ESCAPE) Vous pouvez également utiliser le gadget de chaine pour spécifier de nouvelles pages à sélectionner (en plus de celles qui le sont déjà). Les valeurs admises dans ce gadget sont : * toutes les pages x page x uniquement x-y pages x à y x,y,z,... pages x,y,z,... Vous pouvez utiliser une combinaisons des deux dernières formes, comme par exemple "1,3,5-8". N'oubliez pas que la sélection dépend du numéro de la première page. Notez enfin que vous ne pourrez valider si aucune page n'est sélectionnée. 3. Concepts avancés : --------------------- Ce chapitre décrit quelques possibilités supplémentaires d'APrf, qui lui permettront de s'intégrer encore mieux dans votre environnement de travail. 3.1 La bibliothèque "powerpacker.library" : ------------------------------------------- APrf utilise la bibliothèque "powerpacker.library", si elle est présente dans le répertoire LIBS: de votre disquette Workbench ou de votre disque dur. Ceci vous permet de demander l'impression d'un fichier compacté par les logiciels "PowerPacker 2.3b" ou "PowerPacker Pro 3.0b" : le fichier sera automatiquement décompacté lors de son chargement. Si le fichier avait été crypté, APrf vous demandera le mot de passe nécessaire à son décodage. 3.2 Le mode "eXpress" : ----------------------- Il se peut, dans certains cas, que vous ayez envie d'imprimer un fichier rapidement, sans faire appel à l'interface Intuition d'APrf (si vos Préférences sont réglées correctement c'est sans doute souvent le cas). Dans ce but, l'option -X a été ajouté à APrf : en présence de cette option, une fois la ligne de commande analysée, l'impression démarre directement. APrf n'ouvre pas d'écran, et s'arrête une fois l'impression achevée. Les messages d'erreur éventuels sont affichés sur l'écran Workbench, dans une fenêtre spéciale. 3.3 Le mode AREXX : ------------------- Lors du démarrage, APrf ouvre systématiquement un port compatible AREXX nommé "APrf_rexx" et attend des messages sur ce port. Les messages peuvent être : quit : APrf ferme le port AREXX et termine wakeup : APrf ferme le port AREXX et lance l'interface Intuition reset : APrf recharge les Préférences et revient aux options par défaut load : APrf charge en mémoire le fichier à imprimer print : APrf lance l'impression Tout autre message est considéré comme une ligne de commande CLI et analysé de la même manière (voir §2.1 pour la syntaxe). En cas d'erreur APrf affiche un message sur l'écran Workbench, dans une fenêtre spéciale, et termine. Si vous envoyez un message "load" sans avoir auparavant indiqué le nom du fichier à imprimer, la commande restera sans effet. Voici un exemple de programme AREXX, qui lance l'impression du fichier S:Startup-Sequence avec une marge gauche de 10 caractères, puis termine APrf : /* Imprime S:Startup-Sequence */ address "APrf_rexx" "S:Startup-Sequence -g10" "print" "quit" Notez les guillemets autour des commandes ! Si vous indiquez l'option "-A" lors de l'appel d'APrf, celui-ci passe en mode AREXX : seule la fenêtre d'application (sous système 2.0) ou la fenêtre d'iconification (sous système 1.3) est ouverte et le programme se met automatiquement en mode iconifié (voir §2.5). Depuis l'interface Intuition, vous pouvez placer APrf en mode AREXX simplement en iconifiant le programme (commande "Iconifie" du menu "Projet" voir §2.5). 3.4 La fenêtre d'application : ------------------------------ Sous système 2.0, APrf ouvre automatiquement une fenêtre d'application (ou "AppWindow") sur l'écran Workbench. Vous avez alors les possibilités suivantes : - si vous sélectionnez une ou plusieurs icônes, et que vous les faites glisser sur la fenêtre d'application, APrf fera passer son écran au premier plan (après l'avoir éventuellement ouvert), et vous pourrez alors imprimer le ou les fichiers comme si vous aviez appelé APrf depuis le Workbench. - si vous cliquez sur le gadget de fermeture de la fenêtre d'application, le programme s'arrêtera (sans confirmation en mode AREXX) - si vous activez la fenêtre d'application et cliquez sur le bouton droit de la souris, APrf ouvrira son écran et l'interface normale sera alors utilisable (équivalent à la commande "wakeup" depuis AREXX) Notez que la fenêtre d'application remplace la fenêtre d'iconification. 3.5 Le fichier "APrf.Init" : ---------------------------- Lors du démarrage, APrf essaye d'accéder au fichier "S:APrf.Init". Ce fichier vous permet de définir des configurations type et/ou des polices. Dans le premier cas, les lignes du fichier doivent avoir le format suivant : nom:options:séquence où "nom" et "options" sont des suites de caractères quelconques (il est conseillé de ne pas dépasser 8 caractères pour "nom"), et "séquence" est une suite de code décimaux, séparés par des espaces. Les parties "options" et "séquence" peuvent être vides. Seules les 8 premières configurations type sont prises en compte. Voici quelques exemples de lignes : mon8lpi:-p90 -O8: landscap:-p80:27 48 108 72 Chaque nom indiqué apparaitra dans un nouveau menu : le menu "Contrôle". Si vous sélectionnez un nom dans ce menu, la chaine "options" sera immédiatement analysée comme une ligne de commande CLI. De plus, lors de l'impression, les caractères dont le code ASCII est indiqué dans la séquence correspondante seront envoyées à l'imprimante (après les séquences normales d'initialisation, mais avant le texte lui-même). Vous pouvez bien entendu sélectionner plusieurs noms en même temps. Lors d'un appel depuis le CLI ou depuis le Workbench, l'option -C (voir §3.1) permet de sélectionner une séquence dès le démarrage. La chaine "option" sera analysée après les options d'appel. Si la séquence spécifiée par l'option -C n'existe pas, cette option sera ignorée. Le fichier "S:APrf.Init" vous permet également d'utiliser, depuis APrf, les polices internes de votre imprimante. Pour cela, il vous suffit de rajouter une ligne de la forme : fontdef:nom:séquence où "nom" est le nom de la police, et "séquence" la suite de codes faisant passer votre imprimante dans la police indiquée. Voici un exemple : fontdef:Prestige:27 107 2 27 120 49 Le nombre de polices n'est pas limité. La sélection de la police peut se faire soit à l'appel, à l'aide de l'option -I (voir §2.1), soit à l'aide du gadget "Police" (voir §2.4). Il est conseillé de placer les définitions de police en début de fichier, avant la définition des configurations type. Vous pouvez également indiquer les couleurs à utiliser pour l'écran de APrf, avec une ligne de la forme : palette: c1 c2 c3 c4 où "c1", "c2", "c3" et "c4" sont les spécifications RVB de chaque couleur. Vous pouvez indiquer ces valeurs en décimal ou en hexadécimal (dans ce cas, ajoutez "0x" devant la valeur, par exemple "0x0F00"). Si vous indiquez plusieurs palettes, seule la dernière sera prise en compte. APrf accepte des lignes vides dans le fichier. Une ligne commençant par un point-virgule (";") sera considérée comme un commentaire et ne sera donc pas interprétée. Le fichier "S:APrf.Init" sera rechargé chaque fois que vous sélectionnerez la commande "Options défaut" dans le menu "Outils". En mode "eXpress" (voir §3.2), le fichier "S:APrf.Init" ne sera chargé qu'en cas de besoin, c'est-à-dire si vous indiquez une option -C ou -I. Notez enfin que les séquences sont envoyées par une commande PRD_RAWWRITE, c'est-à-dire qu'elles ne seront pas interprétées par le pilote d'imprimante. 4. Gestion de la mémoire : -------------------------- Ce chapitre explique comment APrf gère la mémoire qu'il utilise. Je vous conseille de le lire attentivement MEME SI AVEZ UNE EXTENSION MEMOIRE. 4.1 Le fichier à imprimer : --------------------------- Avant d'imprimer ou de pré-visualiser un fichier, APrf le charge entièrement en mémoire. Une fois le traitement terminée, le fichier est conservé en mémoire, ce qui permet d'éviter de le recharger à nouveau si vous demandez ensuite une impression ou une pré-visualisation de ce même fichier. La mémoire occupée par le fichier est libérée automatiquement quand APrf est iconifié (voir §2.5), quand vous choisissez un nouveau fichier à imprimer (voir §2.4), ou quand vous choisissez la commande "Fichier suivant" du menu "Projet" (voir §2.5). Le fichier peut également être libéré (mais dans certains cas seulement) si vous choisissez la commande "Options par défaut" du menu "Outils". Vous pouvez forcer APrf à charger immédiatement le fichier à imprimer avec la commande "Charge fichier" du menu "Outils". Si le fichier était déjà présent en mémoire, il sera rechargé quand même. Vous pouvez également forcer APrf à libérer la mémoire occupée par le fichier avec la commande "Libère fichier" du menu "Outils". Pour vous permettre de savoir si le fichier est chargé en mémoire ou non, APrf affiche le caractère "*" à droite du nom du fichier quand il est chargé en mémoire. Ce mode de fonctionnement peut avoir deux inconvénients. Le premier est que le fichier occupe de la mémoire peut-être inutilement (je pense ici à ceux qui n'ont que 512 Ko de mémoire). Dans ce cas, vous pouvez soit iconifier APrf (voir §2.5, vous gagnez en plus la mémoire occupée par le tampon de sortie, par quelques zones de travail, et au moins 32 Ko de mémoire CHIP), soit utiliser la commande "Libère fichier" du menu "Outils". Le second est que si vous modifiez le fichier sur disquette, ces modifications pourraient ne pas être prises en compte, puisque APrf ne recharge pas le fichier. Pour éviter cela, APrf essaye de détecter si le fichier a été modifié depuis le dernier chargement en mémoire, et si tel est le cas vous propose de le recharger. 4.2 Le tampon de sortie : ------------------------- APrf utilise un tampon de sortie, afin de réduire le nombre d'ordres d'écriture. Avec un tampon d'un kilo-octets, l'écriture vers un fichier se fait au moins deux fois plus rapidement qu'avec les premières versions d'APrf, dont le tampon ne contenait qu'une ligne. L'écriture vers l'imprimante n'est pas accélérée de manière visible. Dans tous les cas, le nombre d'ordres d'écriture est divisé au moins par 5 (cela peut aller jusqu'à 14 ou 15), ce qui réduit sensiblement la charge imposée au systême, et PERMET AINSI DE MOINS RALENTIR LES AUTRES TACHES. Par défaut APrf utilise un tampon d'une page (voir §2.5 l'option "Tampon 1Ko" du menu "Options"), afin de réduire encore plus le nombre d'ordres d'écriture. Quand vous changez la taille de la page, le tampon est automatiquement ré-alloué pour pouvoir contenir une page entière. S'il n'y a plus assez de mémoire pour allouer un tampon d'une page, APrf réduit automatiquement la taille du tampon à un kilo-octets. S'il n'est pas possible d'allouer ce tampon d'un kilo-octets, APrf s'arrête et affiche le message d'erreur "Plus de mémoire libre". 4.3 Mémoire nécessaire : ------------------------ Le chargement du programme en mémoire et l'ouverture de l'écran (avec gadgets et menus) nécessitent un peu plus de 100 Ko. Toute opération sur le fichier à imprimer (impression, pré-visualisation, "doc info", etc...) provoque le chargement de ce fichier en mémoire, l'allocation d'un tampon d'une page de (NombreDeLignes * LargeurDesLignes) octets pour la composition des pages. Une impression provoque de plus l'allocation d'un tampon de sortie, d'une page ou d'un kilo-octet (suivant la mémoire disponible). 5. Divers : ----------- Ce chapitre est un bric-à-brac de quelques indications qui n'ont pas trouvé place dans les autres paragraphes. Il contient certains détails importants sur le fonctionnement du programme. Je vous conseille donc de lire attentivement ce qui suit, au moins une fois, et de penser à le relire si APrf vous semble se comporter de manière bizarre. Voici comment APrf réagit si l'option "Continu" est désactivée : avant d'envoyer une page à l'imprimante, une boite de requête apparait, vous demandant d'introduire une nouvelle feuille dans l'imprimante. Quand vous êtes prêt, cliquez sur "OUI" : la page sera envoyée à l'imprimante. Si vous cliquez sur "NON" l'impression sera abandonnée. Si vous désirez interrompre une impression, cliquez dans le cadre où est affiché le numéro de l'exemplaire et de la page en cours d'impression. Une boite de requète apparait alors, pour vous demander confirmation : cliquez sur "OUI" pour arrêter l'impression, ou cliquez sur "NON" pour reprendre l'impression. Si vous confirmez l'arrêt de l'impression, l'envoi des données à l'imprimante est alors suspendu, ce qui ne veut pas forcément dire que l'impression s'arrête tout de suite : il faut attendre que l'imprimante ait vidé son tampon. Un message apparait pour vous informer que votre demande a été prise en compte, et APrf attend que l'ordre d'écriture en cours soit terminé (cela peut prendre un certain temps !). Pour vous permettre d'améliorer la présentation de vos documents, APrf reconnait les séquences ANSI suivantes : ESC[0m caractères normaux ESC[3m début d'italique ESC[23m fin d'italique ESC[4m début de souligné ESC[24m fin de souligné ESC[1m début de gras ESC[22m fin de gras ESC[1"z qualité listing ESC[2"z qualité courrier Ces séquences sont envoyées à l'imprimante, mais les caractères qui les composent ne sont pas pris en compte dans le calcul de la mise en page. De même, ils n'apparaissent pas lors de la pré-visualisation. Toute autre séquence ne sera pas reconnue, et sera considéré comme faisant partie du texte à imprimer. Vous pouvez filtrer ces séquences, si vous ne souhaitez pas qu'elles soient envoyées à l'imprimante (voir §2.5, option "Filtre ANSI" du menu "Options"). La taille de ces séquences est limitée à 32 caractères par LIGNE DE SORTIE (et non par ligne du fichier à imprimer). Cela correspond à 6 ou 8 séquences, et devrait être suffisant dans la plupart des cas. S'il y a trop de séquences sur une ligne de sortie, le message d'erreur "Lignes trop longues, impression abandonnée" apparaitra en cours d'impression. Sauf si le filtrage des caractères de contrôle est actif, un caractère "Saut de page" dans le fichier à imprimer provoquera un saut de page lors de l'impression. Notez enfin que les caractères "Backspace" (code ASCII 8) ne sont pas comptés lors de la composition des lignes.