darktable
O binário darktable inicia o darktable com sua interface gráfica e todas as funcionalidades. Esta é a forma padrão de usar o darktable.
O darktable pode ser invocado com os seguintes parâmetros de linha de comando:
darktable [-d {all,act_on,cache,camctl,camsupport,control,demosaic,
dev,fswatch,imageio,input,ioporder,lighttable,lua,
masks,memory,nan,opencl,params,perf,print,pwstorage,
signal,sql,tiling,undo,verbose}]
[<input file>|<image folder>]
[--version]
[--disable-opencl]
[--configdir <user config directory>]
[--library <library file>]
[--datadir <data directory>]
[--moduledir <module directory>]
[--tmpdir <tmp directory>]
[--cachedir <user cache directory>]
[--localedir <locale directory>]
[--luacmd <lua command>]
[--noiseprofiles <noiseprofiles json file>]
[--d-signal <signal>]
[--d-signal-act <all,raise,connect,disconnect,print-trace>]
[--conf <key>=<value>]
[-t <num openmp threads>]
Todos os parâmetros são opcionais. Na maioria dos caso, o darktable deve ser iniciado sem nenhum parâmetro adicional, o que fará com que sejam usados os valores padrão adequados.
-d {all,act_on,cache,camctl,camsupport,control,demosaic,dev,fswatch,imageio,input,ioporder,lighttable,lua,masks,memory,nan,opencl,params,perf,print,pwstorage,signal,sql,tiling,undo,verbose}- Ativa a saída de depuração no terminal. Existem diversos subsistemas do darktable e cada um deles pode ser depurado separadamente. Você pode usar esta opção várias vezes se quiser depurar mais de um subsistema (por exemplo
darktable -d opencl -d camctl) ou depurar todos de uma vez só (com-d all). Algumas opções de depuração (como-d opencl) também fornecem uma saída mais detalhada, que pode ser invocada com a opção adicional-d verbose. A opção detalhada deve ser fornecida explicitamente, mesmo ao usar-d all. --d-signal <sinal>- Se
-d signalou-d allfor usado, especifique o sinal para depurar usando esta opção. EspecifiqueALLpara depurar todos os sinais ou especifique o sinal com seu nome completo. Pode ser usado múltiplas vezes. --d-signal-act <all,raise,connect,disconnect,print-trace>- Se
-d signalou-d allfor usado, especifique a ação do sinal para depurar usando esta opção. <arquivo de entrada>|<pasta de imagens>- Opcionalmente, forneça o nome de um arquivo de imagem ou pasta. Se um nome de arquivo for fornecido, o darktable inicia na vista da sala escura com o referido arquivo aberto. Se uma pasta for fornecida, o darktable inicia na vista da mesa de luz com o conteúdo da pasta como coleção atual.
--version- Imprime o número de versão do darktable, um aviso de direitos autorais, algumas outras informações úteis e sai.
--disable-opencl- Evita que o darktable inicialize o subsistema OpenCL. Use esta opção se o darktable travar na inicialização devido a uma implementação do OpenCL defeituosa.
--configdir <pasta de configuração>- Define a pasta onde o darktable armazena a configuração específica do usuário. A localização padrão é
$HOME/.config/darktable/. --library <library file>- darktable keeps image information in an sqlite database for fast access. The default location of that database file is file name
library.dbin the directory specified by--configdiror defaulted to$HOME/.config/darktable/. Use this option to provide an alternative location (e.g. if you want to do some experiments without compromising your originallibrary.db). If the database file does not exist, darktable creates it for you. You may also provide:memory:as the library file, in which case the database is kept in system memory – all changes are discarded when darktable terminates. -
Sempre que o darktable é iniciado, ele bloqueará a biblioteca para o usuário atual. Isto é feito salvando o identificador do processo (PID, sigla em inglês) atual em um arquivo de bloqueio
<arquivo de biblioteca>.lockjunto à biblioteca especificada. Se o darktable encontrar um arquivo de bloqueio existente para a biblioteca, terminará imediatamente. --datadir <pasta de dados>- Define a pasta onde o darktable encontra seus dados de tempo de execução. A localização padrão depende de sua instalação. As localizações típicas são
/opt/darktable/share/darktable/e/usr/share/darktable/. --moduledir <pasta de módulo>- O darktable possui uma estrutura modular e organiza seus módulos como bibliotecas compartilhadas para carregamento em tempo de execução. Esta opção informa ao darktable onde procurar por bibliotecas compartilhadas. Localizações típicas são
/opt/darktable/lib64/darktable/e/usr/lib64/darktable/. --tmpdir <pasta temporária>- Define onde o darktable deve armazenar seus arquivos temporários. Se nenhuma opção for fornecida, o darktable usa o padrão do sistema.
--cachedir <pasta de cache>- O darktable mantém uma cache de miniaturas das imagens para uma visualização prévia mais rápida da imagem e binários pré-compilados do OpenCL para inicialização rápida. Por padrão, a cache está localizada em
$HOME/.cache/darktable/. Podem existir várias caches de miniaturas em paralelo – uma para cada arquivo de biblioteca. --localedir <pasta locale>- Define onde o darktable pode encontrar os textos específicos de cada idioma. A localização padrão depende de sua instalação. Localizações típicas são
/opt/darktable/share/locale/e/usr/share/locale/. --luacmd <comando lua>- Um texto contendo comandos do lua a serem executado após a inicialização do lua. Estes comandos serão executados após seu arquivo “luarc”.
- Se o lua não estiver compilado, esta opção será aceita mas não fará nada.
--noiseprofiles <arquivos de perfil de ruído json>- Fornece um arquivo json que contém perfis de ruído específicos de determinadas câmeras. A localização padrão depende de sua instalação. Localizações típicas são
/opt/darktable/share/darktable/noiseprofile.jsone/usr/share/darktable/noiseprofile.json. --conf <key>=<value>- darktable supports a rich set of configuration parameters defined by the user in file
darktablerc, located in the directory specified by--configdiror defaulted to$HOME/.config/darktable/. You may temporarily overwrite individual settings on the command line with this option – these settings will not be stored indarktablercon exit. -t <num subprocessos openmp>- Limita o número de subprocessos openmp para usar em sessões paralelas de openmp.