Manual de usuario

1. Primeros pasos

Iris-Editor es una aplicación web con un proceso de cuatro etapas:

1. Subir foto — JPG o PNG, cualquier tamaño
2. Extraer iris — basado en IA, se ejecuta automáticamente en segundo plano
3. Editar iris — 11 controles para exposición, color, nitidez, forma
4. Crear obra — el estilo elegido se renderiza sobre el iris

En cada etapa puedes descargar el resultado intermedio o saltar a la siguiente.

Requisitos

• Un navegador actual (Firefox, Chrome, Safari, Edge — últimas dos versiones)
• Una PurchaseID válida (ver capítulo siguiente)
• Conexión a internet — los pasos de IA se ejecutan en el servidor

2. Inicio de sesión

Iris-Editor no usa contraseña sino una PurchaseID permanente. Es un identificador que recibes al comprar en pureirisart.com.

Iniciar sesión

1. Abre https://editor.pureirisart.com
2. Escribe tu PurchaseID (mayúsculas, sin espacios)
3. Pulsa Iniciar sesión

Si llegas mediante un enlace del correo de confirmación, la ID se rellena automáticamente (?pid=TU_ID).

¿Qué pasa después?

Llegas al Studio. En tu primer inicio de sesión, el iris de ejemplo ya está en tu biblioteca y se inicia automáticamente la visita guiada que muestra los elementos clave. Puedes reiniciarla en cualquier momento desde el icono de la barra superior.

3. Subir foto

En el Studio, arriba a la izquierda hay un botón de subida (o arrastra y suelta una foto sobre el área de la biblioteca). Se permiten varios archivos a la vez.

¿Qué fotos sirven?

• Formato: JPG o PNG. Tamaño máximo aprox. 50 MB
• Resolución: idealmente al menos 3000 × 2000 px — la IA necesita detalle para extraer el iris limpio
• Sujeto: un ojo nítido con iris bien visible, no un retrato a tres metros
• Iluminación: lo más uniforme posible, sin sombras duras sobre el iris

Durante la subida

Cada foto recibe una pequeña tarjeta en la columna izquierda. Mientras se extrae el iris se muestra una barra de progreso — típicamente 30–60 segundos por foto. Mientras tanto puedes editar otros iris o subir más.

Nombres de archivo

El nombre original se conserva y se usa más tarde para nombrar las descargas. Lo puedes cambiar en cualquier momento: clic derecho (o icono de lápiz) sobre la tarjeta. Útil cuando tu móvil asigna nombres como IMG_8421.jpg — renómbralo a Sarah y todas las descargas llevan ese nombre.

4. Extracción del iris

Recortar el iris se realiza completamente en segundo plano. Cuando el estado de la tarjeta cambia a listo, el iris extraído está disponible como PNG de 4000 × 4000 píxeles con canal alfa.

¿Qué muestra el iris extraído?

• Solo el iris — pupila, esclerótica y párpado están aislados
• Fondo blanco o transparente según el estilo (ver Editor)
• Sin desenfoque de movimiento ni artefactos de pestañas — la IA se encarga

Si falla la extracción

La tarjeta muestra una insignia roja con «Error». Causas más comunes:

• Iris demasiado pequeño o desenfocado en la foto — sube una foto nueva
• API temporalmente no disponible — usa el botón de reintento de la tarjeta
• Archivo dañado — revisa el original, exporta de nuevo si es necesario

El reintento es un clic en el icono de la flecha-en-círculo en la tarjeta. Reinicia la extracción sin que vuelvas a subir la foto.

5. Editor

En el Studio abres un iris haciendo clic en la biblioteca a la izquierda, luego ve a la pestaña Editar. El editor muestra un control deslizante antes/después en el centro y un panel a la derecha con los 11 controles.

Los 11 controles

Doble clic en la etiqueta de un control lo restablece al valor por defecto. Con las flechas ← → se ajusta el control activo en pasos finos.

Fondo transparente

El toggle Fondo transparente elimina el fondo blanco de la extracción mediante chroma-key. Activado por defecto porque la mayoría de estilos esperan iris con canal alfa.

Desactívalo solo si quieres descargar la iris como PNG RGB con fondo blanco.

Ajustes preestablecidos

Cuando hayas dado con una combinación de controles que te guste, guárdala como preset (icono del disco arriba a la derecha). El preset recibe un nombre, está disponible globalmente en tu cuenta y se puede aplicar a cualquier otra iris.

El menú de presets muestra los tuyos — clic en un elemento lo aplica a la iris actual. Valores no aplicables (p. ej. tamaño de pupila) los sobreescribe el preset; puedes seguir ajustando después.

Reflejo

Punto de luz opcional (reflejo) que puedes poner sobre la iris. Forma, posición, tamaño, brillo y rotación son ajustables individualmente. Activa con el toggle Reflejo, aparecen los controles correspondientes.

Guardar

El botón verde Guardar escribe los valores actuales como variante edited de la iris. El editor se cierra; en el Studio verás la nueva variante en la biblioteca. Volver a guardar sobreescribe — siempre hay UNA sola versión edited por iris.

La variante extracted original queda intacta. En el selector de estilos eliges si un estilo se aplica a la extracted en bruto o a la edited.

6. Studio — la interfaz central

El Studio es una vista maestro-detalle: a la izquierda la biblioteca de tus iris, a la derecha la vista de detalle de la iris seleccionada con cuatro pestañas.

Las pestañas

• Resumen — original, extract, edit lado a lado; botones de descarga; estado
• Editar — el editor (capítulo 5)
• Estilos de arte — selector de estilos (capítulo 7)
• Variantes — todas las obras generadas a partir de esta iris (capítulo 8)

Biblioteca (izquierda)

Cada iris es una tarjeta con miniatura, insignia de estado y fecha. Cambia el orden abajo (nombre/fecha, ascendente/descendente). El filtro de búsqueda para listas largas está bajo el icono de la lupa.

Barra superior

• Actividad — indicador de renders en segundo plano
• Créditos — tu cuota restante (proviene de la tienda, no se gestiona aquí)
• Tour — reinicia la introducción guiada
• Menú de usuario (derecha) — modo bajo consumo, idioma, cierre de sesión, opcional Eventos

Modo bajo consumo

En el menú de usuario hay un toggle bajo consumo. Activado, la biblioteca y las vistas previas cargan a 1200 px en lugar de la resolución completa. Ahorra ancho de banda — útil en móvil o Wi-Fi débil. Editor y descargas mantienen la resolución completa.

Idioma

Cuatro idiomas: DE, EN, ES, FR. Cambia desde el menú de usuario. Tu elección queda en tu cuenta y aplica en todos los dispositivos.

7. Elegir y crear estilos de arte

La pestaña Estilos de arte muestra todos los estilos disponibles como mosaicos agrupados por número de iris: 1, 2, 3, 4 o 5 iris por composición.

Estilos de iris única

Para estilos de 1 iris basta un clic en el mosaico. Aparece un pequeño modal de previsualización donde puedes ver el estilo sobre tu iris (sin gastar créditos, solo previsualización). Con Confirmar arranca el render real.

Estilos multi-iris

Estilos para 2–5 iris muestran un selector multi-iris. Eliges de la biblioteca las iris para los slots 1, 2, 3, etc. Requisitos:

• Cada slot necesita una versión edited con fondo transparente — si no, el endpoint no puede componerlas
• Sin duplicados — cada iris solo una vez por composición
• El orden importa: el slot 1 suele ser la iris «principal»

Reordenar slots: arrastrar y soltar en escritorio, tap-to-swap en móvil (toca slot A, luego slot B — se intercambian).

Envío por lotes (varios estilos a la vez)

Puedes seleccionar varios mosaicos a la vez (casilla arriba a la izquierda de cada uno). Aparece arriba y abajo una barra de acción con el número de seleccionados + botón Enviar. Clic → todos se ejecutan secuencialmente.

Si un estilo ya se ha renderizado con esta combinación, aparece una advertencia de duplicado antes de gastar créditos — eliges qué sobreescribir.

Durante el render

El indicador de actividad de la barra superior aumenta. El mosaico del estilo muestra un overlay de carga. En la pestaña Variantes aparece la variante como marcador de posición con estado; al terminar el overlay desaparece y la previsualización es visible.

8. Gestionar variantes

En la pestaña Variantes ves todas las obras renderizadas de la iris actual como mosaicos. Abajo a la derecha de cada variante hay cuatro iconos:

• 📐 Recorte — editor de recorte
• T Texto — editor de texto (capítulo 9)
• ⬇ Descarga — como JPG/PNG
• 🗑 Eliminar — a la papelera

Recorte

En el modal de recorte arrastras la sección con el ratón. Mueve con flechas en pasos de 2 px, mantén Shift para 20 px.

Hay presets de aspect-ratio: 1:1 (cuadrado), 2:3 (foto clásica), 3:4 (póster vertical). Con Restablecer quitas el recorte y vuelves al render original.

Los recortes son no destructivos — no sobreescriben el original, se aplican dinámicamente en cada descarga.

Texto

Detallado en el capítulo 9.

Descarga & ZIP

Descarga individual con el icono ⬇ de la variante. El icono ZIP en la barra de acción agrupa todas las variantes seleccionadas en un solo ZIP. Multi-selección con shift-clic o las casillas.

Los nombres siguen este patrón:

NombreOriginal_NombreEstilo.jpg
NombreOriginal1+NombreOriginal2_NombreEstilo.jpg   (multi-iris)

Papelera

Las variantes eliminadas pasan 30 días en la papelera (pestaña abajo a la derecha Papelera). Hasta entonces se pueden restaurar o borrar definitivamente. Después se aplica la limpieza automática.

Lista de fallos

Si un render falla, en la pestaña Variantes aparece una sección Errores con el mensaje del API. Con Reintentar arrancas un render nuevo — suele bastar si el API estuvo brevemente caído.

9. Editor de texto — añadir tipografía a la obra

Clic en el icono T de una variante abre el editor de texto. Puedes añadir varias capas, moverlas, rotarlas, cambiar color — la previsualización es pixel-perfect lo que descargarás o imprimirás luego.

Añadir capa

Botón + Texto arriba a la izquierda. La capa nueva aparece arriba a la izquierda de la imagen y entra directamente en modo edición — empieza a escribir, el placeholder se reemplaza. Esc o clic fuera termina la edición.

Doble clic en una capa existente para volver a editarla. Hasta 20 capas por variante.

Fuentes & favoritas

47 Google Fonts curadas en 5 categorías:

• Script — manuscritas (Allura, Great Vibes, …)
• Display — fuentes llamativas para titulares
• Serif — clásicas con remates
• Sans — modernas sin remates
• Mono — ancho fijo, estilo máquina de escribir

En el selector de fuentes puedes:

• Con flechas ↑/↓ recorrer todas las fuentes en vivo (incluso con la lista cerrada)
• Filtrar por búsqueda o categoría
• Marcar la fuente activa con la estrella para añadirla a tus favoritas — se guardan en tu cuenta y están disponibles en todos los dispositivos
• El filtro «Favoritas» restringe la navegación con flechas a tus fuentes marcadas

Tamaño, rotación, espaciado

• Tamaño: deslizante 0,5 % – 40 % de la altura de la imagen. Doble clic = restablecer
• Rotación: deslizante –180° a +180°, más campo numérico para precisión. Doble clic = 0°
• Espaciado (letter-spacing / tracking): –50 a 500 en 1/1000 em. Negativo = más junto, positivo = más amplio

Anclaje (izquierda / centro / derecha)

Los tres iconos de la barra deciden el punto al que el texto se ancla cuando varía su longitud:

• Izquierda — el borde izquierdo queda fijo, el texto crece a la derecha
• Centro — el centro queda fijo, el texto crece simétricamente
• Derecha — el borde derecho queda fijo, el texto crece a la izquierda

Importante con variables: el anclaje decide cómo se alinean longitudes distintas. Ejemplo clásico: %Filename1% puede resolver a «Anna» o «Maximilian» — con anclaje «Centro» el texto sigue centrado en ambos.

Mover + bloqueo de eje con Shift

Arrastrar con el ratón mueve la capa libremente. Si mantienes Shift mientras arrastras, la capa permanece en una línea recta — horizontal o vertical según hacia dónde tires. Útil para alinear varias capas a la misma altura.

Variables

Puedes escribir marcadores en el contenido del texto que se reemplazan automáticamente:

Al salir del modo edición (Esc / clic fuera) el marcador se reemplaza inmediatamente por el valor real — ves al instante lo que llegará a la impresión. Al volver a editar la misma capa se restaura el marcador para seguir trabajando con variables.

Plantillas

El pie del editor tiene un menú Plantilla. Sirve para guardar la configuración de texto actual de modo que las nuevas variantes del mismo estilo arranquen ya con ese texto.

• Guardar como mi plantilla — solo para tu PurchaseID
• Eliminar mi plantilla — vuelve al estándar de admin
• Guardar como estándar de admin solo admin — aplica a todos los clientes sin plantilla propia

Orden de resolución al crear una nueva variante:

1. Override del cliente (tu plantilla)
2. Estándar de admin
3. Sin texto

Guardar

Guardar → el navegador renderiza el overlay final como PNG transparente en resolución completa y lo envía. El servidor lo compone 1:1 sobre la obra — la previsualización del editor y la descarga son idénticas pixel a pixel.

10. Ajustes

El menú de usuario (arriba a la derecha) contiene:

• Modo bajo consumo — vistas previas a 1200 px en lugar de resolución completa. Por defecto desactivado.
• Idioma — DE / EN / ES / FR. Efecto inmediato, válido entre dispositivos.
• Eventos solo operador — gestión de eventos (capítulo 11)
• Cerrar sesión

11. Modo evento Operador

El modo evento está pensado para eventos en directo: fotografías iris in situ, el invitado se registra desde su propio móvil y, en el mejor caso, se lleva a casa una impresión de 15 × 20 cm antes de marcharse.

Requiere que tu PurchaseID tenga el flag is_event_operator = 1. Pide al admin que lo active si el menú Eventos no aparece para ti.

Crear evento

Menú de usuario → Eventos → + Nuevo evento. Campos:

Cartel / registro de invitados

Tras guardar verás la tarjeta del evento en la lista. Clic en Copiar URL del cartel te da una URL como:

https://event.pureirisart.com/register.php?slug=<tu-slug>

Imprime esta URL como código QR y colócala en la entrada del evento. Cada invitado lo escanea con su móvil, llega a la página de registro e introduce:

• Nombre (obligatorio)
• Apellido (opcional)
• Correo (obligatorio)
• Casilla GDPR (obligatoria)
• Casilla marketing (opcional, lead-gen)

Tras enviar, el móvil del invitado muestra:

• Un código QR (para que tu webcam lo escanee)
• Un código de 6 dígitos (alternativa si no funciona el escaneo)

Pantalla del operador

En tu portátil de fotos abre:

https://event.pureirisart.com/op.php

La página tiene:

• Área de webcam con escáner QR activo
• Campo manual + selector de evento (alternativa)
• Cola con todos los invitados de todos tus eventos
• Botón ? arriba a la derecha — chuleta con todas las URLs relevantes

Flujo:

1. El invitado pone el móvil delante de la webcam → se escanea el QR → se abre la zona de drop con sus datos
2. Foto desde la carpeta de tethering arrastrada a la zona de drop
3. Subida + extracción del iris en marcha — el invitado ve el estado en su móvil en directo
4. El operador pasa al siguiente, llama el editor

Render automático tras guardar en el editor

En cuanto el operador guarda una iris en el editor con el toggle de transparencia activo:

1. El editor se cierra rápido (la UI se siente ágil)
2. En segundo plano se inician todos los estilos auto-render del evento
3. Por cada estilo con flag T se aplica el texto por defecto resolviendo variables
4. Los renders aparecen en la cola con estado renderizando, luego listo

La cola en detalle

Cada fila muestra nombre del invitado, título del evento, nombre de archivo (clic → detalle del Studio en nueva pestaña) y, según estado, el enlace al editor o un botón ✕ para limpiar renders bloqueados. La cola se refresca cada 15 segundos automáticamente.

Después del evento

El envío masivo de enlaces de descarga aún no es automático — planificado. Hasta entonces puedes descargar los renders uno a uno desde el Studio o agruparlos vía export ZIP.

12. Resolución de problemas

13. Glosario

PurchaseID

Identificador permanente emitido al comprar. Único mecanismo de inicio de sesión.

Subida (Upload)

La foto original en tu biblioteca. De cada subida nacen versiones de iris (extracted, edited).

Versión de iris

Una forma procesada de la iris: extracted (salida IA) o edited (tras tus ajustes).

Obra / Variante

La imagen final formada por iris + estilo. Cualquier número de estilos por combinación de iris, una variante por estilo.

Estilo

La plantilla de arte IA (p. ej. Stardust, Swirl Black). Cada estilo fija el número de iris necesarias.

Caja de recorte

Definición de recorte por variante. No destructiva — se aplica dinámicamente en cada descarga.

Overlay de texto

Las capas de texto sobre una variante. El navegador renderiza el overlay como PNG, el servidor lo compone sobre la obra.

Plantilla de texto

Estructura predefinida de capas de texto por estilo. Se aplica automáticamente a nuevas variantes cuando está activada.

Evento operador

Contenedor de configuración para un evento en directo con su propio branding, estilos por defecto y registro de invitados.

Pantalla del operador operador

La UI del operador en directo en event.pureirisart.com/op.php — escáner webcam + zona de drop + cola.

Modo bajo consumo

Las vistas previas cargan a 1200 px en lugar de resolución completa — ahorra ancho de banda. Toggle en el menú de usuario.