# Le manuel de KFax

Bernd Johannes
Wuebben

    wuebben@kde.org

Version 0.3-1, 5 Octobre 1997

Ce manuel décrit KFax Version 0.3

Le manuel de KFax

KDE
KFax
fax
fac-similé
télécopie
affichage de fax

## Introduction

KFax est un logiciel d'affichage de fichiers fax capable d'afficher et d'imprimer tous les formats habituels de fichiers contenant des fax. En particulier, les fichiers de fax utilisés par les packages d'émission et de réception bien connus mgetty/sendfax et hylafax peuvent être affichés. La première (ou unique) page d'un fichier du style "PC-Research" (DigiFAX) produit par les pilotes ghostscript, dfaxhigh ou dfaxlow peut aussi être affichée (qui utilise encore ce format ?). Les fichiers d'entrée utilisant tout les types d'encodage habituels comme le groupe 3 (1 ou 2 dimensions) et le groupe 4 peuvent être affichés. KFax dispose de capacités d'impression postscript natives intégrées.

J'espère que vous apprécierez ce logiciel d'affichage de fax,

`Bernd Johannes Wuebben`

wuebben@kde.org

## Installation

### Comment obtenir KFax

KFax est une application faisant partie du projet KDE http://www.kde.org. KFax peut être trouvée à ftp://ftp.kde.org/pub/kde/, le site ftp principal du projet KDE.

### Configuration nécessaire

Pour compiler avec succès KFax, vous avez besoin des dernières versions de `libkdecore`, de `libkfm` et de `libkdeui`. Toutes les librairies nécessaires ainsi que KFax lui-même peuvent être trouvés à ftp://ftp.kde.org/pub/kde/.

### Compilation et installation

Pour compiler et installer KFax sur votre système, tapez la séquence suivante dans le répertoire de base de votre distribution de KFax :

    % ./configure
    % make
    % make install

Comme KFax utilise `autoconf` vous ne devriez pas avoir de problème à le compiler. Si toutefois c'était le cas reportez-les aux listes de mailing KDE.

## Techniques de base

KFax ne peut pas (jusqu`à présent) envoyer ni recevoir des fichiers fax. Pour ce point je recommande sans réserve les packages d'émission et de réception mgetty/sendfax ftp://ftp.leo.org/pub/comp/networking/communication/modem/mgetty et hylafax fax ftp://sgi.com/sgi/fax qui sont disponibles gratuitement.

HylaFAX: http://info-sys.home.vix.com/flexfax/toc.html

sendfax/mgetty: http://www.leo.org/~doering/mgetty/

Un document "affiché" peut être déplacé à l'intérieur de la fenêtre de KFax en cliquant dessus puis en maintenant appuyé le bouton gauche de la souris tout en la bougeant.

KFax ne peut pas afficher les formats d'images qui ne sont pas associés aux télécopies, comme des fichiers tiff ou gif arbitrairement choisis.

Par défaut les fichiers fax bruts sont interprétés comme étant au standard faxg3. Si vous désirez afficher des fichiers faxg3-2d et faxg4 vous devez l'indiquer spécifiquement dans la boîte de dialogue des options de Fax. Dans le cas de fichiers bruts au standard faxg4 vous serez peut-être amené à indiquer la hauteur en termes de nombre de lignes de digitalisation du fax si ce nombre n'est pas la valeur par défaut 2155.

### Glisser-déposer

KFax utilise le protocole de glisser-déposer de KDE. Cela signifie que vous pouvez traîner des fichiers depuis le Bureau, depuis le Gestionnaire de Fichiers kfm ou depuis un site ftp distant ouvert dans une des fenêtres de kfm vers KFax.

### Manipuler des fichiers sur l'Internet

Vous pouvez ouvrir et enregistrer des fichiers de manière transparente sur l'Internet.

### Imprimer

KFax supporte de manière native l'impression PostScript.

Assurez-vous que votre système est configuré pour l'impression de documents PostScript. Si vous ne disposez pas d'une imprimante native PostScript, procurez-vous ghostscript/ghostview version 5 (ou mis-à-jour) depuis http://www.cs.wisc.edu/%7Eghost/.

### Options de Fax

KFax supporte un certain nombre d'options vous permettant une configuration adaptée au mieux à l'usage que vous en faites.

Options d'affichage.

  - Paysage: Affiche par défaut les pages de fax tournées de 90 degrés.

  - A l'envers: Affiche par défaut les pages de fax en inversant haut et bas.

  - Inversion: Affiche les fax en blanc sur un fond noir

Résolution brute du Fax:

  - Auto: Certains programmes de transmission de fax utilisent comme première lettre du nom du fax 'f' pour indiquer une résolution "fine" et utilisent 'n' pour une résolution "normale". Lorsque "Auto" est coché, KFax se conforme à cette convention. Cette option est sans effet sur les fac-similés Tiff et "PC-Research" (DIGIFAX). Ces derniers se décrivent eux-mêmes.

  - Fine: Suppose que les fichiers fax bruts (faxg3-faxg32d-faxg4) sont en résolution fine (7.7 lignes/mm). Les fichiers Tiff et "PC-Research" (DigiFAX) se décrivent eux-mêmes.

  - Normale: Suppose que les fichiers fax bruts (faxg3/faxg32d/faxg4) sont en résolution normale (3.85 lignes/mm). Chaque ligne du fax est répétée deux fois dans l'image affichée afin d'obtenir des échelles verticales et horizontales sensiblement égales.

Données des fax bruts:

  Lorsque "bit de poids faible d'abord" est coché, KFax considère que l'ordre des bits des octets de données du fax est inversé. Les spécifications officielles des fax ne traitent que de la transmission en série des données. Les fabriquants de modems sont donc amenés à décider si le premier bit reçu doit être placé dans la position de poids le plus fort ou de poids le plus faible de chaque octet. Le consensus est de ranger le bit de poids fort en premier, mais cette option permet de gérer l'ordre inverse.

Format des fax bruts:

  - faxg3: Considère que les fichiers d'entrée bruts utilisent le codage de groupe 3 à 1 dimension.

  - faxg32d: Considère que les fichiers d'entrée bruts utilisent le codage de groupe 3 à 2 dimensions.

  - faxg4: Considère que les fichiers d'entrée bruts utilisent le codage de groupe 4

Dimensions par défaut des fax bruts:

  - hauteur: indique le nombre par défaut de lignes dans les données de fax bruts

  - largeur: indique le nombre par défaut de pixels dans chaque ligne de digitalisation pour les données de fax bruts. La valeur par défaut est 1728.

  - auto: cette option est le réglage conseillé pour les données de fax bruts de groupe 3 à 1 dimension. Les fax de groupe g3-2d et g4 ont besoin qu'on indique explicitement leurs dimensions.

### Options de ligne de commande:

KFax supporte les options de ligne de commande suivantes:

    wuebben: ../kfax -h
    usage: KFax <drapeaux> fichier ...
            -f      résolution fine
            -n      résolution normale
            -h      hauteur (nombre de lignes de fax)
            -w      largeur (points par ligne de fax)
            -l      tourner l'image de 90 degrés (mode paysage)
            -u      renverser l'image (tête en bas)
            -i      inverser (noir et blanc)
            -m      limite de l'utilisation mémoire en octets (M m mega, K k kilo) par défaut: 8 mégas
            -r      les données du fax sont rangées avec le bit de poids faible en premier
            -v      informations de version
            -2      les fichiers bruts sont au standard faxg3-2d
            -4      les fichiers bruts sont au standard faxg4

### Raccourcis clavier de KFax

KFax permet les raccourcis clavier suivants quand le curseur de la souris est placé sur une fenêtre ouverte contenant un fax.

- `h` Montre la page d'aide en indiquant les raccourcis clavier disponibles

- `q` Restaure le document originel.

- `n + Suivant PageBas Espace` Affiche la page suivante

- `p - Précédent PageHaut Correction` Affiche la page précédente

- `Shift Home` Première Page

- `Shift End` Dernière Page

- `u` Renverse la page (tête en bas)

- `l` Tourne la page de 90 degrés

- `m` Affiche une image en miroir de la page courante

- `i` zoom direct (agrandit)

- `o` zoom inverse (rapetisse)

### Comment créer des fichiers fax

La façon la plus simple de créer des fichiers fax est peut-être de créer en premier lieu un fichier PostScript à partir du document que vous voulez faxer puis d'utiliser l'interpréteur PostScript ghostscript afin de transformer le fichier PostScript en plusieurs fichiers fax, en utilisant un des formats de fichiers fax.

Pour créer des fichiers fax à partir de documents ps vous aurez besoin de ghostscript. KFax sait afficher tous les modes de sortie de fax de ghostscript:

- brut: faxg3 faxg32d faxg4

- tiff: tiffg3 tiffg32d tiffg4

Un fichier brut ne dispose pas d'informations de pagination et sera affiché comme un tout dans la fenêtre de fax. Les fichiers tiff contiennent les informations de pagination et peuvent être parcourus de page en page dans la fenêtre de fax.

#### Exemple

Comment créer un fichier fax que sendfax/mgetty peut lire puis envoyer:

    gs -sDEVICE=faxg3 -sOutputFile=/tmp/fax.g3.%d votredocument.ps

En supposant que votre document postscript `votredocument.ps` contient trois pages, ceci résultera en la création de fax.g3.1, de fax.g3.2 et de fax.g3.3

## Les éléments de menu

### Fichier

#### Nouveau

Ouvre un nouveau document dans l'éditeur.

#### Ouvrir

Permet d'ouvrir un fax.

#### Ajouter

Permet d'ajouter un fichier fax. C'est particulièrement utile pour les fichier fax bruts faxg3/faxg32d/faxg4. On peut ajouter les différentes pages issues d'une transmission de fax et les imprimer toutes d'un coup.

#### Fermer les fax

Ferme tous les fichiers fax ouverts à ce moment

#### Ouvrir une URL

Permet de récupérer un fichier fax depuis l'Internet.

#### Enregistrer une URL

Permet d'enregistrer un fichier fax via l'Internet.

#### Imprimer

Ouvre la boîte de dialogue d'impression et permet d'imprimer les pages des fichiers fax ouverts à ce moment.

#### Sortir

Sort du logiciel d'affichage de fax.

### Vue

#### Suivante

Affiche la page de fax suivante.

#### Précédente

Affiche la page de fax précédente.

#### Première

Affiche la première page de fax.

#### Dernière

Affiche la dernière page de fax.

#### Tourner

Tourne le fax dans le sens inverse des aiguilles d'une montre.

#### Miroir

Affiche une image en miroir de la page de fax courante.

#### Renverse

Renverse la page de fax courante (tête en bas)

#### Zoom direct

Agrandit la vue courante.

#### Zoom inverse

Rapetisse la vue courante.

### Options

#### Options de fax

Affiche la boîte de dialogue des options de fax.

#### Cacher/Afficher la barre d'outils

Permet d'afficher ou de cacher la barre d'outils.

#### Cacher/afficher la barre d'état

Permet d'afficher ou de cacher la barre d'état.

### Aide

#### Aide

Invoque le système d'aide de KDE en affichant les pages d'aide de KFax.

#### A propos

Affiche les informations essentielles sur KFax.

## Questions et réponses

## Copyright

    KFax est Copyright 1997 par Bernd Johannes Wuebben,
                              wuebben@math.cornell.edu
                              wuebben@kde.org

    Ce programme est un logiciel libre ; vous pouvez le redistribuer et/ou le modifier selon les termes de la Licence
    Publique GNU (GPL) telle que publiée par la Free Software Foundation; soit la version 2 de la Licence, ou (à
    votre choix) toute version ultérieure.

    Ce programme est distribué dans l'espoir qu'il sera utile, mais SANS AUCUNE GARANTIE; même sans la garantie
    implicite de MERCANTIBILITE ou de CONVENANCE POUR UN BUT PARTICULIER. Reportez-vous à la Licence
    Générale Publique GNU pour plus de détails.

    Vous devriez avoir reçu une copie de la Licence Générale Publique GNU avec ce programme; si ce n'est pas le
    cas, écrivez à la Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

### Remerciements

    Comme toujours je me repose sur les épaules de géants. Je suis profondément redevable à
    Frank D. Cringle qui a écrit l'excellent logiciel d'affichage de fax viewfax sur lequel KFax est
    partiellement basé:

    viewfax version 2.3, Copyright (C) 1990, 1995 Frank D. Cringle.

    Il en va de même pour la merveilleuse bibliothèque libtiff version 2.3 bêta:

    Copyright (c) 1988-1995 Sam Leffler
    Copyright (c) 1991-1995 Silicon Graphics, Inc.

    Enfin et non des moindres: Merci aux Trolls pour Qt. http://www.troll.no

Traduction française: `Eric Bischoff`