The ansel-cli binary starts the command line interface variant of Ansel which allows images to be exported.

Diese Variante öffnet keine Anzeige – sie arbeitet im reinen Konsolen-Modus, ohne ein GUI zu lancieren. Dieser Modus ist speziell geeignet für Server, die Hintergrund-Jobs abarbeiten.

ansel-cli can be called with the following command line parameters:

 1ansel-cli [<input file or folder>]
 2              [<xmp file>]
 3              <output file or folder>
 4              [--width <max width>]
 5              [--height <max height>]
 6              [--hq <0|1|true|false>]
 7              [--upscale <0|1|true|false>]
 8              [--style <style name>]
 9              [--style-overwrite]
10              [--apply-custom-presets <0|1|false|true>]
11              [--out-ext <extension>]
12              [--import <file or dir>]
13              [--icc-type <type>]
14              [--icc-file <file>]
15              [--icc-intent <intent>]
16              [--verbose]
17              [--help [option]]
18              [--core <Ansel options>]

Der Nutzer muss einen Eingabe-Dateinamen und einen Ausgabe-Dateinamen eingeben. Alle anderen Parameter sind optional.

<input file or folder>
Der Name der Eingabe-Datei oder -Ordner (Bilder enthaltend), der exportiert werden soll. Falls du wünschst mehrere Bilder oder mehrere Ordner abzuarbeiten nutze stattdessen die Option --import.
<xmp file>
Der optionale Name einer XMP-Begleitdatei mit den Daten des Verlaufsstapels, der beim Export angewandt werden sollen. Falls keine Angabe gemacht wird, sucht Ansel eine XMP-Datei, die zu den Eingabedateien gehört.
<output file or folder>
The name of the output file or destination folder. The export file format is derived from the file extension or from the --out-ext option. You can also use a number of variables in the output filename. For obvious reasons this parameter is mandatory if you use the program on an image folder containing multiple images. If you specify output folder it is recommended that you also specify the file format with --out-ext.
--width <max width>
Limitiere die maximale Breite des zu exportierenden Bildes in Pixeln.
--height <max height>
Limitiere die maximale Höhe des zu exportierenden Bildes in Pixeln.
--hq <0|1|true|false>
Define whether to use high quality resampling during export (see the export module reference for more details). Defaults to true.
--upscale <0|1|true|false>
Definiere, ob ein Vergrößern beim Export erlaubt ist. Standard nein.
--style <style name>
Definiere, ob ein Stil beim Export angewendet werden soll. Falls ein Stil definiert ist, muss der Pfad zum Ansel Konfigurations-Directory definiert sein (z.B. --core --configdir ~/.config/Ansel). Als Standard wird kein Stil angewendet.
--style-overwrite
Der spezifische Stil überschreibt den Verlaufsstapel, anstatt daran angehängt zu werden.
--apply-custom-presets <0|1|false|true>
Ob data.dbgeladen werden soll, der Voreinstellungen und Stile enthält. Wenn du diese Option ausschaltest, kannst du mehrere Instanzen von Ansel-clilaufen lassen auf Kosten, dass es dir nicht möglich ist die --styleOption zu nutzen. Standard ein.
--out-ext <extension>
Setze die Ausgabe so, dass die Datei-Endung gebraucht wird. Falls so spezifiziert hat dies Vorrang über das <output file>. Als Standard wird es aus <output file> extrahiert. Standard zu jpg, falls <output folder> spezifiziert ist.
--import <file or dir>
Spezifiziere die Eingabe-Datei oder -Ordner, das kann mehrfach genutzt werden. Diese Option kann nicht mit <input file or folder>kombiniert werden.
--icc-type <type>
Specify the ICC profile type, which is the same as specifying the “output profile” in the output color profile module. Defaults to “image specified”. Use --help icc-type to obtain a list of the supported types. See the output color profile module reference for a more detailed description of the available options.
--icc-file <file>
Specify the ICC profile filename. Defaults to an empty filename.
--icc-intent <intent>
Specify the rendering intent. Defaults to “image specified”. Use --help icc-intent to obtain a list of the supported intents. See rendering intent for a more detailed description of the available options.
--verbose
Ermöglicht eine ausführliche Ausgabe.
--help [option]
Druckt Verwendung und verlässt. Falls option spezifiziert wird, druckt Verwendung für die gegebene Option.
--core <Ansel options>
Alle Kommando-Linien-Parameter nach --core passieren durch das Ansel Core und werden als Standard-Parameter behandelt. Siehe dazu den Abschnitt Ansel binary für eine detaillierte Beschreibung.

Export Optionen

Export options for Ansel are defined as configuration items, set from within the export module. There are two ways to alter this configuration when using Ansel-cli, as described below.

Nutze das Modul Export

Der Befehl Ansel-cli wird die letzte Format-Konfiguration, die im Export-Modul im interaktiven Modus (gui) verwendet wurde, nutzen. Du kannst deshalb die gewünschten Optionen im Modus gui (grafische Benutzeroberfläche) und dann kannst du Ansel-clilaufen lassen, um Dateien zu exportieren.

Pass-Optionen der Befehlszeile

Du kannst mit der folgenden Syntax jegliche Export-Konfiguration setzen:

1    --core --conf plugins/imageio/format/<FORMAT>/<OPTION>=<VALUE>

Worin <FORMAT> der Name des gewünschten Ausgabe-Formates ist und <OPTION> jede Konfigurations-Option für dieses Format.

Eine Option, die so gesetzt wird, wird nicht permanent gespeichert und wird nur für diesen Lauf des Ansel-cligenutzt.

Die nächsten Abschnitte beschreiben die Konfigurations-Optionen, die für jedes Export-Format vorhanden sind:

jpeg

Qualität
die Qualität der Kompression (5 - 100)

j2k (jpg2000)

Format
Die Ausgabe des Formates
  • 0: J2K
  • 1: jp2
Qualität
die Qualität der Kompression (5 - 100)
Voreinstellungen
Der Modus DCP
  • 0: Cinema2K, 24 FPS
  • 1: Cinema2K, 48 FPS
  • 2: Cinema4K, 24 FPS

exr (OpenEXR)

Farbtiefe
Farbtiefe (16 oder 32)
Kompression
Die Art der Kompression
  • 0: uncompressed
  • 1: RLE
  • 2: ZIPS
  • 3: ZIP
  • 4: PIZ
  • 5: PXR24
  • 6: B44
  • 7: DWAA
  • 8: DWAB

pdf

Titel
Der Titel des pdf (jedes Charakters)
Grösse
Die Grösse des pdf (A4, A3, letter, legal)
Ausrichtung
Die Ausrichtung des Papiers des pdf
  • 0: Hochformat
  • 1: Querformat
Rand
Der leeren Streifen rund um das pdf; Format: Grösse (eine Zahl + Einheiten; Beispiele: 10mm, 1 Zoll
dpi
Die Auflösung in dots pro Zoll im pdf (1 - 5000)
rotieren
Soll das pdf gedreht werden (0 oder 1)
icc
Soll ein ICC Profil eingebettet werden (0 oder 1)
bpp
Die Bit-Tiefe (8 oder 16)
Kompression
Soll das pdf komprimiert werden (0 oder 1)
Modus
Der Modus, um das Bild ins pdf zu transformieren
  • 0: normal: transformiere einfach ins pdf
  • 1: Entwurf: Bilder werden mit Boxes ersetzt
  • 2: debug: zeigt nur den Überblick und den Rahmen der Boxen

pfm

Es gibt keine Optionen

png

bpp
Die Bit-Tiefe (8 oder 16)
Kompression
Das Level der Kompression (0 - 9)

ppm

Es gibt keine Optionen

TIFF

bpp
Die Bit-Tiefe (8, 16, 32)
komprimieren
Die Art der Kompression
  • 0: nicht komprimiert
  • 1: entkomprimiere
  • 2: entkomprimiere mit Predictor
Level der Kompression
Das Level der Kompression (0 - 9)
Kurzdatei
SW oder Farbbild
  • 0: schreibe RGB Farben
  • 1: schreibe Grauskala

webp

comp_type
der Typ der Kompression
  • 0: verlustbehaftet
  • 1: ohne Verluste
Qualität
Die Qualität der Kompression (5 - 100)
Hinweis
Die bevorzugte Art, die Kompression zu managen
  • 0: Standard
  • 1: Bild: digitales Bild, wie Porträt, mit Innenbeleuchtung
  • 2: Photo: Outdoor Fotografie, mit natürlichem Licht
  • 3: grafisch: mit schwachen Farben (grafisch, Kacheln etc.)

kopieren

Es gibt keine Optionen

xcf

bpp
Die Bit-Tiefe (8, 16, 32)