Русский · English · Español · Français · Deutsch
360°-Kugelpanoramen werden normalerweise als reguläre JPEG-Dateien mit äquirechteckiger Projektion und einem Seitenverhältnis von 2:1 gespeichert. Der obere Rand des Bildes entspricht dem Zenit, die Mitte dem Horizont und der untere Rand dem Nadir, also dem Punkt genau unter der Kamera.
Nach der Aufnahme bleibt am Nadir oft ein Stativ, der Schatten des Fotografen oder ein schlecht genähter Bereich zurück. Es kann mit einer runden Plakette mit dem Firmennamen, der Website-Adresse oder dem Logo verschlossen werden. Das einfache Überlagern eines Kreises am unteren Rand eines rechteckigen JPEG ist jedoch nicht geeignet: Beim Betrachten eines Panoramas wird ein solches Bild stark verzerrt. Wir benötigen eine Rückprojektion, die die Geometrie der Kugel berücksichtigt.
In diesem Artikel analysieren wir die Webanwendung „Nadir-Signatur für Panoramen“. Es lädt ein sphärisches JPG, zeigt eine interaktive 360°-Vorschau, projiziert die kreisförmige Signatur korrekt auf den Boden der Kugel und speichert das neue JPEG. Die gesamte Verarbeitung erfolgt lokal im Browser – das Originalpanorama wird nicht an den Server gesendet.
Anwendungsfunktionen
- lädt JPG oder JPEG durch Ziehen oder Verwenden des Dateiauswahldialogs;
- prüft die maximale Dateigröße und das Panorama-Seitenverhältnis 2:1;
- Textsignatur bis zu 60 Zeichen lang;
- passt die Farbe, Transparenz und den Eckenradius des Würfels an;
- interaktiver WebGL-Panorama-Viewer;
- Drehung mit der Maus oder dem Finger und Änderung des Sichtfeldes mit dem Rad;
- schneller Übergang mit Blick auf den Nadir;
- Bildverarbeitung in Originalauflösung;
- speichert EXIF-, GPS-, XMP-, IPTC- und JPEG-Kommentare;
- Download-Ergebnis mit Suffix
_nadir.jpg.
Warum Nadir im Original-JPEG ungewöhnlich aussieht
In einer äquirechteckigen Projektion gibt die horizontale Koordinate den Längengrad und die vertikale Koordinate den Breitengrad der Kugel an. Eine volle 360°-Drehung nimmt die gesamte Breite des Bildes ein, und ein Bereich von Zenit bis Nadir von 180° nimmt die gesamte Höhe ein.
Der Nadirpunkt ist der einzige Punkt auf der Kugel, aber bei einem rechteckigen Scan erstreckt er sich über den gesamten unteren Bildrand. Daher verwandelt sich der Kreis, den der Betrachter unter sich sehen sollte, in einen charakteristischen Streifen mit nichtlinearer Verzerrung. Nachdem das Bild wieder zu einer Kugel gefaltet wurde, wird dieser Streifen wieder zu einem Kreis.
Für die Pixel des Originalpanoramas werden sphärische Koordinaten verwendet:
longitude = x / width × 2π − π
latitude = π/2 − y / height × π
Am unteren Rand des Bildes wird der Winkelabstand zum Nadir berechnet. Wenn er kleiner als der ausgewählte Radius ist, wird dem Pixel ein Punkt auf einem kreisförmigen Block zugewiesen.
Projektarchitektur
Die Anwendung ist in React und TypeScript geschrieben. Die Schnittstelle ist drin app/page.tsx, Stile – in app/globals.cssund die Seitenmetadaten sind in app/layout.tsx.
Die Hauptlogik ist in vier Teile unterteilt:
- JPEG-Laden und -Prüfung;
- Erstellung eines runden Blocks mit Text;
- interaktive WebGL-Vorschau; Endgültiges
- -Overlay in voller Auflösung über Canvas 2D.
Die Anwendung benötigt keine Serverdatenbank. Nachdem die Seite geladen wurde, werden Fotovorgänge von der Browser-API ausgeführt.
Panorama laden und prüfen
Die Anwendung akzeptiert Dateien mit MIME-Typ image/jpeg oder Erweiterung .jpg/.jpeg. Anschließend wird die Datei durchgelesen arrayBuffer()und seine Abmessungen werden anhand bestimmt createImageBitmap().
Überprüft das Verhältnis von Breite zu Höhe:
abs(width / height − 2) ≤ 0,035
Kleine Toleranzen ermöglichen Panoramen, die um einige Pixel vom idealen 2:1 abweichen. Das Schnittstellenlimit beträgt 250 MB pro Datei. Das tatsächliche Limit hängt auch von der Speichermenge, der Canvas-Implementierung und der maximalen WebGL-Texturgröße in einem bestimmten Browser ab.
Formformation
Funktion makeBadge() erstellt eine quadratische Leinwand mit 1800 × 1800 Pixeln. Es zeigt:
- Kreis ausgewählter Farbe und Transparenz;
- weißer Umriss;
- weißer Text in der Mitte.
Die Schriftgröße verringert sich von 280 auf 60 Pixel, bis die Linie 80 % der Kreisbreite ausfüllt. Dadurch wird eine kurze Adresse groß dargestellt und eine lange Signatur automatisch skaliert.
Interaktive Anzeige über WebGL Die
-Vorschau verändert das ursprüngliche JPEG nicht. Es werden zwei Texturen verwendet:
- -Panorama;
- hat einen Würfel erstellt.
Der Vertex-Shader zeigt zwei Dreiecke auf der gesamten Leinwand an. Der Fragment-Shader erstellt für jedes Pixel des Bildschirms einen virtuellen Kamerastrahl, wendet eine horizontale und vertikale Drehung an und übersetzt dann die Strahlrichtung in gleichrechteckige Texturkoordinaten.
Wenn die Richtung innerhalb des angegebenen Winkelradius vom Nadir liegt, berechnet der Shader die Koordinaten des entsprechenden Pixels des Volumenkörpers und mischt sie unter Berücksichtigung des Alphakanals mit dem Panorama.
Dieser Ansatz ist praktisch für die Anzeige: Die GPU berechnet das Bild beim Drehen und Skalieren schnell neu. Wenn das Panorama überschreitet
Beim MAX_TEXTURE_SIZE -Videogerät wird eine kleine Kopie zur Vorschau erstellt. Dadurch wird die resultierende Datei nicht verkleinert – die Endverarbeitung erfolgt separat in der Originalauflösung.
Endbearbeitung über Canvas 2D
Nachdem Sie auf „JPG anwenden und herunterladen“ geklickt haben, erstellt die Anwendung eine Leinwand in der Größe des Originalpanoramas und kopiert das Foto hinein. Es wird nicht der gesamte Rahmen bearbeitet, sondern nur die untere Leiste, in der sich physikalisch die Nadirplatte befinden kann:
stripHeight ≈ imageHeight × radius / 180
Für jede horizontale Koordinate werden Sinus und Cosinus des Längengrades im Voraus berechnet. Dadurch entfallen wiederholte trigonometrische Berechnungen innerhalb der Hauptschleife.
Für jedes Pixel des unteren Bandes gilt der Algorithmus:
- ermittelt den Winkelabstand zum Nadir;
- überspringt Pixel außerhalb des ausgewählten Radius;
- wandelt den sphärischen Abstand über das Tangentenverhältnis in die Radialkoordinate der Matrize um;
- findet das Pixel des Würfels; Der
- mischt die RGB-Kanäle eines Bildes und Vollflächen mithilfe eines Alphakanals.
Periodisch setTimeout(..., 0) gibt die Kontrolle an die Ereignisschleife des Browsers zurück. Dadurch kann die Benutzeroberfläche den Fortschrittsbalken aktualisieren und beim Verarbeiten eines großen Bildes nicht völlig eingefroren erscheinen.
Speichern von JPEG-Metadaten
Normaler Anruf canvas.toBlob("image/jpeg") kodiert das Bild neu, verliert jedoch die ursprünglichen Metadaten. Daher liest die Anwendung vor der Verarbeitung die JPEG-Struktur und speichert die Segmente:
- APP1 – normalerweise EXIF und XMP;
- APP2 – erweiterte Profile und Servicedaten;
- APP13 — IPTC/Photoshop metadata;
- COM – JPEG-Kommentare.
Nach der Kodierung des Ergebnisses werden die gespeicherten Segmente unmittelbar nach dem SOI-Marker eingefügt FF D8. Dadurch werden EXIF, GPS und XMP in die fertige Datei übernommen.
Es ist zu bedenken, dass es sich hierbei um eine saubere Übertragung von Quellblöcken und nicht um einen vollwertigen Metadaten-Editor handelt. Die Bildabmessungen in einigen seltenen benutzerdefinierten Feldern bleiben möglicherweise gleich, obwohl in dieser Anwendung die Breite und Höhe des Ergebnisses normalerweise mit dem Original übereinstimmt.
Datenschutz
Das Foto wird lokal verarbeitet. File, ImageBitmap, Canvas, WebGL und Objekt-URL sind nur im Browser des Benutzers vorhanden. Es gibt keinen Code, über den das Bild gesendet werden kann fetch, Formulare oder Server-API.
Dies ist besonders wichtig für Panoramen mit GPS-Koordinaten: Metadaten werden nicht an die Anwendung auf dem Server übertragen, sondern im heruntergeladenen Ergebnis gespeichert. Wenn die fertige Datei veröffentlicht werden soll, sollte GPS ggf. mit einem separaten Tool entfernt werden.
Ein Projekt lokal ausführen
Erfordert Node.js Version 22.13 oder höher.
npm ci
npm run dev
Nach dem Start müssen Sie die von Vite angegebene Adresse im Terminal öffnen. So überprüfen Sie den Produktions-Build:
npm run build
npm run start
Zusätzliche Befehle:
npm test
npm run lint
Einzelheiten finden Sie in der Datei INSTALL.md, dem Archiv beigefügt.
Praktische Einschränkungen
- Es wird nur JPEG unterstützt, PNG und TIFF werden nicht akzeptiert.
- Erfordert ein vollständiges sphärisches Panorama von etwa 2:1.
- Das endgültige JPEG wird mit einer Qualität von 0,95 neu codiert, sodass es nicht mit dem Original identisch ist.
- Sehr große Bilder erfordern viel RAM: Canvas speichert unkomprimierte Pixel und 20.000×10.000 RGBA benötigt etwa 800 MB für nur einen Puffer.
- Während der Verarbeitung kann es sein, dass der mobile Browser die Registerkarte aufgrund von Speichermangel schließt.
- Der Text wird in der Systemschriftart Arial/Helvetica gezeichnet; Ein separater Download von Markenschriftarten ist nicht implementiert.
Mögliche Verbesserungen
Das Projekt kann durch Laden eines transparenten Logos, Auswahl einer Schriftart, Verarbeitung im Web Worker, gekachelte Verarbeitung großer Dateien und Export ohne erneute JPEG-Komprimierung erweitert werden. Für den professionellen Einsatz sind die Anpassung der Strichstärke, Vormuster und das Entfernen von GPS über einen separaten Schalter sinnvoll.
Bereits in seiner jetzigen Form löst die Anwendung das Hauptproblem: Sie ermöglicht es Ihnen, ohne Installation eines Desktop-Editors die richtige Beschriftung zum Nadir eines sphärischen Panoramas hinzuzufügen, das Ergebnis im interaktiven Viewer zu überprüfen und das fertige JPG herunterzuladen, ohne das Foto auf einen Server eines Drittanbieters zu übertragen.