identify
Exemples d'utilisation • Récapitulatif des options
Le programme magick identify décrit le format et les caractéristiques d'un ou plusieurs fichiers image. Il signale également si une image est incomplète ou corrompue. Les informations renvoyées comprennent le numéro de l'image, le nom du fichier, la largeur et la hauteur de l'image, le fait que l'image utilise ou non une palette de couleurs, le nombre de couleurs de l'image, le nombre d'octets de l'image, le format de l'image (JPEG, PNM, etc.), et enfin le nombre de secondes nécessaires pour lire et traiter l'image. De nombreux autres attributs sont disponibles avec l'option verbose. Consultez Traitement en ligne de commande pour des conseils sur la façon de structurer votre commande magick identify, ou voyez ci-dessous des exemples d'utilisation de la commande.
Exemples d'utilisation
Nous présentons ici quelques exemples de la commande magick identify pour illustrer son utilité et sa simplicité d'emploi. Pour commencer, identifions une image au format JPEG :
$ magick identify rose.jpg
rose.jpg JPEG 70x46 70x46+0+0 8-bit sRGB 2.36KB 0.000u 0:00.000
Par défaut, magick identify fournit la sortie suivante :
Filename[frame #] image-format widthxheight page-widthxpage-height+x-offset+y-offset colorspace user-time elapsed-time
Ensuite, examinons la même image plus en détail :
$ magick identify -verbose rose.jpg
Image: rose.jpg
Format: JPEG (Joint Photographic Experts Group JFIF format)
Mime type: image/jpeg
Class: DirectClass
Geometry: 70x46+0+0
Units: Undefined
Type: TrueColor
Endianness: Undefined
Colorspace: sRGB
Depth: 8-bit
Channel depth:
Red: 8-bit
Green: 8-bit
Blue: 8-bit
Channel statistics:
Pixels: 3220
Red:
min: 31 (0.121569)
max: 255 (1)
mean: 145.557 (0.570814)
standard deviation: 69.1933 (0.271346)
kurtosis: -1.38945
skewness: 0.138955
entropy: 0.970683
Green:
min: 27 (0.105882)
max: 255 (1)
mean: 89.246 (0.349984)
standard deviation: 52.4608 (0.205729)
kurtosis: 2.60139
skewness: 1.80708
entropy: 0.869711
Blue:
min: 21 (0.0823529)
max: 255 (1)
mean: 80.4196 (0.315371)
standard deviation: 54.9377 (0.215442)
kurtosis: 2.93417
skewness: 1.95544
entropy: 0.853176
Image statistics:
Overall:
min: 21 (0.0823529)
max: 255 (1)
mean: 105.074 (0.412056)
standard deviation: 58.8639 (0.230839)
kurtosis: 1.37788
skewness: 1.48073
entropy: 0.897856
Rendering intent: Perceptual
Gamma: 0.454545
Chromaticity:
red primary: (0.64,0.33,0.03)
green primary: (0.3,0.6,0.1)
blue primary: (0.15,0.06,0.79)
white point: (0.3127,0.329,0.3583)
Alpha color: grey74
Background color: white
Border color: srgb(223,223,223)
Transparent color: none
Interlace: None
Intensity: Undefined
Compose: Over
Page geometry: 70x46+0+0
Dispose: Undefined
Iterations: 0
Compression: JPEG
Quality: 92
Orientation: Undefined
Properties:
jpeg:colorspace: 2
jpeg:sampling-factor: 1x1,1x1,1x1
signature: aea65c9b557d779d142f26d04abe7008bab50f1e9647faae20afdcc6c15140d5
Artifacts:
verbose: true
Tainted: False
Filesize: 2.65KB
Number pixels: 3.22K
User time: 0.000u
Elapsed time: 0:01.000
Version: ImageMagick 7.0.4-8 Q16 x86_64 http://imagemagick.org
Notez que la signature de l'image est générée à partir des composantes des pixels, et non des métadonnées de l'image.
Pour obtenir la taille d'impression en pouces d'une image à 72 DPI, utilisez :
$ magick identify -format "%[fx:w/72] by %[fx:h/72] inches" document.png
8.5 x 11 inches
La profondeur et les dimensions d'une image brute (raw) doivent être spécifiées sur la ligne de commande :
$ magick identify -depth 8 -size 640x480 image.raw
image.raw RGB 640x480 sRGB 9kb 0.000u 0:01
Ici, nous affichons les caractéristiques de texture de l'image, les moments, le hachage perceptuel et le nombre de couleurs uniques de l'image :
$ magick identify -verbose -features 1 -moments -unique image.png
Pour afficher l'enveloppe convexe et les attributs de la boîte englobante minimale de l'image, utilisez :
magick identify -define identify:convex-hull=true image.png
Voici un define spécial qui produit en sortie l'emplacement du pixel minimal ou maximal de l'image :
magick identify -precision 5 -define identify:locate=maximum -define identify:limit=3 image.png
Vous trouverez d'autres exemples d'utilisation de magick identify dans Examples of ImageMagick Usage.
Récapitulatif des options
La commande magick identify reconnaît ces options. Cliquez sur une option pour obtenir plus de détails sur son fonctionnement.
| Option | Description |
|---|---|
| -alpha | on, activate, off, deactivate, set, opaque, copy, transparent, extract, background ou shape du canal alpha |
| -antialias | supprimer le crénelage des pixels |
| -authenticate value | déchiffrer l'image avec ce mot de passe |
| -auto-orient | orienter l'image automatiquement |
| -channel type | appliquer l'option aux canaux d'image sélectionnés |
| -clip | rogner le long du premier chemin du profil 8BIM |
| -clip-mask filename | associer un masque de détourage à l'image |
| -clip-path id | rogner le long d'un chemin nommé du profil 8BIM |
| -colorspace type | définir l'espace colorimétrique de l'image |
| -crop geometry | rogner l'image |
| -debug events | afficher des informations de débogage abondantes |
| -define format:option | définir une ou plusieurs options de format d'image |
| -density geometry | densité horizontale et verticale de l'image |
| -depth value | profondeur de l'image |
| -endian type | boutisme (MSB ou LSB) de l'image |
| -extract geometry | extraire une zone de l'image |
| -features distance | analyser les caractéristiques de l'image (contraste, corrélations, etc.) |
| -format string | produire en sortie les caractéristiques de l'image au format spécifié |
| -gamma value | niveau de correction gamma |
| -grayscale method | convertir l'image en niveaux de gris |
| -help | afficher les options du programme |
| -interlace type | type de schéma d'entrelacement de l'image |
| -interpolate method | méthode d'interpolation de la couleur des pixels |
| -limit type value | limite de ressources du cache de pixels |
| -list type | Color, Configure, Delegate, Format, Magic, Module, Resource ou Type |
| -log format | format des informations de débogage |
| -mask filename | associer un masque à l'image |
| -moments | afficher les moments de l'image et le hachage perceptuel |
| -monitor | surveiller la progression |
| -negate | remplacer chaque pixel par sa couleur complémentaire |
| -ping | par défaut, déterminer efficacement certaines caractéristiques de l'image en ne lisant que les métadonnées d'image requises. Pour identifier avec précision toutes les métadonnées et caractéristiques de pixels de l'image, utilisez +ping. |
| -precision value | définir le nombre maximal de chiffres significatifs à afficher |
| -quiet | supprimer tous les messages d'avertissement |
| -regard-warnings | tenir compte des messages d'avertissement |
| -respect-parentheses | les réglages restent en vigueur jusqu'à la limite des parenthèses |
| -sampling-factor geometry | facteur d'échantillonnage horizontal et vertical |
| -set attribute value | définir un attribut d'image |
| -size geometry | largeur et hauteur de l'image |
| -strip | retirer de l'image tous les profils et commentaires |
| -unique | afficher le nombre de couleurs uniques de l'image |
| -units type | les unités de résolution de l'image |
| -version | afficher les informations de version |
| -verbose | afficher des informations détaillées sur l'image |
| -virtual-pixel method | méthode d'accès aux pixels en dehors des limites de l'image |