# 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, &eg;, 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.