![/!\](/wiki/classic/img/alert.png "/!\"){kind=small}
Este documento es una traducción del que se encuentra en: http://www.squeakland.org/fun_projects/kedama/kedma_getstart.htm
This document is a translation from http://www.squeakland.org/fun_projects/kedama/kedma_getstart.htm
Contents
Empezando con Kedama
Kedama está hecho de varias partes. En la parte inferior está el mundo Kedama en sí mismo, el cual aparece como una gran caja negra. Encima de estos está una grilla invisible de cuadrados. Cada cuadrado es llamado un patch (parche), y la grilla entera es controlada por variables parche que puedes programar. Los parches sólo son encontrados en Kedama y pueden ser pensados como de un papel de gráficos con 100 x 100 celdas (10.000 en total). A cada celda puede ser asignado un valor numérico. Moviéndose a través de eso s parches en el mundo Kedama están los rebaños de tortugas, que son grupos de tortugas que actuan en la misma forma. Puedes decidir cuántos diferentes rebaños hay, establecer cuántas tortugas hay en cada rebaño, escoger un color de rebaño, y escribir guiones que todas las tortugas en cada rebaño seguirán. Estas tortugas, moviendose a lo largo del mundo Kedama, pueden también leer el valor de cada parche y responder a él. Finalmente, hay tortugas individuales, o partículas, que comparten en mismo nombre que su rebaño. Por ejemplo, el primer rebaño que creaste será "tortuga1, así que cada tortuga en este rebaño seguirá las instrucciones a la tortuga1. A las tortugas se les da las instrucciones como rebaño, no como tortugas individuales.
Para encontrar Kedama en Squeak: Ve a las Provisiones y arrastra el catálogo de objetos. Deberías ver un botón etiquetado "Kedama".
Continua y haz click sobre el botón Kedama para revelar una pequeña imagen a escala del mundo Kedama. Cerca a este hay un pequeño icono etiquetado "KedamaWorldBundle". Este botón también puede ser útil y regresaremos a el prontamente.
Arrastra el mundo kedama al mundo etoy, y estás listo para arrancar! Saca un visor del mundo Kedama y encontrarás una nueva categoría llamada "kedama", que contiene los comandos que pueden ser usados dentro del sistema.
Aquellos que están usando comptuadores con resoluciones más altas podrían querer to play with Kedama’s “pixelsPerPatch” command, located in the same menu. Here, you can change the number of pixels in each patch to make the turtles in the Kedama world clearer for you.
jugar con el comando de Kedama “pixelsPerPatch”, localizado en el mismo menú. Acá, puedes cambiar el número de pixels en cada parche para hacer las tortugas en el mundo Kedama más claras para ti.
De los átomos a las tortugas
Vamos a crear un guión simple. Vamos a crear muchas torutas para representar átomos en un sistema y hacerlos mover.
Pasos
- Crear un nuevo rebaño de tortugas.
- Establecer el número de tortugas en ese rebaño.
- Hacer que todas las tortugas se muevan.
Paso 1: Crear un nuevo rebaño de tortugas.
Para crear un nuevo rebaño de tortugas, haz click sobre el icono encontrado en la parte superior del visor y selecciona “add a new breed of turtle” (agregar nuevo rebaño de tortugas).
Espera un momento y obtendrás una caja coloreada en la posición de tu cursor. Esta es la representación de un rebaño de tortugas en el mundo. Sirve como un ejemplar o un modelo, para todas las tortugas que crees de ese rebaño. Un pequeño punto coloreado (una tortuga) también aparecerá en el mundo Kedama. El primer rebaño de tortugas siempre es rojo. Si creas más de un rebaño de tortugas, los siguientes colores son asignados aleatoriamente.
Paso 2: Configurando el número de tortugas. Para obtener el número de tortugas puedes hacer una de dos cosas, dependiendo de lo que quieres que tus tortugas hagan.
- Si quieres que todas las tortugas se comporten de la misma forma y sigan el mismo guión, entonces querrás agregar tortugas del mismo rebaño como el primero. Para mostrar el visor para tu rebaño de tortugas, apunta el cursor sobre el ejemplar, o el cuadrado rojo que representa el rebaño, y deberías ver el familiar halo de manejadores. Abre un visor y escoje la categoría “kedama turtle breed”.
Ves el comando que dice “turtle1’s turtleCount” y el número asignado? 
avanza y cambia aquel número a la cantidad de tortugas que quieras. Ellas deberían aparecer en el mundo Kedama tan pronto como tecleas "Enter" y serán del mismo color que tu primer tortuga. Ten presente que incluso aunque pueden haber muchas tortugas, todas ellas comparten el mismo nombre puesto que ellas son del mismo rebaño - tortuga 1. - Si quieres que las nuevas tortugas se comporten de forma diferente y sigan un guión diferente, querrás agregar un nuevo rebaño de tortuga. Haz esto del mismo modo que agregaste el primer rebaño de tortugasy verás un punto coloreado diferente y un ejemplar aparecer.
Para nuestra simulación, queremos que todas las tortugas se comporten en la misma forma - como átomos - así que usaremos el primer método. Cuando hayas finalizado, deberás ver el mundo Kedama con muchas tortugas rojas en él, todas del mismo rebaño.
Paso 3: Hacer que las tortugas se muevan:
Hagamos que nuestro rebaño de tortugas se mueva. Es muy similar a hacer otros objetos en Squeak moverse, así que probablemente ya eres un experto en esto! Si no está ya abierto, anda y abre un visor para la tortuga y escoje la categoría “kedama turtle”. Deberás ver una lista de comandos familiares incluido el “turtle1 forward by”.
Arrastra este mosaico para obtener un nuevo guión. Entra cuánto quieres que las tortugas se muevan cada vez, pon tu guión a ejecutarse y mira a las tortugas avanzar. Felicitaciones - has usado ahora Kedama para hacer una simulación atómica.
Atomos que rebotan
¿Viste cómo las tortugas que se movian en nuestra recien creada simulación parecían dejar en mundo Kedama y entrar de nuevo por el otro lado? Esto es llamado “wrapping”, (envolvimiento) puesto que las tortugas parecen evolverse alrededor de un eje al eje opuesto. Si quieres que las tortugas reboten de los lados, sin embargo, puedes hacer esto haciendo un cambio en el menú "kedama". Optén el menú "kedama" haciendo click en el mundo Kedama y abriendo un visor, o haciendo click en el mundo quedama en la solapa. Deberías ver diferentes comandos, incluyendo la palabra “EdgeMode”. Hay cuatro de ellos correspondientes a los cuatro vértices, y están actualmente configurados en "wrap" (ajustado, envuelto). Para hacer que los atómos reboten en los vértices, puedes cambiar su estatus a "bouncing" (rebotando).
Ejecuta tu script de nuevo y mira que pasa!
También puedes controlar la velocidad a la cual los átomos se mueven. Ves el ícono del reloj en la parte superior de tu guión?. Si mantienes presionado el mouse sobre él, verás el siguiente menú:
Esto te permite configurar cuantos ticks, o ciclos, ocurren cada segundo. Anda y configura la taza de ciclos a diferentes valores para observar qué pasa.
Diversión con Color
Podemos también adicionar algunos interesantes efectos visuales con color usando los parches en el mundo Kedama. Primero detén tu escript mientras hacemos los cambios. Desde el visor de la tortuga, arrastra el mosaico “patchValueIn” y suéltado en tu guión.
Esto te permite asignar un valor numérico a cada parche. Los números que escojas también influencian los colores de los parches, en la medida en que los números son más grandes, incrementan el brillo del color del parche. Por ejemplo, cambiando el valor del mosaico a 10 pondría un valor pálido en el parche donde la tortuga actualmente reside. Por ahora, cambia el valor del argumento del mosaico a 40. Entonces, presione el pequeño triángulo ascendente a la izquieda de "patchValueIn" para cambiarlo por "patchValueIn patch increase by".
Adelante corre tu guión. Nota que el color en el pequeño rectángulo se hace azul en la medida en que las tortugas dejan detrás un rastro de puntos coloreados.
Si quieres que tus tortugas dejen rastros de diferente color, puedes cambiarlo usando el visor del parche. Para ver el visor para los parches abre el visor Kedama y seleccione el icono próximo a la variable "Kedasma's patch".
Escoge "grab morph", y una pequeña caja que luce como un mundo mini-Kedama aparecerá. Esta es una representación de un parche en el mundo Kedama. Colocala en tu pantalla, además del mundo Kedama. Ahora, haz click en el morph del parche y abre su visor. Deberías ver un menú de categoría "kedama" ya abierto. Entonces, haz click en la caja coloreada en el mosaico “patch’s color” y selecciona el que quieras.
Pausa tu script para unos pequeños cambios más. Los efectos acá serán más fáciles de ver si hay más pocas tortugas, así que cambia el turtleCount a "20". Luego, dile a tus tortugas que se muevan hacia adelante en 2 unidades.
Luego, encuentra el mosaico “scaleMax” en el visor del parche y configura su valor a "200".
Haciendo esto, configuras el límite superior de saturación de color para el parche. Si quieres, puedes cambiar este valor y observar qué pasa al color contra el fondo negro de Kedama.
Finalmente arrastra "patch diffusePatchVariable" y suéltalo en el scriptor (el lugar donde se crean los guiones/scripts). Esto adicionará el efecto visual de los rastros de las tortugas difundiéndose o exparciéndose, detrás de ellas.
Está casi listo para partir. Para preparar el mundo para tu nuevo guión, presiona la marca de exclamación amarrilla a la izquierda de "patch clear" para borrar los rastros de puntos azules de los parches en el mundo Kedama.
Ejecuta tu guión! Verá a las tortugas dejando un "humo" en la medida en que se mueven.
Las fases en un scriptor serán ejecutadas en una manera que peude ser llamada "sincronización line-wise". Esto significa que una línea será ejecutada después de que todo lo relacionado con la línea anterior se halla completado. Por ejemplo, en éste guión, "patch diffusePatchVariable" es ejecutado después de qe cada tortuta en el rebaño tortuga 1 ha compeltado la acción "patchValueIn:". Usando esta idea, puedes cambiar cómo los rasgos de las tortugas aparecen cambiando donde pones el “diffusePatch Variable” en el guión. Mira cuidadosamente -- puedes ver la diferencia?
Una cosa más: recuerdas la miniatura etiquetada “KedamaWorldBundle”?. Si fueras a arrastras ese icono en el mundo etoy, lo que verías sería esos tres componentes ya atados juntos, listos para que lo uses: un mundo Kedama, un morph parche, y un rebaño de tortugas.