Command-Line Options/it

Spiegazione

<Chevrons> indica i parametri che che è possibile modificare.

[Square brackets] significa che il parametro non è obbligatorio.

The pipe symbol | indica una scelta di uno o l'altro.

The dash symbol - indica una gamma di valori possibili tra uno e l'altro.

Dalla versione di RawTherapee 5.1,sono forniti due programmi eseguibili.

RawTherapee GUI

Una questa applicazione per avviare il programma con la versione grafica.

Utilizzo:

rawtherapee <selected dir>

Avvia il Navigatore nel percorso indicato.

rawtherapee <file>

Avvia il Navigatore con l'immagine indicata.

-w

Non aprire la console di Windows. Questa opzione è disponibile solo in Windows. Se si passano i parametri all'eseguibile RawTherapee esso apre una finestra di console in modo che tu possa vedere l'output dettagliato della tua elaborazione. Normalmente Windows chiude questa console subito dopo che RawTherapee è terminato. Per consentirti di vedere l'output abbiamo aggiunto un prompt si blocca in attesa di premere un tasto prima di chiudere la console. Specificando -w</ code> nessuna console verrà aperta e pertanto non è necessaria alcuna pressione del tasto. Utile se si desidera richiamare rawtherapee.exe</ code> in batch, ad esempio da uno script PowerShell. Si prega di notare che -w</ code> non avrà alcun effetto per le build di "Debug" in cui verrà aperta una finestra di console a meno che non si sia già avviato RawTherapee da una finestra di console.

-v

Stampa la versione di RawTherapee e esce.

-R

Modalità "remota", disponibile da RawTherapee 5.2. Quando si apre un'immagine usando "Apri con" o passando il suo nome di file come argomento, senza utilizzare l'opzione -R</ code> RawTherapee si apre in modalità "no-Navigatore" - in questa modalità mancano le schede Navigatore e Coda di sviluppo e il pulsante Preferenze. Utilizzando la nuova modalità -R</ code>, RawTherapee si aprirà in un'istanza piena. L'utilizzo di -R</ code> consente anche di aprire un'immagine in un'istanza già in esecuzione di RawTherapee, anche se l'istanza è stata avviata anche utilizzando -R</ code>. La modalità No-Navigatore esiste per motivi storici quando i requisiti RAM erano più alti e la stabilità era peggiore. Ora che l'utilizzo della memoria di RawTherapee è ottimizzato e può aprire in modo rapido e affidabile le cartelle con migliaia di immagini, gli utenti possono preferire la modalità -R</ code> per impostazione predefinita.

-h -?

Mostra questi comandi.

RawTherapee CLI (Interfaccia a riga di comando)

Usa questa versione per avviare l'applicazione con la sola linea di comando. E' possibile trovare tutti i comandi per elaborare le tue foto senza nessuna interfaccia grafica.

Utilizzo:

rawtherapee-cli <options> -c <dir>|<files>

Converte i file in batch con i parametri predefiniti se non è stata specificata alcuna <opzione>.

-w

Non aprire la console di Windows. Questa opzione è disponibile solo in Windows. Se si passano i parametri all'eseguibile RawTherapee questo apre una finestra di console in modo che tu possa vedere l'output dettagliato della tua elaborazione. Normalmente Windows chiude questa console subito dopo che RawTherapee è terminato. Per consentirti di vedere l'output abbiamo aggiunto un prompt che si blocca in atteda della pressione di un tasto prima di chiudere la console. Specificando -w nessuna console verrà aperta e pertanto non è necessaria alcuna pressione sul tasto. Utile se si desidera richiamare rawtherapee-cli.exe in batch, ad esempio da uno script PowerShell.

Antre opzioni utilizzate con -c:

rawtherapee-cli [-o <output>|-O <output>] [-q] [-a] [-s|-S] [-p <files>] [-d] [-j[1-100] [-js<1-3>]|[-b<8|16>] <[-t[z] | [-n]]] [-Y] [-f] -c <input>

-c <files>

Specifica uno o piu immagini o percorsi.

Quando si specifica un percorso, RawTherapee cerca le immagini contenute con l'estenzione impostata (vedi l'opzione -a).

L'opzione -c deve sempre essere l'ultima.

-o <file>|<dir>

Seleziona un file o percorso di uscita.

Salva il file di output accanto al file di input se -o non è specificato.

-O <file>|<dir>

Seleziona un file o percorso di uscita e copia i file PP3 nello stesso percorso.

Salva il file di output accanto al file di input se -O non è specificato.

-q<file>|<dir>

Modalità di avvio rapido. Non carica i file memorizzati nella cache per accelerare l'avvio.

-a<file>|<dir>

Processi tutti i tipi di file di immagine supportati quando si specifica una cartella, anche quelli non selezionati in Preferenze> Navigatore> Estensioni riconosciute.

-s

Utilizza il file sidecar esistente per costruire i parametri di elaborazione, ad esempio per photo.raw dovrebbe essere un file photo.raw.pp3 nella stessa cartella. Se il file sidecar non esiste, verranno utilizzati valori neutri.

-S

Identico a -s ma non usatelo se non esiste il file sidecar.

-p <file.pp3>

Specificare il profilo di elaborazione da utilizzare per tutte le conversioni. È possibile specificare il numero di set di opzioni "-p <file.pp3>" come si desidera, ciascuna sarà costruita in cima a quella precedente, come spiegato di seguito.

-d

Usa il file PP3 predefinito specificato in " Preferences > Image Processing > Default Processing Profile"

-j[1-100]

Specifica il formato di uscita JPEG (predefinito, se-t o-n non sono impostati).

Opzionale, specifica la compressione 1-100 (valore predefinito: 92).

-js<1-3>

Specifica i parametri del formato JPEG chroma subsampling, dove:

1 = Migliore compressione: 2x2, 1x1, 1x1 (4:2:0)

Chroma dimezzata verticalmente e orizzontalmente.

2 = Bilanciato: 2x1, 1x1, 1x1 (4:2:2)

Chroma dimezzata orizzontalmente.

3 = Migliore qualità: 1x1, 1x1, 1x1 (4:4:4)

Nessun sottocampionamento del chroma.

-b<8|16>

Specifica la profondità colore per canale (16 bit predefinito).

Si applica solo all'uscita TIFF e PNG, JPEG è sempre 8.

-t[z]

Specifica i parametri del formato TIFF (16-bit se-b8 non è impostato).

Non compresso per impostazione predefinita, o compressione ZIP con 'z'.

-n

Specifica i parametri del formato PNG (16-bit se-b8 non è impostato).

La compressione è hard-coded al livello 6.

-Y

Sovrascrive output se presente.

-f

Usa la coda di sviluppo pe accellerare l'esportazione.

I file PP3 possono essere incompleti, RawTherapee imposterà i valori come segue:

1. Viene creato un nuovo profilo di elaborazione utilizzando valori neutri,
2. Con l'opzione -d i valori vengono sovrascritti da quelli trovati nel profilo predefinito di elaborazione raw o non raw,
3. Se sono state impostate una o più opzioni -p, i valori vengono sovrascritti da quelli trovati in questi profili di elaborazione,
4. Se sono impostate le opzioni -s o -S, i valori vengono finalmente ignorati da quelli trovati nei file sidecar. I profili di elaborazione vengono elaborati nell'ordine specificato sulla riga di comando.

Redirect Output

To redirect RawTherapee's output to a text file, you have to start it from a console and append the redirection code as follows:

Windows (cmd.exe)

rawtherapee.exe > rtlog.txt 2>&1

Linux

rawtherapee &> rtlog.txt

Examples

Example 1

In Linux, process a single raw which resides in /tmp and is called "photo.raw", use its sidecar file "photo.raw.pp3" during conversion, save it in the same folder as "foo.tif", and overwrite the file "foo.tif" if it exists:

rawtherapee-cli -o /tmp/foo.tif -s -t -Y -c /tmp/photo.raw

Example 2

In the next example, we'll assume that you want to quickly process all your raw photos from the /tmp/jane01 folder to a web sub-folder by using the default profile as a basis, using the sidecar profile if it exist, but with removing some Exif tags (e.g. the camera's serial number) and adding some IPTC tags (e.g. your usual copyright parameters), plus resize and sharpen the image for the web (spread over multiple lines for clarity):

rawtherapee-cli -o /tmp/Jane01/web -p ~/profiles/iptc.pp3 -s -p ~/profiles/exif.pp3 -p ~/profiles/web.pp3 -t -Y -d -c /tmp/Jane01/

The processing profile will be built as follows:

1. A new profile is created using internal default values (hard-coded into RawTherapee),
2. then overridden by those from the default raw profile (-d),
3. then overridden by those found in iptc.pp3,
4. then overridden by those found in the sidecar file (-s) if it exists, so you can force some IPTC tags even if already set by iptc.pp3,
5. then overridden by those found in exif.pp3, so you can force the profile to erase some tags,
6. then overridden by those found in web.pp3, to resize and sharpen the image, and make sure that the output colorspace is sRGB.

As you can see, the position of the -s switch tells when to load the sidecar profile relative to the other -p parameters. That is not the case for the -d switch.

Example 3

In the third example, we will see how long it takes to process every raw file in a folder, assuming that each raw photo has a corresponding processing profile, and discard each output file:

time {
 for f in /home/user/photos/2011-11-11/*.raw; do
   rawtherapee-cli -o /dev/null -S -t -Y -c "$f";
 done
 }