Renombrado de archivos de salida

1. Introducción

2. Referencia de etiquetas

3. Reglas de numeración

4. Reglas y limitaciones

5. Ejemplos

*GUI en este documento se refiere a Waifu2x-Extension-GUI

Introducción

Waifu2x-Extension-GUI nombra los archivos de salida automáticamente. Con el diálogo Renombrado de archivos de salida (haga clic en el botón Renombrar para abrirlo), puede personalizar el nombre del archivo de salida.

El diálogo ofrece tres modos:

Predeterminado - mantiene la convención de nomenclatura integrada de los motores; no se aplica ningún renombrado personalizado.
Combinación simple - elija elementos (número, motor, escala, nivel de reducción de ruido, calidad de imagen, extensión de origen) para colocarlos antes y/o después del nombre de archivo, unidos por un conector (_, espacio o -).
Avanzado - construya el nombre de archivo a partir de etiquetas, con dos cadenas de formato separadas: una para cuando se usa una carpeta de salida y otra para el guardado en el mismo lugar (el archivo queda junto al origen, incluso cuando la carpeta de salida está desactivada).

El renombrado se aplica después de que el archivo se haya guardado y movido a su ubicación de salida. Solo cambia el nombre de archivo (nombre base); la extensión nunca se modifica.

El renombrado no surte efecto cuando Mantener nombre orig. está activado mientras se usa una carpeta de salida, o cuando Reemplazar archivo orig. está activado.

Referencia de etiquetas

Etiqueta	Descripción
`<name>`	Nombre base del archivo de origen (sin la extensión). Ejemplo: `CatPic.png` → `CatPic`.
`<ext>`	Extensión del archivo de origen (sin el punto). Ejemplo: `CatPic.png` → `png`.
`<outext>`	Extensión del archivo de salida (sin el punto).
`<scale>`	Relación de escala, como `2x`, o la resolución personalizada, como `1920x1080`, cuando se aplica una resolución personalizada. Se expande a una cadena vacía en procesos sin escalado (solo conversión de formato, solo interpolación de frames, solo eliminación de frames duplicados).
`<denoise>`	Nivel de reducción de ruido. Se expande a una cadena vacía para motores sin opción de reducción de ruido (RealESRGAN, RealSR, PyTorch, Maxine) y en procesos sin escalado.
`<engine>`	Nombre corto del motor de escalado: `Waifu2xNcnn`, `Waifu2xCaffe`, `Waifu2xConverter`, `SrmdNcnn`, `SrmdCuda`, `RealSR`, `RealESRGAN`, `RealCUGAN`, `Anime4K`, `Maxine`, `PyTorch`. Se expande a una cadena vacía en procesos sin motor de escalado (solo conversión de formato, solo interpolación de frames, solo eliminación de frames duplicados).
`<number-pad>`	Número de secuencia dentro de la carpeta de origen, con relleno de ceros. El ancho se adapta al número de archivos del grupo: 77 archivos → ancho 2 → `07`. Vea Reglas de numeración.
`<number-pad3>`	Número de secuencia con un ancho explícito. Ejemplo: `<number-pad3>` → `007`.
`<number-pad3:date:desc>`	Número de secuencia con claves de ordenación en línea. Parámetros permitidos: `name`, `date`, `asc`, `desc`; el valor predeterminado es `name asc`.
`<date:yyyy-MM-dd>`	Fecha de modificación del archivo de origen, formateada con los tokens de formato nativos de Qt (la cadena de formato de `QDateTime::toString`). Ejemplos comunes: `yyyy-MM-dd` → `2024-01-15`, `yyyyMMdd-hhmmss` → `20240115-103000`.
`<ImgQuality:separator>`	Calidad de imagen de la imagen de salida. Solo archivos de imagen, y lleva su propio conector: `cat<ImgQuality:_>` → `cat_Q95.jpg`. Se expande a una cadena vacía para archivos que no son imágenes (GIF, video).

Los nombres de etiquetas no distinguen mayúsculas: <NAME> es lo mismo que <name>.

Reglas de numeración

Los números de secuencia se asignan por carpeta de origen, numerados desde 1.
Los números se asignan cuando comienza el procesamiento, por lo que no dependen del orden en que terminan los archivos. Un archivo que después falla o se omite no cambia los números de los demás archivos.
Los archivos omitidos automáticamente por la omisión automática basada en resolución no se pueden distinguir al asignar los números, por lo que siguen contando y la secuencia puede contener huecos.
Modo simple: la clave de ordenación viene del desplegable (nombre de archivo / fecha de modificación, solo ascendente).
Modo avanzado: la clave de ordenación se define en línea en la etiqueta de número, p. ej. <number-pad:date>, <number-pad3:name:asc>, <number-pad3:date:desc>. Si aparecen varias etiquetas de número con claves de ordenación distintas en la misma cadena de formato, la primera tiene efecto.
La fecha de modificación usada para la ordenación por fecha y para <date:...> es una instantánea tomada al comenzar el procesamiento - modificar el archivo de origen durante el procesamiento no cambia el valor expandido.

Reglas y limitaciones

Los nombres de etiquetas no distinguen mayúsculas.
Fusión de separadores. Cuando una etiqueta se expande a una cadena vacía, el separador (_, espacio o -) inmediatamente adyacente a cada lado se elimina. Ejemplo: a_<empty>_b → a_b. Los separadores consecutivos que escriba usted mismo se conservan: img_<name>__v2 → img_CatPic__v2.
Caracteres no válidos. El nombre de archivo expandido no debe contener \ / : * ? " < > |. Esta comprobación también se aplica al resultado de la expansión; p. ej. <date:hh:mm:ss> se expandiría a 10:30:00, que contiene : y por tanto se rechaza.
No use > dentro de una cadena de formato de fecha, ni siquiera dentro de literales entre comillas simples de Qt - la etiqueta termina en el primer >, por lo que la cadena de formato quedaría cortada.
El renombrado solo cambia el nombre de archivo, nunca la extensión.
Si el nombre de archivo de destino ya existe, se añade automáticamente _1, _2, ...
El renombrado no se aplica cuando Mantener nombre orig. está activado mientras se usa una carpeta de salida, o cuando Reemplazar archivo orig. está activado.
Si el renombrado no se puede aplicar en tiempo de ejecución (por ejemplo, todo el formato se expande a un nombre vacío para el proceso actual, o el archivo está en uso), se conserva el nombre de archivo de salida original, se muestra una advertencia en el registro y el archivo no se marca como fallido.

Ejemplos

Archivo de origen: CatPic.png, motor Waifu2xNcnn, 2x, nivel de reducción de ruido 1, salida png.

<engine>_<name>_<scale>_<denoise> → Waifu2xNcnn_CatPic_2x_1.png
El mismo formato con el motor RealESRGAN (sin opción de reducción de ruido), 4x: <engine>_<name>_<scale>_<denoise> → RealESRGAN_CatPic_4x.png (el <denoise> vacío fusiona el _ adyacente).
Solo conversión de formato (sin motor, sin escala, sin reducción de ruido): <engine>_<name>_<scale>_<denoise> → CatPic.png (las tres etiquetas están vacías, todos los separadores se fusionan).
cat<ImgQuality:_> → cat_Q95.jpg para imágenes; para un GIF o un video se expande a cat.jpg.
<name>_<date:yyyy-MM-dd> → CatPic_2024-01-15.png (fecha de modificación del origen al comenzar el procesamiento).
<number-pad>_<name> con 77 archivos en la carpeta: el 7.º archivo → 07_CatPic.png.
<number-pad3:date:desc>_<name> → ordenado por fecha de modificación, descendente, ancho 3: 003_CatPic.png.