# Usar &kturtle;

Aquesta és una captura de pantalla de &kturtle; en acció.
Finestra principal de &kturtle;

La finestra principal de &kturtle; té tres parts principals: L'editor (1) a l'esquerra d'on escriviu les ordres de &turtlescript;, el llenç (2) a la dreta on la tortuga fa el seu dibuix, i l'inspector (3) que us dóna informació quan executeu el programa. A més d'aquests es troba la barra de menús (5) des d'on es poden abastar totes les accions, la barra d'eines (4) que us permet seleccionar ràpidament les accions més utilitzades, la consola, que podeu utilitzar per introduir una ordre per provar-la, i la barra d'estat (a la part inferior de la finestra) on trobareu informació sobre l'estat de &kturtle;.

## L'editor

En l'editor escriureu les ordres de &turtlescript;. La majoria de les funcions de l'editor es poden trobar en els menús Fitxer i Edita. L'editor es pot ancorar sobre cada vora de la finestra principal o que es pot desancorar i posar a qualsevol lloc de l'escriptori.

Teniu diverses maneres d'obtenir algun codi en l'editor. La manera més senzilla és utilitzar un exemple: Seleccioneu Fitxer Exemples en el menú i seleccioneu un exemple. El fitxer d'exemple que trieu s'obrirà a l'editor, a continuació, podeu utilitzar Executa Executa o des de la barra de menús o el botó Executa des de la barra d'eines per executar el codi si així ho desitgeu.

Podeu obrir fitxers de &turtlescript; escollint Fitxer Obre....

La tercera manera és escriure directament el vostre propi codi en l'editor o fer copia/enganxa sobre algun codi.

## El llenç

El llenç és el domini de la tortuga, la tortuga hi dibuixa d'acord amb les ordres que rep. Després d'aconseguir una mica de codi en l'editor i executar-lo, poden passar dues coses: O bé el codi s'executa bé, i el més probable serà veure com canvia alguna cosa en el llenç; o heu comès un error en el codi, en aquest cas, apareixerà la pestanya d'error explicant l'error que s'ha comès.

Podeu fer «zoom» per apropar i allunyar el llenç amb la roda del ratolí.

## L'inspector

L'inspector us informa sobre les variables, les funcions apreses i mostra l'arbre de codi mentre s'executa el programa.

L'inspector es pot ancorara sobre cada vora de la finestra principal, o es pot desancorar i posar a qualsevol lloc de l'escriptori.

## La barra d'eines

Aquí podreu arribar ràpidament a les accions més utilitzades. La barra d'eines també conté la consola, on podreu invocar ordres ràpidament, això podria ser útil en cas que vulgueu provar una ordre sense modificar el contingut de l'editor.

Podeu configurar la barra d'eines utilitzant Arranjament Configura barres d'eines... per ajustar-la millor a les vostres preferències.

## La barra de menús

A la barra de menús trobareu totes les accions de &kturtle;. Es troben en els següents grups: Fitxer, Edita, Llenç, Executa, Eines, Arranjament i Ajuda. En aquesta secció es descriuen tots.

### El menú Fitxer

&Ctrl;N Fitxer Nou

  Crea un fitxer nou i buit de &turtlescript;.

&Ctrl;O Fitxer Obre...

  Obre un fitxer de &turtlescript;.

Fitxer Obre recent

  Obre un fitxer de &turtlescript; obert recentment.

Fitxer Exemples

  Obre programes &turtlescript; d'exemple. Els exemples estan en el vostre idioma preferit que podeu triar a Arranjament Llenguatge d'script.

Fitxer Aconsegueix més exemples...

  Obre el diàleg Obtén novetats candents per descarregar fitxers &turtlescript; addicionals des d'Internet.

&Ctrl;S Fitxer Desa

  Desa el fitxer &turtlescript; actualment obert.

Fitxer Desa com a...

  Desa el fitxer &turtlescript; actualment obert en un lloc especificat.

Fitxer Exporta com a HTML...

  Exporta el contingut actual de l'editor com un fitxer HTML que inclou colors de ressaltat.

&Ctrl;P Fitxer Imprimeix...

  Imprimeix el codi actual en l'editor.

&Ctrl;Q Fitxer Surt

  Surt de &kturtle;.

### El menú Edita

&Ctrl;Z Edita Desfés

  Desfà l'últim canvi al codi. &kturtle; desfà de manera il·limitada.

&Ctrl; &Maj; Z Edita Refés

  Refà un canvi desfet al codi.

&Ctrl;X Edita Talla

  Talla el text seleccionat a l'editor al porta-retalls.

&Ctrl;C Edita Copia

  Copia el text seleccionat a l'editor al porta-retalls.

&Ctrl;V Edita Enganxa

  Enganxa el text del porta-retalls a l'editor.

&Ctrl;A Edita Selecciona-ho tot

  Selecciona tot el text a l'editor.

&Ctrl;F Edita Cerca...

  Amb aquesta acció podeu trobar frases en el codi.

F3 Edita Cerca següent

  Utilitzeu aquesta opció per cercar la següent ocurrència de la frase cercada.

&Maj;F3 Edita Cerca anterior

  Feu-la servir per trobar l'anterior ocurrència de la frase cercada.

Insert Edita Mode sobreescriure

  Commuta entre els modes «inserir» i «sobreescriure».

### El menú Llenç

Llenç Exporta a imatge (PNG)...

  Exporta el contingut actual del llenç com una imatge del tipus PNG (Portable Network Graphics).

Llenç Exporta a dibuix (SVG)...

  Exporta el contingut actual del llenç com un dibuix vectorial del tipus SVG (Scalable Vector Graphics).

Llenç Imprimeix el llenç...

  Imprimeix el contingut actual del llenç.

### El menú Executa

F5 Executa Executa

  Comença l'execució de les ordres en l'editor.

F6 Executa Pausa

  Atura momentàniament l'execució. Aquesta acció només s'habilita quan les ordres s'estan executant.

F7 Executa Avorta

  Atura l'execució. Aquesta acció només s'habilita quan les ordres s'estan executant.

Executa Velocitat d'execució

  Presenta una llista de les possibles velocitats d'execució, consisteix en: Velocitat màxima (sense ressaltat ni inspector), Velocitat màxima, Lenta, Més lenta, La més lenta i Instrucció a instrucció. Quan la velocitat d'execució s'estableix a Velocitat màxima (per omissió) amb prou feines pot mantenir-se al dia amb el que està succeint. De vegades, aquest comportament es vol, però de vegades volem fer un seguiment de l'execució. En aquest últim cas voldreu establir la velocitat d'execució a Lenta, Més lenta o La més lenta. Quan se selecciona un dels modes lents la posició actual de l'executor es mostrarà a l'editor. Instrucció a instrucció executarà una ordre a la vegada.

### El menú Eines

Eines Selector de direcció...

  Aquesta acció obre el diàleg selector de direcció.

Eines Selector de color...

  Aquesta acció obre el diàleg selector de color.

### El menú Arranjament

Arranjament Llenguatge d'script

  Tria el llenguatge per al codi.

&Ctrl;E Arranjament Mostra l'editor

  Mostra o oculta l'editor.

&Ctrl;I Arranjament Mostra l'inspector

  Mostra o oculta l'inspector.

Arranjament Mostra els errors

  Mostra o oculta la pestanya Error amb una llista dels errors resultants de l'execució del codi. Si aquesta opció està habilitada, feu clic al Llenç per veure la tortuga altra vegada.

F11 Arranjament Mostra els números de les línies

  Amb aquesta acció podeu mostrar els números de línia en l'editor. Això pot ser útil per trobar errors.

Arranjament Mostra barra d'eines

  Mostra o oculta la barra d'eines principal.

Arranjament Mostra la barra d'estat

  Mostra o oculta la barra d'estat.

Arranjament Configura dreceres...

  El diàleg estàndard de &kde; per a configurar les dreceres.

Arranjament Configura barres d'eines...

  El diàleg estàndard del &kde; per a configurar les barres d'eines.

### El menú Ajuda

&help.menu.documentation;

F2 Ajuda Ajuda sobre: ...

  Aquesta és una funció molt útil: Ofereix ajuda sobre el codi a la posició del cursor a l'editor. Així, &pex;, heu utilitzat l'ordre `print` (`imprimeix`) en el vostre codi, i voleu llegir i saber el que diu el manual sobre aquesta ordre. Només cal moure el cursor sobre dita ordre i prémer la tecla F2. El manual mostrarà tota la informació sobre l'ordre `print` (`imprimeix`).

  Aquesta funció pot ser útil mentre s'aprèn &turtlescript;.

## La barra d'estat

A la barra d'estat obtindreu informació sobre l'estat de &kturtle;. Al costat esquerre es mostra informació sobre l'última acció. A la part dreta trobareu la ubicació actual del cursor (nombres de línia i columna). Enmig de la barra d'estat s'indica el llenguatge actualment utilitzat per a les ordres.