Dokumentation Dynamic Media Image Serving and Rendering API

ic ic

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

Ämnen:

Skapat för:

Utvecklare
Användare

Bildkonverteringsverktyg.

ic är ett kommandoradsverktyg som konverterar bildfiler till det optimerade Pyramid TIFF-formatet (PTIFF). Även om det går att bearbeta bilder utan konvertering rekommenderar vi att du konverterar alla bilder som är större än 512 x 512 pixlar till PTIFF. Denna konvertering ger optimal serverprestanda och resursanvändning och minimerar svarstiderna.

Vi rekommenderar att PTIFF-filer som innehåller fotografiskt innehåll kodas med JPEG (ange -jpegcompress). Datorgenererat innehåll kan dra nytta av förlustfri komprimering (antingen -deflatecompress eller -lzwcompress). Om inte färgkonvertering eller konvertering av pixeltyp krävs, överförs JPEG källbilddata till PTIFF utan avkodning för att undvika kvalitetsförsämring. I det här fallet gäller de angivna komprimeringsalternativen bara för pyramidnivåerna med lägre upplösning.

Om du inte konverterar stora bilder behöver du inte ange parametrar som styr hur mycket minne som ska användas. Om du är det ger du ic mer minne genom att använda inställningen -maxmem som beskrivs nedan. En bra tumregel för att beräkna mängden minne som krävs är att multiplicera bildens bredd gånger bildens höjd gånger antalet kanaler. Fyra för en RGB-bild med tre alfavärden. Om kanalerna dessutom är 16 bitar per komponent i stället för 8 gånger det slutliga resultatet.

Användning section-fb5293fa79894442aba831c1e14c5cc9

ic -convert [options]sourceFiledestFile

ic -convert [options]sourceFolderdestFolder

-c -convert [options]sourceFiledestFolder

options

Kommandoalternativ (se nedan).

sourceFile

En enda indatabildfil.

destFile

PTIFF-fil för enstaka utdata (inte giltig om den används med SourceDirectory).

sourceFolder

Mapp som innehåller indatabilder.

destFolder

Mappen som utdata-PTIFF-filer skrivs till.

Returnerar section-36a2dcfa39824d29b69547c432366219

0 om det lyckas. Om ett fel inträffar returneras ett värde som inte är noll och felinformation skickas till stderr.

Alternativ section-df311ace43f947b3817b60b667ae04ca

-uncompressed

Komprimera inte utdatabilden.

-deflatecompress

Använd dekomprimering (zip) (standard).

-lzwcompress

Använd LZW-komprimering (Lempel-Ziv-Welch).

-jpegcompress

Använd JPEG-kodning. Ignoreras om sourceFile innehåller alfavärden.

-jpegquality < quality >

JPEG-kvalitet (0-100; standard är 95).

-fullsamplekrominans

Inaktivera JPEG chroma-downsampling (kan förbättra kvaliteten på färgtext och bilder). Detta påverkar inte utdatabilder som är CMYK eller gråskala.

-usm < amount > < radius > < threshold > < monokrom >

Använd oskarp maskning på pyramidnivåer i delprov. Mer information finns i op_usm=. (Används inte för bilder med full upplösning.)

-applyClippath

Använd klippsökvägen i källfilen, om det finns någon, för att skapa tillhörande alfadata.

-dpi < dpi >

Utskriftsupplösning (dpi) för destFile - om den inte anges kopieras utskriftsupplösningen för srcFile till destFile .

-autocrop < corner > < mode > < tolerans > < infoFile >

Beräkna en beskärningsrektangel för att minimera en enfärgad bakgrund. Ingen beskärningsinformation genereras om algoritmen för automatisk beskärning skulle resultera i att hela bilden beskärs.

Om du vill beräkna beskärningsrektangeln utan att konvertera bilden anger du -autocrop utan -convert och utan destFile.

hörn - ul | ur | alla | lr

Anger vilket hörn i bilden som en startpunkt ska användas för. Ignoreras om läget är 1.

läge - 0 | 1

Ange 0 om du vill beskära baserat på färgen på den angivna hörnpixeln. Fungerar på förmultiplicerade färgdata om alfadata är kopplade till källbilden.

Ange 1 om du vill beskära baserat på alfavärden. Hörnet ignoreras och 0 är alltid startvärdet. Ingen beskärning används om inga alfavärden är associerade med källbilden.

tolerans - Matcha tolerans. Verkligt värde 0,0 till 1,0. Anger toleransen för att matcha pixelkomponentvärden. Ange 0 om du vill ha exakta träffar.

infoFile - Sökväg till och namn på den XML-utdatafil som beskärningsinformation har skrivits till.

-embedXmpData

Kopiera XMP-metadata, om sådana finns, från sourceFile till destFile utan ändring.

-embedColorProfile

Bädda in ICC-färgprofilen i destFile , om den är tillgänglig (ingen profil bäddas in som standard).

-imageprofile < file >

Sökväg till och namn på en ICC-profilfil. Definierar färgrymden för sourceFile och måste matcha dess pixeltyp. Ska bara anges om ingen profil är inbäddad i sourceFile eftersom detta åsidosätter den inbäddade profilen.

-viewprofile < file >

Sökväg till och namn på en ICC-profilfil. Definierar pixeltypen och färgrymden för destFile . IC konverterar till den här profilen om sourceFile har en inbäddad profil eller om -imageprofile också har angetts.

-intentPerceptual

Perceptuell återgivningsmetod för konvertering av färgrymd.

-intentRelColorimetric

Relativa färgvärden för återgivningsmetod för färgmodellskonverteringar (standard).

-intentAbsColorimetric

Absolut färgvärde för återgivningsmetod för färgmodellskonverteringar.

-intentSaturation

Mättnadsrenderingsmetod för konvertering av färgrymd.

-cmsNoBlackPointCompensation

Inaktivera svartpunktskompensation för vissa färgkonverteringar

Aktiverat som standard.

-cmsNoDither8

Inaktivera gitter (felspridning) vid färgkonvertering.

-maintainpixeltype

Inaktivera automatisk konvertering från CMYK till RGB.

- forceJPEGDecompress

Tvinga avkodning och omkodning av JPEG indatabilder.

Varning! Om du använder det här alternativet kan bildkvaliteten försämras.

-downsample2x2

Använd standardfilter för omsampling av kvalitet (bilinjär).

-downsample8x8

Använd ett omsamplingsfilter med högre kvalitet (Lanczos-fönster) (standard).

-downsample8x8FlashPix

Använd omsamplingsfilter med högre kvalitet (FlashPix).

-downsample8x8BicubicSharp

Nedsampla med Photoshop-format 8x8 bikubisk-skarp filter.

-nousage

När det anges som det första alternativet undertrycks utdata av användningsinformation när ogiltiga alternativ påträffas.

-overwrite

Tillåt att en befintlig destFile skrivs över. Som standard läggs ett numeriskt suffix till i filnamnet för att förhindra att filen skrivs över.

-skiphidden

Ignorera dolda källfiler.

-continueonerror

Avbryt inte bearbetningen när ett fel inträffar. Det har bara en effekt när du bearbetar flera filer.

-logfile < file >

Loggfilens sökväg och namn (standardvärdet är stdout ).

-loglevel < level >

Loggnivå.

< 0 - Loggning inaktiverad.

0 - Lista filer som ska bearbetas.

1 - Lägg till rapportering för filer som inte behövs.

2 - Lägg till förloppsrapportering.

3 - Lägg till rapportering för varje fil som påträffas.

4 - Lägg till förloppsrapportering på filnivå.

-logappend

Lägg till i loggfilen (standard).

-nologappend

Skriv över loggfil.

-logprogressSsec < msec >

Loggningsintervall i msek för loggnivå 2 och senare (standard är 3000).

-maxmem < bytes >

Minnesanvändningsgräns. Måste vara minst 10 MB.

-maxmempercent < percent >

Minnesanvändningsgräns. Standardvärdet är 25 % av det fysiska minnet. Om varken maxmem eller maxmempercent uttryckligen anges används maxmempercent-standardvärdet.

-version

Returnera versionsinformation för det här verktyget. Ange utan andra alternativ.

Bildformat som stöds section-ab13d941d6724e65b9f84b62d949d31c

I följande tabell visas de bildfilformat och formatalternativ som stöds av IC.

-format

Pixeltyp bitar/kanal

bitar/kanal

-komprimering

anteckningar

BMP

(Windows-bitmapp)

RGB | indexerad

1 | 5/6 | 8

okomprimerad | RLE

5/6 bitar/kanal anger stöd för 16-bitars RGB (5-5-5 och 5-6-5 bitar/kanal).

EPS

(Encapsulated Postscript)

CMYK | RGB | grå

ASCII | ASCII85 | binary | JPEG

Endast EPS-filer som genererats av Photoshop stöds.

CompuServe

GIF

indexerad

LZW

Om det finns något konverteras genomskinlighetsvärdet på paletten till alfa.

JPG

(JFIF/JPEG)

CMYK | RGB | grå

JPEG

Photoshop

PSD

1 | 8 | 16

okomprimerad | komprimerad

Endast sammanslagna bilder. Lager och extra kanaler ignoreras.

Macintosh

PICT

RGB

RLE

Endast bitmappsdata. Vektordata ignoreras.

PNG

RGB | RGBA | grå | grayA | indexerad

1 | 2 | 4 | 8 | 16

komprimerad

TIFF

1 | 8 | 16

Med undantag för den första associerade alfakanalen ignoreras extra kanaler.

Inbäddade ICC-profiler känns igen i EPS-, JPG-, PSD-, PNG- och TIFF-filer.

Inbäddade sökvägar och XMP-metadata känns igen i EPS-, JPG-, PSD- och TIFF-filer.

Exempel section-3c1986b30315431989bd76b1ee5bef6d

Konvertera en enda bild med bäst kvalitet och behåll den i samma mapp:

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

Konvertera alla bilder i srcFolder till JPEG-kodade pyramid-TIFF:er och placera i destFolder:

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

Konvertera alla bilder i srcFolder. Den kodade bildinformationen i JPG-filer används för den förlustfria LZW-komprimeringen med fullständig upplösning för resten av bildpyramidbilden för dessa bilder samt för hela utdatamilden av alla indatafiler som inte kommer från JPG. Pixeltyper, inbäddade färgprofiler, XMP-metadata och så vidare. upprätthålls.

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

recommendation-more-help

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