identify
Exemplos de uso • Resumo das opções
O programa magick identify descreve o formato e as características de um ou mais arquivos de imagem. Ele também informa se uma imagem está incompleta ou corrompida. As informações retornadas incluem o número da imagem, o nome do arquivo, a largura e a altura da imagem, se a imagem é mapeada em cores ou não, o número de cores da imagem, o número de bytes da imagem, o formato da imagem (JPEG, PNM etc.) e, por fim, o número de segundos que levou para ler e processar a imagem. Muitos outros atributos ficam disponíveis com a opção verbose. Consulte Processamento de linha de comando para orientações sobre como estruturar seu comando magick identify, ou veja abaixo exemplos de uso do comando.
Exemplos de uso
Listamos aqui alguns exemplos do comando magick identify para ilustrar sua utilidade e facilidade de uso. Para começar, vamos identificar uma imagem no formato JPEG:
$ magick identify rose.jpg
rose.jpg JPEG 70x46 70x46+0+0 8-bit sRGB 2.36KB 0.000u 0:00.000
Por padrão, o magick identify fornece a seguinte saída:
Filename[frame #] image-format widthxheight page-widthxpage-height+x-offset+y-offset colorspace user-time elapsed-time
Em seguida, examinamos a mesma imagem com mais detalhes:
$ 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
Observe que a assinatura da imagem é gerada a partir dos componentes dos pixels, não dos metadados da imagem.
Para obter o tamanho de impressão de uma imagem em polegadas a 72 DPI, use:
$ magick identify -format "%[fx:w/72] by %[fx:h/72] inches" document.png
8.5 x 11 inches
A profundidade e as dimensões de uma imagem raw devem ser especificadas na linha de comando:
$ magick identify -depth 8 -size 640x480 image.raw
image.raw RGB 640x480 sRGB 9kb 0.000u 0:01
Aqui exibimos as características de textura da imagem, os momentos, o hash perceptual e o número de cores únicas da imagem:
$ magick identify -verbose -features 1 -moments -unique image.png
Para exibir os atributos de envoltória convexa e de caixa delimitadora mínima da imagem, use:
magick identify -define identify:convex-hull=true image.png
Aqui está um define especial que mostra a localização do pixel mínimo ou máximo da imagem:
magick identify -precision 5 -define identify:locate=maximum -define identify:limit=3 image.png
Você pode encontrar mais exemplos de uso do magick identify em Examples of ImageMagick Usage.
Resumo das opções
O comando magick identify reconhece estas opções. Clique em uma opção para obter mais detalhes sobre como ela funciona.
| Opção | Descrição |
|---|---|
| -alpha | on, activate, off, deactivate, set, opaque, copy, transparent, extract, background ou shape do canal alfa |
| -antialias | remover o serrilhamento de pixels |
| -authenticate value | descriptografar a imagem com esta senha |
| -auto-orient | orientar a imagem automagicamente |
| -channel type | aplicar a opção a canais de imagem selecionados |
| -clip | recortar ao longo do primeiro caminho do perfil 8BIM |
| -clip-mask filename | associar uma máscara de recorte à imagem |
| -clip-path id | recortar ao longo de um caminho nomeado do perfil 8BIM |
| -colorspace type | definir o espaço de cor da imagem |
| -crop geometry | recortar a imagem |
| -debug events | exibir informações abundantes de depuração |
| -define format:option | definir uma ou mais opções de formato de imagem |
| -density geometry | densidade horizontal e vertical da imagem |
| -depth value | profundidade da imagem |
| -endian type | ordenação de bytes (MSB ou LSB) da imagem |
| -extract geometry | extrair uma área da imagem |
| -features distance | analisar as características da imagem (p. ex. contraste, correlações etc.) |
| -format string | exibir as características da imagem formatadas |
| -gamma value | nível de correção de gama |
| -grayscale method | converter a imagem para escala de cinza |
| -help | exibir as opções do programa |
| -interlace type | tipo de esquema de entrelaçamento da imagem |
| -interpolate method | método de interpolação de cor de pixel |
| -limit type value | limite de recurso do cache de pixels |
| -list type | Color, Configure, Delegate, Format, Magic, Module, Resource ou Type |
| -log format | formato das informações de depuração |
| -mask filename | associar uma máscara à imagem |
| -moments | exibir os momentos da imagem e o hash perceptual |
| -monitor | monitorar o progresso |
| -negate | substituir cada pixel por sua cor complementar |
| -ping | por padrão, determinar de forma eficiente certas características da imagem lendo apenas os metadados de imagem necessários. Para identificar com precisão todos os metadados e características de pixel da imagem, use +ping. |
| -precision value | definir o número máximo de algarismos significativos a serem exibidos |
| -quiet | suprimir todas as mensagens de aviso |
| -regard-warnings | dar atenção às mensagens de aviso |
| -respect-parentheses | as configurações permanecem em vigor até o limite dos parênteses |
| -sampling-factor geometry | fator de amostragem horizontal e vertical |
| -set attribute value | definir um atributo da imagem |
| -size geometry | largura e altura da imagem |
| -strip | remover da imagem todos os perfis e comentários |
| -unique | exibir o número de cores únicas da imagem |
| -units type | a unidade de resolução da imagem |
| -verbose | exibir informações detalhadas sobre a imagem |
| -version | exibir informações de versão |
| -virtual-pixel method | método de acesso a pixels fora dos limites da imagem |