Documentação API de disponibilização e renderização de imagens do Dynamic Media

ic ic

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Tópicos:

Criado para:

Desenvolvedor
Usuário

Utilitário de conversão de imagem.

ic é uma ferramenta de linha de comando que converte arquivos de imagem para o formato de TIFF de Pirâmide otimizado (PTIFF). Embora o Servidor de imagens possa processar imagens sem conversão, recomendamos que você converta todas as imagens com mais de 512x512 pixels em PTIFF. Essa conversão garante o desempenho ideal do servidor e o uso de recursos, além de minimizar os tempos de resposta.

Recomenda-se que os arquivos PTIFF com conteúdo fotográfico sejam codificados em JPEG (especifique -jpegcompress). O conteúdo gerado pelo computador pode se beneficiar da compactação sem perdas (-deflatecompress ou -lzwcompress). A menos que seja necessária uma conversão de cores ou de tipo de pixel, os dados da imagem de origem de JPEG são transferidos para o PTIFF sem decodificação, para evitar degradação de qualidade. Nesse caso, as opções de compactação especificadas se aplicam somente aos níveis de pirâmide de resolução mais baixa.

Se você não estiver convertendo imagens grandes, não precisará definir os parâmetros que controlam quanta memória usar. No entanto, se estiver, dê mais memória a ic usando a configuração -maxmem descrita abaixo. Uma boa regra geral para calcular a quantidade de memória necessária é multiplicar a largura da imagem pela altura da imagem multiplicada pelo número de canais. Por exemplo, quatro para uma imagem de RGB com alfa vezes três. Além disso, se os canais forem de 16 bits por componente, em vez de 8, dobre o resultado final.

Uso section-fb5293fa79894442aba831c1e14c5cc9

ic -convert [options]sourceFiledestFile

ic -convert [options]sourceFolderdestFolder

-c -convert [options]sourceFiledestFolder

opções

Opções de comando (veja abaixo).

sourceFile

Arquivo de imagem de entrada única.

destFile

Arquivo PTIFF de saída único (inválido se usado com SourceDirectory).

sourceFolder

Pasta contendo imagens de entrada.

destFolder

Pasta na qual os arquivos PTIFF de saída são gravados.

Devoluções section-36a2dcfa39824d29b69547c432366219

0 se bem-sucedido. Se ocorrer um erro, um valor diferente de zero será retornado e os detalhes do erro serão enviados para stderr.

Opções section-df311ace43f947b3817b60b667ae04ca

-descompactado

Não compacte a imagem de saída.

-deflatecompress

Usar compactação deflate (zip) (padrão).

-lzwcompress

Use a compactação Lempel-Ziv-Welch (LZW).

-jpegcompress

Use a codificação JPEG. Ignorado se sourceFile inclui dados alfa.

-jpegquality < quality >

qualidade de JPEG (0-100; o padrão é 95).

-fullsamplechrominance

Desative a redução de resolução de croma JPEG (pode melhorar a qualidade do texto e dos gráficos coloridos). Isso não afeta imagens de saída CMYK ou em tons de cinza.

-usm < valor > < raio > < limite > < monocromático >

Aplique a máscara sem nitidez a níveis de pirâmide de subamostragem. Consulte op_usm=para obter detalhes. (Não aplicado à imagem com resolução total.)

-applyClippath

Use o caminho do clipe no arquivo de origem, se houver, para criar dados alfa associados.

-dpi < dpi >

Resolução de impressão (dpi) para destFile ; se não especificada, a resolução de impressão de srcFile é copiada para destFile .

-autocrop < canto > < modo > < tolerância > < infoFile >

Calcule um retângulo de corte para minimizar um plano de fundo de cor sólida. Nenhuma informação de corte é gerada se o algoritmo de corte automático resultar no corte da imagem inteira.

Para calcular o retângulo de recorte sem converter a imagem, especifique -autocrop sem -convert e sem destFile.

canto - ul | ur | ll | lr

Especifica qual canto da imagem usar um ponto de propagação. Ignorado se o modo for 1.

modo - 0 | 1

Defina como 0 para recortar com base na cor do pixel de canto especificado; funciona em dados de cor pré-multiplicados se os dados alfa estiverem associados à imagem de origem.

Defina como 1 para recortar com base em dados alfa; o canto é ignorado e 0 é sempre o valor de seed; nenhum recorte é aplicado se nenhum dado alfa estiver associado à imagem de origem.

tolerância - Tolerância de correspondência. Valor real de 0,0 a 1,0. Especifica a tolerância para valores de componentes de pixel correspondentes. Defina como 0 para correspondências exatas.

infoFile - Caminho e nome do arquivo de saída XML no qual os dados de informações de corte são gravados.

-embedXmpData

Copiar metadados XMP, se disponíveis, de sourceFile para destFile sem modificação.

-embedColorProfile

Incorpore o perfil de cores ICC em destFile , se disponível (nenhum perfil é incorporado por padrão).

-imageprofile < arquivo >

Caminho e nome de um arquivo de perfil ICC. Define o espaço de cores de sourceFile e deve corresponder ao seu tipo de pixel. Deve ser especificado somente se nenhum perfil estiver inserido em sourceFile , pois isso substitui o perfil inserido.

-viewprofile < arquivo >

Caminho e nome de um arquivo de perfil ICC. Define o tipo de pixel e o espaço de cor de destFile . A IC converte para este perfil se sourceFile tiver um perfil incorporado ou se -imageprofile também estiver especificado.

-intentPerceptual

Tentativa de renderização perceptiva para conversões do espaço de cores.

-intentRelColorimetric

Tentativa de renderização Colorimétrica relativa para conversões do espaço de cores (padrão).

-intentAbsColorimetric

Tentativa de renderização colorimétrica absoluta para conversões de espaço de cores.

-intentSaturation

Tentativa de renderização de saturação para conversões de espaço de cor.

-cmsNoBlackPointCompensation

Desabilitar compensação de ponto negro para determinadas conversões de cores

Ativado por padrão.

-cmsNoDither8

Desativar pontilhamento (difusão de erro) ao converter cores.

-maintainpixeltype

Desative a conversão automática de CMYK para RGB.

- forceJPEGDecompress

Forçar a decodificação e a recodificação de imagens de entrada de JPEG.

Cuidado: a aplicação desta opção pode reduzir a qualidade da imagem.

-downsample2x2

Usar filtro de reamostragem de qualidade padrão (bi-linear).

-downsample8x8

Usar o filtro de reamostragem (padrão) de maior qualidade (janela Lanczos).

-downsample8x8FlashPix

Use o filtro de reamostragem de qualidade superior (FlashPix).

-downsample8x8BicubicSharp

Reduza a resolução com o filtro de nitidez bicúbica estilo Photoshop 8x8.

-nousage

Quando especificada como a primeira opção, suprime a saída de informações de uso quando opções inválidas são encontradas.

-substituir

Permitir substituição de um destFile existente. Por padrão, um sufixo numérico é anexado ao nome do arquivo para impedir a substituição.

-ignorado

Ignorar arquivos de código-fonte ocultos.

-continueonerror

Não pare o processamento quando ocorrer um erro. Tem efeito somente ao processar vários arquivos.

-logfile < arquivo >

Caminho e nome do arquivo de log (o padrão é stdout ).

-loglevel < level >

Nível de log.

< 0 - Registro desativado.

0 - Lista os arquivos a serem processados.

1 - Adicionar relatórios para arquivos desnecessários.

2 - Adicionar relatório de progresso.

3 - Adicionar relatórios sobre cada arquivo encontrado.

4 - Adicionar relatórios de progresso no nível do arquivo.

-logappend

Anexar ao arquivo de log (padrão).

-nologappend

Substituir arquivo de log.

-logprogressmsec < ms >

Intervalo de log em ms para loglevel 2 e superior (o padrão é 3000).

-maxmem < bytes >

Limite de uso de memória. Deve ter pelo menos 10 MB.

-maxmempercent < percent >

Limite de uso de memória. O padrão é 25% da memória física. Se maxmem ou maxmempercent não forem explicitamente definidos, o maxmempercent usará o padrão maxmempercent.

-versão

Informações de versão de retorno para este utilitário. Especifique sem nenhuma outra opção.

Formatos de imagem de entrada compatíveis section-ab13d941d6724e65b9f84b62d949d31c

A tabela a seguir lista os formatos de arquivo de imagem e as opções de formato compatíveis com IC.

Formato

Tipo De Pixel Bits/Chan

Bits/Chan

Compactação

Notas

BMP

(Bitmap do Windows)

RGB | indexado

1 | 5/6 | 8

descompactado | REGRA

5/6 bits/canal indica suporte para RGB de 16 bits (5-5-5 e 5-6-5 bits/canal).

EPS

(Postscript Encapsulado)

CMYK | RGB | cinza

ASCII | ASCII85 | Binário | JPEG

Somente os arquivos EPS gerados pelo Photoshop são compatíveis.

CompuServe

GIF

indexado

LZW

Se presente, o valor de transparência na paleta é convertido em alfa.

JPG

(JFIF/JPEG)

CMYK | RGB | cinza

JPEG

Photoshop

PSD

1 | 8 | 16

descompactado | compactado

Somente imagem mesclada; camadas e canais extras são ignorados.

Macintosh

PICT

RGB

REGRA

Somente dados de bitmap; dados de vetor são ignorados.

PNG

RGB | RGBA | cinza | grayA | indexado

1 | 2 | 4 | 8 | 16

compactado

TIFF

1 | 8 | 16

Com exceção do primeiro canal alfa associado, os canais extras são ignorados.

Os perfis ICC incorporados são reconhecidos nos arquivos EPS, JPG, PSD, PNG e TIFF.

Caminhos incorporados e metadados XMP são reconhecidos em arquivos EPS, JPG, PSD e TIFF.

Exemplos section-3c1986b30315431989bd76b1ee5bef6d

Converta uma única imagem com a melhor qualidade e mantenha-a na mesma pasta:

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

Converter todas as imagens em srcFolder para TIFF de pirâmide codificada em JPEG e colocar em destFolder:

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

Converter todas as imagens em srcFolder. Os dados de imagem codificados dos arquivos JPG são usados para a compressão LZW de nível de resolução total e sem perdas para o restante da pirâmide de imagem dessas imagens, bem como para a imagem de saída inteira de todos os arquivos de entrada não JPG. Os tipos de pixel, perfis de cores incorporados, metadados XMP e assim por diante. são mantidos.

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

recommendation-more-help

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