¶ El sistema de bucles en KE
¶ Para qué sirve:
- Crear múltiples objetos: Permite generar automáticamente un gran número de líneas de efecto a partir de una sola. Es la base para crear efectos de partículas, rejillas (grids), arreglos y cualquier animación que requiera múltiples elementos en pantalla.
- Animaciones complejas y coordinadas: Al dar a cada objeto generado un índice único, se pueden crear animaciones donde cada elemento se comporta de manera ligeramente diferente (en posición, tiempo, color, etc.), pero de forma sincronizada.
- Distribuir efectos: Facilita la distribución de objetos en el espacio (por ejemplo, en una rejilla rectangular o en capas) o en el tiempo (en una secuencia progresiva), automatizando los cálculos de posición y retardo.
El sistema se basa en dos funciones principales que se escriben en la casilla variable: maxloop() para el bucle principal y replay() para repetir conjuntos de bucles. Dichas variables se llaman desde la casilla loop en la interfaz.
¶ Primero lo importante: Las Casillas loop y variable
loop y variableEn la ventana de configuración de efectos (la que aparece al presionar "Modify"), verás dos casillas para controlar los bucles: loop y variable. Es vital entender la diferencia para sacar el máximo provecho del sistema.
- La casilla
loopes un atajo fácil para usar la funciónmaxloop(). Es perfecta para crear rejillas o secuencias simples. - La casilla
variablete da el control total. Aquí puedes escribirmaxloop(),replay()y cualquier otra variable o código Lua que necesites.
¶ ¿Cómo se traduce la casilla loop?
loop?Lo que escribes en la casilla loop se convierte directamente en los argumentos para maxloop(v, h, d).
-
Si en
loopescribes:10- El script ejecuta:
maxloop(10, 1, 1) - Variables disponibles:
jirá de 1 a 10 (maxjserá 10).fx.loop_vserá 10.
- El script ejecuta:
-
Si en
loopescribes:4, 5- El script ejecuta:
maxloop(4, 5, 1) - Variables disponibles:
jirá de 1 a 20 (maxjserá 20).fx.loop_vserá 4 yfx.loop_hserá 5.
- El script ejecuta:
-
Si en
loopescribes:2, 3, 4- El script ejecuta:
maxloop(2, 3, 4) - Variables disponibles:
jirá de 1 a 24 (maxjserá 24).fx.loop_vserá 2,fx.loop_hserá 3, yfx.loop_3será 4.
- El script ejecuta:
¶ ¿Cómo se usa la casilla variable?
variable?Cuando necesitas usar replay(), definir variables personalizadas, o tener un control más granular, debes escribir el código completo en la casilla variable. Lo que escribas aquí tiene prioridad sobre lo que haya en la casilla loop.
¶ Sintaxis Importante:
- Para separar cualquier función o asignación de variable, usa un punto y coma (
;). Esta es la única regla que necesitas recordar. Se aplica para separarreplay()demaxloop(),maxloop()de una variable, o dos variables entre sí.
¶ Ejemplos de la casilla variable:
variable:-
Combinando
replayymaxloop:replay(3); maxloop(10);- Importante: Observa el punto y coma
;que separa las dos funciones. Esta es la sintaxis estándar para separar cualquier instrucción en la casillavariable. - Resultado: El bucle
maxloopde 10 iteraciones se repetirá 3 veces. Tendrás acceso a las variablesj,maxj,JymaxJ.
- Importante: Observa el punto y coma
-
Definiendo una variable personalizada:
maxloop(20); mi_variable = 50 * ratio; mi_color = color.random()- Importante: Observa cómo el punto y coma
;separa cada instrucción.maxloop(20)se separa de la definición demi_variable, y esta a su vez se separa demi_color. - Resultado:
jirá de 1 a 20. Además, tendrás las variablesmi_variableymi_colordisponibles en las otras casillas para usarlas en tus cálculos.
- Importante: Observa cómo el punto y coma
-
Combinando todo:
replay(4); maxloop(5); delay_particula = 30; velocidad = 1.5- Resultado: Tendrás disponibles
J(1-4),j(1-5 en cada repetición), y las variables personalizadasdelay_particulayvelocidad.
- Resultado: Tendrás disponibles
¶ Bucle Principal
¶ maxloop( v, h, d )
maxloop( v, h, d )-
Descripción: Es la función fundamental para crear bucles. Genera un número determinado de líneas de diálogo (que se convierten en los objetos del efecto), y proporciona variables para controlar las propiedades de cada una de ellas.
-
Argumentos:
v(número, opcional): El número de iteraciones verticales del bucle. Por defecto es1.h(número, opcional): El número de iteraciones horizontales del bucle. Por defecto es1.d(número, opcional): El número de iteraciones en una tercera dimensión (profundidad). Por defecto es1.
-
Variables que Crea: Al usar
maxloop, estas variables quedan disponibles en todas las demás casillas del efecto:j: El contador principal de la iteración. Su valor va desde 1 hastamaxj. Esta es la variable más importante y la que más usarás.maxj: El número total de iteraciones. Se calcula comov * h * d.fx.loop_v: Almacena el valor que se le dio av.fx.loop_h: Almacena el valor que se le dio ah.fx.loop_3: Almacena el valor que se le dio ad.
-
Ejemplo de Uso Básico (Línea de objetos):
-- En la casilla "variable": maxloop(10) -- En la casilla "pos_x": -- Coloca 10 objetos en una línea horizontal, cada uno separado por 50 píxeles. l.left + (j - 1) * 50 -
Ejemplo Avanzado (Rejilla de 4x5):
Para crear una rejilla (grid), se combinanfx.loop_vyfx.loop_hcon operaciones matemáticas. El operador módulo (%) nos da la columna, mientras que la división entera (math.floor) nos da la fila.-- En la casilla "variable": maxloop(4, 5) -- 4 filas, 5 columnas -- En la casilla "pos_x": -- (j-1) % 5 dará como resultado 0,1,2,3,4, 0,1,2,3,4... l.left + ((j - 1) % fx.loop_h) * (l.width / fx.loop_h) -- En la casilla "pos_y": -- math.floor((j-1)/5) dará como resultado 0,0,0,0,0, 1,1,1,1,1... l.top + math.floor((j - 1) / fx.loop_h) * (l.height / fx.loop_h)
¶ Bucle de Repetición
¶ replay( n )
replay( n )-
Descripción: Es un bucle "externo" que ejecuta el
maxloopcompleto un númeronde veces. Es ideal para crear capas de efectos o "tandas" de partículas. El contadorjdelmaxloopse reinicia en cada repetición dereplay. -
Argumentos:
n(número): El número de veces que se repetirá elmaxloop.
-
Variables que Crea:
J: El contador del bucle de repetición. Su valor va desde 1 hastamaxJ.maxJ: El número total de repeticiones, que es igual an.
-
Ejemplo de Uso (Ondas de partículas):
Imagina que quieres que 3 "ondas" de 5 partículas cada una aparezcan secuencialmente.-- En la casilla "variable": replay(3); maxloop(5) -- En la casilla "start_t": -- J controla el tiempo de inicio de cada ONDA. -- j controla el retardo de cada partícula DENTRO de la onda. l.start_time + (J - 1) * 500 + (j - 1) * 40 -- En la casilla "pos_x": -- j controla la posición de cada partícula. l.left + (j - 1) * 100 -- En la casilla "pos_y": -- J controla la altura de cada onda de partículas. l.top + (J - 1) * 50Esto creará 15 líneas en total. Las primeras 5 aparecerán a los
0ms,40ms,80ms... en la altural.top. Las siguientes 5 aparecerán a los500ms,540ms... en la altural.top + 50, y así sucesivamente.
¶ Combinando Bucles y Funciones de Tiempo
La verdadera potencia del sistema de bucles se libera al combinarlo con las funciones de tiempo del capítulo anterior. Las funciones time_loop1 y time_loop2 están diseñadas específicamente para esto.
¶ time_loop1 con maxloop
time_loop1 con maxloop-
Descripción: Genera patrones de tiempo para objetos creados en un bucle simple (
maxloop). Depende de las variablesjymaxjpara calcular los retardos. -
Argumentos:
Mode(string): El patrón de tiempo a usar. Acepta"li"(lineal de inicio a fin),"lo"(lineal de fin a inicio),"mid1"(extremos hacia el centro),"mid2"(centro hacia los extremos).Delay(number, opcional): Milisegundos de retardo entre cada iteración. Por defecto es30.
-
Ejemplo de Uso (Patrón Secuencial Simple):
Crearemos una fila de 10 partículas que aparecen una tras otra.-- En la casilla "variable": maxloop(10) -- En la casilla "start_t": -- time_loop1() calcula automáticamente el retardo para cada partícula. l.start_time + time_loop1("li", 50) -- En la casilla "end_t": l.start_time + time_loop1("li", 50) + 400 -- Cada partícula dura 400ms. -- En la casilla "pos_x": l.left + (j-1) * (l.width/9)En este caso,
time_loop1("li", 50)genera un retardo que aumenta en 50ms para cada valor dej. El resultado es que las 10 partículas aparecen en secuencia de izquierda a derecha.
¶ time_loop2 con replay
time_loop2 con replay-
Descripción: Idéntica a la anterior, pero diseñada para bucles anidados o secundarios (
replay). Depende de las variablesJymaxJ. -
Argumentos:
Mode(string): El patrón de tiempo a usar. Acepta"li","lo","mid1","mid2".Delay(number, opcional): Milisegundos de retardo entre cada iteración. Por defecto es30.
- Ejemplo de Uso: Dentro de un
replay, se puede usartime_loop2("li", 500)para que cada "tanda" de efectos (controlada porJ) aparezca 500ms después de la anterior.
-
Ejemplo de Uso (Capas de efectos secuenciales):
Crearemos 3 capas de partículas. Cada capa (J) aparece después de la anterior. Dentro de cada capa, las partículas (j) aparecen desde el centro hacia los extremos.-- En la casilla "variable": replay(3); maxloop(10) -- En la casilla "start_t": -- J controla el tiempo de inicio de cada CAPA. -- j controla el tiempo de cada partícula DENTRO de la capa. l.start_time + time_loop2("li", 500) - time_loop1("mid2", 30) -- Retardo de 500ms entre cada capa (J) y patrón "abrir cortinas" para las partículas (j) -- En la casilla "end_t": l.start_time + time_loop2("li", 500) - time_loop1("mid2", 30) + 400 -- En las casillas pos_x y pos_y (para completar el efecto): -- pos_x: l.left + (j-1)*(l.width/9) -- pos_y: l.top + (J-1)*50