Come ritagliare una regione rettangolare di un’immagine

A cosa serve il ritaglio con coordinate

Questo strumento permette di isolare una porzione rettangolare di un’immagine partendo dai relativi dati. È utile quando vuoi selezionare un’area attraverso i suoi confini numerici, invece di descriverla con percentuali o con un formato grafico diverso. Il materiale fornito deve rappresentare un’immagine leggibile: il valore viene decodificato e i byte ottenuti vengono aperti come immagine prima del ritaglio.

L’operazione riguarda il ritaglio della regione indicata. Non va interpretata come un ridimensionamento, una rotazione o un miglioramento dell’immagine. Quando l’elaborazione riesce, ottieni i dati codificati della nuova immagine; il formato di origine viene conservato quando è disponibile, mentre in caso contrario l’uscita viene salvata come PNG.

Impostare dati e confini dell’area

1. Prepara i dati dell’immagine in una stringa non vuota. Il contenuto deve poter essere decodificato e aperto come immagine, perché il semplice fatto che una stringa contenga caratteri non basta per ottenere un ritaglio valido.

2. Inserisci la stringa nel campo dedicato ai dati dell’immagine. L’input dichiarato è facoltativo, ma un valore vuoto non consente di procedere con l’elaborazione.

3. Se desideri usare l’area iniziale, lascia i quattro campi delle coordinate ai loro valori predefiniti: sinistra 0, alto 0, destra 100 e basso 100. Questi numeri non descrivono percentuali; sono limiti numerici da applicare alle dimensioni dell’immagine dopo la decodifica.

4. Per scegliere una regione diversa, compila i campi sinistra, alto, destra e basso con valori numerici. Considera sinistra e alto come i confini iniziali dell’area, mentre destra e basso ne indicano i confini opposti. La loro interpretazione dipende dalla larghezza e dall’altezza dell’immagine ottenuta dai dati forniti.

5. Avvia l’elaborazione dopo aver controllato sia i dati sia i quattro valori. I confini sinistro e superiore vengono mantenuti entro le dimensioni dell’immagine. Il confine destro viene riportato entro la larghezza disponibile e poi regolato in modo da restare almeno un’unità oltre sinistra; lo stesso criterio viene applicato a basso rispetto ad alto.

6. Esamina l’uscita prodotta quando il processo termina senza errori. La porzione ritagliata è codificata in base64. Se il formato dell’immagine sorgente è disponibile, viene usato per salvare l’uscita; in assenza di tale informazione, il formato usato è PNG.

Per un controllo pratico, puoi iniziare con i valori predefiniti e poi sostituirli con coordinate riferite alle dimensioni dell’immagine. Non inserire simboli di percentuale nei campi numerici e non attribuire ai valori un significato normalizzato, perché vengono trattati come limiti dell’immagine decodificata.

Leggere l’uscita e riconoscere i limiti

Un’elaborazione riuscita restituisce una rappresentazione codificata dell’immagine risultante, non una misura della porzione selezionata. Per usare correttamente l’uscita, considera quindi il contenuto base64 insieme al formato indicato dalla sorgente o alla possibilità che sia stato usato PNG.

La dimensione della regione dipende dalle coordinate e dalle dimensioni dell’immagine decodificata. Un valore che oltrepassa un bordo viene ricondotto alla dimensione disponibile. Se sinistra o alto arrivano al bordo corrispondente, la correzione minima del limite opposto può estendere la regione di un’unità per conservarne la validità; per questo il rettangolo non va previsto soltanto osservando il valore inserito.

Un esito negativo può dipendere da dati vuoti, da byte che non vengono aperti come immagine o da un problema durante decodifica, apertura, ritaglio o salvataggio. Anche l’assenza della dipendenza necessaria per l’elaborazione delle immagini rientra nelle condizioni di mancato completamento. In questi casi, ricontrolla prima il contenuto dell’immagine e i confini numerici, quindi riprova senza assumere che l’operazione abbia prodotto un’immagine utilizzabile.

Esempio pratico

Devi estrarre da un’immagine codificata una porzione rettangolare usando confini numerici diversi dai valori iniziali.

Inserisci dati base64 non vuoti, imposta sinistra 40, alto 20, destra 240 e basso 160, quindi avvia l’elaborazione. Controlla che l’uscita presenti dati codificati dell’immagine ritagliata.

L’uscita riuscita contiene dati base64 dell’immagine ritagliata, nel formato sorgente quando disponibile oppure in PNG.

Limiti

• La procedura può interrompersi durante decodifica, apertura, ritaglio o salvataggio; il formato dell’uscita non è scelto liberamente, poiché viene mantenuta la sorgente quando disponibile oppure viene usato PNG.

Errori comuni

• Un campo immagine lasciato vuoto oppure una stringa che non apre un’immagine può interrompere il processo; inserisci dati non vuoti e controlla che la loro decodifica produca un’immagine prima di inviare di nuovo la richiesta.

Domande frequenti

Posso inserire una stringa qualsiasi nei dati dell’immagine?

Puoi usare una stringa soltanto se contiene dati che vengono decodificati e aperti come immagine. Un contenuto vuoto non permette di iniziare, mentre dati non validi possono causare un errore nelle fasi di apertura o di elaborazione.

Le coordinate rappresentano percentuali?

No: i quattro valori sono limiti numerici applicati alle dimensioni dell’immagine ottenuta dopo la decodifica. Se un confine supera il bordo disponibile, viene corretto; la regolazione dell’estensione minima può intervenire quando sinistra o alto raggiungono il bordo.

Quali valori vengono usati senza coordinate inserite?

Se non modifichi i campi, l’operazione parte da sinistra 0, alto 0, destra 100 e basso 100. L’area che ne deriva dipende dalle dimensioni dell’immagine e dalle correzioni applicate ai confini.