# O Manual do &khexedit;

Jonathan Singer

    jsinger@leeta.net

Espen Sand

    espensa@online.no

Desenvolvimento
Lauri Watts

    lauri@kde.org

Revisão
José Pires

    jncp@netcabo.pt

Tradução
1999-2000 Jonathan Singer
&FDLNotice;
2001-07-06
0.08.05

O &khexedit; é um editor de hexadecimal para o ambiente do &kde;.

KDE Kapp editar binário hexadecimal

## Introdução

O &khexedit; é um editor para os dados em bruto dos ficheiros binários. Ele inclui as funcionalidades de procura e substituição, favoritos, várias opções de configuração, o suporte para arrastar e largar, assim como outras funcionalidades poderosas.

## Iniciar o &khexedit;

Escreva ``khexedit`` numa linha de comandos ou seleccione o item Editor Binário no menu Utilitários no menu inicial do KDE.

As opções normais da linha de comandos para o &Qt; e o &kde; estão disponíveis e podem ser listadas se digitar ``khexedit` `--help``.

As outras opções da linha de comandos são:

`<ficheiro>` - abre o ficheiro indicado

`--offset` <posição> salta para a a posição <posição> no ficheiro aberto.

## O &khexedit; em Geral

A janela principal do &khexedit; tem os seguintes componentes: a barra de menu, a barra de ferramentas, a coluna da posição, a janela de edição de dados, o campo de texto, a barra de procura, o campo de conversão e a barra de estado.

O Ecrã do &khexedit;
O Ecrã do &khexedit;

Quando está aberto um documento, os 'bytes' são mostrados no formato hexadecimal na janela de edição de dados. Os dados podem ser editados, cortados, copiados, colados arrastados e largados como acontece com o texto normal num editor ou num processador de texto. O cursor marca a posição actual. Se carregar na tecla de Insert muda entre o modo de sobreposição e o de inserção de texto. Os dados também poderão ser mostrados em octal, binário ou em decimal, se escolher o formato desejado no menu Ver.

A coluna da posição à esquerda indica a posição de um 'byte' no ficheiro. O campo de texto à direita mostra a codificação em ASCII do ficheiro. A posição do cursor e as edição na janela de edição de dados são reflectidas no campo de texto. Este pode também ser editado, e essas alterações são reflectidas na janela de edição de dados.

A barra de pesquisa permite ao utilizador procurar por um dado valor -- seja hexadecimal, octal, binário, decimal ou texto.

O campo de conversão mostra o valor do 'byte' na posição do cursor numa variedade de bases. Este também mostra o valor de todos os tipos de dados padrão que começam no cursor.

Podem ser abertos vários documentos ao mesmo tempo mas só um é que poderá estar activo. Use o menu Documentos para seleccionar qual o documento que estará activo.

## Comandos do Menu

Repare que a maioria dos comandos do menu também têm um atalho do teclado.

### O Menu Ficheiro

&Ctrl;N Ficheiro Novo

  Abre um novo ficheiro.

&Ctrl;O Ficheiro Abrir...

  Abrir um ficheiro existente.

&Ctrl; I Ficheiro Inserir...

  Insere um ficheiro existente no documento actual.

Ficheiro Abrir um Recente

  Escolha o ficheiro a abrir numa lista com os últimos ficheiros abertos.

Ficheiro Reverter

  Devolve o documento editado para o último estado gravado.

&Ctrl;S Ficheiro Gravar

  Grava o documento.

Ficheiro Gravar Como...

  Grava o documento com um nome novo.

&Ctrl;W Ficheiro Fechar

  Fecha o documento actual.

&Ctrl;P Ficheiro Imprimir...

  Imprime o documento actual.

Ficheiro Exportar...

  Exporta o documento seleccionado ou um pedaço do mesmo.

  Abre uma janela com estas opções:

  Formato

    Texto simples, tabela de HTML, texto formatado (RTF) ou vector em C. Use a página Opções para seleccionar os detalhes para um vector em C ou uma tabela em HTML.

  Destino

    O ficheiro para o qual os dados serão exportados

  Exportar Gama

    Selecciona quais os dados a exportar -- o documento inteiro, a parte seleccionada ou o intervalo entre duas posições indicadas.

Ficheiro Cancelar Operação

  Pára a operação actual

Ficheiro Permissões

  Define os privilégios de escrita:

  Apenas para leitura

    Quando estiver assinalado, as alterações não poderão ser feitas no ficheiro apresentado.

  Permitir Alteração de Tamanho

    Quando estiver desligado, os 'bytes' em particular poderão ser alterados mas o número total de 'bytes' não.

Ficheiro Nova Janela

  Abre a uma janela adicional do &khexedit;

Ficheiro Fechar a Janela

  Fecha a janela actual do &khexedit;

&Ctrl;Q Ficheiro Sair

  Fecha todas as janelas do &khexedit;

### O Menu Editar

&Ctrl;Z Editar Desfazer

  Anula a última acção.

&Ctrl;&Shift;Z Editar Refazer

  Repete a última acção anulada.

&Ctrl;X Editar Cortar

  Corta o texto seleccionado de momento e copia-o para a área de transferência.

&Ctrl;C Editar Copiar

  Copia o texto seleccionado para a área de transferência.

&Ctrl;V Editar Colar

  Insere o texto cortado ou copiado a partir da área de transferência.

Editar Especial

  Algumas variantes do Copiar e do Colar:

  - Copiar como Texto: Copia os 'bytes' seleccionados como caracteres em ASCII.

  - Colar num Ficheiro Novo.

  - Cola numa nova janela.

&Ctrl;A Editar Seleccionar Tudo

  Selecciona o documento inteiro.

Editar Deseleccionar

  Deselecciona o documento inteiro.

&Ctrl;F Editar Procurar...

  Procura um padrão em especial no documento. Poderão ser procurados padrões em hexadecimal, decimal, octal, binário ou em texto.

  As opções da janela permitem-lhe indicar o ponto inicial, a direcção e o âmbito da procura.

F3 Editar Procurar o Próximo

  Procura a próxima instância do padrão de Procurar.

&Shift;F3 Editar Procurar Anterior

  Procura a instância anterior do padrão do Procurar.

&Ctrl;R Editar Substituir...

  Substitui o padrão de procura com outro padrão diferente.

&Ctrl;G Ir Ir Para a Posição...

  Move o cursor para uma posição indicada.

&Ctrl;Ins Editar Inserir um Padrão...

  Introduz uma sequência específica de 'bytes'.

  As opções da janela permitem-lhe definir o tamanho do padrão, o seu formato (hexadecimal, decimal, octal, binário ou texto) e o ponto de inserção.

  Se o Repetir o padrão estiver assinalado, o padrão indicado será repetido até atingir o valor definido no Tamanho.

### O Menu Ver

Ver Hexadecimal Ver Decimal Ver Octal Ver Binário Ver Texto

  As primeiras cinco opções seleccionam o formato apresentado na janela de edição de dados: hexadecimal, decimal, octal, binário ou texto. Quando é seleccionada a visualização em texto, o campo de texto extra não é apresentado.

Ver Mostrar a Coluna da Posição

  Comuta a apresentação da coluna de posição.

Ver Mostrar o Campo de Texto

  Comuta a apresentação do campo de texto.

Ver Posição em Decimal

  Quando definido, todas as posições são mostradas e interpretadas como números em decimal em vez de hexadecimal.

Ver Maiúsculas (Dados)

  Quando assinalado, os dígitos em hexadecimal dos dados são mostrados em maiúsculas.

Ver Maiúsculas (Posição)

  Quando assinalado, os dígitos em hexadecimal no campo da posição são mostrados em maiúsculas.

Ver Codificação do Documento

  Selecciona a codificação usada para a visualização no campo de texto. As codificações alternativas como o EBCDIC e o ASCII de 7 bits podem ser usadas. As codificações adicionais podem ser adicionadas pelo utilizador (embora ainda não esteja implementadas).

### O Menu Favoritos

&Ctrl;B Favoritos Adicionar aos Favoritos

  Marca uma localização dentro do documento.

  Poderão ser marcados vários favoritos para um único documento. Cada documento tem o seu próprio conjunto de favoritos e o conjunto apropriado é mostrado no fundo do menu de Favoritos quando um documento é seleccionado. Seleccione um favorito para ir para ele.

&Ctrl;E Editar Substituir o Favorito

  Limpa um favorito existente na posição actual do cursor. Será aberta uma janela com a lista dos favoritos disponíveis; seleccione o que deseja alterar.

&Ctrl;U Favoritos Remover o Favorito

  Remove um favorito existente. Será aberta uma lista com os favoritos disponíveis; seleccione nela o favorito que deseja remover.

Favoritos Remover Tudo

  Limpa a lista de favoritos.

&Alt;Baixo Favoritos Ir Para Próximo Favorito

  Move o cursor para o próximo favorito.

&Alt;Cima Favoritos Ir Para Favorito Anterior

  Move o cursor para o favorito anterior.

### O Menu Ferramentas

Ferramentas Extrair o Texto...

  Localiza o texto em ASCII nos dados. O tamanho mínimo do texto, a distinção de maiúsculas ou minúsculas e o padrão de correspondência podem ser indicados.

Ferramentas Filtro Binário...

  Efectua uma operação binária nos dados. A operação (E, OU, ROTAÇÃO...) e o operando podem ser indicados na janela. As opções a marcar na janela permitem que a operação seja limitada a determinados 'bytes' ou à região antes ou depois do cursor.

Ferramentas Tabela dos Caracteres

  Abre uma lista com valores e os seus equivalentes em ASCII e introduz o valor seleccionado no cursor.

Ferramentas Conversor

  Indique um valor em qualquer um dos campos e veja o seu equivalente em hexadecimal, decimal, octal, binário ou texto. Uma opção permite a visualização do valor no cursor em alternativa.

Ferramentas Estatísticas

  Mostra a frequência da ocorrência de valores no documento.

### O Menu Documentos

Oferece uma lista com os documentos abertos. A selecção de um deles torna-o o documento activo.

### O Menu Configuração

Configuração Mostrar a Barra de Ferramentas

  Comuta a visibilidade da barra de ferramentas por baixo do menu.

Configuração Mostrar a Barra de Estado

  Comuta a visibilidade da barra de estado

Configuração Mostrar a Localização Completa

  Comuta a visualização da localização completa do ficheiro na barra do título

Configuração Páginas dos Documentos

  Muda a visibilidade das páginas para todos os documentos actuais. O selector da página pode ser visível por cima ou por baixo da janela de edição, ou poderá estar escondido. Você poderá achar as páginas mais úteis do que o menu dos documentos para mudar de um para outro.

Configuração Campo de Conversão

  Muda a visibilidade do campo de conversão de valores. Pode estar incorporado na janela principal, passar a uma janela flutuante ou ser escondido.

Configuração Barra de Procura

  Muda a visibilidade da barra de procura de valores. Pode estar visível por cima ou por baixo da janela de edição, ou ainda estar escondida.

Configuração Gravar a Configuração

  Grava o estado actual das opções.

Configuração Preferências...

  Altera estas opções:

  Disposição

    Tamanho da linha e da coluna (em 'bytes'). Estes podem ser definidos em separado para diferentes modos. Um número fixo de 'bytes' por linha, bloquear a coluna no fim de linha. As linhas de grelhe entre as linhas e as colunas. A largura dos campos separadores, o espaçamento e as margens.

  Cursor

    A taxa de intermitência e o aspecto do cursor. O comportamento do cursor quando a janela deixa de estar em primeiro plano.

  Tipo de Letra

    O nome do tipo de letra, o estilo e o tamanho. O carácter usado para mostrar os caracteres não visíveis no campo de texto.

  Cores

    Todas as cores no &khexedit; poderão ser personalizadas, incluindo as linhas e colunas pares e ímpares, os favoritos, os separadores e as linhas de grelhas. A única excepção é a cor da selecção, que utiliza a configuração do Centro de Controlo do KDE.

  Ficheiros

    A abertura do último, ou de todos os últimos documentos recentes no arranque. A reposição da posição do cursor. A activação da protecção de escrita por omissão. A criação de uma cópia de segurança ao gravar os ficheiros. A gravação da lista dos Documentos Recentes ao sair. A lista dos Documentos Recentes pode também ser limpa nesta janela.

  Diversos

    A cópia automática, após a selecção, para a área de transferência. O arranque no modo de inserção, em vez do modo de sobreposição. A necessidade de confirmação para voltar ao início ou ao fim da linha nas procuras. Os saltos do cursor para o 'byte' mais próximo quando se move no modo binário. A ocorrência de um som ao digitar dados ou quando ocorre um erro fatal. A apresentação dos favoritos na coluna da posição e nos campos de edição. A notificação quando o número de páginas imprimíveis excede um limite predefinido. O número máximo de execuções do Desfazer.

### O Menu Ajuda

&help.menu.documentation;

### Barra de Ferramentas

A barra de ferramentas contém ícones para os seguintes comandos:

(Excepto para o Arrastar o documento e para Comutar a protecção de escrita, todos se comportam de forma idêntica ao comando do menu).

- Arrastar o documento -- Carregue neste botão e arraste para um ficheiro de texto ou para uma nova janela do &khexedit;.

- Novo

- Abrir

- Reverter

- Gravar

- Imprimir

- Procurar

- Procurar o Próximo

- Procurar o Anterior

- Cortar

- Copiar

- Colar

- Desfazer

- Refazer

- Cancelar Operação

- Ajuda

..e à direita da barra de ferramentas..

Comutar a protecção de escrita - muda entre os modos apenas para leitura e o de leitura/escrita.

#### Barra de procura

A barra de procura é usada para localizar um dado valor no documento. Indique um valor no campo, seleccione a representação desejada (hexadecimal, octal, binária, decimal ou texto) e carregue no botão Procurar. Carregue no botão Para trás para procurar para trás, a partir do cursor, ou assinale o Ignorar a capitalização para uma procura de texto sem distinção de maiúsculas ou minúsculas. Carregue no botão à direita da barra (X) para esconder a barra de procura; vá à Barra de procura no menu de Configuração para a repor.

#### Campo de conversão

O campo de conversão mostra os valores dos vários tipos de dados no 'byte' seleccionado. Para os tipos de 8 bits, mostra o valor do 'byte' sob o cursor; para os tipos maiores, mostra o valor que começa nesse 'byte'. A coluna mais à direita mostra as várias codificações do 'byte' actual. As opções no campo de conversão são:

Mostrar descodificação em 'little endian'

  Quando está assinalado, faz com que os tipos com vários 'bytes' seja calculados usando o método 'little-endian' usado pelos processadores x86 e Alpha. Neste esquema, o primeiro 'byte' representa a parte menos significativa do valor. (0a 4e = 0x4e0a = 19978). Quando estiver desligado, os tipos de vários 'bytes' são calculados com o método 'big-endian' usado pelos processadores PowerPC e Sparc. (0a 4e = 0x0a4e = 2638)

Mostrar o 'unsigned' como hexadecimal

  Quando assinalado, faz com que os tipos sem sinal sejam mostrados em hexadecimal, em vez de ser em decimal.

Comprimento da sequência

  Indica o número de 'bits' usados para calcular os valores nos campos acima.

#### Barra de Estado

A barra de estado mostra a seguinte informação:

Codificação/Selecção

  Quando não estiver nada seleccionado, este campo mostra a opção de codificação usada. (Veja em Ver Codificação do Documento para mais informações sobre a codificação). O ponto de início e o tamanho da selecção são mostrados.

Ficheiro Modificado

  Um `!` nesta zona indica que o ficheiro foi modificado.

Inserir/Sobrepor

  Indica se os valores introduzidos pelo teclado são introduzidos na posição do cursor (INS) ou se sobrepõem os dados que começam no cursor (SOB). Use a tecla Insert para alternar entre os dois modos.

Tamanho

  Mostra o tamanho total do documento actual.

Posição

  Indica a posição do cursor no documento.

Modo de visualização

  Indica se a janela de edição de dados está a mostrar os valores em hexadecimal, octal, binário, decimal ou texto. Mude de modos com o menu Ver.

Protecção de Escrita

  Indica se o documento pode ser editado (RW) ou se está apenas aberto para leitura (R). Mude entre modos com o botão do lado direito da barra de ferramentas ou com o comando Permissões no menu Ficheiro.

## Créditos e Licença

&khexedit;

Programa copyright 1999-2000 Espen Sand espensa@online.no

Contribuições:

- Leon Lessing leon@irlabs.com

- Craig Graham c_graham@hinge.mistral.co.uk

- Dima Rogozin dima@mercury.co.il

- Edward Livingstone-Blade sbcs@bigfoot.com

Documentação copyright 2000 Jonathan Singer jsinger@leeta.net

Tradução de José Nuno Pires jncp@netcabo.pt

&underFDL; &underGPL;

## Compilação e Instalação

&install.intro.documentation; &install.compile.documentation;
&documentation.index;