ForHosting KIT · Immagini e foto

Verifichi l’allineamento di un’icona alla griglia

Le griglie rendono coerente una raccolta di icone, ma le piccole differenze tra coordinate sono difficili da individuare sempre a occhio.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

Funziona nel tuo browser: gratis, senza registrazione, i file non escono dal tuo dispositivo.

Questo strumento confronta i bordi sinistro, superiore, destro e inferiore del riquadro delimitatore di un’icona con le linee più vicine di una griglia regolare. Inserisca la dimensione della griglia e una tolleranza facoltativa: riceverà un esito complessivo e una diagnosi chiara per ciascun bordo. È utile nelle revisioni dei sistemi di design, nelle pipeline delle risorse e nei controlli di qualità automatici in cui la stessa regola misurabile deve valere per tutte le icone.

Descriva icona e griglia nello stesso sistema di coordinate

Inserisca il riquadro dell’icona mediante quattro coordinate: sinistra, alto, destra e basso. Tutti i valori devono usare la stessa unità e la stessa origine della griglia. Per esempio, se il viewBox di un SVG è misurato in unità utente, fornisca sia le coordinate del riquadro sia la dimensione della griglia in tali unità; se il flusso di esportazione usa i pixel, impieghi i pixel in ogni campo. La griglia ha origine in zero e le linee ricorrono a ogni multiplo intero della dimensione scelta, nelle direzioni positiva e negativa. Una griglia di dimensione otto presenta quindi linee in zero, otto, sedici e ventiquattro, nonché in meno otto e meno sedici. Il controllo tratta allo stesso modo le coordinate orizzontali e verticali, poiché la spaziatura è quadrata e uniforme. Accetta coordinate frazionarie, necessarie quando trasformazioni vettoriali o ridimensionamenti producono limiti subpixel. La coordinata destra può coincidere con la sinistra e quella inferiore con la superiore, anche se un’icona visibile ha normalmente larghezza e altezza positive. I limiti invertiti vengono rifiutati perché non descrivono un riquadro valido. Soprattutto, la dimensione della griglia deve essere positiva: zero o un valore negativo restituiscono un errore di input invece di un esito fuorviante.

Interpreti la tolleranza e l’esito di ogni bordo

La tolleranza stabilisce quanto un bordo può distare da una linea per risultare allineato. Il valore predefinito è zero, quindi richiede una coincidenza esatta dopo la normalizzazione numerica stabile. Una tolleranza positiva comprende anche il limite: con 0.02, un bordo distante esattamente 0.02 unità dalla linea più vicina supera il controllo. Per ogni lato, la risposta indica la coordinata originale, la linea di griglia più prossima, la distanza assoluta e un valore booleano di allineamento. Include inoltre un esito generale, vero soltanto se passano tutti e quattro i bordi, e un elenco che nomina ogni bordo fuori griglia. Questa combinazione consente sia decisioni rapide sia indicazioni utili. Un processo di integrazione continua può interrompersi in base all’esito generale, mentre uno strumento di progettazione può mostrare con precisione quali lati correggere. I calcoli decimali vengono normalizzati a dodici posizioni per evitare che nella risposta compaiano i consueti artefatti in virgola mobile. Se un bordo è esattamente a metà fra due linee, entrambe hanno la stessa distanza; l’implementazione ne sceglie una in modo deterministico senza modificare la distanza né l’esito. La tolleranza deve essere zero o positiva e va scelta in funzione dell’esportazione, non ampliata fino a rendere inutile la regola.

Inserisca il controllo nel flusso di qualità delle icone

Il metodo più affidabile misura i limiti dopo le trasformazioni che saranno effettivamente pubblicate. Un’icona può essere disegnata con cura sulla griglia nel documento sorgente e acquisire comunque coordinate frazionarie dopo un ridimensionamento, l’espansione delle tracce, una modifica del viewBox o l’ottimizzazione dell’esportazione. Invii al controllo questi limiti finali e conservi il risultato insieme alle altre verifiche delle risorse, come regole sui nomi, dimensioni e peso dei file. Per un set rigoroso di icone pixel, usi tolleranza zero quando l’esportazione deve produrre coordinate intere della griglia. Per le risorse vettoriali con antialiasing, adotti una piccola tolleranza documentata che rappresenti gli arrotondamenti legittimi degli strumenti. Applichi la stessa dimensione e tolleranza a tutta la raccolta, affinché un esito positivo abbia sempre lo stesso significato. In caso di errore, consulti prima l’elenco dei bordi disallineati e usi poi la linea più vicina indicata per ciascuno come obiettivo della correzione. Questa capacità valuta soltanto il riquadro delimitatore: non giudica equilibrio ottico, posizione delle tracce, punti di controllo interni, peso visivo o adeguatezza artistica della griglia. Offre invece un’affermazione geometrica circoscritta, ripetibile e facilmente automatizzabile, senza rete, stato nascosto o interpretazioni legate a uno specifico programma.

Applichi la griglia del sistema di design

Controlli ogni icona proposta con la stessa dimensione e tolleranza prima che entri nella libreria condivisa.

Individui gli scostamenti di esportazione

Verifichi i limiti finali di SVG o bitmap quando ridimensionamento e ottimizzazione introducono coordinate frazionarie.

Spieghi perché una risorsa non passa

Restituisca linea più vicina e distanza di ogni bordo, così chi contribuisce saprà esattamente cosa correggere.

Quanto costa il controllo?

Ogni controllo tramite API costa $0.002. La versione per browser può essere eseguita localmente in questa pagina.

Dove si trova l’origine della griglia?

La griglia parte da zero. Le linee ricorrono a ogni multiplo intero positivo o negativo della dimensione scelta.

La tolleranza comprende il valore limite?

Sì. Un bordo con distanza esattamente uguale alla tolleranza viene considerato allineato.

Coordinate e dimensione possono essere frazionarie?

Sì. Tutti i valori numerici possono esserlo, purché siano finiti e usino lo stesso sistema di coordinate.

Che cosa accade con una griglia di dimensione zero o negativa?

La richiesta restituisce un errore di input non valido, perché una spaziatura non positiva non definisce una griglia.

Viene esaminato un file SVG o immagine?

No. Sono controllate le coordinate fornite; l’estrazione dei limiti dal file deve avvenire nel passaggio precedente.

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.

POSThttps://api.kit.forhosting.com/image/icon-grid-alignment-check

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

curl -X POST https://api.kit.forhosting.com/image/icon-grid-alignment-check \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bounding_box":{"left":16.02,"top":7.99,"right":47.98,"bottom":40.01},"grid_size":8}'
{
  "bounding_box": {
    "left": 16.02,
    "top": 7.99,
    "right": 47.98,
    "bottom": 40.01
  },
  "grid_size": 8
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "image.icon_grid_alignment_check",
  "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.

per richiesta$0.002

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

max_mb15
max_megapixels12
HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →