Documentation API de diffusion et de rendu d’images Dynamic Media

ic ic

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

Rubriques :

Créé pour :

Développeur
Utilisateur ou utilisatrice

Utilitaire de conversion d’images.

ic est un outil de ligne de commande qui convertit les fichiers image au format Pyramid TIFF optimisé (PTIFF). Bien que la diffusion d’images puisse traiter les images sans conversion, nous vous recommandons de convertir en PTIFF toutes les images dont la taille est supérieure à 512 x 512 pixels. Cette conversion garantit des performances de serveur et une utilisation des ressources optimales et réduit les temps de réponse.

Il est recommandé que les fichiers PTIFF contenant du contenu photographique soient codés en JPEG (spécifiez -jpegcompress). Les contenus générés par ordinateur peuvent bénéficier d’une compression sans perte (-deflatecompress ou -lzwcompress). À moins qu’une conversion de couleur ou de type pixel ne soit requise, les données d’image source JPEG sont transférées au PTIFF sans décodage, afin d’éviter une dégradation de la qualité. Dans ce cas, les options de compression spécifiées s'appliquent uniquement aux niveaux pyramidaux de résolution inférieure.

Si vous ne convertissez pas de grandes images, il n’est pas nécessaire de définir les paramètres qui contrôlent la quantité de mémoire à utiliser. Cependant, si c’est le cas, allouez ic de mémoire supplémentaire à l’aide du paramètre -maxmem décrit ci-dessous. Une bonne règle de base pour calculer la quantité de mémoire requise est de multiplier la largeur de l'image par la hauteur de l'image par le nombre de canaux. Par exemple, quatre pour une image RGB avec un temps alpha de trois. En outre, si les canaux sont de 16 bits par composant au lieu de 8, le double du résultat final.

Utilisation section-fb5293fa79894442aba831c1e14c5cc9

ic -convert [options]sourceFiledestFile

ic -convert [options]sourceFolderdestFolder

-c -convert [options]sourceFiledestFolder

options

Options des commandes (voir ci-dessous).

sourceFile

Fichier image à entrée unique.

destFile

Fichier PTIFF à sortie unique (non valide si utilisé avec SourceDirectory).

sourceFolder

Dossier contenant les images entrantes.

destFolder

Dossier dans lequel les fichiers PTIFF de sortie sont écrits.

Renvoie section-36a2dcfa39824d29b69547c432366219

0 en cas de réussite. Si une erreur se produit, une valeur différente de zéro est renvoyée et les détails de l’erreur sont envoyés à stderr.

Options section-df311ace43f947b3817b60b667ae04ca

- non compressé

Ne pas compresser l’image de sortie.

-deflatecompress

Utilisez la compression dégonflée (zip) (par défaut).

-lzwcompress

Utilisez la compression Lempel-Ziv-Welch (LZW).

-jpegcompress

Utilisez l’encodage JPEG. Ignoré si sourceFile contient des données alpha.

-jpegquality < quality >

Qualité JPEG (0-100 ; la valeur par défaut est 95).

-fullsamplechrominance

Désactivez le sous-échantillonnage de la couleur de JPEG (peut améliorer la qualité du texte et des graphiques en couleur). Cela n’a aucun effet sur les images de sortie en CMJN ou en niveaux de gris.

-usm < quantité > < rayon > < seuil > < monochrome >

Appliquez un masquage flou aux niveaux pyramidaux sous-échantillonnés. Voir op_usm=pour plus de détails. (Non appliqué à l’image en pleine résolution.)

-applyClippath

Utilisez le chemin d’accès de l’élément dans le fichier source, le cas échéant, pour créer les données alpha associées.

-dpi < dpi >

Résolution d’impression (dpi) pour de destFile ; si elle n’est pas spécifiée, la résolution d’impression de srcFile est copiée vers destFile .

-autorecadrage < corner > < mode > < tolérance > < infoFile >

Calculez un rectangle de recadrage pour minimiser un arrière-plan de couleur unie. Aucune information de recadrage n’est générée si l’algorithme de recadrage automatique entraîne le recadrage de l’image entière.

Pour calculer le rectangle de recadrage sans convertir l’image, spécifiez -autocrup sans -convert et sans destFile.

corner - ul | Url | ll | lr

Indique l’angle de l’image à utiliser comme point de départ. Ignoré si le mode est 1.

mode - 0 | 1

Définissez la valeur sur 0 pour recadrer en fonction de la couleur du pixel d’angle spécifié ; fonctionne sur des données de couleur prémultipliées si des données alpha sont associées à l’image source.

Définissez la valeur sur 1 pour recadrer en fonction des données alpha ; le coin est ignoré et 0 est toujours la valeur de départ ; aucun recadrage n’est appliqué si aucune donnée alpha n’est associée à l’image source.

tolérance - Tolérance de correspondance. Valeur réelle 0,0 à 1,0. Indique la tolérance pour la correspondance des valeurs des composants en pixels. Définissez-le sur 0 pour les correspondances exactes.

infoFile - Chemin et nom du fichier de sortie XML dans lequel les données d’informations de recadrage sont écrites.

-embedXmpData

Copiez les métadonnées XMP, le cas échéant, de sourceFile vers destFile sans modification.

-embedColorProfile

Incorporez le profil de couleurs ICC dans fichier destFile , le cas échéant (aucun profil n’est incorporé par défaut).

-imageprofile < fichier >

Chemin et nom d’un fichier de profil ICC. Définit l’espace colorimétrique sourceFile et doit correspondre type de pixel. Ne doit être spécifié que si aucun profil n’est incorporé dans sourceFile , car il remplace le profil incorporé.

-viewprofile < fichier >

Chemin et nom d’un fichier de profil ICC. Définit le type de pixel et l’espace colorimétrique de destFile . IC convertit ce profil si sourceFile a un profil incorporé ou si -imageprofile est également spécifié.

-intentPerceptual

Mode de rendu perceptuel pour les conversions d’espace colorimétrique.

-intentRelColorimetric

Mode de rendu colorimétrique relatif pour les conversions d’espace colorimétrique (par défaut).

-intentAbsColorimetric

Intention de rendu de colorimétrie absolue pour les conversions d’espace colorimétrique.

-intentSaturation

Mode de rendu de saturation pour les conversions d’espace colorimétrique.

-cmsNoBlackPointCompensation

Désactiver la compensation des points noirs pour certaines conversions de couleurs

Activé par défaut.

-cmsNoDither8

Désactivez le tramage (diffusion d’erreur) lors de la conversion des couleurs.

-maintainpixeltype

Désactivez la conversion automatique de CMJN vers RGB.

- forceJPEGDecompress

Forcer le décodage et le recodage des images d’entrée JPEG.

Attention : l'application de cette option peut diminuer la qualité de l'image.

-downsample2x2

Utiliser un filtre de rééchantillonnage de qualité standard (bi-linéaire).

-downsample8x8

Utilisez un filtre de rééchantillonnage de meilleure qualité (fenêtre de Lanczos) (par défaut).

-downsample8x8FlashPix

Utilisez un filtre de rééchantillonnage de meilleure qualité (FlashPix).

-downsample8x8BicubicSharp

Sous-échantillon avec filtre bicubique aigu Photoshop style 8x8.

-nousage

Lorsqu’elle est spécifiée comme première option, supprime la sortie des informations d’utilisation lorsque des options non valides sont rencontrées.

-overwrite

Permet de remplacer un fichier existant destFile . Par défaut, un suffixe numérique est ajouté au nom de fichier pour empêcher le remplacement.

-skiphidden

Ignorez les fichiers sources masqués.

-continueonerror

N’arrêtez pas le traitement en cas d’erreur. N’a d’effet que lors du traitement de plusieurs fichiers.

-logfile < fichier >

Chemin et nom du fichier journal (par défaut, stdout ).

-loglevel < level >

Niveau de log.

< 0 - Journalisation désactivée.

0 - Répertoriez les fichiers à traiter.

1 - Ajoutez des rapports pour les fichiers inutiles.

2 - Ajoutez un rapport de progression.

3 - Ajoutez des rapports sur chaque fichier rencontré.

4 - Ajoutez des rapports de progression au niveau des fichiers.

-logappend

Ajoutez au fichier journal (par défaut).

-nologappend

Remplacer le fichier journal.

-logprogressmsec < msec >

Intervalle de journalisation en ms pour le niveau de journalisation 2 et supérieur (3 000 par défaut).

-maxmem < octets >

Limite d’utilisation de la mémoire. Doit contenir au moins 10 Mo.

-maxmempercent < percent >

Limite d’utilisation de la mémoire. La valeur par défaut est de 25 % de la mémoire physique. Si ni maxmem ni maxmempercent ne sont explicitement définis, utilise maxmempercent default.

-version

Renvoyer les informations de version pour cet utilitaire. Spécifiez sans autre option.

Formats D’Image D’Entrée Pris En Charge section-ab13d941d6724e65b9f84b62d949d31c

Le tableau suivant répertorie les formats de fichiers image et les options de format pris en charge par IC.

format

Type Pixel Bits/Chan

bits/canal

Compression

notes

BMP

(Bitmap Windows)

RGB | indexé

1 | 5/6 | 8

non compressé | RÈGLE

5/6 bits/canal indique la prise en charge de RGB 16 bits (5-5-5 et 5-6-5 bits/canal).

EPS

(Postscript Encapsulé)

CMJN | RGB | grise

ASCII | ASCII85 | Binaire | JPEG

Seuls les fichiers EPS générés par Photoshop sont pris en charge.

CompuServe

GIF

indexé

DROIT

Si elle est présente, la valeur de transparence de la palette est convertie en alpha.

JPG

(JFIF/JPEG)

CMJN | RGB | grise

JPEG

Photoshop

PSD

1 | 8 | 16

non compressé | compressé

Image fusionnée uniquement : les calques et les canaux supplémentaires sont ignorés.

Macintosh

PICT

RVB

RÈGLE

Données bitmap uniquement ; données vectorielles ignorées.

PNG

RGB | RGBA | grise | grayA | indexé

1 | 2 | 4 | 8 | 16

compressé

TIFF

1 | 8 | 16

A l’exception de la première couche alpha associée, les couches supplémentaires sont ignorées.

Les profils ICC incorporés sont reconnus dans les fichiers EPS, JPG, PSD, PNG et TIFF.

Les chemins d’accès intégrés et les métadonnées XMP sont reconnus dans les fichiers EPS, JPG, PSD et TIFF.

Exemples section-3c1986b30315431989bd76b1ee5bef6d

Convertissez une image unique avec la meilleure qualité possible et conservez-la dans le même dossier :

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

Convertissez toutes les images de srcFolder en TIFF pyramidaux codés en JPEG et placez-les dans destFolder :

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

Convertissez toutes les images en srcFolder. Les données d’image codées des fichiers JPG sont utilisées pour la compression LZW sans perte et de niveau de résolution complet pour le reste de la pyramide d’images de ces images, ainsi que pour l’image de sortie complète de tous les fichiers d’entrée non JPG. Types de pixels, profils de couleurs incorporés, métadonnées XMP, etc. sont entretenues.

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

recommendation-more-help

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