darktable
The darktable binary starts darktable with its GUI and full functionality. This is the standard way to use darktable. The command to run the binary depends on your OS.
The following command line parameters are available:
darktable [-d {all,act_on,ai,cache,camctl,camsupport,common,control,
dev,expose,fswatch,imageio,input,ioporder,lighttable,lua,
masks,memory,nan,opencl,params,perf,pipe,print,pwstorage,
signal,sql,tiling,undo,verbose}]
[--d-signal <signal>]
[--d-signal-act <all,raise,connect,disconnect,print-trace>]
[--disable-pipecache]
[<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>]
[--conf <key>=<value>]
[-t <num openmp threads>]
Alle parameters zijn optioneel. In de meeste gevallen moet darktable worden gestart zonder aanvullende parameters, in welk geval darktable geschikte standaardinstellingen gebruikt.
-d {all,act_on,ai,cache,camctl,camsupport,common,control,dev,expose,fswatch,imageio,input,ioporder,lighttable,lua,masks,memory,nan,opencl,params,perf,pipe,print,pwstorage,signal,sql,tiling,undo,verbose}- Enable debug output to the terminal. There are several subsystems of darktable and each of them can be debugged separately. You can use this option multiple times if you want to debug more than one subsystem (e.g.
darktable -d opencl -d camctl) or debug all of them at once (with-d all). The-d commonswitch is provided to give information about most relevant subsystems while debugging darktable or if you want to provide a log for reporting a darktable issue. Some debug options (like-d opencl) can also provide more verbose output, which can be invoked with the additional option-d verbose. The verbose option must be explicitly provided, even when using-d all. --d-signal <signal>- If
-d signalor-d allis specified, specify the signal to debug using this option. SpecifyALLto debug all signals or specify signal using its full name. Can be used multiple times. --d-signal-act <all,raise,connect,disconnect,print-trace>- Als
-d signalof-d allis opgegeven, specificeer je met deze optie de signaalactie die moet worden opgespoord. --pipecache uitschakelen- Schakel de pixelpipe-cache uit. Deze optie staat slechts twee cachelijnen per pipe toe en mag alleen worden gebruikt voor foutopsporingsdoeleinden.
<input file>|<image folder>- Geef optioneel de naam van een afbeeldingsbestand of map op. Als een bestandsnaam wordt gegeven, begint darktable in de ontwikkelenweergave met dat bestand geopend. Als een map wordt gegeven, begint darktable in de bibliotheek-weergave met de inhoud van die map als de huidige collectie.
--version- druk het darktable-versienummer, een copyrightmelding en andere nuttige informatie af en beëindig dan.
--disable-opencl- Voorkom dat darktable het OpenCL-subsysteem initialiseert. Gebruik deze optie als darktable crasht bij het opstarten vanwege een defecte OpenCL-implementatie.
--configdir <config directory>- definieer de map waarin darktable de gebruikersspecifieke configuratie opslaat. De standaardlocatie is
$HOME/.config/darktable/. --library <library file>- darktable bewaart beeldinformatie in een sqlite-database voor snelle toegang. De standaardlocatie van dat databasebestand is bestandsnaam
library.dbin de map gespecificeerd door--configdirof standaard ingesteld op$HOME/.config/darktable/. Gebruik deze optie om een alternatieve locatie op te geven (bijvoorbeeld als je wat experimenten wilt doen zonder jouw oorspronkelijkelibrary.dbin gevaar te brengen). Als het databasebestand niet bestaat, maakt darktable het voor jou aan. Je kan ook:memory:als bibliotheekbestand opgeven, in welk geval de database in het systeemgeheugen wordt bewaard – alle wijzigingen worden genegeerd wanneer darktable wordt beëindigd. -
Telkens wanneer darktable start, wordt de bibliotheek vergrendeld voor de huidige gebruiker. Het doet dit door de huidige proces-ID (PID) te schrijven naar een vergrendelingsbestand `.lock’ naast de opgegeven bibliotheek. Als darktable een bestaand vergrendelingsbestand voor de bibliotheek vindt, wordt het onmiddellijk beëindigd.
--datadir <data directory>- definieer de map waar darktable zijn runtime-gegevens vindt. De standaardlocatie is afhankelijk van jouw installatie. Typische locaties zijn
/opt/darktable/share/darktable/en/usr/share/darktable/. --moduledir <module directory>- darktable heeft een modulaire structuur en organiseert de modules als gedeelde bibliotheken die tijdens runtime kunnen worden geladen. Deze optie vertelt darktable waar de gedeelde bibliotheken moeten worden gezocht. De standaardlocatie is afhankelijk van jouw installatie. Typische locaties zijn
/opt/darktable/lib64/darktable/en/usr/lib64/darktable/. --tmpdir <tmp directory>- Bepaal waar darktable zijn tijdelijke bestanden moet opslaan. Als deze optie niet wordt meegeleverd, gebruikt darktable de systeemstandaard.
--cachedir <cachemap>- darktable houdt een cache van afbeeldingsminiaturen bij voor een snel voorbeeld van afbeeldingen en voorgecompileerde OpenCL-binaire bestanden voor snel opstarten. Standaard bevindt de cache zich in
$HOME/.cache/darktable/. Meerdere miniatuurcaches kunnen parallel bestaan – één voor elk bibliotheekbestand. --localedir <locale directory>- definieer waar darktable zijn taalspecifieke tekstreeksen kan vinden. De standaardlocatie is afhankelijk van jouw installatie. Typische locaties zijn
/opt/darktable/share/locale/en/usr/share/locale/. --luacmd <lua command>- Een tekenreeks met lua-opdrachten die moeten worden uitgevoerd na de initialisatie van lua. Deze opdrachten worden uitgevoerd na jouw “luarc” -bestand.
- Als lua niet is gecompileerd, wordt deze optie geaccepteerd maar doet niets.
--noiseprofiles <noiseprofiles json-bestand>- geef een json-bestand op dat cameraspecifieke ruisprofielen bevat. De standaardlocatie is afhankelijk van jouw installatie. Typische locaties zijn
/opt/darktable/share/darktable/noiseprofile.jsonen/usr/share/darktable/noiseprofile.json. --conf <key>=<value>- darktable ondersteunt een uitgebreide set configuratieparameters gedefinieerd door de gebruiker in bestand
darktablerc, gesitueerd in de directory gespecificeerd door--configdirof standaard ingesteld op$HOME/.config/darktable/. Je kan met deze optie tijdelijk individuele instellingen op de opdrachtregel overschrijven – deze instellingen worden bij het afsluiten niet opgeslagen indarktablerc. -t <num openmp threads>- beperk het aantal openmp-threads om te gebruiken in openmp parallelle secties.
--dump-pfm MODULE_A,MODULE_B,--dump-pipe MODULE_A,MODULE_B,--dumpdir DIR- deze opties zijn beschikbaar voor het opsporen van fouten in de interne verwerkingspijplijn van darktable. Als u bijvoorbeeld wordt aangeroepen met
--dump-pfm demosaic, zal darktable de invoer en uitvoer van de demosaic-module dumpen als pfm-bestanden. Standaard wordt de locatie van deze bestanden gedefinieerd door het besturingssysteem - een tijdelijke map gerapporteerd in de loguitvoer - maar u kunt deze ook expliciet definiëren via de--dumpdiroptie.