La librería shape es una de las más poderosas y extensas de Kara Effector. Proporciona un control total sobre las figuras vectoriales de ASS (\p1, \p<num>). Con estas funciones, puedes crear figuras desde cero, manipular sus puntos, transformarlas geométricamente, animarlas a lo largo de trayectorias complejas, convertirlas en píxeles y mucho más. Es la base para todos los efectos visuales que van más allá de la manipulación de texto simple.
Normaliza y limpia una cadena de texto de un shape. Convierte \clip rectangulares a su equivalente en shape, elimina espacios adicionales, redondea coordenadas y convierte segmentos de línea o curva largos en múltiples segmentos más cortos para asegurar la compatibilidad. Es una función de pre-procesamiento fundamental.
Redondea todas las coordenadas numéricas dentro de un shape a un número específico de decimales.
No devuelve un valor directamente, sino que calcula y almacena en variables globales temporales las propiedades geométricas de un shape. Estas variables son cruciales para ser usadas en otras funciones, especialmente en filtros.
Variables que establece:
minx, maxx, miny, maxy: Coordenadas de la caja contenedora (bounding box).
w_shape, h_shape: Ancho y alto del shape.
c_shape, m_shape: Coordenadas del centro del shape.
n_points: Número total de puntos en el shape.
Se llama internamente antes de funciones como shape.filter para que las variables estén disponibles.
Calcula la longitud total del perímetro de un shape, incluyendo sus segmentos curvos.
Calculan el ancho (width) o alto (height) de la caja contenedora del shape. shape.height es simplemente un atajo para llamar a shape.width con el segundo argumento.
Crea un shape de línea recta.
Genera un shape de círculo a partir de los tres primeros puntos de un shape o clip rectangular. Calcula el círculo que pasa por esos tres puntos (circuncentro).
Extrae el trazado vectorial de un \iclip de la línea de karaoke actual y lo convierte en una nueva línea de diálogo completamente dibujable (con \an7\pos(0,0)\p1). Es útil para visualizar o manipular directamente la trayectoria de un clip.
Similar a from_clip, pero en lugar de generar una línea nueva, devuelve únicamente el código de el shape extraído del \iclip de la línea actual. Si no se encuentra un \iclip, devuelve un shape rectangular del tamaño del objeto karaoke.
puntos=shape.intersect(shape.rectangle, "m -10 50 l 110 50")
-- 'puntos' contendrá {{0, 50}, {100, 50}}
Permite obtener las coordenadas de puntos a lo largo de la trayectoria de un shape, un punto por cada iteración del bucle (j). La función establece automáticamente maxloop al número total de puntos generados.
Devuelve una tabla {x=..., y=...} con las coordenadas del punto j en la trayectoria.
Es la función principal para mover (desplazar) un shape. Puede mover la figura a coordenadas absolutas o de forma relativa a su centro, origen o primer/último punto.
Escala un shape basándose en un factor de proporción. A diferencia de shape.size, no define un tamaño final en píxeles, sino que multiplica sus dimensiones actuales por el factor dado.
-- Mueve un círculo para que su segundo punto de control quede en la posición (0,0).
returnshape.pointpos(shape.circle, 2, {0, 0})
Cuando se aplica a un shape compuesto, esta función activa un bucle (loop) y devuelve la posición (\pos(...)) y el shape de cada sub-figura individual en cada iteración (j).
-- 'mis_estrellas' es una shape compuesta de 5 estrellas. Esto creará 5 líneas,
-- cada una con una estrella en su posición correcta.
returnshape.pos(mis_estrellas)
Aplica una o más matrices de transformación 3x3 a cada punto de un shape. Es la herramienta de transformación más avanzada, permitiendo cualquier combinación de rotación, escala, desplazamiento y cizallado en una sola operación.
Redibuja un shape convirtiendo sus segmentos en una serie de líneas rectas más pequeñas de una longitud aproximada. Es fundamental para aplicar efectos que necesitan una mayor densidad de vértices.
Una de las funciones más potentes. Aplica una o más funciones de filtro a cada punto de un shape. La función de filtro recibe las coordenadas (x, y) del punto y debe devolver las nuevas coordenadas. Dentro del filtro, se tienen acceso a variables especiales como Dc (distancia al centro), Ac (ángulo desde el centro), Mp (progreso a lo largo del shape), etc.
Convierte todos los segmentos de curva Bézier (b) de un shape en segmentos de línea (l). Es un atajo para shape.redraw con la sección "bezier".
Convierte todos los segmentos de línea (l) de un shape en segmentos de curva Bézier (b).
Invierte el orden de los puntos de un shape, cambiando la dirección en la que fue dibujada.
Optimiza un shape eliminando puntos colineales redundantes. Por ejemplo, si un punto se encuentra exactamente en la línea recta formada por sus dos puntos vecinos, es eliminado.
Crea el contorno (borde) de un shape, generando un nuevo shape que representa el borde con un grosor determinado. Utiliza la librería Yutils.
Crea un borde para un shape generando dos figuras: el shape original escalada a un tamaño (Size) y una versión invertida y más pequeña en su interior, simulando un borde con grosor (Bord).
Elimina (retira) uno o más segmentos de un shape. Un segmento es cada comando de dibujo (m, l o b) y sus coordenadas correspondientes.
Elimina figuras completas (cada figura empieza con m) de un shape compuesta.
Función de utilidad avanzada que prepara dos shapes para poder ser interpolados correctamente, incluso si tienen un número diferente de figuras o segmentos de curva. Añade puntos y segmentos “dummy” al shape más simple para que ambas tengan una estructura compatible.
Devuelve dos nuevas (shapes: Shape1_modificada, Shape2_modificada) listas para ser usadas en funciones como table.ipol.
Devuelve una tabla que contiene las coordenadas de todos los puntos que componen un shape. Es fundamental para analizar una figura o aplicar efectos a sus vértices.
Devuelve una tabla de tablas, donde cada sub-tabla es un punto: {{x=..., y=...}, {x=..., y=...}, ...}.
Corta o divide un shape en un punto específico a lo largo de su trayectoria.
Deforma Shape1 para que siga la trayectoria de Shape2. Es conceptualmente similar a text.do_shape, pero opera entre dos shapes.
Estas funciones están diseñadas para crear movimiento a lo largo de caminos definidos por shapes o funciones paramétricas, y para generar shapes complejas que sirvan como trayectorias.
Lineal Move. Genera un movimiento complejo a lo largo de una serie de puntos, creando una trayectoria con segmentos rectos. La función devuelve un conjunto de tags de posicionamiento (\fscx, \fscy) y \t para animar un objeto a lo largo de esa trayectoria.
Parametric Move. Similar a lmove, pero la trayectoria se define mediante funciones paramétricas en lugar de puntos fijos. Esto permite crear movimientos curvos y complejos (círculos, espirales, sinusoides, etc.).
Shape Move. Genera un movimiento que sigue exactamente el contorno de una shape dada.
Random Move. Genera un movimiento aleatorio tipo shake o vibración.
Una variante de rmove que genera un movimiento aleatorio con pausas también aleatorias entre los shakes.
Aplica rmove en múltiples segmentos de tiempo definidos en una tabla.
Genera un movimiento aleatorio con un “doble shake”, superponiendo una vibración secundaria sobre el movimiento principal.
Oscillating Move. Genera un movimiento oscilante entre una serie de puntos.
Simula un “salto de escena”, moviendo un objeto instantáneamente a diferentes posiciones definidas por los puntos de un shape extraído de un \iclip en la línea actual. Crea una serie de líneas de efecto, cada una con una posición diferente.
Estas funciones no mueven un objeto, sino que devuelven un shape que puede usarse como trayectoria para otras funciones (como shape.smove o text.do_shape).
Rellena un área rectangular con un patrón de diagonales.
Crea figuras concéntricas a partir de un shape base, similar a multi1, pero para cualquier figura.
Crea un polígono regular (Loop1 lados) y luego crea un arreglo de (Loop2) polígonos más pequeños dentro de cada lado, repitiendo el proceso (n) veces hacia el centro. Genera patrones tipo “mandala” o geométricos complejos.
Crea un arreglo matricial (cuadrícula) rellenando un área rectangular con una o más shapes.
Crea el perímetro de un cuadrado dividido en rectángulos individuales.
Crea un círculo o un anillo circular compuesto por segmentos individuales.
Crea una serie de shapes concéntricos interpolando su tamaño desde un valor inicial a uno final.
Repite un shape varias veces en una sola línea de efecto, aplicando un conjunto de etiquetas diferente a cada repetición. Es extremadamente útil para crear “trails” (estelas) o conjuntos de objetos con propiedades distintas.
Una función general para crear arreglos de shapes. Puede generar arreglos lineales, radiales, rectangulares o a lo largo de otro shape.
Genera un espectrograma (la forma de onda) de un archivo de audio .wav y lo devuelve como un shape. Crea una serie de líneas de efecto, cada una representando un pequeño segmento de tiempo del audio.
Fusiona una tabla de shapes individuales en un solo shape compuesto, ajustando sus posiciones para que no se superpongan y aplicando opcionalmente etiquetas a cada uno.
Estas funciones operan a un nivel más fundamental, ya sea convirtiendo shapes en sus representaciones de píxeles o realizando manipulaciones de bajo nivel sobre su estructura.
Convierte el relleno de un shape en una serie de píxeles individuales, cada uno como un objeto en un bucle (loop).
Similar a to_pixels, pero en lugar del relleno, convierte el borde del shape en píxeles.
Crea una animación de “morphing” (metamorfosis) entre dos shapes. Devuelve una tabla de shapes que representan los pasos intermedios de la transformación.
Recorta un shape usando una o más líneas de corte. Devuelve una tabla con los shapes resultantes de la división.
Grid Rectangle. Genera un shape de píxeles que representa un rectángulo. A diferencia de shape.grid, no se basa en una shape de entrada, sino que crea un rectángulo desde cero. Es ideal para crear fondos pixelados o efectos de matriz.
Un efecto avanzado que aplica diferentes conjuntos de etiquetas (Set_tagfx) a los objetos que se encuentren dentro de diferentes áreas de recorte (Set_clips). La función genera automáticamente el bucle y las líneas de efecto necesarias.
Crea una animación “frame a frame” ciclando a través de una tabla de shapes.
Toma un shape compuesto (con múltiples comandos m) y lo divide en una tabla de shapes individuales.
Aplica una deformación de onda sinusoidal a los puntos de un shape.
Aplica una deformación aleatoria a los puntos internos de un shape compuesto, creando un efecto de “ruido”, irregularidad o distorsión. No afecta a los puntos del contorno exterior.
Aplica una o más funciones de filtro a cada sub-figura (cada m ...) de un shape compuesto. A diferencia de shape.filter que opera en puntos, esta función opera sobre shapes enteros, permitiendo modificar cada parte de forma individual dentro de un bucle.
