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

ic ic

Last update: Mon Jul 22 2024 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 PTIFF (Pyramid TIFF) optimisé. Bien que la diffusion d’images puisse traiter les images sans conversion, nous vous recommandons de convertir toutes les images de plus de 512x512 pixels en PTIFF. Cette conversion permet d’optimiser les performances du serveur et l’utilisation des ressources, tout en réduisant 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 l'ordinateur peuvent bénéficier d'une compression sans perte (-deflatecompress ou -lzwcompress). À moins d’une conversion de couleur ou d’une conversion de type pixel requise, les données d’image source du JPEG sont transférées au fichier 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 d’images volumineuses, il n’est pas nécessaire de définir les paramètres qui contrôlent la quantité de mémoire à utiliser. Cependant, si vous l'êtes, attribuez à ic plus de mémoire en utilisant le paramètre -maxmem décrit ci-dessous. Une bonne règle de base pour calculer la quantité de mémoire requise consiste à multiplier la largeur de l’image par la hauteur de l’image par le nombre de canaux. Par exemple, quatre pour une image de RGB avec une couche alpha de trois. En outre, si les canaux sont 16 bits par composant au lieu de 8, le résultat final est le double.

Utilisation section-fb5293fa79894442aba831c1e14c5cc9

ic -convert [options]sourceFiledestFile

ic -convert [options]sourceFolderdestFolder

-c -convert [options]sourceFiledestFolder

options

Options de commande (voir ci-dessous).

sourceFile

Fichier image d’entrée unique.

destFile

Fichier PTIFF de sortie unique (non valide s’il est utilisé avec SourceDirectory).

sourceFolder

Dossier contenant des images d’entrée.

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 non nulle est renvoyée et les détails de l’erreur sont envoyés à stderr.

Options section-df311ace43f947b3817b60b667ae04ca

- décompressé

Ne compresse pas l’image de sortie.

-deflatecompress

Utilisez la compression déflate (zip) (par défaut).

-lzwcompress

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

-jpegcompress

Utilisez le codage du JPEG. Ignoré si sourceFile contient des données alpha.

-jpegquality < quality >

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

-fullsamplechrominance

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

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

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

-applyClippath

Utilisez le chemin d’accès à 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 destFile ; si elle n’est pas spécifiée, la résolution d’impression de srcFile est copiée vers destFile .

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

Calculez un rectangle de recadrage afin de minimiser un arrière-plan en couleur uni. 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 -autocrop sans -convert et sans destFile.

coin - ul | ur | ll | lr

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

mode - 0 | 1

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

Définissez cette variable sur 1 pour effectuer un recadrage en fonction des données alpha ; un 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 comprise entre 0,0 et 1,0. Spécifie la tolérance pour les valeurs de composant de pixel correspondantes. Définissez cette variable sur 0 pour connaître 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 XMP métadonnées, le cas échéant, de sourceFile vers destFile sans modification.

-embedColorProfile

Incorporez le profil colorimétrique ICC dans destFile si disponible (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 de sourceFile et doit correspondre à son type de pixel. Doit être spécifié uniquement 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 destFile . IC effectue une conversion vers ce profil si sourceFile comporte un profil incorporé ou si -imageprofile est également spécifié.

-intentPerception

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

-intentRelColorimetric

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

-intentAbsColorimetric

Mode de rendu Colorimétrique absolu pour les conversions de l’espace colorimétrique.

-intentSaturation

Intention de rendu de la saturation pour les conversions de l’espace colorimétrique.

-cmsNoBlackPointCompensation

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

Activé par défaut.

-cmsNoDither8

Désactiver l’effet d’effet d’effet d’effet d’effet d’effet d’effet d’effet d’effet d’effet d’effet d’effet d’effet d’effet d’ombre (diffusion d’erreur) lors de la conversion des couleurs.

-maintainpixeltype

Désactivez la conversion automatique de CMJN en RGB.

- forceJPEGDecompress

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

Attention : L’application de cette option peut réduire la qualité de l’image.

-downsample2x2

Utilisez le filtre de rééchantillonnage de qualité standard (bilinéaire).

-downsample8x8

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

-downsample8x8FlashPix

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

-downsample8x8BicubicSharp

Sous-échantillonnez avec un filtre coupe-vis 8x8 de style Photoshop.

-Nom

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

Autorisez le remplacement d'un destFile existant. Par défaut, un suffixe numérique est ajouté au nom du fichier pour éviter tout écrasement.

-skiphidden

Ignorer les fichiers source masqués.

-continueonerror

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

-logfile < file >

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

-loglevel < level >

Niveau de journal.

< 0 - Journalisation désactivée.

0 - Liste des fichiers à traiter.

1 - Ajoutez un reporting pour les fichiers inutiles.

2 - Ajoutez un rapport de progression.

3 - Ajoutez un reporting sur chaque fichier rencontré.

4 - Ajoutez un rapport de progression au niveau du fichier.

-logappend

Ajouter au fichier journal (par défaut).

-nologappend

Remplacer le fichier journal.

-logprogressmsec < msec >

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

-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 aucun des paramètres maxmem et maxmempercent n’est explicitement défini, la valeur par défaut maxmempercent est utilisée.

-version

Informations sur la version renvoyée pour cet utilitaire. Spécifiez sans aucune 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 de pixel Bits/Chan

Bits/Chan

Compression

Remarques

BMP

(Windows Bitmap)

RGB | indexé

1 | 5/6 | 8

décompressé | RLE

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

EPS

(Encapsulated Postscript)

CMJN | RGB | gris

ASCII | ASCII85 | binaire | JPEG

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

CompuServe

GIF

indexé

LZW

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

JPG

(JFIF/JPEG)

CMJN | RGB | gris

JPEG

Photoshop

PSD

1 | 8 | 16

décompressé | compressé

Image fusionnée uniquement ; les calques et les autres canaux sont ignorés.

Macintosh

PICT

RVB

RLE

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

PNG

RGB | RGBA | gris | grayA | indexé

1 | 2 | 4 | 8 | 16

compressé

TIFF

1 | 8 | 16

A l’exception du premier canal alpha associé, les canaux supplémentaires sont ignorés.

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

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

Exemples section-3c1986b30315431989bd76b1ee5bef6d

Convertissez une seule image 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 TIFFs pyramidaux codés en JPEG et placez-les dans destFolder :

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

Convertissez toutes les images dans srcFolder. Les données d’image codées des fichiers de JPG sont utilisées pour la compression LZW sans perte de niveau résolution totale pour le reste de la pyramide des 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 conservées.

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

recommendation-more-help

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