]>

# Das KFax Handbuch

Bernd Johannes
Wuebben

    wuebben@kde.org

Version 0.3-1, 5. Oktober 1998

Dieses Handbuch beschreibt KFax Version 0.3

KDE

KDE

## Einführung

KFax ist ein Fax-Betrachter, der fähig ist, alle üblichen Fax-Formate anzuzeigen und zu drucken. Speziell die Faxdateien, die von den weit verbreiteten Fax-Programmen `mgetty/sendfax` und `hylafax` verwendet werden, können dargestellt werden. Die erste (oder einzige) Seite einer "PC-Research"-artigen (DigiFAX) Datei, die mit den `ghostscript`-Treibern dfaxhigh oder dfaxlow erstellt wurde, kann ebenfalls angezeigt werden. (Wer benutzt dieses Format immer noch?) Dateien, die eine übliche Fax-Codierung wie Gruppe 3 (ein- der zweidimensional) und Gruppe 4 benutzen, können angezeigt werden. KFax hat eingebaute Postscript Druckfähigkeiten.

Ich hoffe, Sie werden die Arbeit mit diesen Fax-Betrachter mögen,

`Bernd Johannes Wuebben`

wuebben@kde.org

## Installation

### Wie man KFax erhält

KFax ist Teil des KDE Projekts http://www.kde.org. Sie erhalten KFax von ftp://ftp.kde.org/pub/kde/, der Haupt-FTP-Seite des KDE Projekts.

### Voraussetzungen

Um KFax erfolgreich kompilieren zu können, brauchen Sie die neuesten Versionen von `libkdecore`, `libkfm` und `libkdeui`. Alle benötigten Bibliotheken sowie KFax selbst finden Sie auf ftp://ftp.kde.org/pub/kde/.

### Kompilierung und Installation

Um KFax auf Ihrem System installieren zu können, führen Sie folgende Kommandos im Basisverzeichnis der KFax Distribution aus:

    % ./configure
    % make
    % make install

Da KFax `autoconf` und `automake` benutzt, sollten Sie keine Probleme beim kompilieren haben. Falls Probleme auftreten, teilen Sie diese bitte in den KDE Mailinglisten mit.

## Grundlegendes

KFax kann (momentan) keine Faxe versenden oder empfangen. Für diesen Zweck empfehle ich von ganzem Herzen die Pakete `mgetty/sendfax` (ftp://ftp.leo.org/pub/comp/networking/communication/modem/mgetty) und `hylafax` (ftp://sgi.com/sgi/fax), die frei verfügbar sind.

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

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

Ein vergrößertes Dokument kann mit der Maus im KFax Fenster bewegt werden, indem Sie bei gedrücktem ersten Mausknopf den Zeiger bewegen.

KFax kann keine Bildformate anzeigen, die nichts mit Faxen zu tun haben, wie z.B. eine tiff- oder gif-Datei.

Rohfax-Dateien werden standardmäßig als g3-Dateien interpretiert. Wenn Sie faxg3-2d oder faxg4 Dateien anzeigen lassen wollen, müssen Sie dies im Dialog "Fax-Einstellungen" einstellen. Im Falle von g4-Rohdateien werden Sie eventuell die Höhe des Faxes in Scan-Linien einstellen müssen, wenn diese vom voreingestellten Wert 2155 abweicht.

### Drag-and-Drop

KFax benutzt das KDE Drag-and-Drop-Protokoll. Das bedeutet, daß Sie Dateien von der Arbeitsfläche, aus dem Dateimanager(KFM) oder einer entfernten FTP-Seite, die in einem KFM Fenster geöffnet ist, auf KFax ziehen können.

### Dateien aus dem Internet benutzen

Sie können Dateien aus dem Internet Öffnen und Speichern wie wenn Sie Dateien auf Ihrer lokalen Festplatte speichern würden.

### Drucken

KFax hat eingebaute PostScript Druckfähigkeiten.

Stellen Sie sicher, daß Sie Ihr System für das Drucken von PostScript-Dokumenten vorbereitet ist. Wenn Sie keinen Drucker mir PostScript-Fähigkeiten besitzen, holen Sie sich `ghostscript/ghostview` Version 5 oder neuer von http://www.cs.wisc.edu/%7Eghost/.

### Fax-Einstellungen

KFax hat einige Einstellmöglichkeiten, um Ihnen eine optimale Konfiguration für Ihre Zwecke ermöglichen zu können.

Bildschirmoptionen

  - Querformat: Zeigt die Fax-Seiten standardmäßig um 90 Grad gedreht an.

  - Auf dem Kopf: Zeigt die Fax-Seiten standardmäßig auf dem Kopf an.

  - Invertiert: Zeigt die Fax-Seiten mit weißer Schrift auf schwarzem Hintergrund an.

Rohfax-Auflösung

  - Auto: Manche Faxprogramme setzen vor den Namen eines Fax ein "f", wenn es sich um ein Fax mit hoher("fine") Auflösung handelt, und ein n, wenn das Fax mit "normaler" Auflösung vorliegt. Wenn "Auto" aktiviert ist, dann wird KFax auf diese Konvention achten. Diese Einstellung hat keinen Einfluß auf Tiff und "PC-Research" (DIGIFAX) Faxe. Diese spezifieren ihre Auflösung auf andere Weise.

  - Fein: Nehme an, das Rohfax-Daten (g3-g32d-g4) Faxe mit hoher Auflösung sind (7.7 Zeilen/mm). Tiff und "PC-Research" (DIGIFAX) spezifieren ihre Auflösung auf andere Weise.

  - Normal: Nehme an, das Rohfax-Daten (g3-g32d-g4) Faxe mit normaler Auflösung sind (3.85 Zeilen/mm). Jede Zeile wird in der Anzeige verdoppelt, um ungefähr gleiche vertikale und horizontale Skalierung zu erhalten.

Rohfax-Daten haben:

  Wenn "LS-Bit zuerst" aktiviert ist, nimmt KFax an, daß die Bit-Reihenfolge der Faxdaten umgedreht ist. Die offizielle Fax Spezifikation behandelt nur die serielle Übermittlung der Daten. Modemhersteller müssen selbst festlegen, ob das erste empfangene Bit als niedrigstes(least significant) oder höchstes(most significant) Bit in einem Byte gesetzt werden soll. Es besteht zwar der Konsens,daß die höchsten Bit zuerst übertragen werden, aber falls trotzdem der umgekehrte Fall auftritt, müssen Sie diese Option aktivieren.

Rohfax-Daten sind:

  - g3: Nehme an, daß Rohfax-Dateien Gruppe 3, 1-dimensional kodiert sind.

  - g32d: Nehme an, daß Rohfax-Dateien Gruppe3, 2-dimensional kodiert sind.

  - g4: Nehme an, daß Rohfax-Dateien Gruppe 4 kodiert sind.

Rohfax-Breite-Höhe:

  - Höhe: Legen Sie hier die Standardanzahl von Zeilen für Rohfax-Daten fest.

  - Breite: Legen Sie hier die Standardanzahl von Punkten in jeder gescannten Zeile der Rohfaxdaten fest. Voreingestellter Wert ist 1728.

  - Auto: Diese Option ist die empfohlene Einstellung für g3 Rohfax-Daten. Bei g3-2d und g4 müssen die Dimensionen explizit festgelegt werden.

### Kommandozeilen Optionen

KFax unterstützt die folgenden Kommandozeilen Optionen:

            -f      feine Auflösung
            -n      normale Auflösung
            -h      Höhe (Anzahl der Zeilen)
            -w      Breite (Punkte pro Zeile)
            -l      drehe Bild um 90 Grad (Landscape Modus)
            -u      drehe Bild auf den Kopf
            -i      invertieren (schwarz/weiß)
            -m      Grenze des Speicherbedarfs in Bytes (M m Mega, K k Kilo) Standard: 8 Megabyte
            -r      Faxdaten sind mit niedrigstem(least significant) Bit zuerst gespeichert.
            -v      Versions-Informationen
            -2      Rohfax-Dateien sind g3-2d
            -4      Rohfax-Dateien sind g4

### KFax Tastenbelegung

KFax beachtet die folgenden Tastenkombinationen, wenn der Mauszeiger über einem geöffneten Faxdokument steht.

- `h` Zeige Hilfeseite, die die verfügbaren Tastenbelegungen anzeigt.

- `q` Kehre zum ursprünglichen Dokument zurück.

- `n + Next PgDn Space` Zeige die nächste Seite an

- `p - Prior PgUp Backspace` Zeige die vorherige Seite an

- `Shift Pos1` Erste Seite

- `Shift Ende` Letzte Seite

- `u` Stelle Seite auf den Kopf

- `l` Drehe Seite um 90 Grad

- `m` Zeige das Spiegelbild der aktuellen Seite

- `i` Vergrößern

- `o` Verkleinern

### Wie man Faxdateien erzeugt

Die wahrscheinlich einfachste Art Faxdateien zu erzeugen, ist, zuerst eine PostScript-Datei aus Ihrem Dokument, das Sie faxen wollen, zu erstellen, und dann mit dem `ghostscript` PostScript-Interpreter die PostScript-Datei in das gewünschte Fax-Format umzuwandeln.

Um Faxdateien zu erzeugen, benötigen Sie `ghostscript`. KFax kann alle Fax-Formate, die von `ghostview` erzeugt werden können, anzeigen.

- raw: fag3 faxg32d faxg4

- tiff: tiffg3 tiffg32d tiffg4

Eine Roh-Datei enthält keine Information über die Seitenaufteilung und wird als ganzes im Fax-Fenster angezeigt. Tiff-Dateien enthalten Informationen über die Seitenaufteilung, so daß die Seiten einzeln im Fax-Fenster angezeigt werden können.

#### Beispiel

Wie man eine Faxdatei erzeugt, die `sendfax/mgetty` senden kann:

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

Wenn Ihr ps-Dokument ihrdokument beispielsweise drei Seiten enthält, so werden die drei Dateien mit den Namen fax.g3.1 fax.g3.2 fax.g3.3 erstellt.

## Die Menüeinträge

### Datei

#### Neu

Öffnet ein neues Dokument im Editor.

#### Öffnen...

Erlaubt es Ihnen ein Fax zu öffnen.

#### Fax hinzufügen...

Erlaubt es Ihnen ein Fax hinzuzufügen. Dies ist teilweise nützlich für rohe g3/g32d/g4 Fax-Dateien. Sie können alles Seiten einer Fax-Übertragung hinzufügen und alle auf einmal ausdrucken.

#### Schließen

Schließt alle geöffneten Fax-Seiten.

#### URL öffnen...

Erlaubt es Ihnen eine Faxdatei aus dem Internet zu öffnen.

#### Speichern unter URL...

Erlaubt es Ihnen das Fax in ein Dokument im Internet zu speichern.

#### Drucken...

Öffnet den Druckdialog und läßt Sie das momentan geöffnete Dokument drucken.

#### Beenden

Beendet KFax.

### Ansicht

#### Nächste Seite

Zeigt die nächste Faxseite an.

#### Vorherige Seite

Zeigt die vorherige Seite an.

#### Erste Seite

Zeigt die erste Faxseite an.

#### Letzte Seite

Zeigt die letzte Faxseite an.

#### Seite drehen

Dreht das Fax im Uhrzeigersinn.

#### Seite spiegeln

Zeigt die aktuelle Faxseite gespiegelt an.

#### Seite umklappen

Zeigt die aktuelle Faxseite auf dem Kopf an.

#### Vergrößern

Vergrößert die aktuelle Ansicht.

#### Verkleinern

Verkleinert die aktuelle Ansicht..

### Einstellungen

#### Fax-Einstellungen...

Öffnet den Einstellungen-Dialog.

#### Werkzeugleiste ausblenden/anzeigen

Erlaubt es Ihnen, die Werkzeugleiste entweder angezeigt oder ausgeblendet zu haben.

#### Statusleiste ausblenden/anzeigen

Erlaubt es Ihnen, die Statusleiste entweder angezeigt oder ausgeblendet zu haben.

### Hilfe

#### Inhalt

Öffnet das KDE Hilfesystem mit der KFax Hilfeseite.

#### Über KFax...

Zeigt die wichtigsten Informationen über KFax an.

## Fragen und Anworten

## Copyright

    KFax is Copyright 1997 by Bernd Johannes Wuebben,
                              wuebben@math.cornell.edu
                              wuebben@kde.org

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

### Danksagungen

    Wie immer stehe ich auf den Schultern von Riesen. Sehr viel verdanke
    ich Frank D. Cringle, der den exzellenten Fax-Betrachter viewfax
    geschrieben hat, auf dem KFax teilweise basiert.

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

    Ebenso die wunderbare libtiff Bibliothek Version 2.3 beta:

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

    Und letztendlich: Danke den Trolls für Qt. http://www.troll.no