⚠️ Este é um site de tradução não oficial, sem relação com a ImageMagick Studio LLC. Para informações oficiais, consulte a página original (https://imagemagick.org/defines/).

A opção de linha de comando -define adiciona configurações globais específicas, geralmente usadas para controlar coders e operações de processamento de imagem.

Esta opção cria uma ou mais definições para que coders e decoders as utilizem ao ler e gravar dados de imagem. As definições são geralmente usadas para controlar os módulos coder de formatos de arquivo de imagem e as operações de processamento de imagem, além do que é fornecido pelos meios normais. As configurações definidas são listadas nas informações de -verbose (formato de saída "info:") como "Artifacts".

Se o valor estiver ausente em uma definição, é criada uma definição de flag com valor vazio com esse nome. Isso é usado para controlar opções liga/desliga. Use -define keys para remover definições criadas anteriormente. Use +define "*" para remover todas as definições existentes.

As mesmas configurações de "artifact" também podem ser definidas com a opção -set "option:key" "value", que também permite o uso de Format and Print Image Properties no valor definido.

A opção e a chave são independentes de maiúsculas/minúsculas (são convertidas para minúsculas para uso interno dos decoders), enquanto o valor depende de maiúsculas/minúsculas.

Tais configurações têm escopo global e afetam todas as imagens e operações.

magick bilevel.tif -define ps:imagemask eps3:stencil.ps
magick arrow.tga -set colorspace:auto-grayscale=off myArrow.tga

Prefixe o valor com registry: para definir atributos do registro de imagem. Por exemplo, para definir um caminho temporário onde colocar arquivos de trabalho, use:

-define registry:temporary-path=/data/tmp

Veja a seguir uma lista de defines reconhecidos.

Defines de linha de comando

Define Descrição
ashlar:best-fit alinha os ladrilhos nas bordas esquerda e direita.
ashlar:tiles define o número máximo de ladrilhos de imagem a renderizar por canvas.
auto-threshold:verbose retorna o limiar derivado como a propriedade de imagem auto-threshold:threshold.
color:illuminant iluminante de referência, padrão D65.
colorspace:auto-grayscale=on|off Impede a conversão automática para escala de cinza dentro dos coders que suportam escala de cinza. Isso deve ser acompanhado de -type truecolor. PNG e TIF não precisam deste define. Com PNG, basta usar PNG24:image. Com TIF, basta usar -type truecolor. JPG e PSD precisarão deste define.
compare:frequency-domain=boolean Certas métricas de similaridade, como DPC, MSE, NCC, PSNR, Phase e RMSE, operam no domínio da frequência quando FFTW e HDRI estão habilitados. Para utilizar seus equivalentes espaciais, você pode usar o comando -define compare:frequency-domain=false. Observe, porém, que as métricas DPC e PHASE não têm equivalentes espaciais, portanto este comando será ignorado para elas.
compare:ssim-radius=value Define o raio do índice de similaridade estrutural.
compare:ssim-sigma=value Define o sigma do índice de similaridade estrutural.
compare:ssim-k1=value Define o argumento k1 do índice de similaridade estrutural.
compare:ssim-k2=value Define o argumento k2 do índice de similaridade estrutural.
compare:virtual-pixels=boolean O ImageMagick compara imagens pixel a pixel, alinhando a partir do canto superior esquerdo. Se os tamanhos diferirem, as áreas não correspondentes na imagem menor são tratadas como pixels virtuais, podendo afetar os resultados da comparação. Para limitar a comparação apenas aos pixels autênticos, use -define compare:virtual-pixels=false.
complex:snr=value Define a constante SNR de divisão de -complex.
compose:args=arguments Define certos valores de argumento de composição ao usar convert ... -compose ... -composite. Veja Image Composition.
compose:clip-to-self=true|false Alguns métodos de -compose podem modificar a imagem de "destino" fora da área de sobreposição. Está desabilitado por padrão.
compose:clamp=on|off Define como zero cada pixel cujo valor esteja abaixo de zero e como o quantum range (por exemplo, 65535) qualquer pixel cujo valor esteja acima do quantum range; caso contrário, o valor do pixel permanece inalterado. Define suportado no ImageMagick 6.9.1-3 e posteriores.
compose:colorspace=colorspace Define o espaço de cor para o operador de composição colorize. O padrão é HCL.
compose:compose=on|off Este uso especial permite realizar matemática verdadeira dos canais da imagem, sem que os efeitos de composição alfa estejam envolvidos.
connected-components:angle-threshold=value Mescla qualquer região cujo ângulo da elipse equivalente seja menor que value na região circundante ou no maior vizinho. Suportado no Imagemagick 7.0.9.24.
connected-components:area-threshold=value Mescla qualquer região com área menor que value na região circundante ou no maior vizinho. Os limiares podem opcionalmente incluir intervalos, por exemplo, 410-1600.
connected-components:background-id=object-id Identifica qual objeto será o objeto de fundo. Suportado no Imagemagick 7.0.9.21.
connected-components:circularity-threshold=value Mescla qualquer região com circularidade menor que value na região circundante ou no maior vizinho. A circularidade é calculada como 4piarea/perimeter^2. Suportado no Imagemagick 7.0.9.24.
connected-components:diameter-threshold=value Mescla qualquer região com diâmetro menor que value na região circundante ou no maior vizinho. O diâmetro é calculado como sqrt(4*area/pi). Suportado no Imagemagick 7.0.9.24.
connected-components:eccentricity-threshold=value Mescla qualquer região cuja excentricidade da elipse equivalente seja menor que value na região circundante ou no maior vizinho. Suportado no Imagemagick 7.0.9.24.
connected-components:exclude-header=true Lista os objetos sem o cabeçalho. Suportado no Imagemagick 7.0.9.21.
connected-components:keep=list-of-ids Lista de valores de id, separados por vírgulas e/ou hifenizados, a manter na saída. Suportado no Imagemagick 6.9.3-0.
connected-components:keep-colors=red;green;blue Mantém objetos identificados por sua cor em uma lista separada por ponto e vírgula. Suportado no Imagemagick 6.9.3-0.
connected-components:keep-top=number-of-objects Mantém apenas os primeiros number objetos por área. Suportado no Imagemagick 7.0.9.21.
connected-components:major-axis-threshold=value Mescla qualquer região cujo diâmetro do eixo maior da elipse equivalente seja menor que value na região circundante ou no maior vizinho. Suportado no Imagemagick 7.0.9.24.
connected-components:mean-color=true Altera a imagem de saída de valores de id para valores de cor média. Suportado no Imagemagick 6.9.2-8.
connected-components:minor-axis-threshold=value Mescla qualquer região cujo diâmetro do eixo menor da elipse equivalente seja menor que value na região circundante ou no maior vizinho. Suportado no Imagemagick 7.0.9.24.
connected-components:perimeter-threshold=value Mescla qualquer região com perímetro menor que value na região circundante ou no maior vizinho. Suportado no Imagemagick 7.0.9.24.
connected-components:remove=list-of-ids Lista de valores de id, separados por vírgulas e/ou hifenizados, a remover da saída. Suportado no Imagemagick 6.9.2-9.
connected-components:remove-colors=red;green;blue Remove objetos identificados por sua cor em uma lista separada por ponto e vírgula. Suportado no Imagemagick 6.9.3-0.
connected-components:verbose=true Lista id, bounding box, centroide, área e cor média de cada região.
convolve:scale={kernel_scale}[!^] [,{origin_addition}] [%] Define a escala do kernel. A flag especial ! escala automaticamente para a faixa dinâmica completa. A flag ! pode ser usada em combinação com um fator ou porcentagem. O fator ou a porcentagem é então aplicado após a escala automática. Um exemplo é 50%!. Isso produz um resultado 50% mais escuro que a escala da faixa dinâmica completa. A flag ^ garante que o kernel seja de "soma zero", por exemplo, quando alguns valores são positivos e outros negativos, como em kernels de detecção de bordas. O origin addition adiciona esse valor ao pixel central do kernel. Isso produz um efeito semelhante a adicionar a imagem aquele número de vezes ao resultado da imagem filtrada. O valor típico é 1, de modo que a imagem original seja adicionada ao resultado da convolução. O padrão é 0.
deskew:auto-crop=true recorta automaticamente a imagem após o endireitamento.
delegate:bimodal=true Especifica a conversão direta de Postscript para PDF.
distort:scale=value Define o fator de escala de saída para uso com -distort.
distort:viewport=WxH+X+Y Define o viewport para uso com -distort.
dither:diffusion-amount=X% Define a quantidade de difusão a usar com a difusão de Floyd-Steinberg.
exif:sync-image=false Por padrão, a resolução da imagem é sincronizada com o perfil EXIF. Use este define para ignorar o perfil EXIF.
filename:literal=true Por padrão, os nomes de arquivo de saída podem conter caracteres de formatação embutidos. Use esta opção para evitar a interpretação dos caracteres de formatação embutidos e, em vez disso, usar o nome do arquivo literalmente.
filter:option=value Define uma opção de filtro para uso com -resize. Veja abaixo as opções específicas.
filter:b=value Redefine o fator de spline usado para filtros cúbicos como Cubic, Catrom, Mitchel e Hermite, bem como para a função de janela cúbica de Parzen. Se apenas um dos valores b ou c for definido, o outro é ajustado de modo a gerar um filtro 'Cubic-Keys'. O significado dos valores b e c foi definido em um artigo de pesquisa de Mitchell-Netravali.
filter:blur=factor Escala o eixo X do filtro (e de sua janela). Use > 1.0 para desfoque ou < 1.0 para nitidez. Isso só deve ser usado com filtros Gaussianos e similares ao Gaussiano simples, ou você pode não obter os resultados esperados.
filter:c=value Redefine o fator alfa de Keys usado para filtros cúbicos como Cubic, Catrom, Mitchel e Hermite, bem como para a função de janela cúbica de Parzen. Se apenas um dos valores b ou c for definido, o outro é ajustado de modo a gerar um filtro 'Cubic-Keys'. O significado dos valores b e c foi definido em um artigo de pesquisa de Mitchell-Netravali.
filter:kaiser-alpha=value Define o valor alfa da janela de Kaiser. Quando multiplicado por 'PI', é equivalente a "kaiser-beta" e substituirá essa configuração. Afeta apenas a função de janela de Kaiser e não afeta nenhum outro atributo.
filter:kaiser-beta=value Define o valor beta da janela de Kaiser. Afeta apenas a função de janela de Kaiser e não afeta nenhum outro atributo. Antes do ImageMagick v6.7.6-10, esta opção era conhecida como "filter:alpha" (uma herança do antiquíssimo programa "zoom"). Foi alterada para alinhar a função ao uso mais moderno da pesquisa acadêmica e atribuí-la de forma mais definitiva. O valor padrão é 6.5
filter:lobes=count Define o número de lóbulos a usar para o filtro Sinc/Bessel. Esta é uma forma alternativa de especificar a faixa de 'support' do filtro, projetada para ser mais adequada a filtros com janela, especialmente quando usados para distorções de imagem.
filter:sigma=value Define o valor 'sigma' usado para definir o filtro Gaussiano. O valor sigma padrão é '0.5'. Afeta apenas o filtro Gaussiano, mas não encolhe (embora possa ampliar) o 'support' do filtro. Pode ser usado para gerar desfoques muito pequenos, mas sem que o filtro 'perca' pixels devido ao uso de uma configuração de support pequena. Um valor maior de '0.707' (um valor de '1/sqrt(2)') é outra configuração comum.
filter:support=radius Define o raio de support do filtro. Define o tamanho do filtro e, portanto, define diretamente quão lento é o processo de reamostragem filtrada. Todos os filtros têm um tamanho de support 'preferencial' padrão. Alguns filtros, como Lagrange e os filtros com janela, ajustam-se a si mesmos dependendo desse valor. Com filtros simples, esse valor ou não faz nada (apenas torna a reamostragem mais lenta) ou recorta a função do filtro de forma prejudicial.
filter:verbose=true Habilita a impressão de informações sobre a seleção final do filtro interno na saída padrão. Isso inclui um cabeçalho comentado sobre as configurações do filtro em uso e dados que permitem representar facilmente os pesos do filtro em um gráfico. Observe, porém, que alguns filtros são definidos internamente em termos de outros filtros. O filtro Lanczos, por exemplo, é definido em termos de um filtro SincFast com janela SincFast, enquanto o filtro Mitchell é definido como um filtro da família Cubic geral com configurações 'B' e 'C' específicas.
filter:window=filter_function Os filtros IIR (resposta ao impulso infinita) Sinc e Jinc recebem janela (são reduzidos a zero ao longo da faixa de support definida) com o filtro fornecido. Isso permite especificar uma função de filtro a ser usada como função de janela para esses filtros IIR. Muitos dos filtros definidos são, na verdade, funções de janela para esses filtros IIR. Uma escolha típica é Box (que efetivamente desliga a função de janela).
filter:window-support=radius Escala a função de janela para este tamanho. Isso faz com que a janela (ou o filtro Lagrange auto-janelado) atue como se a janela de support fosse maior do que a realmente fornecida ao operador chamador. O filtro, no entanto, ainda é recortado para o tamanho de support verdadeiro fornecido. Se não definido, será igual ao tamanho de support normal do filtro.
h:format=value Define o formato de codificação de imagem a usar ao gravar um cabeçalho no estilo C. format pode ser qualquer formato de saída suportado pelo ImageMagick, exceto h e magick. Se esta opção for omitida, o padrão é GIF para imagens PseudoClass e PNM para imagens DirectClass.
fourier:normalize=inverse Define a localização da normalização FFT/IFT usada por +-fft e +-ift. O padrão é forward.
frames:step Ao selecionar frames de imagem, o padrão é avançar um frame por vez ao longo de uma lista; por exemplo, [0-3] retorna os frames 0, 1, 2 e 3. Defina o step como 2 neste exemplo e, em vez disso, obteremos os frames 0 e 2.
fx:debug=true Depura a expressão -fx.
hough-lines:accumulator=true Retorna a imagem do acumulador além da imagem das linhas.
identify:convex-hull=true Exibe o fecho convexo e a caixa delimitadora mínima.
identify:locate=value Exibe as localizações de pixel mínimas ou máximas. Os valores válidos são minimum ou maximum. O padrão é maximum.
identify:limit=value O número máximo de localizações de pixel a exibir ao usar identify:locate.
json:features Inclui características nas informações detalhadas.
kmeans:seed-colors=color-list Inicializa as cores, onde color-list é uma lista de cores semente delimitada por ponto e vírgula (por exemplo, red;sRGB(19,167,254);#00ffff)
magick:format=value Define o formato de codificação de imagem a usar ao gravar um cabeçalho no estilo C. É o mesmo que "h:format=format" descrito acima.
magnify:method=value Escolhe o método de ampliação de pixel art. As opções são: eagle2X, eagle3X, eagle3XB, epb2X, fish2X, hq2X, scale2X (padrão), scale3X, xbr2X
modulate:colorspace=colorspace Define o espaço de cor a usar com -modulate. Qualquer espaço de cor baseado em matiz pode ser usado. O padrão é HSL.
morphology:compose=compose-method Especifica como mesclar os resultados gerados por múltiplos kernels de morphology. O padrão é none. Um valor típico é 'lighten', usado, por exemplo, com os kernels de bordas sobel.
morphology:showKernel=1 Imprime (na "saída de erro padrão") todas as informações sobre um kernel de -morphology gerado.
phash:colorspaces=colorspace,colorspace,... O hash perceptual usa por padrão os espaços de cor xyY e HSB. Ao usar este define, você pode especificar até seis espaços de cor alternativos. (a partir do IM 7.0.3-8)
phash:normalize=true Normaliza a métrica phash
pixel:compliance={none|undefined|svg|mvg|x11|xpm} Em combinação com -depth, este define permite que os valores de cor sejam apresentados em uma ou em uma combinação de: porcentagem, nomes, componentes de 8 bits ou valores hexadecimais. Valores de profundidade de 16 bits geralmente são mostrados como porcentagens e valores de profundidade de 8 bits geralmente são mostrados como uma combinação de nomes de cor e valores de componente de 8 bits.
png:bit-depth=value
png:chunk-malloc-max=value Define o tamanho máximo de chunk.
profile:skip=name1,name2,... Pula o(s) perfil(is) nomeado(s) ao ler a imagem. Use skip="*" para pular todos os perfis nomeados na imagem. Existem muitos perfis nomeados, incluindo ICC, EXIF, APP1, IPTC, XMP e outros.
precision:highres-transform=true Aumenta a precisão da transformação de perfil. Observe que há uma leve penalidade de desempenho, pois a transformação de alta precisão é em ponto flutuante em vez de não sinalizada. É importante notar que os resultados podem depender de a imagem original já ter ou não um perfil incluído.
preserve-timestamp=true|false Preserva o timestamp do arquivo (apenas mogrify).
q-table=quantization-table.xml Tabelas de quantização JPEG personalizadas.
quantum:format=type Defina o type como floating-point para especificar um formato de ponto flutuante para arquivos raw (por exemplo, GRAY:) ou para imagens MIFF e TIFF no modo HDRI, a fim de preservar valores negativos. Se -depth 16 for incluído, o resultado é um formato de ponto flutuante de precisão simples. Se -depth 32 for incluído, o resultado é um formato de ponto flutuante de precisão dupla. Para dados de pixel sinalizados, use -define quantum:format=signed
quantum:maximum=value Valor máximo para certos tipos de imagem, como DCM. Se não definido, o valor máximo é QuantumRange.
quantum:minimum=value Valor mínimo para certos tipos de imagem, como DCM. Se não definido, o valor mínimo é zero.
quantum:polarity=photometric-interpretation Define a interpretação fotométrica de uma imagem (normalmente para o formato de arquivo de imagem TIFF) como min-is-black (padrão) ou min-is-white.
registry:attribute=value Define atributos do registro de imagem, por exemplo, registry:temporary-path=/data/tmp.
registry:date:precision=length Define o número máximo de caracteres impressos para qualquer timestamp.
registry:option:pedantic=true false | Por padrão, se uma opção de linha de comando também for um nome de arquivo (por exemplo, -quality), ela é interpretada como um nome de arquivo. Defina esta opção como true para interpretá-la como uma opção.
registry:precision=value Define o número máximo de algarismos significativos a serem impressos.
resample:verbose=true Imprime a tabela de consulta do filtro cilíndrico criada pelo algoritmo de reamostragem EWA (Elliptical Weighted Average). Observe que esta tabela usa um valor de consulta de raio ao quadrado. Isso normalmente só é usado para depurar a reamostragem EWA.
sample:offset=geometry Localização do ponto de amostragem dentro da sub-região que está sendo amostrada, expressa como porcentagens (veja -sample).
shepards:power=value Define o expoente na distorção de Shepard. O padrão é 2.
stream:buffer-size=value Define o tamanho do buffer de stream. Selecione 0 para I/O sem buffer.
trim:percent-background=X% Define a quantidade de fundo tolerada em uma borda. É especificada como uma porcentagem. 0% significa que nenhum fundo é tolerado. 50% significa que uma borda pode conter até 50% de pixels que são fundo de acordo com o fuzz-factor.
trim:edges={north,east,south,west} Apara apenas as bordas especificadas da imagem.
trim:minSize=geometry Limita a aparagem ao tamanho especificado.
type:features=string Adiciona uma característica de fonte a ser usada pelo delegate RAQM durante a disposição de texto complexa. Geralmente é usada para ativar características de fonte opcionais que não estão habilitadas por padrão, mas também pode ser usada para desativar características de fonte padrão. As características incluem aquelas que controlam kerning, ligaduras e árabe.
type:hinting=false Desabilita o hinting de fonte. A renderização adequada de glifos requer que os pontos escalonados sejam alinhados ao grid de pixels do dispositivo de destino, por meio de uma operação frequentemente chamada de hinting. Um de seus principais objetivos é garantir que larguras e alturas importantes sejam respeitadas em toda a fonte. (Por exemplo, é muito frequente desejar que os glifos 'I' e 'T' tenham sua linha vertical central com a mesma largura de pixel. O hinting também gerencia características como hastes e overshoots, que podem causar problemas em tamanhos pequenos de pixel.
white-balance:vibrance=value{%} Mudança no vibrance de cor dos canais a e b.
x:screen=true Obtém a imagem a partir da janela raiz.
x:silent=true Desliga o bipe ao importar uma imagem.

IMAGE FORMATS

Define Descrição
bmp3:alpha=true|false Inclui qualquer canal alfa ao gravar no formato de imagem BMP.
bmp:format=value Os valores válidos são bmp2, bmp3 e bmp4. Esta opção pode ser útil quando o método de prefixar "BMP2:" ao nome do arquivo de saída é inconveniente ou não está disponível, como ao usar o utilitário mogrify.
bmp:subtype=value Subtipos de profundidade de canal BMP. As opções são: RGB555, RGB565, ARGB4444, ARGB1555. Suportado apenas em BMP (BMP4). BMP3 e BMP2 não contêm campos de cabeçalho para suportar essas opções.
{caption,label}:{max,start}-pointsize=value Define o pointsize delimitador a usar ao procurar o pointsize máximo em que a anotação de texto ainda cabe dentro dos limites da imagem.
dcm:display-range=reset Define a faixa de exibição para os valores de pixel mínimo e máximo do formato de imagem DCM.
dcm:fix-byte-order=true Corrige a ordem de bytes incorreta ao ler pixels do arquivo.
dcm:rescale=true Habilita a interpretação das configurações de rescale slope e intercept no arquivo.
dcm:rescale=true Habilita a interpretação das configurações de rescale slope e intercept no arquivo.
dcm:window=CxW Especifica o centro e a largura da janela dcm.
dds:cluster-fit=true|false Habilita o cluster-fit do DDS.
dds:compression=dxt1|dxt5|none Define a compressão do dds.
dds:mipmaps=value Define o número de mipmaps do dds.
dds:weight-by-alpha=true|false Habilita a ponderação por alfa do DDS.
dng:max-raw-memory=value Interrompe o processamento se o tamanho do buffer raw crescer além desse valor (em megabytes). O padrão é 8192.
dng:no-auto-bright=true Desabilita o nível de branco baseado em histograma.
dng:output-color=value Seleciona o espaço de cor de saída. As opções são: 0 - Raw color (única para cada câmera), 1 - sRGB D65 (padrão), 2 - Adobe RGB (1998) D65, 3 - Wide Gamut RGB D65, 4 - Kodak ProPhoto RGB D65, 5 - XYZ, 6 - ACES
dng:read-thumbnail=true Lê a miniatura embutida e a armazena como um perfil chamado 'dng:thumbnail'.
dng:use-auto-wb=true Calcula o balanço de branco fazendo a média de toda a imagem.
dng:use-camera-wb=true Usa o balanço de branco especificado pela câmera. O padrão é true.
dot:layout-engine=value Especifica o mecanismo de layout para o formato de imagem DOT (por exemplo, neato).
eps:use-cropbox=true Força o ImageMagick a respeitar a crop box.
exr:color-type=value Especifica o tipo de cor para o formato EXR: RGB, RGBA, YC, YCA, Y, YA, R, G, B, A).
fpx:view=value Especifica o objeto de visualização do FlashPix, que contém a especificação de uma transformação de visualização. A transformação de visualização permite que aplicações representem um conjunto de edições simples como uma lista de "comandos" aplicados à imagem em tempo real sem alterar a imagem original.
ftxt:chsep=value Um único caractere de texto que separa os valores de canal para leitura e gravação. Padrão: "," (vírgula).
ftxt:format=value A string de formato para gravação e leitura. Padrão: "\x,\y:\c". Para escapes como \x etc., veja ftxt: formatted text.
ftxt:hasalpha=value Se o texto tem um canal alfa, apenas para leitura. Padrão: false.
ftxt:nummeta=value O número de canais meta, apenas para leitura. Padrão 0 (zero).
heic:chroma=value Define o parâmetro chroma do HEIC. Os valores possíveis são: "420", "422", "444". O padrão é "420".
heic:cicp=value Define as primárias de cor, características de transferência, coeficientes de matriz e flag de faixa completa do HEIC. Use 1/13/6/1 para BT.709 de faixa completa. Veja a norma ISO/IEC 14496-12:2022 para uma descrição desses campos e valores.
heic:depth-image=true Extrai a imagem de profundidade se o contêiner tiver uma.
heic:max-number-of-tiles=value Define o número máximo de ladrilhos de uma imagem HEIC.
heic:max-bayer-pattern-pixels=value Define o tamanho máximo do padrão bayer em pixels de uma imagem HEIC.
heic:max-items=value Define o número máximo de itens em uma box de uma imagem HEIC.
heic:max-components=value Define o número máximo de componentes de uma imagem HEIC.
heic:max-iloc-extents-per-item=value Define o número máximo de extents na box iloc de uma imagem HEIC.
heic:max-size-entity-group=value Define o tamanho máximo de um grupo de entidades de uma imagem HEIC.
heic:max-children-per-box=value Define o número máximo de filhos por box de uma imagem HEIC.
heic:preserve-orientation=true Preserva a orientação EXIF original durante a decodificação HEIC e rotaciona os pixels de acordo. Por padrão, a orientação EXIF é redefinida para "1" para corresponder à orientação real dos pixels no HEIC.
heic:speed=value Define o parâmetro speed do HEIC. Valor inteiro de 0 a 9. O padrão é 5.
icon:auto-resize Armazena automaticamente múltiplos tamanhos ao gravar uma imagem ico (requer uma imagem de entrada de 256x256).
icon:png-compression-size Define o limiar mínimo de tamanho de imagem acima do qual uma imagem PNG é armazenada em vez de uma imagem BMP.
json:limit
json:locate
json:moments Inclui momentos da imagem nas informações detalhadas.
jp2:layer-number=value Define o número máximo de camadas de qualidade a decodificar. O mesmo para JPT, JC2 e J2K.
jp2:number-resolutions=value Define o número de resoluções a codificar. O mesmo para JPT, JC2 e J2K.
jp2:progression-order=value Escolha entre LRCP, RLCP, RPCL, PCRL ou CPRL. O mesmo para JPT, JC2 e J2K.
jp2:quality=value,value... Define o PSNR da camada de qualidade, dado em dB. A ordem é da esquerda para a direita, em ordem crescente. O padrão é uma única camada de qualidade sem perdas. O mesmo para JPT, JC2 e J2K.
jp2:rate=value Especifica o fator de compressão a usar ao gravar arquivos JPEG-2000. O fator de compressão é o recíproco da taxa de compressão. A faixa válida é de 0.0 a 1.0, com 1.0 indicando compressão sem perdas. Se definido, este valor substitui a configuração -quality. Uma configuração de qualidade de 75 resulta em um valor de rate de 0.06641. O mesmo para JPT, JC2 e J2K.
jp2:reduce-factor=value Define o número dos níveis de resolução mais altos a serem descartados. O mesmo para JPT, JC2 e J2K.
jpeg:arithmetic-coding=on|off habilita/desabilita a otimização Huffman.
jpeg:block-smoothing=on|off
jpeg:colors=value Define o número desejado de cores e deixa o codificador JPEG fazer a quantização.
jpeg:dct-method=value Escolha entre default, fastest, float, ifast e islow.
jpeg:extent=value Restringe o tamanho máximo do arquivo JPEG, por exemplo -define jpeg:extent=400KB. O codificador JPEG procurará o nível de qualidade de compressão mais alto que resulte em um arquivo de saída que não exceda o valor. A opção -quality também será respeitada a partir da versão 6.9.2-5. Entre 6.9.1-0 e 6.9.2-4, adicione -quality 100 para que jpeg:extent funcione corretamente. Antes da 6.9.1-0, a configuração -quality era ignorada.
jpeg:fancy-upsampling=on|off
jpeg:high-bit-depth=on|off Por padrão, o ImageMagick gera imagens JPEG com profundidade de 8 bits. Quando a alta profundidade de bits está habilitada, ele produzirá imagens de 12 bits ou 16 bits se a profundidade da imagem de origem exceder 8 bits.
jpeg:optimize-coding=on|off
jpeg:q-table=table
jpeg:restart-interval=value Define o intervalo de reinício para interval blocos MCU.
jpeg:sampling-factor=sampling-factor-string
jpeg:size=geometry Define a dica de tamanho de uma imagem JPEG, por exemplo, -define jpeg:size=128x128. É mais útil para aumentar o desempenho e reduzir os requisitos de memória ao reduzir o tamanho de uma imagem JPEG grande.
jxl:decoding-speed=value Define a velocidade de decodificação do jpeg-xl. Os valores válidos estão na faixa de 0 (mais lento) a 4 (mais rápido, ao custo de alguma qualidade/densidade).
jxl:effort=value Define o esforço de codificação do jpeg-xl. Os valores válidos estão na faixa de 3 (falcon) a 9 (tortoise).
minimum-bounding-box:orientation=value Encontra a menor distância perpendicular da borda à origem. Os valores válidos são horizontal e vertical.
mng:need-cacheoff desliga o cache de reprodução para MNG em streaming.
pcl:fit-to-page=true
pdf:author=author Define o autor do documento
pdf:create-epoch=seconds Define o horário de criação do documento
pdf:creator=creator Define o criador do documento
pdf:fit-page=geometry Geometry especifica as dimensões de escala para o redimensionamento quando o PDF está sendo lido. A geometry é WxH{%} ou um tamanho de página. Não são permitidos offsets. (introduzido no IM 6.8.8-8)
pdf:fit-to-page=true
pdf:hide-annotations=true oculta as anotações associadas à chave Annots da página.
pdf:interpolate=true habilita a interpolação durante a renderização
pdf:keywords=keywords Define as palavras-chave do documento
pdf:modify-epoch=seconds Define o horário de modificação do documento
pdf:no-identifier=true Não gera a entrada ID
pdf:page-direction=right-to-left
pdf:printed=true Determina se o arquivo deve ser exibido ou impresso usando as opções "screen" ou "printer" para anotações e imagens.
pdf:producer=producer Define o produtor do documento
pdf:subject=subject Define o assunto do documento
pdf:stop-on-error=true
pdf:thumbnail=false Gera miniaturas de imagem ao salvar um arquivo PDF.
pdf:title=title Define o título do documento
pdf:use-cropbox=true
pdf:use-trimbox=true
png:color-type=value Profundidade de bits e tipo de cor desejados para a saída PNG. Você pode forçar o codificador PNG a usar uma profundidade de bits e um tipo de cor diferentes dos que ele teria selecionado normalmente, mas apenas se isso não causar perda de qualidade da imagem. Qualquer tentativa de reduzir a qualidade da imagem é tratada como um erro e nenhum arquivo PNG é gravado. Por exemplo, se você tiver uma imagem preto e branco de 1 bit, pode usar esses "defines" para fazê-la ser gravada como uma escala de cinza de 8 bits, indexada ou até mesmo um RGBA de 64 bits. Mas se você tiver uma imagem de 16 milhões de cores, não pode forçá-la a ser gravada como um PNG em escala de cinza ou indexado. Se desejar fazer isso, deve usar as diretivas apropriadas -depth, -colors ou -type para reduzir a qualidade da imagem antes de usar o codificador PNG. Observe que, em arquivos PNG indexados, "bit-depth" refere-se ao número de bits por índice, que pode ser 1, 2, 4 ou 8. Em tais arquivos, as amostras de cor sempre têm profundidade de 8 bits.
png:compression-filter=value Os valores válidos vão de 0 a 9. 0-4 são os filtros PNG correspondentes, 5 significa filtragem adaptativa exceto para imagens com colormap, 6 significa filtragem adaptativa para todas as imagens, 7 significa compressão MNG "loco", 8 significa estratégia Z_RLE com filtragem adaptativa e 9 significa estratégia Z_RLE sem filtragem.
png:compression-level=value Os valores válidos vão de 0 a 9, com 0 fornecendo a menor, mas mais rápida compressão e 9 normalmente fornecendo a melhor e sempre a mais lenta.
png:compression-strategy=value Os valores válidos vão de 0 a 4, significando as estratégias de compressão ZLIB default, filtered, huffman_only, rle e fixed. Se você estiver usando um zlib antigo que não suporta Z_RLE (anterior a 1.2.0) ou Z_FIXED (anterior a 1.2.2.2), os valores 3 e 4, respectivamente, usarão a estratégia padrão do zlib em vez disso.
png:format=value os valores válidos são png8, png24, png32, png48, png64 e png00. Esta propriedade é útil para especificar o formato PNG específico a ser usado, quando o método usual de prefixar o nome do formato ao nome do arquivo de saída é inconveniente, como ao gravar um arquivo ICO codificado em PNG ou ao usar mogrify. Value = png8 reduz o número de cores para 256, das quais apenas uma pode ser totalmente transparente, se necessário. Os outros valores não forçam nenhuma redução de qualidade; é um erro solicitar um formato que não possa representar os dados da imagem sem perda (exceto que é permitido reduzir a profundidade de bits de 16 para 8 para todos os formatos). Value = png24 e png48 permitem transparência apenas se uma única cor for totalmente transparente e essa cor não aparecer também em um pixel opaco; tal transparência é gravada em um chunk PNG tRNS. Value = png00 faz a imagem herdar seu tipo de cor e profundidade de bits da imagem de entrada, se a entrada também for um PNG.
png:exclude-chunk=value
png:include-chunk=value chunks auxiliares a serem excluídos da ou incluídos na saída PNG. O valor pode ser o nome de um tipo de chunk PNG, como bKGD, uma lista de nomes de chunk separados por vírgulas (que pode incluir a palavra date, a palavra all ou a palavra none). Embora os nomes de chunk PNG dependam de maiúsculas/minúsculas, você pode usar nomes todos em minúsculas, se preferir. As listas "include-chunk" e "exclude-chunk" afetam apenas o comportamento do codificador PNG e não têm efeito sobre o decodificador PNG. Como caso especial, se o chunk sRGB for excluído e o chunk gAMA for incluído, o chunk gAMA só será gravado se o gamma não for 1/2.2, pois a maioria dos decodificadores não assume sRGB para gAMA=0.45455 quando nenhuma informação de espaço de cor está incluída no arquivo PNG. Como a lista é processada da esquerda para a direita, você pode conseguir isso com um único define:
-define png:include-chunk=none,gAMA

Como caso especial, se o chunk sRGB não for excluído e o codificador PNG reconhecer que a imagem contém o perfil ICC sRGB, o codificador PNG gravará o chunk sRGB em vez do perfil ICC inteiro. Para forçar o codificador PNG a gravar o perfil sRGB como um chunk iCCP no PNG de saída em vez do chunk sRGB, exclua o chunk sRGB. Os chunks PNG críticos IHDR, PLTE, IDAT e IEND não podem ser excluídos. Quaisquer dessas entradas que apareçam na lista serão ignoradas. Se o chunk auxiliar PNG tRNS for excluído e a imagem tiver transparência, o colortype PNG é forçado a ser 4 ou 6 (GRAY_ALPHA ou RGBA). Se a imagem não for transparente, então o chunk tRNS não é gravado de qualquer forma, e não há efeito sobre o colortype PNG da imagem de saída. A opção -strip faz o equivalente ao seguinte para a saída PNG:

-define png:exclude-chunk=EXIF,iCCP,iTXt,sRGB,tEXt,zCCP,zTXt,date

O comportamento padrão é incluir todos os chunks auxiliares PNG conhecidos, além do chunk privado vpAg ("virtual page") do ImageMagick, e excluir todos os chunks PNG desconhecidos pelo ImageMagick, independentemente de seu status "copy-safe" do PNG conforme descrito na especificação PNG. Quaisquer nomes de chunk desconhecidos pelo ImageMagick são ignorados se aparecerem na lista "include-chunk" ou "exclude-chunk". Os chunks auxiliares atualmente conhecidos pelo ImageMagick são bKGD, cHRM, gAMA, iCCP, oFFs, orNT, pHYs, sRGB, tEXt, tRNS, vpAg e zTXt. Você também pode colocar date na lista para incluir ou excluir os chunks de texto "Date:create" e "Date:modify" que o ImageMagick normalmente insere no PNG de saída.
png:ignore-crc[=true] | Quando você sabe que sua imagem não tem erros de CRC ou ADLER32, isso pode acelerar a decodificação. Também é útil para depurar relatórios de bugs de "fuzzers".
png:preserve-colormap[=true] | Usa o image->colormap existente. Normalmente, o codificador PNG tentará otimizar a paleta, eliminando as entradas não utilizadas e colocando as cores transparentes primeiro. Se esta flag estiver definida, esse comportamento é suprimido.
png:preserve-iCCP[=true] | Por padrão, o decodificador e o codificador PNG examinam qualquer perfil ICC presente, seja de um chunk iCCP na entrada PNG, seja fornecido por meio de uma opção, e, se o perfil for reconhecido como o perfil sRGB, o converte para o chunk sRGB. Você pode usar -define png:preserve-iCCP para impedir que isso aconteça; em tais casos, o chunk iCCP será lido ou gravado e nenhum chunk sRGB será gravado. Existem alguns perfis ICC que afirmam ser sRGB, mas têm vários erros que fazem com que sejam rejeitados pelo libpng16; tais perfis são reconhecidos de qualquer forma e convertidos para o chunk sRGB, mas são rejeitados se -define png:preserve-iCCP estiver presente. Observe que nem todos os perfis ICC "sRGB" são reconhecidos ainda; nós os adicionaremos à lista conforme os encontrarmos.
png:swap-bytes[=true] | A especificação PNG exige que quaisquer inteiros de múltiplos bytes sejam armazenados na ordem de bytes de rede (endian MSB-LSB). Esta opção permite corrigir quaisquer arquivos PNG inválidos que tenham amostras de 16 bits armazenadas incorretamente em ordem little-endian (LSB-MSB). A opção "-define png:swap-bytes" deve aparecer antes do nome do arquivo de entrada na linha de comando. A troca é feita durante a operação de decodificação do libpng.
ps:imagemask | Se a flag ps:imagemask estiver definida, os coders PS3 e EPS3 criarão arquivos Postscript que renderizam imagens bilevel com o operador imagemask do Postscript em vez do operador image.
psd:additional-info=all|selective | Esta opção só deve ser usada ao converter de um arquivo PSD para outro arquivo PSD. Deve ser colocada após a imagem ser lida. As duas opções são 'all' e 'selective'. A opção 'selective' preservará todas as informações adicionais que não estejam relacionadas à geometria da imagem. A opção 'all' só deve ser usada quando a geometria da imagem não tiver sido alterada. Esta opção é útil ao transferir camadas não simples, como camadas de ajuste, do arquivo PSD de entrada para o arquivo PSD de saída. Se esta opção não for usada, as informações adicionais não serão preservadas. Este define está disponível a partir do Imagemagick versão 6.9.5-8.
psd:alpha-unblend=off | Desabilita o novo desmesclar automático da transparência com a imagem base para a camada achatada 0 antes de adicionar o canal alfa à imagem de saída. Este define deve ser colocado antes da imagem psd de entrada. (Disponível a partir do IM 6.9.2.5). O desmesclar automático é novo no IM 6.9.2.5 e impede que a transparência seja aplicada duas vezes na imagem de saída. Esta opção deve ser definida antes de ler a imagem.
psd:preserve-opacity-mask=true | Esta opção só deve ser usada ao converter de um arquivo PSD para outro arquivo PSD. Ela preservará a máscara de opacidade de uma camada e a adicionará de volta à camada quando a imagem for salva. Definir isso como 'true' habilitará este recurso. Este define está disponível a partir do Imagemagick versão 6.9.5-10.
psd:write-layers=false | Esta opção pode ser usada para desabilitar a gravação das camadas de um arquivo PSD.
psd:replicate-profile=true | Esta opção pode ser usada para copiar o perfil da imagem para todas as imagens, em vez de apenas para a primeira imagem retornada.
ptif:pyramid=min-basexlevels | Especifica o min-base e o número de níveis da pirâmide, por exemplo, 64x4.
svg:parse-huge=true | Habilita a renderização de um SVG muito grande cuja fonte você confia.
svg:substitute-entities=true | Habilita a substituição de entidades se você confiar na fonte.
tga:preserve-orientation=true | Preserva a orientação da imagem.
tga:write-footer=true | Habilita a gravação de um rodapé opcional vazio.
tiff:alpha=associated|unassociated|unspecified | Especifica as amostras extra de alfa como associated, unassociated ou unspecified.
tiff:assume-alpha=true|false | Assume que canais extra não declarados são alfa.
tiff:endian=msb|lsb |
tiff:exif-properties=false | Desabilita a leitura das propriedades EXIF.
tiff:fill-order=msb|lsb |
tiff:peg-tables-mode=0-3 | Define o TIFFTAG_JPEGTABLESMODE quando o arquivo tiff é gravado com compressão jpeg
tiff:gps-properties=false | Desabilita a leitura das propriedades GPS.
tiff:ignore-layers=true | Ignora as camadas do Photoshop.
tiff:ignore-tags=comma-separate-list-of-tag-IDs | Permite que um ou mais valores de tag ID sejam ignorados.
tiff:predictor=[1, 2 or 3] | Um operador matemático aplicado aos dados da imagem antes de um esquema de codificação ser aplicado. A ideia geral é que pixels subsequentes de uma imagem se assemelham entre si. Assim, subtrair de um pixel a informação já contida no anterior provavelmente reduz consideravelmente sua densidade de informação e auxilia a compressão subsequente. 1 = Nenhum esquema de predição usado antes da codificação. 2 = Diferenciação horizontal. 3 = Diferenciação horizontal em ponto flutuante.
tiff:preserve-compression=true | Preserva a compressão da imagem de origem.
tiff:rows-per-strip=value | Define o número de linhas por strip.
tiff:tile-geometry=WxH | Define o tamanho do ladrilho para tiffs em pirâmide. Requer o sufixo PTIF: antes do nome de saída.
uhdr:gainmap-gamma=value | Define o gamma de codificação da imagem gainmap. Deve ser maior que 0.0. Usado durante a codificação. Opcional. O valor padrão é 1.0.
uhdr:gainmap-quality=value | Define o fator de qualidade de codificação da imagem gainmap. A faixa válida é de 1 a 100, com 1 indicando a menor qualidade de imagem ou a maior compressão e 100 indicando a melhor qualidade ou a menor compressão efetiva. Usado durante a codificação. Opcional. O valor padrão é 95.
uhdr:gainmap-max-content-boost=value | Especifica a razão máxima permitida da luminância linear para a renderização HDR de destino em relação à (dividida pela) imagem SDR, em um dado pixel. Em outras palavras, isso especifica o quanto mais brilhante um pixel pode ficar, quando exibido em uma tela HDR, em relação à renderização SDR. Deve ser maior que 0.0. Usado durante a codificação. Opcional. Se não configurado, é calculado dinamicamente com base na entrada.
uhdr:gainmap-min-content-boost=value | Especifica a razão mínima permitida da luminância linear para a renderização HDR de destino em relação à (dividida pela) imagem SDR, em um dado pixel. Em outras palavras, isso especifica o quanto mais escuro um pixel pode ficar, quando exibido em uma tela HDR, em relação à renderização SDR. Deve ser maior que 0.0. Usado durante a codificação. Opcional. Se não configurado, é calculado dinamicamente com base na entrada.
uhdr:hdr-color-gamut={bt709|display_p3|bt2100} | Define o gamut de cor da intenção HDR de entrada. Usado durante a codificação. Obrigatório.
uhdr:hdr-color-transfer={hlg|pq|linear} | Define a transferência de cor da intenção HDR de entrada. Usado durante a codificação. Obrigatório.
uhdr:output-color-transfer={hlg|pq|linear|srgb} | Define as características de transferência da tela de destino na qual a imagem ultrahdr é renderizada. Usado durante a decodificação. Obrigatório. Se srgb, apenas a intenção sdr é decodificada e enviada como saída; caso contrário, a intenção sdr e o gainmap são decodificados, combinados em uma imagem hdr e enviados como saída.
uhdr:sdr-color-gamut={bt709|display_p3|bt2100} | Define o gamut de cor da intenção SDR de entrada. Usado durante a codificação. Obrigatório.
uhdr:uhdr:target-display-peak-brightness=value | O brilho de pico refere-se ao nível máximo de brilho que uma tela pode atingir. Isso é importante para representar com precisão os realces brilhantes em conteúdo HDR.
video:intermediate-format={pam,webp} | Define a opção de formato intermediário de vídeo do ffmpeg.
video:pixel-format=value | Define a opção de formato de pixel do ffmpeg.
video:vsync=value | Define a opção vsync do ffmpeg.
PSEUDO-IMAGE FORMATS
caption:max-pointsize=pointsize | Limita o pointsize máximo
caption:split=boolean | divide o texto, se necessário, para ajustar a legenda no canvas
gradient:angle=angle (in degrees) | Para um gradiente linear, isso especifica a direção do gradiente indo de color1 para color2 em sentido horário positivo em relação ao norte (para cima). Para um gradiente radial, isso especifica a rotação do gradiente em sentido horário positivo a partir de sua orientação X-Y normal. Suportado no Imagemagick 6.9.2-5.
gradient:bounding-box=WxH+X+Y | Limita o gradiente a uma região maior ou menor que as dimensões da imagem. Se a região definida pela bounding box for menor que a imagem, então color1 será a cor do fundo. Suportado no Imagemagick 6.9.2-5.
gradient:center=x,y | Especifica as coordenadas do ponto central para o gradiente radial. O padrão é o centro da imagem. Suportado no Imagemagick 6.9.2-5.
gradient:direction=value | Especifica a direção do gradiente linear em direção aos cantos superior/inferior/esquerdo/direito ou diagonais. As opções são: NorthWest, North, Northeast, West, East, SouthWest, South, SouthEast. Suportado no Imagemagick 6.9.2-5.
gradient:extent=value | Especifica o formato de um gradiente radial centrado na imagem. As opções são: Circle, Diagonal, Ellipse, Maximum, Minimum. Circle e Maximum desenham um gradiente radial circular mesmo para imagens de formato retangular, com raio igual ao maior entre a metade da largura e a metade da altura da imagem. As opções Circle e Maximum são ambas equivalentes ao gradiente radial padrão. A opção Minimum desenha um gradiente radial circular mesmo para imagens de formato retangular, com raio igual ao menor entre a metade da largura e a metade da altura da imagem. A opção Diagonal desenha um gradiente radial circular mesmo para imagens de formato retangular, com raio igual à metade da diagonal da imagem. A opção Ellipse desenha um gradiente radial elíptico para imagens de formato retangular, com raios iguais à metade da largura e à metade da altura da imagem. Suportado no Imagemagick 6.9.2-5.
gradient:radii=x,y | Especifica os raios x e y do gradiente. Se o raio x e o raio y forem iguais, o formato do gradiente radial será um círculo. Se diferirem, o formato será uma elipse. Os valores padrão são o máximo entre a metade da largura e a metade da altura da imagem. Suportado no Imagemagick 6.9.2-5.
gradient:vector=x1,y1,x2,y2 | Especifica a direção do gradiente linear indo de vector1 (x1,y1) para vector2 (x2,y2). Color1 (fromColor) será localizada na posição de vetor x1,y1 e color2 (toColor) será localizada na posição de vetor x2,y2. Suportado no Imagemagick 6.9.2-5.
histogram:unique-colors=false | Suprime a listagem textual das cores únicas da imagem.
pango:align=left|center|right |
pango:auto-dir=true|false |
pango:ellipsize=start|middle|end |
pango:gravity-hint=natural|strong|line |
pango:hinting=none|auto|full |
pango:indent=points |
pango:justify=true|false |
pango:language=en_US|others |
pango:markup=true|false |
pango:single-paragraph=true|false |
pango:wrap=word|char|word-char |
pixel:compliance=value | Define o formato de saída "pixel:" de acordo com vários padrões. As opções são SVG, None, Undefined, MVG, X11, XPM. O padrão lista os valores das cores (s)RGB na forma de (s)rgb(r,g,b) ou (s)rgba(r,g,b,a). Os nomes de cor não serão mais apresentados. Para cores sRGB ou RGB, as opções SVG, X11, XPM e None listam nomes de cor, se existirem. As opções MVG e Undefined listam valores hexadecimais. Quando as cores são apresentadas ou convertidas para espaços de cor baseados em matiz, os valores listados serão inteiros para o matiz e porcentagens para os outros dois componentes. Para outros espaços de cor, os valores podem ser listados como porcentagens ou valores fracionários. Definir a profundidade como 8 limitará os valores à faixa de 8 bits, exceto para cores baseadas em matiz.
txt:compliance=value | Define o formato "txt:" para os valores entre parênteses de acordo com vários padrões. As opções são svg, none, undefined, mvg, x11, xpm. O padrão listará os valores das cores (s)RGB no quantum range. As opções SVG, X11, XPM, MVG e None listam os valores na faixa de 8 bits para todas as compilações de nível Q. A opção undefined também lista os valores no quantum range. Quando as cores são apresentadas ou convertidas para espaços de cor baseados em matiz, os valores listados serão inteiros para o matiz e porcentagens para os outros dois componentes. Para outros espaços de cor, os valores podem ser listados como porcentagens ou valores fracionários. Definir a profundidade como 8 limitará os valores à faixa de 8 bits, exceto para cores baseadas em matiz.
webp:tag=value | O WebP tem uma infinidade de defines detalhados nesta página.
xmp:validate={true,false} | Por padrão, o ImageMagick valida qualquer perfil XMP embutido em uma imagem.