Cómo añadir una etiqueta nadir a una panorámica esférica

Русский · English · Español · Français · Deutsch

generalmente se almacenan como archivos JPEG normales con proyección equirectangular y una relación de aspecto de 2:1. La parte superior de la imagen corresponde al cenit, el medio al horizonte y el borde inferior al nadir, es decir, el punto estrictamente debajo de la cámara.

Después de disparar, es en el punto más bajo donde a menudo queda un trípode, la sombra del fotógrafo o una zona mal cosida. Se puede cerrar con una placa redonda con el nombre de la empresa, la dirección del sitio web o el logotipo. Sin embargo, simplemente superponer un círculo en la parte inferior de un JPEG rectangular no es adecuado: al ver un panorama, dicha imagen se distorsionará mucho. Necesitamos una retroproyección que tenga en cuenta la geometría de la esfera.

En este artículo analizaremos la aplicación web “Firma Nadir para panorámicas”. Carga un JPG esférico, muestra una vista previa interactiva de 360°, proyecta correctamente la firma circular en la parte inferior de la esfera y guarda el nuevo JPEG. Todo el procesamiento se realiza localmente en el navegador; el panorama original no se envía al servidor.

Características de la aplicación

  • cargando JPG o JPEG arrastrando o usando el cuadro de diálogo de selección de archivos;
  • verificando el tamaño máximo de archivo y la relación de aspecto panorámico 2:1; Firma de texto
  • de hasta 60 caracteres;
  • ajustando el color, la transparencia y el radio de las esquinas del troquel;
  • ; rotación
  • con el mouse o el dedo y cambio del campo de visión con la rueda;
  • transición rápida con una mirada al nadir; Procesamiento de imágenes
  • en resolución original;
  • guarda comentarios EXIF, GPS, XMP, IPTC y JPEG; Resultado de descarga de
  • con sufijo _nadir.jpg.

Por qué el nadir parece inusual en el JPEG original

En una proyección equirectangular, la coordenada horizontal especifica la longitud y la coordenada vertical especifica la latitud de la esfera. Una rotación completa de 360° ocupa todo el ancho de la imagen y un rango desde el cenit hasta el nadir de 180° ocupa toda la altura.

El punto nadir es el único punto de la esfera, pero en un escaneo rectangular se extiende a lo largo de todo el borde inferior de la imagen. Por tanto, el círculo que el espectador debería ver debajo de él se convierte en una franja característica con distorsión no lineal. Después de doblar la imagen nuevamente en una esfera, esta franja vuelve a convertirse en un círculo.

Para el píxel del panorama original se utilizan coordenadas esféricas:

longitude = x / width × 2π − π
latitude  = π/2 − y / height × π

En la parte inferior de la imagen, se calcula la distancia angular al nadir. Si es menor que el radio seleccionado, al píxel se le asigna un punto en un bloque circular.

Arquitectura del proyecto

La aplicación está escrita en React y TypeScript. La interfaz está en app/page.tsx, estilos – en app/globals.cssy los metadatos de la página están en app/layout.tsx.

La lógica principal se divide en cuatro partes:

  1. Carga y comprobación de JPEG;
  2. creación de un bloque redondo con texto; Vista previa interactiva de WebGL
  3. ;
  4. a máxima resolución mediante Canvas 2D.

La aplicación no necesita una base de datos de servidor. Una vez cargada la página, la API del navegador realiza las operaciones con las fotografías.

Cargando y comprobando panorama

La aplicación acepta archivos con tipo MIME image/jpeg o extensión .jpg/.jpeg. Luego se lee el archivo arrayBuffer(), y sus dimensiones se determinan utilizando createImageBitmap().

Comprueba la relación ancho-alto:

abs(width / height − 2) ≤ 0,035

Las pequeñas tolerancias permiten obtener panorámicas que difieren del 2:1 ideal en unos pocos píxeles. El límite de la interfaz es de 250 MB por archivo. El límite real también depende de la cantidad de memoria, la implementación de Canvas y el tamaño máximo de textura WebGL en un navegador en particular.

formación de matrices

Función makeBadge() crea un lienzo cuadrado de 1800 × 1800 píxeles. Representa: Círculo

  • de color y transparencia seleccionados;
  • contorno blanco;
  • en el centro.

El tamaño de fuente disminuye de 280 a 60 píxeles hasta que la línea se ajusta al 80% del ancho del círculo. Gracias a esto, una dirección corta se muestra en tamaño grande y una firma larga se escala automáticamente.

Visualización interactiva vía WebGL La vista previa de

no cambia el JPEG original. Utiliza dos texturas: Panorama

  • ; Troquel creado por
  • .

El sombreador de vértices muestra dos triángulos en todo el lienzo. El sombreador de fragmentos crea un rayo de cámara virtual para cada píxel de la pantalla, aplica rotación horizontal y vertical y luego traduce la dirección del rayo en coordenadas de textura equirectangulares.

Si la dirección cae dentro del radio angular especificado desde el nadir, el sombreador calcula las coordenadas del píxel correspondiente del sólido y lo mezcla con el panorama, teniendo en cuenta el canal alfa.

Este enfoque es conveniente para la visualización: la GPU recalcula rápidamente la imagen al girar y escalar. Si el panorama excede dispositivo de vídeo MAX_TEXTURE_SIZE , se crea una copia pequeña para obtener una vista previa. Esto no reduce el archivo resultante: el procesamiento final se realiza por separado con la resolución original.

Procesamiento final vía Canvas 2D

Después de hacer clic en «Aplicar y descargar JPG», la aplicación crea un lienzo del tamaño del panorama original y copia la foto en él. No se procesa todo el marco, sino sólo la tira inferior, en la que físicamente se puede ubicar la placa del nadir:

stripHeight ≈ imageHeight × radius / 180

Para cada coordenada horizontal, el seno y el coseno de longitud se calculan de antemano. Esto elimina cálculos trigonométricos repetidos dentro del bucle principal.

Para cada píxel de la banda inferior, el algoritmo:

  1. encuentra la distancia angular al nadir;
  2. omite píxeles fuera del radio seleccionado;
  3. convierte la distancia esférica en la coordenada radial del troquel mediante la relación tangente;
  4. encuentra el píxel del troquel; El
  5. mezcla los canales RGB de una imagen y sólidos usando un canal alfa.

periódico setTimeout(..., 0) devuelve el control al bucle de eventos del navegador. Esto permite que la interfaz actualice la barra de progreso y no aparezca completamente congelada mientras procesa una imagen grande.

Guardar metadatos JPEG

llamada normal canvas.toBlob("image/jpeg") vuelve a codificar la imagen, pero pierde los metadatos originales. Por tanto, antes de procesar, la aplicación lee la estructura JPEG y guarda los segmentos:

  • APP1: generalmente EXIF y XMP;
  • APP2: perfiles ampliados y datos de servicio;
  • APP13 — IPTC/Photoshop metadata;
  • COM – Comentarios JPEG.

Después de codificar el resultado, los segmentos almacenados se insertan inmediatamente después del marcador SOI FF D8. Como resultado, EXIF, GPS y XMP se transfieren al archivo terminado.

Debe tenerse en cuenta que se trata de una transferencia ordenada de bloques fuente y no de un editor de metadatos completo. Las dimensiones de la imagen dentro de algunos campos personalizados poco comunes pueden seguir siendo las mismas, aunque en esta aplicación el ancho y alto del resultado suelen ser los mismos que los originales.

Privacidad

La foto se procesa localmente. File, ImageBitmap, Canvas, WebGL y la URL del objeto solo existen en el navegador del usuario. No hay ningún código para enviar la imagen a través de fetch, formularios o API de servidor.

Esto es especialmente importante para panoramas con coordenadas GPS: los metadatos no se transfieren a la aplicación en el servidor, sino que se guardan en el resultado descargado. Si se planea publicar el archivo terminado, el GPS debe eliminarse con una herramienta separada si es necesario.

Ejecutando un proyecto localmente

Requiere Node.js versión 22.13 o posterior.

npm ci
npm run dev

Después del lanzamiento, debe abrir la dirección especificada por Vite en la terminal. Para comprobar la compilación de producción:

npm run build
npm run start

Comandos adicionales:

npm test
npm run lint

Los detalles están en el archivo. INSTALL.md, adjunto al archivo.

Limitaciones prácticas

  • Solo se admite JPEG, no se aceptan PNG ni TIFF.
  • Requiere un panorama esférico completo de aproximadamente 2:1.
  • El JPEG final se vuelve a codificar con una calidad de 0,95, por lo que no será idéntico en bits al original.
  • Las imágenes muy grandes requieren mucha RAM: Canvas almacena píxeles sin comprimir y 20.000×10.000 RGBA ocupa unos 800 MB para un solo búfer.
  • Durante el procesamiento, el navegador móvil puede cerrar la pestaña debido a falta de memoria.
  • El texto se dibuja en la fuente del sistema Arial/Helvetica; No se implementa la descarga por separado de fuentes de marca.

Posibles mejoras

El proyecto se puede ampliar cargando un logotipo transparente, eligiendo una fuente, procesando en Web Worker, procesando en mosaico archivos grandes y exportando sin volver a comprimir JPEG. Para uso profesional, es útil ajustar el grosor del trazo, los patrones previos y eliminar el GPS mediante un interruptor independiente.

Ya en su forma actual, la aplicación resuelve el problema principal: le permite agregar el título correcto al punto más bajo de un panorama esférico sin instalar un editor de escritorio, verificar el resultado en el visor interactivo y descargar el JPG terminado sin transferir la foto a un servidor de terceros.