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

Deze variant opent geen enkel scherm – het werkt in pure consolemodus zonder een GUI te starten. Deze modus is met name handig voor servers die achtergrondtaken uitvoeren.

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>]

De gebruiker moet een invoerbestandsnaam en een uitvoerbestandsnaam opgeven. Alle andere parameters zijn optioneel.

<input file or folder>
De naam van het invoerbestand of de map (met afbeeldingen) die moet worden geëxporteerd. Als je meerdere afbeeldingen of meerdere mappen wilt verwerken, gebruik je in plaats daarvan de optie --import.
<xmp-bestand>
de optionele naam van een XMP sidecar-bestand met de geschiedenisgegevens die tijdens het exporteren moeten worden toegepast. Als deze optie niet aanwezig is, zoekt Ansel naar een XMP-bestand dat bij de opgegeven invoerbestand(en) hoort.
<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>
Beperk de breedte van de geëxporteerde afbeelding tot het opgegeven aantal pixels.
--height <max height>
Beperk de hoogte van de geëxporteerde afbeelding tot het opgegeven aantal pixels.
--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>
definieer of opschalen tijdens het exporteren is toegestaan. Standaard ingesteld op false.
--style <style name>
geef de naam op van een stijl die moet worden toegepast tijdens het exporteren. Als een stijl is opgegeven, moet ook het pad naar de Ansel-configuratiemap worden opgegeven (d.w.z. --core --configdir ~/.config/Ansel). Standaard wordt er geen stijl toegepast.
--style-overwrite
De opgegeven stijl overschrijft de geschiedenis in plaats van eraan te worden toegevoegd.
--apply-custom-presets <0|1|false|true>
of data.db moet worden geladen die voorinstellingen en stijlen bevat. Als je deze optie uitschakelt, kan je meerdere exemplaren van Ansel-cli uitvoeren ten koste van het niet kunnen gebruiken van de optie --style. Standaard ingesteld op true.
--out-ext <extension>
de te gebruiken uitvoerextensie instellen. Indien opgegeven heeft voorrang op <output file>. Standaard wordt dit geëxtraheerd uit <output file>. Standaard ingesteld op jpg als <output folder> is opgegeven.
--import <file or dir>
Specificeer invoerbestand of map, kan meerdere keren worden gebruikt. Deze optie kan niet worden gecombineerd met <input file or folder>.
--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
Maakt uitgebreide uitvoer mogelijk.
--help [option]
Drukt gebruik af en sluit af. Als option is opgegeven, wordt bovendien het gebruik voor de gegeven optie afgedrukt.
--core <Ansel options>
Alle opdrachtregelparameters die volgen op --core worden doorgegeven aan de Ansel-kern en behandeld als standaardparameters. Zie de sectie Ansel binary voor een gedetailleerde beschrijving.

exporteer opties

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.

gebruik de exporteren module

De opdracht Ansel-cli zal de laatste formaatconfiguratie gebruiken die in de exporteer-module is gebruikt, wanneer deze in de interactieve (gui) modus wordt uitgevoerd. U kunt daarom handmatig de gewenste formaatopties instellen in de Ansel-gui en vervolgens Ansel-cli uitvoeren om uw bestanden te exporteren.

geef opties door op de opdrachtregel

U kunt elke configuratie-optie voor exportindelingen instellen met behulp van de volgende syntaxis:

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

waarbij <FORMAT> de naam is van het gewenste uitvoerformaat en <OPTION> een willekeurige configuratieoptie voor dat formaat is.

Een optie die op deze manier is ingesteld, wordt niet permanent opgeslagen, maar wordt alleen gebruikt voor het uitvoeren van Ansel-cli.

De volgende secties beschrijven de configuratie-opties/waarden die beschikbaar zijn voor elk exportformaat:

jpeg

kwaliteit
De compressiekwaliteit (5 - 100)

j2k (jpg2000)

formaat
Het formaat van de uitvoer
  • 0: J2K
  • 1: jp2
kwaliteit
De compressiekwaliteit (5 - 100)
vooraf ingesteld
De DCP-modus
  • ‘0’: Cinema2K, 24 FPS
  • 1: Cinema2K, 48 FPS
  • 2: Cinema4K, 24 FPS

exr (OpenEXR)

bpp
De bitdiepte (16 of 32)
compressie
Het compressietype
  • 0: ongecomprimeerd
  • 1: RLE
  • 2: ZIPPEN
  • 3: ZIP
  • 4: PIZ
  • 5: PXR24
  • 6: B44
  • 7: DWAA
  • 8: DWAB

pdf

titel
De titel van de pdf (elk teken)
afmeting
De grootte van de pdf (a4, a3, letter, legal)
oriëntatie
de papierrichting van de pdf
  • 0: portret
  • 1: landschap
rand
De lege ruimte rond de pdf; formaat: grootte (een getal) + eenheid; voorbeelden: 10 mm, 1 inch
dpi
De resolutie in dots per inch in de pdf (1 - 5000)
roteren
Of de pdf moet worden gedraaid (0 of 1)
icc
Of een icc-profiel moet worden ingesloten (0 of 1)
bpp
De bitdiepte (8 of 16)
compressie
Of de pdf moet worden gecomprimeerd (0 of 1)
modus
De modus om de afbeeldingen in de pdf te plaatsen
  • 0: normaal: plaats de afbeeldingen gewoon in de pdf
  • 1: concept: afbeeldingen worden vervangen door kaders
  • 2: debug: alleen de omtreklijnen en begrenzingskaders tonen

pfm

Geen opties gegeven.

png

bpp
De bitdiepte (8 of 16)
compressie
Het compressieniveau (0 - 9)

ppm

Geen opties gegeven.

tiff

bpp
De bitdiepte (8, 16, 32)
comprimeren
Het compressietype
  • 0: ongecomprimeerd
  • 1: leeglopen
  • 2: leeglopen met voorspeller
compressieniveau
Het compressieniveau (0 - 9)
kort bestand
Z&W of kleurenafbeelding
  • 0: RGB-kleuren schrijven
  • 1: grijswaarden schrijven

webp

comp_type
Het compressietype
  • 0: verlies
  • 1: verliesvrij
kwaliteit
de compressiekwaliteit (5 - 100)
hint
De geprefereerde manier om de compressie te beheren
  • 0: standaard
  • 1: foto: digitale foto, zoals portret, binnenopname
  • 2: foto : buitenfoto, met natuurlijk licht
  • 3: grafisch: discrete toon afbeelding (grafiek, kaart-tegel etc)

kopiëren

Geen opties gegeven.

xcf

bpp
De bitdiepte (8, 16, 32)