Comandos

Ao usar os comandos, você diz à tartaruga ou ao KTurtle para fazer algo. Alguns comandos precisam de dados introduzidos, enquanto outros trazem resultados. Nesta secção iremos explicar todos os comandos incorporados que podem ser usados no KTurtle. Em alternativa, usando o aprender, poderá criar os seus próprios comandos. Os comandos incorporados ficam realçados a azul escuro.

Mover a tartaruga

Existem vários comandos para mover a tartaruga pelo ecrã.

forward (fw)
forward X

O forward move a tartaruga para a frente X pixels. Quando o traço está em baixo, a tartaruga irá deixar um rasto. O forward pode ser abreviado para fw

backward (bw)
backward X

O backward move a tartaruga para trás X pixels. Quando o traço está em baixo, a tartaruga irá deixar um rasto. O backward pode ser abreviado para bw.

turnleft (tl)
turnleft X

O turnleft diz à tartaruga para se virar X graus para a esquerda. O turnleft pode ser abreviado para tl.

turnright (tr)
turnright X

O turnright diz à tartaruga para se virar X graus para a direita. O turnright pode ser abreviado para tr.

direction (dir)
direction X

O direction configura a direcção da tartaruga para um ângulo de X graus a contar do zero, e isto não é relativo à direcção anterior da tartaruga. O direction pode ser abreviado para dir.

getdirection
getdirection

O getdirection devolve a direcção da tartaruga como um ângulo de X graus a contar do zero, onde o zero é a direcção em que a tartaruga aponta para cima.

center
center

O center move a tartaruga para o centro da área de desenho.

go
go X,Y

O go manda a tartaruga ir para um dado local da área de desenho. Este local está a X pixels do lado esquerdo da área de desenho e a Y pixels do topo da área.

gox
gox X

Ao usar o comando gox, a tartaruga irá mover-se X pixels a partir da esquerda da área de desenho, mantendo à mesma a sua altura. O gox pode ser abreviado para gx.

goy
goy Y

Ao usar o comando goy, a tartaruga irá mover-se Y pixels a partir do topo da área de desenho, mantendo à mesma a sua distância ao lado esquerdo da área de desenho. O goy pode ser abreviado para gy.

Nota

Usando os comandos go, gox, goy e center, a tartaruga não irá desenhar a linha, não interessando se a caneta está activa ou não.

Onde está a tartaruga?

Existem dois comandos que devolvem a posição da tartaruga no ecrã.

getx

O getx devolve o número de pixels da esquerda da área de desenho até à posição actual da tartaruga.

gety

O gety devolve o número de pixels de cima da área de desenho até à posição actual da tartaruga.

A tartaruga tem um traço

A tartaruga tem um traço e vai desenhando uma linha à medida que a tartaruga se move. Existem alguns comandos para controlar o traço. Nesta secção iremos explicar estes comandos.

penup (pu)
penup

O penup levanta o traço da área de desenho. Quando o traço está “em cima”, não é desenhada nenhuma linha à medida que a tartaruga se move. Veja também o pendown. O penup pode ser abreviado para pu.

pendown (pd)
pendown

O pendown carrega no traço para baixo na área de desenho. Quando o traço está “em baixo”, é desenhada uma linha à medida que a tartaruga se move. Veja também o penup. O pendown pode ser abreviado para pd.

penwidth (pw)
penwidth X

O penwidth configura a espessura do traço para X pixels. O penwidth pode ser abreviado para pw.

pencolor (pc)
pencolor R,G,B

O pencolor configura a cor do traço. O pencolor recebe uma combinação de RGB como parâmetro. O pencolor pode ser abreviado para pc.

Comandos para controlar a área de desenho

Existem vários comandos para controlar a área de desenho.

canvassize (cs)
canvassize X,Y

Com o comando canvassize, poderá definir o tamanho da área de desenho. Recebe um X e um Y como entrada, onde o o X é a nova largura da área de desenho em pixels e o Y é a nova altura da área de desenho em pixels. O canvassize pode ser abreviado para cs.

canvascolor (cc)
canvascolor R,G,B

O canvascolor configura a cor do traço. O canvascolor recebe uma combinação de RGB como parâmetro. O canvascolor pode ser abreviado para cc.

Comandos para limpar

Existem dois comandos para limpar a área de desenho, depois de você ter deixado tudo confuso.

clear (ccl)
clear

Com o clear, você poderá limpar todos os desenhos da área respectiva. Tudo o resto permanece igual: a posição e o ângulo da tartaruga, a cor da área de trabalho, a visibilidade da tartaruga e o tamanho da área de desenho.

reset
reset

O reset limpa tudo de forma mais abrangente que o comando clear. Depois de um comando reset, tudo fica tal e qual estava quando você iniciou o KTurtle. A tartaruga é posicionada no meio do ecrã, a cor da área de desenho é branca e a tartaruga irá desenhar uma linha preta na área de desenho, que fica com um tamanho de 400 x 400 0 pixels.

A tartaruga é uma imagem móvel

Muitas das pessoas não sabem o que são as imagens móveis ('sprites'), daí uma breve explicação: as imagens móveis são pequenas imagens que podem percorrer o ecrã (para mais informações, veja o glossário sobre as imagens móveis).

A seguir você irá encontrar uma apresentação completa de todos os comandos que lidam com imagens móveis.

[A versão actual do KTurtle não suporta ainda o uso de imagens móveis que não apenas a tartaruga. Nas versões futuras, você poderá mudar a tartaruga para outra coisa ao seu gosto]

spriteshow (ss)
spriteshow

O spriteshow torna a tartaruga visível de novo depois de ter ficado escondida. O spriteshow pode ser abreviado para ss.

spritehide (sh)
spritehide

O spritehide esconde a tartaruga. Isto pode ser usado se a tartaruga não couber no seu desenho. O spritehide pode ser abreviado para sh.

Será que a tartaruga escreve?

A resposta é: “sim”. A tartaruga sabe escrever e pode escrever tudo o que lhe disser para escrever.

print
print X

O comando print é usado para dizer à tartaruga para escrever algo na área de desenho. O print recebe números e texto como parâmetros. Você poderá executar o print para vários parâmetros com o sinal “+”. Veja aqui um pequeno exemplo:

$ano = 2004
$autor = "Ze"
print "O " + $autor + " iniciou o projecto do KTurtle em " + $ano + " e ainda continua a gostar de trabalhar nele!"

fontsize
fontsize X

O fontsize configura o tamanho da letra que é usado pelo print. O fontsize recebe um parâmetros que deverá ser um número. O tamanho é definido em pixels.

Comandos matemáticos

Os seguintes comandos são as instruções matemáticas mais avançadas do KTurtle.

round
round(x)

O round arredonda o número indicado ao inteiro mais próximo.

imprimir round(10.8)
avancar 20
imprimir round(10.3)
avancar 20

Com este código, a tartaruga iria apresentar os números 11 e 10.

random (rnd)
random X,Y

O random é um comando que recebe parâmetros e devolve resultados. Como parâmetros são necessários dois números, em que o primeiro define o resultado mínimo (X) e o segundo o máximo (Y). O resultado é um número escolhido aleatoriamente que é maior ou igual ao mínimo e menor ou igual ao máximo. Aqui está um pequeno exemplo:

repeat 500 {
  $x = random 1,20
  forward $x
  turnleft 10 - $x
}

Com o comando random, você poderá adicionar um pouco de confusão ao seu programa.

mod
mod X,Y

O comando mod devolve o resto da divisão do primeiro número pelo segundo.

sqrt
sqrt X

O comando sqrt é usado para descobrir a raiz quadrada de um número X.

pi
pi

Este comando devolve a constante Pi, 3,14159.

sin, cos, tan

sin X
cos X
tan X

Estes três comandos representam as conhecidas funções trigonométricas sin (seno), cos (coseno) e tan (tangente). O argumento de entrada destes comandos, o X, é um número.

arcsin, arccos, arctan

arcsin X
arccos X
arctan X

Estes comandos são as funções inversas do sin, cos e tan. O argumento de entrada destes comandos, o X, é um número.

Entrada de dados e reacção através de janelas

Uma janela poderá pedir alguma alguma reacção em especial ou a introdução de determinados dados. O KTurtle tem dois comandos para janelas, nomeadamente o message e o ask

message
message X

O comando message recebe uma cadeia de caracteres à entrada. Mostra então uma janela que contém o texto da cadeia de caracteres.

mensagem "O Ze iniciou o projecto do KTurtle em 2003 e ainda continua a gostar de trabalhar nele!"

ask
ask X

O ask recebe uma cadeia de caracteres à entrada. Mostra uma janela que contém o texto da cadeia de caracteres, tal como acontece no message. Contudo, para além disso, também mostra um campo de texto na janela. Através deste campo, o utilizador poderá introduzir um número ou uma cadeia de caracteres que poderá ser guardada numa variável ou passado como argumento a um comando. Por exemplo

$entrada = perguntar "Que idade tem?"
$saida = 2003 - $entrada
imprimir "Em 2003, você tinha " + $saida + " anos a dada altura."

Quando um utilizador cancelar a janela ou não introduzir nada de todo, a variável fica vazia.