Efectos Combinados for YMM4 — Manual de Usuario

Versión: 2.2.0 / SO compatible: Windows 10 / 11 (64bit) / Runtime: .NET 10.0

1. Descripción general

«Efectos Combinados» es un complemento de efectos de vídeo para YukkuriMovieMaker4 (YMM4). Permite almacenar múltiples efectos de vídeo en un solo elemento «Efectos Combinados» y gestionarlos mediante agrupación, guardado de ajustes preestablecidos y recuperación.

Características principales:

Aplicar varios efectos en secuencia dentro de un único elemento
Guardar, recuperar y compartir ajustes preestablecidos con nombre
Gestionar múltiples configuraciones de efectos con pestañas y cambiarlas al instante (admite agregar, eliminar y renombrar)
Organizar ajustes con tres tipos de grupos virtuales: Todo, Reciente y Favoritos
Historial de instantáneas y gestión de ramas al estilo Git
Escritura atómica con verificación CRC32 y persistencia multirredundante SHA-256
Exportar e importar archivos de paquete de ajustes preestablecidos (.ceprstpkg)
Copiar, cortar y pegar mediante el portapapeles
Búsqueda multieje con soporte de expresiones regulares
Interfaz en 8 idiomas (japonés, inglés, chino simplificado, chino tradicional, coreano, español, árabe, indonesio)
Interfaz responsiva que cambia automáticamente al diseño móvil por debajo de 400px de ancho

La etiqueta de la línea de tiempo muestra el recuento de efectos actual y el nombre del ajuste aplicado, p. ej. «Efectos Combinados Activo: 3 [NombreAjuste]», lo que facilita identificar el contenido de un vistazo.

La salida de AviUtl (.exo) no es compatible.

2. Requisitos del sistema

Elemento	Requisito
SO	Windows 10 / 11 (64bit)
YukkuriMovieMaker4	Se recomienda la versión más reciente
Runtime	.NET 10.0
GPU	GPU compatible con Direct2D

3. Instalación

Descargue el archivo .ymme más reciente desde la página Releases en GitHub.
Asegúrese de que YMM4 no esté en ejecución.
Haga doble clic en el archivo .ymme descargado para instalarlo.
Inicie YMM4 y seleccione un elemento en la línea de tiempo.
Seleccione «Efectos Combinados» en el menú Agregar efecto de vídeo.

Tras la instalación, el panel de gestión de ajustes preestablecidos y la lista de efectos aparecerán en el panel de propiedades.

4. Primeros pasos

Seleccione un elemento de vídeo o imagen en la línea de tiempo.
Agregue «Efectos Combinados» desde el menú Agregar efecto de vídeo.
Agregue y configure efectos en la sección «Efectos Activos» en la parte inferior del panel de propiedades.
Haga clic en el botón «+ (Agregar)» en el panel de gestión de ajustes, introduzca un nombre y guarde el ajuste.
Para aplicar la misma configuración a otro elemento, seleccione el ajuste y haga clic en el botón «✓ (Aplicar)».

5. Disposición de la interfaz

El panel de propiedades muestra las siguientes secciones de arriba abajo.

5-1. Panel de gestión de ajustes preestablecidos (PresetManagerControl)

Es el área principal de gestión de ajustes, dividida en dos columnas.

Área	Descripción
Columna izquierda (lista de grupos)	Muestra los grupos definidos por el usuario y los grupos virtuales (Todo, Reciente, Favoritos). Haga clic para seleccionar, doble clic para cambiar el nombre, arrastre y suelte para reordenar (los grupos virtuales no se pueden mover). Use el botón + para agregar grupos y el botón - para eliminarlos.
Parte superior columna derecha (barra de búsqueda)	Filtra los ajustes por palabra clave. Haga clic en el icono de la derecha para cambiar el destino de búsqueda.
Centro columna derecha (lista de ajustes)	Lista los ajustes del grupo seleccionado. Cada fila muestra una estrella (alternar favorito), nombre, recuento de efectos e icono de información (el tooltip muestra la lista de efectos). Se admite selección múltiple (Ctrl+clic, Mayús+clic).
Parte inferior columna derecha (botones de acción)	De izquierda a derecha: Agregar (+), Eliminar (-), Actualizar (↺), Aplicar (✓). Los botones amplían sus etiquetas al pasar el ratón por encima.
Controlador de redimensión inferior	Arrastre para cambiar la altura del panel.

5-2. Divisor de cuadrícula

Arrastre el borde entre las dos columnas para ajustar el ancho de la columna de grupos. El valor se restaura al siguiente inicio.

5-3. Diseño móvil (menos de 400px de ancho)

Cuando el ancho del control cae por debajo de 400px, la lista de grupos se oculta y aparece un botón de menú hamburguesa (≡). Al hacer clic se abre la lista de grupos como una ventana emergente.

5-4. Gestión de pestañas de efectos (EffectTabManagerControl)

Encima de «Efectos Activos» se muestra una barra de pestañas. Cada pestaña guarda una configuración de efectos independiente y, al cambiar de pestaña, se refleja inmediatamente la pestaña seleccionada.

Botón + a la derecha: «Agregar pestaña»
Botón x de cada pestaña: «Eliminar pestaña» (la primera pestaña «Nuevo» no se puede eliminar)
Doble clic en el nombre de la pestaña: renombrar (Enter o cambio de foco para confirmar, Esc para cancelar)
Nombres predeterminados: la primera es «Nuevo», luego «Pestaña 2», «Pestaña 3», ...

5-5. Efectos Activos (VideoEffectSelector)

El selector de efectos estándar de YMM4 muestra los efectos de la pestaña actualmente seleccionada. Las operaciones de agregar, eliminar, reordenar y activar/desactivar se guardan en esa pestaña.

6. Gestión de grupos

Los ajustes preestablecidos se pueden organizar en grupos. Existen «grupos reales» y «grupos virtuales».

6-1. Agregar un grupo

Haga clic en el botón «+» en la parte inferior de la lista de grupos.
Introduzca un nombre de grupo en el cuadro de diálogo y haga clic en «OK».
El nuevo grupo se agrega a la lista y se selecciona automáticamente.

6-2. Eliminar un grupo

Seleccione el grupo que desea eliminar en la lista de grupos.
Haga clic en el botón «-» en la parte inferior de la lista de grupos.
Haga clic en «OK» en el cuadro de confirmación para eliminar el grupo y todos sus ajustes.

Nota: El grupo «Por defecto» y los grupos virtuales (Todo, Reciente, Favoritos) no se pueden eliminar.

6-3. Cambiar el nombre de un grupo

Utilice uno de los siguientes métodos:

Haga doble clic en el grupo para abrir un cuadro de diálogo e introduzca un nuevo nombre.
Haga clic derecho en el grupo y seleccione «Renombrar» en el menú contextual.

Nota: Los grupos virtuales no se pueden renombrar.

6-4. Reordenar grupos

Arrastre y suelte los grupos reales para cambiar su orden. Los grupos virtuales siempre están fijos en la parte superior de la lista y no se pueden mover.

7. Gestión de ajustes preestablecidos

7-1. Agregar un ajuste preestablecido (guardar)

Configure los efectos que desea guardar en «Efectos Activos».
Seleccione el grupo de destino en la lista de grupos (si se selecciona un grupo virtual, se guardará en el primer grupo real).
Haga clic en el botón «+ (Agregar)» en la parte inferior de la columna derecha.
Introduzca un nombre de ajuste en el cuadro de diálogo y haga clic en «OK».
La configuración de efectos actual se guarda como ajuste preestablecido y se agrega a la lista.

7-2. Eliminar un ajuste preestablecido

Seleccione el/los ajuste(s) a eliminar (Ctrl+clic o Mayús+clic para selección múltiple).
Haga clic en el botón «- (Eliminar)» o haga clic derecho y seleccione «Eliminar».
Haga clic en «OK» en el cuadro de confirmación para eliminar.

Al seleccionar varios ajustes y eliminarlos, todos los seleccionados se eliminan a la vez.

7-3. Cambiar el nombre de un ajuste preestablecido

Haga doble clic en el ajuste para abrir un cuadro de diálogo e introduzca un nuevo nombre.
Haga clic derecho y seleccione «Renombrar».

7-4. Vaciar un ajuste preestablecido

Elimina todos los efectos almacenados en un ajuste preestablecido, dejándolo vacío. El ajuste en sí permanece.

Haga clic derecho en el ajuste de destino.
Seleccione «Vaciar Ajuste» en el menú contextual.
Haga clic en «OK» en el cuadro de confirmación.

7-5. Reordenar ajustes preestablecidos

Arrastre y suelte los ajustes dentro de la lista para cambiar su orden. El reordenamiento no está disponible cuando se visualizan grupos virtuales (Todo, Favoritos, Reciente).

8. Grupos virtuales

Los grupos virtuales son grupos especiales que siempre aparecen en la parte superior de la lista de grupos. No se pueden eliminar, renombrar ni reordenar.

Nombre del grupo	Contenido	Orden
Todo	Muestra todos los ajustes de todos los grupos reales.	Alfabético (ascendente)
Reciente	Muestra los últimos 10 ajustes aplicados recientemente.	Más reciente primero
Favoritos	Muestra todos los ajustes marcados con estrella.	Alfabético (ascendente)

Cuando se selecciona un grupo virtual y se agrega o pega un ajuste, este se guarda en el primer grupo real.

9. Aplicar ajustes preestablecidos

9-1. Aplicar un único ajuste preestablecido

Seleccione el ajuste que desea aplicar en la lista.
Haga clic en el botón «✓ (Aplicar)» o haga clic derecho y seleccione «Aplicar».
La configuración de efectos del ajuste se carga en el elemento de la línea de tiempo.

Aplicar el mismo ajuste de nuevo: Si intenta aplicar un ajuste cuyo contenido es idéntico a los efectos actuales, aparece un cuadro de confirmación. Haga clic en «OK» para agregar (apilar) los efectos sobre los existentes. Haga clic en «Cancelar» para cancelar.

9-2. Aplicar varios ajustes preestablecidos a la vez

Seleccione varios ajustes con Ctrl+clic o Mayús+clic.
Haga clic en el botón «✓ (Aplicar)».
Los efectos de todos los ajustes seleccionados se combinan en orden y se aplican.

No se muestra ningún cuadro de confirmación de duplicados para la selección múltiple. Además, cuando se seleccionan 2 o más ajustes, la lista «Reciente» y el JSON del ajuste no se actualizan.

9-3. Actualización de la etiqueta tras la aplicación

Tras aplicar un único ajuste, la etiqueta de la línea de tiempo se actualiza para mostrar «Efectos Combinados Activo: 3 [NombreAjuste]». El nombre del ajuste permanece visible incluso si los efectos se modifican manualmente después.

10. Actualizar ajustes preestablecidos

Sobrescribe el ajuste preestablecido seleccionado con la configuración de efectos actual.

Seleccione el ajuste que desea actualizar en la lista.
Modifique los efectos en «Efectos Activos».
Confirme que el botón «↺ (Actualizar)» está activo (solo se activa cuando hay cambios en los efectos).
Haga clic en «↺ (Actualizar)» o haga clic derecho y seleccione «Actualizar».

Cuándo se activa el botón Actualizar: El botón solo se activa cuando el ajuste seleccionado es el mismo que el último ajuste aplicado y la configuración de efectos actual difiere de lo guardado en el ajuste. Si se cambia un parámetro de efecto, el estado del botón se evalúa automáticamente tras un retardo de 50ms.

11. Búsqueda de ajustes preestablecidos

Introduzca una palabra clave en el cuadro de búsqueda para filtrar los ajustes en tiempo real.

11-1. Cambiar el modo de búsqueda

Haga clic en el icono de filtro al final derecho del cuadro de búsqueda para abrir un menú y cambiar el destino de búsqueda.

Modo de búsqueda	Destino
Nombre del preajuste (predeterminado)	El nombre del ajuste preestablecido
Nombre del efecto	Etiquetas de todos los efectos del ajuste (lista separada por saltos de línea)
Recuento de efectos	Número de efectos en el ajuste. La entrada numérica prioriza la coincidencia exacta; vuelve a la coincidencia parcial si no hay coincidencia exacta.
Datos en bruto (JSON)	JSON sin procesar de la configuración de efectos serializada. Busque por nombre de tipo de efecto o valores de parámetros.
Todo	Muestra los ajustes que coincidan con el nombre, los nombres de efectos o el JSON en bruto

11-2. Búsqueda con expresiones regulares

Se pueden usar expresiones regulares (sin distinción de mayúsculas y minúsculas) en todos los modos de búsqueda.

Ejemplo: ^blur → Busca ajustes cuyo nombre empiece por «blur»
Ejemplo: color|shadow → Busca ajustes cuyo nombre contenga «color» o «shadow»
Ejemplo: [0-9]+ → Busca ajustes cuyo nombre contenga un número

Si se introduce un patrón de expresión regular no válido, la búsqueda vuelve a la coincidencia parcial de cadenas sin distinción de mayúsculas y minúsculas.

12. Favoritos

Marque los ajustes de uso frecuente como favoritos para acceder a ellos rápidamente desde el grupo virtual «Favoritos».

12-1. Marcar/desmarcar favoritos

Haga clic en el botón de estrella al inicio de cada fila en la lista de ajustes.

Una estrella amarilla (dorada) indica que el ajuste está marcado como favorito.
Una estrella gris indica que no es un favorito.

Los cambios se guardan en el archivo de ajustes de forma inmediata.

12-2. Ver el grupo Favoritos

Seleccione «Favoritos» en la lista de grupos para mostrar todos los ajustes con estrella en orden alfabético. Si desmarca un ajuste mientras visualiza el grupo Favoritos, desaparece de la lista de inmediato.

13. Copiar, cortar y pegar

Use el portapapeles para copiar, cortar y pegar ajustes preestablecidos. Los datos se escriben en el portapapeles en el mismo formato JSON que los paquetes de ajustes, por lo que también puede inspeccionarlos y editarlos en un editor de texto.

13-1. Copiar

Seleccione el/los ajuste(s) a copiar (se admite selección múltiple).
Haga clic derecho y seleccione «Copiar».

Los ajustes originales permanecen sin cambios.

13-2. Cortar

Seleccione el/los ajuste(s) a mover (se admite selección múltiple).
Haga clic derecho y seleccione «Cortar».

Los ajustes se copian al portapapeles y los originales se eliminan simultáneamente. No se muestra ningún cuadro de confirmación.

13-3. Pegar

Seleccione el grupo de destino en la lista de grupos.
Haga clic derecho en un área en blanco de la lista de ajustes o en cualquier ajuste y seleccione «Pegar».

Solo está disponible cuando el portapapeles contiene JSON de paquete de ajustes válido. A los ajustes pegados se les asignan nuevos GUID (diferentes de los ID originales). Si se selecciona un grupo virtual, los ajustes se agregan al primer grupo real.

13-4. Formato de datos del portapapeles

Los datos escritos en el portapapeles usan el siguiente formato JSON:

{
  "FormatId": "CombinedEffect.PresetExchange",
  "Version": 1,
  "ExportedAtUtc": "2025-01-01T00:00:00+00:00",
  "Presets": [
    {
      "Id": "...",
      "Name": "Nombre del ajuste",
      "IsFavorite": false,
      "SerializedTabs": "...",
      "SerializedEffects": "..."
    }
  ]
}

14. Exportar e importar ajustes preestablecidos

Los ajustes preestablecidos se pueden exportar e importar como archivos de paquete (extensión .ceprstpkg), lo que permite compartirlos entre entornos y usuarios.

14-1. Exportar

Seleccione el/los ajuste(s) a exportar (Ctrl+clic o Mayús+clic para selección múltiple).
Haga clic derecho y seleccione «Exportar».
Se abre un cuadro de diálogo para guardar el archivo. Especifique un destino y nombre de archivo, luego guarde.

Ajuste único: El nombre del ajuste se usa como nombre de archivo predeterminado (los caracteres no permitidos en nombres de archivo se reemplazan con _).
Varios ajustes: Se usa el nombre de paquete predeterminado «CombinedEffect_Preajustes».

14-2. Importar

Seleccione el grupo al que desea agregar los ajustes importados.
Haga clic derecho en un área en blanco de la lista de ajustes y seleccione «Importar».
Se abre un cuadro de selección de archivos. Seleccione un archivo .ceprstpkg (se pueden seleccionar varios archivos a la vez).
Los ajustes importados se agregan al grupo actual.

A los ajustes importados se les asignan nuevos GUID, por lo que no entrarán en conflicto con los ajustes existentes.

14-3. Compatibilidad de versiones

Los archivos de paquete incluyen un número de versión de formato. La versión actual es 1. Si intenta importar un paquete con una versión superior a la compatible, se mostrará un mensaje de error.

15. Historial de instantáneas y gestión de ramas

Cada ajuste preestablecido dispone de una ventana de gestión del historial al estilo Git. Puede guardar los cambios de configuración de efectos como instantáneas y gestionarlos con ramas.

15-1. Abrir la ventana de historial

Haga clic derecho en el ajuste que desea gestionar.
Seleccione «Gestión de historial» en el menú contextual.
Se abre la ventana de gestión del historial (una ventana por ajuste).

15-2. Diseño de la ventana de historial

Panel	Descripción
Izquierda (lista de ramas)	Lista todas las ramas del ajuste. Haga clic para seleccionar una rama; su historial de instantáneas se muestra en el centro. Introduzca un nombre de rama en el cuadro de texto inferior y haga clic en «Crear Nueva Rama» para agregar una nueva rama.
Centro (lista de instantáneas)	Lista las instantáneas desde el HEAD de la rama seleccionada hacia atrás. Cada fila muestra un icono de confirmación (relleno para el HEAD actual), etiquetas, mensaje, fecha/hora, resumen de diferencias e ID. Haga clic derecho para acceder al menú contextual. Introduzca un mensaje en la parte inferior y haga clic en «Guardar Nueva Instantánea» para guardar la configuración actual. Use el botón «Revertir a Esto» en la parte inferior para volver a la instantánea seleccionada.
Derecha (vista de diferencias)	Muestra las diferencias entre la instantánea seleccionada y la configuración de efectos actual. Las adiciones son verdes, las eliminaciones son rojas y las modificaciones son amarillas. Los cambios en el recuento de efectos y los valores de propiedades antes/después se muestran en fuente Consolas.

15-3. Crear una instantánea

Abra la ventana de gestión del historial.
Introduzca un mensaje que describa los cambios en el cuadro de texto en la parte inferior del panel central.
Haga clic en «Guardar Nueva Instantánea».
La configuración de efectos actual del ajuste se guarda como instantánea y el HEAD de la rama seleccionada se actualiza.

15-4. Revertir a una instantánea

Seleccione la instantánea a la que desea revertir.
Haga clic en el botón «Revertir a Esto».
El ajuste y el elemento Efectos Combinados en la línea de tiempo se restauran al estado de la instantánea seleccionada.

15-5. Crear una rama

Introduzca un nuevo nombre de rama en el cuadro de texto en la parte inferior del panel izquierdo.
Haga clic en «Crear Nueva Rama».
Se crea una nueva rama a partir de la instantánea seleccionada actualmente (o el HEAD de la rama actual).

15-6. Operaciones del menú contextual

Al hacer clic derecho en una instantánea se abre un menú contextual.

Operación	Descripción
Fusionar en Actual	Agrega los efectos de la instantánea seleccionada al final de los efectos actuales.
Mantener Cambios (Soft)	Mueve el HEAD de la rama seleccionada a la instantánea elegida sin cambiar los efectos de la línea de tiempo.
Descartar Cambios (Hard)	Realiza Mantener Cambios (Soft) y Revertir simultáneamente.
Administrar Etiquetas	Abre la ventana de gestión de etiquetas para la instantánea.

15-7. Leer el resumen de diferencias

Se muestra un resumen de diferencias en la columna «Cambios» de la lista de instantáneas.

«Agregado (+N)»: La instantánea tiene N efectos más que el estado actual
«Eliminado (N)»: La instantánea tiene N efectos menos que el estado actual
«Modificado»: Mismo recuento de efectos, pero los parámetros han cambiado
(vacío): Idéntico a la configuración de efectos actual

15-8. Ubicación de almacenamiento de datos del historial

Los datos del historial se guardan en la carpeta History/ bajo el directorio del complemento. Se crea una subcarpeta por ajuste; la información de ramas se almacena como branches.json y cada instantánea como {ID}.json.

16. Gestión de etiquetas

Puede adjuntar varias etiquetas a las instantáneas para organizarlas. Las etiquetas se muestran en verde en la lista de instantáneas.

16-1. Agregar una etiqueta

Haga clic derecho en la instantánea a la que desea etiquetar.
Seleccione «Administrar Etiquetas» en el menú contextual.
Se abre la ventana de gestión de etiquetas.
Introduzca un nombre de etiqueta en el cuadro de texto superior y haga clic en «Añadir».

No se permiten nombres de etiqueta duplicados.

16-2. Eliminar una etiqueta

Abra la ventana de gestión de etiquetas.
Haga clic en el botón «Eliminar» junto a la etiqueta que desea borrar.

17. Eliminación masiva de efectos

Puede eliminar de una vez todos los efectos desactivados (sin marca) del elemento Efectos Combinados.

Haga clic derecho en un área en blanco de la lista de ajustes.
Seleccione «Limpiar» → «Eliminar efectos no seleccionados» en el menú contextual.
Haga clic en «OK» en el cuadro de confirmación.
Todos los efectos actualmente desactivados son eliminados.

Los efectos activados no se ven afectados. Si no hay efectos desactivados, no ocurre nada.

18. Interfaz responsiva y ajuste del diseño

18-1. Ajustar la altura del panel

Arrastre el controlador de redimensión (doble línea) en la parte inferior del panel de gestión de ajustes para cambiar su altura. La altura mínima es de 200px. La configuración se guarda al soltar el arrastre y se restaura en el siguiente inicio.

18-2. Ajustar el ancho de la columna de grupos

Arrastre el divisor de cuadrícula (borde entre la lista de grupos y la lista de ajustes) hacia la izquierda o derecha para ajustar el ancho de la columna de grupos. El ancho mínimo es de 120px y el máximo de 400px. La configuración se guarda al finalizar el arrastre.

18-3. Diseño móvil

Cuando el ancho del control cae por debajo de 400px, ocurren los siguientes cambios:

El panel de lista de grupos se oculta.
El divisor de cuadrícula se oculta.
Aparece un botón de menú hamburguesa (≡) a la izquierda de la barra de búsqueda.
Al hacer clic se abre la lista de grupos como una ventana emergente. Al seleccionar un grupo, la ventana emergente se cierra.

Cuando el ancho del control vuelve a 400px o más, el diseño cambia automáticamente de nuevo al modo de escritorio.

19. Almacenamiento de datos y persistencia segura

Todos los datos de ajustes preestablecidos, configuraciones de grupos e historial se guardan como archivos JSON. Los siguientes mecanismos de redundancia y verificación de integridad evitan la pérdida de datos por un único fallo.

19-1. Escritura atómica

Las escrituras en archivos siguen estos pasos:

Escritura en un archivo temporal (.tmp).
Uso de File.Replace para intercambiar el archivo temporal con el archivo principal, y mover el archivo antiguo al de respaldo (.bak).
Incluso si la aplicación se cierra abruptamente durante la escritura, el archivo principal o el de respaldo siempre estará en un estado válido.

19-2. Verificación CRC32

Se calcula una suma de verificación CRC32 y se añade al archivo al escribir. Al leer, se verifica la suma; si no coincide, se utiliza el archivo de respaldo para la recuperación.

19-3. Almacenamiento multirredundante SHA-256

Los datos de ajustes preestablecidos y el registro de grupos se guardan en dos ubicaciones:

Almacenamiento principal: Carpeta presets/ bajo el directorio del complemento
Almacenamiento de respaldo: Carpeta user/backup/CombinedEffect/

Al inicio, ambas ubicaciones se comparan con el hash SHA-256 y la marca de tiempo almacenados en CombinedEffectSettings. Si se detecta una inconsistencia, los datos correctos se usan para reparar automáticamente (sanar) el otro.

19-4. Escrituras con debounce

Las operaciones de cambio consecutivas se agrupan con un debounce de 300ms (100ms para eliminaciones) y se escriben juntas, reduciendo la carga de E/S.

19-5. Registro

Los registros de operaciones y errores se guardan en user/log/CombinedEffect/.

Se crea un nuevo archivo de registro cuando el actual supera los 512 KB.
Los archivos de registro con más de 31 días se eliminan automáticamente (verificado cada hora).

20. Migración desde versiones anteriores

Si existe un archivo de datos de una versión anterior en la ruta indicada a continuación, se migrará automáticamente en el primer inicio.

%AppData%\YukkuriMovieMaker4\user\plugins\CombinedEffect\presets.json

Tras la migración, el archivo antiguo se renombra a presets.json.migrated. El archivo antiguo no se elimina si la migración falla.

La migración incluye:

Lista de grupos en formato antiguo (se excluyen los grupos equivalentes a los virtuales «Todo» y «Favoritos»)
Ajustes preestablecidos pertenecientes a cada grupo (nombre, estado de favorito, configuración de efectos)

21. Estructura de archivos y carpetas

Ruta (relativa al directorio del complemento)	Contenido
`presets/`	Carpeta principal de almacenamiento de datos de ajustes
`presets/groups.json`	Configuración de grupos (nombres de grupo y listas de ID de ajustes)
`presets/{GUID}.json`	Datos de cada ajuste preestablecido (nombre, favorito, JSON de configuración de efectos)
`presets/recent_ids.json`	Lista de ID de ajustes usados recientemente (máx. 10)
`presets/UISettings.json`	Configuración de la interfaz (altura del panel, ancho de columna de grupos)
`History/`	Carpeta de almacenamiento de datos del historial de instantáneas
`History/{GUID del ajuste}/branches.json`	Lista de ramas de ese ajuste
`History/{GUID del ajuste}/{GUID de instantánea}.json`	Datos de cada instantánea
`user/backup/CombinedEffect/`	Almacenamiento de respaldo (relativo al directorio de instalación de YMM4)
`user/log/CombinedEffect/`	Carpeta de almacenamiento de archivos de registro (relativa al directorio de instalación de YMM4)

Los datos de ajustes se almacenan tanto en el almacenamiento principal como en el de respaldo. Si se pierde uno, el otro puede usarse para la recuperación. Si ambos se eliminan, los ajustes no se pueden recuperar.

22. Compatibilidad multilingüe

Toda la interfaz cambia automáticamente según la configuración de idioma de YMM4. No se necesita configuración adicional.

Código de idioma	Idioma
ja-jp	Japonés
en-us	Inglés
zh-cn	Chino simplificado
zh-tw	Chino tradicional
ko-kr	Coreano
es-es	Español
ar-sa	Árabe
id-id	Indonesio

23. Referencia de parámetros

Parámetro	Tipo	Predeterminado	Animable	Descripción
Efectos Activos (Effects)	ImmutableList<IVideoEffect>	(vacío)	No	La lista de efectos de vídeo a gestionar. Use el selector de efectos estándar de YMM4 para agregar, eliminar, reordenar y activar/desactivar efectos. Se procesan en cadena de arriba abajo. Los efectos desactivados se omiten.
EffectTabsJson	String (JSON)	(cadena vacía)	No	Propiedad interna que almacena el estado de pestañas de efectos (ID de pestaña seleccionada, nombres de pestañas y JSON de efectos por pestaña). Se actualiza automáticamente al agregar, eliminar, renombrar o cambiar pestañas.
SelectedPresetJson	String (JSON)	(cadena vacía)	No	Propiedad interna que almacena información sobre el ajuste actualmente aplicado. Se establece automáticamente al aplicar un ajuste. No se recomienda editarlo directamente. Se usa para mostrar el nombre del ajuste en la etiqueta de la línea de tiempo.
PresetManagerVisible	bool	true	No	Indicador interno que controla la visibilidad del panel de gestión de ajustes. Excluido de la serialización JSON ([JsonIgnore]).

Formato de visualización de la etiqueta

Estado	Formato	Ejemplo
Sin ajuste aplicado	{Nombre del efecto} Activo: {N}	Efectos Combinados Activo: 3
Ajuste aplicado	{Nombre del efecto} Activo: {N} [{Nombre del ajuste}]	Efectos Combinados Activo: 3 [Conjunto de efectos A]

24. Referencia rápida

Operaciones de pestañas

Operación	Método	Notas
Agregar pestaña	Botón «+» a la derecha de la barra de pestañas	Crea una pestaña nueva con configuración vacía
Eliminar pestaña	Botón «x» de la pestaña	La primera pestaña «Nuevo» no se puede eliminar
Renombrar pestaña	Doble clic en la pestaña para editar	Enter/cambio de foco para confirmar, Esc para cancelar
Cambiar pestaña	Hacer clic en una pestaña	Los efectos de la pestaña seleccionada se reflejan en «Efectos Activos»

Operaciones de grupo

Operación	Método	Restricción
Agregar grupo	Botón «+» en la parte inferior de la lista de grupos	Ninguna
Eliminar grupo	Botón «-» en la parte inferior de la lista de grupos	Los grupos por defecto y virtuales no se pueden eliminar
Renombrar grupo	Doble clic, o clic derecho → «Renombrar»	Los grupos virtuales no se pueden renombrar
Reordenar grupos	Arrastrar y soltar	Los grupos virtuales no se pueden mover

Operaciones de ajustes preestablecidos

Operación	Método	Notas
Agregar ajuste	Botón «+ (Agregar)»	Se guarda en el primer grupo real si se selecciona un grupo virtual
Eliminar ajuste	Botón «- (Eliminar)», o clic derecho → «Eliminar»	Se muestra cuadro de confirmación. Se admite selección múltiple.
Renombrar ajuste	Doble clic, o clic derecho → «Renombrar»	Ninguna
Reordenar ajustes	Arrastrar y soltar	No disponible al ver grupos virtuales
Aplicar ajuste	Botón «✓ (Aplicar)», o clic derecho → «Aplicar»	Cuadro de confirmación para contenido idéntico
Actualizar ajuste	Botón «↺ (Actualizar)», o clic derecho → «Actualizar»	Solo activo cuando los efectos han cambiado
Vaciar ajuste	Clic derecho → «Vaciar Ajuste»	Se muestra cuadro de confirmación. Solo disponible cuando el ajuste tiene 1+ efectos.
Alternar favorito	Hacer clic en el botón de estrella	Ninguna
Copiar	Clic derecho → «Copiar»	Se admite selección múltiple
Cortar	Clic derecho → «Cortar»	Sin cuadro de confirmación. Se admite selección múltiple.
Pegar	Clic derecho → «Pegar»	Requiere JSON válido en el portapapeles
Exportar	Clic derecho → «Exportar»	Selección múltiple. Formato .ceprstpkg.
Importar	Clic derecho en área en blanco → «Importar»	Se pueden seleccionar varios archivos
Eliminar efectos no seleccionados	Clic derecho en área en blanco → «Limpiar» → «Eliminar efectos no seleccionados»	Se muestra cuadro de confirmación
Abrir historial	Clic derecho → «Gestión de historial»	Una ventana por ajuste

Operaciones del historial

Operación	Método	Descripción
Guardar instantánea	Introducir mensaje → Botón «Guardar Nueva Instantánea»	Desactivado si el mensaje está vacío
Revertir a instantánea	Seleccionar instantánea → Botón «Revertir a Esto»	Se aplica tanto al ajuste como a la línea de tiempo
Crear rama	Introducir nombre de rama → Botón «Crear Nueva Rama»	Desactivado si el nombre de rama está vacío
Fusionar	Clic derecho en instantánea → «Fusionar en Actual»	Agrega efectos al final actual
Mantener Cambios (Soft Reset)	Clic derecho en instantánea → «Mantener Cambios (Soft)»	Solo mueve el HEAD, sin cambios de efectos
Descartar Cambios (Hard Reset)	Clic derecho en instantánea → «Descartar Cambios (Hard)»	Soft Reset + Revertir simultáneamente
Administrar etiquetas	Clic derecho en instantánea → «Administrar Etiquetas»	Abre la ventana de gestión de etiquetas

25. Notas y advertencias

La salida en formato AviUtl (.exo) no es compatible.
No se recomienda anidar «Efectos Combinados» dentro de otro «Efectos Combinados».
Los grupos virtuales «Todo», «Favoritos» y «Reciente» no se pueden eliminar, renombrar ni reordenar.
El grupo «Por defecto» no se puede eliminar.
Agregar o pegar un ajuste mientras se selecciona un grupo virtual lo guarda en el primer grupo real.
Importar un archivo de paquete asigna nuevos ID diferentes de los GUID originales. Por lo tanto, los ajustes importados no heredan el historial de instantáneas.
La operación Cortar elimina ajustes sin cuadro de confirmación. Esta acción no se puede deshacer inmediatamente, así que úsela con cuidado.
Aplicar un solo ajuste restaura la estructura de pestañas guardada (incluida la pestaña seleccionada). Al aplicar varios ajustes a la vez, o al volver a aplicar el mismo ajuste en modo de apilado, solo se combinan los efectos de la pestaña seleccionada y las pestañas se reconstruyen como una única pestaña «Nuevo».
Los datos de ajustes se almacenan tanto en el almacenamiento principal como en el de respaldo. Eliminar una carpeta puede permitir la recuperación, pero eliminar ambas resultará en pérdida permanente de datos.
Los datos del historial se almacenan en la carpeta History/. Eliminar esta carpeta borrará todo el historial.
El historial de instantáneas crece sin límite. Si hay demasiadas instantáneas innecesarias, puede eliminar manualmente los archivos .json no deseados en la carpeta History/{GUID del ajuste}/ (no elimine branches.json).
Solo los efectos admitidos por el sistema de complementos de YMM4 se guardan como parte de la configuración de efectos de un ajuste. Los efectos no admitidos pueden omitirse al cargar.
Debido a las escrituras con debounce, hay un retraso de hasta 300ms entre una operación de cambio y la escritura real en el archivo. Si YMM4 se cierra forzosamente de inmediato, es posible que la última operación no se guarde.

26. Aviso legal y licencia

Este complemento se publica bajo la Licencia MIT.

ESTE SOFTWARE SE PROPORCIONA «TAL CUAL», SIN GARANTÍA DE NINGÚN TIPO, EXPRESA O IMPLÍCITA, INCLUYENDO PERO NO LIMITADO A LAS GARANTÍAS DE COMERCIABILIDAD, IDONEIDAD PARA UN PROPÓSITO PARTICULAR Y NO INFRACCIÓN.

El autor no será responsable de ningún daño derivado del uso o la imposibilidad de uso de este complemento. Úselo bajo su propia responsabilidad.

Autor: routersys / Licencia: MIT License / Repositorio: https://github.com/routersys/YMM4-CombinedEffect

Fin del documento.