darktable
Het binaire bestand `darktable’ start darktable met zijn GUI en volledige functionaliteit. Dit is de standaard manier om darktable te gebruiken.
darktable
kan worden aangeroepen met de volgende opdrachtregelparameters:
darktable [-d {all,act_on,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 <signaal>]
[--d-signal-act <all,raise,connect,disconnect,print-trace>]
[--disable-pipecache]
[<afbeeldingsbestand>|<afbeeldingenmap>]
[--version]
[--disable-opencl]
[--configdir <map met gebruikersinstellingen>]
[--library <bibliotheekbestand>]
[--datadir <data map>]
[--moduledir <module map>]
[--tmpdir <tijdelijke map>]
[--cachedir <cache map>]
[--localedir <map met vertalingen>]
[--luacmd <lua commando>]
[--noiseprofiles <ruisprofielen (json bestand)>]
[--conf <sleutel>=<waarde>]
[-t <aantal 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,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}
- Schakel debug-uitvoer naar de terminal in. Er zijn verschillende subsystemen van darktable en elk daarvan kan afzonderlijk worden opgespoord. U kunt deze optie meerdere keren gebruiken als u meer dan één subsysteem wilt debuggen (bijvoorbeeld
darktable -d opencl -d camctl
) of ze allemaal tegelijk wilt debuggen (met-d all
). De schakelaar-d common
is bedoeld om informatie te geven over de meest relevante subsystemen tijdens het debuggen van darktable of als u een log wilt leveren voor het melden van een darktable-probleem. Sommige debug-opties (zoals-d opencl
) kunnen ook meer uitgebreide uitvoer opleveren, die kan worden aangeroepen met de extra optie-d verbose
. De uitgebreide optie moet expliciet worden opgegeven, zelfs als u-d all
gebruikt. --d-signal <signal>
- Als
-d signal
of-d all
is opgegeven, specificeer dan het signaal dat moet worden opgespoord met deze optie. SpecificeerALL
om alle signalen te debuggen of specificeer het signaal met de volledige naam. Kan meerdere keren worden gebruikt. --d-signal-act <all,raise,connect,disconnect,print-trace>
- Als
-d signal
of-d all
is 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.db
in de map gespecificeerd door--configdir
of 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.db
in 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.json
en/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--configdir
of 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--dumpdir
optie.