# Manuale di &spectacle;

## Introduzione

&spectacle; è una semplice applicazione per catturare schermate del desktop. Può acquisire l'immagine dell'intero desktop, di un singolo monitor, della finestra attiva, della finestra dietro al cursore, o di una regione rettangolare dello schermo. L'immagine può quindi essere stampata, inviata ad altre applicazioni per ulteriori modifiche, o salvata rapidamente così com'è.

Segnala qualsiasi problema o richiesta di miglioramenti sul Sistema di gestione dei bug di &kde;.

## Esecuzione di &spectacle;

&spectacle; può essere avviato in vari modi, come descritto di seguito:

- Nel menu dei programmi, &spectacle; può essere raggiunto da Applicazioni Accessori Accessorio per catturare schermate &spectacle;

- Premendo il pulsante Stamp sulla tastiera, &spectacle; sarà eseguito immediatamente. Inoltre, altre tre scorciatoie di tastiera sono disponibili per catturare schermate e salvarle nella cartella predefinita di salvataggio senza mostrare la &GUI;:

  - Meta Stamp catturerà una schermata della finestra attiva

  - &Shift;Stamp catturerà una schermata dell'intero desktop, &ie; tutti i monitor

  - Meta&Shift;Stamp catturerà una regione rettangolare

  Puoi configurare la posizione ed il file per il salvataggio predefiniti avviando &spectacle; normalmente, facendo clic sul pulsante Configura..., quindi accedendo alla sezione Salva.

- Anche la mini-riga di comando &krunner; (invocata tramite &Alt;F2) può essere usata per avviare &spectacle;.

- &spectacle; può essere avviato dalla riga di comando. &spectacle; dispone di un insieme notevole di opzioni da riga di comando, inclusa la modalità in «background» che può essere usata per catturare schermate da script, senza mostrare l'interfaccia grafica o comunque richiedere interazione con l'utente.

  Per avviare &spectacle; dalla riga di comando, digita:

      % spectacle &

  Per mostrare l'elenco completo delle opzioni a riga di comando e la relativa spiegazione, digita:

      % spectacle --help

## Utilizzare &spectacle;

All'avvio di &spectacle; apparirà una finestra simile alla seguente: Finestra principale di &spectacle;

&spectacle; acquisisce una schermata dell'intero desktop non appena viene eseguito, ma prima di comparire sullo schermo. Questo ti permette di catturare rapidamente immagini dell'intero desktop.

La schermata catturata da &spectacle; viene mostrata nella finestra di anteprima, che è posizionata nella parte sinistra della finestra principale di &spectacle;.

L'immagine può essere salvata facendo clic sul pulsante Salva come... o digitando &Ctrl;&Shift;S). Questa apre la finestra standard di salvataggio dove puoi scegliere il nome del file, la cartella ed il formato da usare per salvare la schermata. Puoi cambiare il nome del file come preferisci, anche usando il nome di una schermata già salvata.

Per salvare una schermata nella posizione predefinita, fai clic sulla parte con freccia del pulsante Salva come... e premi il pulsante Salva (&Ctrl;S). La nuova modalità di salvataggio sarà ricordata la volta successiva. La posizione di salvataggio ed il nome di file predefiniti possono essere configurati, come descritto in seguito.

Per salvare rapidamente l'immagine e chiudere &spectacle; premi la casella accanto a Esci dopo il salvataggio o la copia manuali, quindi fai clic sulla parte con freccia del pulsante Salva come... e premi la voce Salva (&Ctrl;S). Questo salva l'immagine come file PNG nella cartella `Immagini` predefinita e chiude immediatamente il programma. Come per il caso precedente, questa nuova modalità di salvataggio sarà ricordata.

### Catturare una schermata

Quando apri &spectacle; viene catturata immediatamente la schermata intera per comodità e ne viene mostrata l'anteprima nella finestra principale del programma. Puoi salvare questa schermata usando i pulsanti nella parte inferiore della finestra, o catturarne una nuova usando i controlli a destra dell'anteprima.

Per scartare la schermata e catturarne un'altra, premi il pulsante Acquisisci una nuova schermata (&Ctrl;N).

Dopo aver acquisito una schermata, &spectacle; mostrerà un pannello informativo con un collegamento all'immagine ed il pulsante Apri cartella contenitore.

Puoi configurare alcune opzioni nella parte destra della finestra dell'applicazione prima di catturare una schermata. Queste opzioni ti permettono di selezionare l'area dello schermo da catturare, impostare un ritardo prima di catturare l'immagine, e configurare se il cursore del mouse o le decorazioni delle finestre debbano essere catturate nell'immagine.

#### Modalità di acquisizione

Le impostazioni della modalità di cattura ti permettono di impostare l'area dello schermo da catturare, e se ci debba essere un ritardo tra la pressione del pulsante Acquisisci una nuova schermata (&Ctrl;N) e l'effettiva acquisizione. Puoi anche abilitare la casella Al clic, che disabilita il ritardo ed effettua l'acquisizione quando fai clic in un punto qualsiasi dello schermo dopo aver premuto il pulsante Acquisisci una nuova schermata (&Ctrl;N).

La casella combinata Area ti permette di impostare l'area dello schermo da catturare. Ci sono cinque opzioni tra cui scegliere, come descritto di seguito.

- L'opzione Schermo intero (tutti i monitor) cattura la schermata dell'intero desktop in tutti i dispositivi di uscita, inclusi tutti i monitor, proiettori, ecc.

- L'opzione Schermo attuale cattura la schermata del dispositivo di output che contiene il puntatore del mouse.

- L'opzione Finestra attiva cattura la schermata della finestra che ha il fuoco. È consigliabile impostare un ritardo con questa modalità per darti il tempo di selezionare e attivare la finestra prima dell'acquisizione della schermata.

- L'opzione Finestra sotto il cursore cattura la schermata della finestra che è sotto il cursore del mouse. Se il cursore è sopra un menu a comparsa, &spectacle; tenta di catturare sia l'immagine del menu che della finestra che lo contiene.

  Anche se questa procedura funziona la maggior parte delle volte, in alcuni casi potrebbe non riuscire ad ottenere le informazioni sulla finestra che contiene il menu. In questo caso &spectacle; fa ricorso al vecchio metodo di catturare l'immagine automaticamente, e cattura un'immagine del solo menu a comparsa. Puoi anche forzare il vecchio modo di catturare l'immagine selezionando la casella Cattura solo la finestra a comparsa attuale sotto Opzioni

- L'opzione Regione rettangolare ti permette di selezionare una regione rettangolare del tuo desktop con il mouse. Questa regione può estendersi su varie periferiche di uscita.

  Questa modalità non acquisisce una schermata immediatamente ma ti permette di tracciare sullo schermo un rettangolo che può essere spostato e ridimensionato secondo necessità. Una volta che il rettangolo desiderato è stato disegnato, un doppio clic in un qualsiasi punto dello schermo o la pressione del tasto &Enter; sulla tastiera attiveranno la cattura della schermata.

  Puoi usare i tasti freccia per spostare e aggiustare il rettangolo. Premendo i tasti freccia il rettangolo si sposta. Tenendo premuto il tasto &Shift; mentre si premono i tasti freccia il rettangolo si muoverà lentamente, per ritoccare la selezione. Tenendo premuto il tasto &Alt; mentre si premono i tasti freccia la dimensione del rettangolo cambia.

La casella numerica Ritardo ti permette di impostare il ritardo tra la pressione del pulsante Acquisisci una nuova schermata (&Ctrl;N) e l'effettiva cattura. Questo ritardo può essere impostato in incrementi di 1 secondo usando la casella numerica o la tastiera.

Quanto acquisisci una schermata con un ritardo, &spectacle; mostra il tempo rimanente nel titolo della finestra prima di acquisire la schermata, e lo rende visibile nel relativo elemento del gestore dei processi. Anche il pulsante del gestore dei processi di &spectacle; mostra una barra di avanzamento, così puoi tenere traccia del momento della cattura.

Mentre aspetti una cattura con ritardo puoi ripristinare &spectacle;, ed il pulsante Acquisisci una nuova schermata cambierà nel pulsante Annulla. Anche la barra di avanzamento sarà mostrata, permettendoti di cambiare il conto alla rovescia.

Abilitando la casella Al clic il ritardo viene ignorato. Quando questa casella è abilitata, premendo il pulsante Acquisisci una nuova schermata (&Ctrl;N) la finestra di &spectacle; viene nascosta e il puntatore del mouse diventa un mirino. La schermata viene catturata quando viene premuto il pulsante sinistro del mouse, o al contrario l'operazione è annullata se viene premuto un qualsiasi altro pulsante del mouse. Nota che non puoi interagire con il desktop usando il mouse mentre il cursore ha la forma del mirino, ma puoi usare la tastiera.

#### Opzioni

Le impostazioni relative alle opzioni ti permettono di selezionare se il puntatore del mouse debba essere incluso nelle schermate, e se catturare le decorazioni delle finestre con l'immagine di un'applicazione a singola finestra. Nella modalità Finestra sotto il cursore ti permette inoltre di selezionare se &spectacle; debba catturare solo l'immagine del menu a comparsa sotto il cursore o includere anche la finestra che lo contiene. Infine, Esci dopo il salvataggio o la copia chiuderà &spectacle; dopo un'operazione di salvataggio o di copia.

- Abilitando la casella Includi il puntatore del mouse, nella schermata sarà inclusa l'immagine del puntatore del mouse.

- L'opzione Includi la barra del titolo ed i bordi della finestra è abilitata solo quando una tra le modalità Finestra attiva e Finestra sotto il cursore è selezionata nella casella combinata Area. Selezionando questa opzione i bordi e la decorazione della finestra sono inclusi nella schermata, mentre deselezionandola si ottiene un'immagine con il solo contenuto della finestra.

- L'opzione Cattura solo la finestra a comparsa attuale è abilitata solo quando la modalità Finestra sotto il cursore è selezionata nella casella combinata Area. Selezionando questa opzione viene catturato solo il menu a comparsa sotto il cursore, senza la finestra che lo contiene.

- L'opzione Esci dopo il salvataggio o la copia chiuderà &spectacle; dopo un'operazione di salvataggio o di copia. Note come una schermata copiata negli appunti sarà mantenuta solo se è in esecuzione un gestore di appunti che gestisce immagini. Klipper di KDE può essere configurato in questo modo facendo clic col pulsante destro sulla sua icona, selezionando Configura gli appunti... e deselezionando Ignora le immagini.

## Ulteriori funzionalità

### Pulsanti

Ci sono alcuni pulsanti in fondo alla finestra di &spectacle;. La loro funzione è descritta di seguito:

Aiuto

- Fornisce le voci di menu comuni descritte nella sezione del menu Aiuto dei Fondamentali di &kde;.

Configura...

- Ti permette di accedere alla finestra di configurazione di &spectacle; dove puoi cambiare le impostazioni di cattura e la posizione di salvataggio e il nome di file predefiniti.

Strumenti

- Apre un menu a comparsa che offre vari strumenti:

  - Apri cartella predefinita delle schermate selezionerà nel gestore di file predefinito l'ultima schermata salvata

  - Accesso alla finestra di dialogo Stampa

  - Un insieme di programmi esterni per la registrazione dello schermo

Esporta

- Apre un menu a comparsa che ti permetterà di aprire direttamente l'immagine con tutti i programmi associati al tipo &MIME; PNG (Portable Network Graphics). In base ai programmi installati sarai in grado di aprire e modificare l'immagine catturata nei tuoi programmi o visualizzatori grafici.

  Inoltre, se hai le estensioni KIPI installate, potrai inviare le schermate catturate tramite posta elettronica ed esportarle direttamente tramite alcuni social network e siti web.

Copia negli appunti

- Copia la schermata attuale negli appunti, Puoi anche usare la scorciatoia di tastiera &Ctrl;C per questo.

Salva come

- Salva la schermata come immagine PNG nella tua cartella Immagini predefinita e chiude subito l'applicazione.

### Configura

Usa il pulsante Configura... per aprire la finestra di configurazione.

#### Generale

Generale

Premi il tasto schermata per

- Quando viene premuta una scorciatoia per salvare schermate e &spectacle; è già in esecuzione, è possibile configurare il comportamento del sistema di acquisizione. Puoi scegliere tra l'acquisizione di una schermata, l'apertura di una nuova finestra di &spectacle;, e restituire il fuoco alla finestra di &spectacle; pre-esistente.

Dopo aver acquisito una schermata

- Permette di copiare le immagini negli appunti o salvare automaticamente l'immagine nella posizione predefinita. Quest'ultima può essere configurata usando la pagina di configurazione Salva.

Usa un colore di sfondo chiaro

- Usa un colore di sfondo chiaro per mascherare l'area ritagliata nel selettore di regione rettangolare. Potrebbe rendere più visibili i cursori scuri.

Mostra lente di ingrandimento

- Quando una schermata viene salvata, copia negli appunti la posizione in cui il file è stato salvato. Puoi quindi incollarla ovunque sia possibile inserire del testo. Nota che deve esserci un gestore di appunti in esecuzione perché il percorso sia mantenuto negli appunti quando &spectacle; termina.

Accetta al clic-e-rilascio

- Se selezionata, accetta la regione selezionata non appena il mouse viene rilasciato nella modalità Regione rettangolare.

  Quando si seleziona una nuova regione ma non è disponibile una regione salvata in precedenza, le operazioni di click, trascinamento e rilascio del pulsante mouse dovrebbero catturare immediatamente la regione selezionata. Quando viene mostrata una regione salvata in precedenza, la regione salvata può essere ulteriormente manipolata e il salvataggio di questa regione richiede una conferma manuale (&Enter; o un doppio clic con il &LMB;). Facendo clic e trascinando al di fuori della regione salvata in precedenza provoca la cattura immediata della regione appena selezionata.

Ricorda l'area selezionata

- Come comportamento predefinito &spectacle; ricorda una selezione iniziale quando viene acquisita una regione rettangolare fino alla chiusura della finestra di &spectacle;. Puoi anche scegliere di far sì che &spectacle; non ricordi mai l'area selezionata, o che la ricordi tra diverse sessioni di cattura.

#### Salva

Quando usi la funzione Salva &spectacle; salva l'immagine con un nome di file predefinito nella cartella delle immagini (che si trova nella tua cartella home). Il nome di file predefinito include la data ed ora in cui l'immagine è stata acquisita.

La pagina Salva ti permette di impostare la posizione ed il nome di file predefiniti per il salvataggio. Facendo clic su questa opzione fa apparire una finestra di dialogo come la seguente: Salva

Dove salvare

- Nella casella di testo Posizione imposta la cartella dove vuoi salvare le schermate quando premi Salva.

Copia l'indirizzo del file negli appunti dopo il salvataggio

- Quando una schermata viene salvata, copia negli appunti la posizione in cui il file è stato salvato. Puoi quindi incollarla ovunque sia possibile inserire del testo. Nota che deve esserci un gestore di appunti in esecuzione perché il percorso sia mantenuto negli appunti quando &spectacle; termina.

Qualità di compressione

- Scegli la qualità dell'immagine quando salvi con formati d'immagine a perdita di qualità come JPEG. Valori maggiori forniscono una qualità maggiore ma incrementano la dimensione del file. Consulta la pagina di Wikipedia per maggiori dettagli sui formati d'immagine usati in &spectacle;.

Nome file

- Imposta il nome del file predefinito per le schermate salvate.

  Puoi usare i seguenti segnaposti nel nome di file, che saranno sostituiti con il vero contenuto quando il file viene salvato:

  - `%D`: giorno

  - `%H`: ora

  - `%M`: mese

  - `%Nd`: numero sequenziale con spaziatura a 4 cifre

  - `%S`: secondo

  - `%T`: titolo della finestra

  - `%Y`: anno (4 cifre)

  - `%Nd`: numero sequenziale

  - `%m`: minuto

  - `%y`: anni (2 cifre)

  Puoi fare clic sui segnaposti nell'elenco di riferimento in basso per inserirli nella riga Nome file.

  Se esiste già un file con questo nome, sarà aggiunto un numero seriale in fondo al nome del file. Ad esempio, se il nome del file è `Schermata` e `Schermata.png` esiste già, l'immagine sarà salvata come `Schermata-1.png`.

  Digitando un'estensione nel nome del file, il formato dell'immagine sarà impostato correttamente e l'estensione sarà rimossa dal campo del nome del file.

#### Scorciatoie

Questa pagina di configurazione può essere usata per cambiare le scorciatoie predefinite di &spectacle;. È possibile configurare le scorciatoie per avviare &spectacle; e catturare parti diverse del desktop.

### Trascinamento

Un'immagine catturata può essere trascinata su un'altra applicazione o documento. Se l'applicazione è in grado di gestire le immagini, una copia dell'intera immagine viene inserita in essa.

Se trascini una schermata nella finestra di un gestore di file, apparirà una finestra in cui potrai decidere il nome del file ed il formato dell'immagine, e il file verrà inserito nella cartella indicata.

Se trascini la schermata in una casella di testo, verrà inserito il percorso al file temporaneo in cui è salvata la schermata. Questo è utile, per esempio, per caricare una schermata con un modulo Web o per allegare delle schermate a delle segnalazioni di errori sul sistema di tracciamento degli errori di &kde;.

Questo funziona con tutte le applicazioni che non raccolgono i dati delle immagini, ma cercano solo un &URL; nei dati MIME trascinati.

## Riconoscimenti e licenza

Copyright del programma © 2015 &Boudhayan.Gupta; &Boudhayan.Gupta.mail;.

Parti di questo codice sono basate direttamente sul codice del progetto &ksnapshot;. Copyright © 1997-2011 gli sviluppatori di &ksnapshot;. Informazioni dettagliate sull'assegnazione del copyright sono disponibile nelle intestazioni del codice sorgente.

Parti di questo codice sono basate direttamente sul codice del progetto &kwin;. Copyright © 2008, 2013 gli sviluppatori di &kwin;. Informazioni dettagliate sull'assegnazione del copyright sono disponibile nelle intestazioni del codice sorgente.

Documentazione basata sulla documentazione originale di &ksnapshot;:

- Copyright © 1997-2000 &Richard.J.Moore; &Richard.J.Moore.mail;

- Copyright © 2000 &Matthias.Ettrich; &Matthias.Ettrich.mail;

Traduzione italiana di Luigi Toscano luigi.toscano@tiscali.it

&underFDL; &underGPL;
&documentation.index;