# Manuale di &ksnapshot;

Richard
J.
Moore

    &Richard.J.Moore.mail;

Robert
L.
McCormick

    &Robert.L.McCormick.mail;

Brad
Hards

    &Brad.Hards.mail;

Lauri
Watts

    &Lauri.Watts.mail;

Revisore
Richard
J
Moore

    &Richard.J.Moore.mail;

Sviluppatore
Matthias
Ettrich

    &Matthias.Ettrich.mail;

Sviluppatore

    zenith@chemeng.ntnu.no

Traduzione
Federico
Cozzi
Traduzione
Matteo
Merli
Traduzione
Andrea
Celli
Traduzione
1997-2000
&Richard.J.Moore;
2000
&Matthias.Ettrich;
&FDLNotice;
2006-07-05
0.7

&ksnapshot; è un semplice programma per scattare foto allo schermo. È in grado di acquisire immagini di tutto il desktop, di una sola finestra, della sezione di una finestra o di una regione selezionata. Le immagini così ottenute possono in seguito essere salvate in vari formati.

KDE
KSnapshot
kdegraphics
acquisizione dello schermo
cattura dello schermo

## Introduzione

&ksnapshot; è un semplice programma per scattare foto allo schermo. È in grado di acquisire immagini di tutto il desktop, di una sola finestra, della sezione di una finestra o di una regione selezionata. Le immagini così ottenute possono in seguito essere salvate in vari formati.

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

## Uso di &ksnapshot;

Questo capitolo spiega come usare &ksnapshot; per scattare foto allo schermo.

### Avvio di &ksnapshot;

&ksnapshot; può essere avviato in uno dei seguenti modi.

- È possibile avviare &ksnapshot; selezionandolo da Menu K Grafica&ksnapshot; (Scatta foto allo schermo).

- È possibile avviare &ksnapshot; immettendo il seguente comando al prompt dei comandi:

      % ksnapshot &

- È possibile anche usare la mini riga dei comandi (ottenibile con &Alt;F2) per avviare &ksnapshot;

All'avvio di &ksnapshot;, apparirà una finestra simile alla seguente: Finestra di anteprima di &ksnapshot;

### Scattare una foto

&ksnapshot; scatta una foto dell'intero desktop non appena viene avviato, ma prima di apparire a schermo. In questo modo è possibile scattare velocemente foto dell'intero desktop.

La foto scattata da &ksnapshot; è mostrata nella finestra di anteprima, che si trova in alto a sinistra nella finestra di &ksnapshot;. Qui sotto c'è un esempio di finestra di anteprima di &ksnapshot;. La tua anteprima dipenderà da come si presenta il tuo desktop.

Finestra di anteprima di &ksnapshot;

La foto può essere salvata facendo clic sul pulsante Salva con nome.... Ciò apre la finestra di salvataggio standard di &kde;, dove puoi scegliere il nome del file, la posizione nelle cartelle, e il formato in cui la tua istantanea sarà salvata. Se sono fatte più foto, il nome del file è automaticamente incrementato per impedirti di sovrascrivere le foto precedenti. Puoi comunque modificare il nome del file in qualsiasi modo tu voglia, incluso il nome di una foto salvata precedentemente.

Per scattare una foto ad una singola finestra, seleziona la voce della casella combinata Finestra sotto il cursore (di fianco a Modalità di acquisizione) e premi il pulsante Nuova foto.

A seconda di come hai impostato Ritardo per la foto:, il puntatore del mouse diventerà una crocetta (nel caso di Nessun ritardo) oppure un cursore del mouse normale che puoi usare per lavorare con un programma finché non scadrà il tempo e la foto verrà scattata.

Se ha scelto Nessun ritardo, la foto sarà scattata non appena farai clic su una finestra.

&ksnapshot; mostrerà la nuova foto nella finestra di anteprima. A questo punto puoi scegliere se salvare l'immagine (premendo Salva con nome...) o scattarne una nuova premendo ancora il pulsante Nuova schermata.

Per scattare una nuova foto di tutto il desktop, seleziona la voce della casella combinata Schermo intero e fai clic sul pulsante Nuova foto. &ksnapshot; acquisirà tutto il desktop se premi Nuova foto.

Similmente, per fare una foto a una regione, seleziona la voce della casella combinata Regione e imposta il Ritardo per la foto a Nessun ritardo, e fai clic sul pulsante Nuova foto. Il cursore del mouse diventerà una crocetta, e potrai usare il mouse per selezionare la regione che vuoi acquisire.

Per fare una nuova foto della sezione di una finestra, seleziona la casella combinata Sezione di finestra e fai clic con il pulsante Nuova foto. Con Nessun ritardo ottieni un puntatore del mouse a crocetta e devi far clic una volta con il &LMB; nella finestra. La sezione della finestra sotto il cursore del mouse viene quindi evidenziata con un bordo rosso. Sposta il mouse alla sezione desiderata e fai clic con il &LMB; per acquisire l'immagine.

### Funzionalità aggiuntive

#### Ritardo per la foto

L'opzione Ritardo per la foto ti permette di impostare un ritardo, in secondi, tra l'istante in cui premi il pulsante Nuova schermata e quello in cui verrà effettivamente scattata la foto.

Se imposti un ritardo, non è necessario che tu faccia clic con il tasto del mouse per scattare una foto. Ciò ti permette di aprire un menu a tendina e di scattarne una foto.

#### Escludi le decorazioni della finestra

Includi le decorazioni della finestra è l'opzione preimpostata.

Se, invece, vuoi fotografare solo l'applicazione senza le decorazioni circostanti della finestra, puoi disabilitare questa opzione prima di scattare la foto.

#### Stampa

Quando vuoi stampare la foto presente nell'anteprima, ti basta fare clic su Stampa... e comparirà l'abituale finestra di dialogo per la stampa in &kde;, dalla quale potrai stampare direttamente la tua foto.

#### Copia negli appunti

Quando vuoi modificare la tua foto in un'applicazione grafica senza salvarla, basta che fai clic su Copia negli appunti e inserisci l'immagine in un visore o un'applicazione grafica.

#### Pulsanti

Ci sono due ulteriori pulsanti in fondo alla finestra di &ksnapshot;. Qui di seguito è descritta la loro funzione.

Aiuto

  Fornisce un menu dal quale potrai aprire questo Manuale di &ksnapshot;, segnalare un bug o ricevere ulteriori Informazioni su &ksnapshot; e Informazioni su &kde;.

Esci

  Chiude il programma &ksnapshot;.

## Interfaccia &DCOP;

&ksnapshot; può essere gestito da script usando la sua interfaccia &DCOP;. Questo capitolo spiega le varie chiamate &DCOP; che puoi usare, e dà alcuni esempi su come usarle.

Come per tutte le chiamate &DCOP;, devi specificare l'applicazione con cui vuoi interagire, e l'interfaccia specifica. Con &ksnapshot; devi identificare l'applicazione specifica, che è `ksnapshot-` seguito dal numero del processo.

Per avviare &ksnapshot; e ottenere l'argomento giusto, usa `dcopstart ksnapshot`, che restituisce l'argomento (come `ksnapshot-20594`) nello standard output.

Puoi ottenere un elenco di tutte le interfacce &DCOP; disponibili usando gli argomenti giusti, come mostrato in questo esempio:

    $ dcop `dcopstart ksnapshot` interface
    QCStringList interfaces()
    QCStringList functions()
    QString url()
    void slotGrab()
    void slotPrint()
    void slotSave()
    bool save(QString filename)
    void slotSaveAs()
    void slotCopy()
    void setTime(int newTime)
    int timeout()
    void setURL(QString newURL)
    void setGrabMode(int grab)
    int grabMode()
    void slotMovePointer(int x,int y)
    void exit()

Negli esempi seguenti, il processo è sempre `ksnapshot-23151`.

### Accesso &DCOP; alle impostazioni

Di ciascuna delle impostazioni che controlli con la &GUI; puoi sia ottenere lo stato attuale che modificarla usando &DCOP;.

Puoi ottenere l'attuale modalità di acquisizione usando `grabMode`, come mostrato sotto:

    $ dcop ksnapshot-23151 interface grabMode

Ciò restituirà `0` per l'acquisizione di un'intera schermata, `1` per l'aquisizione di una finestra, e `2` per l'acquisizione di una regione.

Puoi impostare la modalità di acquisizione `setGrabMode`, che richiede un argomento per identificare la modalità richiesta (come in `grabMode`). In questo modo puoi impostare la modalità di acquisizione di una finestra (`1`) usando:

    $ dcop ksnapshot-23151 interface setGrabMode 1

Puoi ottenere l'attuale impostazione del ritardo (l'elemento della GUI Ritardo per la foto:) usando `timeout`, come mostrato sotto:

    $ dcop ksnapshot-23151 interface timeout

Ciò restituirà l'impostazione del ritardo in secondi, o zero se non c'è nessun ritardo (acquisizione al clic).

Puoi impostare il ritardo usando `setTime`, che richiede un argomento per identificare la durata del ritardo. Quindi puoi impostare un ritardo di quattro secondi usando:

    $ dcop ksnapshot-23151 interface setTime 4

Puoi ottenere il percorso a cui la schermata sarà salvata usando `url`, come mostrato sotto:

    $dcop ksnapshot-23151 interface url

Ciò restituirà il nome del file in forma di &URL; (per esempio come `file:///home/pippo/prova2.png`).

Puoi impostare il percorso usando `setURL`, che richiede un argomento in forma di stringa per identificare il nuovo percorso. Quindi puoi impostare il percorso a `file:///home/pippo/schermata.jpg` usando:

    $ dcop ksnapshot-23151 interface setURL file:///home/bradh/snapshot.jpg

### Scattare foto con &DCOP;

Il trucco per scattare foto con &DCOP; è usare `slotGrab`, come mostrato sotto:

    $ dcop ksnapshot-23151 interface slotGrab

Ciò scatterà una foto usando la modalità di acquisizione e impostazioni del ritardo attuali (come descritto sopra). Se vuoi salvare l'immagine acquisita, ci sono delle chiamate che puoi usare. Se vuoi solo salvare l'immagine nel percorso attuale (come restituito da `url` o cambiato con `setURL`), puoi usare `slotSave`, come mostrato sotto:

    $ dcop ksnapshot-23151 interface slotSave

Se vuoi che l'utente possa specificare un nome file (e percorso), puoi usare `slotSaveAs`, che farà apparire una finestra di salvataggio dei file standard di &kde;.

Se vuoi salvare l'immagine con un nome (o percorso) diverso senza cambiare il percorso con `setURL`, puoi usare `save`, dando l'&URL; su cui salvare come argomento. Se vuoi salvare la schermata in `file:///tmp/tempshot.png`, puoi fare come segue:

    $ dcop ksnapshot-23151 interface save file:///tmp/tempshot.png

Nota che ciò restituirà vero se la schermata sarà stata salvata correttamente, e falso altrimenti. Inoltre dovresti tener presente che se il file esiste già, l'utente riceverà una finestra standard di &kde; che gli chiederà di decidere se sovrascrivere o meno.

Oltre a salvare la schermata, puoi anche copiarla negli appunti, usando `slotCopy`, come mostrato sotto:

    $ dcop ksnapshot-23151 interface slotCopy

Se devi selezionare una finestra che potrebbe non essere sotto il cursore del mouse, puoi usare `slotMovePointer`, passando la coordinate x e y (in pixel dello schermo) come argomenti. Quindi, per spostare il mouse nell'angolo in alto a sinistra dello schermo (0,0), puoi fare come segue:

    $ dcop ksnapshot-23151 interface slotMoveMouse 0 0

### Stampare schermate con &DCOP;

Puoi stampare la schermata attuale (che può essere salvata o meno) usando `printSlot`, come mostrato sotto:

    $ dcop ksnapshot-23151 interface slotPrint

Nota che questo farà apparire la finestra di stampa standard di &kde;, che può richiedere interazione con l'utente.

### Controllo dell'applicazione con &DCOP;

Puoi terminare &ksnapshot; usando `exit`, come mostrato sotto.

    $ dcop ksnapshot-23151 interface exit

## Riconoscimenti e licenza

Copyright del programma

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

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

Documentazione basata sull'originale, copyright 1997-2000 &Richard.J.Moore; &Richard.J.Moore.mail;

Federico Zenithzenith@chemeng.ntnu.no

Federico Cozzi

Matteo Merli

Andrea Celli

&underFDL; &underGPL;

&documentation.index;