home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Amiga GigaPD 3
/
Amiga_GigaPD_v3_3of3.iso
/
fred_fish
/
fish_601-700_lha
/
fish_628.lha
/
aprf
/
APrf.doc
< prev
next >
Wrap
Text File
|
1993-06-02
|
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.