# O Manual do &kworldclock;

&Brad.Hards; &Brad.Hards.mail;
Marcus Gama

    marcus_gama@uol.com.br

Tradução
2004 Brad Hards
&FDLNotice;
2004-01-22
0.00.00

O &kworldclock; é um aplicativo que mostra as partes do mundo que estão expostas neste momento à luz do dia e as partes que estão atualmente de noite. Mostra também a hora atual num conjunto de cidades do mundo inteiro.

KDE kdetoys kworldwatch Relógio Mundial relógio do dia / noite

## Introdução

O &kworldclock; é um aplicativo que mostra as partes do mundo que estão expostas neste momento à luz do dia e as partes que estão atualmente de noite. Mostra também a hora atual num conjunto de cidades do mundo inteiro.

Por favor comunique todos os problemas ou funcionalidades para as listas de correio do &kde;.

## Usando o &kworldclock;

### A área principal

Quando você inicia o &kworldclock;, você verá aparecer uma pequena janela, como é mostrado abaixo.

Aqui está uma captura de tela do &kworldclock;

Captura de tela

A seção clara (que na imagem acima cobre a zona da Antártida, da Austrália, da África Oriental e do Sul e a maior parte da Ásia, mais o Oceano Índico e a parte ocidental do Oceano Pacífico) mostra a área que está neste momento exposta à luz do dia, enquanto a seção mais escura (que, na imagem acima, cobre a Europa Ocidental, a América do Norte e do Sul, e a zona do Ártico) mostra a área que neste momento está de noite. O contorno entre a seção clara e a escura é a área que está passando pela madrugada ou pelo anoitecer.

Cada quadrado preto pequeno indica uma cidade ou um centro populacional. Se você deixar o mouse acima (ou perto) de um dos quadrados pretos, você irá ver a data e hora atual para essa localização. Na imagem acima, é mostrada a cidade de Brasília.

Você poderá achar mais conveniente expandir a janela, para que haja mais espaço entre os vários quadrados. Lembre-se que você poderá expandir a janela, clicando no botão de maximização (o segundo botão à direita no canto superior direito) ou usando o mouse para arrastar o canto da janela principal. Uma janela expandida, com Brasília (Brasil) selecionada é mostrada abaixo.

Captura de tela do &kworldclock; com a janela expandida

Captura de tela mostrando a janela expandida, com Brasília selecionada.

### Configurando o &kworldclock; com os relógios dos fusos-horários

Se você precisa saber a hora num conjunto de zonas ao redor do mundo, poderá ser útil ter o &kworldclock; mostrando as horas aplicáveis. É mostrado abaixo um exemplo de como isso poderá ficar.

Captura de tela do &kworldclock; com relógios

Captura de tela mostrando a janela expandida, com três relógios.

Repare nos relógios para Perth, Sidney e Berlim na parte inferior da janela principal do &kworldclock;.

Estes relógios são adicionados ao usar o botão direito do mouse e selecionando o item Relógio, como é mostrado abaixo.

Captura de tela do relógio do &RMB; do &kworldclock;

Captura de tela mostrando o menu do &RMB; com o Relógio selecionado.

Isto irá permitir o acesso à seleção do Adicionar..., que irá mostrar uma janela como a que aparece abaixo. O conteúdo da janela é determinado a partir da cidade mais próxima do cursor do mouse quando fizer a seleção.

Captura de tela da janela Editar a Configuração do Relógio do &kworldclock;

Captura de tela mostrando a janela Editar a Configuração do Relógio.

Você poderá agora fazer uma seleção apropriada para a legenda do relógio e para o fuso-horário. Repare que você poderá alterar a legenda para algo apropriado e o fuso-horário de acordo com a necessidade. Um exemplo, para a pequena cidade Australiana de Quairading, é mostrado abaixo.

Captura de tela da janela de &kworldclock; para Editar a Configuração do Relógio modificado para Quairading

Captura de tela mostrando a janela para Editar a Configuração do Relógio para Quairading.

Quando você selecionar OK, o item do relógio é adicionado ao fundo da janela principal. Uma imagem com o item extra para Quairading, é mostrado abaixo.

Captura de tela do &kworldclock; com o relógio em Quairading

Captura de tela mostrando o relógio de Quairading.

Você poderá reparar agora que Perth e Quairading estão agora mostrando a mesma informação (uma vez que estão no mesmo fuso-horário). Neste caso, o item de Perth já não é mais necessário, por isso poderá ser removido. Isto pode ser feito se usar outra vez o botão direito do mouse na área dos relógios e selecionar o item Remover.

Você poderá também editar os itens usando a opção Editar... no menu do botão direito do mouse, que poderá ser útil para fazer as alterações menores.

### Adicionando Bandeiras à Janela do &kworldclock;

Como é mostrado na imagem abaixo, você poderá adicionar bandeiras aos locais do mapa (neste caso, Fremantle perto de Perth, Austrália Ocidental; perto de Moscovo, na Rússia e os Açores, no meio do Atlântico). Estas opções não afetam nenhuma outra funcionalidade - simplesmente permitem-lhe localizar rapidamente os pontos de interesse.

Captura de tela do &kworldclock; com bandeiras

Captura de tela mostrando a janela expandida com três bandeiras.

Você poderá adicionar bandeiras colocando o mouse no ponto que deseja que apareça e usando o botão direito do mouse para selecionar o item Bandeiras.... Você poderá selecionar uma das três bandeiras pré-definidas (isto é, Adicionar Vermelha, Adicionar Verde ou Adicionar Azul), ou poderá selecionar uma cor personalizada.

Você usa a mesma ação do menu para remover uma bandeira (a que estiver mais próxima do mouse quando você fizer a seleção do Excluir Bandeira) ou para remover todas as bandeiras usando a opção Excluir Todas as Bandeiras.

### Modificando a janela do &kworldclock;

Além dos relógios e bandeiras adicionais, existem outras pequenas variações que você poderá fazer na área principal de visualização do &kworldclock;, como por exemplo não mostrar as bandeiras, não mostrar os pequenos quadrados pretos e não mostrar as áreas de dia/noite. Cada uma destas opções é selecionada com o menu do botão direito do mouse.

Para ativar e desativar a visualização das seções de dia / noite, você usa o botão direito do mouse e seleciona o item Mostrar Luz Solar do menu. Cada vez que selecioná-la, a opção será alternada. Quando a visualização do dia e da noite fica ativa (o modo normal na primeira inicialização), existirá uma pequena marcação ao lado do Mostrar Luz Solar. Um exemplo do item do menu (com o dia / noite inativo) é mostrado abaixo.

Captura de tela da luz do dia com o &RMB; do &kworldclock;

Captura de tela mostrando o menu do &RMB;, com a opção Mostrar Luz do Dia.

Para ativar e desativar a visualização dos pequenos quadrados pretos das cidades, você usa o menu do botão direito e seleciona a opção Mostrar Cidades do menu. Cada vez que a seleciona, a seleção será alternada. Quando a visualização das cidades está ativa (o modo normal na primeira inicialização), existirá uma pequena marcação ao lado do Mostrar Cidades. Um exemplo do item do menu (com as bandeiras ativas) é mostrado abaixo.

Captura de tela do menu do &RMB; do &kworldclock; mostrando as cidades

Captura de tela mostrando o menu do &RMB; com a opção Mostrar Cidades selecionada.

Para ativar e desativar a visualização das bandeiras, você usa o menu do botão direito e seleciona a opção Mostrar Bandeiras do menu. Cada vez que a seleciona, a seleção será alternada. Quando a visualização das bandeiras está ativa (o modo normal na primeira inicialização), existirá uma pequena marcação ao lado do Mostrar Bandeiras. Um exemplo do item do menu (com as bandeiras ativas) é mostrado abaixo.

Captura de tela do menu do &RMB; do &kworldclock; mostrando as bandeiras

Captura de tela mostrando o menu do &RMB; com a opção Mostrar Bandeiras.

Depois de reconfigurar o &kworldclock;, você poderá desejar salvar as suas configurações. Isto é feito com o botão direito do mouse, selecionando a opção Salvar Configurações.

### Selecionando mapas alternativos

Além do mapa de profundidade da superfície normal, você poderá adicionar novos mapas, que poderão ser selecionados, usando o item Tema do Mapa do menu do botão direito do mouse. O &kworldclock; vem com um único mapa, que dá uma ideia da profundidade da superfície (em relevo). Os mapas adicionais poderão ser obtidos em http://www.radcyberzine.com/xglobe. Os mapas têm que ser devidamente instalados - tipicamente em `share/apps/kworldclock/maps`, sob o diretório principal do &kde;. Consulte o administrador do seu sistema para ajudá-lo a fazer isto, se for necessário.

Se você quiser usar o seu próprio mapa, você deverá certificar-se que Greenwich fica exatamente no meio do mapa e fornecer um arquivo 'desktop' apropriado.

## Guia de Programação do &kworldclock;

O requisito mais comum para a programação com o &kworldclock; é adicionar cidades ao mapa. As cidades são determinadas por um arquivo chamado `zone.tab`, que se localiza na pasta `share/apps/kworldclock`, sob o diretório principal do &kde;.

Para adicionar uma nova cidade, você terá que saber a latitude e longitude, assim como também as informações de fuso-horário aplicáveis. Existem informações adicionais sobre o formato exato que é necessário no arquivo `zone.tab`.

## Créditos e Licença

&kworldclock;

Direitos Autorais do Programa 2000 Matthias Hoelzer-Kluepfel.

Direitos Autorais da Documentação © 2004 &Brad.Hards; &Brad.Hards.mail;.

Tradução de Marcus Gamamarcus_gama@uol.com.br

&underFDL; &underGPL;

## Instalação

### Como obter o &kworldclock;

&install.intro.documentation;

### Compilação e Instalação

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