Con las órdenes podemos decirle a la tortuga o a KTurtle lo que tiene que hacer. Algunas órdenes requieren de parámetros de entrada, mientras que otras devuelven parámetros de salida. En esta sección se explican todas las órdenes integradas en KTurtle. Alternativamente, puedes usar aprender
para crear tus propias órdenes. Las órdenes que van a detallarse aquí aparecen resaltadas en azul oscuro.
Hay varias órdenes que permiten mover la tortuga por la pantalla.
- avanzar (avz)
avanzar X
avanzar
desplaza la tortuga hacia delante X píxeles. Cuando el pincel está bajado, la tortuga deja a su paso un trazo. avanzar
puede abreviarse como avz
.
- retroceder (ret)
retroceder X
retroceder
hace retroceder la tortuga X píxeles. Cuando el pincel está bajado, la tortuga deja a su paso un trazo. retroceder
puede abreviarse como ret
.
- izquierda (izq)
izquierda X
izquierda
le ordena a la tortuga que rote X grados hacia la izquierda. izquierda
puede abreviarse como izq
.
- derecha (der)
derecha X
derecha
le ordena a la tortuga que rote X grados hacia la derecha. derecha
puede abreviarse como der
.
- dirección (dir)
dirección X
dirección
determina el ángulo de dirección de la tortuga, que será X grados contando a partir de cero. No se tiene en cuenta la dirección anterior de la tortuga. dirección
puede abreviarse como dir
.
- obtenerdirección
obtenerdirección
obtenerdirección
determina el ángulo de dirección de la tortuga, que será X grados contando a partir de cero.
- centrar
centrar
centrar
mueve la tortuga al centro del lienzo.
- ir
ir X; Y
ir
le ordena a la tortuga que se desplace a una posición concreta del lienzo. Esta posición está a X píxeles del margen izquierdo del lienzo y a Y píxeles del margen superior del lienzo.
- irx
irx X
irx
le ordena a la tortuga que vaya a una posición que está a X píxeles del margen izquierdo del lienzo, sin modificar su altura. irx
se puede abreviar con ix
.
- iry
iry Y
iry
le ordena a la tortuga que vaya a una posición que está a Y píxeles del margen superior del lienzo, sin modificar la distancia a la que se encuentre del margen izquierdo. iry
se puede abreviar con iy
.
Nota
Con las órdenes ir
, irx
, iry
y centrar
, la tortuga no dibuja ningún trazo, independientemente de que el pincel esté bajado o no.
Hay dos órdenes que devuelven la posición de la tortuga en la pantalla.
- obtenerx
obtenerx
devuelve el número de píxeles desde el margen izquierdo del lienzo de la posición actual de la tortuga.
- obtenery
obtenery
devuelve el número de píxeles desde el margen superior del lienzo de la posición actual del la tortuga.
La tortuga tiene un pincel
La tortuga tiene un pincel que dibuja una línea cuando esta se desplaza. Hay varia órdenes que controlan el pincel. En esta sección se explican estas órdenes.
- levantarpincel (lpl)
levantarpincel
levantarpincel
alza el pincel del lienzo. Cuando el pincel está «levantado», la tortuga no deja ningún trazo cuando se desplaza. Consulta también bajarpincel
. levantarpincel
puede abreviarse como lpl
.
- bajarpincel (bpl)
bajarpincel
bajarpincel
presiona el pincel sobre el lienzo. Cuando el pincel está «bajado», la tortuga deja un trazo a su paso. Vea también levantarpincel
. bajarpincel
puede abreviarse como bpl
.
- grosorpincel (gpl)
grosorpincel X
grosorpincel
fija el grosor de la línea trazada por la tortuga en X píxeles. grosorpincel
puede abreviarse como gpl
.
- colorpincel (cpl)
colorpincel R;G;B
colorpincel
fija el color del pincel. El parámetro de entrada de colorpincel
es una combinación RGB. colorpincel
puede abreviarse como cpl
.
Órdenes que controlan el lienzo
Existen varias órdenes que controlan el lienzo.
- tamañolienzo (tl)
tamañolienzo X;Y
Con la orden tamañolienzo
puede modificar las dimensiones del lienzo. Requiere de X e Y como parámetros de entrada, donde X es el ancho en píxeles del nuevo lienzo, e Y es la altura del nuevo lienzo también en píxeles. tamañolienzo
puede abreviarse como tl
.
- colorlienzo (cl)
colorlienzo R;G;B
colorlienzo
define el color del lienzo. El parámetro de entrada de colorlienzo
es una combinación RGB. colorlienzo
puede abreviarse como cl
.
Existen dos comandos que permiten limpiar el lienzo después de un embrollo.
- limpiar (lmp)
limpiar
Con limpiar
puede borrar todos los dibujos del lienzo. Todo lo demás permanece: la posición y ángulo de la tortuga, el color del lienzo, la visibilidad de la tortuga y el tamaño del lienzo.
- reiniciar
reiniciar
reiniciar
borra todo de una forma más concienzuda que la orden limpiar
. Después de una orden reiniciar
, todo vuelve a como estaba cuando inició KTurtle. La tortuga regresará a su posición en el centro del lienzo, el color del lienzo volverá a ser blanco, la tortuga dibujará de nuevo una línea negra en el lienzo y el tamaño del lienzo será 400x400 píxeles.
La tortuga es un duendecillo
Antes de nada conviene explicar qué son los sprites: los duendecillos son pequeñas figuras que pueden desplazarse por la pantalla, como vemos con frecuencia en los videojuegos. Nuestra tortuga también es un duendecillo. Para obtener más información, consulta la entrada en el glosario correspondiente a los duendecillos.
A continuación, encontrarás una descripción detallada de todas las órdenes relacionadas con duendecillos.
Nota
La versión actual de KTurtle no admite otro duendecillo aparte de la tortuga. En las versiones futuras sí que podrá cambiar la tortuga por algo diseñado por usted mismo.
- mostrartortuga (mt)
mostrartortuga
mostrartortuga
vuelve visible de nuevo a la tortuga después de haberla ocultado. mostrartortuga
puede abreviarse como mt
.
- ocultartortuga (ot)
ocultartortuga
ocultartortuga
oculta la tortuga. Puede usarse cuando la tortuga no quede bien en su dibujo. ocultartortuga
puede abreviarse como ot
.
¿La tortuga puede escribir?
La respuesta es «sí». La tortuga puede escribir: escribirá todo lo que le ordenes.
- escribir
escribir X
La orden escribir
le indica a la tortuga que escriba algo en el lienzo. El parámetro de entrada de escribir
puede ser un número o una cadena. Puedes concatenar varios números y cadenas usando el símbolo «+». Aquí tienes un ejemplo sencillo:
$año = 2003
$autor = "Cies"
escribir $autor + " comenzó a trabajar en el proyecto KTurtle en " + $año + " y todavía disfruta haciéndolo"
- tamañoletra
tamañoletra X
tamañoletra
fija el tamaño del tipo de letra que usa la orden escribir
. El parámetro de entrada de tamañoletra
tiene que ser un número. El tamaño viene determinado en píxeles.
Las siguientes son algunas de las órdenes aritméticas más avanzadas de KTurtle.
- redondear
redondear(X)
Permite redondear
el número dado a su entero más cercano.
escribir redondear(10,8)
avanzar 20
escribir redondear(10,3)
Este código hace que la tortuga escriba los números 11 y 10.
- aleatorio (alt)
aleatorio X;Y
aleatorio
es una orden que requiere de parámetros de entrada y que devuelve un parámetro de salida. Como parámetros de entrada, necesita dos números, el primero (X) fija el valor mínimo del parámetro de salida, y el segundo (Y) fija su valor máximo. El parámetro de salida es un número elegido al azar que es igual o más grande que el valor mínimo, e igual o más pequeño que el valor máximo. Aquí tiene un ejemplo sencillo:
repetir 500 {
$x = aleatorio 1;20
avanzar $x
izquierda 10 - $x
}
Con la orden aleatorio
puedes incorporar algo de caos a tu programa.
- mod
mod X,Y
La orden mod
devuelve el resto de la división del primer número entre el segundo número.
- raíz
raíz X
La orden raíz
sirve para calcular la raíz cuadrada de un número X.
- pi
pi
Esta orden devuelve el valor del número Pi, 3,14159
.
- sen, cos, tan
sen X
cos X
tan X
Estas tres órdenes representan las famosas funciones trigonométricas sen
, cos
y tan
. El parámetro de entrada de estas tres órdenes, X, es un número.
- arcsen, arccos, arctan
arcsen X
arccos X
arctan X
Estas tres órdenes son las funciones inversas de sen, cos y tan. El parámetro de entrada de estas órdenes, X, es un número.
Entrada e información mediante diálogos
Un diálogo es una pequeña ventana emergente que proporciona información o que solicita un parámetro de entrada. KTurtle tiene dos órdenes relacionadas con diálogos: mensaje
y preguntar
.
- mensaje
mensaje X
La orden mensaje
necesita una cadena como parámetro de entrada. Muestra una ventana emergente con el texto de la cadena.
mensaje "Cies comenzó a trabajar en el proyecto KTurtle en 2003 y todavía disfruta haciéndolo"
- preguntar
preguntar X
preguntar
necesita una cadena como parámetro de entrada. Muestra el texto de la cadena en una ventana emergente (igual que hace mensaje) junto a un campo de entrada. Una vez que el usuario ha introducido un número o una cadena, el resultado puede guardarse en una variable o pasarse como un argumento a otra orden. Por ejemplo:
$entrada = preguntar "¿En qué año naciste?"
$salida = 2003 - $entrada
escribir "En 2003 tenías " + salida + " años."
Si el usuario cancela el diálogo de entrada o no introduce ningún valor, la variable queda vacía.