En esta guía vamos a ver un recorrido por todas las librerías del Kara Effector, explicando sus funciones y recursos. Usaremos ejemplos prácticos y algo de lenguaje técnico, pero no mucho. El objetivo es tener a la mano información complementaria que abarque aquello que el manual oficial de KE no cubrió. También la idea es que este material esté disponible de forma online. Comencemos.
La biblioteca Effector-utils-lib-3.6.lua es el corazón funcional (por funciones) del Kara Effector. Es una colección masiva de funciones de utilidad diseñadas para simplificar y potenciar la creación de efectos de karaoke y edición de video en Aegisub. Incorpora y amplía funcionalidades de bibliotecas anteriores y de la potente Yutils, proporcionando al creador de efectos un arsenal de herramientas para la manipulación de tiempo, tablas, texto, colores, formas vectoriales y mucho más.
Sus modulos son:
timeLa manipulación del tiempo es fundamental en el karaoke. Esta biblioteca ofrece un conjunto completo de herramientas para convertir, calcular y generar patrones de tiempo, sirviendo como puente entre los milisegundos, los timestamps de ASS y los fotogramas de video.
tableLua se basa en tablas, y esta biblioteca sobrecarga sus capacidades nativas con docenas de funciones de alto nivel. Permite inspeccionar, transformar, comparar, filtrar y generar tablas complejas, que son la base para almacenar y manipular casi toda la información dentro del Effector.
stringAmplía las funciones de manejo de texto de Lua, ofreciendo herramientas más avanzadas y específicas para las necesidades del typesetting y la creación de efectos.
mathEsta es una de las bibliotecas más extensas, proporcionando herramientas matemáticas que van desde la generación de números aleatorios hasta la geometría vectorial y las transformaciones matriciales. Es esencial para cualquier efecto que involucre movimiento, posicionamiento y formas complejas.
tagEste es el módulo final de salida para la mayoría de los efectos. Contiene funciones especializadas en la creación, manipulación y formateo de los override tags de ASS, que son los que finalmente definen el aspecto y la animación del karaoke.
color y alphaEstos dos módulos se especializan en el manejo de colores y transparencias. Proporcionan herramientas para convertir entre diferentes formatos (ASS, RGB, HSV), generar valores aleatorios e interpolar suavemente entre un color/alfa y otro.
shapeEsta es una de las bibliotecas más potentes, dedicada por completo a la creación y manipulación de gráficos vectoriales (comandos de dibujo de ASS). Es la base para efectos de partículas, tipografías personalizadas, morphing y animaciones de formas complejas.
graph e imageEstos módulos se enfocan en la generación de gráficos. graph crea formas geométricas primitivas como polígonos, engranajes o banners. image se encarga de procesar imágenes de mapa de bits (principalmente .bmp) para extraer su información de color y alfa, permitiendo recrear una imagen usando píxeles de ASS.
aegisubEste módulo contiene funciones de conveniencia que interactúan directamente con las estructuras de datos de Aegisub y la biblioteca karaskel. Su principal propósito es analizar las líneas de diálogo y extraer información detallada sobre sus palabras, sílabas y caracteres.
fileOfrece un conjunto de herramientas para interactuar con archivos externos. Permite leer, modificar y extraer información de archivos de texto, lo que puede usarse para cargar configuraciones o datos para efectos complejos.
effectorEsta es la biblioteca "meta" que gestiona el propio funcionamiento del Kara Effector. Contiene las funciones que construyen la interfaz de usuario, procesan las selecciones del usuario, aplican los efectos a las líneas de subtítulos y guardan las configuraciones.
textEsta librería es el puente entre el texto de los subtítulos y los efectos gráficos avanzados. Su poder reside en su capacidad para tratar las cadenas de texto no como simples caracteres, sino como objetos visuales complejos. Proporciona herramientas para convertir texto en figuras vectoriales (shapes) totalmente manipulables, descomponerlo en sus unidades fonéticas o estructurales, y aplicar animaciones y estilos a nivel de caracter individual. Es una de las librerías más utilizadas y fundamentales para la creación de efectos visuales creativos.