]>

# Manual do KFax

Bernd Johannes
Wuebben

    wuebben@kde.org

5 Oct 1997
Version 0.3

Este Manual descreve o KFax Versão 0.3

KDE
KFax
fax
facsimile

## Introdução

KFax é um visualizador de arquivos de fax capaz de mostrar e imprimir todos os formatos comuns de arquivos de fax. Em particular os arquivos de fax usados pelos populares pacotes de envio e recebimento mgetty/sendfax e hylafx. A primeira (ou a única) página de um arquivo estilo "PC-Research" (DigiFax) produzida pelos drivers dfaxhigh ou dfaxlow do ghostscript também pode ser mostrada. Arquivos de entrada usando qualquer codificação comum de fax como grupo 3 (1 e 2 dimensional) e grupo 4 podem ser mostrados. KFax tem capacidades nativas de impressão postscript embutidas.

Espero que você aprecie este visualizador de Fax,

`Bernd Johannes Wuebben`

wuebben@kde.org

## Instalação

### Como obter o KFax

N do T: O utilitário KFax vem com o pacote `kdegraphics`, que é bem provável que você já tenha obtido e instalado. Se você já tem o KDE instalado mas faltam-lhe os utilitários como KFax, basta obter o pacote `kdegraphics` e instalá-lo. Dificilmente você vai precisar obter o KFax em avulso, e portanto dificilmente precisará seguir as instruções abaixo. Elas foram mantidas para que este documento fique congruente com a versão original do autor.

KFax é parte do projeto KDE http://www.kde.org. KFax pode ser achado em ftp://ftp.kde.org/pub/kde/, o site principal do projeto KDE.

### Itens requeridos

Para compilar com êxito o KFax, você precisa das últimas versões de `libkdecore` e `libkfm`. Todas as bibliotecas necessárias, bem com o próprio KFax podem ser obtidos no site ftp://ftp.kde.org/pub/kde/.

### Compilação e instalação

Para compilar e instalar o KFax em seu sistema, digite o seguinte no diretório base onde se encontra a sua distribuição do KFax:

    % ./configure
    % make
    % make install

Desde que o KFax use `autoconf` você não deverá ter problemas para compilá-lo. Se você tiver problemas, por favor, reporte-os a kde mailing lists.

## Fundamentos

KFax não pode (ainda) enviar e receber Arquivo de Fax. Para isto eu recomendo o mgetty/sendfax ftp://ftp.leo.org/pub/comp/networking/communication/modem/mgetty e hylafax fax ftp://sgi.com/sgi/fax pacotes de envio/recebimento que são disponíveis de graça.

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

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

Um documento "aumentado" pode ser movido dentro do KFax, clicando e segurando o primeiro botão do mouse enquanto move-se o ponteiro.

KFax não pode mostrar arquivos de imagens cujo formato não está relacionado com fax, como arquivos tiff ou gif.

Por padrão arquivos de fax são interpretados como arquivos g3. Se você quer ver arquivos faxg3-2d e faxg4 você tem que especificar isto no diálogo Opções do Fax. No caso de arquivos g4 você deve precisar

também especificar a altura em linhas de varredura do fax se esta for diferente do padrão 2155.

### Arrastar e Soltar (Drag and Drop)

KFax utiliza o Protocolo de Arrastar e Soltar do KDE. Isto permite que você possa arrastar e soltar arquivos do Ambiente de Trabalho ou kfm ou de algum site remoto de ftp que você mantenha aberto na janela do kfm para o KFax.

### Lidando com arquivos na Internet

Você pode abrir e salvar arquivos de forma transparente na Internet.

### Imprimindo

KFax traz suporte nativo a impressão PostScript.

Certifique-se que seu sistema está configurado para imprimir documentos PostScript se você não tem uma impressora PostScript nativa. Senão obtenha você mesmo o ghostscript/ghostview version 5 ou mais recente no site http://www.cs.wisc.edu/%7Eghost/.

### Opções do Fax

KFax suporta numerosas opções para permitir a você uma configuração otimizada para seu uso específico.

Opções de Tela.

  - Retrato: Mostra, por padrão, a página de fax rotacionada em 90 graus.

  - De Cabeça Para Baixo: Mostra, por padrão, a página de fax de cabeça para baixo.

  - Invertido: Mostra o Fax em branco em um fundo preto.

resolução do Fax.

  - Auto: Alguns programas de transmissão usam como primeira letra do nome de um fax de resolução fina a letra "f" e a letra "n" para um fax de resolução normal. Se "Auto" está ativo, KFax observará esta convenção. Esta opção não tem efeito com TIFF e fax "PC-Research" (DigiFAX). Estes fax são auto especificados.

  - Fina: Assume que arquivos de fax (g3-g32d-g4) são fax de resolução fina. (7.7 linhas/mm). Arquivos Tiff e "PC-Research" (DigiFAX) são auto especificados.

  - Normal: Assume que arquivos de fax (g3-g32d-g4) são fax de resolução normal (3.85 linhas/mm). Cada linha de fax é duplicada na imagem mostrada para dar aproximadamente escalas horizontais e verticais.

dados do Fax:

  Marcando LS-Bit primeiro irá levar o KFax a assumir que a ordem dos bits de dados de fax estão revertidos. A especificação original de fax trabalha somente com transmissão serial de dados. Fabricantes de modems têm que decidir se o primeiro bit recebido será colocado na posição mais significante ou na menos significante do byte. O concenso é empacotar o bit mais significante primeiro, mas a opção está disponível para trabalhar com a ordem oposta.

Formato do Fax:

  - g3: Assume que os arquivos de entrada usam codificação grupo 3, 1-dimensional.

  - g32d: Assume que os arquivos de entrada usam codificação grupo 3, 2-dimensional.

  - g4: Assume que os qrquivos de entrada usam codificação grupo 4.

Altura e largura padrão dos Dados do Fax:

  - altura: especifica o número padrão de linhas para dados de fax

  - largura: especifica o número padrão de pixels em cada linha de varredura para dados de fax. O valor padrão é 1728

  - auto: esta opção é a configuração recomendada para dados de fax g3. g3-2d e g4 precisam de dimensões explícitas.

### Opções de Linha de Comando

KFax suporta as seguintes opções de linha de comando:

    wuebben: ../kfax -h
      uso: KFax <flags> arquivo ...
     -f resolução fina
     -n resolução normal
     -h altura (números de linhas de fax)
     -w largura (pontos por linha de fax)
     -l rotaciona a imagem 90 graus (modo paisagem)
     -u rotaciona a imagem deixando-a de cabeça para baixo
     -i inverte (preto/branco)
     -m limite de bytes para uso da memória (M m mega, K k kilo) padrão: 8
    mega
     -r os dados do fax são empacotados com ls-bit nos bytes de entrada
     -v informações sobre a versão
     -2 arquivos são g3-2d
     -4 arquivos são g4

### Teclas de controle do KFax

KFax tem a honra de possuir as seguintes teclas de controle quando o ponteiro é colocado sobre um documento de fax aberto

- `h` Mostra a página de ajuda indicando as disponíveis teclas de atalho.

- `q` Volta para o documento original.

- `n + Next PgDn Space` Vai para a próxima página.

- `p - Prior PgUp Backspace` Vai para a página anterior.

- `shift Home` Primeira página.

- `shift End` Última página.

- `u` rotaciona a imagem deixando-a de cabeça para baixo.

- `l` rotaciona a imagem 90 graus (modo paisagem).

- `m` Mostra uma imagem espelhada da página de fax corrente.

- `i` Aumentar

- `o` Diminuir

### Como criar arquivos de fax

Talvez o modo mais fácil de criar arquivos de fax seja primeiro criar um arquivo PostScript originado do documento que você deseja enviar por fax. E então usar o interpretador PostScript do ghostscript para transformar o arquivo PostScript em um dos vários formatos de arquivos de fax.

Para criar arquivos de fax através de documentos ps você orecisará do ghostscript. KFax pode mostrar todos os modos de fax gerados pela saída do ghostscript:

- raw: fag3 faxg32d faxg4

- tiff: tiffg3 tiffg32d tiffg4

Um arquivo "raw" não terá informação de paginação e será mostrado como um todo na janela de fax. Arquivos "tiff" contêm informação de paginação e pode ser paginado através da janela de fax.

#### Exemplo

Como criar um arquivo que sendfax/mgetty possa receber e enviar:

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

Assumindo que seu documento ps `seudocumento.ps` contem três páginas, isto irá resultar na criação de fax.g3.1 fax.g3.2 fax.g3.3

## Os Items do Menu

### Arquivo

#### Novo

Cria um novo documento no editor.

#### Open

Permite ao usuário abrir um arquivo de fax.

#### Adicionar

Permite ao usuário adicionar um arquivo de fax. Isto é particularmente útil para arquivos de fax g3/g32d/g4. O usuário pode adicionar todas as páginas de uma transmissão de fax e imprimí-las todas em uma única de impressão.

#### Fechar Fax

Fecha todos os arquivos de fax abertos no momento.

#### Abrir URL

Permite ao usuário abrir um arquivo de fax remoto direto da Internet.

#### Salvar em URL

Permite ao usuário salvar um arquivo de fax remoto direto na Internet.

#### Imprimir

Abre o diálogo de impressão e permite ao usuário imprimir as páginas do arquivo corrente.

#### Sair

Sai do visualizador de fax.

### Ver

#### Próxima

Mostra a próxima página de fax

#### Anterior

Mostra a página anterior de fax

#### Primeira

Mostra a primeira página de fax

#### Última

Mostra a última página de fax

#### Rodar

Rotaciona o fax em sentido anti-horário

#### Espelhar

Mostra uma imagem espelhada da página de fax corrente

#### Virar

Mostra a página corrente de fax de cabeça para baixo

#### Aumentar

Aumentar -- aumenta a vista corrente.

#### Diminuir -- diminui a vista corrente.

### Opções

#### Opções do Fax

Abre o diálogo Opções do Fax.

#### Esconder/Mostrar Barra de Ferramentas

Permite ao usuário ajustar a barra de ferramentas para visível ou oculta.

#### Esconder/Mostrar Barra de Status

Permite ao usuário ajustar a barra de status para visível ou oculta.

### Ajuda

#### Ajuda

Aciona o sistema de ajuda do KDE mostrando a ajuda do KFax.

#### Sobre

Mostra informações essenciais sobre o KFax.

## Perguntas e Respostas.

## Copyright

    KFax tem Copyright 1997 registrado por Bernd Johannes Wuebben,
                            wuebben@math.cornell.edu
                            wuebben@kde.org

    Este programa é software gratuito; você pode redistribuí-lo e/ou
    modificá-lo sob os  termos  da  GNU General Public License  como
    publicado  pela Free Software Foundation;  qualquer uma das duas
    versões de Licença, ou (em sua opinião) alguma versão anterior.

    Este  programa é distribuído com  a esperança de que seja  útil,
    mas SEM NENHUMA GARANTIA;  sem conformidade com implicações    e
    garantias de ACEITAÇÃO NO MERCADO  ou  AJUSTES  PARA  PROPÓSITOS
    PARTICULARES.   Veja  a  GNU  General  Public License para  mais
    detalhes.

    Você  deveria  ter  recebido  uma  cópia  da GNU  General Public
    License junto com este programa; se não recebeu, escreva para  a
    Free   Software  Foundation,  Inc.,   675  Mass Ave,  Cambridge,
    MA 02139, USA.

### Agradecimentos

Como sempre eu estou descansando nos ombros dos gigantes. Estou profundamente em dívida com Frank D. Cringle que escreveu o excelente visualizador de fax no qual KFax é parcialmente baseado:

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

Bem com a maravilhosa libtiff library version 2.3 beta:

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

E por último, mas não menos: Agradecimentos ao Trolls for Qt. http://www.troll.no