home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Club Amiga de Montreal - CAM
/
CAM_CD_1.iso
/
files
/
626b.lha
/
APrf_v5.00
/
APrf.doc
< prev
next >
Wrap
Text File
|
1992-04-08
|
38KB
|
998 lines
APrf v5.00 - Manuel d'utilisation
Ce manuel décrit la version 5.00 de l'utilitaire APrf. Ce programme
est placé dans le domaine public, avec autorisation de le copier librement
et de le diffuser par n'importe quel moyen, à condition que le produit soit
diffusé dans son intégralité, et sans aucune modification.
APrf est ©1989-1990-1991-1992 par Denis GOUNELLE, toute utilisation
commerciale ou vente de ce programme sans autorisation écrite est
STRICTEMENT INTERDITE. Serge HAMMOUCHE est autorisé à diffuser APrf aux
conditions qu'il voudra.
"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.
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 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 :
----------------
APrf est un utilitaire d'impression de fichiers texte, développé
pour l'Amiga. Il permet entre autres l'ajout d'une entête ou d'un pied de
page, l'ajout 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, 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 à Jean-Yves PROUX, Michel SCHINZ, Serge HAMMOUCHE, Pierre
VITET, et Jean ROUGELIN pour leurs tests et leurs idées.
2. Mode d'emploi :
------------------
APrf peut être lancé aussi bien depuis le CLI que depuis le
WorkBench. Si vous appelez APrf depuis le CLI, je vous conseille de le
faire par une commande "RunBackGround" ou "ARun", car APrf ne se détache
pas du CLI. La meilleure solution, à mon avis, est de définir un alias dans
votre fichier "S:Shell-Startup", comme par exemple :
Alias APrf C:RunBackGround SYS:Utilities/APrf []
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}][-N#]
[-Oopts][-P{p|e|f}][-Spages][-X]
Si on précise l'argument <fichier>, 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. # peut prendre les
valeurs :
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.
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.4).
-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.
-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
s 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 à
l'intérieur de la fenêtre (ou appuyez sur une touche) 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 "WorkBench" du WorkBench, et choisissez la commande "Info".
Ensuite, cliquez sur le gadget ADD de la zone "TOOL TYPES", et ajoutez 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}][-N#][-Oopts]
[-P{p|e|f}][-Spages]
Ces options sont décrites au paragraphe précédent (§2.1).
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 :
----------------------------
Si tout se passe bien, un écran s'ouvre, sur lequel apparaissent
une vingtaine de gadgets. Sinon une fenêtre apparait sur l'écran WorkBench,
indiquant le problème rencontré. Cliquez à l'intérieur de la fenêtre (ou
appuyez sur une touche) 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 quatre cas :
a) APrf n'a pu ouvrir la bibliothèque "intuition.library"
b) APrf n'a pu ouvrir la bibliothèque "graphics.library"
c) APrf n'a pu ouvrir la fenêtre pour afficher le message d'erreur
d) APrf n'a pu ouvrir l'écran WorkBench
Il est cependant fort peu probable que vous soyez confrontés à
cette situation.
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 ANNULER,
ou sur le gadget VALIDER sans avoir choisit 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 ANNULER,
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. Cliquez sur la flèche vers le haut pour augmenter cette valeur, et sur
la flèche vers le bas pour la réduite. Si la valeur ne change pas, c'est
que vous avez atteint la limite inférieure ou supérieure admise pour ce
paramêtre. La valeur augmente ou diminue automatiquement tant que vous
appuyez sur 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 trois 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.
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.
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.
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).
Pour modifier la valeur de ce gadget il suffit de cliquer
dessus.
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.
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 "Mode AREXX" (Amiga-A) :
Place APrf en mode AREXX (voir §3.3).
Une boite de requête apparaitra pour vous demander
confirmation, cliquez sur "OUI" ou appuyez sur la touche
RETURN pour passer en mode AREXX, cliquez sur "NON" ou
appuyez sur la touche ESCAPE pour rester en mode normal.
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 une petite
fenêtre dont le titre est "APrf v5.00" vient se placer dans
le coin supérieur gauche de l'écran WorkBench.
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 petite fenêtre.
Commande "Quitte" (Amiga-Q ou ESCAPE) :
Termine l'exécution d'APrf.
Une boite de requête apparaitra pour vous demander
confirmation, cliquez sur "OUI" ou appuyez sur la touche
RETURN pour quitter, cliquez sur "NON" ou appuyez sur la
touche ESCAPE pour ne pas quitter APrf.
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 "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 à l'intérieur ou
appuyez sur une touche.
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 "Envoit 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.
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 :
-------------------
Si vous indiquez l'option -A lors de l'appel d'APrf, celui-ci passe
en mode AREXX : un port compatible AREXX nommé "APrf_rexx" est ouvert, et
le programme attend des messages sur ce port. L'emploi de l'option -A fait
obligatoirement passer APrf en mode "eXpress" (voir §3.2).
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 !
Depuis l'interface Intuition, vous pouvez placer APrf en mode AREXX
à l'aide de la commande "Mode AREXX" du menu "Projet" (voir §2.5).
3.4 Le fichier "APrf.Init" :
----------------------------
Lors du démarrage, APrf essaye de charger le fichier "S:APrf.Init"
S'il existe, les huits premières lignes de ce fichier sont lues et donnent
accès à un nouveau menu : le menu "Contrôle". Les lignes du fichier doivent
obligatoirement 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. Voici quelques exemples de lignes :
mon8lpi:-p90 -O8:
landscap:-p80:27 48 108 72
Chaque nom indiqué apparaitra dans le nouveau 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.
Notez 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.
Le fichier "S:APrf.Init" sera rechargé et le menu "Contrôle" mis à
jour chaque fois que vous sélectionnerez la commande "Options défaut" dans
le menu "Outils".
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.
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.
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 ne seront pas prises en compte, puisque APrf ne rechargera
pas le fichier. Dans ce second cas, utilisez la commande "Charge fichier"
du menu "Outils", pour demander à APrf de recharger le fichier à imprimer.
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" ou appuyez sur la touche RETURN : la page
sera envoyée à l'imprimante. Si vous cliquez sur "NON" ou appuyez sur la
touche ESCAPE, 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" ou appuyez sur la touche RETURN pour
arrêter l'impression, cliquez sur "NON" ou appuyez sur la touche ESCAPE
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.