darktable-cli

Plik binarny darktable-cli uruchamia wariant interfejsu wiersza poleceń darktable, umożliwiającego eksport obrazów.

Ten wariant nie otwiera żadnego ekranu - działa w trybie czystej konsoli bez uruchamiania GUI. Ten tryb jest szczególnie przydatny w przypadku serwerów, wykonujących zadania w tle.

darktable-cli może być wywołane z następującymi parametrami linii poleceń:

darktable-cli [plik lub folder wejściowy>]
              [<plik xmp>]
              <plik lub folder wyjściowy>
              [--width <maksymalna szerokość>]
              [--height <maksymalna wysokość>]
              [--hq <0|1|true|false>]
              [--upscale <0|1|true|false>]
              [--style <nazwa stylu>]
              [--style-overwrite]
              [--apply-custom-presets <0|1|false|true>]
              [--out-ext <rozszerzenie>]
              [--import <plik lub folder>]
              [--icc-type <typ>]
              [--icc-file <plik>]
              [--icc-intent <cel>]
              [--verbose]
              [--help [opcja]]
              [--core <opcje darktable>]

Użytkownik musi określić plik wejściowy i wyjściowy. Pozostałe parametry są opcjonalne.

<plik lub folder wejściowy>
Nazwa pliku wejściowego lub folderu (zawierającego obrazy) do wyeksportowania. Jeśli chcesz przetwarzać wiele obrazów lub wiele folderów, użyj opcji --import.
<plik xmp>
Opcjonalna nazwa pliku pobocznego XMP zawierającego dane stosu historii do zastosowania podczas eksportu. Jeśli ta opcja nie jest podana, darktable będzie szukać pliku XMP, który należy do podanych plików wejściowych.
<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 <maksymalna szerokość>
Ogranicza szerokość eksportowanego obrazu do podanej liczby pikseli.
--height <maksymalna wysokość>
Ogranicza wysokość eksportowanego obrazu do podanej liczby pikseli.
--hq <0|1|true|false>
Zdefiniuj, czy podczas eksportu ma być używane ponowne próbkowanie wysokiej jakości (więcej szczegółów znajduje się w sekcji eksportu). Wartość domyślna to prawda.
--upscale <0|1|true|false>
Określa, czy zezwalać na upscaling podczas eksportu. Wartość domyślna to fałsz.
--style <nazwa stylu>
Określa nazwę stylu do zastosowania podczas eksportu. Jeśli określono styl, należy również podać ścieżkę do katalogu konfiguracyjnego darktable (np. --core --configdir ~/.config/darktable). Domyślnie nie jest stosowany żaden styl.
--style-overwrite
Określony styl nadpisuje stos historii, zamiast być do niego dołączany.
--apply-custom-presets <0|1|false|true>
Czy załadować plik data.db, który zawiera presety i style. Wyłączenie tej opcji umożliwia uruchamianie wielu instancji darktable-cli kosztem niemożności użycia opcji --style. Wartość domyślna to prawda.
--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 <plik lub katalog>
Określ plik wejściowy lub folder, może być używany wielokrotnie. Tej opcji nie można łączyć z <plikiem lub folderem wejściowym>.
--icc-type <typ>
Określa typ profilu ICC, który jest taki sam, jak określenie „profilu wyjściowego” w module wejściowego profilu koloru. Domyślnie używany obraz. Użyj --help icc-type, aby uzyskać listę obsługiwanych typów. Zapoznaj się z dokumentacją modułu wejściowego profilu koloru, aby uzyskać bardziej szczegółowy opis dostępnych opcji.
--icc-file <plik>
Określa nazwę pliku profilu ICC. Domyślnie pusta nazwa pliku.
--icc-intent <cel>
Określa sposób renderowania. Wartość domyślna to określone zdjęcie. Użyj --help icc-intent, aby uzyskać listę obsługiwanych sposobów. Zobacz sposób odzworowania barw, aby uzyskać bardziej szczegółowy opis dostępnych opcji.
--verbose
Włącza szczegółowe wyjście.
--help [opcja]
Drukuje podstawową informację o użyciu i kończy działanie. Jeśli podano option, dodatkowo wypisuje użycie dla danej opcji.
--core <opcje darktable>
Wszystkie parametry wiersza poleceń następujące po --core są przekazywane do jądra darktable i obsługiwane jako parametry standardowe. Zobacz opis komendy darktable dla uzyskania szczegółowego opisu.

🔗opcje eksportu

Opcje eksportu dla darktable są zdefiniowane jako elementy konfiguracji ustawiane w module eksportu. Istnieją dwa sposoby zmiany tej konfiguracji podczas używania darktable-cli, jak opisano poniżej.

🔗użycie modułu eksportu

Polecenie darktable-cli użyje ostatniej konfiguracji formatu użytej w module eksportu, gdy zostanie uruchomione w trybie interaktywnym (gui). Możesz zatem ręcznie ustawić żądane opcje formatu w graficznej wersji darktable, a następnie uruchomić darktable-cli, aby wyeksportować pliki.

🔗przekazywanie opcji do linii poleceń

Możesz ustawić dowolną opcję konfiguracji formatu eksportu, korzystając z następującej składni:

    --core --conf plugins/imageio/format/<FORMAT>/<OPCJA>=<WARTOŚĆ>

gdzie <FORMAT> jest nazwą żądanego formatu wyjściowego, a <OPCJA>jest dowolną opcją konfiguracyjną tego formatu.

Opcja ustawiona w ten sposób nie zostanie zapisana na stałe, ale zostanie użyta tylko w bieżącej instancji darktable-cli.

W poniższych sekcjach opisano opcje i wartości parametrów konfiguracyjnych, dostępnych dla każdego formatu eksportu.

🔗jpeg

quality
Jakość kompresji (5 - 100)

🔗j2k (jpg2000)

format
Format wyjściowy
  • 0: J2K
  • 1: jp2
quality
Jakość kompresji (5 - 100)
preset
Tryb DCP
  • 0: Cinema2K, 24 FPS
  • 1: Cinema2K, 48 FPS
  • 2: Cinema4K, 24 FPS

🔗exr (OpenEXR)

bpp
Głębia bitowa (16 lub 32)
compression
Typ kompresji
  • 0: nieskompresowany
  • 1: RLE
  • 2: ZIPS
  • 3: ZIP
  • 4: PIZ
  • 5: PXR24
  • 6: B44
  • 7: DWAA
  • 8: DWAB

🔗pdf

title
Tytuł pdf (dowolne znaki)
size
Rozmiar strony pdf (a4, a3, letter, legal)
orientation
orientacja papieru w pdf
  • 0: pionowa
  • 1: pozioma
border
Wielkość pustego miejsca dokoła pdf w formacie: rozmiar (liczba) + jednostka, np. 10 mm, 1 cal
dpi
Rozdzielczość w punktach na cal wewnątrz pdf (1 - 5000)
rotate
Czy obracać pdf (0 lub 1)
icc
Czy osadzać profil icc (0 lub 1)
bpp
Głębia bitowa (8 lub 16)
compression
Czy kompresować pdf (0 lub 1)
mode
Tryb umieszczania obrazów w formacie PDF
  • 0: normalny: po prostu umieść obrazy w pliku pdf
  • 1: wersja robocza: obrazy są zastępowane polami
  • 2: debugowanie: wyświetla tylko kontury i ramki ograniczające

🔗pfm

Nie określono opcji.

🔗png

bpp
Głębia bitowa (8 lub 16)
compression
Poziom kompresji (0 - 9).

🔗ppm

Nie określono opcji.

🔗tiff

bpp
Głębia bitowa (8, 16, 32)
compress
Typ kompresji
  • 0: nieskompresowany
  • 1: kompresja deflate
  • 2: kompresja deflate z predyktorem
compresslevel
Poziom kompresji (0 - 9)
shortfile
obraz B&W lub kolorowy
  • 0: zapisuj kolory rgb
  • 1: zapisuj skalę szarości

🔗webp

comp_type
Tryb kompresji
  • 0: stratna
  • 1: bezstratna
quality
jakość kompresji (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.)

🔗kopia

Nie określono opcji.

🔗xcf

bpp
Głębia bitowa (8, 16, 32)

🔗JXL

bpp
Głębia bitowa (8, 10, 12, 16, 32)
pixel_type
Wartość logiczna określająca, czy typ piksela (16 bitów) jest liczbą całkowitą bez znaku czy zmiennoprzecinkową
  • 0: liczba całkowita bez znaku
  • 1: zmiennoprzecinkowa
quality
Liczba naturalna (4 - 100); jakość zdjęcia, odpowiadająca mniej więcej jakości JPEG (100 to kompresja bezstratna)
original
Wartość logiczna: czy kodować przy użyciu oryginalnego profilu kolorów, czy wewnętrznego XYB
  • 0: wewnętrzne
  • 1: oryginał
effort
Liczba całkowita od 1 do 9. Wysiłek włożony w kodowanie danych wyjściowych; wyższy oznacza wolniejszy (domyślnie jest to 7)
tier
Liczba naturalna 1-4. Większe wartości kładą nacisk na prędkość dekodowania kosztem jakości (domyślnie 0)

translations