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.
<output file or folder>
The name of the output file or destination folder. The parameter is mandatory if you use the program on an image folder containing multiple images, and it must point to an existing folder. If the specified path does not point to an existing folder, it is interpreted as a filename. If the path is interpreted as a filename, the export file format is derived from the file extension, unless the --out-ext option is present (see below). Note that the file extension is only used to determine the export format, which then enforces the actual output extension (e.g. image.jpeg sets the format to JPEG, which results in the filename image.jpg). You can also use a number of variables in the output filename. 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 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>
Defines the export format to use (e.g. jpeg, tiff, openexr) based on the provided argument string, which can be a common extension (e.g. jpg, tif, exr) or a format (e.g. jpeg, tiff). The name --out-ext is preserved for compatibility with existing scripts, but it is actually used to determine the format, not the file extension; the extension, as always, is determined by the format. If specified, this format takes precedence over the one derived from <output file>. If the output filename already contains an extension, it is removed only if it exactly matches the string passed to --out-ext. Otherwise, it is treated as part of the filename (e.g. output.jpg with --out-ext jpeg results in output.jpg.jpg, because jpg does not match jpeg). Defaults to jpg if <output folder> is specified.
--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
The preferred way to manage the compression
  • 0: default
  • 1: picture: digital picture, like portrait, inner shot
  • 2: photo: outdoor photograph, with natural lighting
  • 3: graphic: discrete tone image (graph, map-tile, etc.)

🔗copiar

Nenhuma opção fornecida.

🔗xcf

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

🔗JXL

bpp
A profundidade de bits (8, 10,12,16, 32)
pixel_type
Booleano se o tipo de pixel (16 bits) é inteiro sem sinal ou ponto flutuante
  • 0: inteiro sem sinal
  • 1: ponto flutuante
quality
Inteiro (4-100): a qualidade da imagem, correspondendo aproximadamente à qualidade JPEG (100 é sem perdas)
original
Booleano se deseja codificar usando o perfil de cores original ou o XYB interno
  • 0: interno
  • 1: original
effort
Número inteiro entre 1-9. Esforço para codificar a saída; maior é mais lento (o padrão é 7)
tier
Número inteiro entre 0-4. Um valor mais alto favorece a velocidade de decodificação versus qualidade (o padrão é 0)

translations