# xvidcap Manual V0.3

2008
Karl H. Beckers
2003
Vincenzo Reale (traduzione italiana)
Karl H. Beckers
Karl
H.
Beckers
karl.h.beckers@gmx.net
xvidcap V0.1
2006

Karl H. Beckers karl.h.beckers@gmx.net

Karl H. Beckers

xvidcap V0.2
2007

Karl H. Beckers karl.h.beckers@gmx.net

Karl H. Beckers

xvidcap V0.3
2008

Karl H. Beckers karl.h.beckers@gmx.net

Karl H. Beckers

Questo manuale descrive la versione 1.1.7 di xvidcap.

## Segnalazioni

Per segnalare bug o proporre suggerimenti riguardanti l'applicazione xvidcap o questa guida, seguire le istruzioni reperibili sul sito di xvidcap, presso SF.net.

Manuale utente per l'applicazione di acquisizione dello schermo.

## Introduzione

xvidcap è uno strumento che acquisisce su file il movimento presente in un'area selezionata di uno schermo X11. Ciò avviene tramite l'acquisizione di un numero configurabile di schermate per secondo ed il loro salvataggio, sia come schermate individualiche come video. Questo tipo di applicazione, al giorno d'oggi, è comunemente definito programma screencam o screencast. Uno dei più primi programmi del genere era Lotus Screencam, che è stato d'ispirazione per xvidcap.

xvidcap può essere utilizzato in due distinte modalità operativen:

1. acquisizione a fotogramma singolo -- per acquisire ciascuna singola schermata in altrettanti file.

2. acquisizione a fotogrammi multipli -- per acquisire e codificare al volo un video.

### Promemoria

Il nome attribuito alle modalità operative deriva dal numero di fotogrammi che vengono memorizzati nel file di uscita: uno o più.

### Acquisizione audio

xvidcap può acquisire l'audio, ma solo in modalità di acquisizione a fotogrammi multipli.

La registrazione in modalità di acquisizione a fotogramma singolo potrebbe essere maggiormente conveniente se si desidera pre-processare le immagini prima della codifica, o se si vuole usare codificatori video che xvidcap non supporta. Le singole immagini possono essere codificate successivamente con strumenti quali ffmpeg, mencoder, o transcode.

Per segnalare bug o proporre suggerimenti riguardanti l'applicazione xvidcap o questa guida, seguire le istruzioni reperibili sul sito di xvidcap, presso SF.net.

## Primi passi

### Avviare xvidcap

Puoi avviare xvidcap nei seguenti modi:

Menu Applicazioni

  Scegliere Sonoro e Video Acquisizione schermo con XVidCap.

Linea di comando

  Eseguire il seguente comando: `xvidcap`. Per ulteriori informazioni circa l'utilizzo della linea di comando, vedere la pagina di manuale di xvidcap.

### All'avvio di xvidcap

All'avvio di xvidcap, viene visualizzata la seguente finestra:

#### Controlli di xvidcap

Mostra i controllo di xvidcap.

La finestra dotata di titolo e pulsanti è il controllo principale di xvidcap, mentre il rettangolo rosso è il fotogramma di selezione che racchiude l'area da catturare.

#### Controlli principali di xvidcap

Visualizzatore nome file e menu

Il visualizzatore nome file e menu visualizza il nome file attuale e, se in modalità di acquisizione a fotogrammi multipli, il numero indice del fotogramma acquisito di recente tra parentesi quadre. In modalità di acquisizione a fotogramma singolo, il numero indice del fotogramma attuale sarà normalmente parte del nome file.

In modalità di acquisizione a fotogramma singolo, un clic del tasto destro del mouse reimposta il contatore dei fotogrammi all'inizio. Un clic del tasto destro quando non si è in fase di acquisizione mostrerà il menu principale.

#### Modalità di acquisizione predefinita

In maniera predefinita, xvidcap si avvia in modalità di acquisizione a fotogrammi multipli.

Contatore dei fotogrammi scartati

Il contatore dei fotogrammi scartati fornisce un'indicazione della bontà della sessione di acquisizione alla velocità desiderata. Se il proprio sistema viene sottoposto ad un carico eccessivo, potrebbe non essere in grado di acquisire il numero di fotogrammi desiderato. Ciò si manifesterà con un'anomala velocità di riproduzione dei video. xvidcap visualizza uno stato verde se è possibile acquisire o quasi alla velocità desiderata. Se ci sono fotogrammi scartati lo stato diventa giallo, o rosso se il numero di fotogrammi scartati è eccessivo. Per ridurre il numero di fotogrammi scartati, è possibile acquisire una parte di schermo più piccola, selezionare una velocità minore, chiudere quante più applicazioni che caricano eccessivamente il sistema sia possibile, o eseguire il programma sun una macchina più potente. Potrebbe, inoltre, essere di aiuto il ridimensionamento dei dati acquisiti. Un altro modo per rendere più leggera l'acquisizione dello schermo sul proprio sistema consiste nell'utilizzo dell'estensione XDamage. Vedere il paragrafo corrispondente sulla scheda delle opzioni generali della finestra delle preferenze.

Pulsante Ferma | Il pulsante Ferma interrompe una sessione di registrazione in esecuzione.
Pulsante Pausa | Il pulsante Pausa sospende una sessione di registrazione o continua una sessione sospesa. È possibile selezionare anche prima dell'inizio della registrazione per avviare in pausa.
Pulsante Registra | Il pulsante Registra avvia una sessione di registrazione.
Pulsante Istantanea singola | Il pulsante Istantanea singola è attivo solo in caso di sessioni in pausa per la modalità di acquisizione a fotogramma singolo. Permette di catturare schermate singole alla pressione del pulsante.

Pulsante Riavvolgi

Il pulsante Riavvolgi ha diversi usi a seconda della modalità di acquisizione attuale.

In modalità di acquisizione a fotogramma singolo il riavvolgimento si riferisce al numero indice del fotogramma attuale da acquisire. Immaginare di fermare una sessione di acquisizione che ha catturato dieci immagini PNG. Il visualizzatore nome file dovrebbe mostrare test-0010.png. Se si crede che le ultime due schermate non siano quelle desiderate, è possibile fare clic sul pulsante Riavvolgi due volte. Ciò cambierà il nome file visualizzato in test-0008.png. Se l'acquisizione continua, i fotogrammi otto e nove delle immagini test-0008.png e test-0009.png saranno sovrascritti.

In modalità di acquisizione a fotogrammi multipli, il pulsante Riavvolgi funziona quasi alla stesso modo. In ogni caso, non influenza il numero indice del fotogramma attuale, ma quello del filmato attuale poiché si riferisce alla funzionalità di continuazione automatica.

Pulsante Avanti | Il pulsante Avanti fa l'opposto del pulsante Riavvolgi incrementando il numero indice del fotogramma attuale o il numero indice del filmato a seconda della modalità di acquisizione.
Pulsante Blocca area di acquisizione | The Frame Selection Lock makes the capture selection move with the main control if selected. If deselected, the capture selection will stay where it is when the main control moves. If, in the preferences dialog, you have checked "Capture Area Follows Mouse" the capture selection follows the mouse pointer instead.

Pulsante Selettore fotogramma

Fare clic sul pulsante Selettore fotogramma per cambiare l'area che si desidera catturare. Al clic, il puntatore si trasforma in un puntatore a croce. Fatto questo, è possibile:

- fare clic su una singola finestra per catturarla.

  #### Spostare le finestre catturate

  Notare che la selezione dell'area non è incollata alla finestra nel senso di seguire la finestra selezionata in origine, se ci si sposta. Si occupa di regolare la posizone e la dimensione dell'area di acquisizione selezionata in corrispondenza del contenuto della finestra selezionata. Se, successivamente, si sposta la finestra, l'area di acquisizione rimarrà nella stessa posizione, a meno che non si sia abilitato il blocco dell'area di acquisizione e si sposti manualmente il controllo principale nella giusta posizione.

- fare clic e trascinare per selezionare un'arbitraria posizione dello schermo.

- fare clic sullo sfondo per selezionare l'acquisizione a schermo intero.

  #### Acquisizione a schermo intero

  Con le dimensioni attuali dello schermo, l'acquisizione a schermo intero ha un'alta probabilità di sottoporre il sistema a un elevato carico. Guardare il contatore dei fotogrammi scartati e, se possibile, regolare la risoluzione del proprio schermo se è necessaria un'acquisizione a schermo intero. Si tenga presente che la tipica risoluzione dei DVD è di 720 x 486. L'acquisizione a schermo intero a risoluzione di 1400 x 1050 significa codificare in tempo reale una quantità di dati 4 volte maggiore di quella di un DVD -- niente a che vedere con qualcosa che si può realizzare con carta e penna.

  Comunque, non è solo la codifica di un'acquisizione a schermo intero che può stressare il sistema. La cattura dell'intera area di acquisizione da uno schermo X11 è un'operazione di per sé pesante. L'utilizzo dell'estensione XDamage potrebbe alleviare questo effetto, anche se potrebbe generare degli avvisi. Vedere il paragrafo corrispondente sulla scheda delle opzioni generali della finestra delle preferenze.

#### Ridimensiona trascinando

A partire dalla versione 1.1.5, è possibile ridimensionare l'area di acquisizione anche trascinando i bordi del fotogramma mentre non si è in fase di acquisizione. Utilizzare questa funzionalità come si ridimensiona una normale finestra.

Pulsante Modifica

Il pulsante Modifica chiama un programma esterno per modificare i fotogrammi acquisiti di recente in modalità di acquisizione a fotogramma singolo o il video attuale in modalità di acquisizione a fotogrammi multipli. xvidcap non fornisce queste applicazioni. In maniera predefinita, xvidcap chiama gimp in modalità di acquisizione a fotogramma singolo e nessun programma in modalità di acquisizione a fotogrammi multipli. Le due impostazioni possono essere cambiate attraverso la finestra delle preferenze.

### Menu principale

Un clic del tasto destro sul visualizzatore del nome file mostra il seguente menu:

#### Menu principale

Menu principale

#### le voci del menu principale:

Voce di menu Preferenze | apre la finestra delle preferenze

Voce di menu Salva preferenze

salva le impostazioni attuali

#### Impostazioni temporanee

Notare che xvidcap non salva automaticamente le preferenze cambiate. È possibile modificare le impostazioni, uscire da xvidcap, e tornare alle impostazioni precedenti con il solo riavvio di xvidcap. Se si vuole rendere le modifiche permanenti, selezionare questa opzione. Scriverà le impostazioni in un file `.xvidcaprc` nella propria home.

Voce di menu Fotogrammi multipli

seleziona la modalità di acquisizione a fotogrammi multipli

#### Impostazioni parallele per le modalità di acquisizione

Occorre ricordare che è possibile avere impostazioni distinte per le modalità di acquisizione a fotogrammi multipli e a fotogramma singolo configurate e memorizzate contemporaneamente. La scelta di questa voce di menu o della successiva commuta tra le due modalità e le rispettive impostazioni.

Voce di menu Fotogramma singolo | seleziona la modalità di acquisizione a fotogramma singolo
Voce di menu Continuazione automatica | Attiva o disattiva la funzionalita di continuazione automatica Selezionabile solo in modalità di acquisizione a fotogrammi multipli e solo se il nome file è variabile. Fare riferimento a impostazioni di continuazione automatica per ulteriori informazioni.

Show Frame

show frame around capture area (yes/no)

If this is unchecked, the frame around the area to capture is hidden.

#### Hiding frame around the area to capture

This is esp. helpful, if you are running a compositing window manager like compiz and use effects which make the capture frame lag behind the movement of the area to capture (e. g. wobbly windows). In such a case the lagging frame parts may move inside the area to capture ending up visible in the finished video.

The cleaner solution, however, is to disable the effect for windows of class "Xvidcap". That makes hiding the frame unnecessary.

Voce di menu Crea video

esegue il comando di codifica impostato nelle preferenze

In modalità di acquisizione a fotogrammi multipli non è necessaria e non impostata come predefinita. Può, comunque, essere impostata per consentire l'esecuzione di un comando di transcodifica personalizzato se si desidera un formato d'uscita diverso da quelli che xvidcap può generare. Lo script usato come predefinito in modalità di acquisizione a fotogramma singolo è fornito da xvidcap ma potrebbe essere necessario copiarlo nel proprio path per renderlo disponibile. Fare riferimento a la scheda di preferenze dei comandi per ulteriori informazioni su come impostare i comandi di codifica.

Voce di menu Anima/Riproduci | esegue il comando di riproduzione impostato nelle preferenze In modalità di acquisizione a fotogrammi multipli è mplayer e animate (parte di ImageMagick) in maniera predefinita. Fare riferimento a la scheda di preferenze dei comandi per ulteriori informazioni su come impostare i comandi di codifica.
Voce di menu Aiuto | mostra l'aiuto in linea
Voce di menu Informazioni su | mostra la finestra di informazioni di xvidcap
Voce di menu Esci | esce da xvidcap

## Preferenze

Puoi aprire la finestra Preferenze sia facendo clic con il tasto destro sul visualizzatore del nome file controllo principale e selezionando Preferenze, sia premendo CTRL-P. La finestra è divisa in quattro schede.

### Preferenze generali

La prima scheda della finestra delle preferenze contiene varie impostazioni riguardanti il comportamento generale di xvidcap.

#### Preferenze generali

Preferenze generali

#### le impostazioni generali sono:

Modalità di acquisizione predefinita | Questa opzione stabilisce la modalità di acquisizione predefinita di xvidcap, ad es. se nessun altra impostazione fornisce a xvidcap un indizio.

Catturare il puntatore del mouse

Spuntare questa opzione per acquisireil puntatore del mouse.

#### Forme personalizzate del puntatore del mouse

Senza l'estesione XFixes di X11, non c'è modo per xvidcap di acquisire l'effettivo, attuale puntatore, solo la sua posizione. Se l'estensione non è disponibile sia sulla macchina dove xvidcap è stato compilato sia dove è eseguito, xvidcap genera un puntatore del mouse fittizio nel filmato acquisito. In questo caso si troverà un pulsante di selezione accanto alla casella che consente di selezionare se il puntatore fittizio sarà bianco o nero.

Salva geometria di acquisizione | Spuntare questa opzione per memorizzare la dimensione e la posizione dell'area di acquisizione attualmente selezionata insieme ad altre preferenze selezionando Salva preferenze dal menu principale.
Capture Area Follows Mouse | Check this if you want a locked frame to follow the mousepointer's movement rather than that of the main control windows.
Hide Frame | Check this if you want the frame around the area to capture to be hidden. See the Show Frame menu item for more information, but notice that this works the other way around, i. e. a check hides the frame.

Usa memoria condivisa

Spuntare questa opzione se si vuole che l'acquisizione dei fotogrammi utilizzi l'estensioni della memoria condivisa di X11.

#### Accesso con memoria condivisa a X11

L'uso della memoria condivisa è abilitato in maniera predefinita se la macchina sulla quale xvidcap è stato compilato supporta l'accesso con memoria condivisa a X11, che rappresenta oggigiorno la situazione tipica. È necessario disabilitare questa funzione, comunque, se server X11 e client non sono in esecuzione sulla stessa macchina, ad es. se si usa un terminale X su thin client.

Imposta manualmente XDamage

Selezionare questa opzione se si vuole scavalcare la decisione di xvidcap sull'uso o meno dell'estensione XDamage per velocizzare l'acquisizione dello schermo. Questa estensione permette a xvidcap di essere informato circa le porzioni di schermo che sono cambiate tra i singoli fotogrammi, in modo da non dover ottenere l'intera area da acquisire per ogni fotogramma. xvidcap cercherà di utilizzare XDamage in modo predefinito se disponibile al momento della compilazione, se è disponibile al momento dell'esecuzione, e se il gestore di finestre utilizzato non è compiz o beryl. Se si utilizza beryl e si desidera utilizzare comunque l'estensione XDamage, selezionare questo controllo per abilitare i pulsanti di selezione sulla destra e scegliere "abilitato".

#### XDamage e compiz o beryl

A causa dei possibili effetti visuali avanzati di compiz, beryl e affini, le notifiche ricevute da xvidcap tramite XDamage potrebbero non essere sufficienti per determinare la giusta posizione delle schermo da acquisire. Si può comunque forzare xvidcap ad utilizzarla come descritto sopra, ma la distanza potrebbe variare.

Continuazione automatica

Se si registra in modalità di acquisizione a fotogrammi multipli e si usa un numero massimo di fotogrammi da acquisire o una durata massima di acquisizione, xvidcap può automaticamente continuare ad acquisire in un nuovo video una volta che il numero massimo di fotogrammi o la durata massima sia stata raggiunta. In questo modo si possono creare una serie di filmati in spezzoni della lunghezza massima desiderata. Per usare questa funzione è necessario un nome file di destinazione mutevole.

Mostra sempre la finestra dei risultati

Spuntare questa opzione per mostrare sempre una finestra con un riepilogo dei risultati di acquisizione all'interruzione di una sessione di registrazione. La finestra sarà mostrata sempre se richiesto (ad es. per specificare il nome file di destinazione). In tal caso, la finestra potrebbe essere mostrato anche se non strettamente necessario. Per scelta predefinita, la finestra dei risultati è sempre visualizzata. Se si rimuove la spunta da Mostra questa finestra la prossima volta nella finestra precedente, è possibile riattivarla qui.

Minimizza nel vassoio di sistema

Selezionare questa opzione per minimizzare xvidcap nel vassoio di sistema all'avvio di una sessione di registrazione. In tal caso, il pannello di controllo principale sarà nascosto e il monitor dei fotogrammi scartati apparirà nel vassoio di sistema. Un clic destro su di esso permetterà di mettere in pausa o fermare la sessione di registrazione. Se si ferma la registrazione la finestra principale sarà visualizzata nuovamente.

Percentuale di ridimensionamento dell'uscita

Usare questa opzione per ridurre le dimensioni del video di uscita rispetto alle dimensioni originali della porzione di schermo acquisita. La percentuale specificata qui è la dimensione dell'uscita relativa all'ingresso. Per esempio, specificando 25, l'altezza e la larghezza dell'uscita saranno la metà dell'originale. Le dimensioni dell'immagine di uscita saranno il 25 percento dell'area acquisita.

#### Il ridimensionamento non funziona con l'uscita XWD

Il ridimensionamento dei fotogrammi di uscita funziona con tutti i formati di uscita e i codificatori tranne che con XWD.

### Preferenze di acquisizione a fotogramma singolo

Questa scheda contiene le impostazioni per la modalità di acquisizione a fotogramma singolo. Poiché tale modalità non supporta l'acquisizione audio, è possibile configurare solo le impostazioni video.

#### Preferenze di acquisizione a fotogramma singolo

Preferenze di acquisizione a fotogramma singolo

#### le impostazione per la modalità di acquisizione a fotogramma singolo sono:

Nome file

Inserire qui un modello di nome file da usare per il salvataggio dei singoli fotogrammi acquisiti. Il nome file deve contenere un modello che sarà sostituito dal numero del fotogramma per ogni singolo file. I modelli usati sono quelli riconosciuti da fprintf. Un nome file che contiene questo tipo di modelli sarà definito, d'ora in poi, nome file mutevole

#### Selezione del nome file

Invece di digitare un nome file, è possibile fare clic sul pulsante di selezione file (...). Assicurarsi di immettere un modello numerico nel nome file. In caso di dubbi, usare %5d in una qualunque posizione del nome file.

Formato file | Se si spunta la casella auto, xvidcap selezionerà automaticamente un formato di uscita appropriato basato sul nome file specificato. Per esempio, se si specifica test-%4d.png il formato di uscita sarà Portable Network Graphics File (png). Se la casella auto è deselezionata, il menu a tendina permette di selezionare manualmente un formato, ignorando la decisione di xvidcap.
Fotogrammi al secondo | Il numero di fotogrammi da acquisire per secondo.
Tempo massimo | Tempo massimo di registrazione in secondi
Numero massimo di fotogrammi | Numero massimo fotogrammi da acquisire
Numero del fotogramma iniziale | Inizia il conteggio dei fotogrammi con questo numero

Incremento per il numero del fotogramma

Durante l'acquisizione incrementa il conteggio dei fotogrammi del numero specificato per ciascuno dei fotogrammi acquisiti.

#### Impostazioni deprecate

A causa dell'uso limitato di Numero del fotogramma iniziale e Incremento per il numero del fotogramma, queste impostazioni potrebbe sparire nelle prossime versioni.

Qualità

Qualità desiderata dell'uscita

#### Impostazione della qualità cambiata nella 1.1.5

L'effetto dell'impostazione della qualità a un valore inferiore al 100% è cambiato in xvidcap 1.1.5. Assicurarsi di provare i valori nelle preferenze memorizzate. L'impostazione di qualità non si applica all'uscita XWD.

### Preferenze di acquisizione a fotogrammi multipli

Questa scheda contiene le impostazioni per la modalità di acquisizione a fotogrammi multipli.

#### Preferenze di acquisizione a fotogrammi multipli

Preferenze di acquisizione a fotogrammi multipli

#### le impostazioni video per la modalità di acquisizione a fotogrammi multipli sono:

Nome file

Inserire qui un nome file o modello di nome file da usare per il salvataggio dei singoli fotogrammi acquisiti. Per l'acquisizione a fotogrammi multipli, la stringa fornita deve essere un nome file mutevole se la funzionalità di continuazione automatica deve essere usata. Altrimenti è sufficiente un nome file semplice, che può essere anche selezionato attraverso il pulsante di selezione file (...).

Formato file | Se si spunta la casella auto, xvidcap selezionerà automaticamente un formato di uscita appropriato basato sul nome file specificato. Per esempio, se si specifica test.avi il formato di uscita sarà Microsoft Audio Video Interleaved File (avi). Se la casella auto è deselezionata, il menu a tendina permette di selezionare un formato manualmente, ignorando la decisione di xvidcap

Codificatore video

Se si spunta la casella auto, xvidcap selezionerà automaticamente un codificatore video appropriato per il formato di uscita selezionato. Per esempio, se si seleziona Microsoft Audio Video Interleaved File (avi), il codificatore video sarà Microsoft DIVX 2. Se la casella auto è deselezionata, il menu a tendina permette di selezionare manualmente un codificatore, ignorando la decisione di xvidcap.

Fotogrammi al secondo | Il numero di fotogrammi da acquisire per secondo. Questo controllo può essere una scala o un menu a tendina, se il codificatore selezionato supporta solo alcune velocità.
Tempo massimo | Tempo massimo di registrazione in secondi
Numero massimo di fotogrammi | Numero massimo fotogrammi da acquisire

Qualità

Qualità desiderata dell'uscita

#### Impostazione della qualità cambiata nella 1.1.5

L'effetto dell'impostazione della qualità a un valore inferiore al 100% è cambiato in xvidcap 1.1.5. Assicurarsi di provare i valori nelle preferenze memorizzate. Nel passato un'impostazione di qualità di 20 poteva ottenere buoni risultati a seconda del codificatore scelto. Non è più così. Un'impostazione di 75 potrebbe essere accettabile, un valore di 85 normalmente lo sarà. Un video risultante da un'acquisizione con un'impostazione di qualità di 90 non sarà normalmente facile da distinguere da uno acquisito a una qualità del 100 percento.

#### le impostazioni audio per la modalità di acquisizione a fotogrammi multipli sono:

Abilita audio | Spuntare questa opzione per acquisire l'audio insieme ai fotogrammi video.
Dispositivo d'ingresso | Inserire il nome del dispositivo di ingresso usato per acquisire l'audio o selezionarlo con il pulsante di selezione file (...).

Codificatore audio

Se si spunta la casella auto, xvidcap selezionerà automaticamente il codificatore audio appropriato per il formato video di uscita selezionato. Per esempio, se Microsoft Audio Video Interleaved File (avi) è selezionato il codificatore audio sarà MPEG2. Se la casella auto è deselezionata, il menu a tendina permette di selezionare manualmente un codificatore, ignorando la decisione di xvidcap.

Campionamento

Campionamento audio. Se si usa un ingresso audio in pipe, il flusso audio viene ricampionato alla velocità specificata se richiesto.

#### Ingresso audio in pipe

Invece che acquisire l'audio da una fonte audio in tempo reale, si può anche redirigere con una pipe un file audio registrato in precedenza a xvidcap. In questo modo si può effettivamente doppiare la propria registrazione con una data traccia audio. Per fare ciò bisogna:

cat mio.mp3 | xvidcap`--mf``--audio yes``--audio_in -``--file test.avi`

Quando si avvia una sessione di registrazione, xvidcap campionerà l'audio dal file rediretto con una pipe.

Bitrate | Bitrate audio. Se non stai usando un ingresso audio rediretto con una pipe, il flusso audio è ricampionato alla velocità specificata se richiesto.
Canali | Numero di canali audio. Se si sta usando un ingresso audio rediretto con una pipe, il flusso audio è ricampionato al numero di canali se richiesto.

### Preferenze comandi

Questa scheda contiene diverse impostazioni riguardanti i comandi da eseguire per determinate azioni.

#### Preferenze comandi

Preferenze comandi

#### i comandi che si possono impostare sono:

Comando di riproduzione per fotogramma singolo

Questo comando è eseguito se si seleziona la voce del menu principale Anima / Riproduci o in caso di pressione del pulsante di riproduzione della finestra dei risultati di acquisizione in modalità di acquisizione a fotogramma singolo.

#### Specificare comandi

Ogni comando può essere configurato qui. In teoria, potrebbe anche non essere collegato all'acquisizione video. Sarà sempre necessario assicurarsi che l'applicazione invocata sia nel proprio path e che il comando termini con il simbolo & per evitare che xvidcap attenda la chiusura dell'applicazione invocata prima di continuare.

xvidcap rende disponibile la seguente variabile d'ambiente per l'applicazione chiamata:

XVFFRAME | numero del primo fotogramma acquisito
XVLFRAME | numero dell'ultimo fotogramma acquisito
XVWIDTH | larghezza dell'area acquisita
XVHEIGHT | altezza dell'area acquisita
XVFPS | velocità fotogrammi desiderata (!)
XVTIME | tempo per fotogramma desiderato (!)
XVFILE | nome file

Il nome file, comunque, necessita di un trattamento speciale per l'acquisizione a fotogramma singolo. Il modello usato per i nomi file mutevoli è inviato letteralmente come specificato per il comando di codifica per fotogramma singolo solamente alla fine. Per il comando di riproduzione per fotogramma singolo, il modello viene convertito in caratteri speciali, ad es. test-%4d.png diventa test-????.png. Per il comando di modifica per fotogramma singolo, il modello viene sostituito dal numero del fotogramma attuale, ad es. test-%4d.png diventa test-0001.png. Per tutti i comandi per fotogrammi multipli

Comando di codifica per fotogramma singolo | Questo comando è eseguito se si seleziona la voce di menu Crea video in modalità di acquisizione a fotogramma singolo.
Comando di modifica per fotogramma singolo | Questo comando è eseguito al clic del pulsante Modifica dei controlli principali in modalità di acquisizione a fotogramma singolo.
Comando di riproduzione per fotogrammi multipli | Questo comando è eseguito quando si seleziona la voce di menu Anima / Riproduci del menu principale o se si preme il tasto di riproduzione della finestra dei risultati di acquisizione in modalità di acquisizione a fotogrammi multipli.
Comando di transcodifica per fotogrammi multipli | Questo comando è eseguito se si seleziona la voce di menu Crea video in modalità di acquisizione a fotogrammi multipli.
Comando di modifica per fotogrammi multipli | Questo comando è eseguito al clic del pulsante Modifica dei controlli principali in modalità di acquisizione a fotogrammi multipli.

## Finestra dei risultati di acquisizione

Alla prima interruzione di una sessione di registrazione, comparirà una finestra che visualizza i risultati della sessione di acquisizione. Per evitare che tale finestra compaia ancora, è sufficiente deselezionare la casella Mostra la prossima volta o premere questo pulsante nella finestra delle preferenze.

Questa stessa finestra può usare uno o due moduli a seconda che xvidcap sia configurato o meno per richiedere un nome file di destinazione dopo l'acquisizione.

### Richiesta del nome file all'utente

D'ora in poi, il solo modo per configurare xvidcap per richiedere all'utente di specificare un nome file dopo l'acquisizione piuttosto che fornirne uno direttamente, specificando un nome file vuoto sia attraverso la linea di comando usando `--file ""` o nella finestra delle preferenze. Per fare ciò, bisogna specificare manualmente il formato file di uscita. In questa configurazione, xvidcap memorizzerà il video in un file temporaneo nella propria cartella home che può essere successivamente rinominato/spostato nella destinazione desiderata. Non è compatibile con la continuazione automatica.

Se xvidcap è configurato per richiedete il nome file all'utente, la finestra dei risultati apparirà in questo modo:

### Finestra dei risultati di acquisizione con richiesta del nome file all'utente

Finestra dei risultati di acquisizione con richiesta del nome file all'utente

Oltre al riepilogo delle impostazioni utilizzate e alle informazioni circa la velocità dei fotogrammi desiderata e raggiunta, si può selezionare il nome e la posizione del file nel quale di vuole salvare il video facendo clic su Salva come. Una volta che un file è stato selezionato, l'etichetta accanto al pulsante visualizzerà il nome file assoluto. Si può scegliere se vedere un'anteprima del video con Riproduci o abbandonare con Elimina. Notare che quest'ultima non elimina immediatamente il file temporaneo.

Normalmente, la finestra dei risultati apparirà in questo modo:

### Finestra di acquisizione dei risultati normale

Finestra di acquisizione dei risultati normale

## La finestra di avviso delle preferenze

Ogni volta che xvidcap determina che le impostazioni scelte non funzioneranno, visualizzerà questi problemi in un formato standardizzato. A meno che non si esegua xvidcap con il parametro `--gui no`, verrà mostrata la seguente finestra:

### Finestra di avviso delle preferenze

Finestra di avviso delle preferenze

### Operare senza interfaccia grafica

In caso di esecuzione dalla linea di comando con il parametro `--gui no`, queste impostazioni saranno visualizzate in testo semplice sul terminale. Non si vedrà la sezione Dettagli a meno che non si specifichi `-v`.

### Ci sono pochi casi in cui certi messaggi possono essere visualizzati:

All'avvio | Quando xvidcap è avviato, verifica la consistenza delle impostazioni per la modalità di acquisizione attuale e segnala eventuali problemi. Non sarà possibile chiudere questa finestra, ma si dovrà riaprire la finestra delle preferenze. xvidcap controlla solo la modalità di acquisizione attuale e non tiene conto delle inconsistenze con le altre modalità. Questa è il secondo caso.
Al cambiamento della modalità di acquisizione | Se si cambia la modalità di acqusizione attuale dal menu, xvidcap verificherà la consistenza delle impostazione per la nuova modalità di acquisizione e segnalerà eventuali problemi riscontrati. Annullando la finestra di avviso, si tornerà alla precedente selezione della modalità di acquisizione.
Quando si applicano modifiche delle preferenze | Quando chiudi la finestra delle preferenze, xvidcap controllerà le impostazioni per entrambe le modalità di acquisizione. L'annullamento della finestra di avviso riporterà alla finestra delle preferenze.

Nella finestra di avviso delle preferenze si troveranno uno o più messaggi composti da tre righe ciascuno. La prima riga contiene un tipo di messaggio o gravità, un ID numerico univoco e un breve nome dell'errore. La seconda riga fornisce una descrizione più dettagliata, e la terza riga descrive l'azione che xvidcap intraprenderà se si fa clic su OK.

Un'azione potrebbe essere la correzione automatica del problema scegliendo un valore predefinito plausibile, per ignorare il problema se non è grave o per uscire da xvidcap se la soluzione non è determinabile automaticamente.

La gravità di un problema può essere INFO per messaggi puramente informativi senza modifiche alle impostazioni, AVVISO dove vengono suggeriti piccoli cambiamenti alle impostazioni attuali, ERRORE dove viene richiesto una sostanziale modifica delle impostazioni attuali, o ERRORE GRAVE. In caso di errore grave, l'unica azione suggerita è di uscire da xvidcap. Non si vedranno problemi di gravità INFO a meno che non si esegua xvidcap in modalità prolissa.