# Usando o &kturtle;

Aqui está uma imagem do &kturtle; em ação Janela principal do &kturtle;

A janela principal do &kturtle; possui três componentes principais: o editor (1) à esquerda, onde você digita os comandos de &turtlescript;; a área de desenho (2) à direita, onde a tartaruga faz o seu desenho; e o inspetor (3) que lhe dá informações sobre as variáveis durante a execução do programa. Além dos componentes você pode encontrar a barra de menus (5) onde todas as ações podem ser acessadas; a barra de ferramentas (4) que permite-lhe selecionar rapidamente as ações mais utilizadas; o Console:, que você poderá usar para inserir um comando numa única linha para teste; e a barra de status (na parte inferior da janela) onde você encontrará alguma informação sobre o estado do &kturtle;.

## O editor

No editor, você poderá digitar os comandos de &turtlescript;. A maioria das suas funcionalidades são encontradas no menu Editar e Arquivo. O editor pode ser acoplado a qualquer um dos lados da janela principal ou poderá ser destacado e colocado em qualquer local da sua tela.

Você tem várias formas de obter algum código no editor. A forma mais fácil é usar um exemplo já feito. Selecione um exemplo no submenu Arquivo Exemplos. O arquivo de exemplo que escolher será aberto no editor, e você poderá ir então usar o menu Executar Executar (atalho: &Alt;F2) ou o botão Executar da barra de ferramentas para executar o código se desejar.

Você poderá abrir os arquivos de &turtlescript; selecionando o menu Arquivo Abrir....

A terceira forma é digitar diretamente o seu código no editor ou copiar/colar algum código.

## A área de desenho

A área de desenho é a área onde os comandos são visualizados, ou seja, onde eles desenham uma imagem. Em outras palavras, é o espaço de recreio da tartaruga. Depois de inserir algum código no editor e de executá-lo, duas coisas poderão acontecer: ou o código é executado perfeitamente e você poderá ver algo mudando na área de desenho, ou você tem um erro no seu código e existirá uma mensagem que lhe dirá qual o erro que você cometeu.

Você poderá ampliar ou diminuir a área de desenho com a roda do seu mouse.

## O inspetor

O inspetor informa-o das variáveis, as funções aprendidas e a árvore de código enquanto o programa está em execução.

O inspetor pode ser embutido em qualquer canto da janela principal ou pode ser desanexado e colocado em qualquer lugar de sua área de trabalho.

## A barra de ferramentas

Aqui você poderá acessar rapidamente às ações mais utilizadas. A barra de ferramentas também contém a caixa de entrada Console:, onde poderá invocar rapidamente os comandos; isto poderá ser útil no caso de querer testar um comando sem modificar o conteúdo do Editor.

Você poderá configurar a barra de ferramentas se usar o menu Configurações Configurar as Barras de Ferramentas..., para se ajustar às suas preferências.

## A barra de menus

No menu, você irá encontrar todas as ações do &kturtle;. Elas estão nos seguintes grupos: Arquivo, Editar, Área de Desenho, Executar, Ferramentas, Configurações e Ajuda. Esta seção descreve todas elas.

### Menu Arquivo

&Ctrl;N Arquivo Novo

- Cria um arquivo de &turtlescript; novo e vazio.

&Ctrl;O Arquivo Abrir...

- Abre um arquivo do &turtlescript;.

Arquivo Abrir recente

- Abre um arquivo de &turtlescript; que foi aberto recentemente.

Arquivo Exemplos

- Um exemplo dos programas do &turtlescript;. Os exemplos estão em seu idioma favorito, que poderá ser selecionado no submenu Configurações Linguagem dos scripts.

Arquivo Obter mais exemplos...

- Abra o diálogo Obter novidades para baixar arquivos do &turtlescript; adicionais da Internet.

&Ctrl;S Arquivo Salvar

- Salva o arquivo de &turtlescript; atualmente aberto.

&Ctrl;&Shift;S Arquivo Salvar como...

- Salva o arquivo do &turtlescript; aberto atualmente num local especificado.

Arquivo Exportar para HTML...

- Exporta o conteúdo atual do Editor como um arquivo em &HTML; que inclui as cores do realce.

&Ctrl;P Arquivo Imprimir...

- Imprime o código atual no editor.

&Ctrl;Q Arquivo Sair

- Sai do &kturtle;.

### Menu Editar

&Ctrl;Z Editar Desfazer

- Desfaz a última alteração no código. O &kturtle; pode fazer desfazer de forma ilimitada.

&Ctrl;&Shift;Z Editar Refazer

- Refaz uma alteração desfeita no código.

&Ctrl;X Editar Recortar

- Corta o texto selecionado do editor para a área de transferência.

&Ctrl;C Editar Copiar

- Copia o texto selecionado do editor para a área de transferência.

&Ctrl;V Editar Colar

- Cola o texto na área de transferência no editor.

&Ctrl;A Editar Selecionar tudo

- Seleciona todo o texto do editor.

&Ctrl;F Editar Procurar...

- Com esta ação, você poderá procurar frases no código.

F3 Editar Procurar próximo

- Use isto para procurar a próxima ocorrência da frase que estava pesquisando.

&Shift;F3 Editar Localizar anterior

- Use isto para procurar a ocorrência anterior da frase que estava pesquisando.

&Ins; Editar Modo de edição

- Alterne entre o modo de 'inserir' e 'sobrescrever'.

### Menu Tela

Área de Desenho Exportar para Imagem (PNG)...

- Exporta o conteúdo atual da Área de Desenho como uma imagem rasterizada no formato PNG (Portable Network Graphics).

Área de Desenho Exportar para Desenho (SVG)...

- Exporta o conteúdo atual da Área de Desenho como um desenho vetorial no formato &SVG; (Scalable Vector Graphics).

Área de Desenho Imprimir a Área de Desenho...

- Imprime o conteúdo atual da Área de Desenho.

### Menu Executar

F5 Arquivo Executar

- Inicia a execução dos comandos no editor.

F6 Executar Pausa

- Coloca a execução em pausa. Esta ação só fica ativa quando os comandos estiverem de fato sendo executados.

F7 Executar Interromper

- Interrompe a execução; esta ação só fica ativa quando os comandos estiverem de fato sendo executados.

Executar Velocidade da Execução

- Apresenta uma lista com as velocidades de execução possíveis, consistindo em: velocidade máxima (sem realce e inspetor), velocidade máxima, velocidade baixa, velocidade mais baixa, velocidade mínima e passo-a-passo. Quando a velocidade de execução é igual velocidade máxima (padrão), você poderá não conseguir ver o que está acontecendo. Em alguns dos casos este comportamento poderá ser o desejado, mas em outros casos você poderá querer ter uma ideia da execução. No último caso, você poderá desejar configurar a velocidade da execução como velocidade baixa, velocidade mais baixa ou velocidade mínima. Quando um dos modos lentos for selecionado, a posição atual de execução será exibida no editor. O passo-a-passo irá executar um comando por vez.

### Menu Ferramentas

Ferramentas Seletor de direção...

- Esta ação abre o diálogo do seletor de direção.

Ferramentas Seletor de cores...

- Esta ação abre o diálogo do seletor de cores.

### Menu Configurações

Configurações Linguagem de Programação

- Escolhe a linguagem para o código.

&Ctrl;E Configurações Mostrar o Editor

- Mostra ou oculta o Editor.

&Ctrl;I Configurações Mostrar o Inspetor

- Mostra ou oculta o Inspetor.

Configurações Mostrar os Erros

- Exiba ou esconda a aba Erros com a lista de erros resultantes do código em execução. Se esta opção estiver habilitada, clique na área de desenho para ver a tartaruga novamente.

F11 Configurações Mostrar números de linha

- Com esta ação, você poderá mostrar os números de linha no editor. Isto poderá ser útil para procurar um erro.

Configurações Mostrar barra de ferramentas

- Ativa ou desativa a barra de ferramentas principal.

Configurações Mostrar barra de estado

- Alterna a barra de status.

Configurações Configurar atalhos...

- O diálogo padrão do &kde; para configurar os atalhos.

Configurações Configurar barras de ferramentas...

- A janela padrão do &kde; para configurar as barras de ferramentas.

### Menu Ajuda

O &kturtle; tem o menu Ajuda padrão do &kde;, tal como se encontra descrito nos Fundamentos do &kde;, com um item adicional:

F2 Ajuda Ajuda sobre: ...

- Esta é uma função muito útil: ela oferece ajuda sobre o código sob o cursor na janela do editor. Por isso, ⪚, você poderá ter usado o comando `mostre` no seu código e deseja ler e aprender o que o manual diz sobre este comando. Basta mover o seu cursor para cima do `mostre` e pressionar então F2. O manual irá então mostrar toda a informação sobre o comando `mostre`.

  Esta função poderá ser útil enquanto aprende o &turtlescript;.

## A barra de status

Na barra de status você poderá saber o estado do &kturtle;. Do lado esquerdo, ela fornece o resultado da última ação. Do lado direito, você encontra a localização atual do cursor (os números da linha e da coluna). No meio da barra de status é indicado o idioma atual usado para os comandos.