1. Démarrer
Iris-Editor est une application web avec un pipeline en quatre étapes :
- Téléverser une photo — JPG ou PNG, toute taille
- Extraire l'iris — par IA, en arrière-plan automatiquement
- Modifier l'iris — 11 réglages pour exposition, couleur, netteté, forme
- Créer l'œuvre — le style choisi est rendu sur l'iris
À chaque étape tu peux télécharger le résultat intermédiaire ou passer à l'étape suivante.
Astuce : Lors de ta première connexion, un iris d'exemple est ajouté automatiquement à ta bibliothèque. Tu peux ainsi tester le flux sans devoir téléverser une photo personnelle.
Prérequis
- Un navigateur récent (Firefox, Chrome, Safari, Edge — deux dernières versions)
- Une PurchaseID valide (chapitre suivant)
- Une connexion internet — les étapes IA tournent côté serveur
2. Connexion
Iris-Editor n'utilise pas de mot de passe mais une PurchaseID permanente. Tu la reçois lors de l'achat sur pureirisart.com.
Se connecter
- Ouvre
https://editor.pureirisart.com - Saisis ta PurchaseID (majuscules, sans espace)
- Clique sur Se connecter
Si tu arrives via un lien dans un mail de confirmation, l'ID est remplie automatiquement (?pid=TON_ID).
Que se passe-t-il après la connexion ?
Tu arrives dans le Studio. À la première connexion, l'iris d'exemple est déjà dans ta bibliothèque et la visite guidée démarre automatiquement pour te présenter les éléments principaux. Tu peux la relancer à tout moment via l'icône de la barre supérieure.
À noter : Ta PurchaseID n'expire jamais. Les photos téléversées et iris extraits sont supprimés automatiquement après 30 jours ; les œuvres terminées également 30 jours après leur création. Télécharge à temps ce qui compte.
3. Téléverser une photo
Dans le Studio, en haut à gauche se trouve le bouton de téléversement (ou glisse-dépose une photo dans la zone de bibliothèque). Plusieurs fichiers à la fois acceptés.
Quelles photos conviennent ?
- Format : JPG ou PNG. Taille max ~50 Mo
- Résolution : idéalement au moins 3000 × 2000 px — l'IA a besoin de détail pour extraire proprement
- Sujet : un œil net avec iris bien visible, pas un portrait pris à trois mètres
- Éclairage : aussi homogène que possible, sans ombres dures sur l'iris
Pendant le téléversement
Chaque photo reçoit une petite carte dans la colonne de gauche. Pendant l'extraction de l'iris une barre de progression s'affiche — typiquement 30–60 secondes par photo. Tu peux pendant ce temps modifier d'autres iris ou en téléverser d'autres.
Noms de fichier
Le nom de fichier d'origine est conservé et sert ensuite à nommer les téléchargements. Tu peux le changer à tout moment : clic droit (ou icône crayon) sur la carte. Pratique quand ton smartphone donne des noms comme IMG_8421.jpg — renomme-le en Sarah et toutes les sorties porteront ce nom.
4. Extraction de l'iris
Le détourage de l'iris se fait totalement en arrière-plan. Dès que la carte passe en terminé, l'iris extrait est disponible en PNG 4000 × 4000 pixels avec couche alpha.
Que montre l'iris extrait ?
- Uniquement l'iris — pupille, sclère et paupière sont détourées
- Fond blanc ou transparent selon le style (voir Éditeur)
- Sans flou de bougé ni artefacts de cils — l'IA s'en charge
En cas d'échec
La carte affiche un badge rouge « Erreur ». Causes les plus courantes :
- Iris trop petite ou floue dans la photo — téléverser une nouvelle photo
- API serveur temporairement indisponible — relance via l'icône de réessai sur la carte
- Fichier corrompu — vérifie l'original, ré-exporte si besoin
Le réessai est un clic sur l'icône flèche-en-cercle de la carte. L'extraction redémarre sans nouveau téléversement.
5. Éditeur
Dans le Studio tu ouvres une iris en cliquant dans la bibliothèque à gauche, puis tu vas sur l'onglet Modifier. L'éditeur affiche un curseur avant/après au centre et un panneau à droite avec les 11 réglages.
Les 11 réglages
| Réglage | Ce qu'il fait | Quand l'utiliser |
|---|---|---|
| Exposition | Hautes lumières et tons moyens ensemble | Récupérer une photo sur/sous-exposée |
| Luminosité | Luminosité globale, linéaire | Éclaircir/assombrir toute l'iris |
| Contraste | Écart entre ombres et lumières | Faire ressortir le détail |
| Saturation | Intensité des couleurs | Raviver des iris ternes |
| Température | Balance des blancs, froid vs chaud | Corriger une dominante |
| Correction brun | Atténue la pigmentation brune | Sauver le contraste sur iris très sombre |
| Netteté | Netteté des bords | Une touche avant l'impression |
| Recadrage / marge | Recadrage + marge autour | Centrer l'iris ou laisser de l'air |
| Taille de pupille | Mise à l'échelle de la pupille | Montrer plus de surface d'iris |
| Détourage iris | Coupe circulaire dure au bord | Iris ronde nette, sans sclère résiduelle |
| Bords doux | Bord anti-aliasing doux | Iris plus douce, sans coupe dure |
Double-clic sur le libellé d'un réglage le remet à la valeur par défaut. Les flèches ← → ajustent le réglage actif par petits pas.
Fond transparent
Le toggle Fond transparent retire le fond blanc de l'extraction par chroma-key. Activé par défaut car la plupart des styles attendent une iris avec couche alpha.
Désactive-le seulement si tu veux télécharger l'iris en PNG RGB avec fond blanc.
Préréglages
Une fois trouvée une combinaison de réglages qui te plaît, tu peux la sauvegarder en préréglage (icône disquette en haut à droite). Le préréglage reçoit un nom, est global pour ton compte et applicable à toute autre iris.
Le menu de préréglages affiche les tiens — un clic en applique un à l'iris en cours. Les valeurs non concernées (p. ex. taille de pupille) sont écrasées par le préréglage ; tu peux ajuster ensuite.
Reflet
Point lumineux optionnel (reflet) à poser sur l'iris. Forme, position, taille, intensité, rotation sont réglables séparément. Active-le via le toggle Reflet, les réglages associés apparaissent.
Enregistrer
Le bouton vert Enregistrer écrit les valeurs courantes comme variante edited de l'iris. L'éditeur se ferme, dans le Studio tu vois la nouvelle variante dans la bibliothèque. Enregistrer à nouveau écrase — il y a toujours UNE seule version edited par iris.
La variante extracted d'origine reste intacte. Dans le sélecteur de styles tu choisis si un style est appliqué sur la version extracted brute ou sur l'edited.
6. Studio — l'interface centrale
Le Studio est une vue maître-détail : à gauche la bibliothèque de toutes tes iris, à droite la vue détail de l'iris sélectionnée avec quatre onglets.
Les onglets
- Aperçu — original, extract, edit côte à côte ; boutons de téléchargement ; informations de statut
- Modifier — l'éditeur (chapitre 5)
- Styles d'art — le sélecteur de styles (chapitre 7)
- Variantes — toutes les œuvres générées à partir de cette iris (chapitre 8)
Bibliothèque (gauche)
Chaque iris est une carte avec miniature, badge de statut et date. Tri modifiable en bas (nom/date, asc/desc). Filtre de recherche pour les longues listes via la loupe.
Barre supérieure
- Activité — indicateur des rendus en arrière-plan
- Crédits — quota restant (vient du shop, non géré ici)
- Tour — relance la visite guidée
- Menu utilisateur (droite) — mode économique, langue, déconnexion, éventuellement Événements
Mode économique
Dans le menu utilisateur, un toggle Mode économique. Activé, la bibliothèque et les aperçus se chargent en 1200 px au lieu de la pleine résolution. Économise de la bande passante — utile en mobile ou Wi-Fi faible. L'éditeur et les téléchargements gardent la pleine résolution.
Langue
Quatre langues : DE, EN, ES, FR. Changement via le menu utilisateur. Choix mémorisé dans le compte, valable sur tous les appareils.
7. Choisir et créer des styles d'art
L'onglet Styles d'art affiche tous les styles disponibles en tuiles, regroupées par nombre d'iris : 1, 2, 3, 4 ou 5 iris par composition.
Styles à une iris
Pour les styles à 1 iris un clic sur la tuile suffit. Une petite modale d'aperçu s'ouvre où tu peux voir le style sur ton iris (sans crédits consommés, juste un aperçu). Confirmer lance le rendu réel.
Styles multi-iris
Les styles 2–5 iris ouvrent un sélecteur multi-iris. Tu choisis dans ta bibliothèque les iris pour les emplacements 1, 2, 3 etc. Conditions :
- Chaque emplacement a besoin d'une version edited avec fond transparent — sinon le endpoint ne peut pas composer
- Pas de doublon — chaque iris ne peut figurer qu'une seule fois par composition
- L'ordre compte : l'emplacement 1 est généralement l'iris « principale »
Réordonner : glisser-déposer en bureau, tap-to-swap en mobile (touche emplacement A puis B — ils s'échangent).
Envoi par lot (plusieurs styles à la fois)
Tu peux sélectionner plusieurs tuiles à la fois (case en haut à gauche de chacune). Une barre d'action apparaît en haut et en bas avec le nombre sélectionné + bouton Envoyer. Clic → tous tournent séquentiellement.
Si un style a déjà été rendu pour cette combinaison d'iris, un avertissement de doublon apparaît avant toute consommation de crédits — tu choisis quoi écraser.
Pendant le rendu
L'indicateur d'activité dans la barre supérieure monte. La tuile du style affiche un overlay de chargement. Dans l'onglet Variantes la variante apparaît en placeholder avec statut ; une fois prête l'overlay disparaît et l'aperçu est visible.
8. Gérer les variantes
Dans l'onglet Variantes tu vois toutes les œuvres rendues de l'iris courante en tuiles. En bas à droite de chaque variante quatre icônes :
- 📐 Recadrage — éditeur de recadrage
- T Texte — éditeur de texte (chapitre 9)
- ⬇ Téléchargement — en JPG/PNG
- 🗑 Supprimer — vers la corbeille
Recadrage
Dans la modale tu tires la zone à la souris. Déplace avec les flèches en pas de 2 px, maintiens Maj pour 20 px.
Préréglages d'aspect-ratio intégrés : 1:1 (carré), 2:3 (photo classique), 3:4 (poster portrait). Réinitialiser retire le recadrage.
Les recadrages sont non destructifs — ils n'écrasent pas l'original, ils sont appliqués dynamiquement à chaque téléchargement.
Texte
Détaillé au chapitre 9.
Téléchargement & ZIP
Téléchargement individuel via l'icône ⬇ de la variante. L'icône ZIP en haut empaquette toutes les variantes sélectionnées dans un seul ZIP. Sélection multiple via Maj-clic ou les cases à cocher.
Les noms suivent ce schéma :
NomOriginal_NomStyle.jpg
NomOriginal1+NomOriginal2_NomStyle.jpg (multi-iris)
Corbeille
Les variantes supprimées restent 30 jours en corbeille (onglet en bas à droite Corbeille). Jusque-là, restauration ou suppression définitive possible. Ensuite nettoyage automatique.
Liste des échecs
Si un rendu échoue, une section Erreurs apparaît dans l'onglet Variantes avec le message API. Réessayer relance un rendu — souvent suffisant si l'API était brièvement indisponible.
9. Éditeur de texte — poser de la typographie sur l'œuvre
Un clic sur l'icône T d'une variante ouvre l'éditeur de texte. Tu peux ajouter plusieurs couches de texte, les déplacer, les tourner, les colorer — l'aperçu est pixel-perfect ce qui sortira au téléchargement ou à l'impression.
Ajouter une couche
Bouton + Texte en haut à gauche. La nouvelle couche se place en haut à gauche de l'image, directement en mode édition — tape, le placeholder est remplacé. Échap ou clic en dehors termine.
Double-clic pour rééditer une couche existante. Jusqu'à 20 couches par variante.
Polices & favoris
47 Google Fonts choisies en 5 catégories :
- Script — manuscrites (Allura, Great Vibes, …)
- Display — polices de titre marquantes
- Serif — antiqua classiques
- Sans — sans empattement modernes
- Mono — chasse fixe, machine à écrire
Dans le sélecteur de polices tu peux :
- Avec les flèches ↑/↓ parcourir toutes les polices en direct (même liste fermée)
- Filtrer par recherche ou catégorie
- Marquer la police active avec l'étoile pour l'ajouter aux favoris — mémorisés dans le compte, disponibles partout
- Le filtre « Favoris » restreint la navigation par flèches à tes polices marquées
Taille, rotation, espacement
- Taille : curseur 0,5 % – 40 % de la hauteur d'image. Double-clic = réinitialiser
- Rotation : curseur –180° à +180°, plus champ numérique pour précision. Double-clic = 0°
- Espacement (letter-spacing / tracking) : –50 à 500 en 1/1000 em. Négatif = serré, positif = aéré
Ancrage (gauche / centre / droite)
Les trois icônes de la barre déterminent autour de quel point le texte s'aligne quand sa longueur change :
- Gauche — bord gauche fixe, le texte grandit vers la droite
- Centre — centre fixe, le texte grandit symétriquement
- Droite — bord droit fixe, le texte grandit vers la gauche
Important avec les variables : l'ancrage décide comment des longueurs différentes s'alignent. Exemple classique : %Filename1% peut résoudre « Anna » ou « Maximilian » — avec l'ancrage « Centre » le texte reste centré dans les deux cas.
Déplacer + verrou d'axe Maj
Glisser à la souris déplace librement la couche. Maintiens Maj et la couche reste sur une ligne droite — horizontale ou verticale selon ton mouvement principal. Pratique pour aligner plusieurs couches à la même hauteur.
Variables
Tu peux saisir des marqueurs dans le contenu, ils sont remplacés automatiquement :
| Marqueur | Remplacé par |
|---|---|
| %Filename1% | Nom de fichier original de l'iris en emplacement 1 (sans extension) |
| %Filename2% .. %Filename6% | Idem pour emplacements 2 à 6 |
| %DD.MM.YYYY% | Date du jour, format 03.05.2026 |
À la sortie du mode édition (Échap / clic dehors) le marqueur est immédiatement remplacé par la valeur réelle — tu vois directement ce qui sortira sur l'impression. À la prochaine édition, le marqueur revient pour pouvoir continuer avec les variables.
Modèles
Le pied de l'éditeur a un menu Modèle. Il permet de sauvegarder la mise en page de texte courante pour que les nouvelles variantes du même style démarrent avec ce texte.
- Enregistrer comme mon modèle — uniquement pour ta PurchaseID
- Supprimer mon modèle — retour au défaut admin
- Enregistrer comme défaut admin admin uniquement — pour tous les clients sans modèle propre
Ordre de résolution à la création d'une nouvelle variante :
- Override client (ton modèle)
- Défaut admin
- Pas de texte
Enregistrer
Enregistrer → le navigateur rend le overlay de texte final en PNG transparent à pleine résolution et l'envoie. Le serveur le compose 1:1 sur l'œuvre — l'aperçu de l'éditeur et le téléchargement sont identiques au pixel près.
10. Réglages
Le menu utilisateur (en haut à droite) contient :
- Mode économique — aperçus en 1200 px au lieu de pleine résolution. Désactivé par défaut.
- Langue — DE / EN / ES / FR. Effet immédiat, valable sur tous les appareils.
- Événements opérateur uniquement — gestion des événements (chapitre 11)
- Déconnexion
11. Mode événement Opérateur
Le mode événement est conçu pour les événements en direct : tu photographies les iris sur place, l'invité s'enregistre depuis son propre smartphone et, idéalement, repart avec une impression 15 × 20 cm avant même de quitter le lieu.
Nécessite que ta PurchaseID ait le flag is_event_operator = 1. Demande à l'admin si l'entrée Événements n'apparaît pas chez toi.
Créer un événement
Menu utilisateur → Événements → + Nouvel événement. Champs :
| Champ | Sens |
|---|---|
| Titre | Nom affiché sur l'affiche & la page mobile |
| Slug | Composant d'URL, unique (p. ex. mariage-mueller-2026) |
| Date / Lieu | Optionnel, affichage seulement |
| Couleur primaire | Couleur d'accent pour les boutons sur la page publique |
| Couleur de fond | Fond du body sur la page d'inscription / statut |
| URL du logo | Optionnel, en haut des pages publiques |
| Format d'impression | 15 × 20, 13 × 18 ou 10 × 15 cm |
| Rétention (jours) | Combien de temps données + rendus sont gardés |
| Styles auto-render | Liste des styles rendus automatiquement après l'enregistrement de l'éditeur |
| T-toggle par style | Par style : avec ou sans texte par défaut |
| Actif | Active la page d'inscription |
Affiche / inscription des invités
Après enregistrement la carte de l'événement apparaît dans la liste. Clic sur Copier l'URL de l'affiche donne une URL comme :
https://event.pureirisart.com/register.php?slug=<ton-slug>
Imprime cette URL en QR code et affiche-la à l'entrée de l'événement. Chaque invité scanne avec son propre smartphone, atterrit sur la page d'inscription et saisit :
- Prénom (obligatoire)
- Nom (optionnel)
- E-mail (obligatoire)
- Case RGPD (obligatoire)
- Case marketing (optionnel, lead-gen)
Après envoi, le smartphone de l'invité affiche :
- Un QR code (pour ta webcam)
- Un code à 6 chiffres (alternative si le scan ne marche pas)
Surface opérateur
Sur ton ordinateur photo, ouvre :
https://event.pureirisart.com/op.php
La page contient :
- Une zone webcam avec scanner QR actif
- Un champ code manuel + sélecteur d'événement (alternative)
- Une file d'attente avec tous les invités de tous tes événements
- Bouton ? en haut à droite — antisèche compacte avec toutes les URLs
Flux :
- L'invité présente son smartphone à la webcam → le QR est scanné → la zone de drop s'ouvre avec ses données
- Photo depuis le dossier de tethering glissée sur la zone de drop
- Téléversement + extraction d'iris en cours — l'invité voit le statut en direct sur son smartphone
- L'opérateur passe à la personne suivante, l'éditeur attend
Rendu automatique après enregistrement
Dès que l'opérateur enregistre une iris dans l'éditeur avec le toggle de transparence activé :
- L'éditeur se ferme rapidement (l'UI réagit vite)
- En arrière-plan, tous les styles auto-render de l'événement démarrent
- Pour chaque style avec flag T, le texte par défaut est appliqué automatiquement avec résolution des variables
- Les rendus apparaissent dans la file avec statut rendu en cours, puis terminé
La file en détail
| Statut | Sens |
|---|---|
| pas de photo | Invité enregistré, pas encore de photo |
| extraction | Photo téléversée, extraction IA en cours |
| à modifier | Extraction terminée, attend l'enregistrement manuel de l'éditeur. Clic sur Éditeur ouvre l'iris dans le Studio en nouvel onglet. |
| rendu en cours | Éditeur enregistré, rendu automatique en cours |
| terminé | Tous les rendus terminés |
| erreur | Nettoie avec ✕, enregistre dans l'éditeur pour re-rendre |
Chaque ligne montre nom de l'invité, titre de l'événement, nom de fichier (clic → détail Studio en nouvel onglet) et selon le statut le lien éditeur ou un bouton ✕ pour nettoyer les rendus bloqués. La file s'actualise automatiquement toutes les 15 secondes.
Après l'événement
L'envoi groupé des liens de téléchargement n'est pas encore automatique — prévu. En attendant, télécharge les rendus un par un depuis le Studio ou regroupe-les via l'export ZIP.
12. Dépannage
Connexion ne marche pas — « PurchaseID invalide »
Vérifie la PurchaseID : pas d'espaces, majuscules. Si elle est correcte, l'API de validation est peut-être brièvement injoignable — attends une minute puis réessaie. Après plusieurs échecs consécutifs l'IP est bloquée 15 min (protection anti-brute-force).
Extraction d'iris bloquée à 50 %
L'API IA a un blocage. Clique sur l'icône de réessai sur la carte de la bibliothèque — l'extraction redémarre sans nouveau téléversement.
Style multi-iris échoue avec « iris sans fond transparent »
Le slot choisi contient une iris sans fond transparent. Ouvre l'iris dans l'éditeur, active « Fond transparent », enregistre. Réapplique le style.
Position du texte dans l'éditeur ≠ position au téléchargement
Ne devrait plus arriver depuis la version 0.17.0 — le navigateur rend l'overlay en PNG, le serveur le compose 1:1. Si tu vois encore un cache ancien : touche la variante par un recadrage ou ré-enregistrement pour régénérer les caches.
Boucles des polices manuscrites coupées dans l'éditeur
Corrigé depuis 1.0.x — cache de glyphes Fabric désactivé. Si le problème persiste : recharger le navigateur, éventuellement vider le cache.
Rendu bloqué en « rendu en cours » sans avancer opérateur
Dans la file d'attente clique sur ✕ à droite de la ligne — tous les rendus bloqués de cette iris sont supprimés. Enregistre l'iris à nouveau, l'auto-trigger relance des jobs frais.
QR code invité → opérateur ne fonctionne pas opérateur
Trois causes habituelles :
- Permission webcam non accordée → vérifier la barre d'adresse, autoriser à nouveau
- Reflet / lumière insuffisante → saisir le code à 6 chiffres manuellement (choisir l'événement dans le déroulant)
- Cookie de session encore sur l'ancien sous-domaine — déconnexion, vider les cookies, reconnexion
Transfert de données entre PurchaseIDs (p. ex. après connexion avec la mauvaise)
Via le script CLI scripts/transfer_purchase.php. Voir scripts/README.md dans le repo. Toujours faire un --dry-run d'abord pour vérifier le plan, puis sans l'option.
13. Glossaire
- PurchaseID
- Identifiant permanent émis à l'achat. Seul mécanisme de connexion.
- Téléversement (Upload)
- La photo originale dans ta bibliothèque. Chaque téléversement génère des versions d'iris (extracted, edited).
- Version d'iris
- Une forme traitée de ton iris : extracted (sortie IA) ou edited (après tes ajustements).
- Œuvre / Variante
- L'image finale composée d'iris + style. Nombre quelconque de styles par combinaison d'iris, une variante par style.
- Style
- Le modèle artistique IA (p. ex. Stardust, Swirl Black). Chaque style fixe le nombre d'iris requis.
- Boîte de recadrage
- Définition de recadrage par variante. Non destructive — appliquée dynamiquement à chaque téléchargement.
- Overlay de texte
- Les couches de texte sur une variante. Le navigateur rend l'overlay en PNG, le serveur le compose sur l'œuvre.
- Modèle de texte
- Configuration prédéfinie de couches de texte par style. Appliquée automatiquement aux nouvelles variantes quand activée.
- Événement opérateur
- Conteneur de configuration pour un événement live avec son branding, ses styles par défaut et l'inscription des invités.
- Surface opérateur opérateur
- L'UI opérateur en direct sous
event.pureirisart.com/op.php— scanner webcam + zone de drop + file d'attente. - Mode économique
- Les aperçus se chargent en 1200 px au lieu de pleine résolution — économise la bande passante. Toggle dans le menu utilisateur.