Opções de Faixa: Uma Estratégia de Baixa Neutra do Mercado.
A viabilidade de combinações na negociação de opções permite oportunidades lucrativas em cenários variados. Seja os preços das ações subjacentes subindo, descendo ou permanecendo estáveis, combinações de opções adequadamente selecionadas oferecem um potencial de lucro adequado. (Deseja saber mais sobre o que significa "mercado neutro"? Consulte "Como obter resultados com fundos neutros de mercado".)
Este artigo apresenta “Strip Options”, uma das estratégias de negociação neutras do mercado com potencial de lucro em ambos os movimentos laterais de preços. "Strip" se origina como uma versão ligeiramente modificada do straddle. O Straddle oferece um potencial de lucro igual em ambos os lados do movimento de preço subjacente (tornando-se uma estratégia neutra de mercado "perfeita"), enquanto a Strip é uma estratégia neutra de mercado fornecendo o dobro do potencial de lucro em queda de preço comparado ao movimento de preço ascendente equivalente . (Aprenda sobre sua contraparte: "Opções de Strap: Uma Estratégia de Alta Neutral de Mercado.")
As opções Strip oferecem um potencial de lucro ilimitado no movimento ascendente dos preços do subjacente e um potencial de lucro limitado no movimento descendente dos preços. O risco / perda é limitado ao prêmio total da opção pago (mais comissão de corretagem).
O custo de construção da posição da opção de strip é alto, pois requer 3 opções de compras:
Todas as 3 opções devem ser compradas no mesmo subjacente, com o mesmo preço de exercício e a mesma data de vencimento.
Função de pagamento com um exemplo:
Suponha que você esteja criando uma posição de opção de tira em um estoque atualmente negociando em torno de $ 100. Uma vez que as opções ATM (At-The-Money) são compradas, o preço de exercício para cada opção deve ser o mais próximo disponível para o preço subjacente, ou seja, US $ 100.
Aqui estão as funções básicas de pagamento para cada uma das três posições de opção. O gráfico Azul representa a opção LONG CALL de preço de exercício de US $ 100 (assuma um custo de US $ 6). Os gráficos amarelos e cor-de-rosa sobrepostos representam as duas opções LONG PUT (custando US $ 7 cada). Vamos considerar o preço (prêmios da opção) na última etapa.
Agora, vamos adicionar todas essas posições de opção juntas para obter a seguinte função de compensação líquida (cor turquesa):
Finalmente, vamos levar os preços em consideração. O custo total será de ($ 6 + $ 7 + $ 7 = $ 20). Como todas são opções LONG, ou seja, compras, há um débito líquido de US $ 20 para criar essa posição. Assim, a função net payoff (gráfico turquesa) será reduzida em US $ 20, dando-nos a função de payoff líquido de cor marrom com os preços levados em consideração:
Existem duas áreas de lucro para opções de tira, isto é, onde a função de pagamento BROWN permanece acima do eixo horizontal. Neste exemplo de opção de faixa, a posição será lucrativa quando o preço subjacente se movimentar acima de US $ 120 ou cair abaixo de US $ 90. Esses pontos são conhecidos como pontos de equilíbrio, pois são os pontos de “limite de perda de lucros” ou “sem fins lucrativos, sem perda”.
Ponto de Equilíbrio Superior = Preço de Golpe da Chamada / Coloca + Prêmio Líquido Pago.
= $ 100 + $ 20 = $ 120, para este exemplo.
Ponto de equilíbrio inferior = Preço de Chamado / Colocações - (Prêmio Líquido Pago / 2)
= $ 100 - ($ 20/2) = $ 90, para este exemplo.
Perfil de Lucro e Risco da Opção Strip:
Para além do ponto de equilíbrio superior, ou seja, no movimento ascendente dos preços do subjacente, o comerciante tem um potencial de lucro ILIMITADO, uma vez que, teoricamente, o preço pode passar para qualquer nível acima, oferecendo lucro ilimitado. Para cada movimento de ponto de preço único do subjacente, o comerciante obterá um ponto de lucro - ou seja, um aumento de um dólar no preço da ação subjacente aumentará o pagamento em um dólar.
Abaixo do ponto de equilíbrio mais baixo, ou seja, no movimento descendente dos preços do subjacente, o comerciante tem um potencial de lucro limitado, uma vez que o preço subjacente não pode ir abaixo de $ 0 (pior cenário de falência). No entanto, para cada movimento descendente único do preço do subjacente, o comerciante obterá dois pontos de lucro.
É aí que a perspectiva de baixa para a opção Strip oferece melhor lucro em comparação com o lado positivo, e é aí que a faixa difere de um straddle usual que oferece potencial de lucro igual em ambos os lados.
Lucro na Opção Strip em sentido ascendente = Preço do Activo Subjacente - Preço de Exercício da Oferta - Net Premium Pago - Corretora & amp; Comissão.
Assumindo os fins subjacentes em US $ 140, então lucro = US $ 140 - US $ 100 - US $ 20 - Corretora.
Lucro na Opção Strip em sentido descendente = 2 x (Preço de Vendas - Preço dos Activos Subjacentes) - Net Premium Pago - Corretagem & amp; Comissão.
Supondo que os fins subjacentes em US $ 60, em seguida, o lucro = 2 * ($ 100 - $ 60) - $ 20 - Corretora.
A área Risco ou Perda é a região onde a função de pagamento MARROM se encontra ABAIXO do eixo horizontal. Neste exemplo, situa-se entre estes dois pontos de equilíbrio, ou seja, esta posição será perda quando o preço subjacente se mantém entre $ 90 e $ 120. O valor da perda irá variar linearmente dependendo de onde o preço subjacente é.
Perda Máxima na Negociação de Opção de Strip = Prêmio da Opção Líquida paga + Corretora & amp; Comissão.
Neste exemplo, perda máxima = US $ 20 + Corretora.
A Estratégia de Negociação de Opções Strip é perfeita para um trader que espera um movimento de preço considerável no preço da ação subjacente, é incerto sobre a direção, mas também espera maior probabilidade de um movimento descendente de preço. Pode haver uma grande movimentação de preços esperada em qualquer direção, mas as chances são mais de que ela esteja na direção descendente.
Cenários da vida real, ideais para a negociação de opções de strip incluem.
Lançamento de um novo produto por uma empresa Esperando que lucros muito bons ou ruins sejam reportados pela empresa Resultados de um lance de projeto para o qual a empresa fez uma oferta.
O lançamento do produto pode ser sucesso / falha, os ganhos podem ser muito bons / ruins, o lance pode ser ganho / perdido pela empresa - tudo pode levar a grandes oscilações de preço incertas da direção.
A estratégia de opções de tiras se encaixa bem para traders de curto prazo que se beneficiarão da alta volatilidade no movimento de preços subjacentes em qualquer direção. Os operadores de opções de longo prazo devem evitar isso, já que a compra de três opções a longo prazo levará a um prêmio considerável em direção ao valor do decaimento do tempo, que se desgasta com o tempo. Como em qualquer outra estratégia comercial de curto prazo, é aconselhável manter uma clara meta de lucro e sair da posição quando a meta for atingida. Embora o stop-loss já esteja embutido nessa posição de strip (devido à perda máxima limitada), os operadores de opções de strip ativo mantêm outros níveis de stop loss com base no movimento de preço subjacente e na volatilidade indicativa. O negociador precisa atender uma probabilidade ascendente ou descendente e, consequentemente, selecionar as posições Strap ou Strip.
O que é uma 'Strip'?
A faixa é o processo de remover cupons de um título e depois vender as partes separadas como um cupom de cupom zero e um título de cupom de juros. No contexto de títulos, a decapagem é tipicamente feita por uma corretora ou outra instituição financeira.
Nas opções, uma tira é uma estratégia criada por ser longa em uma posição de chamada e duas opções de venda, todas com o mesmo preço de exercício.
Uma tira é também referida como uma ligação descascada ou uma ligação z.
Strip Bond.
Tira De Futuros.
Principal Apenas Tiras - PO.
Tiras de interesse apenas (IO).
QUEBRANDO 'Faixa'
O termo "tira" é usado tanto para descrever as ações tomadas no mercado de títulos, bem como o mercado de opções. No mercado de títulos, os títulos de cupom são literalmente destituídos de seus cupons e princípios e vendidos como títulos-z e dívidas com juros. No mercado de opções, uma tira é uma estratégia de investidor que assume a posição oposta de uma variante.
Faixa no mercado de títulos.
STRIPS é um acrônimo para negociação separada de juros registrados e principal dos valores mobiliários. Quando ocorre uma faixa no mercado de títulos, uma obrigação ou nota do Tesouro é eliminada pelo sistema comercial de escrituração, tornando-se efetivamente o pagamento de juros da obrigação ou nota e o pagamento do princípio se tornando entidades separadas. Esses novos produtos de investimento separados são conhecidos como bond strip ou cupom zero.
Por exemplo, se houver uma nota do Tesouro com 10 anos de vencimento e com pagamentos de juros semestrais, essa nota pode ser retirada através do processo STRIPS para produzir 21 títulos de dívida separados. Como o vínculo está definido para vencer em 10 anos, os pagamentos de juros semestrais representam 10 x 2 = 20 períodos de pagamento. No último período de pagamento, o principal investimento também é reembolsado, portanto, a razão pela qual a STRIP pode criar 21 instrumentos de dívida exclusivos. Os 20 pagamentos de juros tornam-se títulos de strip-tease individuais e o pagamento único princípio torna-se seu próprio vínculo.
A quantia mínima necessária para comprar uma nota de princípio fixo ou tesouraria é de $ 100. Qualquer quantia acima de US $ 100 deve ser retirada em valores de US $ 100. Esses tipos de títulos despojados são muito atraentes para os investidores que desejam poupar para a aposentadoria ou receber um pagamento fixo no futuro. O risco de possuir esses tipos de veículos de investimento é extremamente baixo.
Strip como uma estratégia de opções.
Um investidor conduz uma estratégia de striping ao comprar duas opções de venda e uma opção de compra em uma única ação subjacente. Todas as três opções terão a mesma data de vencimento e o mesmo preço de exercício. Um investidor tirará uma posição de tira em uma ação quando o investidor acreditar que o preço subjacente da ação cairá em um curto período de tempo. Se o investidor estiver correto e o preço diminuir drasticamente, as colocações pagarão substancialmente. Se, no entanto, o investidor estiver errado e o preço do ativo subjacente aumentar, a opção de compra atenuará a perda.
251 & # 32; пользователь находится здесь.
МОДЕРАТОРЫ.
Nefarious-Gordon Gekko MrTacoMan AutoModeradora de Estratégia Corporativa wreckingcru VP - Analista de Private-equity throw-it-out - Hedge Fund à venda de produtos & raquo;
Bem vindo ao Reddit,
a primeira página da internet.
e inscreva-se em uma das milhares de comunidades.
Ато архивированный пост. Вы не можете голосовать или комментировать.
Quer adicionar à discussão?
приложенияи инструменты Reddit para iPhone Reddit para Android móvel кнопки site.
Использование данного сайта означает, что вы принимаете & # 32; пользовательского соглашения & # 32; и & # 32; Политика конфиденциальности. &cópia de; 2018 reddit инкорпорейтед. Все права защищены.
REDDIT e o logotipo ALIEN são marcas registradas da reddit inc.
& pi; Processado pelo PID 95764 em & # 32; app-33 & # 32; em 2018-03-02 03: 30: 28.527035 + 00: 00 executando 863f1f5 código do país: UA.
A faixa é uma versão modificada e mais baixista do straddle comum. Isso envolve a compra de um número de chamadas no dinheiro e duas vezes o número de opções de compra da mesma ação subjacente, preço de referência e data de vencimento.
As tiras são lucro ilimitado, estratégias de negociação de opções de risco limitadas que são usadas quando o negociador de opções pensa que o preço das ações subjacentes experimentará volatilidade significativa no curto prazo e é mais provável que caia para baixo em vez de se recuperar.
Potencial ilimitado de lucro.
Um grande lucro é atingível com a estratégia de strip quando o preço das ações subjacentes faz um movimento forte, seja para cima ou para baixo na expiração, com ganhos maiores a serem feitos com um movimento descendente.
A fórmula para calcular o lucro é dada abaixo:
Lucro Máximo = Lucro Ilimitado Obtido Quando Preço de Subjacente> Preço de Exercício das Chamadas / Postos + Prêmio Líquido Pago OU Preço do Subjacente O Guia de Opções.
Estratégias Neutras.
Estratégias de Opções.
Opções do Localizador de Estratégias.
Aviso de Risco: Negociações de ações, futuros e opções binárias discutidas neste site podem ser consideradas Operações de Operações de Alto Risco e sua execução pode ser muito arriscada e resultar em perdas significativas ou mesmo em uma perda total de todos os fundos da sua conta. Você não deve arriscar mais do que você pode perder. Antes de decidir negociar, você precisa garantir que entende os riscos envolvidos, levando em consideração seus objetivos de investimento e nível de experiência. As informações contidas neste site são fornecidas apenas para fins informativos e educacionais e não se destinam a serviços de recomendação de negociação. TheOptionsGuide não será responsável por quaisquer erros, omissões ou atrasos no conteúdo, ou por quaisquer ações tomadas com base nele.
Os produtos financeiros oferecidos pela empresa carregam um alto nível de risco e podem resultar na perda de todos os seus fundos. Você nunca deve investir dinheiro que você não pode perder.
Faixa de opções de fx
Observe que o espaço de cor scRGB requer suporte HDRI, caso contrário, ele se comporta exatamente como o RGB linear.
Use o espaço de cores Indefinido para identificar imagens multi-espectrais.
+ combinar o espaço de cores.
Combine uma ou mais imagens em uma única imagem.
Os canais (previamente definidos por - canal) da imagem combinada são retirados dos valores de escala de cinza de cada imagem na sequência, em ordem. Para a configuração de canal padrão de RGB, isso significa que a primeira imagem é atribuída ao canal Vermelho, a segunda ao canal Verde, a terceira ao Azul.
Esta opção pode ser considerada como inversa a separada, desde que as configurações do canal sejam as mesmas. Assim, no exemplo a seguir, a imagem final deve ser uma cópia do original.
cadeia de comentários.
Incorporar um comentário em uma imagem.
Esta opção configura os metadados do comentário de uma imagem lida após essa opção ter sido dada. Para modificar um comentário das imagens que já estão na memória use "-set comment".
O comentário pode conter caracteres de formato especial listados nas propriedades Formatar e imprimir imagem. Esses atributos são expandidos quando o comentário é finalmente atribuído às imagens individuais.
Se o primeiro caractere da string for @, o comentário da imagem será lido em um arquivo com os caracteres restantes na string. Comentários lidos de um arquivo são literais; Nenhum caractere de formatação incorporado é reconhecido.
Metadados de comentários não são visíveis na própria imagem. Para isso, use as opções - annotate ou - draw.
produz um comentário de imagem de MIFF: bird. miff 512x480 (supondo que a imagem bird. miff tenha uma largura de 512 e uma altura de 480.
matematicamente e visualmente anotar a diferença entre uma imagem e sua reconstrução.
Esta é uma versão convertida de "comparar" para duas imagens do mesmo tamanho. A sintaxe é a seguinte, mas outras métricas são permitidas.
Para obter o valor da métrica, use o formato de string "% [distorção]".
operador complexo.
realizar matemática complexa em uma sequência de imagens.
Escolha entre esses operadores:
Opcionalmente, especifique o operador de divisão SNR com complexo - define: snr = float.
-compor operador.
Defina o tipo de composição da imagem.
Veja Composição alfa para uma discussão detalhada da composição alfa.
Essa configuração afeta os operadores de processamento de imagens que mesclam duas (ou mais) imagens de alguma forma. Isso inclui os operadores, compara, composto, composto de camadas, - flatten, - mosaic, - layers mesclar, - border, - frame e - extent.
É também uma das principais opções para o comando "composite".
Execute a composição alfa em duas imagens e uma máscara opcional.
Pegue a primeira imagem 'destino' e sobreponha a segunda imagem 'fonte' de acordo com a configuração atual. A localização da imagem 'fonte' ou 'sobreposição' é controlada de acordo com as configurações - gravity e - geometry.
Se uma terceira imagem for dada, isso será tratado como uma imagem de 'máscara' de mesclagem em tons de cinza relativa à primeira imagem de 'destino'. Essa máscara é mesclada com a imagem de origem. No entanto, para o método de composição 'displace', a máscara é usada para fornecer uma imagem de deslocamento Y separada.
Se um método - compose requer argumentos ou flags numéricos extras, eles podem ser fornecidos definindo - se a opção - set ': compose: args apropriadamente para o método de composição.
Alguns métodos podem modificar a imagem de 'destino' fora da área de sobreposição. Você pode desabilitar isso configurando a opção especial - set: compose: outside-overlay 'para' false '.
A especificação de composição de SVG exige que os valores de cor e opacidade variem entre zero e QuantumRange, inclusive. Você pode permitir valores fora deste intervalo com esta opção: - set 'option: compose: clamp = false.
-comprimir tipo.
Use a compactação de pixels especificada por tipo ao gravar a imagem.
As opções são: Nenhuma, BZip, Fax, Grupo4, JPEG, JPEG2000, Lossless, LZW, RLE ou Zip.
Para imprimir uma lista completa de tipos de compactação, use - list compress.
Especifique + compress para armazenar a imagem binária em um formato descompactado. O padrão é o tipo de compactação do arquivo de imagem especificado.
Se a compactação LZW for especificada, mas a compactação LZW não tiver sido ativada, os dados da imagem serão gravados em um formato LZW não compactado que pode ser lido por decodificadores LZW. Isso pode resultar em arquivos GIF maiores do que o esperado.
Sem perdas refere-se ao JPEG sem perdas, que só está disponível se a biblioteca JPEG tiver sido corrigida para suportá-lo. O uso de JPEG sem perdas geralmente não é recomendado.
Ao escrever um arquivo ICO, você pode solicitar que as imagens sejam codificadas no formato PNG, especificando a compactação Zip.
Ao gravar um arquivo JNG, especifique a compactação Zip para solicitar que o canal alfa seja codificado no formato PNG "IDAT" ou JPEG para solicitar que ele seja codificado no formato JPG "JDAA".
Use a opção - quality para definir o nível de compactação a ser usado pelos codificadores JPEG, PNG, MIFF e MPEG. Use a opção - sampling-factor para definir o fator de amostragem a ser usado pelos codificadores JPEG, MPEG e YUV para reduzir a amostragem dos canais de chroma.
conectividade de componentes conectados.
A etiquetagem de componentes conectados detecta regiões conectadas em uma imagem, escolha conectividade de 4 ou 8 vias.
Use - define connected-components: verbose = true para gerar estatísticas associadas a cada rótulo exclusivo.
Melhore ou reduza o contraste da imagem.
Esta opção aumenta as diferenças de intensidade entre os elementos mais claros e mais escuros da imagem. Use - contrast para melhorar a imagem ou o contraste + para reduzir o contraste da imagem.
Para um efeito mais pronunciado, você pode repetir a opção:
ponto negro de contraste-alongamento.
Aumente o contraste em uma imagem esticando o intervalo de valores de intensidade.
Ao executar o alongamento, apague na maioria dos pixels de ponto preto e apague com a maioria dos pixels de ponto branco. Ou, se percentual for usado, desative a maioria dos pontos-negativos em% pixels e desative-os na maioria dos pontos percentuais em branco.
Antes do ImageMagick 6.4.7-0, - contrast-stretch apagará na maioria dos pixels de ponto preto e esbranquiçará na maioria dos pixels, menos os pixels de ponto branco. Ou, se percentual for usado, desabilite a maioria dos pontos-negativos em% pixels e esbranqueie-os no máximo em 100% menos pontos-brancos% pixels.
Observe que - contrast-stretch 0 modificará a imagem de forma que os valores mínimo e máximo da imagem sejam esticados para 0 e QuantumRange, respectivamente, sem perda de dados devido a burn-out ou recorte em ambas as extremidades. Isto não é o mesmo que - normalizar, o que equivale a - contrast-stretch 0.15x0.05% (ou antes do ImageMagick 6.4.7-0, - contrast-stretch 2% x99%).
O operador interno trabalha criando um escaninho de histograma e, em seguida, usa esse escaninho para modificar a imagem. Como tal, algumas cores podem ser mescladas quando caíram originalmente no mesmo 'bin'.
Todos os canais são normalizados em conjunto pela mesma quantidade, de modo a preservar a integridade da cor, quando a configuração padrão do canal + está em uso. Especificar qualquer outra configuração de canal normalizará os canais RGB de forma independente.
Veja também - auto-level para uma normalização 'perfeita' de imagens matemáticas.
Este operador está sob revisão para o novo desenvolvimento.
-convolve o kernel.
Convolve uma imagem com um kernel de convolução fornecido pelo usuário.
O kernel é uma matriz especificada como uma lista separada por vírgula de inteiros (sem espaços), ordenada da esquerda para a direita, começando com a linha superior. Atualmente, apenas kernels com dimensões ímpares são suportados e, portanto, o número de entradas no kernel especificado deve ser 3 2 = 9, 5 2 = 25, 7 2 = 49, etc.
Note que o operador convolver & # x2011; suporta a configuração de polarização & # x2011; Esta opção desloca a convolução para que os resultados positivos e negativos sejam relativos a um valor de polarização especificado pelo usuário. Isso é importante para compilações não-HDRI do ImageMagick ao lidar com convoluções que contêm valores negativos e positivos. Esse é especialmente o caso de convoluções envolvendo filtros de alta freqüência ou detecção de bordas. Sem um desvio de saída, os valores negativos são cortados em zero.
Ao usar um ImageMagick com a configuração de tempo de compilação HDRI, o bias & # x2011; não é necessário, pois o ImageMagick é capaz de armazenar / manipular quaisquer resultados negativos sem recorte para o intervalo de valores de cor (0.QuantumRange). Veja a discussão sobre as implementações de HDRI do ImageMagick na página High Dynamic-Range Images. Para mais informações sobre o HDRI, acesse as páginas de Uso do ImageMagick ou esta entrada da Wikipedia.
-cópia da geometria.
Copie pixels de uma área de uma imagem para outra.
geometria
Recorte uma ou mais regiões retangulares da imagem.
Veja Geometria da imagem para detalhes completos sobre o argumento da geometria.
A largura e a altura do argumento de geometria fornecem o tamanho da imagem que permanece após o recorte, e x e y no deslocamento (se presente) fornecem a localização do canto superior esquerdo da imagem recortada em relação à imagem original. Para especificar o valor a ser removido, use - shave em vez disso.
Se os deslocamentos x e y estiverem presentes, uma única imagem será gerada, consistindo dos pixels da região de recorte. Os deslocamentos especificam a localização do canto superior esquerdo da região de recorte medida para baixo e para a direita em relação ao canto superior esquerdo da imagem. Se a opção - gravity estiver presente com a gravidade NorthEast, East ou SouthEast, ela fornecerá a distância à esquerda da borda direita da imagem até a borda direita da região de recorte. Da mesma forma, se a opção - gravity estiver presente com a gravidade SouthWest, South ou SouthEast, a distância será medida para cima entre as bordas inferiores.
Se os deslocamentos x e y forem omitidos, um conjunto de blocos da geometria especificada, cobrindo toda a imagem de entrada, será gerado. Os ladrilhos mais à direita e os ladrilhos inferiores são menores se a geometria especificada se estender além das dimensões da imagem de entrada.
Você pode adicionar @ ao argumento de geometria para dividir igualmente a imagem no número de blocos gerados.
Ao adicionar um sinalizador de caractere de exclamação ao argumento de geometria, o tamanho da página de canvas virtual e o deslocamento das imagens recortadas são definidos como se o argumento de geometria fosse uma viewport ou janela. Isso significa que o tamanho da página da tela está definido exatamente com o mesmo tamanho que você especificou, o conjunto de deslocamento de imagem relativo ao canto superior esquerdo da região cortada.
Se a imagem recortada "perdeu" a imagem real em sua tela virtual, uma imagem "perdida" transparente de pixel único especial é retornada e um aviso de "recorte perdido" é fornecido.
Talvez seja necessário + recalcular a imagem antes de recortar a imagem para garantir que o quadro de coordenadas da cultura seja realocado para o canto superior esquerdo da imagem visível. Da mesma forma, você pode querer usar + repage após o recorte para remover o deslocamento da página que será deixado para trás. Isso é especialmente verdadeiro quando você vai gravar em um formato de imagem, como PNG, que suporta um deslocamento de imagem.
quantidade de bicicleta.
desloque o mapa de cores da imagem por quantidade.
Quantidade define o número de posições que cada entrada de mapa de cores é alterada.
eventos - debug.
ativar a impressão de depuração.
O parâmetro events especifica quais eventos devem ser registrados. Pode ser None, All, Trace ou uma lista separada por vírgula que consiste em um ou mais dos seguintes domínios: Accelerate, Annotate, Blob, Cache, Coder, Configurar, Deprecado, Exceção, Localidade, Renderizar, Recurso, Segurança, TemporaryFile, Transform, X11 ou User.
Por exemplo, para registrar eventos de cache e blob, use.
O domínio do usuário está normalmente vazio, mas os desenvolvedores podem registrar os eventos do usuário em sua cópia privada do ImageMagick.
Para imprimir a lista completa de métodos de depuração, use - list debug.
Use a opção - log para especificar o formato para depuração de saída.
Use + debug para desativar todos os registros.
A depuração também pode ser definida usando a variável de ambiente MAGICK_DEBUG. Os valores permitidos para a variável de ambiente MAGICK_DEBUG são os mesmos que para a opção - debug.
-decipher nome do arquivo.
Decifre e restaure pixels que foram previamente transformados por - encipher.
Obtenha a frase secreta do arquivo especificado por nome de arquivo.
-desconstruir.
encontrar áreas que mudaram entre as imagens.
Dada uma seqüência de imagens do mesmo tamanho, como produzido pelo - coalesce, substitua a segunda e a última imagem, com uma imagem menor de apenas a área que mudou em relação à imagem anterior.
A sequência de imagens resultante pode ser usada para otimizar uma sequência de animação, embora não funcione corretamente para animações GIF quando partes da animação podem passar de opacas a transparentes.
Esta opção é, na verdade, equivalente ao método - layers 'compare-any'.
- define a chave.
adicione configurações globais específicas geralmente usadas para controlar codificadores e operações de processamento de imagens.
Essa opção cria uma ou mais definições para codificadores e decodificadores usarem durante a leitura e gravação de dados de imagem. As definições geralmente são usadas para controlar os módulos codificadores de formato de arquivo de imagem e as operações de processamento de imagem, além do que é fornecido por meios normais. As configurações definidas são listadas em informação - verbose ("info:" formato de saída) como "Artefatos".
Se o valor estiver faltando para uma definição, uma definição com valor vazio de um sinalizador será criada com esse nome. Isso é usado para controlar as opções de ativação / desativação. Use + define chave para remover as definições criadas anteriormente. Use + define "*" para remover todas as definições existentes.
As mesmas configurações de 'artefato' também podem ser definidas usando a opção - set "opção: chave" "valor", que também permite o uso de Propriedades de Formatar e Imprimir Imagem no valor definido.
A opção e a chave são independentes de maiúsculas e minúsculas (elas são convertidas para minúsculas para uso nos decodificadores), enquanto o valor é dependente de maiúsculas e minúsculas.
Essas configurações são globais no escopo e afetam todas as imagens e operações.
As definições a seguir são apenas alguns dos artefatos disponíveis:
O valor pode ser o nome de um tipo de bloco PNG, como bKGD, uma lista separada por vírgulas de nomes de fragmentos (que pode incluir a palavra data, a palavra all ou a palavra none). Embora os nomes de fragmentos PNG sejam dependentes de maiúsculas e minúsculas, você pode usar todos os nomes minúsculos, se preferir.
As listas "include-chunk" e "exclude-chunk" afetam apenas o comportamento do codificador PNG e não afetam o decodificador PNG.
Como um caso especial, se o pedaço sRGB for excluído e o pedaço gAMA for incluído, o pedaço gAMA será escrito apenas se gama não for 1 / 2.2, já que a maioria dos decodificadores assume sRGB e gama = 1 / 2.2 quando nenhuma informação de espaço é incluída no arquivo PNG. Como a lista é processada da esquerda para a direita, você pode conseguir isso com uma única definição:
Como um caso especial, se o bloco 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 bloco sRGB em vez de todo o perfil ICC. Para forçar o codificador PNG a gravar o perfil sRGB como um trecho iCCP no PNG de saída, em vez do trecho sRGB, exclua o trecho sRGB.
Os blocos críticos de PNG IHDR, PLTE, IDAT e IEND não podem ser excluídos. Todas as entradas que aparecem na lista serão ignoradas.
Se o trecho auxiliar do PNG tRNS for excluído e a imagem tiver transparência, o tipo de coruja PNG será forçado a ser 4 ou 6 (GRAY_ALPHA ou RGBA). Se a imagem não for transparente, o bloco tRNS não será gravado de qualquer forma e não haverá efeito no tipo de cor PNG da imagem de saída.
A opção - strip faz o equivalente ao seguinte para a saída PNG:
O comportamento padrão é incluir todos os fragmentos auxiliares PNG conhecidos mais o vpAg privado da ImageMagick ("página virtual") e excluir todos os fragmentos PNG que são desconhecidos do ImageMagick, independentemente de seu status "seguro para cópia" PNG, conforme descrito no PNG especificação.
Qualquer nome de fragmento que não seja conhecido no ImageMagick será ignorado se aparecer na lista "include-chunk" ou "exclude-chunk". Os fragmentos secundários atualmente conhecidos do ImageMagick são bKGD, cHRM, gAMA, iCCP, oFFs, pHYs, sRGB, tEXt, tRNS, vpAg e zTXt.
Você também pode colocar a data na lista para incluir ou excluir os fragmentos de texto "Data: criar" e "Data: modificar" que o ImageMagick normalmente insere no PNG de saída.
Por exemplo, para criar um arquivo postscript que renderize apenas os pixels pretos de uma imagem de dois níveis, use:
Definir atributos do registro de imagem prefixando o valor com o registro:. Por exemplo, para definir um caminho temporário para colocar arquivos de trabalho, use:
-delay carrapatos.
-delay carrapatos x carrapatos por segundo.
exibir a próxima imagem após a pausa.
Esta opção é útil para regular a animação de seqüências de imagens. Os tiques / tiques por segundo devem expirar antes da exibição da próxima imagem. O padrão é nenhum atraso entre cada exibição da seqüência de imagens. O padrão por segundo é 100.
Use & gt; para alterar o atraso da imagem apenas se o valor atual exceder o atraso determinado. & lt; altera o atraso da imagem apenas se o valor atual for menor que o atraso determinado. Por exemplo, se você especificar 30 & gt; e o atraso da imagem é 20, o atraso da imagem não muda. No entanto, se o atraso da imagem for 40 ou 50, o atraso será alterado para 30. Coloque o atraso especificado entre aspas para evitar que o & lt; ou & gt; de ser interpretado pelo seu shell como um redirecionamento de arquivo.
-exclua índices.
exclua as imagens especificadas por índice, da seqüência de imagens.
Especifique a imagem pelo seu índice na sequência. A primeira imagem é o índice 0. Os índices negativos são relativos ao final da sequência, por exemplo, -1 representa a última imagem da sequência. Especifique um intervalo de imagens com um traço (por exemplo, 0-4). Separe os índices com uma vírgula (por exemplo, 0,2). Use + delete para excluir a última imagem na sequência de imagens atual. Use - elelete 0--1 para apagar toda a seqüência da imagem.
largura de densidade.
-densidade largura x altura.
Defina a resolução horizontal e vertical de uma imagem para renderização em dispositivos.
Essa opção especifica a resolução da imagem a ser armazenada durante a codificação de uma imagem raster ou a resolução da tela ao renderizar (ler) formatos vetoriais, como Postscript, PDF, WMF e SVG, em uma imagem rasterizada. A resolução da imagem fornece a unidade de medida a ser aplicada ao renderizar em um dispositivo de saída ou imagem rasterizada. A unidade de medida padrão é em pontos por polegada (DPI). A opção de unidades pode ser usada para selecionar pontos por centímetro.
A resolução padrão é de 72 pontos por polegada, o que equivale a um ponto por pixel (padrão Macintosh e Postscript). As telas de computador normalmente são de 72 ou 96 pontos por polegada, enquanto as impressoras normalmente suportam 150, 300, 600 ou 1200 pontos por polegada. Para determinar a resolução da sua exibição, use uma régua para medir a largura da tela em polegadas e divida pelo número de pixels horizontais (1024 em uma exibição de 1024x768).
Se o formato de arquivo suportar, esta opção pode ser usada para atualizar a resolução da imagem armazenada. Observe que o Photoshop armazena e obtém a resolução da imagem a partir de um perfil incorporado proprietário. Se esse perfil não for retirado da imagem, o Photoshop continuará tratando a imagem usando sua resolução anterior, ignorando a resolução da imagem especificada no cabeçalho do arquivo padrão.
A opção - density define um atributo e não altera a imagem raster subjacente. Ele pode ser usado para ajustar o tamanho renderizado para fins de editoração eletrônica, ajustando a escala aplicada aos pixels. Para redimensionar a imagem para que ela tenha o mesmo tamanho em uma resolução diferente, use a opção - resample.
valor de profundidade.
profundidade da imagem.
Este é o número de bits em uma amostra de cor dentro de um pixel. Use essa opção para especificar a profundidade das imagens brutas cuja profundidade é desconhecida, como CINZA, RGB ou CMYK, ou para alterar a profundidade de qualquer imagem depois de ter sido lida.
obter imagem pela hierarquia descendente da janela.
Limite de
endireite uma imagem. Um limiar de 40% funciona para a maioria das imagens.
Use a opção - set: deskew: auto-crop true | false para cortar automaticamente a imagem.
reduza as manchas dentro de uma imagem.
Tipo de direção.
renderizar texto da direita para a esquerda ou da esquerda para a direita. Requer a biblioteca delegada RAQM e o layout de texto complexo.
-deslocar escala horizontal.
-dispõe escala horizontal x escala vertical.
Deslocar os pixels da imagem conforme definido por um mapa de deslocamento.
Com essa opção, a imagem 'overlay' e, opcionalmente, a imagem 'mask', é usada como um mapa de deslocamento, que é usado para deslocar a pesquisa de qual parte da imagem 'background' é vista em cada ponto da área sobreposta . Muito parecido com o mapa de deslocamento é uma "lente" que redireciona a luz que brilha através dele, de modo a apresentar uma visão distorcida da imagem original "fundo" por trás dele.
Quaisquer áreas cinzentas perfeitas do mapa de deslocamento produzem um deslocamento zero da imagem. As áreas pretas produzem o deslocamento negativo máximo do ponto de pesquisa, enquanto o branco produz um deslocamento positivo máximo da pesquisa.
Note que é a busca do 'fundo' que é deslocado, não um deslocamento da própria imagem. Como tal, uma área do mapa de deslocamento contendo 'branco' terá o ponto de referência 'deslocado' por um valor positivo, gerando assim uma cópia da imagem de destino para a direita / para baixo a partir da posição correta. Essa é a imagem que parece ter sido "deslocada" em uma direção negativa para a esquerda / para cima. Entender isso é muito importante para entender como funcionam os mapas de deslocamento.
Os argumentos fornecidos definem a quantidade máxima de deslocamento em pixels que um mapa específico pode produzir. Se a escala de deslocamento for grande o suficiente, também é possível procurar partes da imagem de "fundo" que estão bem fora dos limites do próprio mapa de deslocamento. Ou seja, você pode facilmente copiar uma seção da imagem original de fora da área de sobreposição para a área de sobreposição.
O sinalizador '%' faz a escala de deslocamento em relação ao tamanho da imagem de sobreposição (100% = meia largura / altura da imagem). Usando '!' alterna argumentos de porcentagem para se referir ao tamanho da imagem de destino. esses sinalizadores foram adicionados a partir do IM v6.5.3-5.
Normalmente, é fornecido um único mapa de deslocamento em escala de cinza, que com os valores de escala determinados determinará uma única direção (vetor) na qual os deslocamentos podem ocorrer (positiva ou negativamente). No entanto, se você também especificar uma terceira imagem que é normalmente usada como uma máscara, a imagem composta será usada para o deslocamento X horizontal, enquanto a imagem de máscara será usada para o deslocamento Y vertical. Isso permite que você defina valores de deslocamento completamente diferentes para as direções X e Y, permitindo que você pesquise qualquer ponto dentro dos limites da escala. Em outras palavras, cada pixel pode procurar qualquer outro pixel próximo, produzindo deslocamentos bidimensionais complexos, em vez de simples deslocamentos de um vetor dimensional.
Como alternativa, em vez de fornecer duas imagens separadas, como no IM6.4.4-0, é possível usar o canal 'vermelho' da imagem de sobreposição para especificar o deslocamento horizontal ou X e o canal 'verde' para o deslocamento vertical ou Y.
A partir do IM v6.5.3-5, qualquer canal alfa na imagem de sobreposição é usado como máscara para a transparência da imagem de destino. No entanto, as áreas fora das áreas sobrepostas não serão afetadas.
-exibir host: exibir [.screen]
Especifica o servidor X a ser contatado.
Esta opção é usada com converso para obter imagem ou fonte deste servidor X. Veja X (1).
-dispose método.
defina a configuração da imagem de descarte GIF para imagens que estão sendo criadas ou lidas.
O método de disposição da camada define o modo como cada imagem exibida deve ser modificada após a exibição da 'moldura' atual de uma animação (após o período de 'atraso'), mas antes que o próximo quadro em uma animação seja sobreposto a exibição.
Aqui estão os métodos válidos:
Indefinido 0: Nenhum descarte especificado (equivalente a 'nenhum'). Nenhum 1: Não descarte, apenas sobreponha a próxima imagem do quadro. Segundo plano: limpe a área do quadro com a cor de fundo. Anterior 3: Limpar para a imagem antes desta sobreposição de quadros.
Você também pode usar os números fornecidos acima, que é o que o formato GIF usa internamente para representar as configurações acima.
Para imprimir uma lista completa de métodos de descarte, use - list descarte.
Use + dispose, desative a configuração e evite redefinir os métodos de descarte de camadas das imagens que estão sendo lidas.
Use o método "dispor" para definir o método de descarte de imagens para imagens já armazenadas na memória.
-limite de discrepância - dissimilaridade.
RMSE máximo para correspondência de subimagem (padrão 0,2).
-dissolve src_percent [x dst_percent]
dissolver uma imagem em outra pela porcentagem dada.
A opacidade da imagem composta é multiplicada pela porcentagem dada e, em seguida, é composta "sobre" a imagem principal. Se src_percent for maior que 100, comece a dissolver a imagem principal para que ela fique transparente em um valor de '200'. Se ambas as porcentagens são dadas, cada imagem é dissolvida para as porcentagens dadas.
Observe que as porcentagens de dissolução não adicionam, duas imagens opacas dissolvidas em '50, 50 'produzem uma transparência de 75%. Para uma combinação de 50% + 50% das duas imagens, você precisaria usar valores de dissolução de '50, 100 '.
Argumentos do método - distort.
distorcer uma imagem, usando o método fornecido e seus argumentos obrigatórios.
Os argumentos são uma única string contendo uma lista de números de ponto flutuante separados por vírgulas ou espaços. O número e o significado dos valores de ponto flutuante dependem do método de distorção que está sendo usado.
Escolha entre esses tipos de distorção:
O número de argumentos determina o significado específico de cada argumento para as operações de escalas, rotação e conversão.
2: Ângulo de escala 3: X, Y Ângulo 4: X, Y Ângulo de escala 5: X, Y ScaleX, ScaleY Ângulo 6: X, Y Ângulo de escala NewX, NewY 7: X, Y ScaleX, ScaleY Ângulo NewX, NewY Este é na verdade, uma maneira alternativa de especificar uma distorção linear bidimensional 'Affine' ou 'AffineProjection'.
Mais de 3 conjuntos dados a pares de pontos de controle (12 números) são os quadrados mínimos ajustados para melhor corresponder a uma distorção afim linear. Se apenas dois pares de pontos de controle (8 números) receberem uma rotação de translação de imagem de dois pontos e a escala for executada, sem qualquer possível distorção, invertendo ou alterando a proporção para a imagem resultante. Se apenas um par de pontos de controle for fornecido, a imagem será traduzida somente (o que pode ser uma tradução não inteira de ponto flutuante).
Essa distorção não inclui qualquer forma de distorção de perspectiva.
Veja a configuração do perfil para mais detalhes e o significado desses coeficientes.
As distorções 'Affine' e 'SRT' fornecem métodos alternativos para definir essa distorção, com o ImageMagick fazendo os cálculos necessários para gerar os coeficientes necessários. Você pode ver os coeficientes gerados internamente, usando uma configuração - verbose com essas outras variantes.
O 'BilinearForward' é usado para mapear retângulos para qualquer quadrilátero, enquanto a forma 'BilinearReverse' mapeia qualquer quadrilátero para um retângulo, enquanto preserva as bordas da linha reta em cada caso.
Observe que 'BilinearForward' pode gerar pixels inválidos que serão coloridos usando a configuração de cor - mattecolor. Além disso, se o quadrilátero se tornar "invertido", a imagem pode desaparecer.
Existem planos futuros para produzir uma verdadeira distorção bilinear que tentará mapear qualquer quadrilátero para qualquer outro quadrilátero, preservando as arestas (e as proporções de distância das bordas).
Perspectiva As imagens distorcidas asseguram que as linhas retas permaneçam retas, mas a escala da imagem distorcida varia. O horizonte é anti-aliased e a cor 'sky' pode ser definida usando a configuração - mattecolor.
Esta é uma variação de uma distorção polar projetada para tentar preservar a relação de aspecto da imagem em vez da conversão direta de cartesiano para polar.
Argumentos: Rmax, Rmin CenterX, CenterY, start, end_angle.
Todos os argumentos são opcionais. Com Rmin padronizando para zero, o centro para o centro da imagem e os ângulos indo de -180 (superior) a +180 (superior). Se Rmax recebe o valor especial de '0', a distância do centro até a borda mais próxima é usada para o raio da imagem de saída, o que garantirá que toda a imagem seja visível (embora reduzida em escala). No entanto, um valor especial de '-1' usará a distância do centro até o canto mais distante. Isso poderá 'recortar' os cantos da imagem retangular de entrada, mas gerará o inverso exato de um 'DePolar' com os mesmos argumentos.
Se a forma mais de distorção (+ distorção) for usada, o centro da imagem de saída será padronizado para 0,0 da tela virtual, e o tamanho da imagem será ajustado para garantir que toda a imagem de entrada fique visível na imagem de saída na tela virtual.
A configuração especial Rmax de '0' pode, no entanto, cortar os cantos da imagem de entrada. No entanto, usar a configuração especial Rmax de '-1' (distância máxima de centro a canto) garantirá que toda a imagem distorcida seja preservada no resultado gerado, de modo que o mesmo argumento para 'Polar' inverterá a distorção reproduzindo o original. Observe que, como essa distorção requer a área de reamostragem de um arco circular, que não pode ser manipulado pela função de reamostragem EWA incorporada. Assim, os filtros normais da EWA são desativados. Recomenda-se que seja utilizada alguma forma de técnica de processamento de imagens de 'super-amostragem' para produzir um resultado de alta qualidade.
Argumentos: A B C [D [X, Y]]
Então, isso forma a função.
Rsrc = r * (A * r 3 + B * r 2 + C * r + D)
Onde X, Y é o centro opcional da distorção (padrão para o centro da imagem).
A segunda forma é normalmente usada para distorcer imagens, em vez de corrigir distorções de lentes.
Rsrc = r / (A * r3 + B * r2 + C * r + D)
Note que este não é o contrário da distorção "Barrel", apenas um método diferente de distorção radial em forma de barril.
A distorção foi comparada a "puxar com o dedo" usando pregos ou alfinetes "presos em um bloco de" geleia "que é então movido para a nova posição, distorcendo a superfície da geléia.
Internamente, é equivalente a gerar um mapa de deslocamento (consulte - displace) para pesquisa de cor da imagem de origem usando o método - sparse-color com o mesmo nome.
Para imprimir uma lista completa dos métodos de distorção, use - list distorcendo.
Muitos dos métodos de distorção acima, como 'Affine', 'Perspective' e 'Shepards' usam uma lista de pontos de controle definindo como esses pontos na imagem determinada devem ser distorcidos na imagem de destino. Cada conjunto de quatro valores de ponto flutuante representa uma coordenada de imagem de origem, seguida imediatamente pela coordenada da imagem de destino. Isso produz uma lista de valores como.
onde U, V na imagem de origem é mapeado para X, Y na imagem de destino.
Por exemplo, para distorcer uma imagem usando a distorção de "perspectiva", é necessária uma lista de pelo menos 4 conjuntos de coordenadas ou 16 números. Aqui está a distorção da perspectiva da imagem "rose:" incorporada. Observe como os espaços foram usados para agrupar os 4 conjuntos de pares de coordenadas, para facilitar a leitura e a compreensão.
Se mais do que o número necessário de pares de coordenadas for dado para uma distorção, o método de distorção é 'least squares' ajustado para produzir o melhor resultado para todos os pares de coordenadas dados. If less than the ideal number of points are given, the distort will generally fall back to a simpler form of distortion that can handles the smaller number of coordinates (usually a linear ' Affine ' distortion).
By using more coordinates you can make use of image registration tool to find matching coordinate pairs in overlapping images, so as to improve the 'fit' of the distortion. Of course a bad coordinate pair can also make the 'fit' worse. Caution is always advised.
Colors are acquired from the source image according to a cylindrical resampling - filter, using a special technique known as EWA resampling. This produces very high quality results, especially when images become smaller (minified) in the output, which is very common when using ' perspective ' distortion. For example here we view a infinitely tiled 'plane' all the way to the horizon.
Note that a infinitely tiled perspective images involving the horizon can be very slow, because of the number of pixels that are compressed to generate each individual pixel close to the 'horizon'. You can turn off EWA resampling, by specifying the special - filter setting of ' point ' (recommended if you plan to use super-sampling instead).
If an image generates invalid pixels , such as the 'sky' in the last example, - distort will use the current - mattecolor setting for these pixels. If you do not what these pixels to be visible, set the color to match the rest of the ground.
The output image size will by default be the same as the input image. This means that if the part of the distorted image falls outside the viewed area of the 'distorted space', those parts is clipped and lost. However if you use the plus form of the operator (+distort) the operator will attempt (if possible) to show the whole of the distorted image, while retaining a correct 'virtual canvas' offset, for image layering. This offset may need to be removed using +repage, to remove if it is unwanted.
Setting - verbose setting, will cause - distort to attempt to output the internal coefficients, and the - fx equivalent to the distortion, for expert study, and debugging purposes. This many not be available for all distorts.
You can alternatively specify a special " - define distort:viewport= " setting which will specify the size and the offset of the generated 'viewport' image of the distorted image space.
Setting a " - define distort:scale= scale_factor " will scale the output image (viewport or otherwise) by that factor without changing the viewed contents of the distorted image. This can be used either for 'super-sampling' the image for a higher quality result, or for panning and zooming around the image (with appropriate viewport changes, or post-distort cropping and resizing).
Setting " - define resample:verbose=1 " will output the cylindrical filter lookup table created by the EWA (Elliptical Weighted Average) resampling algorithm. Note this table uses a squared radius lookup value. This is typically only used for debugging EWA resampling.
-distribute-cache port.
launch a distributed pixel cache server.
-dither method.
Apply a Riemersma or Floyd-Steinberg error diffusion dither to images when general color reduction is applied via an option, or automagically when saving to specific formats. This enabled by default.
Dithering places two or more colors in neighboring pixels so that to the eye a closer approximation of the images original color is reproduced. This reduces the number of colors needed to reproduce the image but at the cost of a lower level pattern of colors. Error diffusion dithers can use any set of colors (generated or user defined) to an image.
Dithering is turned on by default, to turn it off use the plus form of the setting, +dither. This will also also render PostScript without text or graphic aliasing. Disabling dithering often (but not always) leads to faster process, a smaller number of colors, but more cartoon like image coloring. Generally resulting in 'color banding' effects in areas with color gradients.
The color reduction operators - colors, - monochrome, - remap, and - posterize, apply dithering to images using the reduced color set they created. These operators are also used as part of automatic color reduction when saving images to formats with limited color support, such as GIF: , XBM: , and others, so dithering may also be used in these cases.
Alternatively you can use - random-threshold to generate purely random dither. Or use - ordered-dither to apply threshold mapped dither patterns, using uniform color maps, rather than specific color maps.
-draw string.
Annotate an image with one or more graphic primitives.
Use this option to annotate or decorate an image with one or more graphic primitives. The primitives include shapes, text, transformations, and pixel operations.
The shape primitives:
point x, y line x0,y0 x1,y1 rectangle x0,y0 x1,y1 roundRectangle x0,y0 x1,y1 wc, hc arc x0,y0 x1,y1 a0,a1 ellipse x0,y0 rx, ry a0,a1 circle x0,y0 x1,y1 polyline x0,y0 . xn, yn polygon x0,y0 . xn, yn bezier x0,y0 . xn, yn path specification image operator x0,y0 w, h filename.
The text primitive:
text x0,y0 string.
The text gravity primitive:
gravity NorthWest, North, NorthEast, West, Center, East, SouthWest, South, or SouthEast.
The text gravity primitive only affects the placement of text and does not interact with the other primitives. It is equivalent to using the - gravity command-line option, except that it is limited in scope to the - draw option in which it appears.
The transformation primitives:
rotate degrees translate dx, dy scale sx, sy skewX degrees skewY degrees.
The pixel operation primitives:
color x0,y0 method matte x0,y0 method.
The shape primitives are drawn in the color specified by the preceding - fill setting. For unfilled shapes, use - fill none. You can optionally control the stroke (the "outline" of a shape) with the - stroke and - strokewidth settings.
A point primitive is specified by a single point in the pixel plane, that is, by an ordered pair of integer coordinates, x , y . (As it involves only a single pixel, a point primitive is not affected by - stroke or - strokewidth.)
A line primitive requires a start point and end point.
A rectangle primitive is specified by the pair of points at the upper left and lower right corners.
A roundRectangle primitive takes the same corner points as a rectangle followed by the width and height of the rounded corners to be removed.
The circle primitive makes a disk (filled) or circle (unfilled). Give the center and any point on the perimeter (boundary).
The arc primitive is used to inscribe an elliptical segment in to a given rectangle. An arc requires the two corners used for rectangle (see above) followed by the start and end angles of the arc of the segment segment (e. g. 130,30 200,100 45,90). The start and end points produced are then joined with a line segment and the resulting segment of an ellipse is filled.
Use ellipse to draw a partial (or whole) ellipse. Give the center point, the horizontal and vertical "radii" (the semi-axes of the ellipse) and start and end angles in degrees (e. g. 100,100 100,150 0,360).
The polyline and polygon primitives require three or more points to define their perimeters. A polyline is simply a polygon in which the final point is not stroked to the start point. When unfilled, this is a polygonal line . If the - stroke setting is none (the default), then a polyline is identical to a polygon .
A coordinate is a pair of integers separated by a space or optional comma.
As an example, to define a circle centered at 100,100 that extends to 150,150 use:
The Bezier primitive creates a spline curve and requires three or points to define its shape. The first and last points are the knots and these points are attained by the curve, while any intermediate coordinates are control points . If two control points are specified, the line between each end knot and its sequentially respective control point determines the tangent direction of the curve at that end. If one control point is specified, the lines from the end knots to the one control point determines the tangent directions of the curve at each end. If more than two control points are specified, then the additional control points act in combination to determine the intermediate shape of the curve. In order to draw complex curves, it is highly recommended either to use the path primitive or to draw multiple four-point bezier segments with the start and end knots of each successive segment repeated. Por exemplo:
A path represents an outline of an object, defined in terms of moveto (set a new current point), lineto (draw a straight line), curveto (draw a Bezier curve), arc (elliptical or circular arc) and closepath (close the current shape by drawing a line to the last moveto) elements. Compound paths (i. e., a path with subpaths, each consisting of a single moveto followed by one or more line or curve operations) are possible to allow effects such as donut holes in objects. (See Paths.)
Use image to composite an image with another image. Follow the image keyword with the composite operator, image location, image size, and filename:
You can use 0,0 for the image size, which means to use the actual dimensions found in the image header. Otherwise, it is scaled to the given dimensions. See Alpha Compositing for a detailed discussion of alpha composition methods that are available.
The "special augmented compose operators" such as "dissolve" that require arguments cannot be used at present with the - draw image option.
Use text to annotate an image with text. Follow the text coordinates with a string. If the string has embedded spaces, enclose it in single or double quotes.
For example, the following annotates the image with Works like magick! for an image titled bird. miff .
See the - annotate option for another convenient way to annotate an image with text.
The rotate primitive rotates subsequent shape primitives and text primitives about the origin of the main image.
The translate primitive translates subsequent shape and text primitives.
The scale primitive scales them.
The skewX and skewY primitives skew them with respect to the origin of the main image or the region.
The transformations modify the current affine matrix, which is initialized from the initial affine matrix defined by the - affine option. Transformations are cumulative within the - draw option. The initial affine matrix is not affected; that matrix is only changed by the appearance of another - affine option. If another - draw option appears, the current affine matrix is reinitialized from the initial affine matrix.
Use the color primitive to change the color of a pixel to the fill color (see - fill). Follow the pixel coordinate with a method:
Consider the target pixel as that specified by your coordinate. The point method recolors the target pixel. The replace method recolors any pixel that matches the color of the target pixel. Floodfill recolors any pixel that matches the color of the target pixel and is a neighbor, whereas filltoborder recolors any neighbor pixel that is not the border color. Finally, reset recolors all pixels.
Use matte to the change the pixel matte value to transparent. Follow the pixel coordinate with a method (see the color primitive for a description of methods). The point method changes the matte value of the target pixel. The replace method changes the matte value of any pixel that matches the color of the target pixel. Floodfill changes the matte value of any pixel that matches the color of the target pixel and is a neighbor, whereas filltoborder changes the matte value of any neighbor pixel that is not the border color (-bordercolor). Finally reset changes the matte value of all pixels.
You can set the primitive color, font, and font bounding box color with - fill, - font, and - box respectively. Options are processed in command line order so be sure to use these options before the - draw option.
Strings that begin with a number must be quoted (e. g. use '1.png' rather than 1.png).
Drawing primitives conform to the Magick Vector Graphics format.
-duplicate count, indexes.
duplicate an image one or more times.
Specify the count and the image to duplicate by its index in the sequence. The first image is index 0. Negative indexes are relative to the end of the sequence, for example, -1 represents the last image of the sequence. Specify a range of images with a dash (e. g. 0-4). Separate indexes with a comma (e. g. 0,2). Use +duplicate to duplicate the last image in the current image sequence.
-edge radius.
detect edges within an image.
-emboss radius.
emboss an image.
-encipher filename.
Encipher pixels for later deciphering by - decipher.
Get the passphrase from the file specified by filename .
-encoding type.
specify the text encoding.
-endian type.
Specify endianness ( MSB or LSB ) of the image.
To print a complete list of endian types, use the - list endian option.
Use +endian to revert to unspecified endianness.
Apply a digital filter to enhance a noisy image.
perform histogram equalization on the image channel-by-channel.
To perform histogram equalization on all channels in concert, transform the image into some other color space, such as HSL, OHTA, YIQ or YUV, then equalize the appropriate intensity-like channel, then convert back to RGB.
For example using HSL, we have: . - colorspace HSL - channel lightness - equalize - colorspace RGB .
For YIQ, YUV and OHTA use the red channel. For example, OHTA is a principal components transformation that puts most of the information in the first channel. Here we have . - colorspace OHTA - channel red - equalize - colorspace RGB .
-evaluate operator value.
Alter channel pixels by evaluating an arithmetic, relational, or logical expression.
(See the - function operator for some multi-parameter functions. See the - fx operator if more elaborate calculations are needed.)
The behaviors of each operator are summarized in the following list. For brevity, the numerical value of a "pixel" referred to below is the value of the corresponding channel of that pixel, while a "normalized pixel" is that number divided by the maximum (installation-dependent) value QuantumRange . (If normalized pixels are used, they are restored, following the other calculations, to the full range by multiplying by QuantumRange .)
The specified functions are applied only to each previously set - channel in the image. If necessary, the results of the calculations are truncated (clipped) to fit in the interval [0, QuantumRange ]. The transparency channel of the image is represented as a 'alpha' values (0 = fully transparent), so, for example, a Divide by 2 of the alpha channel will make the image semi-transparent. Append the percent symbol ' % ' to specify a value as a percentage of the QuantumRange .
To print a complete list of - evaluate operators, use - list evaluate.
The results of the Add , Subtract and Multiply methods can also be achieved using either the - level or the +level operator, with appropriate argument, to linearly modify the overall range of color values. Please note, however, that - level treats transparency as 'matte' values (0 = opaque), while - evaluate works with 'alpha' values.
AddModulus has been added as of ImageMagick 6.4.8-4 and provides addition modulo the QuantumRange . It is therefore equivalent to Add unless the resulting pixel value is outside the interval [0, QuantumRange ].
Exp or Exponential has been added as of ImageMagick 6.6.5-1 and works on normalized pixel values. The value used with Exp should be negative so as to produce a decaying exponential function. Non-negative values will always produce results larger unity and thus outside the interval [0, QuantumRange ]. The formula is expressed below.
If the input image is squared, for example, using - function polynomial "2 0 0", then a decaying Gaussian function will be the result.
Log has been added as of ImageMagick 6.4.2-1 and works on normalized pixel values. This a scaled log function. The value used with Log provides a scaling factor that adjusts the curvature in the graph of the log function. The formula applied to a normalized value u is below.
log( value × u + 1) / log( value + 1)
Pow has been added as of ImageMagick 6.4.1-9, and works on normalized pixel values. Note that Pow is related to the - gamma operator. For example, - gamma 2 is equivalent to - evaluate pow 0.5 , i. e., a 'square root' function. The value used with - gamma is simply the reciprocal of the value used with Pow .
Cosine and Sine was added as of IM v6.4.8-8 and converts the image values into a value according to a (co)sine wave function. The synonyms Cos and Sin may also be used. The output is biased 50% and normalized by 50% so as to fit in the respective color value range. The value scaling of the period of the function (its frequency), and thus determines the number of 'waves' that will be generated over the input color range. For example, if the value is 1, the effective period is simply the QuantumRange ; but if the value is 2, then the effective period is the half the QuantumRange .
0.5 + 0.5 × cos(2 π u × value ).
See also the - function operator, which is a multi-value version of evaluate.
-evaluate-sequence operator.
Alter channel pixels by evaluating an arithmetic, relational, or logical expression over a sequence of images. Ensure all the images in the sequence are in the same colorspace, otherwise you may get unexpected results, e. g. add - colorspace sRGB to your command-line.
To print a complete list of - evaluate-sequence operators, use - list evaluate.
-extent geometry.
Set the image size and offset.
If the image is enlarged, unfilled areas are set to the background color. To position the image, use offsets in the geometry specification or precede with a - gravity setting. To specify how to compose the image with the background, use - compose.
This command reduces or expands a JPEG image to fit on an 800x600 display. If the aspect ratio of the input image isn't exactly 4:3, then the image is centered on an 800x600 black canvas:
See Image Geometry for complete details about the geometry argument.
-extract geometry.
Extract the specified area from image.
This option is most useful for extracting a subregion of a very large raw image. Note that these two commands are equivalent:
If you omit the offsets, as in.
the image is resized to the specified dimensions instead, equivalent to:
See Image Geometry for complete details about the geometry argument.
-family fontFamily.
Set a font family for text.
This setting suggests a font family that ImageMagick should try to use for rendering text. If the family can be found it is used; if not, a default font (e. g., "Arial") or a family known to be similar is substituted (e. g., "Courier" might be used if "System" is requested but not found).
For other settings that affect fonts, see the options - font, - stretch, - style, and - weight.
-features distance.
display (co-occurrence matrix) texture measure features for each channel in the image in each of four directions (horizontal, vertical, left and right diagonals) for the specified distance.
implements the forward discrete Fourier transform (DFT).
This option is new as of ImageMagick 6.5.4-3 (and now working for Windows users in ImageMagick 6.6.0-9). It transforms an image from the normal (spatial) domain to the frequency domain. In the frequency domain, an image is represented as a superposition of complex sinusoidal waves of varying amplitudes. The image x and y coordinates are the possible frequencies along the x and y directions, respectively, and the pixel intensity values are complex numbers that correspond to the sinusoidal wave amplitudes. See for example, Fourier Transform, Discrete Fourier Transform and Fast Fourier Transform.
A single image name is provided as output for this option. However, the output result will have two components. It is either a two-frame image or two separate images, depending upon whether the image format specified supports multi-frame images. The reason that we get a dual output result is because the frequency domain represents an image using complex numbers, which cannot be visualized directly. Therefore, the complex values are automagically separated into a two-component image representation. The first component is the magnitude of the complex number and the second is the phase of the complex number. See for example, Complex Numbers.
The magnitude and phase component images must be specified using image formats that do not limit the color or compress the image. Thus, MIFF, TIF, PFM, EXR and PNG are the recommended image formats to use. All of these formats, except PNG support multi-frame images. So for example,
generates a magnitude image as fft_image. miff[0] and a phase image as fft_image. miff[1] . Similarly,
generates a magnitude image as fft_image-0.png and a phase image as fft_image-1.png . If you prefer this representation, then you can force any of the other formats to produce two output images by including +adjoin following - fft in the command line.
The input image can be any size, but if not square and even-dimensioned, it is padded automagically to the larger of the width or height of the input image and to an even number of pixels. The padding will occur at the bottom and/or right sides of the input image. The resulting output magnitude and phase images is square at this size. The kind of padding relies on the - virtual-pixel setting.
Both output components will have dynamic ranges that fit within [0, QuantumRange ], so that HDRI need not be enabled. Phase values nominally range from 0 to 2*π, but is scaled to span the full dynamic range. (The first few releases had non-HDRI scaled but HDRI not scaled). The magnitude image is not scaled and thus generally will contain very small values. As such, the image normally will appear totally black. In order to view any detail, the magnitude image typically is enhanced with a log function into what is usually called the spectrum. A log function is used to enhance the darker values more in comparison to the lighter values. This can be done, for example, as follows:
where either - contrast-stretch 0 or - auto-level is used to scale the image to full dynamic range, first. The argument to the - evaluate log typically is specified between 100 and 10,000, depending upon the amount of detail that one wants to bring out in the spectrum. Larger values produce more visible detail. Too much detail, however, may hide the important features.
The FFTW delegate library is required to use - fft.
Use +fft to produce two output images that are the real and imaginary components of the complex valued Fourier transform.
However, as the real and imaginary components can contain negative values, this requires that IM be configured with HDRI enabled. In this case, you must use either MIFF, TIF, PFM or MPC formats for the real and imaginary component results, since they are formats that preserve both negative and fractional values without clipping them or truncating the fractional part. With either MIFF or TIF, one should add - define quantum:format=32, to allow those image types to work properly in HDRI mode without clipping.
The real and imaginary component images resulting from +fft are also square, even dimensioned images due to the same padding that was discussed above for the magnitude and phase component images.
See the discussion on HDRI implementations of ImageMagick on the page High Dynamic-Range Images. For more about HDRI go the ImageMagick Usage pages, Fred's Fourier Processing With ImageMagick page or this Wikipedia entry.
By default the FFT is normalized (and the IFT is not). Use " - define fourier:normalize=forward to explicitly normalize the FFT and unnormalize the IFT.
-fill color.
color to use when filling a graphic primitive.
This option accepts a color name, a hex color, or a numerical RGB, RGBA, HSL, HSLA, CMYK, or CMYKA specification. See Color Names for a description of how to properly specify the color argument.
Enclose the color specification in quotation marks to prevent the "#" or the parentheses from being interpreted by your shell.
See - draw for further details.
To print a complete list of color names, use the - list color option.
-filter type.
Use this type of filter when resizing or distorting an image.
Use this option to affect the resizing operation of an image during operations such as - resize and - distort. For example you can use a simple resize filter such as:
Use - define filter:lobes= to specify the support size for filtering for the CubicSpline filter.
The Bessel and Sinc filter is also provided (as well as a faster SincFast equivalent form). However these filters are generally useless on their own as they are infinite filters that are being clipped to the filters support size. Their direct use is not recommended except via expert settings (see below).
Instead these special filter functions are typically windowed by a windowing function that the - filter setting defines. That is using these functions will define a 'Windowed' filter, appropriate to the operator involved. Windowed filters include:
Also one special self-windowing filter is also provided Lagrange , which will automagically re-adjust its function depending on the current 'support' or 'lobes' expert settings (see below).
If you do not select a filter with this option, the filter defaults to Mitchell for a colormapped image, an image with a matte channel, or if the image is enlarged. Otherwise the filter default to Lanczos .
To print a complete list of resize filters, use the - list filter option.
You can modify how the filter behaves as it scales your image through the use of these expert settings (see also - define and - set):-
For example, to get a 8 lobe jinc windowed sinc filter (Genseng filter?):
Or a raw un-windowed Sinc filter with 4 lobes:
To extract the data for a raw windowing function, combine it with a ' Box ' filter. For example the ' Welch parabolic windowing function.
Note that the use of expert options is provided for image processing experts who have studied and understand how resize filters work. Without this knowledge, and an understanding of the definition of the actual filters involved, using expert settings are more likely to be detrimental to your image resizing.
This is a simple alias for the - layers method "flatten".
create a mirror image.
reflect the scanlines in the vertical direction. The image will be mirrored upside-down.
-floodfill x y color.
floodfill the image with color at the specified offset.
Flood fill starts from the given 'seed point' which is not gravity affected. Any color that matches within - fuzz color distance of the given color argument, connected to that 'seed point' will be replaced with the current - fill color.
Note that if the pixel at the 'seed point' does not itself match the given color (according to - fuzz), then no action will be taken.
This operator works more like the - opaque option, than a more general flood fill that reads the matching color directly at the 'seed point'. For this form of flood fill, look at - draw and its 'color floodfill' drawing method.
create a mirror image .
Reflect the scanlines in the horizontal direction, just like the image in a vertical mirror.
set the font to use when annotating images with text, or creating labels.
To print a complete list of fonts, use the - list font option (for versions prior to 6.3.6, use 'type' instead of 'font').
In addition to the fonts specified by the above pre-defined list, you can also specify a font from a specific source. For example Arial. ttf is a TrueType font file, ps:helvetica is PostScript font, and x:fixed is X11 font.
For other settings that affect fonts, see the options - family, - stretch, - style, and - weight.
-foreground color.
Define the foreground color for menus.", "display.
The color is specified using the format described under the - fill option.
The default foreground color is black.
-format type.
the image format type.
When used with the mogrify utility, this option converts any image to the image format you specify. For a list of image format types supported by ImageMagick, use - list format.
By default the file is written to its original name. However, if the filename extension matches a supported format, the extension is replaced with the image format type specified with - format. For example, if you specify tiff as the format type and the input image filename is image. gif , the output image filename becomes image. tiff .
-format string.
output formatted image characteristics.
See Format and Print Image Properties for an explanation on how to specify the argument to this option.
-frame geometry.
Surround the image with a border or beveled frame.
The color of the border is specified with the - mattecolor command line option.
See Image Geometry for complete details about the geometry argument. The size portion of the geometry argument indicates the amount of extra width and height that is added to the dimensions of the image. If no offsets are given in the geometry argument, then the border added is a solid color. Offsets x and y , if present, specify that the width and height of the border is partitioned to form an outer bevel of thickness x pixels and an inner bevel of thickness y pixels. Negative offsets make no sense as frame arguments.
The - frame option is affected by the current - compose setting and assumes that this is using the default ' Over ' composition method. It generates an image of the appropriate size with the current - bordercolor setting, and then draws the frame of four distinct colors close to the current - mattecolor. The original image is then overlaid onto center of this image. This means that with the default compose method of ' Over ' any transparent parts may be replaced by the current - bordercolor setting.
The image composition is not affected by the - gravity option.
include the X window frame in the imported image.
-function function parameters.
Apply a function to channel values.
This operator performs calculations based on the given arguments to modify each of the color values for each previously set - channel in the image. See - evaluate for details concerning how the results of the calculations are handled.
This is can be considered a multi-argument version of the - evaluate operator. (Added in ImageMagick 6.4.8−8.)
Here, parameters is a comma-separated list of numerical values. The number of values varies depending on which function is selected. Choose the function from:
To print a complete list of - function operators, use - list function. Descriptions follow.
The Polynomial function takes an arbitrary number of parameters, these being the coefficients of a polynomial, in decreasing order of degree. That is, entering.
will invoke a polynomial function given by.
where u is pixel's original normalized channel value.
The Polynomial function can be used in place of Set (the constant polynomial) and Add , Divide , Multiply , and Subtract (some linear polynomials) of the - evaluate operator. The - level operator also affects channels linearly. Some correspondences follow.
The Polynomial function gives great versatility, since polynomials can be used to fit any continuous curve to any degree of accuracy desired.
The Sinusoid function can be used to vary the channel values sinusoidally by setting frequency, phase shift, amplitude, and a bias. These values are given as one to four parameters, as follows,
where phase is in degrees. (The domain [0,1] of the function corresponds to 0 through freq ×360 degrees.) The result is that if a pixel's normalized channel value is originally u , its resulting normalized value is given by.
For example, the following generates a curve that starts and ends at 0.9 (when u =0 and 1, resp.), oscillating three times between .7−.2=.5 and .7+.2=.9.
The default values of amp and bias are both .5. The default for phase is 0.
The Sinusoid function generalizes Sin and Cos of the - evaluate operator by allowing varying amplitude, phase and bias. The correspondence is as follows.
The ArcSin function generates the inverse curve of a Sinusoid, and can be used to generate cylindrical distortion and displacement maps. The curve can be adjusted relative to both the input values and output range of values.
with all values given in terms of normalized color values (0.0 for black, 1.0 for white). Defaulting to values covering the full range from 0.0 to 1.0 for bout input ( width ), and output ( width ) values. ' 1.0,0.5,1.0,0.5 '
The ArcTan function generates a curve that smooth crosses from limit values at infinities, though a center using the given slope value. All these values can be adjusted via the arguments.
Defaulting to ' 1.0,0.5,1.0,0.5 '.
-fuzz distance.
Colors within this distance are considered equal.
A number of algorithms search for a target color. By default the color must be exact. Use this option to match colors that are close to the target color in RGB space. For example, if you want to automagically trim the edges of an image with - trim but the image was scanned and the target background color may differ by a small amount. This option can account for these differences.
The distance can be in absolute intensity units or, by appending % as a percentage of the maximum possible intensity (255, 65535, or 4294967295).
Use +fuzz to reset the fuzz value to 0.
-fx expression.
apply a mathematical expression to an image or image channels.
If the first character of expression is @ , the expression is read from a file titled by the remaining characters in the string.
-gamma value.
level of gamma correction.
The same color image displayed on two different workstations may look different due to differences in the display monitor. Use gamma correction to adjust for this color difference. Reasonable values extend from 0.8 to 2.3 . Gamma less than 1.0 darkens the image and gamma greater than 1.0 lightens it. Large adjustments to image gamma may result in the loss of some image information if the pixel quantum size is only eight bits (quantum range 0 to 255).
Gamma adjusts the image's channel values pixel-by-pixel according to a power law, namely, pow(pixel,1/gamma) or pixel^(1/gamma), where pixel is the normalized or 0 to 1 color value. For example, using a value of gamma=2 is the same as taking the square root of the image.
Use +gamma value to set the image gamma level without actually adjusting the image pixels. This option is useful if the image is of a known gamma but not set as an image attribute (e. g. PNG images). Write the "file gamma" which is the reciprocal of the display gamma; e. g., if your image is sRGB and you want to write a PNG gAMA chunk, use.
Note that gamma adjustments are also available via the - level operator.
-gaussian-blur radius.
-gaussian-blur radius x sigma.
Blur the image with a Gaussian operator.
Convolve the image with a Gaussian or normal distribution using the given Sigma value. A fórmula é:
The Sigma value is the important argument, and determines the actual amount of blurring that will take place.
The Radius is only used to determine the size of the array which will hold the calculated Gaussian distribution. It should be an integer. If not given, or set to zero, IM will calculate the largest possible radius that will provide meaningful results for the Gaussian distribution.
The larger the Radius the radius the slower the operation is. However too small a Radius , and severe aliasing effects may result. As a guideline, Radius should be at least twice the Sigma value, though three times will produce a more accurate result.
This differs from the faster - blur operator in that a full 2-dimensional convolution is used to generate the weighted average of the neighboring pixels.
The - virtual-pixel setting will determine how pixels which are outside the image proper are blurred into the final result.
-geometry geometry.
Set the preferred size and location of the image.
See Image Geometry for complete details about the geometry argument.
-gravity type.
Sets the current gravity suggestion for various other settings and options.
Choices include: NorthWest , North , NorthEast , West , Center , East , SouthWest , South , SouthEast . Use - list gravity to get a complete list of - gravity settings available in your ImageMagick installation.
The direction you choose specifies where to position text or subimages. For example, a gravity of Center forces the text to be centered within the image. By default, the image gravity is undefined . See - draw for more details about graphic primitives. Only the text primitive of - draw is affected by the - gravity option.
The - gravity option is also used in concert with the - geometry setting and other settings or options that take geometry as an argument, such as the - crop option.
If a - gravity setting occurs before another option or setting having a geometry argument that specifies an offset, the offset is usually applied to the point within the image suggested by the - gravity argument. Thus, in the following command, for example, suppose the file image. png has dimensions 200x100. The offset specified by the argument to - region is (−40,+20). The argument to - gravity is Center , which suggests the midpoint of the image, at the point (100,50). The offset (−40,20) is applied to that point, giving (100−40,50+20)=(60,70), so the specified 10x10 region is located at that point. (In addition, the - gravity affects the region itself, which is centered at the pixel coordinate (60,70). (See Image Geometry for complete details about the geometry argument.)
When used as an option to composite, - gravity gives the direction that the image gravitates within the composite.
When used as an option to montage, - gravity gives the direction that an image gravitates within a tile. The default gravity is Center for this purpose.
-grayscale method.
convert image to grayscale.
This will use one of the - intensity methods to convert the given image into a grayscale image.
For example, to convert an image to (linear) Rec709Luminance grayscale, type:
which is equivalent to:
Note that LinearGray is new as of Imagemagick 6.9.9-29 and 7.0.7-17.
Similarly, to convert an image to (non-linear) Rec709Luma grayscale, type:
which is equivalent to:
Note that a 'colorspace' intensity method will produce the same result regardless of the current colorpsace of the image. But a 'mathematical' intensity method depends on the current colorspace the image is currently using.
While this operation uses an - intensity method, it does not use or set the - intensity setting, so will not affect other operations that may use that setting.
-green-primary x, y.
green chromaticity primary point.
apply a Hald color lookup table to the image.
A Hald color lookup table is a 3-dimensional color cube mapped to 2 dimensions. Create it with the HALD: prefix (e. g. HALD:8). You can apply any color transformation to the Hald image and then use this option to apply the transform to the image.
This option provides a convenient method for you to use Gimp or Photoshop to make color corrections to the Hald CLUT image and subsequently apply them to multiple images using an ImageMagick script.
Note that the representation is only of the normal RGB color space and that the whole color value triplet is used for the interpolated lookup of the represented Hald color cube image. Because of this the operation is not - channel setting affected, nor can it adjust or modify an images transparency or alpha/matte channel.
See also - clut which provides color value replacement of the individual color channels, usually involving a simpler grayscale image. E. g: grayscale to color replacement, or modification by a histogram mapping.
print usage instructions.
-highlight-color color.
when comparing images, emphasize pixel differences with this color.
-hough-lines width x height.
identify straight lines in the image (e. g. - hough-lines 9x9+195).
Use the Hough line detector with any binary edge extracted image to locate and draw any straight lines that it finds.
The process accumulates counts for every white pixel in the binary edge image for every possible orientation (for angles from 0 to 179 in 1 deg increments) and distance from the center of the image to the corners (in 1 px increments). It stores the counts in an accumulator matrix of angle vs distance. The size of the accumulator will be 180x(diagonal/2). Next it searches the accumulator for peaks in counts and converts the locations of the peaks to slope and intercept in the normal x, y input image space. The algorithm uses slope/intercepts to find the endpoints clipped to the bounds of the image. The lines are drawn from the given endpoints. The counts are a measure of the length of the lines.
The WxH arguments specify the filter size for locating the peaks in the Hough accumulator. The threshold excludes lines whose counts are less than the threshold value.
Use - background to specify the color of the background onto which the lines will be drawn. The default is black.
Use - fill to specify the color of the lines. The default is black.
Use - stroke and - strokewidth to specify the thickness of the lines. The default is black and no strokewidth.
A text file listing the endpoints and counts may be created by using the suffix,.mvg, for the output image.
Use - define hough-lines:accumulator=true to return the accumulator image in addition to the lines image.
-iconGeometry geometry.
specify the icon geometry.
Offsets, if present in the geometry specification, are handled in the same manner as the - geometry option, using X11 style to handle negative offsets.
See Image Geometry for complete details about the geometry argument.
start in icon mode in X Windows", 'animate', 'display.
identify the format and characteristics of the image.
This information is printed: image scene number; image name; image size; the image class ( DirectClass or PseudoClass ); the total number of unique colors; and the number of seconds to read and transform the image. Refer to MIFF for a description of the image class.
If - colors is also specified, the total unique colors in the image and color reduction error values are printed. Refer to color reduction algorithm for a description of these values.
If - verbose precedes this option, copious amounts of image properties are displayed including image statistics, profiles, image histogram, and others.
implements the inverse discrete Fourier transform (DFT).
This option is new as of ImageMagick 6.5.4-3 (and now working for Windows users in ImageMagick 6.6.0-9). It transforms a pair of magnitude and phase images from the frequency domain to a single image in the normal or spatial domain. See for example, Fourier Transform, Discrete Fourier Transform and Fast Fourier Transform.
For example, depending upon the image format used to store the result of the - fft, one would use either.
The resulting image may need to be cropped due to padding introduced when the original image, prior to the - fft or +fft, was not square or even dimensioned. Any padding is at the right and/or bottom sides of the image.
The FFTW delegate library is required to use - ift.
Use +ift (with HDRI enabled) to transform a pair of real and imaginary images from the frequency domain to a single image in the normal (spatial) domain.
By default the IFT is not normalized (and the FFT is). Use " - define fourier:normalize=inverse to explicitly normalize the IFT and unnormalize the FFT.
make image immutable.
-implode factor.
implode image pixels about the center.
-insert index.
insert the last image into the image sequence.
This option takes last image in the current image sequence and inserts it at the given index. If a negative index is used, the insert position is calculated before the last image is removed from the sequence. As such - insert -1 will result in no change to the image sequence.
The +insert option is equivalent to - insert -1 . In other words, insert the last image, at the end of the current image sequence. Consequently this has no effect on the image sequence order.
-intensity method.
method to generate intensity value from pixel.
ImageMagick provides a number of methods used in situations where an operator needs to determine a single grayscale value for some purpose, from an image with red, green, and blue pixel components. Typically the Rec709Luma formula is used, which is the same formula used when converting images to - colorspace gray .
The following formulas are currently provided, and will first convert the pixel values to linear-RGB or non-linear sRGB colorspace before being applied to calculate the final greyscale value.
Rec601Luma 0.298839R' + 0.586811G'+ 0.114350B' Rec601Luminance 0.298839R + 0.586811G + 0.114350B Rec709Luma 0.212656R' + 0.715158G' + 0.072186B' Rec709Luminance 0.212656R + 0.715158G + 0.072186B Brightness max(R', G', B') Lightness (min(R', G', B') + max(R', G', B')) / 2.0.
Note that the above R, G,B values is the image's linear-RGB values, while R',G',B' are sRGB non-linear values.
These intensity methods are mathematical in nature and will use the current value in the images respective R, G,B channel regardless of what that is, or what colorspace the image is currently using.
Average (R' + G' + B') / 3.0 MS (R'^2 + G'^2 + B'^2) / 3.0 RMS sqrt( (R'^2 + G'^2 + B'^2) / 3.0 )
These methods are often used for other purposes, such as generating a grayscale difference image between two color images (using - compose ' Difference ' composition.
For example The 'MS' (Mean Squared) setting is good for minimizing color error comparisions. Enquanto. The method 'RMS' (Root Mean Squared) for example is appropriate for calculating color vector distance, from a color difference image. This is equivalent to the color only component of the - fuzz factor color compare setting.
See also - grayscale which applies one of the above grayscaling formula directly to an image without setting the - intensity setting.
The - colorspace gray image conversion also uses the current intensity setting, but will always convert the image to the appropriate sRGB or linear-RGB colorspace before appling the above function.
To print a complete list of possible pixel intensity setting methods, use - list intensity.
Operators affected by the - intensity setting include:
-intent type.
use this type of rendering intent when managing the image color.
Use this option to affect the color management operation of an image (see - profile). Choose from these intents: Absolute, Perceptual, Relative, Saturation .
The default intent is Perceptual for the sRGB colorspace and undefined for the RGB and gray colorspaces.
To print a complete list of rendering intents, use - list intent.
-interlace type.
the type of interlacing scheme.
This option is used to specify the type of interlacing scheme for raw image formats such as RGB or YUV .
None means do not interlace (RGBRGBRGBRGBRGBRGB. ),
Line uses scanline interlacing (RRR. GGG. BBB. RRR. GGG. BBB. ), and.
Plane uses plane interlacing (RRRRRR. GGGGGG. BBBBBB. ).
Partition is like plane except the different planes are saved to individual files (e. g. image. R, image. G, and image. B).
Use Line or Plane to create an interlaced PNG or GIF or progressive JPEG image.
To print a complete list of interlacing schemes, use - list interlace.
-interpolate type.
Set the pixel color interpolation method to use when looking up a color based on a floating point or real value.
When looking up the color of a pixel using a non-integer floating point value, you typically fall in between the pixel colors defined by the source image. This setting determines how the color is determined from the colors of the pixels surrounding that point. That is how to determine the color of a point that falls between two, or even four different colored pixels.
average The average color of the surrounding four pixels average4 The average color of the surrounding four pixels average9 The average color of the surrounding nine pixels average16 The average color of the surrounding sixteen pixels background bilinear A double linear interpolation of pixels (the default) blend catrom Fitted bicubic-spines of surrounding 16 pixels integer The color of the top-left pixel (floor function) mesh Divide area into two flat triangular interpolations nearest-neighbor The nearest pixel to the lookup point (rounded function) spline Direct spline curves (colors are blurred)
This most important for distortion operators such as - distort, - implode, - transform and - fx.
To print a complete list of interpolation methods, use - list interpolate.
See also - virtual-pixel, for control of the lookup for positions outside the boundaries of the image.
-interline-spacing value.
the space between two text lines.
-interword-spacing value.
the space between two words.
-kerning value.
the space between two letters.
-kuwahara radius.
-kuwahara radius x sigma.
edge preserving noise reduction filter.
The radius is more important than the sigma . If sigma is left off, it will be computed automatically from the radius as sigma = radius -0.5. The sigma provides a bit of additional smoothing control.
-label name.
assign a label to an image.
Use this option to assign a specific label to the image, as it is read in or created. You can use the - set operation to re-assign a the labels of images already read in. Image formats such as TIFF, PNG, MIFF, supports saving the label information with the image.
When saving an image to a PostScript file, any label assigned to an image is used as a header string to print above the postscript image.
You can include the image filename, type, width, height, or other image attribute by embedding special format character. See Format and Print Image Properties for details of the percent escape codes.
assigns an image label of MIFF:bird. miff 512x480 to the " bird. miff " image and whose width is 512 and height is 480, as it is read in. If a +label option was used instead, any existing label present in the image would be used. You can remove all labels from an image by assigning the empty string.
A label is not drawn on the image, but is embedded in the image datastream via Label tag or similar mechanism. If you want the label to be visible on the image itself, use the - draw option, or during the final processing in the creation of an image montage.
If the first character of string is @ , the image label is read from a file titled by the remaining characters in the string. Labels in a file are literal, no embedded formatting characters are recognized.
-lat width x height offset.
perform local adaptive threshold.
Adaptively threshold each pixel based on the value of pixels in a surrounding window. If the current pixel is lighter than this average plus the optional offset , then it is made white, otherwise it is made black. Small variations in pixel values such as found in scanned documents can be ignored if offset is positive. A negative offset will make it more sensitive to those small variations.
This is commonly used to threshold images with an uneven background. It is based on the assumption that average color of the small window is the the local background color, from which to separate the foreground color.
-layers method.
handle multiple images forming a set of image layers or animation frames.
Perform various image operation methods to a ordered sequence of images which may represent either a set of overlaid 'image layers', a GIF disposal animation, or a fully-'coalesced' animation sequence.
To print a complete list of layer types, use - list layers.
The operators - coalesce, - deconstruct, - flatten, and - mosaic are only aliases for the above methods and may be depreciated in the future. Also see - page, - repage operators, the - compose setting, and the GIF - dispose and - delay settings.
-level black_point.
adjust the level of image channels.
Given one, two or three values delimited with commas: black-point, white-point, gamma (for example: 10,250,1.0 or 2%,98%,0.5). The black and white points range from 0 to QuantumRange , or from 0 to 100%; if the white point is omitted it is set to ( QuantumRange - black_point), so as to center contrast changes. If a % sign is present anywhere in the string, both black and white points are percentages of the full color range. Gamma will do a - gamma adjustment of the values. If it is omitted, the default of 1.0 (no gamma correction) is assumed.
In normal usage ( - level ) the image values are stretched so that the given ' black_point ' value in the original image is set to zero (or black), while the given ' white_point ' value is set to QuantumRange (or white). This provides you with direct contrast adjustments to the image. The ' gamma ' of the resulting image will then be adjusted.
From ImageMagick v6.4.1-9 using the plus form of the operator ( +level ) or adding the special '!' flag anywhere in the argument list, will cause the operator to do the reverse of the level adjustment. That is a zero, or QuantumRange value (black, and white, resp.) in the original image, is adjusted to the given level values, allowing you to de-contrast, or compress the channel values within the image. The ' gamma ' is adjusted before the level adjustment to de-contrast the image is made.
Only the channels defined by the current - channel setting are adjusted (defaults to RGB color channels only), allowing you to limit the effect of this operator.
Please note that the transparency channel is treated as 'matte' values (0 is opaque) and not as 'alpha' values (0 is transparent).
-level-colors.
adjust the level of an image using the provided dash separated colors.
This function is exactly like - level, except that the value value for each color channel is determined by the ' black_color ' and ' white_color ' colors given (as described under the - fill option).
This effectively means the colors provided to - level-colors is mapped to become 'black' and 'white' respectively, with all the other colors linearly adjusted (or clipped) to match that change. Each channel is adjusted separately using the channel values of the colors specified.
On the other hand the plus form of the operator ( +level-colors ) will map the image color 'black' and 'white' to the given colors respectively, resulting in a gradient (de-contrasting) tint of the image to those colors. This can also be used to convert a plain grayscale image into a one using the gradient of colors specified.
By supplying a single color with a comma separator either before or after that color, will just replace the respective 'black' or 'white' point respectively. But if no comma separator is provided, the given color is used for both the black and white color points, making the operator either threshold the images around that color (- form) or set all colors to that color (+ form).
-limit type value.
Set the pixel cache resource limit.
Choose from: width , height , area , memory , map , disk , file , thread , throttle , or time .
The value for file is in number of files. The other limits are in bytes. Define arguments for the memory, map, area, and disk resource limits with SI prefixes (.e. g 100MB).
By default the limits are 768 files, 3GB of image area, 1.5GiB memory, 3GiB memory map, and 18.45EB of disk. These limits are adjusted relative to the available resources on your computer if this information is available. When any limit is reached, ImageMagick fails in some fashion but attempts to take compensating actions, if possible. For example, the following limits memory:
Use - list resource to list the current limits. For example, our system shows these limits:
Requests for pixel storage to keep intermediate images are satisfied by one of three resource categories: in-memory pool, memory-mapped files pool, and disk pool (in that order) depending on the ‑limit settings and whether the system honors a resource request. If the total size of allocated pixel storage in the given pool reaches the corresponding limit, the request is passed to the next pool. Additionally, requests that exceed the area limit automagically are allocated on disk.
To illustrate how ImageMagick utilizes resource limits, consider a typical image resource request. First, ImageMagick tries to allocate the pixels in memory. The request might be denied if the resource request exceeds the memory limit or if the system does not honor the request. If a memory request is not honored, the pixels are allocated to disk and the file is memory-mapped. However, if the allocation request exceeds the map limit, the resource allocation goes to disk. In all cases, if the resource request exceeds the area limit, the pixels are automagically cached to disk. If the disk has a hard limit, the program fails.
In most cases you simply do not need to concern yourself with resource limits. ImageMagick chooses reasonable defaults and most images do not tax your computer resources. Where limits do come in handy is when you process images that are large or on shared systems where ImageMagick can consume all or most of the available memory. In this case, the ImageMagick workflow slows other processes or, in extreme cases, brings the system to a halt. Under these circumstances, setting limits give some assurances that the ImageMagick workflow will not interfere with other concurrent uses of the computer. For example, assume you have a web interface that processes images uploaded from the Internet. To assure ImageMagick does not exceed 10MiB of memory you can simply set the area limit to 10MiB:
Now whenever a large image is processed, the pixels are automagically cached to disk instead of memory. This of course implies that large images typically process very slowly, simply because pixel processing in memory can be an order of magnitude faster than on disk. Because your web site users might inadvertently upload a huge image to process, you should set a disk limit as well:
Here ImageMagick stops processing if an image requires more than 500MB of disk storage.
In addition to command-line resource limit option, resources can be set with environment variables. Set the environment variables MAGICK_AREA_LIMIT , MAGICK_DISK_LIMIT , MAGICK_FILE_LIMIT , MAGICK_MEMORY_LIMIT , MAGICK_MAP_LIMIT , MAGICK_THREAD_LIMIT , MAGICK_TIME_LIMIT for limits of image area, disk space, open files, heap memory, memory map, number of threads of execution, and maximum elapsed time in seconds respectively.
Inquisitive users can try adding - debug cache to their commands and then scouring the generated output for references to the pixel cache, in order to determine how the pixel cache was allocated and how resources were consumed. Advanced Unix/Linux users can pipe that output through grep memory|open|destroy|disk for more readable sifting.
For more about ImageMagick's use of resources, see the section Cache Storage and Resource Requirements on the Architecture page.
-linear-stretch black-point.
Linear with saturation stretch.
This is very similar to - contrast-stretch, and uses a 'histogram bin' to determine the range of color values that needs to be stretched. However it then stretches those colors using the - level operator.
As such while the initial determination may have 'binning' round off effects, the image colors are stretched mathematically, rather than using the histogram bins. This makes the operator more accurate.
note however that a - linear-stretch of ' 0 ' does nothing, while a value of ' 1 ' does a near perfect stretch of the color range.
See also - auto-level for a 'perfect' normalization of mathematical images.
This operator is under review for re-development.
the line width for subsequent draw operations.
-liquid-rescale geometry.
rescale image with seam-carving.
See Image Geometry for complete details about the geometry argument.
Print a list of supported arguments for various options or settings. Choose from these list types:
These lists vary depending on your version of ImageMagick. Use " - list list " to get a complete listing of all the " - list " arguments available:
-log string.
Specify format for debug log.
This option specifies the format for the log printed when the - debug option is active.
You can display the following components by embedding special format characters:
%d domain %e event %f function %l line %m module %p process ID %r real CPU time %t wall clock time %u user CPU time %% percent sign \n newline \r carriage return.
The default behavior is to print all of the components.
-loop iterations.
add Netscape loop extension to your GIF animation.
Set iterations to zero to repeat the animation an infinite number of times, otherwise the animation repeats itself up to iterations times.
-lowlight-color color.
when comparing images, de-emphasize pixel differences with this color.
double the size of the image with pixel art scaling.
Display image using this type .
Choose from these Standard Colormap types:
The X server must support the Standard Colormap you choose, otherwise an error occurs. Use list as the type and display searches the list of colormap types in top-to-bottom order until one is located. See xstdcmap(1) for one way of creating Standard Colormaps.
-map components.
Here are the valid components of a map:
r red pixel component g green pixel component b blue pixel component a alpha pixel component (0 is transparent) o opacity pixel component (0 is opaque) i grayscale intensity pixel component c cyan pixel component m magenta pixel component y yellow pixel component k black pixel component p pad component (always 0)
You can specify as many of these components as needed in any order (e. g. bgr). The components can repeat as well (e. g. rgbr).
-mattecolor color.
Specify the color to be used with the - frame option.
The color is specified using the format described under the - fill option.
The default matte color is #BDBDBD , this shade of gray .
return the maximum intensity of an image sequence.
Select the 'maximum' value from all the surrounding pixels.
This is legacy option from the method of the same name.
-median geometry.
apply a median filter to the image.
Select the 'middle' value from all the surrounding pixels.
This is legacy option from the method of the same name.
-mean-shift width x height.
image noise removal and color reduction/segmentation (e. g. - mean-shift 7x7+10%).
width x height is the window size and distance is the color distance measured in the range 0 to 1 or 0 to 100%
The mean shift algorithm is iterative and thus slower the larger the window size. For each pixel, it gets all the pixels in the window centered at the pixel and excludes those that are outside the radius=sqrt((width-1)(height-1)/4) surrounding the pixel. From those pixels, it finds which of them are within the specified squared color distance from the current mean. It then computes a new x, y centroid from those coordinates and a new mean. This new x, y centroid is used as the center for a new window. This process is iterated until it converges and the final mean is then used to replace the original pixel value. It repeats this process for the next pixel, etc, until it processes all pixels in the image. Results are better when using other colorspaces rather than RGB. Recommend YIQ, YUV or YCbCr, which seem to give equivalent results.
-metric type.
Output to STDERR a measure of the differences between images according to the type given metric.
AE absolute error count, number of different pixels (-fuzz affected) DSSIM structural dissimilarity index FUZZ mean color distance MAE mean absolute error (normalized), average channel error distance MEPP mean error per pixel (normalized mean error, normalized peak error) MSE mean error squared, average of the channel error squared NCC normalized cross correlation PAE peak absolute (normalized peak absolute) PHASH perceptual hash for the sRGB and HCLp colorspaces. Specify an alternative colorspace with - define phash:colorspaces= colorspace, colorspace. PSNR peak signal to noise ratio RMSE root mean squared (normalized root mean squared) SSIM structural similarity index.
Control the ' AE ', or absolute count of pixels that are different, with the - fuzz factor (ignore pixels which only changed by a small amount). Use ' PAE ' to find the size of the - fuzz factor needed to make all pixels 'similar', while ' MAE ' determines the factor needed for about half the pixels to be similar.
The MEPP metric returns three different metrics (' MAE ', ' MAE ' normalized, and ' PAE ' normalized) from a single comparison run.
The SSIM and DSSIM metrics respect these defines: - define compare:ssim-radius , - define compare:ssim-sigma , - define compare:ssim-k1 , and - define compare:ssim-k2 .
To print a complete list of metrics, use the - list metric option.
return the minimum intensity of an image sequence.
Select the 'minimal' value from all the surrounding pixels.
This is legacy option from the method of the same name.
-mode geometry.
make each pixel the \'predominant color\' of the neighborhood.'
-mode value.
Modo de operação.
Choose the value from these styles: Frame, Unframe, or Concatenate.
Use the - list option with a ' Mode ' argument for a list of - mode arguments available in your ImageMagick installation.
-modulate brightness [, saturation , hue ]
Vary the brightness , saturation , and hue of an image.
The arguments are given as a percentages of variation. A value of 100 means no change, and any missing values are taken to mean 100.
The brightness is a multiplier of the overall brightness of the image, so 0 means pure black, 50 is half as bright, 200 is twice as bright. To invert its meaning - negate the image before and after.
The saturation controls the amount of color in an image. For example, 0 produce a grayscale image, while a large value such as 200 produce a very colorful, 'cartoonish' color.
The hue argument causes a "rotation" of the colors within the image by the amount specified. For example, 50 results in a counter-clockwise rotation of 90, mapping red shades to purple, and so on. A value of either 0 or 200 results in a complete 180 degree rotation of the image. Using a value of 300 is a 360 degree rotation resulting in no change to the original image.
For example, to increase the color brightness by 20% and decrease the color saturation by 10% and leave the hue unchanged, use - modulate 120,90.
Use - set attribute of ' option:modulate:colorspace ' to specify which colorspace to modulate. Choose from HCL , HCLp , HSB , HSI , HSL (the default), HSV , HWB , or LCH (LCHuv). Por exemplo,
Manual de Traders da FX Options.
O CME Group FX representa o maior mercado regulamentado de câmbio do mundo e a segunda maior plataforma de câmbio com mais de US $ 100 bilhões em liquidez diária. Um pool de liquidez profundo e diversificado composto por uma ampla gama de clientes de compra e venda - os principais bancos do mundo, fundos de hedge, empresas proprietárias de trading e operadores individuais ativos - usam nossos produtos futuros e opções para gestão de risco e oportunidades de investimento.
As opções do CME Group FX podem oferecer:
Preços transparentes Anonimato total Compensação central e crédito de contraparte virtualmente garantido Acesso eletrônico em todo o mundo, 24 horas por dia, seis dias por semana.
Combinado com o volume recorde, as opções FX do CME Group oferecem um mercado altamente líquido com uma infinidade de expirações, pares de moedas, opções de cotação e mais, entregando contratos que são flexíveis o suficiente para dar a você a habilidade de executar qualquer estratégia de negociação.
Comments
Post a Comment