Content-type: text/html Manpage of TYPERULES

TYPERULES

Section: Misc. Reference Manual Pages (${MANNUM4_5})
Updated: 12 Mai 1993
Index Return to Main Contents
 

NOM

typerules - Identification des types de fichiers et règles de conversion de HylaFAX  

DESCRIPTION

Seuls trois formats de fichiers sont acceptés par le serveur HylaFAX pour transmettre comme fax: les fichiers POSTSCRIPT®, les fichiers PDF, et les fichiers TIFF de Classe F (du groupe double niveau 3-encodé). Tous les autres types de fichiers doivent être convertis dans l'un de ces trois formats. Le programme de soumission des fax applique un jeu de règles au contenu de chacun des fichiers en entrée, pour en identifier le type et ainsi décider comment convertir le fichier dans un format acceptable pour la transmission. Ces règles sont stockées dans le fichier ${LIBDATA}/typerules, un fichier ASCII qui est créé d'après le fichier /etc/magic utilisé par le programme file(1) du system V. Cependant, il existe des différences significatives, précisées ci-dessous.

Les règles typographiques comparent des motifs de données à l'intérieur d'un fichier ; typiquement, les motifs qui apparaissent dans les tout premiers octets d'un fichier (c'est-à-dire les nombres magiques). Il existe deux types de règles, les règles primaires et les règles secondaires. Les règles secondaires spécifient des règles additionnelles à appliquer après la règle primaire correspondante. Lorsque les règles secondaires sont utilisées, elles sont passées en revue jusqu'à la prochaine règle typographique primaire du fichier.

Chaque règle consiste en un ensemble de champs séparés par des blancs :



      décalage type de données correspondance résultat commande
Si une ligne est terminée avec le caractère anti-slash, l'entrée est continuée sur la ligne suivante, tous les caractères espace en début de ligne étant transformés en un seul espace. Les commentaires sont notés avec le caractère « # » ; à partir de lui et jusqu'à la fin de la ligne, tout sera ignoré. Les règles secondaires ont un caractère « > » dans la première colonne de la ligne ; les règles primaires non.

Les champs de chacune des règles sont :

décalage
Le décalage des octets du fichier à partir duquel les données doivent être extraites et comparées à une chaîne ou valeur de recherche
Type de données
Le type de données à extraire à partir du décalage spécifié dans des buts de comparaison ; à choisir dans : « byte » (nombre non signé codé sur 8 bits), « short » (nombre non signé codé sur 16 bits), « long » (nombre non signé codé sur 32 bits), « tring » (un tableau de bytes), ou « ascii » (un tableau de bytes uniquement ASCII).
correspondance
La valeur et l'opération à utiliser dans la comparaison; la valeur utilisée est basée sur le champ type de données. Si la valeur est « x », elle est interprétée comme correspond à tout; sinon, les opérations suivantes sont gérées ( donnée étant la valeur extraite du fichier, et valeur étant spécifiée dans le champ de correspondance) sauf pour les types « string » et « ascii » :

= donnée == valeur != donnée != valeur > donnée > valeur < donnée < valeur <= donnée <= valeur >= donnée >= valeur & (donnée & valeur) == valeur ! (donnée & valeur) != valeur ^ (donnée ^ valeur) != 0
Si aucune opération n'est spécifiée, « = » est utilisé.
Pour « string » et « ascii » aucun opérateur n'est autorisé ; l'opération implicite est toujours « = ». Dans ce cas, le champ est terminé par une tabulation ou fin de ligne, et non par « # ». Les caractères dans le champ ont leur propre valeur littérale ; il n'y a pas de caractères d'échappement, comme c'est le cas en C.
résutat
Prend sa valeur parmi « ps », « tiff », ou « error » (non sensible à la casse). Les deux premiers résultats précisant que la règle génère, respectivement, soit un fichier POSTSCRIPT soit un fichier TIFF/F (du groupe double niveau 3-encodé). Le résultat « error » indique que le fichier est non souhaitable pour une transmission et, que s'il est utilisé dans une transmission, cela peut provoquer l'annulation de la tâche avec le champ commande utilisé comme message d'erreur.
commande
La description d'une commande qui est complétée et passée au shell pour convertir le fichier entrant dans le format cible (souhaitable pour l'envoi de fax). Avant que la chaîne ne soit transmise au shell, elle est analysée et les différents codes « % » sont remplacés par :

%i nom du fichier en entrée %o nom du fichier en sortie %r résolution horizontale de sortie en pixels/mm %R résolution horizontale de sortie en pixels/pouce %v résolution verticale de sortie en pixels/mm %V résolution verticale de sortie en pixels/pouce %f format des données, ``1'' pour 1-d encodé ou ``2'' pour 2-d encodé %w largeur de la page en pixels %W largeur de la page en mm %l hauteur de la page en pixels %L hauteur de la page en mm %s nom de la taille de page %F répertoire où sont les programmes de filtrage de HylaFAX %<x> le caractère <x> (par exemple ``%%'' a pour résultat``%''
Voir plus bas pour des exemples utilisant ces codes.
 

EXEMPLES

Les exemples suivants correspondent aux formats qui sont manipulés directement par le serveur :


#décalage   type de données    correspondance  résultat    commande
0           string             %!              ps                          # POSTSCRIPT
0           string             %PDF            ps                          # POSTSCRIPT par Ghostscript
0           short              0x4d4d          tiff                        # TIFF big-endian
0           short              0x4949          tiff                        # TIFF little-endian

Ces règles sont utilisées pour traiter la version ASCII de IRIS . Le format de la base de données de l'inventeur pour les fichiers, varie lorsqu'on bloque la transmission de différents formats binaires :



#décalage   type de données    correspondance  résultat    commande
0           string             #Inventeur V    error       IRIS Inventor file 
>15         string             binary          error       binary IRIS Inventor file
>15         string             ascii           ps          %F/textfmt -fCourier-Bold -p11bp\
                                                               -U -q >%o <%i

Cette règle est typiquement la dernière entrée d'un fichier, elle est utilisée pour convertir tous les fichiers de données ASCII qui n'ont pas trouvé de correspondance en POSTSCRIPT:



#décalage   type de données    correspondance  résultat    commande
0           ascii              x               ps          %F/textfmt -fCourier-Bold -p11bp -U -q >%o <%i
 

NOTES

Il vaut beaucoup mieux convertir les données à envoyer en POSTSCRIPT car ce format de données permet au serveur de fax de réaliser la dernière image avec les options optimales pour le transfert (résolution, encodage binaire, etc).

Il serait encore mieux de permettre à une règle secondaire d'augmenter une règle primaire, au lieu de la remplacer. Ceci permettant, par exemple, de sélectionner des options de ligne de commande en fonction du type de fichier.  

TRADUCTION

Christophe Sauthier (traduction@reponses.net), 2004  

AVERTISSEMENT SUR LA TRADUCTION

Il est possible que cette traduction soit imparfaite ou périmée. En cas de doutes, veuillez vous reporter au document original en langue anglaise fourni avec le programme.  

VOIR AUSSI

sendfax(1), hylafax-client(1)


 

Index

NOM
DESCRIPTION
EXEMPLES
NOTES
TRADUCTION
AVERTISSEMENT SUR LA TRADUCTION
VOIR AUSSI

This document was created by man2html, using the manual pages.
Time: 07:50:05 GMT, March 21, 2004