The ansel-cli binary starts the command line interface variant of Ansel which allows images to be exported.

Esta variante não exibe nenhuma janela – ela funciona em modo de console puro sem iniciar uma interface gráfica. Este modo é particularmente útil para servidores rodando trabalhos em segundo plano.

ansel-cli can be called with the following command line parameters:

 1ansel-cli [<input file or folder>]
 2              [<xmp file>]
 3              <output file or folder>
 4              [--width <max width>]
 5              [--height <max height>]
 6              [--hq <0|1|true|false>]
 7              [--upscale <0|1|true|false>]
 8              [--style <style name>]
 9              [--style-overwrite]
10              [--apply-custom-presets <0|1|false|true>]
11              [--out-ext <extension>]
12              [--import <file or dir>]
13              [--icc-type <type>]
14              [--icc-file <file>]
15              [--icc-intent <intent>]
16              [--verbose]
17              [--help [option]]
18              [--core <Ansel options>]

O usuário deve fornecer um nome de arquivo de entrada e um nome de arquivo de saída. Todos os outros parâmetros são opcionais.

<arquivo ou pasta de entrada>
O nome do arquivo ou pasta (que contém as imagens) de entrada a ser exportado. Se você deseja processar múltiplas imagens ou múltiplas pastas, use a opção --import em seu lugar.
<arquivo xmp>
O nome opcional do arquivo XMP auxiliar que contém os dados da pilha de histórico que serão aplicados durante a exportação. Se esta opção não for fornecida, o Ansel irá procurar por um arquivo XMP que pertença ao(s) arquivo(s) de entrada.
<output file or folder>
The name of the output file or destination folder. The export file format is derived from the file extension or from the --out-ext option. You can also use a number of variables in the output filename. For obvious reasons this parameter is mandatory if you use the program on an image folder containing multiple images. If you specify output folder it is recommended that you also specify the file format with --out-ext.
--width <largura máxima>
Limita a largura da imagem exportada ao número de pixels especificado.
--height <altura máxima>
Limita a altura da imagem exportada ao número de pixels especificado.
--hq <0|1|true|false>
Define whether to use high quality resampling during export (see the export module reference for more details). Defaults to true.
--upscale <0|1|true|false>
Define se permite a ampliação da imagem durante a exportação. Falso (false) por padrão.
--style <nome do estilo>
Especifica o nome de um estilo a ser aplicado durante a exportação. Se um estilo for especificado, o caminho de configuração do Ansel deve também ser especificado (por exemplo, --core --configdir ~/.config/Ansel). Por padrão, nenhum estilo é aplicado.
--style-overwrite
O estilo especificado sobrescreve a pilha de histórico ao invés de ser apenas adicionado.
--apply-custom-presets <0|1|false|true>
Define se deseja carregar o data.db que contém as predefinições e estilos. Desativar esta opção permite que você execute múltiplas instâncias do Ansel-cli ao custo de ser incapaz de usar a opção --style. Verdadeiro (true) por padrão.
--out-ext <extensão>
Configura a extensão de saída que será utilizada. Se especificada, toma a precedência sobre o <arquivo de saída>. Por padrão, é obtida do <arquivo de saída>. O padrão é jpg se for especificada a <pasta de saída>.
--import <arquivo ou pasta>
Especifica o arquivo de entrada ou pasta, e pode ser usada múltiplas vezes. Esta opção não pode ser combinada com <arquivo de entrada ou pasta>.
--icc-type <type>
Specify the ICC profile type, which is the same as specifying the “output profile” in the output color profile module. Defaults to “image specified”. Use --help icc-type to obtain a list of the supported types. See the output color profile module reference for a more detailed description of the available options.
--icc-file <file>
Specify the ICC profile filename. Defaults to an empty filename.
--icc-intent <intent>
Specify the rendering intent. Defaults to “image specified”. Use --help icc-intent to obtain a list of the supported intents. See rendering intent for a more detailed description of the available options.
--verbose
Ativa a saída com informações completas do processo.
--help [opção]
Mostra instruções de uso e sai. Se opção é especificada, adicionalmente mostra o uso da opção dada.
--core <opções do Ansel>
Todos os parâmetros de linha de comando após --core são passados para o núcleo do Ansel e tratados como parâmetros padrão. Consulte a seção binário do Ansel para uma descrição mais detalhada.

opções de exportação

Export options for Ansel are defined as configuration items, set from within the export module. There are two ways to alter this configuration when using Ansel-cli, as described below.

usar o módulo de exportação

O comando Ansel-cli usará a última configuração de formato usada no módulo de exportação, quando executado no modo interativo (interface gráfica). Você pode, portanto, definir manualmente as opções de formato desejadas na interface do Ansel e, em seguida, executar o Ansel-cli para exportar seus arquivos.

passar opções na linha de comando

Você pode definir qualquer opção de configuração de formato de exportação usando a seguinte sintaxe:

1    --core --conf plugins/imageio/format/<FORMATO>/<OPÇÃO>=<VALOR>

onde <FORMATO> é o nome do formato de saída desejado e <OPÇÃO> é qualquer opção de configuração para aquele formato.

Uma opção definida desta forma não será armazenada permanentemente, mas será usada apenas para esta execução do Ansel-cli.

As seções a seguir descrevem as opções/valores de configuração que estão disponíveis para cada formato de exportação:

jpeg

quality
A qualidade de compressão (5 - 100)

j2k (jpg2000)

format
O formato da saída
  • 0: J2K
  • 1: jp2
quality
A qualidade de compressão (5 - 100)
preset
O modo DCP
  • 0: Cinema2K, 24 FPS
  • 1: Cinema2K, 48 FPS
  • 2: Cinema4K, 24 FPS

exr (OpenEXR)

bpp
A profundidade de bits (16 ou 32)
compression
O tipo de compressão
  • 0: descompactado
  • 1: RLE
  • 2: ZIP
  • 3: ZIP
  • 4: PIZ
  • 5: PXR24
  • 6: B44
  • 7: DWAA
  • 8: DWAB

pdf

title
O título do pdf (qualquer caractere)
size
O tamanho do pdf (a4, a3, letter, legal)
orientation
a orientação do papel do pdf
  • 0: retrato
  • 1: paisagem
border
O espaço vazio ao redor do pdf; formato: tamanho (um número) + unidade; exemplos: 10 mm, 1 inch
dpi
A resolução em pontos por polegada dentro do pdf (1 - 5000)
rotate
Se deve rotacionar o pdf (0 ou 1)
icc
Se deve incorporar um perfil icc (0 ou 1)
bpp
A profundidade de bits (8 ou 16)
compression
Se o pdf deve ser comprimido (0 ou 1)
mode
O modo de colocar as imagens no pdf
  • 0: normal: simplesmente coloca as imagens no pdf
  • 1: rascunho: as imagens são substituídas por caixas
  • 2: depuração: mostra apenas os contornos e a caixa delimitadora

pfm

Nenhuma opção fornecida.

png

bpp
A profundidade de bits (8 ou 16)
compression
O nível de compressão (0 - 9)

ppm

Nenhuma opção fornecida.

tiff

bpp
A profundidade de bits (8, 16, 32)
compress
O tipo de compressão
  • 0: descompactado
  • 1: esvaziar
  • 2: esvaziar com preditor
compresslevel
O nível de compactação (0 - 9)
shortfile
P&B ou imagem colorida
  • 0: salvar cores rgb
  • 1: salvar escala de cinza

webp

comp_type
O tipo de compressão
  • 0: com perdas
  • 1: sem perdas
quality
a qualidade de compressão (5 - 100)
hint
A maneira preferida de gerenciar a compactação
  • 0: padrão
  • 1: imagem: imagem digital, como retrato, foto interna
  • 2: foto: fotografia ao ar livre, com iluminação natural
  • 3: gráfico: imagem de tom discreto (gráfico, mapa em ladrilhos etc)

copiar

Nenhuma opção fornecida.

xcf

bpp
A profundidade de bits (8, 16, 32)