Русский · English · Español · Français · Deutsch
sont généralement stockés sous forme de fichiers JPEG classiques avec une projection équirectangulaire et un rapport hauteur/largeur de 2:1. Le haut de l’image correspond au zénith, le milieu à l’horizon et le bord inférieur au nadir, c’est-à-dire le point strictement en dessous de la caméra.
Après la prise de vue, c’est au nadir qu’il reste souvent un trépied, l’ombre du photographe ou une zone mal cousue. Il peut être fermé par une plaque ronde portant le nom de l’entreprise, l’adresse du site Internet ou le logo. Cependant, la simple superposition d’un cercle au bas d’un JPEG rectangulaire ne convient pas : lors de la visualisation d’un panorama, une telle image sera fortement déformée. Nous avons besoin d’une rétroprojection qui tienne compte de la géométrie de la sphère.
Dans cet article, nous analyserons l’application web « Signature Nadir pour les panoramas ». Il charge un JPG sphérique, affiche un aperçu interactif à 360°, projette correctement la signature circulaire au bas de la sphère et enregistre le nouveau JPEG. Tout le traitement est effectué localement dans le navigateur : le panorama original n’est pas envoyé au serveur.
Fonctionnalités de l’application
- chargeant JPG ou JPEG en faisant glisser ou en utilisant la boîte de dialogue de sélection de fichier ;
- vérifiant la taille maximale du fichier et le rapport hauteur/largeur du panorama 2:1 ; Signature textuelle
- jusqu’à 60 caractères ;
- ajustant la couleur, la transparence et le rayon de coin de la matrice ;
- ; Rotation du
- avec la souris ou le doigt et modification du champ de vision avec la molette ; Transition rapide
- avec un coup d’œil au nadir ; Traitement d’image
- en résolution originale ;
- enregistre les commentaires EXIF, GPS, XMP, IPTC et JPEG ; Résultat du téléchargement
- avec suffixe
_nadir.jpg.
Pourquoi le nadir semble inhabituel sur le JPEG original
Dans une projection équirectangulaire, la coordonnée horizontale spécifie la longitude et la coordonnée verticale spécifie la latitude de la sphère. Une rotation complète de 360° occupe toute la largeur de l’image, et une plage du zénith au nadir de 180° occupe toute la hauteur.
Le point nadir est le seul point de la sphère, mais dans un balayage rectangulaire, il s’étend sur toute la bordure inférieure de l’image. Par conséquent, le cercle que le spectateur devrait voir en dessous de lui se transforme en une bande caractéristique avec une distorsion non linéaire. Après avoir replié l’image en sphère, cette bande redevient un cercle.
Pour le pixel du panorama original, les coordonnées sphériques sont utilisées :
longitude = x / width × 2π − π
latitude = π/2 − y / height × π
Au bas de l’image, la distance angulaire au nadir est calculée. S’il est inférieur au rayon sélectionné, le pixel se voit attribuer un point sur un bloc circulaire.
Architecture du projet
L’application est écrite en React et TypeScript. L’interface est en app/page.tsx, styles-dans app/globals.csset les métadonnées de la page sont dans app/layout.tsx.
La logique principale est divisée en quatre parties : Chargement et vérification JPEG
- ;
- création d’un bloc rond avec texte ; Aperçu WebGL interactif
- ;
- en pleine résolution via Canvas 2D.
L’application n’a pas besoin d’une base de données serveur. Une fois la page chargée, les opérations sur les photos sont effectuées par l’API du navigateur.
Chargement et vérification du panorama
L’application accepte les fichiers de type MIME image/jpeg ou extension .jpg/.jpeg. Le fichier est ensuite lu arrayBuffer(), et ses dimensions sont déterminées à l’aide createImageBitmap().
Vérifie le rapport largeur/hauteur :
abs(width / height − 2) ≤ 0,035
De petites tolérances permettent d’obtenir des panoramas qui diffèrent du 2:1 idéal de quelques pixels. La limite de l’interface est de 250 Mo par fichier. La limite réelle dépend également de la quantité de mémoire, de l’implémentation de Canvas et de la taille maximale de la texture WebGL dans un navigateur particulier.
Formation des matrices
Fonction makeBadge() crée un canevas carré de 1800 × 1800 pixels. Il représente :
Cercle
- de couleur et de transparence sélectionnées ; Contour blanc
- ;
- au centre.
La taille de la police diminue de 280 à 60 pixels jusqu’à ce que la ligne corresponde à 80 % de la largeur du cercle. Grâce à cela, une adresse courte s’affiche en grand et une signature longue est automatiquement mise à l’échelle.
Visualisation interactive via WebGL L’aperçu
ne modifie pas le JPEG d’origine. Il utilise deux textures : Panorama
- ; Matrice créée par
- .
Le vertex shader affiche deux triangles sur l’ensemble du canevas. Le fragment shader crée un rayon de caméra virtuelle pour chaque pixel de l’écran, applique une rotation horizontale et verticale, puis traduit la direction du rayon en coordonnées de texture équirectangulaires.
Si la direction se situe à l’intérieur du rayon angulaire spécifié à partir du nadir, le shader calcule les coordonnées du pixel correspondant du solide et le mélange avec le panorama, en tenant compte du canal alpha.
Cette approche est pratique pour la visualisation : le GPU recalcule rapidement l’image lors de la rotation et de la mise à l’échelle. Si le panorama dépasse
Appareil vidéo MAX_TEXTURE_SIZE , une petite copie est créée pour l’aperçu. Cela ne réduit pas le fichier résultant – le traitement final est effectué séparément à la résolution d’origine.
Traitement final via Canvas 2D
Après avoir cliqué sur « Appliquer et télécharger JPG », l’application crée un canevas de la taille du panorama original et y copie la photo. Ce n’est pas tout le cadre qui est traité, mais seulement la bande inférieure, dans laquelle la plaque nadir peut se trouver physiquement :
stripHeight ≈ imageHeight × radius / 180
Pour chaque coordonnée horizontale, le sinus et le cosinus de la longitude sont calculés à l’avance. Cela élimine les calculs trigonométriques répétés dans la boucle principale.
Pour chaque pixel de la bande inférieure, l’algorithme :
- trouve la distance angulaire jusqu’au nadir ;
- ignore les pixels en dehors du rayon sélectionné ;
- convertit la distance sphérique en coordonnées radiales de la matrice via le rapport tangentiel ;
- trouve le pixel du dé ; Le
- mélange les canaux RVB d’une image et les solides à l’aide d’un canal alpha.
Périodique setTimeout(..., 0) redonne le contrôle à la boucle d’événements du navigateur. Cela permet à l’interface de mettre à jour la barre de progression et de ne pas apparaître complètement figée lors du traitement d’une grande image.
Enregistrement des métadonnées JPEG
Appel normal canvas.toBlob("image/jpeg") réencode l’image, mais perd les métadonnées d’origine. Ainsi, avant le traitement, l’application lit la structure JPEG et enregistre les segments :
- APP1 – généralement EXIF et XMP ;
- APP2 – profils étendus et données de service ;
- APP13 — IPTC/Photoshop metadata;
- COM – Commentaires JPEG.
Après avoir codé le résultat, les segments stockés sont insérés immédiatement après le marqueur SOI FF D8. En conséquence, EXIF, GPS et XMP sont transférés dans le fichier fini.
Il convient de garder à l’esprit qu’il s’agit d’un transfert soigné de blocs sources et non d’un éditeur de métadonnées à part entière. Les dimensions de l’image dans certains champs personnalisés rares peuvent rester les mêmes, bien que dans cette application, la largeur et la hauteur du résultat soient généralement les mêmes que l’original.
Confidentialité
La photo est traitée localement. File, ImageBitmap, Canvas, WebGL et l’URL de l’objet n’existent que dans le navigateur de l’utilisateur. Il n’y a pas de code pour envoyer l’image via fetch, formulaires ou API serveur.
Ceci est particulièrement important pour les panoramas avec coordonnées GPS : les métadonnées ne sont pas transférées à l’application sur le serveur, mais sont enregistrées dans le résultat téléchargé. Si le fichier final doit être publié, le GPS doit être supprimé à l’aide d’un outil séparé si nécessaire.
Exécuter un projet localement
Nécessite Node.js version 22.13 ou ultérieure.
npm ci
npm run dev
Après le lancement, vous devez ouvrir l’adresse spécifiée par Vite dans le terminal. Pour vérifier la version de production :
npm run build
npm run start
Commandes supplémentaires :
npm test
npm run lint
Les détails sont dans le fichier INSTALL.md, joint à l’archive.
Limites pratiques
- Seul JPEG est pris en charge, PNG et TIFF ne sont pas acceptés.
- Nécessite un panorama sphérique complet d’environ 2:1.
- Le JPEG final est réencodé avec une qualité de 0,95, il ne sera donc pas un peu identique à l’original.
- Les très grandes images nécessitent beaucoup de RAM : Canvas stocke les pixels non compressés et 20 000 × 10 000 RGBA occupent environ 800 Mo pour un seul tampon.
- Pendant le traitement, le navigateur mobile peut fermer l’onglet en raison d’un manque de mémoire.
- Le texte est dessiné dans la police système Arial/Helvetica ; Le téléchargement séparé des polices de marque n’est pas mis en œuvre.
Améliorations possibles
Le projet peut être étendu en chargeant un logo transparent, en choisissant une police, en le traitant dans Web Worker, en traitant en mosaïque de fichiers volumineux et en exportant sans nouvelle compression JPEG. Pour un usage professionnel, il est utile d’ajuster l’épaisseur du trait, les pré-motifs et de supprimer le GPS à l’aide d’un interrupteur séparé.
Déjà dans sa forme actuelle, l’application résout le problème principal : elle permet d’ajouter la légende correcte au nadir d’un panorama sphérique sans installer d’éditeur de bureau, de vérifier le résultat dans la visionneuse interactive et de télécharger le JPG fini sans transférer la photo vers un serveur tiers.