composite
Exemplos de uso • Resumo das opções
Use o programa composite para sobrepor uma imagem a outra. Consulte Command Line Processing para orientações sobre como estruturar seu comando composite ou veja abaixo exemplos de uso do comando.
Exemplos de uso
Listamos aqui alguns exemplos do comando composite para ilustrar sua utilidade e facilidade de uso. Para começar, vamos sobrepor uma carinha sorridente a uma rosa:
magick composite -gravity center smile.gif rose: rose-over.png
Você pode criar um efeito tridimensional com Atop:
magick -size 70x70 canvas:none -fill red -draw 'circle 35,35 10,30' red-circle.png
magick -size 70x70 canvas:none -draw "circle 35,35 35,20" -channel RGB -negate -channel A -gaussian-blur 0x8 white-highlight.png
magick composite -compose atop -geometry -13-17 white-highlight.png red-circle.png red-ball.png
Ou suponha que você queira mesclar um urso a um riacho de forma perfeita. Experimente este comando:
magick -verbose stream.jpg bear.jpg bear_mask.png -define compose:args=400x0.0002+100 \
-compose seamless-blend -geometry +30+30 -composite bear-in-stream.png
A máscara marca a área ao redor do urso a ser mesclada. A mesclagem perfeita (seamless blending) é um processo iterativo. Aqui, limitamos as iterações a 400 ou menos, caso a mesclagem convirja (o resíduo tem um RMSE inferior a 0.0002). O valor do resíduo (RMSE) é exibido a cada 100 iterações. Observe que a mesclagem perfeita funciona de forma mais eficaz quando o recurso HDRI está habilitado.
magick -verbose stream.jpg \( bear.jpg -read-mask only_bear.png \) bear_mask.png \
-define compose:args=400x0.0002+100 -compose seamless-blend -geometry +30+30 -composite \
bear-in-stream.png
Aqui criamos uma máscara de leitura (read mask) que marca o objeto em primeiro plano separando-o do fundo. Nenhuma mesclagem é aplicada ao objeto em primeiro plano, apenas ao seu entorno. A read-mask preserva as cores do urso e impede que elas clareiem, como no primeiro exemplo. Observe que as read-masks devem ser pretas sobre fundo branco, ao contrário das máscaras normais, que são brancas sobre fundo preto.
Você pode encontrar exemplos adicionais de uso do composite em Examples of ImageMagick Usage. Você pode saber mais sobre eles e sobre a matemática envolvida consultando SVG Alpha Compositing
Resumo das opções
O comando composite reconhece estas opções. Clique em uma opção para obter mais detalhes sobre como ela funciona.
| Opção | Descrição |
|---|---|
| -affine matrix | matriz de transformação afim |
| -alpha | on, activate, off, deactivate, set, opaque, copy, transparent, extract, background ou shape do canal alfa |
| -authenticate value | descriptografar a imagem com esta senha |
| -blend geometry | mesclar imagens |
| -blue-primary point | ponto primário azul de cromaticidade |
| -border geometry | cercar a imagem com uma borda colorida |
| -bordercolor color | cor da borda |
| -channel type | aplicar a opção aos canais de imagem selecionados |
| -colors value | número preferido de cores na imagem |
| -colorspace type | definir o espaço de cor da imagem |
| -comment string | anotar a imagem com um comentário |
| -compose operator | definir o operador de composição da imagem |
| -compress type | tipo de compressão da imagem |
| -debug events | exibir informações abundantes de depuração |
| -decipher filename | converter pixels cifrados em texto simples |
| -define format:option | definir uma ou mais opções de formato de imagem |
| -density geometry | densidade horizontal e vertical da imagem |
| -depth value | profundidade de bits da imagem |
| -displace geometry | deslocar os pixels da imagem conforme definido por um mapa de deslocamento |
| -dissolve value | dissolver as duas imagens em uma dada porcentagem |
| -dither method | aplicar difusão de erro à imagem |
| -encipher filename | converter pixels de texto simples em pixels cifrados |
| -encoding type | tipo de codificação de texto |
| -endian type | endianness (MSB ou LSB) da imagem |
| -extract geometry | extrair uma área da imagem |
| -filter type | usar este filtro ao redimensionar uma imagem |
| -font name | renderizar texto com esta fonte |
| -geometry geometry | tamanho ou posição preferidos da imagem |
| -gravity type | posicionamento horizontal e vertical do texto |
| -green-primary point | ponto primário verde de cromaticidade |
| -help | exibir as opções do programa |
| -identify | identificar o formato e as características da imagem |
| -interlace type | tipo de esquema de entrelaçamento da imagem |
| -interpolate method | método de interpolação de cor de pixel |
| -label string | atribuir um rótulo a uma imagem |
| -level value | ajustar o nível de contraste da imagem |
| -limit type value | limite de recursos do cache de pixels |
| -log format | formato das informações de depuração |
| -monitor | monitorar o progresso |
| -monochrome | transformar a imagem em preto e branco |
| -negate | substituir cada pixel por sua cor complementar |
| -page geometry | tamanho e posição de uma tela de imagem (configuração) |
| -pointsize value | tamanho em pontos da fonte |
| -profile filename | adicionar, excluir ou aplicar um perfil de imagem |
| -quality value | nível de compressão JPEG/MIFF/PNG |
| -quantize colorspace | reduzir as cores da imagem neste espaço de cor |
| -quiet | suprimir todas as mensagens de aviso |
| -red-primary point | ponto primário vermelho de cromaticidade |
| -regard-warnings | prestar atenção às mensagens de aviso. |
| -respect-parentheses | as configurações permanecem em vigor até o limite dos parênteses. |
| -rotate degrees | aplicar a rotação Paeth à imagem |
| -sampling-factor geometry | fator de amostragem horizontal e vertical |
| -scene value | número da cena da imagem |
| -seed value | semear uma nova sequência de números pseudoaleatórios |
| -set attribute value | definir um atributo de imagem |
| -sharpen geometry | tornar a imagem mais nítida |
| -shave geometry | remover pixels das bordas da imagem |
| -size geometry | largura e altura da imagem |
| -stegano offset | ocultar uma marca-d'água dentro de uma imagem |
| -stereo geometry | combinar duas imagens para criar um anáglifo estéreo |
| -strip | remover da imagem todos os perfis e comentários |
| -swap indexes | trocar duas imagens na sequência de imagens |
| -synchronize | sincronizar a imagem com o dispositivo de armazenamento |
| -taint | marcar a imagem como modificada |
| -thumbnail geometry | criar uma miniatura da imagem |
| -tile | repetir a operação de composição na horizontal e na vertical da imagem |
| -transform | aplicar transformação afim à imagem |
| -transparent-color color | cor transparente |
| -treedepth value | profundidade da árvore de cores |
| -type type | tipo de imagem |
| -units type | unidades de resolução da imagem |
| -unsharp geometry | tornar a imagem mais nítida |
| -verbose | exibir informações detalhadas sobre a imagem |
| -version | exibir informações de versão |
| -virtual-pixel method | método de acesso a pixels fora dos limites da imagem |
| -watermark geometry | porcentagem de brilho e saturação de uma marca-d'água |
| -white-point point | ponto branco de cromaticidade |
| -white-threshold value | forçar todos os pixels acima do limiar para branco |
| -write filename | gravar as imagens neste arquivo |