darktable-cli

O binário darktable-cli inicia a variante de interface de linha de comando do darktable que permite exportar imagens.

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.

O darktable-cli pode ser chamado com os seguintes parâmetros de linha de comando:

darktable-cli [<arquivo ou pasta de entrada>]
	[<arquivo xmp>]
	<arquivo ou pasta de saída>
	[--width <largura máx>]
	[--height <altura máx>]
	[--hq <0|1|true|false>]
	[--upscale <0|1|true|false>]
	[--style <nome do estilo>]
	[--style-overwrite]
	[--apply-custom-presets <0|1|false|true>]
	[--out-ext <extensão>]
	[--import <arquivo ou pasta>]
	[--icc-type <tipo>]
	[--icc-file <arquivo>]
	[--icc-intent <intenção>]
	[--verbose]
	[--help [opção]]
	[--core <opções do darktable>]

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 darktable irá procurar por um arquivo XMP que pertença ao(s) arquivo(s) de entrada.
<arquivo ou pasta de saída>
O nome do arquivo de saída ou pasta de destino. O formato do arquivo exportado deriva da extensão do arquivo ou da opção --out-ext. Você também pode usar diversas variáveis no nome do arquivo de saída. Por razões óbvias, este parâmetro é obrigatório se você usar o programa em uma pasta contendo múltiplas imagens. Se você especificar uma pasta de destino, é recomendável que você também especifique o formato do arquivo com a opção --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 se deseja utilizar uma reamostragem de alta qualidade durante a exportação (consulte a referência do módulo exportar para obter mais detalhes). Verdadeiro (true) por padrão.
--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 darktable deve também ser especificado (por exemplo, --core --configdir ~/.config/darktable). 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 darktable-cli ao custo de ser incapaz de usar a opção --style. Verdadeiro (true) por padrão.
--out-ext <extension>
Set the export file format to use derived from the extension (jpg, tif, jxl). If specified takes precedence over <output file>. By default this is extracted from <output file>. Defaults to jpg if <output folder> is specified. Note: the extension used in the export filename is predetermined by the export format and not adjustable.
--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 <tipo>
Especifica o tipo de perfil ICC, que é o mesmo que especificar o “perfil de saída” no módulo perfil de cor de saída. O padrão é “especificado pela imagem”. Use --help icc-type para obter uma lista dos tipos suportados. Veja a referência do módulo perfil de cor de saída para uma descrição mais detalhada das opções disponíveis.
--icc-file <arquivo>
Especifica o nome do arquivo de perfil ICC. O padrão é um nome de arquivo vazio.
--icc-intent <intenção>
Especifica a intenção de renderização. O padrão é “especificado pela imagem”. Use --help icc-intent para obter uma lista das intenções suportadas. Veja intenção de renderização para uma descrição mais detalhada das opções disponíveis.
--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 darktable>
Todos os parâmetros de linha de comando após --core são passados para o núcleo do darktable e tratados como parâmetros padrão. Consulte a seção binário do darktable para uma descrição mais detalhada.

🔗opções de exportação

As opções de exportação para darktable são definidas como itens de configuração, definidos no módulo de exportação. Existem duas maneiras de alterar esta configuração ao usar o darktable-cli, conforme descrito abaixo.

🔗usar o módulo de exportação

O comando darktable-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 darktable e, em seguida, executar o darktable-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:

    --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 darktable-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)

🔗JXL

bpp
The bit depth (8, 10, 12, 16, 32)
pixel_type
Boolean whether the (16 bit) pixel type is unsigned integer or floating point
  • 0: unsigned integer
  • 1: floating point
quality
Integer (4-100): the quality of the image, roughly corresponding to JPEG quality (100 is lossless)
original
Boolean whether to encode using the original color profile or the internal XYB one
  • 0: internal
  • 1: original
effort
Integer between 1-9. Effort with which to encode output; higher is slower (default is 7)
tier
Integer between 0-4. Higher value favors decoding speed vs quality (default is 0)

translations