En resumen
Activa VanityFilter una vez en la aplicación, abre PowerShell y ejecuta vanityfilter-cli.exe desde la carpeta de instalación con uno o más videos. Cada archivo se procesa con el preajuste que elijas y se guarda como un archivo nuevo; los originales nunca se reemplazan.
Antes de empezar
- Licencia: la herramienta usa la licencia activada en la aplicación. Abre VanityFilter e introduce tu clave antes del primer uso. Si la licencia venció, termina con un mensaje de error.
- Ubicación: se instala junto a la aplicación. En una instalación predeterminada es
C:\Program Files\VanityFilter\vanityfilter-cli.exe. No se agrega al PATH, así que usa la ruta completa entre comillas o abre la terminal en esa carpeta. - Ajustes: parte de un preajuste y cambia solo lo necesario. Cada opción de tratamiento reemplaza el valor del preajuste. Si eliges los ajustes en la aplicación, guárdalos en un espacio de usuario o en un archivo .vfpreset y úsalos aquí con
--preset.
Ejemplos
Un clip con el preajuste Standard:
& "C:\Program Files\VanityFilter\vanityfilter-cli.exe" --preset Standard "D:\Videos\entrevista.mp4"Una carpeta completa a ProRes, con la máscara y los ajustes guardados junto a cada salida:
& "C:\Program Files\VanityFilter\vanityfilter-cli.exe" --preset "User 1" --codec prores --export-mask --sidecar --output-dir "D:\Videos\limpios" (Get-ChildItem "D:\Videos\crudos\*.mp4").FullNameUna prueba corta de 30 segundos antes de exportar todo el clip:
& "C:\Program Files\VanityFilter\vanityfilter-cli.exe" --preset Standard --shine 0.4 --blemish 0.65 --start 1:00 --end 1:30 -o "D:\Videos\prueba.mp4" "D:\Videos\entrevista.mp4"Una entrevista con retratos en el fondo, tratando solo a la persona principal:
& "C:\Program Files\VanityFilter\vanityfilter-cli.exe" --preset Standard --min-face 0.225 "D:\Videos\entrevista.mp4"Todas las opciones
Esta es la ayuda de la versión 3.1.5. Ejecuta vanityfilter-cli.exe --help para ver la de tu versión instalada. Los nombres de las opciones están en inglés en ambos idiomas de la aplicación.
Entrada y salida
| Opción | Valor | Qué hace |
|---|---|---|
inputs | archivo... | Uno o más videos de entrada (MP4, MOV, AVI o MKV). |
-o, --output | RUTA | Ruta de salida. Solo con un archivo de entrada. Por defecto: <entrada>_skin_smooth.<ext>. |
--output-dir | CARPETA | Carpeta para las salidas con nombre por defecto. Se crea si no existe. |
--codec | h264 | prores | h264 escribe .mp4; prores escribe ProRes 422 HQ en .mov. Por defecto: h264. |
--export-mask | También exporta el video de máscara en escala de grises junto a cada salida. | |
--sidecar | Escribe un archivo JSON con los ajustes junto a cada salida. | |
--mask-preview | Exporta el video de depuración con la máscara superpuesta en lugar del resultado. | |
--start | TIEMPO | Exporta desde este momento, en segundos o [hh:]mm:ss (por ejemplo 90 o 1:30). |
--end | TIEMPO | Exporta hasta este momento. Solo con un archivo de entrada. |
Preajuste y tratamiento
| Opción | Valor | Qué hace |
|---|---|---|
--preset | NOMBRE | Punto de partida: Light touch, Standard, Heavy, Low-light repair, Face only, un espacio User 1 a User 4 guardado en la aplicación, o la ruta de un archivo .vfpreset. No distingue mayúsculas. |
--amount | 0..1 | Mezcla general de todo el efecto (Cantidad). |
--strength | 0..1 | Mezcla del suavizado (Intensidad). |
--radius | 3..25 | Radio de suavizado en píxeles. |
--repair | 0..1 | Reparar textura. |
--detail | 0..1 | Restaurar detalle. |
--tolerance | 0..1 | Tolerancia de color de piel. |
--brighten | 0..1 | Aclarar: elevación gamma de la luminosidad de la piel. |
--shine | 0..1 | Quitar brillos. |
--redness | 0..1 | Reducir rojeces. |
--blemish | 0..1 | Imperfecciones. |
Máscara y rostros
| Opción | Valor | Qué hace |
|---|---|---|
--feather | 3..61, impar | Difuminado del borde de la máscara en píxeles. |
--stability | 0..0.95 | Estabilidad temporal de la máscara. |
--expansion | 0..1 | Expandir rostro. |
--neck | 0..1 | Cobertura de cuello; 0 la desactiva. |
--forehead | 0..1 | Cobertura de frente; 0 la desactiva. |
--primary-only | Trata solo el rostro más grande o más centrado (Solo el rostro principal). | |
--min-face | 0..0.5 | Ignora rostros más bajos que esta fracción del alto del fotograma (Ignorar rostros pequeños; 0.225 equivale a 22,5 %). |
Otras
| Opción | Valor | Qué hace |
|---|---|---|
--version | Muestra la versión y termina. | |
-h, --help | Muestra la ayuda completa y termina. |
Qué escribe y cómo termina
- Por cada archivo muestra su número y nombre, la resolución, los fotogramas por segundo, la duración y si tiene audio, una barra de progreso y, al terminar, la ruta de la salida.
- Si dos salidas de un lote tendrían el mismo nombre, las siguientes reciben _2, _3 y así sucesivamente. Un archivo de salida existente con el mismo nombre se reemplaza.
- Si detecta una velocidad de fotogramas variable, o no puede verificarla, muestra una advertencia: la exportación usa una velocidad constante y el audio puede desfasarse. Convierte ese archivo a velocidad constante primero.
- Código de salida 0: todos los archivos se procesaron. 1: al menos un archivo falló; los demás del lote se procesan igual. 2: opciones no válidas o un problema de licencia; no se procesa nada.
¿Prefieres la aplicación? El flujo equivalente está en suaviza la piel antes de editar. Para dudas, pregúntale a Vani o escríbenos.