ic

Utilitário de conversão de imagem.

ic é uma ferramenta de linha de comando que converte arquivos de imagem para o formato Pyramid TIFF (PTIFF) otimizado. Embora o Image Serving 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 e minimiza os tempos de resposta.

Recomenda-se que os arquivos PTIFF que contêm 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 cor ou de tipo pixel, os dados da imagem de origem 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 apenas aos níveis da pirâmide de resolução mais baixa.

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

Uso

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 (não válido se usado com SourceDirectory).
sourceFolder	Pasta contendo imagens de entrada.
destFolder	Pasta na qual os arquivos PTIFF de saída são gravados.

Retorna

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

Opções

-descompactado	Não compacte a imagem de saída.
-deflatecompress	Use a compactação deflate (zip) (padrão).
-lzwcompress	Use a compactação Lempel-Ziv-Welch (LZW).
-jpegcompress	Use a codificação JPEG. Ignorado se sourceFile incluir dados alfa.
-jpegquality <> quality >	Qualidade JPEG (0-100; o padrão é 95).
-fullsampling echrominance	Desative a redução da amostragem do croma JPEG (pode melhorar a qualidade do texto e dos gráficos de cores). Isso não tem efeito nas imagens de saída CMYK ou em tons de cinza.
-usm <> amount > <> radius > <> threshold > <> monochrome >	Aplique o mascaramento com nitidez a níveis de pirâmide subamplificados. Consulte op_usm= para obter detalhes. (Não aplicado à imagem de resolução completa.)
-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 especificado, a resolução de impressão de srcFile é copiada para destFile .
-autocortar <> 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 será gerada se o algoritmo de corte automático resultar no corte da imagem inteira. Para calcular o retângulo de corte sem converter a imagem, especifique -autorecortar sem -converter e sem destFile. corner - 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 cortar com base na cor do pixel do canto especificado; O funciona em dados de cor pré-multiplicados se os dados alfa estiverem associados à imagem de origem. Definir como 1 para cortar com base em dados alfa; corner é ignorado e 0 é sempre o valor de seed; nenhum corte será aplicado se nenhum dado alfa estiver associado à imagem de origem. tolerância - Corresponder à tolerâ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 serão gravados.
-embedXmpData	Copie XMP metadados, se disponíveis, de sourceFile para destFile sem modificação.
-embedColorProfile	Incorpore o perfil de cor ICC em destFile , se disponível (nenhum perfil é incorporado por padrão).
-imageprofile <> file >	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 incorporado em sourceFile , pois isso substitui o perfil incorporado.
-viewprofile <> file >	Caminho e nome de um arquivo de perfil ICC. Define o tipo de pixel e o espaço de cores de destFile . O IC converte para esse perfil se sourceFile tiver um perfil incorporado ou se -imageprofile também estiver especificado.
-intentPerceptual	Propósito de renderização específico para conversões de espaço de cores.
-intentRelColorimetric	Propósito de renderização Colorimétrica relativa para conversões do espaço de cores (padrão).
-intentAbsColorimetric	Intenção de renderização Colorimétrica absoluta para conversões de espaço de cores.
-intentSaturation	Propósito de renderização de saturação para conversões de espaço de cores.
-cmsNoBlackPointCompensação	Desative a compensação de pontos negros para determinadas conversões de cores Ativado por padrão.
-cmsNoDither8	Desative o pontilhamento (difusão de erros) ao converter cores.
-mainpixeltype	Desative a conversão automática de CMYK para RGB.
- forceJPEGDecompress	Forçar decodificação e recodificação de imagens de entrada JPEG. Cuidado: aplicar essa opção pode reduzir a qualidade da imagem.
-downsample2x2	Use o filtro de reamostragem de qualidade padrão (bi-linear).
-downsample8x8	Use o filtro de nova amostra de qualidade superior (janela Lanczos) (padrão).
-downsample8x8FlashPix	Use o filtro de nova amostra de maior qualidade (FlashPix).
-downsample8x8BicubicSharp	Reduza a amostra com o filtro Photoshop style 8x8 bicubic-shark.
-nousage	Quando especificado como a primeira opção, suprime a saída de informações de uso quando opções inválidas são encontradas.
-overwrite	Permita a substituição de um destFile existente. Por padrão, um sufixo numérico é anexado ao nome do arquivo para evitar a substituição.
-skiphidden	Ignorar arquivos de origem ocultos.
-contínuo	Não interrompa o processamento quando ocorrer um erro. Somente tem um efeito ao processar vários arquivos.
-logfile <> file >	Caminho e nome do arquivo de log (o padrão é stdout ).
-loglevel <> level >	Nível de log. < 0=""> 0 - Lista os arquivos a serem processados. 1 - Adicione relatórios para arquivos desnecessários. 2 - Adicionar relatório de progresso. 3 - Adicione relatórios em cada arquivo encontrado. 4 - Adicionar relatório de progresso no nível do arquivo.
-logappend	Anexar ao arquivo de log (padrão).
-nologappend	Substituir arquivo de log.
-logprogressmsec <> msec >	Intervalo de log em msec para nível de log 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 nem maxmempercent não estiverem definidos explicitamente, o padrão maxmempercent será usado.
-version	Retornar informações de versão deste utilitário. Especifique sem outras opções.

Formatos de imagem de entrada suportados

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

Formato	Pixel TypeBits/Chan	Bits/chan	Compactação	Notas
BMP (Bitmap do Windows)	RGB \| indexado	3 \| 5/6 \| 8	descompactado \| RLE	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	8	ASCII \| ASCII85 \| Binário \| JPEG	Somente os arquivos EPS gerados pelo Photoshop são compatíveis.

CompuServe GIF	indexado	8	LZW	Se estiver presente, o valor de transparência na paleta é convertido em alfa.
JPG (JFIF/JPEG)	CMYK \| RGB \| cinza	8	JPEG
Photoshop PSD	CMYK \| CMYKA \| RGB \| RGBA \| cinza \| cinzaA	1 \| 8 \| 16	descompactado \| comprimido	Somente imagem mesclada; camadas e canais extras são ignorados.
Macintosh PICT	RGB	8	RLE	Somente dados do bitmap; dados de vetor são ignorados.
PNG	RGB \| RGBA \| cinza \| cinzaA \| indexado	3 \| 2 \| 4 \| 8 \| 16	compactado
TIFF	CMYK \| CMYKA \| RGB \| RGBA \| cinza \| cinzaA \| indexado	3 \| 8 \| 16	descompactado \| ZIP \| LZW \| JPEG \| REGRA DE CRITÉRIO \| CCITT G3 \| CCITT G4 \| Embalagens	Com exceção do primeiro canal alfa associado, canais extras são ignorados.

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

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

Exemplos

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

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

Converta todas as imagens em srcFolder em TIFF de pirâmide codificados em JPEG e coloque em destFolder:

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

Converta todas as imagens em srcFolder. Os dados de imagem codificados de arquivos JPG são usados para a compactação LZW de nível de resolução total, sem perdas, para o restante da pirâmide de imagem dessas imagens, bem como para toda a imagem de saída de todos os arquivos de entrada não JPG. Os tipos de pixels, perfis de cores incorporados, metadados de XMP etc. são mantidas.

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