Ultra Wide est une application iPhone en SwiftUI qui produit les champs 0,5×, 0,75×, 1×, 1,5× et 2× avec l’objectif principal physique. Un téléobjectif physique peut aussi être choisi quand l’iPhone en possède un ; les cadrages proposés dépendent de sa focale et de la couverture réalisable. Pour les champs déjà couverts par l’objectif, l’application prend directement une photo native. Pour les champs plus larges, elle compose une image à partir d’un balayage continu.
- Choisir l’objectif et le cadrage. L’aperçu est déjà actif : pointer le centre de la scène et toucher le bouton rond. Aux champs 1×, 1,5× et 2× sur le capteur principal, une seule photo est prise, sans assemblage.
- Balayer librement, dans n’importe quel ordre. Le petit cadre ambre représente le champ instantané de l’iPhone dans le cadre final. Un aperçu assemblé se construit pendant la prise de vue ; les zones colorées correspondent aux images dont l’alignement a été vérifié. Une flèche indique la zone manquante la plus proche et une vibration discrète confirme les gains de couverture. Si une image est trop sombre, le mouvement trop rapide ou l’alignement impossible, un message explique le blocage.
- La capture s’arrête automatiquement lorsque les dernières images sont enregistrées et alignées, et couvrent tout le cadre, bords et coins compris. Le moteur réutilise alors les transformations préparées pour les raccords, la fusion et l’export final. Le bouton rond permet aussi d’arrêter plus tôt. Choisir Continuer pour compléter le même balayage, ou Utiliser le champ capturé lorsqu’un cadre légèrement réduit et entièrement couvert est disponible. Le recadrage proposé est indiqué par un contour en pointillés ; il conserve le format portrait ou paysage. Le champ demandé n’est jamais réduit automatiquement.
- Examiner le résultat, l’enregistrer dans Photos, dans l’album Ultra Wide, ou le partager. Le pincement et le double toucher permettent d’inspecter le fichier final en pleine résolution, sans agrandir seulement la miniature. Une session interrompue peut être reprise après réalignement de la vue centrale.
Avant la capture, toucher l’aperçu pour choisir le point de mise au point et de mesure de lumière. Le bouton ± de la barre d’outils affiche la correction d’exposition de −2 à +2 IL, avec remise à zéro ; son symbole est plein tant qu’une correction est appliquée. Le dernier réglage est appliqué avant la prise de vue ; ces contrôles sont verrouillés pendant le balayage pour garder une exposition et une mise au point constantes entre les images.
La caméra choisie reste la même pendant tout le balayage. Le résultat est un assemblage géométrique en projection rectilinéaire, avec sélection des raccords, harmonisation et fusion multibande. Si les images ne se recouvrent pas assez ou si le cadrage demandé n’est pas couvert, l’application conserve la session afin de compléter les zones manquantes. Le zoom natif cadre les photos prises en une seule fois ; un recadrage local complète ce zoom uniquement si l’appareil ne peut pas atteindre le facteur demandé.
Avant le balayage, le menu Éclairage (ampoule de la barre d’outils, pleine en mode manuel) permet de conserver Auto (région) ou de choisir 50 Hz / 60 Hz. La durée de pose et l’ISO sont fixés avant la première image, en conservant la luminosité mesurée par la caméra. La durée intègre des cycles entiers de lumière électrique lorsque les limites du capteur le permettent. Les lampes à modulation indépendante du secteur peuvent encore produire des bandes ; ce réglage ne prétend pas détecter leur fréquence.
Le bouton engrenage ouvre les réglages depuis la caméra, l’aperçu du résultat ou l’écran d’indisponibilité. La section Icône de l’app propose l’icône originale et trois variantes : Ambre, Aurore et Graphite. Toucher une icône l’applique sur l’écran d’accueil ; l’originale reste disponible. Le choix actif est relu auprès d’iOS et un échec de changement est signalé sans modifier la sélection affichée.
La grille de cadrage et le retour haptique sont mémorisés entre les lancements. Les vibrations passent par l’API SwiftUI sensoryFeedback et respectent ce réglage. La grille est désactivée par défaut ; les vibrations sont activées. Le réglage Éclairage est également accessible ici avant une nouvelle capture. Les réglages ne sont pas accessibles pendant le balayage ou l’assemblage.
La section Image de sortie propose une Résolution maximale de 4, 8, 12, 16, 24 ou 48 MP, mémorisée entre les lancements, avec 16 MP par défaut. Elle s’applique aux prochaines photos directes et aux prochains assemblages, pour l’enregistrement dans Photos comme pour le partage. Les photos directes sont réduites après leur éventuel recadrage si elles dépassent ce plafond. Les images plus petites ne sont jamais agrandies. L’assemblage peut produire une résolution inférieure selon le détail des sources et la mémoire disponible ; les résolutions élevées peuvent augmenter son temps de calcul et la taille du fichier. Changer ce choix depuis l’aperçu d’un résultat ne modifie pas le fichier déjà produit.
Les variantes conservent les calques vectoriels Icon Composer. Après une modification de l’icône principale, python3 scripts/generate_icon_variants.py régénère les variantes et leurs aperçus avec le moteur d’Icon Composer fourni par Xcode. En Debug, les arguments de lancement -ui-camera-preview, -ui-exposure-preview, -ui-sweep-preview, -ui-crop-preview, -ui-review-preview et -ui-settings-preview affichent chaque écran dans le simulateur sans caméra ; -ui-landscape les fait pivoter en paysage.
L’interface est en français et en anglais. Les textes sont gérés par des String Catalogs Xcode (UltraWide/Localizable.xcstrings et UltraWide/InfoPlist.xcstrings) : l’anglais est la langue source et la langue de repli, le français est une traduction complète. iOS choisit la langue selon les préférences de l’iPhone ou le réglage de langue propre à l’app ; les nombres (« 0,5× », « 3 072 × 2 048 px », pourcentages) suivent le format régional. Un nouveau texte de l’interface s’écrit en anglais dans le code (Text("…"), String(localized:) ou LocalizedStringResource) ; Xcode l’ajoute au catalogue lors de la compilation, où il reste à traduire en français.
- Xcode 27, SDK iOS 27, cible minimale iOS 26, iPhone avec caméra arrière.
- Ouvrir UltraWide.xcodeproj, sélectionner la cible UltraWide et une équipe de signature pour l’installation sur iPhone.
- Le framework OpenCV 4.13.0 pour iPhone est fourni dans
ThirdParty/OpenCV. Sa provenance, sa licence Apache 2.0 et la commande de préparation figurent dans ThirdParty/OpenCV/README.md. - Le simulateur permet de compiler et de lancer l’interface, mais ne peut ni capturer avec une caméra arrière physique ni exécuter l’assembleur iPhone.
xcodebuild -project UltraWide.xcodeproj -scheme UltraWide \
-configuration Debug -destination 'generic/platform=iOS' \
CODE_SIGNING_ALLOWED=NO buildLes tests de planification, de couverture polygonale, de suivi Vision et d’assemblage progressif se lancent avec xcodebuild test sur un simulateur iOS 26 ou plus récent. Ils incluent un balayage synthétique incliné avec de vraies images et le moteur Vision, ainsi que les interruptions et la vidange des tâches de capture. UltraWideTests/test_stitch_projection.py rejoue deux balayages synthétiques avec OpenCV 4.13. python3 UltraWideTests/test_blend_sampling.py compile et teste directement l’interpolation native des raccords avec le compilateur C++ local. Sur iPhone, NativeStitchIntegrationTests vérifie l’export HEIF, PreparedStitchIntegrationTests vérifie la réutilisation des transformations sans recalcul SIFT et CameraPipelineIntegrationTests vérifie le flux de la caméra. Les tests d’export OpenCV sont sautés sur simulateur. La qualité et les délais des captures réelles doivent être validés sur plusieurs iPhone avant diffusion.
L’argument de lancement -capture-diagnostics active, y compris en Release, des mesures locales dans la console : sélection, encodage, écriture, alignement, étapes d’export, mémoire, état thermique et retard du thread principal. Les mesures ne contiennent pas de pixels. Sans cet argument, aucune mesure périodique n’est lancée. Pour observer un balayage physique, lancer l’app avec devicectl device process launch --console et garder l’iPhone déverrouillé.
python3 UltraWideTests/test_parallel_render.py vérifie sur macOS le répartiteur du rendu natif : tuiles partielles, ordre des images, limite de concurrence et propagation des erreurs. python3 UltraWideTests/test_render_support.py vérifie que l’exclusion des tuiles sans contribution conserve les mêmes pixels, y compris aux bords interpolés des raccords et dans les zones encore sans source. Le rendu utilise jusqu’à quatre tâches simultanées sur des tuiles distinctes, à résolution inchangée.
python3 UltraWideTests/test_linear_blend.py vérifie directement les opérations natives de couleur : énergie lumineuse des mélanges, précision après 96 recouvrements et encodage en place, avec les sanitizers mémoire. Sur macOS avec opencv-python-headless 4.13, python3 UltraWideTests/test_native_blend_plan.py compile les fonctions C++ de raccords et de correction de UWStitcher.mm contre les en-têtes du projet et les exécute avec la bibliothèque OpenCV du module Python. Un mur uniforme, vu sous deux inclinaisons et expositions différentes, doit conserver sa couleur jusque près des bords. Le test iPhone correspondant vérifie également le fichier HEIF produit.
- Les images source sélectionnées dans le flux sont conservées localement jusqu’à l’enregistrement du résultat ou l’abandon de la session. L’application ne transmet pas d’images à un serveur. Les sources et les résultats en cours d’examen sont exclus des sauvegardes iCloud ; un résultat non enregistré et les tampons temporaires d’un assemblage interrompu sont supprimés au lancement suivant.
- Le flux continu conserve au plus 60 fichiers sources ; atteindre cette limite ne termine pas la capture. Les nouvelles vues remplacent les anciennes les moins utiles, en protégeant le centre, les quatre vues les plus récentes et la connexion entre les images alignées. La sélection privilégie les vues redondantes ou non alignées pour limiter la perte de couverture. Le champ vidéo réellement livré, y compris son ratio, sert à calculer la couverture ; il est souvent plus étroit qu’une photo 4:3. Un cadrage téléobjectif qui demanderait un balayage trop long n’est pas proposé.
- La sélection analyse directement une petite grille de luminance du buffer vidéo, hors du fil de l’interface et indépendamment de la compression. Une file bornée à trois buffers compresse et enregistre les images en arrière-plan. La sélection peut se réessayer toutes les 33 ms et accepte une vue peu détaillée dès la première image utile. Le balayage tolère une inclinaison de 20° et une vitesse de 2,4 rad/s. Les vues utiles sont prises dès environ 12 % de déplacement du champ. La position associée à chaque image est interpolée à son horodatage de prise de vue. L’exposition, la mise au point et la balance des blancs restent fixes pendant un passage. Le premier buffer conservé doit avoir reçu ces réglages. L’aperçu utilise une cadence de 25 ou 30 images/s lorsque le format le permet ; la vidéo SDR évite les bascules automatiques d’EDR.
- Un acteur séparé aligne progressivement des miniatures de 640 pixels maximum avec Vision. Les mouvements servent d’estimation initiale ; la corrélation des images et des zones de détail valide ensuite chaque transformation. Une recherche locale sur les gradients vérifie aussi les contours : un décalage d’un pixel sur la miniature peut devenir visible à l’export malgré une forte corrélation globale. Les contrôles portent aussi sur les moitiés de l’image pour détecter une parallaxe localisée sans rejeter le rééchantillonnage sous-pixel normal. Lorsque Vision et l’estimation initiale passent ces contrôles, le moteur conserve celle qui correspond le mieux aux images originales pour éviter d’accumuler des corrections inutiles. Le candidat est contrôlé contre les autres vues voisines qui le recouvrent pour limiter la dérive entre images successives. Une union exacte des empreintes polygonales prend en compte la perspective, l’inclinaison et les petits trous de couverture. Une vue non alignée ne remplit pas le cadre. Ses sources sont conservées pour une nouvelle tentative si une vue intermédiaire arrive. Les vues alignées devenues redondantes peuvent être retirées sans perdre de couverture ni de recouvrement. Un aperçu provisoire est rendu avec Core Image ; la capture continue indépendamment de ce travail.
- Les recouvrements alignés servent également à estimer une correction robuste de luminance en lumière linéaire, en excluant les pixels noirs ou saturés. Le gain combine les mesures des voisins vérifiés ; lorsqu’il ne peut pas être mesuré, la correction de la référence est conservée. Le même gain scalaire est appliqué à l’aperçu et à l’export pour conserver la teinte. L’export projette et mélange des couleurs linéaires sur 16 bits avant l’encodage Display P3 final. La pyramide multibande utilise des bords de couleur réfléchis et des masques de couverture séparés pour éviter l’assombrissement dû aux pixels hors image. Sa correction résiduelle est un gain de luminance borné à ±0,25 EV, sans décalage indépendant des canaux RGB. Le tampon linéaire mappé sur disque est compacté en place pour l’encodage HEIF. Les bords de l’aperçu sont adoucis ; une correction globale ne peut pas réparer des bandes déjà présentes à l’intérieur d’une image.
- Les miniatures décodées et leurs plans de luminance sont conservés pendant la capture, y compris pour les images à réessayer. Une estimation initiale déjà vérifiée avec une corrélation d’au moins 0,985 et un accord local d’au moins 0,98 évite une nouvelle recherche Vision. La recherche des décalages de contours s’arrête dès que son résultat est certain, avec les mêmes seuils de rejet. La sérialisation du manifeste se fait sur la file d’écriture pour libérer le fil de l’interface.
- L’union exacte des empreintes calcule en un seul passage la surface propre à chaque vue. La suppression des sources redondantes et la libération de place à la limite des 60 fichiers réutilisent ces surfaces, sans recalculer toute la couverture pour chaque candidate. Pendant le mouvement, le gain d’une vue est mesuré sur son empreinte seule. L’aperçu conserve les valeurs flottantes en lumière linéaire de Core Image et est complété avec les nouvelles vues ; il est reconstruit lorsqu’une source est retirée, que l’ordre change ou que le cadre change. À l’export, les tuiles sans contribution aux raccords sont ignorées uniquement si leurs pixels disposent déjà d’une vraie source ; les contrôles de couverture et la résolution sont conservés.
- À l’arrêt, seules les dernières écritures et vérifications encore en attente sont vidées. Les alignements et gains préparés sont réutilisés directement pour le rendu final OpenCV, sans nouvelle recherche SIFT ni estimation globale des caméras. Les sessions anciennes dépourvues d’alignements préparés conservent le chemin d’assemblage complet. L’aperçu progressif n’est pas la fusion finale : les raccords et l’export restent à effectuer. Les raccords sont calculés avec une résolution adaptée au nombre de sources, puis interpolés dans les deux axes à chaque pixel de sortie pour éviter les transitions en blocs.
- La carte de guidage est calculée hors de l’interface. Lorsqu’une source est retirée à la limite des 60 fichiers, elle est recalculée à partir des empreintes vérifiées restantes sans attendre la file d’alignement. Les vues rejetées ne sont retentées que lorsque leurs références voisines changent. Dès qu’une couverture complète est vérifiée, la sélection cesse d’ajouter des images pour permettre de vider les tâches en attente ; elle reprend si leur vérification révèle un manque. Un recadrage ne peut être proposé qu’à partir d’au moins deux empreintes vérifiées, avec une marge de sécurité et sans trou intérieur. Les matrices existantes sont replacées dans ce nouveau champ ; les contrôles de couverture du moteur natif restent actifs à l’export. Les gros manques demandent de continuer la capture.
- Le résultat apparaît d’abord avec sa miniature ; ImageIO décode ensuite le fichier original en arrière-plan, en appliquant son orientation. Le visualiseur UIKit conserve la position du zoom pendant ce chargement et permet d’atteindre les pixels natifs. Le fichier conservé dans Photos ou partagé reste celui de l’export.
- L’assembleur ajuste sa résolution de sortie selon le plafond choisi (16 MP par défaut), le détail des sources et la mémoire de l’appareil (20, 32 ou 48 MP maximum selon l’iPhone). Les assemblages sont des HEIF SDR en Display P3 ; les données HDR étendues et ProRAW ne sont pas conservées. Les photos directes utilisent le format HEIF natif lorsque l’iPhone le permet, avec JPEG en secours ; leur résolution native dépend du format de capture disponible.
- Les images d’entrée proviennent du flux vidéo : chacune peut être moins détaillée qu’une photo fixe haute résolution. La couverture du capteur principal et le recouvrement entre vues compensent partiellement cette limite dans l’image finale.
- La scène doit présenter suffisamment de détails communs entre les vues. Un sujet en mouvement, une rotation autour d’un autre point que l’iPhone ou un premier plan très proche peut rendre l’assemblage difficile.
UltraWide/Capture: caméra AVFoundation en continu, guidage Core Motion, couverture et reprise.UltraWide/Stitching: moteur OpenCV natif et interface Swift.UltraWide/UI: interface SwiftUI (barres d’outils natives, Liquid Glass), cadre de couverture, prise de vue et examen du résultat.UltraWideTests: tests de cadrage, de couverture et de projection OpenCV synthétique.