ForHosting KIT · Immagini e foto

Stima la larghezza del panorama da foto sovrapposte, gratis

Prima di unire un panorama, è utile sapere quanto sarà larga la tela finale. Questo calcolatore gratuito prende le dimensioni in pixel di ogni scatto sovrapposto e la stima della sovrapposizione orizzontale tra fotogrammi consecutivi, quindi restituisce la larghezza del panorama, la sovrapposizione totale in pixel e l'altezza del panorama quando ogni immagine la dichiara. Funziona interamente nel Suo browser, è gratuito per l'uso interattivo, e lo stesso calcolo è disponibile tramite API a $0.002 per richiesta quando Le serve in una pipeline.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Come viene stimata la larghezza del panorama

Un panorama unito non è semplicemente la somma delle larghezze delle singole foto, perché i fotogrammi consecutivi si sovrappongono. Questo strumento scorre il Suo elenco di immagini da sinistra a destra, esattamente nell'ordine in cui Lei le unirà. Per ogni coppia adiacente calcola la regione condivisa: la percentuale di sovrapposizione che Lei fornisce, applicata alla più stretta delle due larghezze. Usare la larghezza minore è la scelta conservativa e fisicamente sensata: la striscia sovrapposta non può mai essere più larga di una delle due immagini che la condividono. Quella sovrapposizione in pixel viene poi sottratta quando si aggiunge il fotogramma successivo, così il totale cresce solo della striscia nuova e non duplicata di ogni foto. Il risultato è la larghezza stimata della tela finale in pixel. Poiché il calcolo è una semplice somma di prodotti, la stima è esatta per le percentuali che Lei inserisce; l'unica incertezza risiede in quanto le Sue stime di sovrapposizione corrispondano a ciò che la fotocamera ha realmente catturato. Per riprese a mano libera, sovrapposizioni tra il 20% e il 40% sono tipiche, mentre una testa panoramica su treppiede Le consente di pianificare valori più stretti e prevedibili.

Cosa inserire e cosa si ottiene

L'input è un elenco di record di immagini in ordine di unione. Ogni record richiede una larghezza in pixel; l'altezza è opzionale, e overlap_pct è la sovrapposizione orizzontale che quell'immagine condivide con la successiva, espressa come percentuale da 0 fino a 100 escluso. L'ultima immagine non ha mai un vicino successivo, quindi il suo valore di sovrapposizione viene ignorato. L'output Le fornisce image_count, la stima panorama_width, total_overlap_px (quanti pixel sono duplicati in tutte le giunzioni), sum_widths_px (il totale ingenuo se ignorasse la sovrapposizione) e panorama_height quando ogni record dichiara un'altezza — presa come il massimo, poiché la tela deve contenere il fotogramma più alto. Una sovrapposizione del 100% o più viene rifiutata con un errore chiaro, perché due fotogrammi che si sovrappongono completamente non aggiungono nuove informazioni e di solito segnalano un input errato. Tutti i valori sono arrotondati a sei decimali affinché i risultati siano stabili e confrontabili tra esecuzioni.

Consigli di pianificazione per unioni migliori

Usi questa stima prima di scattare o prima di impegnare spazio su disco per una tela enorme. Se conosce l'obiettivo, le dimensioni del sensore e l'angolo di rotazione tra gli scatti, può ricavare la percentuale di sovrapposizione dal campo visivo orizzontale: la frazione del fotogramma che si ripete è uguale a uno meno il passo angolare diviso per il campo visivo. Applichi la stessa percentuale a ogni giunzione per una scansione uniforme, oppure la vari per coppia quando ha cambiato il passo durante la sequenza. Mantenga almeno il 15% di sovrapposizione affinché il software di unione abbia abbastanza caratteristiche corrispondenti, e preferisca il 30% o più in scene con poca texture come cielo o acqua. Se la stima risulta molto più larga di quanto il Suo editor o la Sua stampante supportino, riduca il numero di fotogrammi, aumenti la sovrapposizione così ogni fotogramma contribuisce con meno area nuova, oppure preveda di ridimensionare la tela finale. Poiché questo calcolatore è deterministico e istantaneo, può sperimentare liberamente con conteggi di fotogrammi e sovrapposizioni finché la dimensione prevista non rientra nel Suo obiettivo.

Casi d'uso

Pianificazione pre-scatto per panorami paesaggistici

Un fotografo che pianifica una scansione di cinque fotogrammi di uno skyline inserisce la larghezza di ogni fotogramma e la sovrapposizione prevista del 30% per confermare che la tela finale sarà abbastanza larga per una stampa di grande formato prima di uscire di casa.

Dimensionamento di tela e archiviazione per lavori gigapixel

Uno studio che costruisce un mosaico gigapixel di decine di fotogrammi con teleobiettivo stima la larghezza unita per verificare in anticipo memoria, disco di lavoro e limiti di esportazione del proprio software di unione.

Controllo di coerenza di una pipeline di unione

Uno sviluppatore che elabora in batch sequenze di foto da drone chiama l'API a $0.002 per richiesta per prevedere le dimensioni di output, segnalando le sequenze i cui input di sovrapposizione produrrebbero un risultato impossibilmente stretto o largo.

Domande frequenti

Perché il mio panorama non è semplicemente la somma di tutte le larghezze delle immagini?

Perché i fotogrammi consecutivi si sovrappongono. La striscia duplicata tra ogni coppia viene sottratta, quindi la larghezza finale è la somma delle larghezze meno la sovrapposizione in pixel di ogni giunzione.

Come viene calcolata la sovrapposizione tra due immagini?

La Sua percentuale di sovrapposizione viene applicata alla più stretta delle due larghezze in ogni coppia adiacente, poiché la regione condivisa non può essere più larga di nessuna delle due immagini. Quel valore in pixel viene poi sottratto quando si aggiunge il fotogramma successivo.

Cosa succede se inserisco una sovrapposizione del 100% o più?

La richiesta viene rifiutata come input non valido. Una sovrapposizione completa significa che la seconda immagine non aggiunge nuova area, il che contraddice l'idea stessa di unione e indica quasi sempre un errore di inserimento dati.

L'ordine delle immagini è importante?

Sì. I record vengono elaborati in ordine di unione, da sinistra a destra, e ogni overlap_pct descrive la giunzione tra quell'immagine e la successiva. Il valore di sovrapposizione dell'ultima immagine viene ignorato.

Posso stimare anche l'altezza del panorama?

Sì. Quando ogni record di immagine include un'altezza, il risultato include panorama_height, preso come l'altezza massima affinché la tela contenga il fotogramma più alto. Se manca qualche altezza, il campo viene omesso.

Lo strumento è gratuito e funziona online?

L'uso interattivo funziona interamente nel Suo browser gratuitamente — nulla viene caricato. Lo stesso identico calcolo è esposto anche tramite l'API a $0.002 per richiesta per pipeline scriptate.

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

POSThttps://api.kit.forhosting.com/image/stitch-panorama-estimate

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo stack

curl -X POST https://api.kit.forhosting.com/image/stitch-panorama-estimate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"images":[{"width":4000,"height":3000,"overlap_pct":30},{"width":4000,"height":3000,"overlap_pct":25},{"width":4000,"height":3000}]}'

const res = await fetch("https://api.kit.forhosting.com/image/stitch-panorama-estimate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "images": [
      {
        "width": 4000,
        "height": 3000,
        "overlap_pct": 30
      },
      {
        "width": 4000,
        "height": 3000,
        "overlap_pct": 25
      },
      {
        "width": 4000,
        "height": 3000
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/image/stitch-panorama-estimate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "images": [
        {
            "width": 4000,
            "height": 3000,
            "overlap_pct": 30
        },
        {
            "width": 4000,
            "height": 3000,
            "overlap_pct": 25
        },
        {
            "width": 4000,
            "height": 3000
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/stitch-panorama-estimate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"images":[{"width":4000,"height":3000,"overlap_pct":30},{"width":4000,"height":3000,"overlap_pct":25},{"width":4000,"height":3000}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"images":[{"width":4000,"height":3000,"overlap_pct":30},{"width":4000,"height":3000,"overlap_pct":25},{"width":4000,"height":3000}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/stitch-panorama-estimate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Esempio di richiesta

{
  "images": [
    {
      "width": 4000,
      "height": 3000,
      "overlap_pct": 30
    },
    {
      "width": 4000,
      "height": 3000,
      "overlap_pct": 25
    },
    {
      "width": 4000,
      "height": 3000
    }
  ]
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "image.stitch_panorama_estimate",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Limiti

max_items 200

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →