home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_2.iso / files / 694a.lha / APrfII_v2.00 / APrf.doc.pp / APrf.doc
Text File  |  1992-11-16  |  44KB  |  1,119 lines
  1.  
  2.             APrf2 v2.00 - Manuel d'utilisation
  3.  
  4.  
  5.  
  6.  
  7.  
  8.     Ce manuel décrit la version 2.00 de l'utilitaire APrf2. Ce programme
  9. est (c)1989-1990-1991-1992 par Denis GOUNELLE, toute utilisation commerciale
  10. ou vente sans autorisation écrite est  strictement  interdite.    Vous  pouvez
  11. copier et diffuser ce programme aux conditions suivantes :
  12.  
  13.     - l'ensemble des fichiers doit être fourni
  14.     - aucun fichier ne doit avoir été modifié
  15.     - vous ne devez pas demander plus de 40FF pour cela
  16.  
  17.     "PowerPacker 2.3b" est (c)1989  par  PowerPeak  et  Nico  FRANCOIS,
  18. "PowerPacker Pro 3.0b" est (c)1990 par PowerPeak et par  UGA  Software.  La
  19. bibliothèque "powerpacker.library" est (c)1990 par Nico FRANCOIS. AREXX est
  20. (c)1987 par William Hawes. La bibliothèque "reqtools.library" est  (c)1990-
  21. 1991 par Nico FRANCOIS.
  22.  
  23.     Malgrès de nombreux tests, je ne peux garantir qu'APrf ne  contient
  24. aucune erreur. VOUS UTILISEZ CE PROGRAMME A VOS RISQUES ET  PERILS.  Je  ne
  25. pourrai en aucun cas être tenu    responsable  de  tout  dommage,  direct  ou
  26. indirect, résultant de l'utilisation d'APrf.
  27.  
  28.  
  29. Sommaire :
  30. ----------
  31.  
  32.     1. Introduction
  33.     2. Mode d'emploi
  34.        2.1 Appel depuis le CLI
  35.        2.2 Appel depuis le Workbench
  36.        2.3 Démarrage du programme
  37.        2.4 Les gadgets
  38.        2.5 Les menus
  39.        2.6 Entête et pied de page
  40.        2.7 La pré-visualisation
  41.        2.8 Modification de la sélection
  42.     3. Concepts avancés
  43.        3.1 La bibliothèque "powerpacker.library"
  44.        3.2 Le mode "eXpress"
  45.        3.3 Le mode AREXX
  46.        3.4 La fenêtre d'application (AppWindow)
  47.        3.5 Le fichier "APrf.Init"
  48.     4. Gestion de la mémoire
  49.        4.1 Le fichier à imprimer
  50.        4.2 Le tampon de sortie
  51.        4.3 Mémoire nécessaire
  52.     5. Divers
  53.  
  54.  
  55. 1.Introduction :
  56. ----------------
  57.  
  58.     APrf2 est une nouvelle version    de  APrf,  capable  d'utiliser  les
  59. fonctions de la version 2.0 du système. Ce  programme  peut  toujours  être
  60. utilisé avec le système 1.3, bien que certaines des nouvelles  possibilités
  61. ne soient pas disponibles dans ce cas.
  62.     APrf est un  utilitaire  d'impression  qui  permet  (entre  autres)
  63. l'ajout d'une entête, d'un pied de page, de  marges,  la  numérotation  des
  64. lignes, l'impression sur plusieurs colonnes, etc...  et utilise les valeurs
  65. fixées dans les Préférences. APrf dispose  de  plus  d'un  port  compatible
  66. AREXX, d'une  fenêtre  d'application  (ou  "AppWindow",  sous  système  2.0
  67. uniquement) et peut charger des fichiers compactés par    "PowerPacker  2.3b"
  68. ou par "PowerPacker Pro 3.0b".
  69.  
  70.     Vous pouvez me faire part de vos remarques ou critiques  sur  APrf,
  71. en écrivant à l'adresse suivante :
  72.  
  73.               M. GOUNELLE Denis
  74.                   Boite 71
  75.              6, rue des cailloux
  76.             92110 CLICHY - FRANCE
  77.  
  78.     Merci à Serge HAMMOUCHE, Jean-Yves PROUX, Jean-Philippe RAPP,  Jean
  79. ROUGELIN, Michel SCHINZ, et Pierre VITET, pour leurs tests et leurs idées.
  80.     En France, la dernière    version  de  ce  programme  est  disponible
  81. auprès de Serge HAMMOUCHE, 3 rue  Anatole  France,  13220  Chateauneuf-les-
  82. Martigues. Pour recevoir le catalogue complet,    il  vous  suffit  d'envoyer
  83. deux timbres à cette adresse.
  84.  
  85.  
  86. 2. Mode d'emploi :
  87. ------------------
  88.  
  89.     APrf peut être lancé aussi bien depuis le Workbench que  depuis  le
  90. CLI. Dans ce dernier cas, il n'y  a  pas  besoin  d'utiliser  une  commande
  91. "RunBack" ou "ARun", car APrf se détache automatiquement de la fenêtre CLI.
  92.  
  93.  
  94.     2.1 Appel depuis le CLI :
  95.     -------------------------
  96.  
  97.     Depuis le CLI, on peut appeler APrf avec une  série  d'options  qui
  98. permettent de modifier les paramêtres par défaut. La syntaxe de la ligne de
  99. commande est :
  100.  
  101.         APrf [fichier][-c#][-d#][-e#][-f#,#][-g#][-n#][-p#][-t#][-vF]
  102.          [-x#][-A][-Cseq][-D#][-E{G|C|D}fmt][-F{G|C|D}][-Ifont]
  103.          [-N#][-Oopts][-P{p|e|f}][-Spages][-X]
  104.  
  105.     Si  on    précise l'argument <fichier>, le fichier correspondant sera
  106. considéré  comme  le  fichier  à imprimer.  Voici la description des autres
  107. options :
  108.  
  109.     -c#    (nombre de Colonnes)
  110.         Imprime sur # colonnes.
  111.         Valeur par défaut : # = 1.
  112.         Valeur minimale   : # = 1. Valeur maximale : # = 999.
  113.  
  114.     -d#    (marge Droite)
  115.         Ajoute    une  marge  droite de # caractères.  Notez que
  116.         les  marges fixées dans les Préférences sont prises en
  117.         compte quoi qu'il arrive.
  118.         Valeur par défaut : # = 0.
  119.         Valeur minimale   : # = 0. Valeur maximale : # = 999.
  120.  
  121.     -e#    (Espacement)
  122.         Sépare les colonnes par # espaces.
  123.         Valeur par défaut : # = 1.
  124.         Valeur minimale   : # = 1. Valeur maximale : # = 999.
  125.  
  126.     -f#,#    (Format de page)
  127.         Sélectionne le format de la page et les pages où faire
  128.         la présentation. Le premier # peut prendre les valeurs
  129.         suivantes :
  130.  
  131.             0 : pas de format particulier
  132.             1 : ajoute une entête
  133.             2 : ajoute un pied de page
  134.             3 : ajoute une entête et un pied de page
  135.  
  136.             Valeur par défaut : # = 1.
  137.  
  138.         Le second # peut prendre les valeurs suivantes :
  139.  
  140.             0 : sur toutes les pages
  141.             1 : sur toutes les pages sauf la première
  142.             2 : sur les pages paires
  143.             3 : sur les pages impaires
  144.  
  145.             Valeur par défaut : # = 0
  146.  
  147.         Il est possible de n'indiquer qu'un seul  paramètre  :
  148.         les formes "-f1,2", "-f1" et "-f,2" sont acceptées.
  149.         Pour plus de détails voir §2.6.
  150.  
  151.     -g#    (marge Gauche)
  152.         Ajoute    une  marge  gauche de # caractères.  Notez que
  153.         les  marges fixées dans les Préférences sont prises en
  154.         compte quoi qu'il arrive.
  155.         Valeur par défaut : # = 0.
  156.         Valeur minimale   : # = 0. Valeur maximale : # = 999.
  157.  
  158.     -n#    (Numérotation des lignes)
  159.         Numérote les lignes (numéros de # chiffres).
  160.         Valeur par défaut : # = 0 (pas de numéros de ligne).
  161.         Valeur minimale   : # = 0. Valeur maximale : # = 10.
  162.  
  163.     -p#    (longueur des Pages)
  164.         Imprime par pages de # lignes.
  165.         Valeur par défaut : "Paper Length" des Préférences.
  166.         Valeur minimale   : # = 5. Valeur maximale : # = 999.
  167.  
  168.     -t#    (Tabulation)
  169.         Règle  les  positions des tabulations sur les colonnes
  170.         #+1, 2#+1, 3#+1, etc...
  171.         Valeur par défaut : # = 8.
  172.         Valeur minimale   : # = 1. Valeur maximale : # = 999.
  173.  
  174.     -vF    (Vers)
  175.         L'impression est redirigée vers le fichier F.
  176.  
  177.     -x#    (eXemplaires)
  178.         Imprime # exemplaires du fichier.
  179.         Valeur par défaut : # = 1.
  180.         Valeur minimale   : # = 1. Valeur maximale : # = 999.
  181.  
  182.     -A    (mode AREXX)
  183.         Place APrf en mode AREXX (voir §3.3)
  184.  
  185.     -Cseq    (séquence de Contrôle)
  186.         Sélectionne la séquence de contrôle "seq" (voir §3.5).
  187.  
  188.     -D#    (format de la Date)
  189.         Indique le format de la date dans l'entête. # peut prendre
  190.         les valeurs :
  191.  
  192.             0 : format AmigaDOS (jj-mmm-aa)
  193.             1 : format international (aa-mm-jj)
  194.             2 : format américain (mm-jj-aa)
  195.             3 : format européen (jj-mm-aa)
  196.  
  197.         Valeur par défaut : # = 0.
  198.         Pour plus de détails voir §2.6.
  199.  
  200.     -E{G|C|D}fmt (format de l'Entête)
  201.         Indique le format de l'entête.
  202.         Pour plus de détails voir §2.6.
  203.  
  204.     -F{G|C|D}fmt (format du pied de page)
  205.         Indique le format du pied de page.
  206.         Pour plus de détails voir §2.6.
  207.  
  208.     -Ifont    (police Interne)
  209.         Sélectionne la police interne indiquée.
  210.         Pour plus de détails voir §3.5.
  211.  
  212.     -N#    (Numéro de la première page)
  213.         La numérotation des pages commence au nombre #.
  214.         Valeur par défaut : # = 1.
  215.         Valeur minimale   : # = 1. Valeur maximale : # = 899.
  216.  
  217.     -Oopts    (Options)
  218.         Permet de modifier certaines options. opts est une
  219.         combinaison quelconque des caractères :
  220.  
  221.             c    qualité courrier
  222.             l    qualité listing
  223.             8    interligne 8LPI
  224.             6    interligne 6LPI
  225.             C    alimentation papier continu
  226.             F    alimentation feuilles à feuilles
  227.             t    tronque les lignes trop longues
  228.             f    filtre les caractères de contrôle
  229.             a    filtre les séquences d'échappement
  230.             k    tampon de sortie d'un kilo-octets
  231.             n    n'envoit pas de sauts de page
  232.             u    souligne l'entête
  233.  
  234.         Voir la description du menu "Options" au §2.5 pour plus
  235.         de détails.
  236.  
  237.     -P{p|e|f} (Pas d'impression)
  238.         Permet de sélectionner le pas d'impression :
  239.  
  240.             -Pp pour le pas "pica"
  241.             -Pe pour le pas "elite"
  242.             -Pf pour le pas "fine"
  243.  
  244.         Valeur par défaut : "Pitch" des Préférences.
  245.  
  246.     -Spages (Sélection)
  247.         Permet    de  sélectionner  les  pages  à  imprimer.  La
  248.         sélection peut prendre les formes suivantes :
  249.  
  250.             x      : page x uniquement
  251.             x-y      : pages x à y
  252.             x,y,z,... : pages x,y,z,...
  253.  
  254.         Vous pouvez également utiliser une combinaisons des deux
  255.         dernières formes, comme par exemple "-S1,3,5-8".
  256.  
  257.         ATTENTION : les numéros de page indiqués dans la sélection
  258.                 doivent tenir compte du numéro de la  première
  259.                 page (voir option -N)
  260.  
  261.     -X    (eXpress)
  262.         Lance APrf en mode eXpress (voir §3.2).
  263.  
  264.  
  265.     En cas d'erreur dans la ligne de commande, une fenêtre apparait sur
  266. l'écran Workbench, portant le message "Arguments incorrects".  Cliquez  sur
  267. le gadget "OK" pour la faire disparaitre, et relancez APrf après correction
  268. de la ligne de commande.
  269.     Notez que le menu "Outils"  possède  une  commande  qui  permet  de
  270. savoir quelles options de la ligne de commande    correspondent  aux  options
  271. courantes (voir §2.5 pour plus de détails).
  272.  
  273.  
  274.     2.2 Appel depuis le Workbench :
  275.     -------------------------------
  276.  
  277.     Il y a trois façon d'appeler APrf depuis le Workbench quand on veut
  278. lui indiquer le ou les fichiers à imprimer :
  279.  
  280.      - en double-cliquant sur une icône de  type  "Project"  qui  a  APrf
  281.        comme outil par défaut ("Default tool")
  282.      - en cliquant sur une  ou    plusieurs  icônes  de  fichiers  puis  en
  283.        double-cliquant sur l'icône d'APrf tout en gardant la touche SHIFT
  284.        enfoncée.
  285.      - en cliquant sur l'icône d'APrf (et éventuellement sur  des  icônes
  286.        de fichiers) puis en double-cliquant sur une icône de fichier tout
  287.        en gardant la touche SHIFT enfoncée.
  288.  
  289.     Dans tous les cas, le ou les fichiers sélectionnés sont transmis  à
  290. APrf, qui affiche le nom du premier  fichier  dans  le    gadget    "Fichier  à
  291. imprimer" (voir §2.4). La  commande  "Fichier  suivant"  du  menu  "Projet"
  292. permet de passer au fichier suivant (voir §2.5), et  la  commande  "Options
  293. défaut" du menu "Outils" permet de revenir au premier fichier de  la  liste
  294. (voir §2.5).
  295.  
  296.     Comme pour l'appel depuis le CLI, il est  possible  d'appeler  APrf
  297. avec des options. Pour ce faire, cliquez sur l'icône du fichier à imprimer,
  298. appelez le menu "Icons" du Workbench et  choisissez  l'item  "Information".
  299. Ensuite, cliquez sur le gadget "New" de la zone "TOOL TYPES" et entrez  les
  300. options en respectant la syntaxe suivante :
  301.  
  302.       APRF=[-c#][-d#][-e#][-f#,#][-g#][-n#][-p#][-t#][-vF][-x#]
  303.            [-Cseq][-D#][-E{G|C|D}fmt][-F{G|C|D}][-Ifont][-N#]
  304.            [-Oopts][-P{p|e|f}][-Spages]
  305.  
  306.     Ces options sont décrites au paragraphe précédent (§2.1).  Si  vous
  307. appelez APrf depuis le Workbench sans arguments (juste  en  double-cliquant
  308. sur l'icône d'APrf) les options seront cherchées dans le champ "TOOL TYPES"
  309. de l'icône d'APrf.
  310.     Notez que les options -A (mode  AREXX)  et  -X  (mode  eXpress)  ne
  311. peuvent être utilisées en cas d'appel depuis le Workbench.
  312.  
  313.  
  314.     2.3 Démarrage du programme :
  315.     ----------------------------
  316.  
  317.     APrf utilise la version 2.0c de la bibliothèque "reqtools.library".
  318. Vous devez donc copier cette bibliothèque dans le répertoire "LIBS:", si ce
  319. n'est déjà fait.
  320.  
  321.     Si  tout  se  passe bien, un écran s'ouvre, sur lequel apparaissent
  322. une vingtaine de gadgets. Un port AREXX est également ouvert  (voir  §3.3).
  323. Sous système 2.0, APrf    ouvre  systématiquement  une  "AppWindow"  (fenêtre
  324. d'application, voir §3.4).
  325.     Sinon une fenêtre apparait  sur  l'écran  Workbench,  indiquant  le
  326. problème rencontré. Cliquez sur le gadget "OK" pour la  faire  disparaitre,
  327. APrf s'arrête et retourne la  valeur   10   (ERROR,  voir  commande  IF  de
  328. l'AmigaDOS).
  329.  
  330.     Il  se peut que APrf rende la main sans dire pourquoi, c'est-à-dire
  331. sans afficher aucun message, mais en retournant  cependant  la    valeur    10.
  332. Ceci ne peut se produire que dans trois cas :
  333.  
  334.     a) APrf n'a pu ouvrir la bibliothèque "reqtools.library"
  335.     b) APrf n'a pu ouvrir la fenêtre pour afficher le message d'erreur
  336.     c) APrf n'a pu ouvrir l'écran Workbench
  337.  
  338.     Je suppose maintenant que le programme a démarré correctement.    Les
  339. deux  paragraphes  qui    suivent  vont  vous  expliquer comment utiliser les
  340. gadgets et les menus d'APrf. Si vous utilisez APrf pour la  première  fois,
  341. je vous conseille de lancer  le  programme afin de pouvoir mieux suivre les
  342. explications.
  343.  
  344.  
  345.     2.4 Les gadgets :
  346.     -----------------
  347.  
  348.     Ce paragraphe décrit les gadgets affichés sur l'écran, de  haut  en
  349. bas et de gauche à droite.
  350.  
  351.     Fichier à imprimer :
  352.  
  353.         Ce gadget indique le nom du fichier à imprimer.
  354.         Pour modifier sa valeur il suffit de  cliquer  dessus.    Une
  355.         boite de requête apparait, vous permettant  de    choisir  le
  356.         fichier à imprimer. Si vous cliquez sur le gadget "CANCEL",
  357.         ou sur    le  gadget  "OK"  sans  avoir  choisi  de  fichier,
  358.         l'ancien nom de fichier sera conservé.
  359.         Le caractère "*" apparait à droite du nom de fichier  quand
  360.         le fichier est chargé en mémoire (voir §4.1).
  361.  
  362.     Fichier de sortie :
  363.  
  364.         Ce gadget indique où sera envoyée l'impression.
  365.         Par  défaut  il indique "PRT:", mais cette valeur peut être
  366.         changée à l'appel grâce à l'option -v (voir §2.1).
  367.         Pour modifier la valeur de ce gadget, il suffit de  cliquer
  368.         dessus. Une boite de requête apparait, vous  permettant  de
  369.         choisir le fichier de sortie. Si vous cliquez sur "CANCEL",
  370.         le fichier de sortie devient "PRT:".
  371.  
  372.     Pages sélectionnées :
  373.  
  374.         Ce gadget indique quelles pages  seront  imprimées.
  375.         Par défaut il indique "*",  ce  qui  signifie  "toutes  les
  376.         pages", mais cette valeur peut être changée à l'appel grâce
  377.         à l'option -S (voir §2.1).
  378.         Pour modifier la valeur de la sélection,  reportez-vous  au
  379.         §2.8.
  380.  
  381.     Les neufs gadgets suivants permettent de spécifier respectivement :
  382. la taille de la marge gauche, la taille de la marge droite, la longueur des
  383. tabulations, le nombre de lignes par page, le numéro de la  première  page,
  384. la taille des numéros de lignes, le nombre de  colonnes,  l'espacement  des
  385. colonnes, et le nombre d'exemplaires à imprimer.
  386.     Chacun    de  ces gadgets indique la  valeur  actuelle  du  paramêtre
  387. correspondant, suivit par une flèche vers le haut et  une  flèche  vers  le
  388. bas. Vous pouvez cliquer sur la valeur, et la modifier au clavier  (appuyez
  389. sur Amiga-X pour effacer la valeur précédente, n'oubliez pas d'appuyer  sur
  390. <RETURN> pour valider la nouvelle valeur). Vous  pouvez  également  cliquez
  391. sur la flèche vers le haut pour augmenter la valeur, ou sur la flèche  vers
  392. le bas pour la réduire. Si la valeur ne change pas,  c'est  que  vous  avez
  393. atteind la limite inférieure ou supérieure admise  pour  ce  paramêtre.  La
  394. valeur augmente ou diminue automatiquement tant que  vous  appuyez  sur  le
  395. bouton gauche de la souris.
  396.  
  397.     Marge gauche : (voir §2.1, option -g)
  398.         Valeur par défaut : 0
  399.         Valeur minimale   : 0
  400.         Valeur maximale   : 999
  401.  
  402.     Marge droite : (voir §2.1, option -d)
  403.         Valeur par défaut : 0
  404.         Valeur minimale   : 0
  405.         Valeur maximale   : 999
  406.  
  407.     Tabulation : (voir §2.1, option -t)
  408.         Valeur par défaut : 8
  409.         Valeur minimale   : 1
  410.         Valeur maximale   : 999
  411.  
  412.     Lignes par page : (voir §2.1, option -p)
  413.         Valeur par défaut : "Paper length" des Préférences
  414.         Valeur minimale   : 5
  415.         Valeur maximale   : 999
  416.  
  417.     No première page : (voir §2.1, option -N)
  418.         Valeur par défaut : 1
  419.         Valeur minimale   : 1
  420.         Valeur maximale   : 899
  421.  
  422.         NOTE : la sélection des pages est effacée à chaque
  423.                modification du numéro de la première page.
  424.  
  425.     No de lignes : (voir §2.1, option -n)
  426.         Valeur par défaut : 0 (pas de numéros de ligne)
  427.         Valeur minimale   : 0 (pas de numéros de ligne)
  428.         Valeur maximale   : 10
  429.  
  430.     Colonnes : (voir §2.1, option -c)
  431.         Valeur par défaut : 1
  432.         Valeur minimale   : 1
  433.         Valeur maximale   : 999
  434.  
  435.     Espacement : (voir §2.1, option -e)
  436.         Valeur par défaut : 1
  437.         Valeur minimale   : 1
  438.         Valeur maximale   : 999
  439.  
  440.     Exemplaires : (voir §2.1, option -x)
  441.         Valeur par défaut : 1
  442.         Valeur minimale   : 1
  443.         Valeur maximale   : 999
  444.  
  445.     Les cinq gadgets suivants proposent différentes valeurs,  que  vous
  446. pouvez faire défiler en cliquant sur le gadget en forme de  flèche  affiché
  447. juste à droite de la valeur. Si vous appuyez sur une des touches  SHIFT  en
  448. même temps, les valeurs défileront en sens inverse.
  449.  
  450.     Caractères :
  451.  
  452.         Ce gadget indique le pas d'impression. Par défaut,  le  pas
  453.         est celui indiqué dans le champ  "Pitch"  des  Préférences,
  454.         mais cela peut être changé à l'appel grâce  à  l'option  -P
  455.         (voir §2.1).
  456.  
  457.     Police :
  458.  
  459.         Ce gadget indique la police interne à utiliser. Normalement
  460.         il s'agit de la police par  défaut,  mais  cela  peut  être
  461.         changé à l'appel grâce à l'option -I (voir §2.1).
  462.         Pour plus de détails, voir §3.5.
  463.  
  464.     Format Date :
  465.  
  466.         Ce gagdet indique dans quel format sera la date. Par défaut
  467.         le format est le  format  AmigaDOS,  mais  ceci  peut  être
  468.         changé à l'appel grâce à l'option -D (voir §2.1).
  469.         Pour plus de détails, voir §2.6.
  470.  
  471.     Format Page :
  472.  
  473.         Ce gadget indique le format de page courant
  474.         Par défaut le format est  "entête",  mais  ceci  peut  être
  475.         changé à l'appel grâce à l'option -f (voir §2.1).
  476.         Pour plus de détails, voir §2.6.
  477.  
  478.     sur :
  479.  
  480.         Ce gadget indique sur quelles pages seront ajoutés l'entête
  481.         et/ou le pied de page.
  482.         Par défaut, ce sera sur toutes les pages,  mais  ceci  peut
  483.         être changé à l'appel grâce à l'option -f (voir §2.1).
  484.         Pour plus de détails, voir §2.6.
  485.  
  486.     Les gadgets suivants vous permettent de personnaliser  l'entête  et
  487. le pied de page.
  488.  
  489.     Entête :
  490.  
  491.         Ce gadget indique le format des trois parties de l'entête :
  492.         la partie gauche, la partie centrale, et la partie  droite.
  493.         La valeur par défaut de chaque partie peut être  changée  à
  494.         l'appel grâce à l'option -E (voir §2.1).
  495.         Pour modifier la valeur d'une des parties, il  vous  suffit
  496.         de cliquer dessus : une   fenêtre   avec   un    gadget     de
  497.         chaine apparait alors. Appuyez sur Amiga-X pour effacer  la
  498.         valeur, sur RETURN pour valider, ou cliquez sur  le  bouton
  499.         de fermeture pour annuler l'opération.
  500.         Pour plus de détails, voir §2.6.
  501.  
  502.     Pied de page :
  503.  
  504.         Fonctionne de la même façon que pour  l'entête.  La  valeur
  505.         par défaut peut être changée à l'appel grâce à l'option  -F
  506.         (voir §2.1).
  507.         Pour plus de détails, voir §2.6.
  508.  
  509.     Les deux gadgets en forme de losange, en bas de l'écran, permettent
  510. de lancer l'impression (celui de gauche) et de lancer la  pré-visualisation
  511. (celui de droite) sans avoir à passer par les menus.
  512.     Vous pouvez également cliquer sur le  gadget  de  fermeture  de  la
  513. fenêtre principale (en haut à gauche) pour quitter le programme, ou sur  le
  514. gadget "zoom" (en haut à droite, sous système 2.0 uniquement) pour iconifier
  515. APrf.
  516.  
  517.  
  518.     2.5 Les menus :
  519.     ---------------
  520.  
  521.     APrf possède trois menus : le menu "Projet", le menu "Outils" et le
  522. menu "Options". Chaque commande peut  être  sélectionnée  à  l'aide  de  la
  523. souris ou de raccourcis clavier, par contre les items du menu "Options"  ne
  524. peuvent être modifiés qu'à la souris. Les rubriques du menu  "Projet"  sont
  525. les suivantes :
  526.  
  527.     Commande "Fichier suivant" (Amiga-F) :
  528.  
  529.         Si l'on a appelé APrf depuis le Workbench en  sélectionnant
  530.         plusieurs fichiers, cette  commande  permet  de  passer  au
  531.         fichier suivant dans la liste des fichiers sélectionnés.
  532.         Le gadget "Fichier à imprimer" est mis à jour  (voir  §2.4)
  533.         et l'ancien fichier est vidé  de  la  mémoire  (s'il  était
  534.         chargé, voir §4.1).
  535.  
  536.     Commande "Imprime" (Amiga-P) :
  537.  
  538.         Lance l'impression.
  539.  
  540.     Commande "Palette" :
  541.  
  542.         Vous permet de modifier les couleurs de l'écran de APrf.
  543.         Pour sauvegarder la nouvelle palette immédiatement, appelez
  544.         la commande "Sauve config" et entrez "palette" comme nom de
  545.         configuration.    Sinon,    lorsque  vous  voudrez    quitter  le
  546.         programme, APrf vous demandera si  vous  voulez  sauver  la
  547.         nouvelle palette.
  548.  
  549.     Commande "A Propos..." (Amiga-?) :
  550.  
  551.         Affiche  quelques  informations  sur   APrf.   Pour   faire
  552.         disparaitre la fenêtre, cliquez à  l'intérieur  ou  appuyez
  553.         sur une touche.
  554.  
  555.     Commande "Iconifie" (Amiga-I) :
  556.  
  557.         Iconifie APrf. L'écran d'APrf est fermé  et,  sous  système
  558.         1.3 une petite fenêtre dont  le  titre    est  "APrf2  v2.00"
  559.         vient se placer dans le coin supérieur    gauche    de  l'écran
  560.         Workbench. Sous système 2.0, la fenêtre d'application reste
  561.         ouverte. Notez que le port AREXX est toujours actif pendant
  562.         que APrf est iconifié.
  563.         Pour réveiller    APrf,  rendez  cette  fenêtre  active  puis
  564.         cliquez sur le bouton  droit  de  la  souris.  Vous  pouvez
  565.         quitter  APrf  lorsqu'il  est  iconifié  sans  avoir  à  le
  566.         réveiller, en cliquant sur le gadget  de  fermeture  de  la
  567.         fenêtre.
  568.  
  569.     Commande "Quitte" (Amiga-Q ou ESCAPE) :
  570.  
  571.         Termine l'exécution d'APrf.
  572.         Une  boite  de    requête  apparaitra  pour   vous   demander
  573.         confirmation.
  574.  
  575.  
  576.     Voici la description des commandes du menu "Outils" :
  577.  
  578.     Commande "Options défaut" (Amiga-D) :
  579.  
  580.         Permet de recharger les options par défaut (dans l'ordre  :
  581.         valeurs des  Préférences,  puis  options  de  la  ligne  de
  582.         commande).
  583.         Si l'on a appelé APrf depuis le Workbench en  sélectionnant
  584.         plusieurs fichiers, le premier fichier sélectionné  devient
  585.         le fichier à imprimer.
  586.         Cette commande peut être utile (entre autres) si vous  avez
  587.         changé les Préférences, car cela permet à APrf    de  prendre
  588.         en compte ces modifications sans que vous ayez à quitter le
  589.         programme.
  590.  
  591.     Commande "Charge fichier" (Amiga-C) :
  592.  
  593.         Permet de charger immédiatement le fichier  à  imprimer  en
  594.         mémoire. Si ce    fichier  était    déjà  en  mémoire,  il    est
  595.         rechargé quand même (voir §4.1).
  596.  
  597.     Commande "Libère fichier" (Amiga-L) :
  598.  
  599.         Permet de libérer la  mémoire  occupée    par  le  fichier  à
  600.         imprimer (voir §4.1)
  601.  
  602.     Commande "Pré-visualise" (Amiga-V) :
  603.  
  604.         Permet de visualiser la mise en page du fichier à imprimer.
  605.         (voir §2.7).
  606.  
  607.     Commande "Ligne de cmd" (Amiga-K) :
  608.  
  609.         Affiche la liste des options à donner à  l'appel  pour  que
  610.         les paramêtres d'impressions aient leur valeur actuelle.
  611.         Pour faire disparaitre la fenêtre, cliquez à l'intérieur ou
  612.         appuyez sur une touche.
  613.  
  614.     Commande "Sauve config" (Amiga-S) :
  615.  
  616.         Sauve les options courantes  (sauf  le  nom  du  fichier  à
  617.         imprimer) en créant une  nouvelle  ligne  dans    le  fichier
  618.         "S:APrf.Init". Une fenêtre apparait, et vous  devez  entrer
  619.         le nom de la nouvelle configuration. Cliquez sur le  gadget
  620.         de fermeture de la fenêtre pour annuler l'opération.  Notez
  621.         que le nouveau fichier de configuration n'est pas rechargé.
  622.         Voir §3.5 pour d'autres détails.
  623.  
  624.     Commande "Doc info" (Amiga-X) :
  625.  
  626.         Affiche le nombre de pages, de lignes et de caractères    que
  627.         produira l'impression courant. Ce décompte tient compte  de
  628.         toutes les options de mise  en    page,  mais  notez  que  le
  629.         nombre de caractères est approximatif.
  630.         Pour faire disparaitre la fenêtre, cliquez  sur  le  gadget
  631.         "OK".
  632.  
  633.  
  634.     Voici la description des items du menu "Options" :
  635.  
  636.     Option "Courrier" :
  637.  
  638.         Permet de sélectionner la qualité d'impression : "courrier"
  639.         ou "listing".
  640.         Par défaut la qualité  est  celle  indiquée  par  le  champ
  641.         "Print Quality" des Preferences, mais cela peut être changé
  642.         à l'appel par l'option -O (voir §2.1).
  643.  
  644.     Option "8 LPI" :
  645.  
  646.         Permet de régler l'interligne : "8 LPI" ou "6 LPI".
  647.         Par défaut l'interligne est  celui  indiqué  par  le  champ
  648.         "Spacing" des Préférences, mais cela  peut  être  changé  à
  649.         l'appel par l'option -O (voir §2.1).
  650.  
  651.     Option "Continu" :
  652.  
  653.         Permet d'indiquer comment est alimentée votre imprimante  :
  654.         par du papier en continu, ou feuille à feuille.
  655.         Par défaut, l'alimentation est celle indiquée par le  champ
  656.         "Paper type" des Préférences, mais cela peut être changé  à
  657.         l'appel grâce à l'option -O (voir §2.1).
  658.  
  659.     Option "Tronque" :
  660.  
  661.         Si cette option est active, les lignes trop longues  seront
  662.         tronquées au lieu d'être imprimées sur plusieurs lignes.
  663.         Normalement cette option n'est pas active, mais  cela  peut
  664.         être changé à l'appel grâce à l'option -O (voir §2.1).
  665.  
  666.     Option "Filtre CTRL" :
  667.  
  668.         Si cette option est  active,  les  caractères  de  contrôle
  669.         (code ASCII inférieur à 32 ou supérieur à 126) trouvés dans
  670.         le fichier à imprimer ne seront pas envoyés à l'imprimante.
  671.         Normalement cette option n'est pas active, mais  cela  peut
  672.         être changé à l'appel grâce à l'option -O (voir §2.1).
  673.  
  674.     Option "Filtre ANSI" :
  675.  
  676.         Si cette option est active, les séquence d'échappement ANSI
  677.         (définies au §6) trouvées dans le  fichier  à  imprimer  ne
  678.         seront pas envoyés à l'imprimante.
  679.         Normalement cette option n'est pas active, mais  cela  peut
  680.         être changé à l'appel grâce à l'option -O (voir §2.1).
  681.  
  682.     Option "Tampon 1Ko" :
  683.  
  684.         Si cette option est active, le tampon de  sortie  aura    une
  685.         taille d'un kilo-octets (et non d'une page).
  686.         Normalement cette option n'est pas active, mais  cela  peut
  687.         être changé à l'appel grâce à l'option -O (voir §2.1).
  688.         Voir §4.2 pour plus de détails.
  689.  
  690.     Option "Envoie FF" :
  691.  
  692.         Si cette option est active, un    caractère  "saut  de  page"
  693.         (Form Feed) est envoyé à la fin de chaque page.
  694.         Normalement cette option est active, mais  cela  peut  être
  695.         changé à l'appel grâce à l'option -O (voir §2.1).
  696.  
  697.     Option "Soul.entête" :
  698.  
  699.         Si cette option est active, l'entête sera souligné lors  de
  700.         l'impression.
  701.         Normalement cette option n'est pas active, mais  cela  peut
  702.         être changé à l'appel grâce à l'option -O (voir §2.1).
  703.  
  704.  
  705.     2.6 L'entête et le pied de page :
  706.     ---------------------------------
  707.  
  708.     APrf vous permet d'ajouter une entête, un  pied  de  page,  ou  les
  709. deux, sur vos documents. Le choix se fait soit à l'appel (option  -f,  voir
  710. §2.1) soit avec le gadget "Format Page" (voir §2.4). L'entête et le pied de
  711. page utilisent chacun deux lignes sur la page.
  712.  
  713.     Lorsque vous demandez une entête (et/ou  un  pied  de  page),  APrf
  714. utilise la valeur des gadgets "Entête" (et/ou "Pied de page") pour composer
  715. cette entête (et/ou ce pied de page). Le gadget à  gauche  indique  ce  qui
  716. sera écrit à gauche, le gadget central ce qui sera écrit au milieu,  et  le
  717. gadget à droite ce qui sera écrit à droite.
  718.     Les  spécifications  de  format  peuvent  utiliser  les   séquences
  719. suivantes :
  720.  
  721.     %a    nom du jour de la semaine (e.g. "Lundi")
  722.     %b    nom du mois (complet, e.g. "septembre")
  723.     %B    nom du mois (abbrégé, e.g. "Sep")
  724.     %d    jour du mois (01 à 31)
  725.     %D    date telle qu'indiquée par le gadget "Format Date"
  726.     %f    nom de base du fichier (e.g. "toto")
  727.     %F    nom complet du fichier (e.g. "RAM:titi/toto")
  728.     %h    heure (00 à 11)
  729.     %H    heure (00 à 23)
  730.     %m    mois (01 à 12)
  731.     %M    minutes (00 à 59)
  732.     %n    numéro de page
  733.     %p    période de la journée (AM ou PM)
  734.     %s    taille du fichier en octets
  735.     %S    secondes (00 à 59)
  736.     %v    version du programme (e.g. "APrf v4.20")
  737.     %w    jour de la semaine (0 à 6)
  738.     %x    numéro d'exemplaire
  739.     %y    année (00 à 99)
  740.  
  741.     La valeur par défaut de l'entête est "%f" pour  la  partie  gauche,
  742. "Page %n" pour la partie centrale, et "%D" pour la partie droite. La valeur
  743. par défaut du pied de page est "Page %n" pour la partie centrale,  et  rien
  744. pour les autres parties.
  745.     Vous avez  la  possibilité  d'indiquer  un  format  différent  pour
  746. l'entête  (et/ou  le  pied  de  page),  soit  en  cliquant  sur  le  gadget
  747. correspondant à la partie que vous voulez modifier,  soit  à  l'appel  avec
  748. l'option -E (et/ou l'option -F) : "-EGformat" modifie la valeur par  défaut
  749. de  la    partie    gauche,  "-ECformat"  celle  de  la  partie  centrale,   et
  750. "-EDformat" celle de la partie droite.
  751.     Vous pouvez également préciser sur quelles pages doivent apparaitre
  752. l'entête (et/ou le pied de page), soit avec le gadget  "sur"  (voir  §2.4),
  753. soit à l'appel à l'aide de l'option -f (voir §2.1).
  754.  
  755.  
  756.     2.7 La pré-visualisation :
  757.     --------------------------
  758.  
  759.     Cette fonction vous permet de  voir  l'aspect  final  du  texte  en
  760. fonction des options de mise en page.  Pour  l'utiliser,  réglez  tous  les
  761. paramêtres d'impression, puis choisissez  la  commande  "Pré-visualise"  du
  762. menu "Outils". Une fenêtre apparait au milieu de l'écran, et vous montre le
  763. résultat de la mise en page en commençant par la première page sélectionnée
  764. (la taille de la fenêtre est fonction de la taille de la page).
  765.     Pour passer à  la  page  suivante,  cliquez  à    l'intérieur  de  la
  766. fenêtre, ou appuyez sur la touche RETURN. A tout moment vous pouvez arrêter
  767. l'opération de visualisation en cliquant sur le gadget de fermeture  ou  en
  768. appuyant sur la touche ESCAPE.
  769.  
  770.     Notez cependant que si la longueur des pages est très grande  (plus
  771. de 121 lignes en mode PAL, ou plus de 93 lignes  en  mode  NTSC),  APrf  ne
  772. pourra pas ouvrir la fenêtre de pré-visualisation.
  773.  
  774.  
  775.     2.8 Modification de la sélection
  776.     --------------------------------
  777.  
  778.     Pour modifier la sélection des pages à    imprimer,  cliquez  sur  le
  779. gadget "Pages sélectionnées". Une fenêtre apparaitra au milieu de  l'écran.
  780. La partie supérieure de cette fenêtre est une grille de 100 cases, dont les
  781. numéros correspondent aux numéros de pages. Les numéros sont écrits en noir
  782. sur blanc si la page correspondante est sélectionnée, en noir sur bleu dans
  783. le cas contraire.
  784.     Si vous cliquez sur un numéro, vous inverserez la sélection  de  la
  785. page correspondante. Vous avez également à votre  disposition  les  gadgets
  786. suivants :
  787.  
  788.     TOUT        sélectionne toutes les pages
  789.     INVERSER    inverse la sélection
  790.     RIEN        aucune page n'est sélectionnée
  791.     VALIDER     validation de la nouvelle sélection (ou RETURN)
  792.     REPRENDRE   reprise de la sélection précédente
  793.     ANNULER     annulation de la nouvelle sélection (ou ESCAPE)
  794.  
  795.     Vous pouvez également utiliser le gadget de chaine  pour  spécifier
  796. de nouvelles pages à sélectionner (en plus de celles qui le sont déjà). Les
  797. valeurs admises dans ce gadget sont :
  798.  
  799.     *        toutes les pages
  800.     x        page x uniquement
  801.     x-y        pages x à y
  802.     x,y,z,...   pages x,y,z,...
  803.  
  804.     Vous pouvez utiliser une combinaisons des  deux  dernières  formes,
  805. comme par exemple "1,3,5-8".
  806.  
  807.     N'oubliez pas que la sélection dépend  du  numéro  de  la  première
  808. page. Notez enfin  que    vous  ne  pourrez  valider  si    aucune    page  n'est
  809. sélectionnée.
  810.  
  811.  
  812. 3. Concepts avancés :
  813. ---------------------
  814.  
  815.     Ce chapitre décrit quelques  possibilités  supplémentaires  d'APrf,
  816. qui lui permettront de s'intégrer encore mieux dans votre environnement  de
  817. travail.
  818.  
  819.  
  820.     3.1 La bibliothèque "powerpacker.library" :
  821.     -------------------------------------------
  822.  
  823.     APrf utilise la bibliothèque  "powerpacker.library",  si  elle  est
  824. présente dans le répertoire LIBS: de votre disquette Workbench ou de  votre
  825. disque dur. Ceci vous permet de demander l'impression d'un fichier compacté
  826. par les logiciels "PowerPacker 2.3b" ou "PowerPacker Pro 3.0b" : le fichier
  827. sera automatiquement décompacté lors de son chargement. Si le fichier avait
  828. été crypté, APrf vous demandera le mot de passe nécessaire à son décodage.
  829.  
  830.  
  831.     3.2 Le mode "eXpress" :
  832.     -----------------------
  833.  
  834.     Il se peut, dans certains cas, que vous ayez  envie  d'imprimer  un
  835. fichier rapidement, sans faire appel à l'interface Intuition d'APrf (si vos
  836. Préférences sont réglées correctement c'est sans  doute  souvent  le  cas).
  837. Dans ce but, l'option -X a été ajouté à APrf : en présence de cette option,
  838. une fois la ligne de commande analysée, l'impression  démarre  directement.
  839. APrf n'ouvre pas d'écran, et s'arrête une fois  l'impression  achevée.  Les
  840. messages d'erreur éventuels sont affichés sur l'écran Workbench,  dans  une
  841. fenêtre spéciale.
  842.  
  843.  
  844.     3.3 Le mode AREXX :
  845.     -------------------
  846.  
  847.     Lors du démarrage, APrf ouvre systématiquement un  port  compatible
  848. AREXX nommé "APrf_rexx" et attend des messages sur ce port.
  849.  
  850.     Les messages peuvent être :
  851.  
  852.     quit   : APrf ferme le port AREXX et termine
  853.     wakeup : APrf ferme le port AREXX et lance l'interface Intuition
  854.     reset  : APrf recharge les Préférences et revient aux options par
  855.          défaut
  856.     load   : APrf charge en mémoire le fichier à imprimer
  857.     print  : APrf lance l'impression
  858.  
  859.     Tout autre message est considéré comme une ligne  de  commande    CLI
  860. et analysé de la même manière (voir §2.1 pour la syntaxe). En cas  d'erreur
  861. APrf affiche un message sur l'écran Workbench, dans une  fenêtre  spéciale,
  862. et termine.
  863.     Si vous envoyez un message "load" sans avoir auparavant indiqué  le
  864. nom du fichier à imprimer, la commande restera sans effet.
  865.  
  866.     Voici un exemple de programme  AREXX,  qui  lance  l'impression  du
  867. fichier S:Startup-Sequence avec une marge gauche  de  10  caractères,  puis
  868. termine APrf :
  869.  
  870.     /* Imprime S:Startup-Sequence */
  871.     address "APrf_rexx"
  872.     "S:Startup-Sequence -g10"
  873.     "print"
  874.     "quit"
  875.  
  876.     Notez les guillemets autour des commandes !
  877.  
  878.     Si vous indiquez l'option "-A" lors  de  l'appel  d'APrf,  celui-ci
  879. passe en mode AREXX : seule la fenêtre d'application (sous système 2.0)  ou
  880. la fenêtre d'iconification (sous système 1.3) est ouverte et  le  programme
  881. se met automatiquement en mode iconifié (voir §2.5).
  882.     Depuis l'interface Intuition, vous pouvez placer APrf en mode AREXX
  883. simplement en iconifiant le programme (commande "Iconifie" du menu "Projet"
  884. voir §2.5).
  885.  
  886.  
  887.     3.4 La fenêtre d'application :
  888.     ------------------------------
  889.  
  890.     Sous  système  2.0,  APrf   ouvre   automatiquement   une   fenêtre
  891. d'application (ou "AppWindow") sur l'écran Workbench. Vous avez  alors  les
  892. possibilités suivantes :
  893.  
  894.     - si vous  sélectionnez  une  ou  plusieurs  icônes,  et  que  vous
  895.       les faites glisser sur la fenêtre d'application, APrf fera passer
  896.       son écran au premier plan (après l'avoir éventuellement  ouvert),
  897.       et vous pourrez alors imprimer le ou les fichiers comme  si  vous
  898.       aviez appelé APrf depuis le Workbench.
  899.     - si vous  cliquez  sur  le  gadget  de  fermeture  de    la  fenêtre
  900.       d'application, le programme s'arrêtera (sans confirmation en mode
  901.       AREXX)
  902.     - si vous activez la fenêtre d'application et cliquez sur le bouton
  903.       droit de la souris, APrf ouvrira son écran et l'interface normale
  904.       sera alors utilisable (équivalent à la commande  "wakeup"  depuis
  905.       AREXX)
  906.  
  907.     Notez  que   la   fenêtre   d'application   remplace   la   fenêtre
  908. d'iconification.
  909.  
  910.  
  911.     3.5 Le fichier "APrf.Init" :
  912.     ----------------------------
  913.  
  914.     Lors du démarrage, APrf essaye d'accéder au fichier  "S:APrf.Init".
  915. Ce fichier vous  permet  de  définir  des  configurations  type  et/ou    des
  916. polices. Dans le premier cas, les lignes du fichier doivent avoir le format
  917. suivant :
  918.  
  919.     nom:options:séquence
  920.  
  921. où "nom" et "options" sont des suites de  caractères  quelconques  (il  est
  922. conseillé de ne pas dépasser 8 caractères pour "nom"),  et  "séquence"  est
  923. une suite de code décimaux, séparés par des espaces. Les parties  "options"
  924. et "séquence" peuvent être vides. Seules  les  8  premières  configurations
  925. type sont prises en compte. Voici quelques exemples de lignes :
  926.  
  927.     mon8lpi:-p90 -O8:
  928.     landscap:-p80:27 48 108 72
  929.  
  930.     Chaque nom indiqué apparaitra  dans  un  nouveau  menu    :  le  menu
  931. "Contrôle". Si vous sélectionnez un nom dans ce menu, la  chaine  "options"
  932. sera immédiatement analysée comme une ligne de commande CLI. De plus,  lors
  933. de l'impression, les caractères dont le code  ASCII  est  indiqué  dans  la
  934. séquence correspondante seront envoyées à l'imprimante (après les séquences
  935. normales d'initialisation, mais avant le texte lui-même). Vous pouvez  bien
  936. entendu sélectionner plusieurs noms en même temps.
  937.     Lors d'un appel depuis le CLI ou depuis le Workbench,  l'option  -C
  938. (voir §3.1) permet de sélectionner une séquence dès le démarrage. La chaine
  939. "option" sera analysée après les options d'appel. Si la séquence  spécifiée
  940. par l'option -C n'existe pas, cette option sera ignorée.
  941.  
  942.     Le fichier "S:APrf.Init" vous permet également  d'utiliser,  depuis
  943. APrf, les polices internes de votre imprimante. Pour cela, il  vous  suffit
  944. de rajouter une ligne de la forme :
  945.  
  946.     fontdef:nom:séquence
  947.  
  948. où "nom" est le nom de la police, et "séquence" la suite de  codes  faisant
  949. passer votre imprimante dans la police indiquée. Voici un exemple :
  950.  
  951.     fontdef:Prestige:27 107 2 27 120 49
  952.  
  953.     Le nombre de polices n'est pas limité. La sélection  de  la  police
  954. peut se faire soit à l'appel, à l'aide de l'option -I (voir §2.1),  soit  à
  955. l'aide du gadget "Police" (voir §2.4).  Il  est  conseillé  de  placer  les
  956. définitions de    police    en  début  de  fichier,  avant    la  définition    des
  957. configurations type.
  958.  
  959.     Vous pouvez également indiquer les couleurs à utiliser pour l'écran
  960. de APrf, avec une ligne de la forme :
  961.  
  962.     palette: c1 c2 c3 c4
  963.  
  964. où "c1", "c2", "c3" et "c4" sont les spécifications RVB de chaque  couleur.
  965. Vous pouvez indiquer ces valeurs en décimal ou en hexadécimal (dans ce cas,
  966. ajoutez "0x" devant la valeur, par  exemple  "0x0F00").  Si  vous  indiquez
  967. plusieurs palettes, seule la dernière sera prise en compte.
  968.  
  969.     APrf accepte des lignes vides dans le fichier. Une ligne commençant
  970. par un point-virgule (";") sera considérée comme un commentaire et ne  sera
  971. donc pas interprétée.
  972.     Le  fichier  "S:APrf.Init"  sera  rechargé  chaque  fois  que  vous
  973. sélectionnerez la commande "Options défaut" dans le menu "Outils". En  mode
  974. "eXpress" (voir §3.2), le fichier "S:APrf.Init" ne sera chargé qu'en cas de
  975. besoin, c'est-à-dire si vous indiquez une option -C ou -I. Notez enfin  que
  976. les séquences sont envoyées  par  une commande    PRD_RAWWRITE,  c'est-à-dire
  977. qu'elles ne seront pas interprétées par le pilote d'imprimante.
  978.  
  979.  
  980. 4. Gestion de la mémoire :
  981. --------------------------
  982.  
  983.     Ce chapitre explique comment APrf gère la mémoire qu'il utilise. Je
  984. vous conseille de le lire attentivement MEME SI AVEZ UNE EXTENSION MEMOIRE.
  985.  
  986.  
  987.     4.1 Le fichier à imprimer :
  988.     ---------------------------
  989.  
  990.     Avant d'imprimer ou de pré-visualiser un fichier,  APrf  le  charge
  991. entièrement en mémoire. Une fois le traitement    terminée,  le  fichier    est
  992. conservé en mémoire, ce qui permet  d'éviter  de  le  recharger  à  nouveau
  993. si vous demandez ensuite une impression ou une pré-visualisation de ce même
  994. fichier.
  995.     La mémoire occupée par le fichier est libérée automatiquement quand
  996. APrf est iconifié (voir §2.5), quand vous choisissez un nouveau  fichier  à
  997. imprimer (voir  §2.4),  ou  quand  vous  choisissez  la  commande  "Fichier
  998. suivant" du menu "Projet" (voir  §2.5).  Le  fichier  peut  également  être
  999. libéré (mais dans certains cas seulement) si vous  choisissez  la  commande
  1000. "Options par  défaut" du menu "Outils".
  1001.  
  1002.     Vous pouvez forcer  APrf  à  charger  immédiatement  le  fichier  à
  1003. imprimer avec la commande "Charge fichier" du menu "Outils". Si le  fichier
  1004. était déjà présent en mémoire, il sera rechargé  quand    même.  Vous  pouvez
  1005. également forcer APrf à libérer la mémoire occupée par le fichier  avec  la
  1006. commande "Libère fichier" du menu "Outils".
  1007.  
  1008.     Pour vous permettre de savoir si le fichier est chargé    en  mémoire
  1009. ou non, APrf affiche le caractère "*" à droite du nom du fichier  quand  il
  1010. est chargé en mémoire.
  1011.  
  1012.     Ce mode de fonctionnement peut avoir deux inconvénients.
  1013.     Le premier est que  le    fichier  occupe  de  la  mémoire  peut-être
  1014. inutilement (je pense ici à ceux qui n'ont que 512 Ko de mémoire). Dans  ce
  1015. cas, vous pouvez soit iconifier APrf (voir  §2.5, vous gagnez  en  plus  la
  1016. mémoire occupée par le tampon de sortie, par quelques zones de travail,  et
  1017. au moins 32 Ko de mémoire CHIP), soit utiliser la commande "Libère fichier"
  1018. du menu "Outils".
  1019.     Le second est que si vous modifiez le fichier  sur  disquette,    ces
  1020. modifications pourraient ne pas être prises  en  compte,  puisque  APrf  ne
  1021. recharge pas le fichier. Pour éviter cela, APrf essaye de  détecter  si  le
  1022. fichier a été modifié depuis le dernier chargement en mémoire,    et  si    tel
  1023. est le cas vous propose de le recharger.
  1024.  
  1025.  
  1026.     4.2 Le tampon de sortie :
  1027.     -------------------------
  1028.  
  1029.     APrf utilise un  tampon  de  sortie,  afin  de    réduire  le  nombre
  1030. d'ordres d'écriture. Avec un tampon d'un kilo-octets,  l'écriture  vers  un
  1031. fichier se fait au moins deux fois plus rapidement  qu'avec  les  premières
  1032. versions d'APrf, dont le tampon ne contenait qu'une ligne. L'écriture  vers
  1033. l'imprimante n'est pas accélérée de manière visible. Dans tous les cas,  le
  1034. nombre d'ordres d'écriture est divisé au  moins  par  5  (cela  peut  aller
  1035. jusqu'à 14 ou 15), ce qui réduit sensiblement la charge imposée au systême,
  1036. et PERMET AINSI DE MOINS RALENTIR LES AUTRES TACHES.
  1037.  
  1038.     Par défaut APrf utilise un tampon d'une page  (voir  §2.5  l'option
  1039. "Tampon 1Ko" du menu "Options"), afin de  réduire  encore  plus  le  nombre
  1040. d'ordres d'écriture. Quand vous changez la taille de la page, le tampon est
  1041. automatiquement ré-alloué pour pouvoir contenir une page entière. S'il  n'y
  1042. a plus assez de mémoire pour allouer un  tampon  d'une  page,  APrf  réduit
  1043. automatiquement la taille du tampon à un kilo-octets.
  1044.      S'il n'est pas possible d'allouer ce tampon d'un kilo-octets, APrf
  1045. s'arrête et affiche le message d'erreur "Plus de mémoire libre".
  1046.  
  1047.  
  1048.     4.3 Mémoire nécessaire :
  1049.     ------------------------
  1050.  
  1051.     Le chargement du programme en mémoire  et  l'ouverture  de  l'écran
  1052. (avec gadgets et menus) nécessitent un peu plus de 100 Ko. Toute  opération
  1053. sur le fichier    à  imprimer  (impression,  pré-visualisation,  "doc  info",
  1054. etc...) provoque le chargement de ce fichier en mémoire, l'allocation  d'un
  1055. tampon d'une page de (NombreDeLignes * LargeurDesLignes)  octets  pour   la
  1056. composition des pages. Une impression provoque de  plus  l'allocation  d'un
  1057. tampon de sortie,  d'une  page  ou  d'un  kilo-octet  (suivant  la  mémoire
  1058. disponible).
  1059.  
  1060.  
  1061. 5. Divers :
  1062. -----------
  1063.  
  1064.     Ce chapitre est un bric-à-brac de quelques  indications  qui  n'ont
  1065. pas trouvé place dans les autres paragraphes.  Il contient certains détails
  1066. importants  sur  le fonctionnement du programme.  Je vous conseille donc de
  1067. lire attentivement ce qui suit, au moins une fois, et de penser à le relire
  1068. si APrf vous semble se comporter de manière bizarre.
  1069.  
  1070.     Voici comment APrf réagit si l'option "Continu"  est  désactivée  :
  1071. avant d'envoyer une page à l'imprimante, une  boite  de  requête  apparait,
  1072. vous demandant d'introduire une nouvelle feuille dans  l'imprimante.  Quand
  1073. vous êtes prêt, cliquez sur "OUI" : la page sera envoyée à l'imprimante. Si
  1074. vous cliquez sur "NON" l'impression sera abandonnée.
  1075.  
  1076.     Si  vous  désirez interrompre une impression, cliquez dans le cadre
  1077. où  est  affiché  le  numéro  de  l'exemplaire  et  de  la  page  en  cours
  1078. d'impression. Une boite de  requète  apparait  alors,  pour  vous  demander
  1079. confirmation : cliquez sur "OUI" pour arrêter l'impression, ou cliquez  sur
  1080. "NON" pour reprendre l'impression.
  1081.     Si vous confirmez l'arrêt de l'impression, l'envoi  des  données  à
  1082. l'imprimante est alors suspendu, ce qui ne  veut  pas  forcément  dire  que
  1083. l'impression s'arrête tout de suite : il faut attendre que l'imprimante ait
  1084. vidé son tampon. Un message apparait pour vous informer que votre demande a
  1085. été prise en compte, et APrf attend que l'ordre d'écriture  en  cours  soit
  1086. terminé (cela peut prendre un certain temps !).
  1087.  
  1088.     Pour vous permettre d'améliorer la présentation de  vos  documents,
  1089. APrf reconnait les séquences ANSI suivantes :
  1090.  
  1091.         ESC[0m        caractères normaux
  1092.         ESC[3m        début d'italique
  1093.         ESC[23m     fin d'italique
  1094.         ESC[4m        début de souligné
  1095.         ESC[24m     fin de souligné
  1096.         ESC[1m        début de gras
  1097.         ESC[22m     fin de gras
  1098.         ESC[1"z         qualité listing
  1099.         ESC[2"z         qualité courrier
  1100.  
  1101.     Ces séquences sont envoyées à l'imprimante, mais les caractères qui
  1102. les composent ne sont pas pris en compte dans le calcul de la mise en page.
  1103. De même, ils n'apparaissent pas lors de la pré-visualisation.  Toute  autre
  1104. séquence ne sera pas reconnue, et sera considéré comme    faisant  partie  du
  1105. texte à imprimer. Vous pouvez filtrer ces séquences, si vous  ne  souhaitez
  1106. pas qu'elles soient envoyées à  l'imprimante  (voir  §2.5,  option  "Filtre
  1107. ANSI" du menu "Options").
  1108.     La taille de ces séquences est limitée à 32 caractères par LIGNE DE
  1109. SORTIE (et non par ligne du fichier à imprimer). Cela correspond à 6  ou  8
  1110. séquences, et devrait être suffisant dans la plupart des cas. S'il y a trop
  1111. de séquences sur une ligne de sortie,  le  message  d'erreur  "Lignes  trop
  1112. longues, impression abandonnée" apparaitra en cours d'impression.
  1113.  
  1114.     Sauf si le filtrage  des  caractères  de  contrôle  est  actif,  un
  1115. caractère "Saut de page" dans le fichier à imprimer provoquera un  saut  de
  1116. page lors de l'impression. Notez enfin que les caractères "Backspace" (code
  1117. ASCII 8) ne sont pas comptés lors de la composition des lignes.
  1118.  
  1119.