Ritagliare immagine in un riquadro

Questo validatore accetta larghezza e altezza dell’immagine sorgente insieme a un riquadro definito da x, y, larghezza e altezza. Controlla ogni valore, conferma che l’intero rettangolo rimanga dentro l’immagine e restituisce le dimensioni ritagliate quando il riquadro è valido. Non occorre caricare o decodificare il file, quindi Lei può usarlo prima di avviare un elaboratore grafico, creare un’anteprima o accettare coordinate provenienti da un altro servizio.

Descriva l’immagine sorgente e il riquadro

Parta dalle dimensioni in pixel dell’immagine originale. Imposti image_width sul numero totale di pixel orizzontali e image_height sul numero totale di pixel verticali. Descriva poi il rettangolo con x, y, width e height. I valori x e y collocano l’angolo superiore sinistro rispetto a quello dell’immagine, che corrisponde alla coordinata 0,0. Width si estende verso destra e height verso il basso. Tutti i sei valori devono essere interi, perché la capacità rappresenta ritagli raster allineati ai pixel e non geometria frazionaria. Le dimensioni dell’immagine e del ritaglio devono essere positive, mentre x e y possono essere zero. Per esempio, x uguale a 240 salta le prime 240 colonne di pixel. Il riquadro può toccare esattamente qualsiasi bordo: x più width può quindi uguagliare image_width, e y più height può uguagliare image_height. Inserisca le misure dello stesso file che verrà ritagliato; le coordinate ricavate da un’anteprima ridimensionata devono prima essere riportate alla scala originale.

Comprenda come vengono verificati i limiti

Il validatore rifiuta innanzitutto valori mancanti, numeri non interi, coordinate negative, riquadri privi di area e cifre fuori dall’intervallo documentato. Controlla quindi i due confini che stabiliscono il contenimento. In orizzontale, x più width deve essere minore o uguale a image_width. In verticale, y più height deve essere minore o uguale a image_height. Se una somma è maggiore, parte del ritaglio esce dalla sorgente e la richiesta restituisce un errore di input non valido. Questa regola esplicita evita un comune equivoco di una unità: un ritaglio largo 100 pixel che inizia da x 0 occupa un’estensione completa di 100 pixel e rientra esattamente in un’immagine larga 100 pixel. La capacità non limita, sposta o riduce un riquadro non valido, perché cambiare silenziosamente le coordinate può selezionare un soggetto o una composizione diversi. Inoltre, non esamina i byte dell’immagine. La decisione dipende soltanto dalle misure e coordinate fornite, risultando veloce, ripetibile e adatta sia ai moduli interattivi sia alle pipeline automatiche.

Usi il risultato prima del ritaglio effettivo

Una risposta valida restituisce larghezza e altezza del ritaglio risultante. I valori coincidono con il riquadro richiesto perché questa capacità verifica la geometria senza ricampionare o modificare il rettangolo. Usi la risposta come controllo prima di passare le stesse coordinate a una libreria grafica, un servizio multimediale o un’attività di rendering in coda. In questo modo separa una verifica economica dalla decodifica più costosa e impedisce che errori prevedibili raggiungano i processi successivi. In un editor, esegua il controllo dopo la conferma della selezione o dopo aver convertito le coordinate dell’anteprima in pixel dell’originale. In una pipeline, verifichi i metadati appena arrivano e inoltri i record non validi alla correzione. Consideri l’orientamento: se un’altra fase ruota fisicamente l’immagine, usi le dimensioni successive alla rotazione e coordinate espresse nello stesso orientamento. La richiesta API costa $0.002; l’esecutore nel browser svolge localmente lo stesso calcolo deterministico. Nessuno dei due percorsi carica l’immagine.