Documentazione API di server e rendering immagini Dynamic Media

ic ic

Last update: Fri Aug 15 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:

Creato per:

Sviluppatore
Utente

Image Conversion Utility

ic è uno strumento da riga di comando che converte i file immagine nel formato PTIFF (Pyramid TIFF Format) ottimizzato. Mentre Image Server può elaborare le immagini senza conversione, ti consigliamo di convertire tutte le immagini di dimensioni superiori a 512x512 pixel in PTIFF. Questa conversione garantisce prestazioni ottimali del server e l’utilizzo delle risorse, riducendo al minimo i tempi di risposta.

È consigliabile che i file PTIFF contenenti contenuto fotografico siano codificati in JPEG (specificare -jpegcompress). I contenuti generati dal computer possono beneficiare di una compressione senza perdita (-deflatecompress o -lzwcompress). A meno che non sia necessaria una conversione del colore o del tipo di pixel, i dati dell'immagine sorgente di JPEG vengono trasferiti al file PTIFF senza decodifica, per evitare il degrado della qualità. In questo caso, le opzioni di compressione specificate si applicano solo ai livelli piramidali a risoluzione inferiore.

Se non si convertono immagini di grandi dimensioni, non è necessario impostare i parametri che controllano la quantità di memoria da utilizzare. Tuttavia, se lo sei, concedi a ic più memoria utilizzando l'impostazione -maxmem descritta di seguito. Una buona regola per calcolare la quantità di memoria necessaria è moltiplicare la larghezza dell'immagine per l'altezza dell'immagine per il numero di canali. Ad esempio, quattro per un’immagine RGB con alfa moltiplicato per tre. Inoltre, se i canali sono a 16 bit per componente invece di 8, il risultato finale sarà doppio.

Utilizzo section-fb5293fa79894442aba831c1e14c5cc9

ic -convert [options]sourceFiledestFile

ic -convert [options]sourceFolderdestFolder

-c -convert [options]sourceFiledestFolder

opzioni

Opzioni di comando (vedere di seguito).

sourceFile

File immagine di input singolo.

destFile

Singolo file PTIFF di output (non valido se utilizzato con SourceDirectory).

cartellaOrigine

Cartella contenente le immagini di input.

destFolder

Cartella in cui vengono scritti i file PTIFF di output.

Restituisce section-36a2dcfa39824d29b69547c432366219

0 in caso di esito positivo. Se si verifica un errore, viene restituito un valore diverso da zero e i dettagli dell'errore vengono inviati a stderr.

Opzioni section-df311ace43f947b3817b60b667ae04ca

- non compresso

Non comprimere l'immagine di output.

-deflatecompress

Utilizza la compressione Deflate (zip) (impostazione predefinita).

-lzwcompress

Utilizzare la compressione Lempel-Ziv-Welch (LZW).

-jpegcompress

Utilizza la codifica JPEG. Ignorato se sourceFile include dati alfa.

-jpegquality < qualità >

Qualità JPEG (0-100; il valore predefinito è 95).

- fullsamplechrominance

Disattiva il downsampling della crominanza JPEG (può migliorare la qualità del testo e della grafica a colori). Questo non ha alcun effetto sulle immagini di output in CMYK o in scala di grigi.

-usm < importo > < raggio > < soglia > < monocromatico >

Applicate la maschera di contrasto ai livelli piramidali sottocampionati. Per ulteriori dettagli, vedere op_usm=. (non applicata all'immagine a risoluzione completa).

-applyClippath

Utilizzate il percorso di clip nel file di origine, se presente, per creare i dati alfa associati.

-dpi < dpi >

Risoluzione di stampa (dpi) per destFile ; se non specificata, la risoluzione di stampa di srcFile viene copiata in destFile .

-autocrop < angolo > < modalità > < tolleranza > < infoFile >

Calcola un rettangolo di ritaglio per ridurre al minimo lo sfondo di un colore a tinta unita. Se con l’algoritmo di ritaglio automatico l’intera immagine viene ritagliata, non viene generata alcuna informazione di ritaglio.

Per calcolare il rettangolo di ritaglio senza convertire l'immagine, specificare -autocrop senza -convert e senza destFile.

angolo - ul | ur | ll | lr

Specifica l'angolo dell'immagine da utilizzare come punto di partenza. Ignorato se la modalità è 1.

modalità - 0 | 1

Impostate questo valore su 0 per ritagliare in base al colore del pixel d'angolo specificato; funziona sui dati di colore premoltiplicati se all'immagine sorgente sono associati dati alfa.

Impostate questo valore su 1 per ritagliare in base ai dati alfa; corner viene ignorato e 0 è sempre il valore di partenza; non viene applicato alcun ritaglio se all'immagine sorgente non sono associati dati alfa.

tolleranza - Corrispondenza tolleranza. Valore reale da 0,0 a 1,0. Specifica la tolleranza per i valori dei componenti pixel corrispondenti. Imposta su 0 per le corrispondenze esatte.

infoFile - Percorso e nome del file di output XML in cui vengono scritti i dati delle informazioni di ritaglio.

-embedXmpData

Copiare i metadati di XMP, se disponibili, da sourceFile a destFile senza modifiche.

-embedColorProfile

Incorpora il profilo colore ICC in destFile , se disponibile (nessun profilo è incorporato per impostazione predefinita).

-imageprofile < file >

Percorso e nome di un file di profilo ICC. Definisce lo spazio colore di sourceFile e deve corrispondere al relativo tipo di pixel. È necessario specificare solo se non è incorporato alcun profilo in sourceFile , in quanto questo sostituisce il profilo incorporato.

-viewprofile < file >

Percorso e nome di un file di profilo ICC. Definisce il tipo di pixel e lo spazio colore di destFile . IC viene convertito in questo profilo se sourceFile ha un profilo incorporato o se -imageprofile è specificato.

-intentPerceptual

Intento di rendering percettivo per le conversioni di spazio colore.

-intentRelColorimetric

Intento di rendering colorimetrico relativo per le conversioni dello spazio colore (impostazione predefinita).

-intentAbsColorimetric

Intento di rendering colorimetrico assoluto per le conversioni dello spazio colore.

-intentSaturation

Intento di rendering di saturazione per le conversioni dello spazio colore.

-cmsNoBlackPointCompensation

Disattiva la compensazione del punto nero per determinate conversioni di colore

Abilitato per impostazione predefinita.

-cmsNoDither8

Disattiva il dithering (diffusione degli errori) durante la conversione del colore.

-maintainpixeltype

Disattiva la conversione automatica da CMYK a RGB.

- forceJPEGDecompress

Forza la decodifica e la ricodifica delle immagini di input JPEG.

Attenzione: L'applicazione di questa opzione potrebbe ridurre la qualità dell'immagine.

-downsampling2x2

Utilizzare un filtro di ricampionamento di qualità standard (bi-lineare).

-downsample8x8

Utilizza un filtro di ricampionamento di qualità superiore (finestra Lanczos) (impostazione predefinita).

-downsample8x8FlashPix

Utilizzare un filtro di ricampionamento di qualità superiore (FlashPix).

-downsample8x8BicubicSharp

Downsampling con filtro bicubic-sharp in stile Photoshop 8x8.

-nousage

Se specificata come prima opzione, sopprime l’output delle informazioni di utilizzo quando vengono rilevate opzioni non valide.

-sovrascrivi

Consenti la sovrascrittura di un destFile esistente. Per impostazione predefinita, al nome del file viene aggiunto un suffisso numerico per impedire la sovrascrittura.

-nascosto

Ignora i file di origine nascosti.

-continueonerror

Non interrompere l’elaborazione quando si verifica un errore. Ha effetto solo quando si elaborano più file.

-logfile < file >

Percorso e nome del file di registro (impostazione predefinita: stdout ).

-loglevel < livello >

Livello del registro.

< 0 - Registrazione disabilitata.

0 - Elencare i file da elaborare.

1 - Aggiungere rapporti per i file non necessari.

2 - Aggiungere rapporti sull’avanzamento.

3 - Aggiungere rapporti su ogni file rilevato.

4 - Aggiungere rapporti sull’avanzamento a livello di file.

-logappend

Aggiungi al file di registro (impostazione predefinita).

-nologappend

Sovrascrivi file di registro.

-logprogressmsec < msec >

Intervallo di registrazione in msec per loglevel 2 e versioni successive (il valore predefinito è 3000).

-maxmem < byte >

Limite di utilizzo della memoria. Deve essere di almeno 10 MB.

-maxmempercent < percent >

Limite di utilizzo della memoria. Il valore predefinito corrisponde al 25% della memoria fisica. Se né maxmem né maxmempercent sono impostati in modo esplicito, viene utilizzato il valore predefinito maxmempercent.

- versione

Restituire le informazioni sulla versione per questa utility. Specifica senza altre opzioni.

Formati supportati per le immagini in ingresso section-ab13d941d6724e65b9f84b62d949d31c

Nella tabella seguente sono elencati i formati di file immagine e le opzioni di formato supportate da IC.

Formato

Tipo Di Pixel Bit/Chan

Bit/Chan

Compressione

note

BMP

(Bitmap Windows)

RGB | indicizzato

1 | 5/6 | 8

non compresso | RUOLO

5/6 bit/canale indica il supporto per RGB a 16 bit (5-5-5 e 5-6-5 bit/canale).

EPS

(PostScript incapsulato)

CMYK | RGB | grigio

ASCII | ASCII85 | Binario | JPEG

Sono supportati solo i file EPS generati da Photoshop.

CompuServe

GIF

indicizzato

LZW

Se presente, il valore di trasparenza nella palette viene convertito in alfa.

JPG

(JFIF/JPEG)

CMYK | RGB | grigio

JPEG

Photoshop

PSD

1 | 8 | 16

non compresso | compresso

Solo immagine unita; i livelli e i canali aggiuntivi vengono ignorati.

Macintosh

IMMAGINE

RGB

RUOLO

Solo dati bitmap; i dati vettoriali vengono ignorati.

PNG

RGB | RGBA | grigio | grigioA | indicizzato

1 | 2 | 4 | 8 | 16

compresso

TIFF

1 | 8 | 16

Ad eccezione del primo canale alfa associato, i canali aggiuntivi vengono ignorati.

I profili ICC incorporati vengono riconosciuti nei file EPS, JPG, PSD, PNG e TIFF.

I percorsi incorporati e i metadati XMP vengono riconosciuti nei file EPS, JPG, PSD e TIFF.

Esempi section-3c1986b30315431989bd76b1ee5bef6d

Converti una singola immagine alla migliore qualità e mantienila nella stessa cartella:

ic -convert src/myFile.png src/myFile.tif

Converti tutte le immagini in srcFolder in TIFF piramidali con codifica JPEG e inserisci in destFolder:

ic -convert -jpegcompress -jpegquality 90 -overwrite -continueOnError srcFolder destFolder

Convertire tutte le immagini in srcFolder. I dati immagine codificati dei file JPG vengono utilizzati per la compressione LZW a piena risoluzione, senza perdita di dati, per il resto della piramide di immagini di queste immagini e per l'intera immagine di output di tutti i file di input non JPG. I tipi di pixel, i profili di colore incorporati, i metadati XMP e così via. sono mantenuti.

ic -convert -lzwcompress -embedXmpData -embedColorProfile -maintainpixeltype -overwrite -continueOnError srcFolder destFolder

recommendation-more-help

a26166cd-f2f4-45ce-996d-96a0f0d6cf49